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 Up to Top