SAVJRNRCV SAVE JOURNAL RECEIVERS TAAJROO |
The Save Journal Receiver command saves all, active, or detached
receivers for a specific journal. Saving an active receiver (not
detached) is supported by the the system, but can make it awkward to
restore.
You must have the *SAVSYS special authority to use SAVJRNRCV.
Most of the parameters on SAVJRNRCV are passed thru to the SAVOBJ
command. For a full explanation of the parameters, see the SAVOBJ
command.
A typical command would be:
SAVJRNRCV JRN(xxx) TYPE(*DETACHED) UDEV(yyy)
The detached receivers for the named journal would be saved. The
library used by the journal receivers is the library used for the
SAVOBJ LIB parameter. All journal receivers for the named journal
must be in the same library.
SAVJRNRCV escape messages you can monitor for
---------------------------------------------
TAA9891 No receivers that match the TYPE exist
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
JRN The qualified name of the journal object. The
library value defaults to *LIBL. A specific library
or *CURLIB may also be used.
TYPE The type of receivers to be saved.
*ALL is the default to save all types.
*ACTIVE may be specified to save only the active
receivers (multiple active receives are supported by
the system).
*DETACHED may be specified to save only the detached
receivers that are no longer active.
DEV The device to be used. Up to 4 devices may be named
or the special values *SAVF or *MEDDFN.
VOL The volume identifier to be used. The default is
*MOUNTED. Up to 75 volumes may be named.
SEQNBR The sequence number of the file on tape to be used.
The default is *END to write after the last file on
tape. A number between 1 and 16777215 may be
entered.
LABEL The label on the tape to be used. *LIB is the
default which is the name of the library where the
journal receivers exist.
EXPDATE The expiration date if the data is written to tape.
*PERM is the default to permanently protect the
tape. An expiration date may be entered in job
format.
ENDOPT The operation to be performed on the tape when
writing is complete. *REWIND is the default.
*LEAVE or *UNLOAD may be specified.
SAVF If DEV(*SAVF) is entered, a qualified name of a save
file must be entered. The library qualifier
defaults to *LIBL. A specific library or *CURLIB
may be entered.
MEDDFN The media definition object to be used if
DEV(*MEDDFN) is specified. The library qualifier
defaults to *LIBL. A specific library or *CURLIB
may be entered.
USEOPTBLK A *YES/*NO option for whether the optimum block size
should be used when writing to tape. Some tape
devices support a larger block size than the basic
32K block size used for Save/Restore. *YES is the
default. *NO may be specified to use a 32K block
size.
TGTRLS The target release that you intended to restore the
receivers to.
*CURRENT is the default meaning the current release.
Use the command prompter to see the other values.
UPDHST A *YES/*NO option for whether the DSPOBJD
information regarding the last save date should be
updated.
*YES is the default to update the history
information.
*NO may be specified to not update the history
information.
CLEAR An option that determines if any active data is
cleared before writing. *NONE is the default which
will prevent writing over active data unless the
tape is positioned beyond the last file.
*ALL may be specified to clear all active data.
*AFTER and *REPLACE may be specified.
STG Whether the storage for the journal receivers should
be cleared. *KEEP is the default to retain the data
online. *FREE may be specified to free the storage
online.
DTACPR Specifies whether data compression should be used.
*DEV is the default to use the device compression
capability. *NO, *YES, *LOW, *MEDIUM, or *HIGH may
be specified.
COMPACT Specifies whether data compaction should be used.
*DEV is the default meaning compaction will be used
if supported by the device. *NO may be specified to
prevent compaction.
ASPDEV The auxiliary storage pool device to be used. * is
the default. See the same parameter of SAVOBJ for a
full discussion.
OUTPUT The type type of output to be created. *NONE is the
default.
*OUTFILE may be entered to create an outfile in
which case the OUTFILE parameter must be entered.
*PRINT may be entered to print a listing.
OUTFILE The name of the outfile to be output if
OUTPUT(*OUTFILE) is specified. The model file is
QASAVOBJ in QSYS with a format name of QSRSAV. The
library qualifier does not default. A specific
library or *CURLIB must be entered.
OUTMBR A 2 part parameter to describe the member of the
outfile and whether to replace any existing data.
The first part is the name of the member of the
outfile to write data to. The default is *FIRST.
The second part determines whether any existing data
will be replaced. *REPLACE is the default. *ADD
may be specified to add to any existing data.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CHKSPCAUT Check special authority
CVTJRNA Convert journal attributes
EDTVAR Edit variable
EXTLST2 Extract list 2
RSNLSTMSG Resend last message
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDLNGMSG Send long 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
------ ---- --------- ---------- ----------
SAVJRNRCV *CMD TAAJROO QATTCMD
TAAJROOC *PGM CLP TAAJROOC QATTCL
|
Added to TAA Productivity tools January 1, 2007
