Work with History using JS (WRKHSTJS)
| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
The Work with History using Job Scheduler (WRKHSTJS) command allows you to work with job completion history based on specified completion status, date ranges and sequences. The Work with History using Job Scheduler command takes you to the Work with History display which shows the job information, last run information and completion status for jobs based on the parameters you have selected in the WRKHSTJS command.
| 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 |
| STATUS | Completion status | Single values: *ALL Other values (up to 7 repetitions): *NORMAL, *ABNORMAL, *ABNGRP, *SBMERROR, *PROCESS, *JOBQ, *CANCELLED, *RESET |
Optional |
| PERIOD | Time period for history 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 | ||
| RMTLOCNAME | Remote location name | Name, *ALL, *LCL, *JOBCTL | Optional |
| SEQOPT | Sequence option | *DATE, *JOB, *GROUP | Optional |
| START | Entries to display first | *LAST, *FIRST | Optional |
| Top |
Job entry (JOB)
Specifies the name of the job or jobs that you want to work with. You can specify a group and associated sequence numbers for the jobs whose history you want to work with. You can sequence the display by job, by date or by group. When you press Enter, you are taken to the Work with History display where you can perform various actions on the selected job history information.
Element 1: Job
- *ALL
- You want to work with IBM Advanced Job Scheduler for i history for all jobs that meet the criteria specified in the command.
- generic-name
- The job is generic. For example, specifying JOB* would cause all jobs whose names begin with JOB to be included in the Work with History display.
- name
- Specify the name of the job that you want to work with.
Element 2: Group
- *ALL
- You want to work with IBM Advanced Job Scheduler for i history for all jobs that are members of any group.
- *NONE
- The job is not a member of a group.
- generic-name
- The group is generic. For example, specifying GROUP* would cause all groups whose names begin with GROUP to be included in the Work with History display.
- name
- Specify the name of the group for which you want to work with.
Element 3: Group sequence
- *ALL
- All sequence numbers should be included in the jobs that you want to work with.
- *NONE
- The job does not have a sequence number.
- 1-99
- Specify the sequence number of the job 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 |
Completion status (STATUS)
Specifies the completion status that you want to use when displaying the IBM Advanced Job Scheduler for i history information.
Single values
- *ALL
- Include all jobs in the Work with History display regardless of completion status.
Other values (up to 7 repetitions)
- *NORMAL
- The job came to normal end of job completion.
- *ABNORMAL
- The job completed abnormally. The IBM Advanced Job Scheduler for i log can be used to determine why the job ended abnormally.
- *ABNGRP
- The group ended abnormally. This completion status applies to all jobs in the group that did not process because a previous job group did not run successfully.
- *SBMERROR
- The job did not run successfully because there was an error in the job submission. An example of a submission error would be a job submitted by a user who did not have the proper authority to submit the job.
- *PROCESS
- The job is currently in process on the system.
- *JOBQ
- The job is currently in the job queue waiting for processing.
- *CANCELLED
- The job was cancelled prior to its completion.
- *RESET
- The job was manually reset.
| Top |
Time period for history output (PERIOD)
Specifies the period of time for which the history entries are selected for the display.
Element 1: Start time and date
Specifies the beginning time and date at or after which history entries are to be included. Any jobs started before the specified time and date are not included in the display.
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 history 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 history entries are included.
- *CURRENT
- History entries with a current date run 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.
- number
- 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/09 (date format is mm/dd/yy), the Begin date for the IBM Advanced Job Scheduler for i history would be 3/2/09.
Element 2: End time and date
Specifies the ending time and date before which history entries are included. Any job completion times after the specified time and date are not included in the history entries for the display.
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 history entries are to be included.
Element 2: Ending date
- *END
- The history entries to the end of the history information are included in the display.
- *CURRENT
- History entries whose run date is on or before the current date are included in the display.
- date
- Specify the ending date. The date must be specified in the job date format.
- number
- 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/09 (date format is mm/dd/yy), the End date for the IBM Advanced Job Scheduler for i history would be 3/12/09.
| Top |
Remote location name (RMTLOCNAME)
Specifies the remote location and network identification of the system that created the job history that you want to work with.
- *ALL
- Selects all job history for all systems in the network.
- *LCL
- Selects all job history for the local system.
- *JOBCTL
- Selects all job history using *JOBCTL as the remote location name.
- remote-location-name
- Specify the name of the remote location associated with the system whose job history 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 |
Sequence option (SEQOPT)
The Work with History display can be sequenced several ways.
- *DATE
- Sequences the Work with History display by date.
- *JOB
- Sequences the Work with History display by job.
- *GROUP
- Sequences the Work with History display by group.
| Top |
Entries to display first (START)
Specifies whether the newest job history entries or the oldest job history entries are shown first. The display station user can roll the display up or down to see other job history entries if the job history entry is on another display screen.
- *LAST
- The last (newest) job history is shown on the bottom line of the display.
- *FIRST
- The first (oldest) job history is shown on the top line of the display.
| Top |
Examples
WRKHSTJS SEQOPT(*JOB)
This command displays the Work with History panel for all jobs and all groups, sequenced by job.
| Top |
Error messages
Unknown| Top |