DSPACGSGN -- Display Job Accounting Signon

DSPACGSGN DISPLAY JOB ACCOUNTING SIGNON TAAACGG
The Display Job Accounting Signon command displays the job accounting records for interactive jobs within a range of 'From date/time' and 'To date/time'. All users or a generic user profile name may be entered. The user must have signed off and the Job Accounting journal entries converted for the JOBACG tool to find the information. The system does not write a job accounting journal entry until a job completes. The CVTJOBACG command must then be used to convert the job accounting journal entries to the files used by the JOBACG tool. Once the job accounting records exist, you can display the signon dates using DSPACGSGN. A typical command would be: DSPACGSGN FROM(dddddd) All job accounting records for interactive jobs would be listed if the job was started after the specified date. You may sequence the output by date/time, by user, or by job name (device name). You may select a specific user, generic users, or all users. Contrast with the DSPLSTSGN tool -------------------------------- The DSPLSTSGN tool takes information from the user profile. Only the last signon for each user is kept. DSPLSTSGN is useful for determining profiles that have not signed onto prior to some date. It may also be used in conjunction with a job schedule entry to determine who has signed on during odd hours. For example, you can run a job at 7:00 AM to determine who has signed on from 7:00 PM of the previous day to 7:00 AM of the current day. Since only the last signon is known, multiple signons by a single user cannot be determined. The DSPACGSGN tool uses job accounting information to determine the signons. It is only effective if the user has signed off thus causing a job accounting entry to be sent to the QACGJRN journal. While DSPACGSGN allows you to see multiple signons, it cannot be used until the user has signed off and the journal entries have been converted. DSPACGSGN escape messages you can monitor for --------------------------------------------- None. Escape messages from based on functions will be re-sent. Command parameters CMD ------------------ USRPRF The user profile to be listed. The default is ALL. A single user profile or a generic user profile name may be entered. USERTYPE The type of user to be selected. JOBUSER is the default meaning the user of the job. CURUSER may be specified to mean the current user profile that was swapped to during the job. FROM The 'from date/time' to select from. The default is FIRST for both values so any signon date would be selected. For the date value, TODAY may be entered for todays date. PRVDAY1 ... PRVDAY7 may be entered to mean 1 to 7 days prior to the current date. A specific date may be entered in job date format. For the time value, a specific time may be entered in hhmmss format. TO The 'to date/time' to select from. Both values default to LAST meaning that any signon date would be selected. For the date value, TODAY may be entered to mean todays date. A specific date may be entered in job date format. For the time value, a specific time may be entered in hhmmss format. SEQBY An option to determine the sequence of the output. The default is DATETIME meaning the job accounting records will appear in date/time sequence. USER may be specified to sequence the job accounting records by date/time within user profile. JOB may be specified to sequence the job accounting records by date/time within job name (since only interactive jobs will exist, this is the device name). SYSTEM The system to select. The JOBACG tool allows job accounting information from more that one system to be stored in the same file. The default is ALL for all systems. A specific system may be named. JOBACGLIB The library containing the JOBACGP file. The default is LIBL. CURLIB may be specified. OUTPUT How to output the results. * is the default to display the spooled file if the command is entered interactively. The spooled file is deleted after it is displayed. If the command is entered in batch or PRINT is specified, the spooled file is output and retained. Restrictions ------------ You must be using the JOBACG tool. The user must have signed off to cause a job accounting journal entry. You must have converted the job accounting journal entries to the JOBACG tool files. Prerequisites ------------- The following TAA Tools must be on your system: ADDDAT Add date CHKGENERC Check generic CVTTIM Convert time JOBACG Job accounting RTVDAT Retrieve date RTVSYSVAL3 Retrieve system value 3 SNDCOMPMSG Send completion message SNDESCINF Send escape information SNDSTSMSG Send status message Implementation -------------- None, the tool is ready to use. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- DSPACGSGN CMD TAAACGG QATTCMD TAAACGGC PGM CLP TAAACGGC QATTCL TAAACGGC2 PGM CLP TAAACGGC2 QATTCL TAAACGGR *PGM RPG TAAACGGR QATTRPG

DSPACGSGN       DISPLAY JOB ACCOUNTING SIGNON          TAAACGG


The Display Job  Accounting Signon command displays the  job accounting
records  for interactive jobs  within a  range of 'From  date/time' and
'To  date/time'.   All  users or  a generic  user  profile name  may be
entered.   The  user  must  have  signed off  and  the  Job  Accounting
journal   entries  converted   for  the   JOBACG  tool   to   find  the
information.

