TAA Tools
CVTSYSSTS     CONVERT WRKSYSSTS TO A DATA BASE FILE      TAAJOBJ

The  Convert WRKSYSSTS  command  takes the  output  from WRKSYSSTS  and
creates  a data  base file  SYSSTSP  with one  record per  pool.   This
allows  you  to automate  or  capture the  information  that is  on the
WRKSYSSTS display.

A typical command would be entered as:

       CVTSYSSTS     OUTLIB(QTEMP)

The command creates a file  named SYSSTSP in QTEMP with one  record for
each  pool.    Each  record  contains the  standard  information  which
appears  at the  top of  the WRKSYSSTS  display (e.g.   the  percent of
storage used).   You  can then  read  the file  in a  CL or  other  HLL
program.

CVTSYSSTS  is implemented  by  using the  QWCRSSTS  API.   The  maximum
activity level  of the machine pool (pool 1) is  always output as 0s as
the system  ignores  the value.    The WRKSYSSTS  display  has  limited
space to show results.   If a value exceeds the results,  + symbols are
shown.  The  API does not have this  consideration, so the actual value
will  be  shown.    In  years  past,  there  were  instances  where the
WRKSYSSTS  display showed  more  than  100%  of  CPU usage.    If  this
occurs, it is forced to 100.0.

Larger field sizes
------------------

Some  fields  like  'ASP  storage  in  MB' and  'pool  size'  have  two
different  fields in the outfile.  The  second field is larger to allow
for larger  sizes.   Both fields  will contain  the same  value if  the
size fits.   If the size exceeds  the length of the  shorter field, the
shorter field is zeroed out.

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

   RESET         Whether  to reset the  WRKSYSSTS statistics.   This is
                 the same  parameter  as  on WRKSYSSTS  and  is  passed
                 through  to the  API  to provide  for  a reset.    The
                 default is *NO.

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

   OUTMBR        The member  of the  SYSSTSP file to  be used.   If the
                 member  does not exist,  it is added.   The default is
                 SYSSTSP.

   REPLACE       A *YES/*NO  value  for whether  the member  should  be
                 cleared before writing  records into it.   The default
                 is *YES.

File format
-----------

The file name that is output is SYSSTSP.

The model file used is TAAJOBJP with a format name of SSRCD.

To see the field names used:

       DSPFMT    TAAJOBJP

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

None.

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

The following TAA Tools must be on your system:

      EDTVAR        Edit variable
      RTVDAT        Retrieve date
      SNDCOMPMSG    Send completion message
      SNDESCMSG     Send escape message

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

None, the tool is ready to use.

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

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

   CVTSYSSTS     *CMD                      TAAJOBJ        QATTCMD
   TAAJOBJP      *FILE         PF          TAAJOBJP       QATTDDS
   TAAJOBJC      *PGM          CLP         TAAJOBJC       QATTCL
   TAAJOBJR      *PGM          RPG         TAAJOBJR       QATTRPG
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top