RTVIPLA -- Retrieve IPL Attributes

RTVIPLA RETRIEVE IPL ATTRIBUTES TAASYSS
The Retrieve IPL Attributes command retrieves the default attributes that will be used on the next IPL. The values can be seen with the DSPIPLA display. The values may be changed by the system command CHGIPLA or if a manual IPL is performed. A typical series of commands would be: DCL &STRPRTWTR CHAR LEN(4) . RTVIPLA STRPRTWTR(&STRPRTWTR) IF (&STRPRTWTR EQ 'YES') DO The system API QWCRIPLA is used which first appeared in V4R2M0. RTVIPLA Command parameters CMD -------------------------- RESTART A return variable for the type of restart to perform when PWRDWNSYS is used with RESTART(YES). The values SYS (Restart just the Operating System) or FULL (Restart the hardware and the Operating System) will be returned. If specified, the variable must be declared as CHAR LEN(10). KEYLCKPOS A return variable for how the keylock position is set. The values MANUAL, NORMAL, AUTO, or SECURE will be returned. If specified, the variable must be declared as CHAR LEN(10). HDWDIAG A return variable for the type of hardware diagnostics to be run at IPL. The values MIN (minimum diagnostics) or ALL (all diagnostics) will be returned. If specified, the variable must be declared as CHAR LEN(10). CPRJOBTBL A return variable for whether the job tables will be compressed at IPL. The values NONE (not compressed), NORMAL (compressed on a normal IPL), ABNORMAL (compressed on an abnormal IPL), or ALL (compressed on any IPL) will be returned. If specified, the variable must be declared as CHAR LEN(10). CHKJOBTBL A return variable for whether damage checking of job tables will be performed at IPL. The values ALL (checked on any IPL), ABNORMAL (checked on an abnormal IPL), or SYNC (checked asynchronously on all IPLs) will be returned. If specified, the variable must be declared as CHAR LEN(10). RBDPRDDIR A return variable for whether the product directory will be rebuilt at IPL. The values NONE (not fully rebuilt), ALL (rebuilt on any IPL), NORMAL (rebuilt on any normal IPL), or ABNORMAL (rebuilt on any abnormal IPL) will be returned. If specified, the variable must be declared as CHAR LEN(10). MSFRCY A return variable for whether Mail Server Framework recovery will be done at IPL. The values NONE (not rebuilt), or ABNORMAL (rebuilt on any abnormal IPL) will be returned. If specified, the variable must be declared as CHAR LEN(10). CLRJOBQ A return variable for whether job queues will be cleared at IPL. The values YES or NO will be returned. If specified, the variable must be declared as CHAR LEN(4). CLROUTQ A return variable for whether output queues will be cleared at IPL. The values YES or NO will be returned. If specified, the variable must be declared as CHAR LEN(4). CLRINCJOB A return variable for whether incomplete job logs will be cleared at IPL. The values YES or NO will be returned. If specified, the variable must be declared as CHAR LEN(4). STRPRTWTR A return variable for whether print writers will be started at IPL. The values YES or NO will be returned. If specified, the variable must be declared as CHAR LEN(4). STRRSTD A return variable for whether the system will be started in the restricted state. The values YES or NO will be returned. If specified, the variable must be declared as CHAR LEN(4). DSPSTS A return variable for the whether the system will display information during an IPL at the console. The values QSYS, NONE, ATTEND, ABNORMAL, or ALL will be returned which have the same meaning as the corresponding values on DSPIPLA. If specified, the variable must be declared as CHAR LEN(10). STRTCP A return variable for whether the system will start TCP (STRTCP) command as part of an IPL. The values YES or NO will be returned. If specified, the variable must be declared as CHAR LEN(4). SPLRCV A return variable for the type of spooled file recovery that will occur during an IPL when a job table is detected as damaged. The values DETACH or REMOVE will be returned which have the same meaning as the corresponding values on DSPIPLA. If specified, the variable must be declared as CHAR LEN(10). Restrictions ------------ None. Prerequisites ------------- None. Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- RTVIPLA CMD TAASYSS QATTCMD TAASYSSC PGM CLP TAASYSSC QATTCL

RTVIPLA         RETRIEVE IPL ATTRIBUTES                TAASYSS


The Retrieve  IPL Attributes command  retrieves the  default attributes
that will  be used on  the next IPL.   The values can be  seen with the
DSPIPLA  display.   The  values may  be changed  by the  system command
CHGIPLA or if a manual IPL is performed.

A typical series of commands would be:

             DCL           &STRPRTWTR *CHAR LEN(4)
              .
             RTVIPLA       STRPRTWTR(&STRPRTWTR)
             IF            (&STRPRTWTR *EQ '*YES') DO

The system API QWCRIPLA is used which first appeared in V4R2M0.

