Display Job using JS (DSPJOBJS)

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

The Display Job using Job Scheduler (DSPJOBJS) command allows you to display or print a single job, groups of jobs or all jobs that you have set up in Advanced Job Scheduler You can sequence the display or report by job, by date or by group.

If you select a single job to display, you are taken to the Display Job display. If you select more than one job to display, you are taken to the Display Jobs display where you can select any of the group of jobs to display individually. If you want to print information about a job or group of jobs, you can select a specific area to print or you can print all areas.

Top

Parameters

Keyword Description Choices Notes
JOB Job entry Element list Optional, Positional 1
Element 1: Job Generic name, name, *ALL
Element 2: Group Generic name, name, *ALL, *NONE
Element 3: Group sequence 1-99, *ALL, *NONE
APP Application Generic name, name, *ALL, *NONE Optional
SCDCDE Schedule code Character value, *ALL, *DAILY, *CALENDAR, *DATE, *DAY, *NUMDAY, *MINUTES, *ONCE, *MONTHEND, *FIRST, *SECOND, *THIRD, *FOURTH, *FIFTH, *LAST, *FIRSTWRK, *LASTWRK, *ALTERNATE, *TEMP, *NONE Optional
CAL Calendar Generic name, name, *ALL, *NONE Optional
HDYCAL Holiday calendar Generic name, name, *ALL, *NONE Optional
FSCCAL Fiscal calendar Generic name, name, *ALL, *NONE Optional
RMTLOCNAME Remote location name Name, *ALL, *LCL, *JOBCTL Optional
RPTDSTID Report distribution ID Generic name, name, *ALL, *NONE Optional
LIBL Library list Generic name, name, *ALL, *JOBCTL, *JOBD, *SYSVAL, *NONE Optional
STATUS Job status *ALL, *READY, *DEPW, *HELD, *OMIT, *PROCESS, *JOBQ, *SAVED Optional
TEXT Text Character value, *ALL, *NONE, *generic* Optional
CMD Command request Character value, *ALL, *NONE, *generic* Optional
SEQ Sequence *JOB, *DATE, *GROUP Optional
OUTPUT Output *, *PRINT Optional
DETAIL Detail *BASIC, *FULL Optional
AREA Area Single values: *ALL
Other values (up to 5 repetitions): *JOBDFN, *CMD, *AUT, *LDA, *DOC, *DEP
Optional
Top

Job entry (JOB)

Specifies that you want to display or print a single job, a generic group of jobs or all jobs. You can specify a single job with generic group, all jobs with a single group and so on.

Element 1: Job

*ALL
Display or print all jobs.
generic-name
Specify the generic name of the jobs that you want to display or print. 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 that you want to display or print.

Element 2: Group

*ALL
All groups to which the specified job or jobs are a member are displayed or printed.
*NONE
There is no group associated with the job or jobs.
generic-name
Specify the generic name of the group that you want to display or print. 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 or jobs that you want to display or print.

Element 3: Group sequence

*ALL
All sequence numbers for the specified group or groups are displayed or printed.
*NONE
There is no sequence number associated with the job.
1-99
Specify the sequence number of the job within the group or groups that you want to display or print.
Top

Application (APP)

Specifies the name of the application that you want to display or print.

*ALL
All the application entries that meet this command's other parameter values are shown on the display or report.
*NONE
The job is not assigned to an application.
generic-name
Specify the generic name of the application. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with application names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete application name.
name
Specify the user-defined name of the application you want to display or print.
Top

Schedule code (SCDCDE)

Specifies the schedule code or schedule name for the job or jobs that you want to display or print.

