Work with Jobs using JS (WRKJOBJS)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Work with Jobs using Job Scheduler (WRKJOBJS) command allows you to work with a single job, groups of jobs or all jobs that you have set up in Advanced Job Scheduler. You can sequence the display by job, by date or by group.

When you select jobs that you want to work with, you are taken to the Work with Jobs display. From this display you can perform most job related functions.

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 Generic name, name, *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
Top

Job entry (JOB)

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

Element 1: Job

*ALL
Work with all jobs that meet the other parameter specifications.
generic-name
Specify the generic name of the jobs that you want to work with. 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 work with.

Element 2: Group

*ALL
All groups to which the specified job or jobs are members are included in the Work with Jobs display.
*NONE
There is no group associated with the job or jobs.
generic-name
Specify the generic name of the group that you want to work with. 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 work with.

Element 3: Group sequence

*ALL
All sequence numbers for the specified group or groups are included in the Work with Jobs display.
*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 work with.
Top

Application (APP)

Specifies the name of the application that you want to work with.

*ALL
All the application entries that meet this command's other parameter values are shown on the Work with Jobs display.
*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 work with.
Top

Schedule code (SCDCDE)

Specifies the schedule code or schedule name for the job or jobs that you want to work with.

*ALL
All the schedule code entries that meet this command's other parameter values are shown on the Work with Jobs display.
*DAILY
The job or jobs that you want to work with are scheduled to run using the *DAILY schedule code.
*CALENDAR
The job or jobs that you want to work with are scheduled to run using the *CALENDAR schedule code.
*DATE
The job or jobs that you want to work with are scheduled to run using the *DATE schedule code.
*DAY
The job or jobs that you want to work with are scheduled to run using the *DAY schedule code.
*NUMDAY
The job or jobs that you want to work with are scheduled to run using the *NUMDAY schedule code.
*MINUTES
The job or jobs that you want to work with are scheduled to run using the *MINUTES schedule code.
*ONCE
The job or jobs that you want to work with are scheduled to run using the *ONCE schedule code.
*MONTHEND
The job or jobs that you want to work with are scheduled to run using the *MONTHEND schedule code.
*FIRST
The job or jobs that you want to work with are scheduled to run using the *FIRST schedule code.
*SECOND
The job or jobs that you want to work with are scheduled to run using the *SECOND schedule code.
*THIRD
The job or jobs that you want to work with are scheduled to run using the *THIRD schedule code.
*FOURTH
The job or jobs that you want to work with are scheduled to run using the *FOURTH schedule code.
*FIFTH
The job or jobs that you want to work with 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 work with are scheduled to run using the *LAST schedule code.
*FIRSTWRK
The job or jobs that you want to work with are scheduled to run using the *FIRSTWRK schedule code.
*LASTWRK
The job or jobs that you want to work with are scheduled to run using the *LASTWRK schedule code.
*ALTERNATE
The job or jobs that you want to work with are scheduled to run using the *ALTERNATE schedule code.
*TEMP
The job or jobs that you want to work with 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 for the jobs that you want to work with.

*ALL
All the calendar entries that meet this command's other parameter values are shown on the display.
*NONE
A calendar is not assigned to the job.
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 work with.
Top

Holiday calendar (HDYCAL)

Specifies the name of the holiday calendar for the jobs that you want to work with.

*ALL
All the holiday calendar entries that meet this command's other parameter values are shown on the display.
*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 for the jobs that you want to work with.
Top

Fiscal calendar (FSCCAL)

Specifies the name of the fiscal year calendar for the jobs that you want to work with.

*ALL
All the fiscal calendar entries that meet this command's other parameter values are shown on the display.
*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 for the jobs that you want to work with.
Top

Remote location name (RMTLOCNAME)

Specifies the remote location and network identification of the system that created the job entry that you want to work with.

*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 work with.
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 for the jobs that you want to work with.

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

Library list (LIBL)

Specifies the name of the library list that you want to work with. 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.
*JOBCTL
Include only those jobs whose library list is *JOBCTL in the display.
*JOBD
Include only those jobs whose library list is *JOBD in the display.
*SYSVAL
Include only those jobs whose library list is *SYSVAL in the display.
*NONE
Include only those jobs whose library list is *NONE in the display.
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.
name
Specify the name of the library list that you want to include in the display.
Top

Job status (STATUS)

Specifies the status code of the jobs that you want to work with.

*ALL
Include all jobs that meet the specifications of the other parameters.
*READY
Include only jobs whose job status is *READY in the Work with Jobs display. 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 Work with Jobs display. 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 Work with Jobs display. Jobs with job status *HELD have been suspended and will not be processed until released.
*PROCESS
Include only those jobs whose job status is *PROCESS in the Work with Jobs display. Jobs with job status *PROCESS are jobs that are currently processing at the time of the display.
*JOBQ
Include only those jobs whose job status is *JOBQ in the Work with Jobs display. Jobs with job status *JOBQ are jobs that are on the job queue at the time of the display.
*SAVED
Include only those jobs whose job status is *SAVED in the Work with Jobs display. Jobs with job status *SAVED 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 work with. 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.

*ALL
You want to work with all job schedule entries, regardless of the text.
*NONE
You want to work with all job schedule entries that have blanks or *NONE for text.
generic-text
Specify generic text. For example, specifying 'THE JOB*' would cause all text that begins the words 'THE JOB' to be included in the display.
character-value
Specify that you want to work with 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 work with. You can include any command request, a string of command characters, or work with entries that have no command request.

*ALL
You want to work with all job schedule entries, regardless of whether they have a command request.
*NONE
You want to work with all job schedule entries that have no command request.
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.
command
Specify that you want to work with all job schedule entries that have the command request specified.
Top

Sequence (SEQ)

Specifies the sequence in which you want to work with the selected job schedule entries.

*JOB
You want to work with the job schedule entries in job sequence.
*DATE
You want to work with the job schedule entries in schedule date sequence.
*GROUP
You want to work with the job schedule entries in group sequence.
Top

Examples

WRKJOBJS   SCDCDE(*DAILY)  STATUS(*READY)  SEQ(*DATE)

This command displays the Work with Jobs panel showing all jobs that have a schedule code of *DAILY and a status code of *READY. The jobs are presented in date sequence.

Top

Error messages

Unknown
Top