WRKSYSVAL2 WORK SYSTEM VALUE 2 TAASEHW |
The Work System Value 2 command allows an entry of a string of
characters such as 'LMT' or 'LIMIT' and scans the system value names
and text for matches. A work display appears with the matching
system values and options to display or 'work with'. WRKSYSVAL2
simplifies accessing a system value when you know part of the name or
a word in the text description.
A typical command would be:
WRKSYSVAL2 STRING(LMT)
All system values that contain LMT in either the system value name or
text description would appear in a subfile.
The Display option is done by invoking the system DSPSYSVAL command.
The 'Work with' option is done by invoking the system WRKSYSVAL
command.
Security considerations
-----------------------
Any user who is authorized to DSPSYSVAL can use the Display option.
The user must be authorized to CHGSYSVAL to see or use the 'Work
with' option.
If some system values are locked down via the SST/DST function, the
'Work with' option will fail (done via WRKSYSVAL) for some system
values. The error is monitored for by WRKSYSVAL. See the discussion
with the CHKLCKSYSV tool.
The sub program TAASEHWC3 may be called to refresh the TAASYSOS file
in TAATOOL if the file does not exist or does not contain any
records. This file will contain the output of the CVTSYSVAL command
and is refreshed as part of the install of the TAA Productivity
Tools. The file is used to determine the system values that exist
for each release and should not be used to determine the current
value of a system value.
The TAASEHWC3 program adopts the user profile of QSECOFR. The
program is available to the *PUBLIC, but must be passed the correct
parameter value to run. The only function the program performs is to
refresh the TAASYSOS file. This provides a faster access for
WRKSYSVAL2 and other tools that need to know the current list of
available system values.
WRKSYSVAL2 escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
WRKSYSVAL2 Command parameters *CMD
-----------------------------
STRING The string of characters to be scanned for. The
string is scanned in both the system value name and
text description. Both the string value and the
text description are converted to upper case before
scanning.
Restrictions
------------
The user must be authorized to CHGSYSVAL to see or use the 'Work
with'option.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADJVAR Adjust variable
CVTSYSVAL Convert system value
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
TRMLDGBLK Trim leading blank
TRNVAL Translate value
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
WRKSYSVAL2 *CMD TAASEHW QATTCMD
TAASEHWC *PGM CLP TAASEHWC QATTCL
TAASEHWC2 *PGM CLP TAASEHWC2 QATTCL
TAASEHWC3 *PGM CLP TAASEHWC3 QATTCL
TAASEHWR *PGM RPG TAASEHWR QATTRPG
TAASEHWD *FILE DSPF TAASEHWD QATTDDS
|
Added to TAA Productivity tools January 15, 2009