Data Queue APIs--Categories - FTP Directory Listing - IBM

Rename Object (QLIRNMO) API
Rename Object (QLIRNMO) API
Required Parameter Group:
1 From qualified object name Input Char(20)
2 Object type Input Char(10)
3 To qualified object name Input Char(20)
4 Replace object Input Char(1)
5 Error code I/O Char(*)
Threadsafe: Conditional; see Usage Notes.
The Rename Object (QLIRNMO) API renames an existing object to a new object name or moves the
object to a different library or both, and optionally replaces the object.
When the replace object parameter requests to replace an existing object and the to object already exists,
the following occur:
● The *PUBLIC and private authorities from the to object replace the authorities on the renamed
object.
● The owner of the object is the owner of the from object.
● If the object is not a *PGM object, the to object is deleted.
● For a *PGM object, the to object is moved to the QRPLOBJ library. The renamed program will
have the same user profile (USRPRF) value as the to program. If the to program has the adopted
authority USRPRF(*OWNER) attribute, the owner of the from program must be the same as the
owner of the to program. An error message is issued if the owners do not match. For more
information on adopted authority, see the Security - Reference book. The use adopted authority
(USEADPAUT) value from the to program is copied to the from program as long as the user who
performs the rename operation can create and update programs with the USEADPAUT(*YES)
attribute. The QUSEADPAUT system value determines whether or not users can create and update
programs to use adopted authority. If the program being replaced has USEADPAUT(*YES) and the
user cannot create and update programs to use adopted authority, the USEADPAUT value of the
from program remains the same.
● For a *CRQD object, the from change request description will have the same user profile
(USRPRF) value as the to change request description. If the to change request description has a user
profile value of USRPRF(*OWNER), the owner of the from object must be the same as the to
object. An error message is issued if the owners do not match.
All restrictions that apply to the Move Object (MOVOBJ) and Rename Object (RNMOBJ) commands also
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qlirnmo.htm (1 of 6) [10/4/1999 2:36:33 PM]