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 IBM Advanced Job Scheduler for i . 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 | ||
DTALIB | Data library | Name, *USRPRF | Optional |
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 |
Data library (DTALIB)
Specifies the data library to access.
- *USRPRF
- The data library specified in the user profile for the current user will be used.
- name
- Specify the data library to be assigned to the user profile. The data library specified will be used for the current user profile until it is changed.
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.
- *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 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
UnknownTop |