*ALL
All the schedule code entries that meet this command's other parameter values are shown on the display or report.
*DAILY
The job or jobs that you want to display or print are scheduled to run using the *DAILY schedule code.
*CALENDAR
The job or jobs that you want to display or print are scheduled to run using the *CALENDAR schedule code.
*DATE
The job or jobs that you want to display or print are scheduled to run using the *DATE schedule code.
*DAY
The job or jobs that you want to display or print are scheduled to run using the *DAY schedule code.
*NUMDAY
The job or jobs that you want to display or print are scheduled to run using the *NUMDAY schedule code.
*MINUTES
The job or jobs that you want to display or print are scheduled to run using the *MINUTES schedule code.
*ONCE
The job or jobs that you want to display or print are scheduled to run using the *ONCE schedule code.
*MONTHEND
The job or jobs that you want to display or print are scheduled to run using the *MONTHEND schedule code.
*FIRST
The job or jobs that you want to display or print are scheduled to run using the *FIRST schedule code.
*SECOND
The job or jobs that you want to display or print are scheduled to run using the *SECOND schedule code.
*THIRD
The job or jobs that you want to display or print are scheduled to run using the *THIRD schedule code.
*FOURTH
The job or jobs that you want to display or print are scheduled to run using the *FOURTH schedule code.
*FIFTH
The job or jobs that you want to display or print are scheduled to run using the *FIFTH schedule code. If there is not a fifth occurrence in a month, the job will not run and will be scheduled for the next time there is a fifth occurrence of a selected day in a month.
*LAST
The job or jobs that you want to display or print are scheduled to run using the *LAST schedule code.
*FIRSTWRK
The job or jobs that you want to display or print are scheduled to run using the *FIRSTWRK schedule code.
*LASTWRK
The job or jobs that you want to display or print are scheduled to run using the *LASTWRK schedule code.
*ALTERNATE
The job or jobs that you want to display or print are scheduled to run using the *ALTERNATE schedule code.
*TEMP
The job or jobs that you want to display or print are temporary jobs, created as a result of processing the SBMJOBJS command.
*NONE
The job is not a scheduled job. It can be a member of a group job waiting for submission, a job waiting for a predecessor job to run, or a job waiting for manual submission by a user.

Note: The schedule code *NONE replaces the schedule code *DEPJOB which was used in releases prior to V4R2.

character-value
The job or jobs that you want to work with are scheduled to run using the specified schedule or the schedule code found in the specified schedule. For instance, user-defined schedule MONTHLY1 uses schedule code *DAY. By specifying MONTHLY1 all jobs using MONTHLY1 as the schedule or *DAY as the schedule code would be listed.
Top

Calendar (CAL)

Specifies the name of the calendar that you want to display or print.

*ALL
All the calendar entries that meet this command's other parameter values are shown on the display or report.
*NONE
The job that you want to display or print does not use a calendar.
generic-name
Specify the generic name of the calendar. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with calendar names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete calendar name.
name
Specify the user-defined name of the calendar you want to display or print.
Top

Holiday calendar (HDYCAL)

Specifies the name of the holiday calendar that you want to display or print.

*ALL
All the holiday calendar entries that meet this command's other parameter values are shown on the display or report.
*NONE
A holiday calendar is not assigned to the job.
generic-name
Specify the generic name of the holiday calendar. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with holiday calendar names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete holiday calendar name.
name
Specify the user-defined name of the holiday calendar you want to display or print.
Top

Fiscal calendar (FSCCAL)

Specifies the name of the fiscal year calendar that you want to display or print.

*ALL
All the fiscal calendar entries that meet this command's other parameter values are shown on the display or report.
*NONE
A fiscal calendar is not assigned to the job.
generic-name
Specify the generic name of the fiscal calendar. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with fiscal calendar names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete fiscal calendar name.
name
Specify the user-defined name of the fiscal calendar you want to display or print.
Top

Remote location name (RMTLOCNAME)

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

*ALL
Selects all job entries for all systems in the network.
*LCL
Selects all job entries for the local system.
*JOBCTL
Selects all job entries using *JOBCTL as the remote location name.
remote-location-name
Specify the name of the remote location associated with the system whose job entries you want to display or print.
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

Report distribution ID (RPTDSTID)

Specifies the identifier of the report distribution names that you want to display or print.

*ALL
All the report distribution ID's that meet this command's other parameter values are shown on the display or report.
*NONE
You do not want to include any jobs with report distribution IDs in the display or report.
generic-name
The report distribution ID is generic. For example, specifying ACT* would cause all jobs whose report distribution ID's begin with the characters ACT to be included in the display or report.
name
Specify the report distribution ID that you want to display or print.
Top