RTVIPLA Command parameters                            *CMD
--------------------------

   RESTART       A return variable for  the type of restart to  perform
                 when  PWRDWNSYS  is  used  with  RESTART(*YES).    The
                 values  *SYS (Restart  just  the Operating  System) or
                 *FULL  (Restart   the  hardware   and  the   Operating
                 System)  will   be  returned.     If   specified,  the
                 variable must be declared as *CHAR LEN(10).

   KEYLCKPOS     A  return  variable for  how the  keylock  position is
                 set.  The values  *MANUAL, *NORMAL, *AUTO, or  *SECURE
                 will be  returned.   If specified,  the variable  must
                 be declared as *CHAR LEN(10).

   HDWDIAG       A   return   variable  for   the   type  of   hardware
                 diagnostics  to  be  run  at  IPL.    The  values *MIN
                 (minimum diagnostics) or  *ALL (all diagnostics)  will
                 be  returned.   If  specified,  the  variable must  be
                 declared as *CHAR LEN(10).

   CPRJOBTBL     A  return variable for whether the  job tables will be
                 compressed  at   IPL.      The   values   *NONE   (not
                 compressed),  *NORMAL (compressed  on  a normal  IPL),
                 *ABNORMAL  (compressed on  an  abnormal IPL),  or *ALL
                 (compressed  on  any  IPL)  will  be  returned.     If
                 specified,  the variable  must  be declared  as  *CHAR
                 LEN(10).

   CHKJOBTBL     A return  variable for whether damage  checking of job
                 tables  will  be performed  at IPL.   The  values *ALL
                 (checked  on  any  IPL),  *ABNORMAL  (checked   on  an
                 abnormal  IPL), or  *SYNC  (checked asynchronously  on
                 all  IPLs)  will  be  returned.    If  specified,  the
                 variable must be declared as *CHAR LEN(10).

   RBDPRDDIR     A return variable  for whether  the product  directory
                 will be rebuilt  at IPL.  The values  *NONE (not fully
                 rebuilt),   *ALL   (rebuilt  on   any   IPL),  *NORMAL
                 (rebuilt on  any normal  IPL), or  *ABNORMAL  (rebuilt
                 on  any   abnormal  IPL)   will  be   returned.     If
                 specified,  the  variable must  be  declared as  *CHAR
                 LEN(10).

   MSFRCY        A  return variable  for whether  Mail Server Framework
                 recovery will be done  at IPL.  The values  *NONE (not
                 rebuilt), or  *ABNORMAL (rebuilt on  any abnormal IPL)
                 will  be returned.   If  specified, the  variable must
                 be declared as *CHAR LEN(10).

   CLRJOBQ       A return  variable  for  whether job  queues  will  be
                 cleared  at IPL.    The values  *YES  or  *NO will  be
                 returned.     If  specified,  the   variable  must  be
                 declared as *CHAR LEN(4).

   CLROUTQ       A return variable  for whether output  queues will  be
                 cleared  at IPL.    The values  *YES  or *NO  will  be
                 returned.     If  specified,  the   variable  must  be
                 declared as *CHAR LEN(4).

   CLRINCJOB     A  return  variable  for whether  incomplete  job logs
                 will be cleared at IPL.   The values *YES or  *NO will
                 be  returned.   If  specified,  the  variable must  be
                 declared as *CHAR LEN(4).

   STRPRTWTR     A  return variable for  whether print  writers will be
                 started at  IPL.   The  values  *YES  or *NO  will  be
                 returned.     If  specified,  the  variable   must  be
                 declared as *CHAR LEN(4).

   STRRSTD       A  return  variable  for whether  the  system  will be
                 started in the restricted state.   The values *YES  or
                 *NO  will be  returned.   If  specified, the  variable
                 must be declared as *CHAR LEN(4).

   DSPSTS        A  return variable  for  the whether  the  system will
                 display  information  during  an IPL  at  the console.
                 The values *QSYS,  *NONE, *ATTEND, *ABNORMAL,  or *ALL
                 will be  returned which have  the same meaning  as the
                 corresponding  values on  DSPIPLA.  If  specified, the
                 variable must be declared as *CHAR LEN(10).

   STRTCP        A return variable  for whether  the system will  start
                 TCP (STRTCP)  command as part of  an IPL.   The values
                 *YES  or  *NO will  be  returned.   If  specified, the
                 variable must be declared as *CHAR LEN(4).

   SPLRCV        A  return  variable  for  the  type  of  spooled  file
                 recovery that  will  occur during  an IPL  when a  job
                 table is  detected as damaged.  The  values *DETACH or
                 *REMOVE  will be returned which  have the same meaning
                 as  the   corresponding  values   on   DSPIPLA.     If
                 specified,  the variable  must  be  declared as  *CHAR
                 LEN(10).


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

None.

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

None.

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   RTVIPLA       *CMD                   TAASYSS       QATTCMD
   TAASYSSC      *PGM       CLP         TAASYSSC      QATTCL

Added to TAA Productivity tools August 1, 1998

Home Page

Up to Top