TAA Tools
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


Home Page Up to Top