Library list (LIBL)

Specifies the name of the library list that you want to include in the display or print. If you want to select a library list name from a list when prompting this command, place the cursor on this parameter and press F4.

*ALL
Include all jobs regardless of library list in the display or report.
*JOBCTL
Include only those jobs whose library list is *JOBCTL in the display or report.
*JOBD
Include only those jobs whose library list is *JOBD in the display or report.
*SYSVAL
Include only those jobs whose library list is *SYSVAL in the display or report.
*NONE
Include only those jobs whose library list is *NONE in the display or report.
generic-name
The library list name is generic. For example, specifying "LIB*" would cause all jobs whose library lists begin with the characters "LIB" to be included in the display or report.
name
Specify the name of the library list that you want to include in the display or report.
Top

Job status (STATUS)

Specifies the status code of the jobs that you want to display or print.

*ALL
Include all jobs regardless of status in the display or report.
*READY
Include only jobs whose job status is *READY in the display or report. Jobs with job status *READY are jobs that are waiting to be processed at their next scheduled date and time.
*DEPW
Include only jobs whose job status is *DEPW in the display or report. Jobs with job status *DEPW are jobs that are waiting to be processed based on another job or event.
*HELD
Include only those jobs whose job status is *HELD in the display or report. Jobs with job status *HELD are jobs that have been suspended and will not be processed until released.
*OMIT
Include only those jobs whose job status is *OMIT in the display or report.
*PROCESS
Include only those jobs whose job status is *PROCESS in the display or report. Jobs with job status *PROCESS are jobs that are currently processing at the time of the display or report.
*JOBQ
Include only those jobs whose job status is *JOBQ in the display or report. Jobs with job status *JOBQ are jobs that are on the job queue at the time of the display or report.
*SAVED
Include only those jobs whose job status is *SAVED in the display or report. Jobs with job status *SAVED are jobs that are one time jobs that you have saved for future use.
Top

Text (TEXT)

Specifies the text related to the job that you want to display or print. You can search for any string of characters, and only those job schedule entries that contain the string of characters in the text are included in the display or report.

*ALL
You want to display or report all job schedule entries, regardless of the text.
*NONE
You want to display or report all job schedule entries that have blanks or *NONE for text.
generic-text
The text is generic. For example, specifying 'THE JOB' would cause all text that begins with the words 'THE JOB' to be included in the display or report.
character-value
Specify that you want to display all job schedule entries that have the text string specified.
Top

Command request (CMD)

Specifies the command request for the jobs that you want to display or print. You can include any command request, a string of command characters, or display entries that have no command request.

*ALL
You want to display or print all job schedule entries, regardless of whether they have a command request.
*NONE
You want to display or print job schedule entries that have no command requests
generic-command
Specify generic command information. For example, specifying 'CALL PG*' would cause all command requests that begins the string 'CALL PG' to be included in the display.
character-value
Specify that you want to display or print all job schedule entries that have the command request specified.
Top

Sequence (SEQ)

Specifies the sequence in which you want to display or report the selected job schedule entries.

*JOB
You want to display or report the job schedule entries in job sequence.
*DATE
You want to display or report the job schedule entries in date sequence.
*GROUP
You want to display or report the job schedule entries in group sequence.
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

Area (AREA)

Specifies the information about the job or jobs that you want to include in the report when you specify *FULL for the Detail (DETAIL) parameter.

Single values

*ALL
All information about the job or jobs is to be included in the display or report.

Other values (up to 5 repetitions)

*JOBDFN
Job definition information is included in the display or report.
*CMD
Command information is included in the display or report.
*LDA
Local data area information is included in the display or report.
*DOC
Documentation information is included in the display or report.
*DEP
Dependency information is included in the display or report.
Top

Examples

Example 1: Displaying a Job

DSPJOBJS JOB(JOB02) OUTPUT(*PRINT)

This command prints information for job JOB02.

Top

Error messages

Unknown
Top