Display Log for Job Scheduler (DSPLOGJS)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Display Log for Job Scheduler (DSPLOGJS) command allows you to display or print the Advanced Job Scheduler log. The Advanced Job Scheduler log is a display by date and time of messages that Advanced Job Scheduler has created as a result of processing. The DSPLOGJS command allows you to display or print all or part of the log.

Top

Parameters

Keyword Description Choices Notes
TYPE Type *ALL, *RUN, *SUBMIT, *MAINT, *EMAIL, *WORKFLOW Optional, Positional 1
PERIOD Time period for log output Element list Optional
Element 1: Start time and date Element list
Element 1: Beginning time Time, *AVAIL
Element 2: Beginning date Character value, *CURRENT, *BEGIN
Element 2: End time and date Element list
Element 1: Ending time Time, *AVAIL
Element 2: Ending date Character value, *CURRENT, *END
SEV Severity 0-99, *ALL Optional
OUTPUT Output *, *PRINT Optional
DETAIL Detail *BASIC, *FULL Optional
JOB Job entry Single values: *NONE
Other values: Element list
Optional
Element 1: Job Generic name, name, *ALL
Element 2: Group Generic name, name, *ALL, *NONE
Element 3: Group sequence 1-99, *ALL, *NONE
RMTLOCNAME Remote location name Name, *ALL, *LCL Optional
USER User Name, *ALL Optional
MSGID Message identifier Name, *ALL Optional
Top

Type (TYPE)

The type of entry for which you want to review log entries.

*ALL
Selects all log entries for display.
*RUN
Selects only job run entries for display.
*SUBMIT
Selects only submit job log entries for display.
*MAINT
Selects only maintenance log entries for display.
*EMAIL
Selects only e-mail related log entries for display.
*WORKFLOW
Selects only Work Flow related log entries for display.
Top

Time period for log output (PERIOD)

Specifies the period of time for which the log entries are selected for the display or report.

Element 1: Start time and date

Specifies the beginning time and date at or after which log entries are included. Any log entries created before the specified time and date are not included in the display or report.

Element 1: Beginning time

*AVAIL
Any time that is available for the beginning date is included.
time
Specify the beginning time for the specified beginning date that indicates which log entries are to be included.

The time is specified in 24-hour format and can be specified with or without a time separator:

  • Without a time separator, specify a string of 4 digits (hhmm) where hh=hours and mm=minutes. Hours and minutes must each be exactly 2 digits (using leading zeros if necessary).
  • With a time separator, specify a string of 5 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

Element 2: Beginning date

*BEGIN
History entries from the beginning of the log entries are included.
*CURRENT
Log entries with a current date creation date and between the specified beginning and ending times (if specified) are included.
date
Specify the beginning date. The date must be specified in the job date format.
integer
Specify a number to represent the number of days before the current date that you want to use for the search. An example would be 10. If today's date were 3/12/01 (date format is mm/dd/yy), the Begin date for the Advanced Job Scheduler log would be 3/2/01.

Element 2: End time and date

Specifies the ending time and date after which log entries are not included. Any log entries made after the specified time and date are not included in the display or report.

Element 1: Ending time

*AVAIL
Any time that is available for the ending date is included.
time
Specify the ending time for the specified ending date that indicates which log entries are to be included.

Element 2: Ending date

*END
The log entries to the end of the log information are included in the display or report.
*CURRENT
Log entries whose date is on or before the current date are included in the display or report.
date
Specify the ending date. The date must be specified in the job date format.
integer
Specify a number to represent the number of days before the current date that you want to use for the search. An example would be 10. If today's date were 3/22/01 (date format is mm/dd/yy), the End date for the Advanced Job Scheduler log would be 3/12/01.
Top

Severity (SEV)

Specifies the message severity level that you want to include in the report/display. For example, a severity level of 30 would include all messages that are severity level 30 and above.

*ALL
Include all severity levels in the display or report.
0-99
Specify the severity level associated with log entries that you want to include in the display or report.
Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*
The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
*PRINT
The output is printed with the job's spooled output.
Top

Detail (DETAIL)

Specifies the format used for the printed output.

*BASIC
The entries are printed in abbreviated list format.
*FULL
The detail of each entry is printed in an expanded format.
Top

Job entry (JOB)

Specifies the name of the job whose log entries you want to display or print. You must specify a job for every job and alternately can specify a group to which the job belongs as well as a sequence number for the job within the group.

Single values

*NONE
Jobs that have no log entries are displayed.

Element 1: Job

*ALL
All jobs that have log entries are displayed.
generic-name
Specify the generic name of the jobs whose log entries you want to display. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete job.
name
Specify the name of the job whose log entries you want to display.

Element 2: Group

*ALL
All groups to which the specified job or jobs are a member are displayed.
*NONE
There is no group associated with the job.
generic-name
Specify the generic name of the group whose log entries you want to display. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete group.
name
Specify the name of the group that contains the job whose log entries you want to display.

Element 3: Group sequence

*ALL
All job sequences that belong to this group with log entries are displayed.
*NONE
There is no sequence number associated with the job.
1-99
Specify the sequence number of the job within the group whose log entries you want to display.
Top

Remote location name (RMTLOCNAME)

Specifies the remote location and network identification of the system that created the log entry that you want to display.

*ALL
Selects all log entries for all systems in the network.
*LCL
Selects all log entries for the local system.
remote-location-name
Specify the name of the remote location associated with the system whose log entries you want to display.
network-ID.remote-location-name
Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.
Top

User (USER)

Specifies the name of the user profile for the log entries that you want to display.

*ALL
Include all user profiles in the display or report.
name
Specify the name of the user profile whose log entries you want to include in the display or report.
Top

Message identifier (MSGID)

Specifies the message identifier for the log entries that you want to display.

*ALL
Include all message identifiers in the display or report.
name
Specify the message identifier whose log entries you want to include in the display or report.
Top

Examples

DSPLOGJS   PERIOD((*AVAIL *BEGIN) (*AVAIL *END))
           JOB(JOB02)

This command displays Job Scheduler log entries from the beginning of the log to the end of the log for JOB02.

Top

Error messages

Unknown
Top