TAA Tools
SAVE2         SAVE 2 MENU                            TAASAVT

The SAVE2 tool  provides a menu of  save functions that are  similar to
the system SAVE  menu, but only for options 20, 21,  22, and 23.  SAVE2
provides  better function  than the system  menu.  A  starting date may
be entered as well  as a function that  allows a start when batch  work
has completed.   By  default the TAA  Tools of CHKSAVRST  and PRTSAVLBL
occur automatically.

A  test  option  (Option  82) allows  you  to  try  most  of the  SAVE2
functions without requiring  the restricted  state or  causing a  large
save  to  occur.    You  should use  the  test  option  to  familiarize
yourself with  the SAVE2 functions before using  Options 21, 22, or 23.
See the later discussion of the Test option.

Normal use
----------

SAVE2 is designed to  allow an unattended save  to occur.  The  command
should  be  entered  at a  workstation  in  the  Controlling  Subsystem
before  going home.   The SAVE2 tool  is designed to  provide functions
which the system SAVE menu does not such as:

  **   The  workstation device is protected while  the function is in a
       time  delay and  while  the  function  is running.    If  System
       Request Option  2 (End Previous  Request) is entered,  a signoff
       occurs.   With  the system  SAVE menu,  System Request  Option 2
       can be used  to end  the current  function and allow  a user  to
       operate as the user who is signed on.

  **   The  workstation device  can  be protected  when  the option  is
       complete.   Options  exist to  signoff, powerdown,  or powerdown
       with reset.  When  the system SAVE menu  option is complete,  it
       does a return  and allows a user  to operate as the user  who is
       signed on.

  **   A  time delay can  be greater  than 24  hours.  A  specific date
       and  time  may  be entered.    The  system save  can  only delay
       within the next 24 hours.

  **   The save  can begin  after batch work  has completed.   See  the
       later discussion.

  **   If POWERDOWN(*NO) is specified for the DLYCMD, by default:

         --   The TAA  CHKSAVRST command is  run with ERRORSONLY(*YES).
              This  provides  a spooled  file with  any  SAVxxx command
              errors that have occurred during the save.

         --   The TAA  TAA  PRTSAVLBL  command  is run  which  makes  a
              spooled file  with a  label that can  be attached  to the
              media.   A separate label  is created for  each tape that
              is mounted.

  **   If POWERDOWN(YES) is specified for  the DLYCMD, see the  section
       on 'Powering down or Signoff with CHKSAVRST/PRTSAVLBL'.


SAVE2 Menu
----------

The user  of SAVE2  must have  *JOBCTL and  *SAVSYS special  authority.
This  allows the  use of  the  Save options.   The  function  cannot be
adopted.   *ALLOBJ special  authority is required  for the options that
permanently change default values.

SAVE2 is a menu and would be invoked by:

             GO  SAVE2

The menu would appear as follows:

************************************************************
*                                                          *
*     Save system and user data                            *
*       20. Define save system and user data defaults      *
*       21. Entire system                                  *
*       22. System data only                               *
*       23. All user data                                  *
*                                                          *
*     TAA Options                                          *
*       80. Edit application values for SAVE2              *
*       81. Set DLYCMD defaults                            *
*       82. Test save of one object from TAATOOL           *
*       83. CHKTAPRDY command                              *
*       84. DSPTAPVOL command                              *
*                                                          *
************************************************************

