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. 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. 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

Last modified on January 12, 2010