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