DSPLOGJS (Display Log for Job Scheduler) Command Description

DSPLOGJS Command syntax diagram

Purpose

The Display Log for Job Scheduler (DSPLOGJS) command allows you to display the Job Scheduler log.

Note: When referring to a job in this command, we are referring to an entry in Job Scheduler. An entry in Job Scheduler is a user-defined name for commands or programs that you want to process at scheduled times and dates. Job Scheduler jobs (entries) are not OS/400 objects. The Job Scheduler log is a display by date and time of messages that Job Scheduler has created as a result of processing. The DSPLOGJS command allows you to display or print all or part of the log.

Optional Parameters

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.

PERIOD

Specifies the time period used to select log entries to be included in the display or report. This parameter contains two lists of two elements each.

Element 1: Beginning Time

One of the following is used to specify the starting creation time at which or after log entries are included. Any log entries made before the specified time and date are not included in the display or report.

*AVAIL: Any time that is available for the beginning date is included.

begin-time: Specify the beginning time for the specified beginning date that indicates which log entries are to be included.

Element 2: Beginning Date

One of the following is used to specify the starting date on or after which the log entries must have been made. Any entries made before the specified date are not included in the display or report.

*CURRENT: Log entries with a current date creation date and between the specified beginning and ending times (if specified) are displayed or reported.

*BEGIN: Log entries from the beginning of the log information are included.

begin-date: Specify the beginning date. The date must be specified in the job date format.

number-of-days: Specify a number to represent the number of days before the current day that you want to use for the search. An example would be 10. If today's date were 3/12/94 (date format is mm/dd/yy), the From date for the Job Scheduler log would be 3/2/94.

Element 3: Ending Time

One of the following is used to specify the ending time before which log entries are included. Any log entries made after the specified time and date are not included in the items displayed or reported.

*AVAIL: Any time that is available for the ending date is included.

end-time: Specify the ending time for the specified ending date that indicates which log entries are to be included.

Element 4: Ending Date

One of the following is used to specify the ending date on which or before which the log entries must have been made. Any log entries created after the specified date are not included in the report or display.

*CURRENT: Log entries whose date is on or before the current date are included in the display or report.

*END: The log entries to the end of the log information are included.

end-date: Specify the ending date. The date must be specified in the job date format.

number-of-days: Specify a number to represent the number of days before the current day that you want to use for the search. An example would be 10. If today's date were 3/22/94 (date format is mm/dd/yy), the To date for the Job Scheduler log would be 3/12/94.

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. The severity level can be specified from 0 to 99.

*ALL: Include all severity levels in the report or display.

severity-level: Specify the severity level associated with log entries that you want to include in the display or report.

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.

JOB

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

Element 1: Job

*ALL: All jobs that have log entries are displayed.

*NONE: All log entries that do not have jobs associated with them are displayed.

generic*-job-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.

job-name: Specify the name of the job whose log entries you want to display.

Element 2: Group

*ALL: All jobs that belong to this group with log entries are displayed.

*NONE: There is no group associated with the job.

generic*-group-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.

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.

group-sequence-number: Specify the sequence number of the job within the group whose log entries you want to display.

RMTLOCNAME

Specifies the location and network identification of the remote location name 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 location associated with the system whose log entries you want to display.

network-ID.location-name: Specify the network identifier and the name of the location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the location name.

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.

user-name: Specify the user profile whose log entries you want to include in the display or report.

MSGID

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

*ALL: Include all message identifiers profiles in the display or report.

message-identifier: Specify the message identifier whose log entries

MSGID

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

*ALL: Include all message identifiers profiles in the display or report.

message-identifier: Specify the message identifier whose log entries you want to include in the display or report.

Example for DSPLOGJS

Example 1: Displaying the Job Scheduler Log

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

In this example Job Scheduler log entries from the beginning of the log to the end of the log are displayed for JOB02.

Error messages for DSPLOGJS

None