TAA Tools

 CHKLCKSYSV      CHECK LOCKED SYSTEM VALUE              TAASEHY

 The Check Locked System  Value command checks a system value  to see if
 it  is locked by  the DST/SST function.   This prevents  certain system
 values   from  being  used  by  CHGSYSVAL  (or  the  Change  option  on
 WRKSYSVAL).    The escape  message  TAA9896  is  sent  if  the  DST/SST
 function  has been used  and the  system value  is one  that is  on the
 list  that may be  locked.  Otherwise, the  command completes normally.

 A typical series of commands would be:

            CHKLCKSYSV   SYSVAL(xxx)
            MONMSG       MSGID(TAA9896) EXEC(DO) /* Locked */
                         /******************************************/
                         /*                                        */
                         /*    Your handling of the locked         */
                         /*      condition                         */
                         /*                                        */
                         /******************************************/

 System Values that can be locked
 --------------------------------

 The system documentation describes the  list of system values that  can
 be  locked and  how to  do it.    Search the  online documentation  for
 'Lock system values'.

 The  list  includes  more  than  just  strictly  security items.    For
 example, QAUDLVL and QDSCJOBITV are included.

 There is one  'yes/no' option  in DST/SST  for all  system values  that
 may be locked.  You cannot lock individual system values.

 CHKLCKSYSV escape messages you can monitor for
 ----------------------------------------------

       TAA9896    The system value is locked and cannot be changed

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

 CHKLCKSYSV Command parameters                         *CMD
 -----------------------------

    SYSVAL        The  system  value  to be  checked.    Escape  message
                  TAA9896  is sent if  the system  value is locked.   If
                  the  system value  is not one  of the  values that can
                  be locked  or locking  is not in  effect, the  command
                  returns normally.

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

 None.

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

 The following TAA Tools must be on your system:

      CVTSYSVAL       Convert system value
      RTVSYSSEC       Retrieve system security
      SNDESCINF       Send escape information
      SNDESCMSG       Send escape message
      WRKSYSVAL2      Work system value 2

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

 None, the tool is ready to use.

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

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

    CHKLCKSYSV    *CMD                   TAASEHY       QATTCMD
    TAASEHYC      *PGM       CLP         TAASEHYC      QATTCL
    TAASEHYR      *PGM       RPG         TAASEHYR      QATTRPG

Added to TAA Productivity Tools January 15, 2009


Home Page

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.