Assume you take Option 21 to save the system.  The following occurs:

  **   A screen  is  shown which  describes what  the  option will  and
       will not do.  This is similar to the same system display.

  **   The  'Specify  Command Defaults'  screen  is  shown.   The  only
       change  from the system display is that  the prompt for 'time of
       day' has been moved to the  first line and a date prompt  added.

  **   You may  enter a  date and/or time  or use  the defaults  to run
       the function immediately.

         --   The  TAA DLYCMD command  prompt appears  and allows other
              options to  be specified  such as  should the  device  be
              signed off when  the save completes or should  the system
              be powered  down.  The command prompt  may be bypassed by
              setting  a value  using Option 80  so that  the user will
              go directly to the DLYCMD display.

         --   The DLYCMD display  appears which describes the  function
              to be  performed and other information such  as the delay
              time  and whether batch  work should  be completed first.

              DLYCMD protects  the  device.   No  entries  are  allowed
              once the display  appears.  The only  functions which can
              be used  are the System Request  functions such as Option
              6 to display a message  queue.  If System Request  Option
              2  (End Previous  Request)  is used,  the  job is  signed
              off.

         --   If no  date or time  was entered, the function  is to run
              immediately.    The  DLYCMD display  will  appear  with a
              message that it is  waiting for 30 seconds.   This allows
              the  operator   time  to   confirm  his   choices  before
              performing  a  long running  function.   If  the operator
              decides  to  cancel,  he  may  use  the   System  Request
              function for Option  2 to 'End Request'  (this will cause
              the job to be signed off).

         --   When  the  time delay  and the  batch  completion options
              are  satisfied,  the  DLYCMD  function  causes  the  save
              function  to  occur.     The  TAA  tools   CHKSAVRST  and
              PRTSAVLBL are run by default.

         --   Based  on  the  DLYCMD option,  either  a  return to  the
              SAVE2 menu, a signoff, or a powerdown occurs.

For  best use  of SAVE2, an  *ALLOBJ special authority  user should use
Options 20,  80, and  81 to  specify  permanent defaults  to allow  the
system  operator  to  enter  a  minimal amount  of  information.    For
example,  the  Security Officer  can  decide  such things  as  will the
device be signed off  when the function  is complete, how to  recognize
when batch  work is complete,  and should  the operator see  the DLYCMD
prompt.   This would allow  the operator to request  GO SAVE2 and enter
only:

       - The Save Option to be performed
       - The time to begin the save (and an optional date) if any

All of  the other  functions could  be defaulted  so the  next  display
would be the DLYCMD display (not the command prompt).

Starting the Save when batch work has completed
-----------------------------------------------

The DLYCMD  function is used  to determine when  the Save operation  is
started.    The  default is  to  occur  immediately  (current date  and
time).

However,  by specifying  a value for  the DLYCMD  MAXJOBS parameter and
naming one or  more subsystems, you  can cause the  Save to begin  when
batch work is completed.

Because many  systems have 'never ending batch  jobs' that periodically
'wake  up' when some event  has occurred (such as  an entry arriving on
a data  queue  or  DLYJOB is  used  and  the program  checks  for  some
activity),  it can  be difficult  to  determine when  'no normal  batch
work' is running.

There are two typical solutions to running batch using i5/OS.

  **   Using QBASE  subsystem.  This normally means  you are also using
       QBASE as  the Controlling  Subsystem.   Because  QBASE  contains
       several 'never  ending  jobs' started  by the  system, you  must
       know when  there is 'no  normal batch work' running  in order to
       start the save operation.

       A  special  function  is  provided with  the  RTVSBSBCH  tool to
       allow for this.   It allows you to  determine when there is  'no
       normal batch  work'.   To use the  RTVSBSBCH function,  you must
       first  become familiar with  the RTVSBSBCH tool.   It provides a
       test  aid  (PRTSBSBCH)  to  assist  in  determining  any  unique
       situations relative  to your  system.   Once this  is determined
       and any changes are made to the defaults, you would specify:

                 DLYCMD    ... MAXJOBS(*RTVSBSBCH) SBS(QBASE)

  **   Using  QBATCH  subsystem.   This  normally means  you  are using
       QCTL as the Controlling  Subsystem.  If  you have 'never  ending
       jobs' in  QBATCH,  you must  either place  them  in a  different
       subsystem  or use  the RTVSBSBCH  tool  described for  the QBASE
       solution.    If you  have no  'never ending  jobs' in  the batch
       subsystem, the subsystem  can be deemed  to have completed  work
       when  only a  single job  remains (the  subsystem monitor).   To
       use this approach, you would specify:

                 DLYCMD    ... MAXJOBS(1) SBS(QBATCH)

