The Saved Owned Objects command saves objects owned by a specific
user from a named library. A list of object types may be named. You
must have *SAVSYS special authority to use SAVOWNOBJ. There is a
limit of 300 objects that may be saved.
A typical command would be:
SAVOWNOBJ LIB(ABC) OWNER(TOM) DEV(TAP01) CLEAR(*ALL)
The objects owned by TOM in the ABC library would be saved to TAP01.
The default is to run the CHKSAVRST command with ERRORSONLY(*YES)
after the save occurs to provide a simple review of any error
conditions.
A limit of 300 objects may be saved.
Attempting to save the same name of an object (such as a *FILE and a
*PGM) is prevented For example, if you need to save multiple objects
named ABC, multiple SAVOWNOBJ commands would be required.
SAVOWNOBJ escape messages you can monitor for
---------------------------------------------
CPF2123 No objects exist of the type named
TAA9894 No objects are owned by the specified user
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
LIB The library containing the objects to be saved.
OWNER The owner of the objects to be saved.
DEV The device where the save should occur to. *SAVF
must be specified if a save file is to be used.
VOL The tape volume to be checked. *MOUNTED is the
default to mean the volume that is currently on the
device.
A specific volume ID may be entered.
If the device specified is a media library device,
then the volume specified should be the cartridge
identifier to be mounted and used.
OBJ The name or generic name of the objects to be saved.
The default is *ALL for all object names to be
considered.
OBJTYPE A list of up to 100 object types to be saved. The
default is *ALL for all object types. For a list of
the object types, use the command prompter.
SEQNBR The sequence number to start the save operations.
The default is 1. A specific sequence number may be
entered in a range of 1-99999. For more
information, see the same parameter on the SAVLIB
command.
ENDOPT The end operation for the device. The default is
*REWIND. *LEAVE or *UNLOAD may also be specified.
For more information, see the same parameter on the
SAVLIB command.
If multiple SAVOBJ commands are required to write to
a tape device, *LEAVE is specified for each. When
the command is complete, CHKTAP is used with the
ENDOPT value specified.
CLEAR Whether to clear the files on the volume beginning
at the sequence number described. *NONE is the
default meaning no active data is cleared. If an
active file is encountered, an inquiry message will
result.
*ALL may be specified to clear all files.
Expiration dates will not be considered.
The following values are the same as various SAVxxx
commands. For more information, see the same
parameter on the SAVLIB command.
*AFTER may be specified to clear all files after the
first volume. An inquiry message occurs if active
files exist on the first volume.
*REPLACE may be specified to clear all files the
same as *ALL.
SAVF If DEV(*SAVF) is specified, a save file must be
named. The library defaults to *LIBL. *CURLIB may
also be specified.
EXPDATE The expiration date to be used for the output media.
The default is *DAY3 which means 3 days from the
current date.
*PERM may be entered to make the file permanent.
The special values *DAY1, *DAY2 ... *DAY60 may be
entered to cause an expiration date of 1, 2 ... 60
days from today.
A specific date entered in job format may also be
used.
DTACPR Whether to use data compress. The values are passed
thru to the SAVLIB command. For a complete
understanding of the parameter, see the SAVLIB
command.
The default is *YES to compress the data.
*NO may be specified so the data will not be
compressed.
*LOW may be specified to compress to a low degree.
*MEDIUM may be specified to compress to a medium
degree.
*HIGH may be specified to compress to a high degree.
COMPACT Whether to use compaction as the output is written.
The default is *DEV meaning to use any data
compression offered by the device.
*NO may also be specified. For more information,
see the same parameter on the SAVLIB command.
TGTRLS The target release to be used for the save. The
default is *CURRENT for the current release. For
the other options, use the command prompter.
UPDHST A *YES/*NO option for whether to update the save
history information for each object saved. *YES is
the default.
*NO may be specified to bypass updating of the save
history.
CHKSAVRST A *YES/*NO option for should the TAA Tool CHKSAVRST
command be run. The default is *YES. The CHKSAVRST
command will produce a spooled file of the S/R
messages which have occurred during the job.
ERRORSONLY A *YES/*NO option for should the CHKSAVRST command
ERRORSONLY option be used. *YES is the default.
The default is designed to further 'net out' the job
log. The printed listing will essentially take the
library completion message information and print a
summary. If any objects were not saved, the detail
message will appear in the job log if the *YES
option is taken. The entry is ignored if
CHKSAVRST(*NO) is specified.
Restrictions
------------
You must have *SAVSYS special authority to use SAVOWNOBJ.
Since SAVOBJ is used internally within SAVOWNOBJ, a limit of 300
objects may be saved.
Attempting to save the same name of an object (such as a *FILE and a
*PGM) is prevented
Prerequisites
-------------
The following TAA Tools must be on your system:
ADDDAT Add date
CHKDAT Check date
CHKOBJ3 Check object 3
CHKSAVRST Check save/restore
EDTVAR Edit variable
EXTLST2 Extract list 2
RSNLSTMSG Resend last message
RTVSPCAUT Retrieve special authority
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SAVOWNOBJ *CMD TAASAWG QATTCMD
TAASAWGC *PGM CLP TAASAWGC QATTCL
|
