TAA Tools
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


Home Page Up to Top