To  start the save when  batch work is completed,  you should specify a
delay time  as the earliest  time you  expect batch  work to  complete.
When the  time delay is  met, the function  of checking for  the number
of batch  jobs begins.  If  batch jobs are still  running, the function
waits for the DLYCMD WAITTIME parameter value and then tries again.

With either  technique  of  specifying  MAXJOBS,  the  DLYCMD  function
attempts to  ensure that  a 'window' has  not been  found where  no new
batch  work has  been  started.   Before  the Save  begins,  the DLYCMD
function  waits 30 seconds and determines  if there is still 'no normal
batch work'.    This  process must  be  met  3 times  before  the  Save
begins.

Option 20 - Define save system and user data defaults
-----------------------------------------------------

Option  20 shares  the same  function as  provided by  the  system SAVE
menu.   It allows  the defaults  (such as the  tape drive  names) to be
tailored so  that the  other  options do  not require  re-entering  the
same values each time  they are used.  If you have  changed the options
via the SAVE menu, they will be the same for SAVE2 and vice versa.

Options 21, 22, 23  - Save entire system, system data, user data
----------------------------------------------------------------

Options   21,  22,   and  23,   provide  the   same  function   as  the
corresponding system display.   The DLYCMD  function occurs before  the
save begins.   When the  DLYCMD criteria is  satisfied (such as  a time
delay),  the same system  function is  used to  perform the save  as is
used by the system SAVE menu.

Option 80 Edit Application Values
---------------------------------

Using  Option 80  will provide  a display  where the  SAVE2 Application
Values may  be changed.   Only an  *ALLOBJ special  authority user  can
use Option 80.  The values that can be changed are:

  **   CHKSAVRST.   Whether to  use the TAA  CHKSAVRST ERRORSONLY(*YES)
       function  following a  save.   This provides  a spooled  file of
       any Save  errors  that  have  occurred during  the  Save.    The
       spooled file is easier to read than the job log.

  **   PRTSAVLBL.     Whether  to  use   the  TAA   PRTSAVLBL  function
       following  a  save.   This  will generate  a  spooled  file with
       appropriate labels that can be attached  to the media.  A  label
       is generated for each  tape used.  You can tailor  the label for
       your own requirements (see the PRTSAVLBL tool).

  **   Exit Before  Save program.  You may specify  a program that will
       run  before the Save command.   The program is called just after
       the timeout has  occurred and before  any subsystems are  ended.
       For example,  if you set the  DLYCMD TIME parameter  for 3:00 AM
       or  when  all  batch  work  has  been  completed,  a time  delay
       occurs.   When  the timeout  is  met,  the before  exit  program
       runs.

  **   Exit After Save  program.  You may  specify a program to  be run
       after the  save has ended if  the job is still  active or one of
       the special values *PWRDWN or *SIGNOFF.

       The  exit  program  runs  after  the  CHKSAVRST  and   PRTSAVLBL
       functions.   Note that neither  of these  functions will run  if
       the DLYCMD option requests a power down or a signoff.

       The  special  value  *PWRDWN  may  be  specified  for  the  exit
       program  to cause the  system to power  down after the CHKSAVRST
       and PRTSAVLBL functions.

       The  special  value *SIGNOFF  may  be  specified  for  the  exit
       program to  cause the job to  be signed off after  the CHKSAVRST
       and PRTSAVLBL functions.  The signon prompt would appear.

       Note  that  the  DLYCMD  options  can  prevent  the  Exit  After
       program  from  running.    If  you  specify  POWERDOWN(*YES)  or
       SIGNOFF(*YES)  on the  DLYCMD, the  job running  SAVE2 is  ended
       after  the save  command completes.   Therefore,  the CHKSAVRST,
       PRTSAVLBL, and Exit After functions will not be run.

  **   DLYCMD Prompt  Option.   You  may  specify whether  or  not  the
       DLYCMD prompt  will occur.   If  you have set  the defaults  for
       this display  (using Option 81)  and the operator  has specified
       a  Save Option  and optionally a  delay time,  there is probably
       no reason to see the command prompt.