The  system does not write  a job accounting journal  entry until a job
completes.   The CVTJOBACG command  must then  be used  to convert  the
job accounting  journal entries to the  files used by the  JOBACG tool.
Once  the job  accounting  records exist,  you can  display  the signon
dates using DSPACGSGN.

A typical command would be:

            DSPACGSGN     FROM(dddddd)

All job  accounting records  for interactive  jobs would  be listed  if
the job was started after the specified date.

You may  sequence the  output by  date/time, by  user, or  by job  name
(device name).   You may select a specific  user, generic users, or all
users.

Contrast with the DSPLSTSGN tool
--------------------------------

The  DSPLSTSGN tool takes information from  the user profile.  Only the
last  signon  for  each  user  is  kept.     DSPLSTSGN  is  useful  for
determining  profiles that  have not  signed onto  prior to  some date.
It  may  also be  used  in conjunction  with  a job  schedule  entry to
determine who has  signed on during  odd hours.   For example, you  can
run a  job at 7:00 AM  to determine who has  signed on from 7:00  PM of
the previous day to 7:00 AM of the current day.

Since  only the  last signon  is  known, multiple  signons by  a single
user cannot be determined.

The DSPACGSGN tool  uses job  accounting information  to determine  the
signons.   It  is  only  effective if  the  user  has signed  off  thus
causing  a job  accounting entry  to be  sent  to the  QACGJRN journal.
While  DSPACGSGN allows you to see  multiple signons, it cannot be used
until the  user  has  signed off  and  the  journal entries  have  been
converted.

DSPACGSGN escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

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

   USRPRF        The user profile  to be listed.  The  default is *ALL.
                 A  single user profile or a  generic user profile name
                 may be entered.

   USERTYPE      The type of user to be selected.

                 *JOBUSER is the default meaning  the user of the  job.

                 *CURUSER may  be specified  to mean  the current  user
                 profile that was swapped to during the job.

   FROM          The 'from  date/time' to select from.   The default is
                 *FIRST for both  values so  any signon  date would  be
                 selected.

                 For the date value,

                      *TODAY may be entered for todays date.

                      *PRVDAY1 ...   *PRVDAY7 may be entered to  mean 1
                      to 7 days prior to the current date.

                      A  specific  date  may  be  entered in  job  date
                      format.

                 For  the time  value, a  specific time  may be entered
                 in hhmmss format.

   TO            The  'to  date/time' to  select  from.    Both  values
                 default to  *LAST meaning  that any signon  date would
                 be selected.

                 For the date value,

                      *TODAY may be entered to mean todays date.

                      A  specific  date  may  be  entered  in job  date
                      format.

                 For the time  value, a  specific time  may be  entered
                 in hhmmss format.

   SEQBY         An option  to determine  the sequence  of the  output.
                 The  default is  *DATETIME meaning the  job accounting
                 records will appear in date/time sequence.

                 *USER  may   be   specified  to   sequence   the   job
                 accounting records  by date/time within  user profile.

                 *JOB may  be specified to sequence  the job accounting
                 records  by  date/time  within  job  name  (since only
                 interactive  jobs  will  exist,  this  is  the  device
                 name).

   SYSTEM        The  system to  select.   The JOBACG  tool  allows job
                 accounting  information from  more that one  system to
                 be stored in the same  file.  The default is *ALL  for
                 all systems.

                 A specific system may be named.

   JOBACGLIB     The  library   containing  the  JOBACGP  file.     The
                 default is *LIBL.  *CURLIB may be specified.

   OUTPUT        How  to  output the  results.   *  is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.  The  spooled file is deleted  after it
                 is displayed.

                 If  the  command is  entered  in  batch  or *PRINT  is
                 specified,  the spooled  file is  output and retained.

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

You must be using the JOBACG tool.

The  user must  have  signed off  to  cause  a job  accounting  journal
entry.

You  must have  converted the  job  accounting journal  entries to  the
JOBACG tool files.

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

The following TAA Tools must be on your system:

     ADDDAT          Add date
     CHKGENERC       Check generic
     CVTTIM          Convert time
     JOBACG          Job accounting
     RTVDAT          Retrieve date
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   DSPACGSGN     *CMD                   TAAACGG       QATTCMD
   TAAACGGC      *PGM       CLP         TAAACGGC      QATTCL
   TAAACGGC2     *PGM       CLP         TAAACGGC2     QATTCL
   TAAACGGR      *PGM       RPG         TAAACGGR      QATTRPG

Added to TAA Productivity tools March 31, 2004

Home Page

Up to Top