Display History using JS (DSPHSTJS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display History using Job Scheduler (DSPHSTJS) command allows you to display or print job completion history based on specified completion status, date ranges and sequences. The Display History using Job Scheduler command takes you to the Display History display which shows the job information, last run information and completion status for jobs based on the parameters you have selected in the DSPHSTJS 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 | ||
| 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 |
| OUTPUT | Output | Optional |
| Top |
Job entry (JOB)
Specifies the name of the job or jobs that you want to display or print. You can specify a group and associated sequence numbers for the jobs whose history you want to display or print. You can sequence the display or report by job, by date or by group. When you press Enter, you are taken to the Display History panel where you can perform various actions on the selected job history information.
Element 1: Job
- *ALL
- You want to display or print IBM Advanced Job Scheduler for i history for all jobs that meet the criteria specified in the command.
- generic-name
- Specify the generic job. For example, specifying JOB* would cause all jobs whose names begin with JOB to be included.
- name
- Specify the name of the job that you want to display or print.
Element 2: Group
- *ALL
- You want to display or print 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
- Specify the generic group. For example, specifying GROUP* would cause all groups whose names begin with GROUP to be included.
- name
- Specify the name of the group for which you want to display or print.
Element 3: Group sequence
- *ALL
- All sequence numbers should be included in the jobs that you want to display or print.
- *NONE
- The job does not have a sequence number.
- 1-99
- Specify the sequence number of the job that you want to display or print.
| Top |
Completion status (STATUS)
Specifies the completion status that you want to use when displaying or printing IBM Advanced Job Scheduler for i history information.
Single values
- *ALL
- Include all jobs in the Display 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 or report.
Element 1: Start time and date
Specifies the beginning time and date at or after which history entries are included. Any jobs started before the specified time and date are not included in the display or report.
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.
- integer
- 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 after which history entries are not included. Any job completion times after the specified time and date are not included in the history entries for the display or report.
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 or report.
- *CURRENT
- History entries whose run date is on or before the current date are included in the display or report.
- date
- Specify the ending date. The date must be specified in the job date format.
- integer
- 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 display or print.
- *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 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 |
Sequence option (SEQOPT)
Specifies how the Display History display is to be sequenced.
- *DATE
- Sequences the Display History display by date.
- *JOB
- Sequences the Display History display by job.
- *GROUP
- Sequences the Display 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 |
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).
- The output is printed with the job's spooled output.
| Top |
Examples
Example 1: Displaying Job Scheduler History
DSPHSTJS SEQOPT(*JOB) OUTPUT(*PRINT)
This command prints the Job Scheduler History report for all jobs and all groups. The report is sequenced by job.
| Top |
Error messages
Unknown| Top |