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