Work with History using JS (WRKHSTJS)

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

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 Advanced Job Scheduler 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 Advanced Job Scheduler 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.

Completion status (STATUS)

Specifies the completion status that you want to use when displaying the Advanced Job Scheduler 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 Advanced Job Scheduler 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.

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/01 (date format is mm/dd/yy), the Begin date for the Advanced Job Scheduler history would be 3/2/01.

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/01 (date format is mm/dd/yy), the End date for the Advanced Job Scheduler history would be 3/12/01.

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.