The defaults are kept  in the SAVE2 Application Value  (*USRSPC) object
in TAASECURE.

Option 81 Set DLYCMD defaults
-----------------------------

This  option allows setting  of the  defaults when  the DLYCMD  tool is
used.   Specifying the  defaults is important  if you use  Option 80 to
bypass the DLYCMD command prompt.

Only an  *ALLOBJ  special  authority  user  can use  Option  81.    The
defaults are  stored in a data  area (DLYCMD) in the  TAASECURE library
and are used by a prompt override program for DLYCMD.

The  critical parameters  are usually those  that determine  when batch
work is  complete (MAXJOBS)  and  what to  do  when the  save  function
completes (Signoff, powerdown, etc.).

You do  not have to enter  a value for  the CMD parameter  ('Command to
execute').    This  will   be  inserted  automatically  when  the  user
determines which save option to run.

Note   that  this  option  (81)  invokes  the  TAA  SETDLYCMD  command.
SETDLYCMD can be  used directly to set  the DLYCMD defaults.   There is
only one set of  defaults for DLYCMD that are used.   This means if you
use DLYCMD directly or via SAVE2, you will see the same defaults.

Option 82 Test save function
----------------------------

This  option  lets you  try  out some  of  the functions  of  SAVE2 and
DLYCMD.  After  selecting the option,  a screen appears  where you  can
request  whether or  not you  wish to  enter the  restricted state  (by
ending  all subsystems).   By  not entering  the restricted  state, you
can become familiar with the SAVE2 functions.

The same prompt appears  as is used  for Option 21, 22,  and 23.   This
allows you  to enter a tape  device name.   The first device  name will
be used for the test save (multiple devices are not supported).

You  can specify either  or both Option  80 or  81 to help  control the
defaults that will be used by the test save function.

Option 83 CHKTAPRDY Command
---------------------------

The  CHKTAPRDY  command  is intended  to  be  used when  you  are first
mounting tapes to  be saved  to at a  later time.   CHKTAPRDY lets  you
check  a volume ID  and/or do  a sanity  test to  the device  to ensure
that  it can be written to  and read and that  the Save/Restore code is
working.

If the  CHKTAPRDY  default  is used,  there  is no  check  for  whether
active files  exist (you must manually  ensure that the proper  tape is
mounted).

The sanity  test is not a  guarantee that you will be  able to read the
tape that is  written if  you have to  do a  restore.  A  data area  is
saved  and then  restored  to  QTEMP  and compared  with  the  original
value.   Yesterdays date is  used as the  expiration date for  the tape
label  to  allow  any subsequent  saves  to occur  without  active file
considerations.

Option 84 DSPTAPVOL Command
---------------------------

The  DSPTAPVOL  command  provides  a  simple  and   fast  solution  for
determining the volume  ID for a mounted tape.   A display appears with
the  volume ID and provides simple  Function keys to access information
about the tape  labels.  Either  the system DSPTAP  command or the  TAA
DSPSAVTAP command can be run by pressing a Function key.

Powering down or Signoff with CHKSAVRST/PRTSAVLBL
-------------------------------------------------

If  the   DLYCMD  specifies   POWERDOWN(*YES)  or   SIGNOFF(*YES),  the
CHKSAVRST, PRTSAVLBL, and exit after program will not be run.

If  you want  CHKSAVRST  and PRTSAVLBL  to run  after a  save  and then
power down  or  signoff,  specify  the  DLYCMD  as  POWERDOWN(*NO)  and
SIGNOFF(*NO).   Use  Option 80  from  the SAVE2  menu  and specify  the
'Exit after' program as *PWRDWN or *SIGNOFF.

Preventing other System Request options
---------------------------------------

The SAVE2  menu prevents the user from entering  Option 2 (End Previous
Request)  and operating as the user who is  signed on.  If End Previous
Request is specified, the job is signed off.

The System Request menu will also allows:

        Option  1    Transfer to an Alternate Job
        Option 80    Disconnect the Job

It is possible to prevent  both of these options by creating  a special
profile.  See the discussion with the DLYCMD of 'Tighter Security'.

SAVOPT command                                   *CMD
--------------

The  command that  does  most of  the  save work  is  the internal  TAA
command  SAVOPT.  This command  is not intended to  be run directly (it
will send an escape message  if not used as  part of SAVE2).  When  the
SAVE2 menu  is used, for options  20, 21, 22,  or 82, you will  see the
SAVOPT  command name on  the DLYCMD prompt  for the CMD  parameter (the
parameter is protected).

The SAVOPT  command  provides function  that  wraps around  the  system
supplied programs  that perform  each of  the save options.   Thus  the
specification  of what  libraries  are actually  saved is  done  by the
same  system function  that occurs  using the  system SAVE menu  (it is
not unique TAA code).

SAVOPT Command parameters                             *CMD
-------------------------

   OPTION        The save  option to be  run.  The  option must be  21,
                 22, 23, or 82.

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

You  must  have both  *SAVSYS  and  *JOBCTL  special authority  to  use
SAVE2.  The function cannot be adopted.

To  use  Option  20  (Change save  system  defaults),  Option  80 (Edit
Application Values),  or  Option  82  (Set  DLYCMD  defaults)  requires
*ALLOBJ special authority.

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

The following TAA Tools must be on your system:

     ADDDAT          Add date
     ADDTIM          Add time
     APPVAL          Application value
     CHKRSDSTE       Check restricted state
     CHKSAVRST       Check save restore
     CHKTAPRDY       Check tape ready
     CHKTIM          Check time
     CVTTIM          Convert time
     DLYCMD          Delay command
     DSPTAPVOL       Display tape volume ID
     FMTLIN          Format line
     PMTOPR          Prompt operator
     PRTSAVLBL       Print save label
     RSNLSTMSG       Resend last message
     RTVIPLSTS       Retrieve IPL status
     RTVJOBSTS       Retrieve job status
     RTVSPCAUT       Retrieve special authority
     SNDDIAGMSG      Send diagnostic message
     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
   ------        ----    ---------      ----------    ----------

   SAVE2         *MENU
   SAVOPT        *CMD                   TAASAVT3      QATTCMD
   TAASAVTC2     *PGM       CLP         TAASAVTC2     QATTCL
   TAASAVTC3     *PGM       CLP         TAASAVTC3     QATTCL
   TAASAVTC4     *PGM       CLP         TAASAVTC4     QATTCL
   TAASAVTC7     *PGM       CLP         TAASAVTC7     QATTCL
   TAASAVTC8     *PGM       CLP         TAASAVTC8     QATTCL
   TAASAVTC9     *PGM       CLP         TAASAVTC9     QATTCL
   TAASAVTD      *FILE      DSPF        TAASAVTD      QATTDDS
   TAASAVTE      *FILE      DSPF        TAASAVTE      QATTDDS
   TAASAVTF      *FILE      DSPF        TAASAVTF      QATTDDS

The SAVE2 Application Value (*USRSPC) exists in TAASECURE.


Structure
---------

SAVE2       Menu - Specifies TAASAVTC4 as the program
   TAASAVTC4  CL pgm
     TAASAVTD   Display file of menu options
     TAASAVTC7   CL pgm - Adopts to access DLYCMD defaults
     TAASAVTC9   CL pgm  Retrieve application values
     TAASAVTC8   CL pgm  'What this option will do'
       TAASAVTF    Display file
     TAASAVTC2   CL pgm  'Prompt for changes to save options'
       TAASAVTE    Display file
     TAASAVTC7   CL pgm  Adopts to access DLYCMD defaults
     SAVOPT      Cmd
       TAASAVTC3   CL pgm
         Calls system programs to perform the saves
					

Added to TAA Productivity tools December 15, 2000


Home Page Up to Top