TAA Tools
RTVSYSSTS       RETRIEVE SYSTEM STATUS                 TAAJOCA

The Retrieve System  Status command retrieves system  level information
such  as is  found on  the WRKSYSSTS  display  along with  other values
that represent the status of the system.

A typical command to retrieve the number of signed on users would be:

            DCL          &SIGNONCNT *DEC LEN(9 0)
             .
            RTVSYSSTS    SIGNONCNT(&SIGNONCNT)

You  can also  retrieve such  information as  whether the system  is in
the restricted  state,  the  total  amount of  auxiliary  storage,  the
percentage  of  System  ASP  used,  the  percentage  of  temporary  and
permanent addresses used.

The API QWCRSSTS is used to extract the information.

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

   RESET         Whether  to reset the status statistics.   This is the
                 same parameter as  exists on  WRKSYSSTS.  The  default
                 is  *NO.   *YES  causes the  status  statistics to  be
                 reset.

   CPUPCT        An  optional return  variable for  the percent  of CPU
                 used.   If specified,  the variable  must be  declared
                 as *DEC LEN(5 1).

   SYSJOBCNT     An optional  return variable  for the  number of  jobs
                 in  the system.   This value  should match  the number
                 seen  on DSPSYSSTS.   If specified,  the variable must
                 be declared as *DEC LEN(7 0).

   PRMADRPCT     An  optional return  variable  for the  percentage  of
                 permanent   addresses  used.      If  specified,   the
                 variable must be declared as *DEC LEN(7 3).

   TMPADRPCT     An  optional  return variable  for  the  percentage of
                 temporary  addresses   used.     If   specified,   the
                 variable must be declared as *DEC LEN(7 3).

   MAINSTG       An optional  return variable  for the  amount of  main
                 storage  in KB.   If specified,  the variable  must be
                 declared as *DEC LEN(11 0).

   SYSASPSTG     An  optional  return  variable   for  the  amount   of
                 storage in  the System ASP  storage in gigabytes.   If
                 specified,  the  variable  must  be declared  as  *DEC
                 LEN(9 3).

   SYSASPPCT     An  optional  return  variable for  the  percentage of
                 System ASP used.   If specified, the variable must  be
                 declared as *DEC LEN(7 4).

   TOTAUXSTG     An  optional return variable  for the  Total auxiliary
                 storage  in  gigabytes.   If  specified,  the variable
                 must be declared as *DEC LEN(9 3).

   CURUNPSTG     An optional  return variable  for the  current  amount
                 of  unprotected storage  in  millions  of bytes.    If
                 specified,  the  variable  must  be  declared as  *DEC
                 LEN(9 0).

   MAXUNPSTG     An optional  return variable  for the  maximum  amount
                 of  unprotected storage  used  in millions  of  bytes.
                 If  specified, the variable  must be declared  as *DEC
                 LEN(9 0).

   ELPTIM        An  optional  return variable  for elapsed  time since
                 the last reset  of the statistics.   The elapsed  time
                 is  returned in the  form HHMMSS.   If  specified, the
                 variable must be declared as *CHAR LEN(6).

   RSDSTE        An  optional return  variable  for whether  the system
                 is in the  restricted state.  N  is returned for  'No'
                 the  system is  not in  the  restricted state.   Y  is
                 returned  for 'Yes'  the system  is in  the restricted
                 state.  If  specified, the variable  must be  declared
                 as *CHAR LEN(1).

   SIGNONCNT     An optional return  variable for the number  of signed
                 on  users.     If  specified,  the  variable  must  be
                 declared as *DEC LEN(7 0).

   DISCONCNT     An   optional  return  variable   for  the  number  of
                 disconnected users.   A  disconnected  user is  caused
                 by  Option  80  on  the  System Request  menu  or  the
                 DSCJOB  command.  If  specified, the  variable must be
                 declared as *DEC LEN(7 0).

   SUSSYSCNT     An optional  return variable  for the  number of  jobs
                 that  have   been  temporarily  suspended   by  System
                 Request  jobs  so   that  other  jobs  may  run.    If
                 specified, the  variable  must  be  declared  as  *DEC
                 LEN(7 0).

   SUSGRPCNT     An optional  return variable  for the  number of  jobs
                 that  have been  temporarily suspended  by  Group Jobs
                 so  that  other  jobs  may  run.    If  specified, the
                 variable must be declared as *DEC LEN(7 0).

   SIGNOFFPRT    An optional  return variable  for the  number of  jobs
                 that  have   signed  off,  but   have  printer  output
                 waiting  to print.   If  specified, the  variable must
                 be declared as *DEC LEN(7 0).

   BATCHMSG      An optional return  variable for  the number of  batch
                 jobs  that  are  waiting  for a  reply  to  a  message
                 before   they  can   continue.    If   specified,  the
                 variable must be declared as *DEC LEN(7 0).

   BATCHRUN      An optional return  variable for the  number of  batch
                 jobs that  are currently running.   If  specified, the
                 variable must be declared as *DEC LEN(7 0).

   BATCHHLD      An  optional return variable  for the number  of batch
                 jobs  that are held while  running.  If specified, the
                 variable must be declared as *DEC LEN(7 0).

   BATCHEND      An optional return  variable for  the number of  batch
                 jobs that  are ending due  to a condition such  as the
                 job  is in  process of  ending normally  or abnormally
                 (the job  log may  be printing).    If specified,  the
                 variable must be declared as *DEC LEN(7 0).

   BATCHWAIT     An optional  return variable  for the number  of batch
                 jobs  that are  waiting to  run or  already scheduled.
                 This includes  those submitted  for a  future date  or
                 time.   Jobs on  the job  schedule function that  have
                 not  been submitted are  not included.   If specified,
                 the variable must be declared as *DEC LEN(7 0).

   BATCHHLDO     An  optional return  variable for the  number of batch
                 jobs that are held  on a job queue (HLDJOB  was used).
                 If specified,  the variable  must be declared  as *DEC
                 LEN(7 0).

   BATCHHLDQ     An  optional return variable  for the  number of batch
                 jobs that  are  on  a  held  job  queue  (HLDJOBQ  was
                 used).   If specified, the  variable must  be declared
                 as *DEC LEN(7 0).

   BATCHUNASG    An  optional return variable  for the  number of batch
                 jobs  that  are  on  an  unassigned  job  queue.    If
                 specified,  the  variable must  be  declared  as  *DEC
                 LEN(7 0).

   BATCHENDP     An  optional return variable  for the number  of batch
                 jobs   that  have  ended,   but  have  printer  output
                 waiting to  print.   If specified,  the variable  must
                 be declared as *DEC LEN(7 0).

   ACTJOBS       An optional  return variable for the  number of active
                 jobs  in  the system.    This value  should  match the
                 number  seen  on   WRKACTJOB.     If  specified,   the
                 variable must be declared as *DEC LEN(7 0).

   MAXJOBS       An  optional return  variable for  the maximum  number
                 of  jobs allowed in  the system.   When the  number is
                 reached,  no  new  jobs  may  be  started.    See  the
                 SYSJOBCNT  parameter for  how  many  jobs exist.    If
                 specified,  the  variable  must  be declared  as  *DEC
                 LEN(7 0).

   ACTTHREADS    An   optional  return  variable   for  the  number  of
                 initial  and   secondary   threads  that   have   been
                 started, but  not ended.   If specified,  the variable
                 must be declared as *DEC LEN(7 0).

   PARTITIONS    An   optional  return  variable  for   the  number  of
                 partitions  that   are  powered   on  or   off.     If
                 specified,  the  variable  must be  declared  as  *DEC
                 LEN(7 0).

   PARTNID       The  partition  identifier of  the  current partition.
                 If specified, the  variable must be  declared as  *DEC
                 LEN(7 0).

   PROCESSORS    The number  of  processors that  are currently  active
                 in  this partition.   If specified, the  variable must
                 be declared as *DEC LEN(7 0).

   PRCSHRATTR    The  processor  sharing attribute  in  this partition.
                 If specified, the variable  must be declared as  *CHAR
                 LEN(1).

                 0 = The partition does not share processors

                 1 =  The partition  shares processors, but  is limited
                 to using its configured capacity.

                 2  = The partition shares processors  and can use more
                 than its configured capacity.

   CURPRCCAP     The current processing  capacity in  hundredths.   See
                 the  API description  of  this value.   If  specified,
                 the variable must be declared as *DEC LEN(9 2).

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

Because  the command  returns variables, it  can only  be used in  a CL
program.

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

The following TAA Tools must be on your system:

           CVTSYSSTS    Convert system status

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

None, the tool is ready to use.

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

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

   RTVSYSSTS     *CMD                   TAAJOCA       QATTCMD
   TAAJOCAC      *PGM       CLP         TAAJOCAC      QATTCL
					

Added to TAA Productivity tools May 1, 1996


Home Page Up to Top