CHGOWNTAP CHANGE OWNER FROM TAPE TAASEFH
The Change Owner from Tape command provides a 'fix up' of ownership.
CHGOWNTAP is designed for the case where object ownership has been
changed and you want to reset the ownership to the owner that exists
on a save tape. A listing is produced with one line for each object
with flags for those objects that were changed or could not be
changed. You must be authorized to change ownership of the
Authorities granted to users are not saved with the object and are
The command is helpful in resetting the ownership of objects in a
user ASP after a failure in the system ASP. If the system ASP fails,
the ownership of user ASP objects becomes QDFTOWN. The backup and
recovery guide recommends changing the ownership of each object in
the user ASP using CHGOBJOWN. CHGOWNTAP simplifies this task.
A sub tool (CVTTAPSAVD) is English language dependent.
A typical command would be:
CHGOWNTAP DEV(TAP01) LIB(xxx)
The tape would be read and the save information converted to a file
in QTEMP. The QTEMP file would be read and the objects checked for
the same owner. If the owner differs, CHGOBJOWN would be attempted
to change the object on the system to the owner name of the object on
the save media.
A listing is output with one line for each object processed and flags
are used for those objects that were changed and where an error
occurs. For example, an error would occur if the the object does not
exist, is allocated, or insufficient authorization exists.
An escape message is sent if the command could not complete
Options exist to process only a specific ASP or a specific current
object owner (such as QDFTOWN). If a selection option is taken, any
objects that are bypassed do not appear on the listing.
CHGOWNTAP escape messages you can monitor for
TAA9893 Some error occurred.
Escape messages from based on functions will be re-sent.
Command parameters *CMD
DEV The tape device to be used.
LIB The library on tape (the tape label) to be
converted. A specific library or *ALL may be
If a specific library is named, the tape which is
mounted is searched (beginning at the current file
sequence number) for that library. If the library
is not on the tape, an error message will occur.
An entry of *ALL specifies that all files on the
tape will be processed. File sequence 1 is used
first. If a multi-volume tape was written, the
CHGOWNTAP command will not cause a request to mount
a subsequent tape. It will end at the end of the
mounted tape. To do all files for a multi-volume
save, you need to mount each tape of the
multi-volume save and use CHGOWNTAP on each tape.
ENDOPT The operation to be performed on the tape volume
when the tape has been read. The default is *REWIND
to rewind the tape.
*UNLOAD may be specified to unload the tape.
ASP The ASP of the objects to be processed. The default
is *ALL. A value in a range of 1 - 99 may be
entered. If a specific ASP is entered, any objects
not in the ASP are bypassed and do not appear in the
CUROBJOWN The current owner of the objects to be processed.
The default is *ALL. A specific name may be entered
such as QDFTOWN. If a specific current owner is
entered, any objects not owned by that user profile
name are bypassed and do not appear in the listing.
Multi-volume tape files are supported by using a unique CHGOWNTAP
command for each volume.
The sub tool CVTTAPSAVD is English language dependent.
The following TAA Tools must be on your system:
CVTTAPSAVD Convert Tape Save Description
EDTVAR Edit variable
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHGOWNTAP *CMD TAASEFH QATTCMD
TAASEFHC *PGM CLP TAASEFHC QATTCL
TAASEFHR *PGM RPG TAASEFHR QATTRPG
Added to TAA Productivity tools June 1, 2002