TAA Tools
SAVSYSINF2      SAVE SYSTEM INFORMATION 2              TAASYTS

The Save  System Information  2 command is  a front  end to  the system
SAVSYSINF command.   SAVSYSINF saves a subset of  the system data saved
by  SAVSYS without requiring the system  to be in the restricted state,
but  requires  a  more  complex  recovery  scenario.     SAVSYSINF2  is
preferable  to directly  using the  system function  because SAVSYSINF2
runs  SAVSYSINF  and  then updates  a  data area  in  TAASECURE.   This
provides a version of the save  information which would be lost if  the
last SAVSYS was restored.

The  information  from  the  data  area   may  be  displayed  with  the
DSPSYSINF2 command.

You must have the save files for PTFs restored to your system.

    ********************************************************
    *                                                      *
    *     Using SAVSYSINF will cause a more complex        *
    *     recovery scenario than the use of SAVSYS.        *
    *     SAVSYSINF should not be used unless you          *
    *     cannot afford the downtime to use SAVSYS.        *
    *                                                      *
    ********************************************************

A typical SAVSYSINF2 command would be:

            SAVSYSINF2     DEV(xxx)

The  subset of  SAVSYS information  would be  written to  a tape.   The
tape will contain a save file.   The TAASYSINF2 data area in  TAASECURE
would be  updated with  the save  information.   The name  of the  tape
file written is QSAVSYSINF.

Any  user can  display the  save information  from the  TAASYSINF2 data
area in TAASECURE with:

           DSPSYSINF2

SAVSYSINF2  has  most of  the  same parameters  as  SAVSYSINF.   Only a
single device is supported as  the amount of data saved will  be small.
Optical devices are  not supported.  The OUTPUT  and OUTFILE parameters
are supported by copying from a standard file output to QTEMP.

SAVSYSINF2 Authorization
------------------------

Both  the  SAVSYSINF and  SAVSYSINF2  commands are  shipped  as *PUBLIC
*USE, but  the SAVSYSINF  command requires  *SAVSYS special  authority.
This is checked for within the SAVSYSINF2 processing.

System SAVSYSINF support
------------------------

The  purpose of  SAVSYSINF is  to allow  the infrequent  use of  SAVSYS
which requires  the system to be  placed in the restricted  state.  The
majority  of  information  from  QSYS  (outside  of  configuration  and
security information is saved).

To  recover, the  user would  restore  a SAVSYS  version  and then  use
RSTSYSINF to  restore the last  SAVSYSINF media.   There are exceptions
to  the  recovery  scenario  which  should  be  reviewed  by  using the
RSTSYSINF help text.

SAVSYS requires the restricted state and saves the following:

     - Saves the Licensed Internal Code
     - Saves the QSYS library

Security and  configuration information is  saved by  default, but  the
OMIT   parameter  allows   omission.      Security  and   configuration
information can be saved at any time by the commands:

     - SAVSECDTA
     - SAVCFG

SAVSYSINF  may be  used without entering  the restricted  state to save
various object types that  are rarely changed  in QSYS such as  *JOBDs,
*JOBQs, *SBSDs, etc.  Also saved are such items as:

     - System reply list
     - Network attributes
     - PTFs applied since the last SAVSYS

For  a full  discussion  of the  items  saved, see  the  help text  for
SAVSYSINF.

After  restoring   the  TAATOOL  and  TAASECURE  libraries,  you  could
determine the last use of SAVSYSINF or SAVSYSINF2.

SAVSYSINF writes to the file  named QSAVSYSINF and updates the  QSYSINF
data area (use DSPOBJD2 to see the last save information).

SAVSYSINF2 escape messages you can monitor for
----------------------------------------------

None.  Escape messages from based on functions will be re-sent.

SAVSYSINF2 Command parameters                         *CMD
-----------------------------

   DEV           The device name to  be used.  The special  value *SAVF
                 may be used  to save to a save  file.  It is generally
                 preferable  to  save  directly  to  tape  so  the tape
                 volume name may be captured.

   VOL           The volume  identifier of  the tape.   The default  is
                 *MOUNTED.  Up to 75 volumes may be entered.

   SEQNBR        The sequence  number to be used as  the starting point
                 of  the  save.    *END  is  the  default.    A  number
                 1-6777215 may be entered.

   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.

   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.

   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.    See  the
                 SAVSYSINF command for a full discussion.

   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.   See the SAVSYSINF  command for a  full
                 discussion.

   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.   See the SAVSYSINF command  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.
                 The named outfile must not exist.

   OUTFILE       The   name   of   the   outfile  to   be   output   if
                 OUTPUT(*OUTFILE)  is  specified.   The  file  must not
                 exist.   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        The name of the  member of the  outfile to write  data
                 to.  The default is *FIRST.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CVTTIM          Convert time
     EDTVAR          Edit variable
     EXTLST2         Extract list 2
     RSNLSTMSG       Resend last message
     RTVDBFRR        Retrieve data base file RR
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape 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
   ------        ----    ---------      ----------    ----------

   SAVSYSINF2    *CMD                   TAASYTS       QATTCMD
   DSPSYSINF2    *CMD                   TAASYTS2      QATTCMD
   TAASYTSC      *PGM       CLP         TAASYTSC      QATTCL
   TAASYTSC2     *PGM       CLP         TAASYTSC2     QATTCL
   TAASYTSD      *FILE      DSPF        TAASYTSD      QATTDDS

Structure
---------

SAVSYSINF2  Cmd
   TAASYTSC   CL pgm

DSPSYSINF2  Cmd
   TAASYTSC2   CL pgm
     TAASYTSD    Display file
					

Added to TAA Productivity tools January 1, 2007


Home Page Up to Top