TAA Tools

 CVTSYSVAL       CONVERT SYSTEM VALUES                  TAASYSO

 The Convert  System  Values command  converts the  spooled file  output
 from  WRKSYSVAL to  the SYSVALP  file.   This  provides a  solution for
 determining  the system  values that  exist on  each release,  the text
 descriptions, and the current and shipped values.

 Also  included are  the  group  (as  defined by  WRKSYSVAL),  the  type
 (*CHAR or *DEC), the length, and decimal positions.

 The  model file  used is  TAASYSOP  in TAATOOL  with a  format name  of
 SYSVALR.

 The outfile is created as ALWUPD(*NO) and ALWDLT(*NO).

 A typical command would be:

              CVTSYSVAL   OUTLIB(xxx)

 The  WRKSYSVAL  spooled  file  would  be  output  and  CPYSPLF used  to
 convert the  data to a  temporary data  base file.   The  file is  then
 read and converted to the externally described file SYSVALP.

 The information  about whether  the system  value has  been changed  is
 taken  directly from  the listing.   System values  such as  QDAY which
 are never the same as  the shipped value are  not marked as changed  in
 the listing nor in the outfile.

 The SYCURL  (long value)  field is  1000 bytes and  allows for  holding
 large  system values  such as  QPWDRULES, QSYSLIBL,  QUSRLIBL, QAUDLVL,
 and QAUDLVL2.

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

    OUTLIB        The   library  in  which  the  file  SYSVALP  will  be
                  placed.  The  default is *LIBL.   If the SYSVALP  file
                  does not  already exist, a library  must be specified.

                  The  model file  used  is TAASYSOP  in TAATOOL  with a
                  format name of SYSVALR.

    OUTMBR        The member of  the SYSVALP file  to be used.   If  the
                  member does  not exist, it is  added.  The  default is
                  SYSVALP.  The member is cleared on each use.

                  *DATE  may  be  specified  to  output  a  member  name
                  Mcyymmdd.  This allows a  unique member for each  date
                  converted and different  members can be  compared with
                  the CMPRPYLE command.

    CMPSYSVAL     A  *YES/*NO value for  whether the output  is intended
                  for   CMPSYSVAL.    *NO  is  the  default  meaning  no
                  special records are written to the output file.

                  *YES  may be  specified  if  you  intend  to  use  the
                  CMPSYSVAL  tool.   *YES causes  special records  to be
                  written  to the outfile  to allow for  a comparison of
                  release  information  and   the  full  definition   of
                  QSYSLIBL and QUSRLIBL.

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

 If  the  format  of  the  WRKSYSVAL printed  output  is  changed  on  a
 subsequent release, the program must be modified.

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

 The following TAA Tools must be on your system:

      CRTDUPPF        Create duplicate physical file
      EDTVAR          Edit variable
      RTVSYSVALA      Retrieve system value attributes
      RTVSYSVAL3      Retrieve system value 3
      SNDCOMPMSG      Send completion message
      SNDESCMSG       Send escape message
      SNDSTSMSG       Send status message

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

 None, the tool is ready to use.

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

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

    CVTSYSVAL     *CMD                   TAASYSO       QATTCMD
    TAASYSOC      *PGM       CLP         TAASYSOC      QATTCL
    TAASYSOC2     *PGM       CLP         TAASYSOC2     QATTCL
    TAASYSOR      *PGM       RPG         TAASYSOR      QATTRPG
    TAASYSOP      *FILE      PF          TAASYSOP      QATTDDS
    TAASYSOQ      *FILE      PF          TAASYSOQ      QATTDDS
    TAASYSOS      *FILE      PF          TAASYSOS      QATTDDS

 TAASYSOQ  is a  second version of  TAASYSOP that  is used only  for the
 CMPSYSVAL tool.

 TAASYSOS is  a  keyed  version  of TAASYSOP  that  is  used  for  tools
 requiring the list of system values.

Added to TAA Productivity Tools December 1, 1996


Home Page

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