Prev | Table of Contents | Next

5. PJS ISPF Interface

An ISPF interface is distributed with PJS. The interface consists of panels that replicate the PJS TSO commands, described in Chapter 4, and a tutorial on PJS/ISPF. Only the panels that replicate the TSO commands are illustrated.

The following diagram provides a high‑level overview of PJS/ISPF:

Figure 2. The PJS ISPF Interface

The PJS Main Menu Panel is a gateway to four panel systems. This panel is discussed in Section 5.1.

The PJS Job Request Panel System is entered through the Job Request Menu Panel. The system is described throughout Section 5.2. The menu panel is discussed in Subsection 5.2.1.

The PJS Calendar Panel System is entered through the Calendar Menu Panel. The system is described throughout Section 5.3. The menu panel is discussed in Subsection 5.3.1.

The PJS Event Panel System is entered through the Event Menu Panel. The system is described throughout Section 5.4. The menu panel is discussed in Subsection 5.4.1.

The PJS/ISPF Tutorial Panels are entered through the PJS Main Menu Panel or from any other panel by entering the HELP command. They can function as a full PJS/ISPF tutorial or as a context‑sensitive help facility. If you prefer to learn PJS from online documentation, you can use the tutorial panels and skip this chapter.

Individual panels are illustrated and discussed in subsections. Each section orders its subsections functionally. In the panel illustrations, underlined fields denote input fields, that is, fields into which you can enter values. Fields without underscores are information fields.

5.1 PJS Main Menu Panel

Use the PJS Main Menu panel as a gateway to PJS/ISPF:

yy/mm/dd hh:mm ----- PJS(tm) - PERSONAL JOB SCHEDULER -------------- v.r.m OPTION ===> __________________________________________________________________ Select one of the following functions: J JOBREQ - Update Job Requests C CALENDAR - Update Calendars E EVENT - Update Events T TUTORIAL - Enter PJS/ISPF Tutorial Select an option, then press ENTER. (c) Copyright, Northrop Grumman, 1990, 2004. For additional copyright information enter ABOUT on the command line. PJS is distributed under the GNU General Public License. For license information enter LICENSE on the command line.

At most sites, you will enter PJS/ISPF from an ISPF menu panel. If you have trouble getting into PJS check with your site administrator.

The following menu options can be selected by typing the appropriate letter on the OPTIONS command line:

J is short for Job Request. This option will display the PJS Job Request Menu panel. For more information on the PJS job request system, please refer to Section 5.2.

C is short for Calendar. This option will display the PJS Calendar Menu panel. For more information on the PJS calendar system, please refer to Section 5.3.

E is short for Event. This option will display the PJS Event Menu panel. For more information on the PJS event system, please refer to Section 5.4.

T is short for Tutorial. This option will display an online tutorial on how to use PJS.

In addition, the following commands can be entered in the OPTIONS or COMMAND line of any PJS/ISPF panel:

ABOUT will display a panel with the PJS copyright information.

LICENSE will display a panel with the PJS software license.

You can exit PJS from this panel by pressing PF3.

5.2 PJS Job Request Panel System

The following figure shows how you can move from one panel to another in the PJS Job Request Panel System.

Figure 3. The PJS Job Request ISPF Panels

The Job Request Menu Panel is the gateway to the PJS job request panel system. From here, you can list, add, modify, delete, or display calendars. This panel is discussed in Subsection 5.2.1.

The List Job Requests Panel lists job requests and their characteristics. If you plan to work with more than one job request during a session, or if you have forgotten the request‑ID for a job request you plan to alter, it's a good idea to use this panel. You can use line commands to select an individual job request to copy, modify, delete, or display. You can also use the ADD primary command to add a new job request from this panel. This panel is discussed in Subsection 5.2.2.

The Add Job Request Panel enables you to create a job request and place it on the PJS Request Queue. This panel is discussed in Subsection 5.2.3.

The Modify Job Request Panel enables you to change the characteristics of an existing job request. This panel is discussed in Subsection 5.2.4.

The Specify Job Frequency Panel is entered from either the Add Job Request Panel or the Modify Job Request Panel, and enables you to specify how often you want PJS to submit the job for execution. This panel is discussed in Subsection 5.2.5.

The Specify Job Request Events Panel is entered from either the Add Job Request Panel or the Modify Job Request Panel, and enables you to specify events, post events, and reset events for a single job request. This panel is discussed in Subsection 5.2.6.

The Delete Job Request Panel enables you to delete a job request from the PJS Request Queue. This panel is discussed in Subsection 5.2.7.

The Display Job Request Panel displays the characteristics of one PJS job request. This panel is discussed in Subsection 5.2.8.

The Display Job Request Events Panel is entered from either the Delete Job Request Panel or the Display Job Request Panel, and displays the name and status of all events specified for one PJS job request. This panel is discussed in Subsection 5.2.9.

The Browse Saved JCL Panel is entered from most of the other PJS job request panels, and displays the job JCL that is saved in the PJS Spool. This panel is discussed in Subsection 5.2.10.

5.2.1 Job Request Menu Panel

Use the Job Request Menu Panel as a gateway to the PJS job request panel system.

yy/mm/dd hh:mm ----- PJS(tm) - JOB REQUEST MENU ----------------------------- OPTION ===> ___________________________________________________________________ Select one of the following functions: L LIST - List all Job Requests for Owner A ADD - Add a new Job Request D DELETE - Delete a Job Request M MODIFY - Modify a Job Request S DISPLAY - Display a Job Request Request-ID: Owner-ID ===> xxxxxxxx Request Num ===> nnn (Required for options D, M, and S) Enter Request-ID (if required) and make a selection, then press ENTER.

You can enter this panel from the PJS Main Menu Panel.

The following menu options can be selected by typing the appropriate letter on the OPTIONS command line:

L is short for List. This option will display the List Job Requests panel. This panel is described in Subsection 5.2.2. When using this option the PJS owner-ID to be listed should be entered in the Owner-ID input field.

A is short for Add. This option will display the Add Job Request panel. This panel is described in Subsection 5.2.3. When using this option the PJS owner-ID for the job request to be added should be entered in the Owner-ID input field.

D is short for Delete. This option will display the Delete Job Request panel. This panel is described in Subsection 5.2.7. When using this option the PJS job request-ID for the job request to be deleted should be entered in the Owner-ID and Request Num input fields.

M is short for Modify. This option will display the Modify Job Request panel. This panel is described in Subsection 5.2.4. When using this option the PJS job request-ID for the job request to be modified should be entered in the Owner-ID and Request Num input fields.

S is short for Select or diSplay. This option will display the Display Job Request panel. This panel is described in Subsection 5.2.8. When using this option the PJS job request-ID for the job request to be displayed should be entered in the Owner-ID and Request Num input fields.

You can exit this panel and return to the PJS Main Menu panel by pressing PF3.

The following input fields are available:

Owner‑ID specifies who "owns" the job request you are adding, deleting, modifying, listing, or displaying. You must be authorized to access job requests for an owner-ID other than your own. For more information on the owner‑ID specification, please refer to Section 3.1.

Request Num is the job request number PJS issued to a job request on the PJS Request Queue. If you plan to delete, modify, or display a job request, you must enter a value in this input field. For more information on this specification, please refer to Section 3.2.

5.2.2 List Job Requests Panel

Use the List Job Requests Panel to display a set of existing job requests.

yy/mm/dd hh:mm ----- PJS(tm) - LIST JOB REQUESTS --------- LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx S Request-ID Status Next Date/Time Frequency Events Member _ xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxx _ xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm nnn YR NONE xxxxxxx _ xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm SU,MO,TU,WE,TH,FR,SA nn OF nn xxxxxxx _ xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm EOM-nn POSTED xxxxxxx _ xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm CAL-xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxx _ xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxx _ xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . Commands ==> ADD - Add a new request Line Commands ==> C - Copy Request, D - Delete Request, M - Modify Request, S - Display Request, J - Browse Saved JCL

yy/mm/dd hh:mm ----- PJS(tm) - LIST JOB REQUESTS --------- LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx S Request-ID Member JCL Data Set Name Instdata _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Commands ==> ADD - Add a new request Line Commands ==> C - Copy Request, D - Delete Request, M - Modify Request, S - Display Request, J - Browse Saved JCL

This panel can be scrolled up and down to display more job requests. Use PF7 and PF8 keys to scroll the data up and down.

On an 80‑column display, part of the panel extends beyond the right border. Use the PF10 and PF11 keys to scroll the data left and right. As you scroll the S and Request‑ID fields keep their position:

You can enter this panel from the Job Request Menu Panel.

The following command can be entered on the COMMAND line:

ADD This will display the Add Job Request panel. This panel is described in Subsection 5.2.3.

The following line commands can be selected by typing the appropriate letter in the S field for one of the displayed job requests:

C is short for Copy. This option will display the Add Job Requests panel. This panel is described in Subsection 5.2.2. The values of a copied job request serve as defaults for the new job request to be added. The input fields on the Add Job Request Panel will contain the values assigned to the copied job request as will the fields on the Specify Job Frequency Panel and the Specify Job Request Events Panel.

D is short for Delete. This option will display the Delete Job Request panel for the selected job request. This panel is described in Subsection 5.2.7.

M is short for Modify. This option will display the Modify Job Request panel for the selected job request. This panel is described in Subsection 5.2.4.

S is short for Select or diSplay. This option will display the Display Job Request panel for the selected job request. This panel is described in Subsection 5.2.8.

J is short for JCL. This option will display the Browse Saved JCL panel for the selected job request. This panel is described in Subsection 5.2.10.

You can exit this panel and return to the PJS Job Request Menu panel by pressing PF3.

The following fields are displayed for each job request:

Request‑ID is the unique ID for the job request. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

Next Date/Time is the date and time on which PJS is to submit the job. The format of this information field is mm/dd/yyyy hh:mm.

Frequency is how often PJS is to submit the job request. Valid values are:

ONCE means the job is submitted one time.

nnn MINUTES means the job is to be submitted every nnn minutes.

nnn HOURS means the job is to be submitted every nnn hours.

nnn DAYS means the job is to be submitted every nnn days.

nnn WEEKS means the job is to be submitted every nnn weeks.

nn MONTHS means the job is to be submitted every nn months.

nn YEARS means the job is to be submitted every nn years.

day[, day]... means the job is to be submitted the displayed weekdays. Valid values for day are:

SU Sunday.

MO Monday.

TU Tuesday.

WE Wednesday.

TH Thursday.

FR Friday.

SA Saturday.

EOM‑nn means the job is to be submitted nn days before the end of each month.

CAL‑calendar‑ID means that the indicated PJS calendar was specified for the job request.

CAL‑MULTI means that multiple calendars were specified. Up to three calendars can be specified. The job request must be displayed individually to see all of the specified calendars.

Events tells you how many job request events are posted. Valid values are:

NONE means no events were specified for the job request.

pe OF ne means that some, but not all, of the job request events are posted. The number of posted events is displayed against the total number of events:

pe is the number of posted events.

ne is the total number of events.

POSTED means that all job request events are posted.

Member is the name of the member that contains the job.

JCL Data Set Name is the name of the JCL data set.

Instdata is short for Installation Data. This information field can be used to display site‑specific data. For example, the PJS Installation Data Format Exit can use this field to display site‑specific information.

5.2.3 Add Job Request Panel

Use the PJS Add Job Request Panel to create and place a job request on the PJS Request Queue:

yy/mm/dd hh:mm ----- PJS(tm) - ADD JOB REQUEST ------------------------------ COMMAND ===> __________________________________________________________________ Request-ID ===> xxxxxxxx.nnn Status ===> xxxxxxxx Enabled ===> xxx (Yes or No) JCL Data Set ===> xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx Member ===> xxxxxxxx Save ===> xxx (Yes or No) Start Date ===> mm/dd/yyyy (for one-time job request) Start Time ===> hh:mm___ Commands ==> FREQ - Specify Job Frequency, EVENT - Specify Events, END - Complete Add, CANCEL - Cancel Add

You can enter this panel from the Job Request Menu Panel or the List Job Requests Panel.

The following informational fields are displayed:

Request‑ID is the unique ID for the job request to be added. However, before the add is complete the request number has not yet been assigned. As a result, on this panel, the request-number portion of the request-ID will always be 000. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

The following data entry fields are available:

Enabled tells PJS whether you want to submit the job.

YES puts the job request in WAIT status. When the job request is placed on the PJS Request Queue, PJS can submit the job for execution.

NO puts the job request in DISABLED status. The job request is placed on the PJS Job Request Queue, but PJS will not submit the job for execution. You can use this value to enter the information for a job request, but temporarily prevent job submission.

JCL Data Set is the name of the JCL data set. This is always a fully qualified data set name. Do not use quotes. The name you specify will be saved in your ISPF profile and used as a default in the future.

Member is the name of the member of the JCL Data Set that contains the job. If the JCL data set is a partitioned data set (PDS), you must specify a valid value in this field.

Save tells PJS whether to place a copy of the job JCL on the PJS JCL Spool. If you place job JCL on the PJS JCL Spool, PJS can provide protection from accidental modification or unauthorized access. However, if your site uses a security package such as RACF, your job JCL may already be protected from intrusive access. Valid values are:

NO tells PJS not to place a copy of the job JCL on the PJS JCL Spool. When the job is submitted, the JCL in the JCL data set at the time of submission will be executed.

YES tells PJS to place a copy of the job JCL on the PJS JCL Spool. When the job is submitted, the JCL on the PJS JCL Spool will be executed.

The default for PJS JCL Spool use was determined when PJS was installed. Your site may require you to specify either NO or YES, or you may be able to specify either value. For more information, please contact your Site Administrator or the person who installed PJS.

Start Date tells PJS which date you want to submit the job for execution. The default is the current system date, which is usually today's date. You can specify an absolute date in the mm/dd/yyyy format or a relative date in the *+ddd format. For more information on date specifications, please refer to Section 3.6.

Start Time tells PJS what time you want to submit the job for execution. There is no default, you must specify a valid time. You can specify an absolute time in the hh:mm[AM|PM] format or a relative time in the *+{hh:mm|hh|:mm} format. For more information on time specifications, please refer to Section 3.5.

The following commands can be entered on the COMMAND line:

FREQ displays the Specify Job Frequency panel. This panel enables you to tell PJS how often to submit the job. If you do not use this panel, the job is only submitted once. For more information on the Specify Job Frequency panel, please refer to Subsection 5.2.5.

EVENT displays the Specify Job Request Events panel. This panel enables you to any events that must be posted before the job is submitted. For more information on the Specify Job Request Events panel, please refer to Subsection 5.2.6.

END completes that add and exits the panel after processing the values you entered. Use this command to create a PJS job request that will be placed on the PJS Request Queue. You can also press the PF3 key to perform this function.

CANCEL exits the panel without processing any of the values you may have entered. Use this command if you decide not to create a PJS job request.

5.2.4 Modify Job Request Panel

Use the PJS Modify Job Request Panel to modify a job request on the PJS Request Queue:

yy/mm/dd hh:mm ----- PJS(tm) - MODIFY JOB REQUEST --------------------------- COMMAND ===> __________________________________________________________________ Request-ID ===> xxxxxxxx.nnn Status ===> xxxxxxxx Enabled ===> xxx (Yes or No) JCL Data Set ===> xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx Member ===> xxxxxxxx Save ===> xxxxxxx (Yes, No, or Refresh) Start Date ===> mm/dd/yyyy (for one-time job request) Start Time ===> hh:mm___ Installation Data Heading xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Inst Data ===> xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Commands ==> FREQ - Specify Job Frequency, EVENT - Specify Events, JCL - Browse Saved JCL, END - Complete Modify, CANCEL - Cancel Modify

The following informational fields are displayed:

Request‑ID is the unique ID for the job request to be modified. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

Inst Data is an information field that can be used to display site‑specific data.

The following data entry fields are available:

Enabled tells PJS whether you want to submit the job.

YES puts the job request in WAIT status. When the job request is placed on the PJS Request Queue, PJS can submit the job for execution.

NO puts the job request in DISABLED status. The job request is placed on the PJS Job Request Queue, but PJS will not submit the job for execution. You can use this value to enter the information for a job request, but temporarily prevent job submission.

JCL Data Set is the name of the JCL data set. This is always a fully qualified data set name. Do not use quotes.

Member is the name of the member of the JCL Data Set that contains the job. If the JCL data set is a partitioned data set (PDS), you must specify a valid value in this field.

Save tells PJS whether to place a copy of the job JCL on the PJS JCL Spool. If you place job JCL on the PJS JCL Spool, PJS can provide protection from accidental modification or unauthorized access. However, if your site uses a security package such as RACF, your job JCL may already be protected from intrusive access. Valid values are:

NO tells PJS not to place a copy of the job JCL on the PJS JCL Spool. When the job is submitted, the JCL in the JCL data set at the time of submission will be executed.

YES tells PJS to place a copy of the job JCL on the PJS JCL Spool. When the job is submitted, the JCL on the PJS JCL Spool will be executed.

REFRESH tells PJS to replace the copy of the job JCL on the PJS JCL Spool. Use this keyword if you have already saved a copy of the job JCL and want to apply any new changes or updates to job JCL. This option is only valid if a copy of the job request’s JCL has already been saved in the PJS JCL Spool.

The default for PJS JCL Spool use was determined when PJS was installed. Your site may require you to specify either NO or YES, or you may be able to specify either value. For more information, please contact your Site Administrator or the person who installed PJS.

Start Date tells PJS which date you want to submit the job for execution. You can specify an absolute date in the mm/dd/yyyy format or a relative date in the *+ddd format. For more information on date specifications, please refer to Section 3.6.

Start Time tells PJS what time you want to submit the job for execution. You can specify an absolute time in the hh:mm[AM|PM] format or a relative time in the *+{hh:mm|hh|:mm} format. For more information on time specifications, please refer to Section 3.5.

The following commands can be entered on the COMMAND line:

FREQ displays the Specify Job Frequency panel. This panel enables you to tell PJS how often to submit the job. For more information on the Specify Job Frequency panel, please refer to Subsection 5.2.5.

EVENT displays the Specify Job Request Events panel. This panel enables you to any events that must be posted before the job is submitted. For more information on the Specify Job Request Events panel, please refer to Subsection 5.2.6.

JCL displays the Browse Saved JCL panel. This panel enables you to review the JCL that has been saved in the PJS JCL Spool. This command is only valid if a copy of the job request’s JCL has already been saved in the PJS JCL Spool. For more information on the Browse Saved JCL panel, please refer to Subsection 5.2.10.

END completes that modify and exits the panel after processing the values you entered. You can also press the PF3 key to perform this function.

CANCEL exits the panel without processing any of the values you may have entered. Use this command if you decide not to create a PJS job request.

5.2.5 Specify Job Frequency Panel

Use the Specify Job Frequency Panel to tell PJS how often to submit the job:

yy/mm/dd hh:mm ----- PJS(tm) - SPECIFY JOB FREQUENCY ------------------------ COMMAND ===> __________________________________________________________________ Request-ID ===> xxxxxxxx.nnn Status ===> xxxxxxxx Start Date ===> mm/dd/yyyy End Date ===> mm/dd/yyyy Start Time ===> hh:mm___ End Time ===> hh:mm___ Window Time ===> hh:mm (hh:mm) Window Optn ===> xxxxxxxx (Disable, Error, or Skip) Frequency (choose one of the options below) Periodic ===> num (num) units__ (units - Yr, Mo, Wk, Day, Hr, or Min) or Day of Week ===> x Sun x Mon x Tue x Wed x Thu x Fri x Sat or End of Month ===> Last Day - nn (days before last day of each month) or Calendar(s) ===> xxxxxxxx.xxxxxxxx xxxxxxxx.xxxxxxxx xxxxxxxx.xxxxxxxx or Once (if none of the above is specified) Commands ==> EVENT - Specify Events, JCL - Browse Saved JCL, END - Complete Updates, CANCEL - Cancel Updates

You can enter this panel from the Add Job Request Panel, the Modify Job Request Panel, or the Specify Job Request Events panel.

The following informational fields are displayed:

Request‑ID is the unique ID for the job request. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

The following data entry fields are available:

Start Date tells PJS which date you want to submit the job for execution. You can specify an absolute date in the mm/dd/yyyy format or a relative date in the *+ddd format. For more information on date specifications, please refer to Section 3.6.

Start Time tells PJS what time you want to submit the job for execution. You can specify an absolute time in the hh:mm[AM|PM] format or a relative time in the *+{hh:mm|hh|:mm} format. For more information on time specifications, please refer to Section 3.5.

End Date tells PJS the date on which it will stop submitting the job for execution. You can specify an absolute date in the mm/dd/yyyy format or a relative date in the *+ddd format. For more information on date specifications, please refer to Section 3.6.

End Time tells PJS at what time it is to stop submitting the job for execution. If you plan to use the end time parameter, you must also have values specified in the End Date input field. You can specify an absolute time in the hh:mm[AM|PM] format or a relative time in the *+{hh:mm|hh|:mm} format. For more information on time specifications, please refer to Section 3.5.

Window Time specifies a window of time during which PJS can submit your job. A job can be submitted late because PJS was down or because events were not posted. While the time window is open, PJS may resume operation or the events may be posted. If your job isn't submitted while the time window is open, the action specified by the Window Optn field is taken. The Window Optn parameter is discussed below.

The Window Time field specifies a time relative to the value specified in the Start Time field to determine when the window closes. For example, if submission time is 10:00 and you want to open a time window for two hours, you can enter a relative time value of 2:00. The time window will close at 12:00.

To specify the window time, use the hh:mm format, where:

hh is the number of hours. Valid values are 00 through 99.

mm is the number of minutes. Valid values are 00 through 99.

If you don't want a time window for the job request, you can overtype the value in the Window Time field with blank characters. A job request without a window time can be delayed indefinitely, and will still be submitted as soon as all its events have been posted and the PJS System Task is up.

Window Opt tells PJS what to do if the job cannot be submitted within the time window specified by the Window Time field. You must specify a value for Window Time if you plan to use this parameter.

You can specify one of the following:

DISABLE places the job request in DISABLED status. The job request remains on the PJS Request Queue, but it is inactive. PJS cannot submit the job.

ERROR places the job request in ERROR status. The job request remains on the PJS Request Queue until it is modified or deleted. This is the default.

SKIP causes PJS to behave as if the job was submitted. PJS calculates a new run date and time, and resets all job request events. When the new start time value is reached, PJS will attempt to submit the job.

To activate the job request, you can specify Yes in the Enabled field on the Modify Job Request Panel. For more information on the Modify Job Request Panel, please refer to Subsection 5.2.4.

Periodic means that you want PJS to submit the job for execution at regular intervals.

This field consists of two subfields, num and units, where:

num is the number that specifies how many units elapse between each job submission. If you specify unit as YR for year or MO for month, valid values range from 1 through 99. For any other unit, valid values range from 1 through 999.

unit is a measure of time multiplied by num to determine how much time elapses between job submissions. When you specify a unit, you can use the displayed abbreviations, the full name of the unit, or you can abbreviate the full name by specifying the first two or three characters in the unit name. You can specify one of the following valid values:

YR means that the job is to be submitted for execution every num years.

MO means that the job is to be submitted for execution every num months.

Caution: If the number of days in a month is less than the value of Start Date, PJS does not submit your job during that month.

For example, if the start date for a monthly job is January 31, PJS assumes you want to submit the job on the 31st of each month and that every month has 31 days. To calculate the next run date, it adds 31 days to January 31: the next run date is February 31st. The job is actually submitted 31 days from January 31. In most years, the next actual run date is March 3, so the job is not submitted during the month of February. The job is next submitted on March 31, so the monthly job is submitted twice in March.

You can avoid this problem by specifying a start date that begins no later than the 28th day of the month. For example, if you specify 1 MO and a start date of January 16, PJS will submit the job on the 16th of each month.

WK means that the job is to be submitted for execution every num weeks.

DAY means that the job is to be submitted for execution every num days.

HR means that the job is to be submitted for execution every num hours.

MIN means that the job is to be submitted for execution every num minutes.

If you specify a value for Periodic, you cannot also specify a value in any of the other Frequency fields.

Day of Week means that the specified job is submitted for execution every week on each specified days. Select days by typing a non‑blank character in the input field that precedes the appropriate day. To remove a selection, overtype the character in the input field with a blank character. You can select from one through seven days.

If you specify a value for Day of Week, you cannot also specify a value in any of the other Frequency fields.

End of Month means that the job is to be submitted nn days before the end of each month, where nn is a value from 0 through 27.

For example, if you specify 0, the job is submitted each month on the last day of the month, for example, May 31 or June 30. If you specify 3, the job is submitted three days before the end of each month, for example, May 28 or June 27.

If you specify a value for End of Month, you cannot also specify a value in any of the other Frequency fields.

Calendar(s) means that PJS will submit the job for execution on the date or dates specified in a calendar. This enables you to specify an arbitrary set of submission dates. Before you can use this keyword, you must have created at least one calendar. For information on how to create a PJS calendar, please refer to Section 5.3.

You can specify up to three calendars. However, if you specify more than one calendar, PJS only submits the job on the dates that are specified on every calendar.

Specify each calendar‑ID with the [owner‑ID.]cal‑name format, where:

owner‑ID specifies who "owns" the calendar.

cal‑name is the name of the calendar.

For more information on how to specify a calendar‑ID, please refer to Section 3.3.

If you specify a value for Calendar(s), you cannot also specify a value in any of the other Frequency fields.

Once is the default for the Frequency field. If you do not enter a value in any other Frequency field, the job will be submitted for execution once only.

The following commands can be entered on the COMMAND line:

EVENT displays the Specify Job Request Events panel. This panel enables you to any events that must be posted before the job is submitted. For more information on the Specify Job Request Events panel, please refer to Subsection 5.2.6.

JCL displays the Browse Saved JCL panel. This panel enables you to review the JCL that has been saved in the PJS JCL Spool. This command is only valid if a copy of the job request’s JCL has already been saved in the PJS JCL Spool. For more information on the Browse Saved JCL panel, please refer to Subsection 5.2.10.

END completes the information entered on this panel and returns to the Add Job Request panel or the Modify Job Request panel. You can also press the PF3 key to perform this function.

CANCEL cancels all updates (or the add) for the current job request. Use this command if you decide not to create or modify the PJS job request. PJS will return to the Job Request Menu panel or the List Job Requests panel.

5.2.6 Specify Job Request Events Panel

Use the Specify Job Request Events Panel to specify events for a job request:

yy/mm/dd hh:mm ---- PJS(tm) - SPECIFY JOB REQUEST EVENTS - LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx Request-ID ===> xxxxxxxx.nnn Status ===> xxxxxxxx S Event-ID Prepost Date/Time Posted _ xxxxxxxx.xxxxxxxx xxx mm/dd/yyyy hh:mm _ xxxxxxxx.xxxxxxxx xxx _ xxxxxxxx.xxxxxxxx xxx _ xxxxxxxx.xxxxxxxx xxx mm/dd/yyyy hh:mm _ _________________ ___ _ _________________ ___ _ _________________ ___ _ _________________ ___ _ _________________ ___ _ _________________ ___ _ _________________ ___ _ _________________ ___ _ _________________ ___ _ _________________ ___ Commands ==> FREQ - Specify Job Frequency, JCL - Browse Saved JCL, END - Complete Updates, CANCEL - Cancel Updates Line Commands ==> D - Delete Event, P - Post Job Event, R - Reset Job Event

You can enter this panel from the Add Job Request panel, the Modify Job Request panel, or the Specify Job Request Events panel.

The following informational fields are displayed:

Request‑ID is the unique ID for the job request. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

The remainder of the screen displays the job request events that are defined for this job request. The list of job request events can be scrolled up and down to display more job request events. Use PF7 and PF8 keys to scroll the data up and down.

The following fields are displayed for each job request event:

Event‑ID is the event-ID for the job request event. After all existing job request events are displayed, the remaining lines on the screen are formatted with blank entry fields. To add a new job request event, simply enter an Event-ID in a blank Event-ID field. Specify each event‑ID with the [owner‑ID.]event‑name format, where:

owner‑ID specifies who "owns" the event.

event‑name is the name of the event.

For more information on how to specify an event‑ID, please refer to Section 3.4.

The Event-ID field for existing job request events is protected from updates. To change the Event-ID you must delete the existing job request event and add a new one with the new Event-ID.

Prepost tells PJS whether the job request event can be posted prior to the Next Run Date and Time for the job request. This field can also be changed by overtyping the existing value. Valid values are:

NO means that the event will not be posted in the job request record if the event is posted before the job is scheduled for its next submission.

YES means that the job request event will be posted in the job request record whenever the event is posted. PJS doesn't care when the event is posted.

Date/Time Posted is the date and time on which PJS posted the event for this job request. The format of this information field is mm/dd/yyyy hh:mm:ss. If the job request event is not posted, this field is blank.

When an existing job request event appears on a line, the following line commands can be selected by typing the appropriate letter in the S field for that job request event:

D is short for Delete. This option will delete the job request event.

P is short for Post. This option will post the job request event. This will post the event for this job request only. Other job requests are not affected.

R is short for Reset. This option will reset the job request event. This will reset the event for this job request only. Other job requests are not affected.

The following commands can be entered on the COMMAND line:

FREQ displays the Specify Job Frequency panel. This panel enables you to tell PJS how often to submit the job. For more information on the Specify Job Frequency panel, please refer to Subsection 5.2.5.

JCL displays the Browse Saved JCL panel. This panel enables you to review the JCL that has been saved in the PJS JCL Spool. This command is only valid if a copy of the job request’s JCL has already been saved in the PJS JCL Spool. For more information on the Browse Saved JCL panel, please refer to Subsection 5.2.10.

END completes the information entered on this panel and returns to the Add Job Request panel or the Modify Job Request panel. You can also press the PF3 key to perform this function.

CANCEL cancels all updates (or the add) for the current job request. Use this command if you decide not to create or modify the PJS job request. PJS will return to the Job Request Menu panel or the List Job Requests panel.

5.2.7 Delete Job Request Panel

Use the Delete Job Request Panel to remove a job request from the PJS Request Queue:

yy/mm/dd hh:mm ----- PJS(tm) - DELETE JOB REQUEST --------------------------- COMMAND ===> __________________________________________________________________ Request-ID ===> xxxxxxxx.nnn Status ===> xxxxxxxx JCL Data Set ===> xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx Member ===> xxxxxxxx Saved ===> xxx Next Run D/T ===> mm/dd/yyyy hh:mm Last Run D/T ===> mm/dd/yyyy hh:mm:ss Start D/T ===> mm/dd/yyyy hh:mm End D/T ===> mm/dd/yyyy hh:mm Frequency ===> xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Events ===> xxxxxxxx Installation Data Heading xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Inst Data ===> xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Enter 'YES' and press enter to confirm delete ===> ___ Commands ==> EVENT - Display Events, JCL - Browse Saved JCL, END - Complete Delete, CANCEL - Cancel Delete

You can enter this panel from the Job Request Menu panel or the List Job Requests panel.

The following informational fields are displayed:

Request‑ID is the Request-ID for the job request to be deleted. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

JCL Data Set is the name of the JCL data set.

Member is the name of the member of the JCL Data Set that contains the job.

Save indicates if a copy of the job JCL was saved in the PJS JCL Spool. Valid values are:

NO means that the job JCL has not been copied to the PJS JCL Spool. When the job is submitted, the JCL in the JCL data set at the time of submission will be executed.

YES means that the job JCL has been copied to the PJS JCL Spool. When the job is submitted, the JCL on the PJS JCL Spool will be executed.

Next Run D/T is short for Next Run Date and Time, that is, the next date and time on which PJS will submit the job. The format of this information field is mm/dd/yyyy hh:mm. If PJS is not going to submit or resubmit the job, this field is blank.

Last Run D/T is short for Last Run Date and Time, that is, the last date and time on which PJS submitted the job. The format of this information field is mm/dd/yyyy hh:mm:ss. If PJS never submitted the job, this field is blank.

Start D/T is short for Starting Run Date and Time. This is the first date and time on which PJS was to submit the job. The format of this information field is mm/dd/yyyy hh:mm.

End D/T is short for End Run Date and Time. This is the last date and time on which PJS is to submit the job. The format of this information field is mm/dd/yyyy hh:mm. If the last date and time was never specified, this field is blank.

Frequency is how often PJS is to submit the job request. Valid values are:

ONCE means the job is submitted one time.

nnn MINUTES means the job is to be submitted every nnn minutes.

nnn HOURS means the job is to be submitted every nnn hours.

nnn DAYS means the job is to be submitted every nnn days.

nnn WEEKS means the job is to be submitted every nnn weeks.

nn MONTHS means the job is to be submitted every nn months.

nn YEARS means the job is to be submitted every nn years.

day[, day]... means the job is to be submitted the displayed weekdays. Valid values for day are:

SU Sunday.

MO Monday.

TU Tuesday.

WE Wednesday.

TH Thursday.

FR Friday.

SA Saturday.

EOM‑nn means the job is to be submitted nn days before the end of each month.

CAL‑cal‑ID means that the indicated PJS calendar was specified for the job request. Multiple calendars may appear.

Events tells you how many job request events are posted. Valid values are:

NONE means no events were specified for the job request.

pe OF ne means that some, but not all, of the job request events are posted. The number of posted events is displayed against the total number of events:

pe is the number of posted events.

ne is the total number of events.

POSTED means that all job request events are posted.

Inst Data is an information field that can be used to display site‑specific data.

The following data entry field is available:

Enter 'YES'... is the delete confirmation field. You must enter YES in this field, then press the ENTER key, then enter the END command (or press PF3), to complete the delete.

If you decide not to delete the job request, enter the CANCEL command.

The following commands can be entered on the COMMAND line:

EVENT displays the Display Job Request Events panel. For more information on the Display Job Request Events panel, please refer to Subsection 5.2.9.

JCL displays the Browse Saved JCL panel. This panel enables you to review the JCL that has been saved in the PJS JCL Spool. This command is only valid if a copy of the job request’s JCL has already been saved in the PJS JCL Spool. For more information on the Browse Saved JCL panel, please refer to Subsection 5.2.10.

END completes the delete and returns to the Job Request Menu panel or the List Job Requests panel. You must enter ‘YES’ in the delete confirmation field. You can also press the PF3 key to perform this function.

CANCEL exits the panel and returns to the Job Request Menu panel or the List Job Requests panel without performing any processing. Use this command if you decide not to delete the job request.

5.2.8 Display Job Request Panel

Use the Display Job Request Panel to display one job request on the PJS Request Queue:

yy/mm/dd hh:mm ----- PJS(tm) - DISPLAY JOB REQUEST -------------------------- COMMAND ===> __________________________________________________________________ Request-ID ===> xxxxxxxx.nnn Status ===> xxxxxxxx JCL Data Set ===> xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx Member ===> xxxxxxxx Save ===> xxx Next Run D/T ===> mm/dd/yyyy hh:mm Last Run D/T ===> mm/dd/yyyy hh:mm:ss Start D/T ===> mm/dd/yyyy hh:mm End D/T ===> mm/dd/yyyy hh:mm Frequency ===> xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Events ===> xxxxxxxx Installation Data Heading xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Inst Data ===> xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Commands ==> EVENT - Display Events, JCL - Browse Saved JCL

You can enter this panel from the Job Request Menu panel or the List Job Requests panel.

The following informational fields are displayed:

Request‑ID is the Request-ID for the job request. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

JCL Data Set is the name of the JCL data set.

Member is the name of the member of the JCL Data Set that contains the job.

Save indicates if a copy of the job JCL was saved in the PJS JCL Spool. Valid values are:

NO means that the job JCL has not been copied to the PJS JCL Spool. When the job is submitted, the JCL in the JCL data set at the time of submission will be executed.

YES means that the job JCL has been copied to the PJS JCL Spool. When the job is submitted, the JCL on the PJS JCL Spool will be executed.

Next Run D/T is short for Next Run Date and Time, that is, the next date and time on which PJS will submit the job. The format of this information field is mm/dd/yyyy hh:mm. If PJS is not going to submit or resubmit the job, this field is blank.

Last Run D/T is short for Last Run Date and Time, that is, the last date and time on which PJS submitted the job. The format of this information field is mm/dd/yyyy hh:mm:ss. If PJS never submitted the job, this field is blank.

Start D/T is short for Starting Run Date and Time. This is the first date and time on which PJS was to submit the job. The format of this information field is mm/dd/yyyy hh:mm.

End D/T is short for End Run Date and Time. This is the last date and time on which PJS is to submit the job. The format of this information field is mm/dd/yyyy hh:mm. If the last date and time was never specified, this field is blank.

Frequency is how often PJS is to submit the job request. Valid values are:

ONCE means the job is submitted one time.

nnn MINUTES means the job is to be submitted every nnn minutes.

nnn HOURS means the job is to be submitted every nnn hours.

nnn DAYS means the job is to be submitted every nnn days.

nnn WEEKS means the job is to be submitted every nnn weeks.

nn MONTHS means the job is to be submitted every nn months.

nn YEARS means the job is to be submitted every nn years.

day[, day]... means the job is to be submitted the displayed weekdays. Valid values for day are:

SU Sunday.

MO Monday.

TU Tuesday.

WE Wednesday.

TH Thursday.

FR Friday.

SA Saturday.

EOM‑nn means the job is to be submitted nn days before the end of each month.

CAL‑cal‑ID means that the indicated PJS calendar was specified for the job request. Multiple calendars may appear.

Events tells you how many job request events are posted. Valid values are:

NONE means no events were specified for the job request.

pe OF ne means that some, but not all, of the job request events are posted. The number of posted events is displayed against the total number of events:

pe is the number of posted events.

ne is the total number of events.

POSTED means that all job request events are posted.

Inst Data is an information field that can be used to display site‑specific data.

The following commands can be entered on the COMMAND line:

EVENT displays the Display Job Request Events panel. For more information on the Display Job Request Events panel, please refer to Subsection 5.2.9.

JCL displays the Browse Saved JCL panel. This panel enables you to review the JCL that has been saved in the PJS JCL Spool. This command is only valid if a copy of the job request’s JCL has already been saved in the PJS JCL Spool. For more information on the Browse Saved JCL panel, please refer to Subsection 5.2.10.

END returns to the Job Request Menu panel or the List Job Requests panel. You can also press the PF3 key to perform this function.

5.2.9 Display Job Request Events Panel

Use the Display Job Request Events Panel to see which events have been specified for a job request:

yy/mm/dd hh:mm ---- PJS(tm) - DISPLAY JOB REQUEST EVENTS - LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx Request-ID ===> xxxxxxxx.nnn Status ===> xxxxxxxx Event-ID Prepost Date/Time Posted xxxxxxxx.xxxxxxxx xxx mm/dd/yyyy hh:mm xxxxxxxx.xxxxxxxx xxx xxxxxxxx.xxxxxxxx xxx xxxxxxxx.xxxxxxxx xxx mm/dd/yyyy hh:mm . . . . . . . . . . . . . . . Commands ==> JCL - Browse Saved JCL

You can enter this panel from the Display Job Request panel or the Delete Job Request panel.

The following informational fields are displayed:

Request‑ID is the unique ID for the job request. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

The remainder of the screen displays the job request events that are defined for this job request. The list of job request events can be scrolled up and down to display more job request events. Use PF7 and PF8 keys to scroll the data up and down.

The following fields are displayed for each job request event:

Event‑ID is the event-ID for the job request event. For more information please refer to Section 3.4.

Prepost tells PJS whether the job request event can be posted prior to the Next Run Date and Time for the job request. Valid values are:

NO means that the event will not be posted in the job request record if the event is posted before the job is scheduled for its next submission.

YES means that the job request event will be posted in the job request record whenever the event is posted. PJS doesn't care when the event is posted.

Date/Time Posted is the date and time on which PJS posted the event for this job request. The format of this information field is mm/dd/yyyy hh:mm:ss. If the job request event is not posted, this field is blank.

The following commands can be entered on the COMMAND line:

JCL displays the Browse Saved JCL panel. This panel enables you to review the JCL that has been saved in the PJS JCL Spool. This command is only valid if a copy of the job request’s JCL has already been saved in the PJS JCL Spool. For more information on the Browse Saved JCL panel, please refer to Subsection 5.2.10.

END returns to the Display Job Request panel or the Delete Job Request panel. You can also press the PF3 key to perform this function.

5.2.10 Browse Saved JCL Panel

Use the Browse Saved JCL Panel to review JCL saved on the PJS JCL Spool:

BROWSE xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxx Line nnnnnnnn Col nnn nnn COMMAND ===> ________________________________________________ Scroll ===> xxxx ********************************* Top of Data ********************************* // JCL // STATEMENTS // . // . // . ******************************** Bottom of Data *******************************

You can enter this panel from the List Job Request panel, the Modify Job Request panel, the Delete Job Request panel, the Display Job Request panel, the Specify Job Frequency panel, the Specify Job Request Events panel, or the Display Job Request Events panel.

The JCL is displayed using the ISPF browse facility. For detailed instructions on how to use ISPF Browse, consult your ISPF documentation. You cannot edit the displayed JCL.

5.3 PJS Calendar Panel System

The following diagram provides an overview of the PJS calendar panel system:

Figure 4. The PJS Calendar ISPF Panels

The Calendar Menu Panel is the gateway to the PJS calendar panel system. From here, you can list, add, modify, delete, or display calendars. This panel is discussed in Subsection 5.3.1.

The List Calendars Panel lists calendars and their characteristics. You can also add, modify, delete, or display calendars. Additionally, you can display a list of which job requests have specified a given calendar. If you plan to work with more than one calendar during a session, it's a good idea to use this panel. The List Calendars Panel is discussed in Subsection 5.3.2.

The Add Calendar ID Panel is displayed when you add or copy a panel from the List Calendars Panel. It enables you to specify a calendar‑ID for the new calendar. The Add Calendar ID Panel is discussed in Subsection 5.3.3.

The Add Calendar Panel enables you to create a PJS calendar. To build a calendar, you must select at least one date. The dates you select are the dates on which you want PJS to submit a job. You must create a calendar before you can specify one in a job request. This panel is discussed in Subsection 5.3.4.

The Modify Calendar Panel enables you to add or delete selected dates on a PJS calendar. This panel is discussed in Subsection 5.3.5.

The Delete Calendar Panel enables you to delete a calendar. If you want to remove the calendar specification from a job request, but keep the calendar, please use the Modify Job Request Panel, which is discussed in Subsection 5.2.4. If, however, you want to delete the calendar, the Delete Calendar Panel is discussed in Subsection 5.3.6.

The Display Calendar Panel displays the characteristics of one PJS calendar. This panel is discussed in Subsection 5.3.7.

The Job Requests for Calendar Panel displays the characteristics of a job request in which a given PJS calendar was specified. This panel is discussed in Subsection 5.3.8.

5.3.1 Calendar Menu Panel

Use the Calendar Menu Panel as a gateway to the PJS calendar panel system:

yy/mm/dd hh:mm ----- PJS(tm) - CALENDAR MENU -------------------------------- OPTION ===> ___________________________________________________________________ Select one of the following functions: L LIST - List all Calendars for Owner-ID A ADD - Add a new Calendar D DELETE - Delete a Calendar M MODIFY - Modify a Calendar S DISPLAY - Display a Calendar Calendar-ID: Owner-ID ===> xxxxxxxx Calendar Name ===> xxxxxxxx (Required for options A, D, M, and S) Enter Calendar-ID (if required) and make a selection, then press ENTER.

You can enter this panel from the PJS Main Menu Panel.

The following menu options can be selected by typing the appropriate letter on the OPTIONS command line:

L is short for List. This option will display the List Calendars panel. This panel is described in Subsection 5.3.2. When using this option the PJS owner-ID to be listed should be entered in the Owner-ID input field.

A is short for Add. This option will display the Add Calendar panel. This panel is described in Subsection 5.3.4. When using this option the PJS owner-ID for the calendar to be added should be entered in the Owner-ID input field.

D is short for Delete. This option will display the Delete Calendar panel. This panel is described in Subsection 5.3.6. When using this option the PJS calendar-ID for the calendar to be deleted should be entered in the Owner-ID and Calendar Name input fields.

M is short for Modify. This option will display the Modify Calendar panel. This panel is described in Subsection 5.3.5. When using this option the PJS calendar-ID for the calendar to be modified should be entered in the Owner-ID and Calendar Name input fields.

S is short for Select or diSplay. This option will display the Display Calendar panel. This panel is described in Subsection 5.3.7. When using this option the PJS calendar-ID for the calendar to be displayed should be entered in the Owner-ID and Calendar Name input fields.

You can exit this panel and return to the PJS Main Menu panel by pressing PF3.

The following input fields are available:

Owner‑ID specifies who "owns" the calendar you are adding, deleting, modifying, listing, or displaying. You must be authorized to access calendars for an owner-ID other than your own. For more information on the owner‑ID specification, please refer to Section 3.1.

Calendar Name is the name of the calendar. If you plan to add, delete, modify, or display a calendar, you must enter a value in this input field. For more information on this specification, please refer to Section 3.3.

5.3.2 List Calendars Panel

Use the List Calendars Panel to display a set of calendars for a specified owner‑ID:

yy/mm/dd hh:mm ----- PJS(tm) - LIST CALENDARS ------------ LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx S Calendar-ID Next Date _ xxxxxxxx.xxxxxxxx mm/dd/yyyy _ xxxxxxxx.xxxxxxxx mm/dd/yyyy _ xxxxxxxx.xxxxxxxx mm/dd/yyyy _ xxxxxxxx.xxxxxxxx mm/dd/yyyy . . . . . . . . . . . . Commands ==> ADD - Add a new calendar Line Commands ==> C - Copy Calendar, D - Delete Calendar, M - Modify Calendar, S - Display Calendar, J - List Job Requests for Calendar

You can enter this panel from the Calendar Menu Panel.

This panel can be scrolled up and down to display more calendars. Use PF7 and PF8 keys to scroll the data up and down.

The following command can be entered on the COMMAND line:

ADD This will display the Add Calendar-ID panel. This panel is described in Subsection 5.3.3.

The following line commands can be selected by typing the appropriate letter in the S field for one of the displayed calendars:

C is short for Copy. This option will display the Add Calendar-ID panel. This panel is described in Subsection 5.3.3. After you enter a new calendar name on this panel, the Add Calendar panel will be displayed. This panel is described in Subsection 5.3.4. The dates of the copied calendar serve as defaults for the new calendar to be added. The new calendar that appears on the Add Calendar panel will have the same dates selected as in the copied calendar.

D is short for Delete. This option will display the Delete Calendar panel for the selected calendar. This panel is described in Subsection 5.3.6.

M is short for Modify. This option will display the Modify Calendar panel for the selected calendar. This panel is described in Subsection 5.3.5.

S is short for Select or diSplay. This option will display the Display Calendar panel for the selected calendar. This panel is described in Subsection 5.3.7.

J is short for Job Requests. This option will display the List Job Requests for Calendar panel for the selected calendar. This panel is described in Subsection 5.3.8.

You can exit this panel and return to the PJS Calendar Menu panel by pressing PF3.

The following fields are displayed for each calendar:

Calendar-ID is the calendar-ID for the calendar. For more information please refer to Section 3.3.

Next Date is the next date selected on the calendar. The format of this information field is mm/dd/yyyy. If this field is blank, either no dates are selected, so the calendar is empty; or the last selected date on the calendar has passed.

5.3.3 Add Calendar ID Panel

Use the Add Calendar ID Panel to specify a calendar‑ID for a new calendar:

yy/mm/dd hh:mm ----- PJS(tm) - ADD CALENDAR ID ------------------------------ COMMAND ===> __________________________________________________________________ New Calendar-ID: Owner-ID ===> xxxxxxxx Calendar Name ===> xxxxxxxx Enter New Calendar-ID, then press ENTER. Commands ==> CANCEL - Cancel Add

You can enter this panel from the List Calendars panel.

The following data entry fields are available:

Owner‑ID specifies who "owns" the calendar you are adding or copying. For more information on how to specify an owner‑ID, please refer to Section 3.1.

Calendar Name is the name of the calendar. For more information on how to specify this value, please refer to Section 3.3.

The following commands can be entered on the COMMAND line:

CANCEL cancels the add for the calendar. Use this command if you decide not to create the PJS calendar. PJS will return to the List Calendars panel.

5.3.4 Add Calendar Panel

Use the Add Calendar Panel to create a PJS calendar:

yy/mm/dd hh:mm ----- PJS(tm) - ADD CALENDAR --------------------------------- COMMAND ===> __________________________________________________________________ Calendar-ID ===> xxxxxxxx.xxxxxxxx Month xxxxxxxxx Year yyyy Sun Mon Tue Wed Thu Fri Sat x 01 x 02 x 03 x 04 x 05 x 06 x 07 x 08 x 09 x 10 x 11 x 12 x 13 x 14 x 15 x 16 x 17 x 18 x 19 x 20 x 21 x 22 x 23 x 24 x 25 x 26 x 27 x 28 x 29 x 30 x 31 Enter the 3-letter month and year above to select month, or Enter scroll commands (or use PF keys) to select next/previous month Enter a non-blank character before each date to be selected Enter a Space before each date to be excluded Commands ==> REQ - Display Job Requests for Calendar, END - Complete Add, CANCEL - Cancel Add

You can enter this panel from the Calendar Menu panel, or the List Calendars panel through the Add Calendar ID panel.

The following informational fields are displayed:

Calendar‑ID is the Calendar-ID for the calendar to be added. For more information please refer to Section 3.3.

The calendar area of this panel shows the calendar, one month at a time, in the typical calendar format. The month to be displayed can be selected by either typing the month and year to be displayed into the provided input fields, or by “scrolling” through the calendar using the normal ISPF scroll commands (or PF keys.) To scroll to an earlier month, use the UP command (or PF7). To scroll to a later month use the DOWN command (or PF8).

The following data entry fields are available:

Month is the name of the month to be displayed in the calendar area. Only the first three characters entered are checked. Use the following three‑letter values:

JAN APR JUL OCT

FEB MAY AUG NOV

MAR JUN SEP DEC

Year is the year. You can enter a value that ranges from the current year through 2099.

Dates are dates selected by the calendar. To select a date, place any non‑blank character, in the input field that precedes the date. If you want to deselect a date, overtype the character with a space. When PJS displays the selected dates, it will use an asterisk (‘*’) and highlight the date.

The following commands can be entered on the COMMAND line:

REQ displays the Job Requests for Calendar panel. This panel will display all of the job requests that specify this calendar. However, since you are adding the calendar, there will likely be no job requests to list. For more information on the Job Requests for Calendar panel, please refer to Subsection 5.3.8.

END completes that add and exits the panel after processing the values you entered. Use this command to create the PJS calendar. You can also press the PF3 key to perform this function.

CANCEL exits the panel and returns to the Calendar Menu panel or the List Calendars panel without performing any processing. Use this command if you decide not to add the calendar.

5.3.5 Modify Calendar Panel

Use the Modify Calendar Panel to modify an existing PJS calendar:

yy/mm/dd hh:mm ----- PJS(tm) - MODIFY CALENDAR ------------------------------ COMMAND ===> __________________________________________________________________ Calendar-ID ===> xxxxxxxx.xxxxxxxx Month xxxxxxxxx Year yyyy Sun Mon Tue Wed Thu Fri Sat x 01 x 02 x 03 x 04 x 05 x 06 x 07 x 08 x 09 x 10 x 11 x 12 x 13 x 14 x 15 x 16 x 17 x 18 x 19 x 20 x 21 x 22 x 23 x 24 x 25 x 26 x 27 x 28 x 29 x 30 x 31 Enter the 3-letter month and year above to select month, or Enter scroll commands (or use PF keys) to select next/previous month Enter a non-blank character before each date to be selected Enter a Space before each date to be excluded Commands ==> REQ - Display Job Requests for Calendar END - Complete Modify, CANCEL - Cancel Modify

You can enter this panel from the Calendar Menu panel, or the List Calendars panel.

The following informational fields are displayed:

Calendar‑ID is the Calendar-ID for the calendar to be modified. For more information please refer to Section 3.3.

The calendar area of this panel shows the calendar, one month at a time, in the typical calendar format. The month to be displayed can be selected by either typing the month and year to be displayed into the provided input fields, or by “scrolling” through the calendar using the normal ISPF scroll commands (or PF keys.) To scroll to an earlier month, use the UP command (or PF7). To scroll to a later month use the DOWN command (or PF8).

The following data entry fields are available:

Month is the name of the month to be displayed in the calendar area. Only the first three characters entered are checked. Use the following three‑letter values:

JAN APR JUL OCT

FEB MAY AUG NOV

MAR JUN SEP DEC

Year is the year. You can enter a value that ranges from the current year through 2099.

Dates are dates selected by the calendar. To select a date, place any non‑blank character, in the input field that precedes the date. If you want to deselect a date, overtype the character with a space. When PJS displays the selected dates, it will use an asterisk (‘*’) and highlight the date.

The following commands can be entered on the COMMAND line:

REQ displays the Job Requests for Calendar panel. This panel will display all of the job requests that specify this calendar. For more information on the Job Requests for Calendar panel, please refer to Subsection 5.3.8.

END completes that modify and exits the panel after processing the values you entered. You can also press the PF3 key to perform this function.

CANCEL exits the panel and returns to the Calendar Menu panel or the List Calendars panel without performing any processing. Use this command if you decide not to modify the calendar.

5.3.6 Delete Calendar Panel

Use the Delete Calendar Panel to delete an existing PJS calendar:

yy/mm/dd hh:mm ----- PJS(tm) - DELETE CALENDAR ------------------------------ COMMAND ===> __________________________________________________________________ Calendar-ID ===> xxxxxxxx.xxxxxxxx Month xxxxxxxxx Year yyyy Sun Mon Tue Wed Thu Fri Sat * 01 02 03 * 04 05 * 06 07 08 * 09 10 11 * 12 * 13 14 15 * 16 * 17 18 19 20 * 21 * 22 23 24 * 25 * 26 27 28 29 * 30 * 31 Enter the 3-letter month and year above to select month, or Enter scroll commands (or use PF keys) to select next/previous month Enter 'YES' and press enter to confirm delete ===> xxx Commands ==> REQ - Display Job Requests for Calendar, END - Complete Delete, CANCEL - Cancel Delete

You can enter this panel from the Calendar Menu panel, or the List Calendars panel.

The following informational fields are displayed:

Calendar‑ID is the Calendar-ID for the calendar to be deleted. For more information please refer to Section 3.3.

The calendar area of this panel shows the calendar, one month at a time, in the typical calendar format. The month to be displayed can be selected by either typing the month and year to be displayed into the provided input fields, or by “scrolling” through the calendar using the normal ISPF scroll commands (or PF keys.) To scroll to an earlier month, use the UP command (or PF7). To scroll to a later month use the DOWN command (or PF8).

The dates selected by the calendar are indicated by an asterisk (‘*’) preceding the date, and the date is highlighted.

The following data entry fields are available:

Month is the name of the month to be displayed in the calendar area. Only the first three characters entered are checked. Use the following three‑letter values:

JAN APR JUL OCT

FEB MAY AUG NOV

MAR JUN SEP DEC

Year is the year. You can enter a value that ranges from the current year through 2099.

Enter 'YES'... is the delete confirmation field. You must enter YES in this field, then press the ENTER key, then enter the END command (or press PF3), to complete the delete.

If you decide not to delete the calendar, enter the CANCEL command.

The following commands can be entered on the COMMAND line:

REQ displays the Job Requests for Calendar panel. This panel will display all of the job requests that specify this calendar. For more information on the Job Requests for Calendar panel, please refer to Subsection 5.3.8.

END completes that delete and returns to the Calendar Menu panel or the List Calendars panel. You must enter ‘YES’ in the delete confirmation field. You can also press the PF3 key to perform this function.

CANCEL exits the panel and returns to the Calendar Menu panel or the List Calendars panel without performing any processing. Use this command if you decide not to delete the calendar.

5.3.7 Display Calendar Panel

Use the Display Calendar Panel to display one PJS calendar:

yy/mm/dd hh:mm ----- PJS(tm) - DISPLAY CALENDAR ----------------------------- COMMAND ===> __________________________________________________________________ Calendar-ID ===> xxxxxxxx.xxxxxxxx Month xxxxxxxxx Year yyyy Sun Mon Tue Wed Thu Fri Sat * 01 02 03 * 04 05 * 06 07 08 * 09 10 11 * 12 * 13 14 15 * 16 * 17 18 19 20 * 21 * 22 23 24 * 25 * 26 27 28 29 * 30 * 31 Enter the 3-letter month and year above to select month, or Enter scroll commands (or use PF keys) to select next/previous month Commands ==> REQ - Display Job Requests for Calendar

You can enter this panel from the Calendar Menu panel, or the List Calendars panel.

The following informational fields are displayed:

Calendar‑ID is the Calendar-ID for the calendar to be deleted. For more information please refer to Section 3.3.

The calendar area of this panel shows the calendar, one month at a time, in the typical calendar format. The month to be displayed can be selected by either typing the month and year to be displayed into the provided input fields, or by “scrolling” through the calendar using the normal ISPF scroll commands (or PF keys.) To scroll to an earlier month, use the UP command (or PF7). To scroll to a later month use the DOWN command (or PF8).

The dates selected by the calendar are indicated by an asterisk (‘*’) preceding the date, and the date is highlighted.

The following data entry fields are available:

Month is the name of the month to be displayed in the calendar area. Only the first three characters entered are checked. Use the following three‑letter values:

JAN APR JUL OCT

FEB MAY AUG NOV

MAR JUN SEP DEC

Year is the year. You can enter a value that ranges from the current year through 2099.

The following commands can be entered on the COMMAND line:

REQ displays the Job Requests for Calendar panel. This panel will display all of the job requests that specify this calendar. For more information on the Job Requests for Calendar panel, please refer to Subsection 5.3.8.

END returns to the Calendar Menu panel or the List Calendars panel. You can also press the PF3 key to perform this function.

5.3.8 Job Requests for Calendar Panel

Use the Job Requests for Calendar Panel to display job requests with the calendar specified:

yy/mm/dd hh:mm --- PJS(tm) - JOB REQUESTS FOR CALENDAR --- LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx Request-ID Status Next Date/Time Frequency Events Member xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm nnn YR NONE xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm SU,MO,TU,WE,TH,FR,SA nn OF nn xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm EOM-nn POSTED xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm CAL-xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxxx . . . . . . . . . . . . . . . . . . . . . . . .

yy/mm/dd hh:mm --- PJS(tm) - JOB REQUESTS FOR CALENDAR --- LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx Request-ID Member JCL Data Set Name Instdata xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx . . . . . . . . . . . . . . . . . . . . . . . . . . .

You can enter this panel from the List Calendars panel, Add Calendar panel, Display Calendar panel, Modify Calendar panel, or Delete Calendar panel.

This panel can be scrolled up and down to display more job requests. Use PF7 and PF8 keys to scroll the data up and down. On an 80‑column display, part of the panel extends beyond the right border. Use the PF10 and PF11 keys to scroll the data left and right. As you scroll the Request‑ID field keeps its position:

You can exit this panel by pressing PF3.

The following fields are displayed for each job request:

Request‑ID is the unique ID for the job request. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

Next Date/Time is the date and time on which PJS is to submit the job. The format of this information field is mm/dd/yyyy hh:mm.

Frequency is how often PJS is to submit the job request. Valid values are:

ONCE means the job is submitted one time.

nnn MINUTES means the job is to be submitted every nnn minutes.

nnn HOURS means the job is to be submitted every nnn hours.

nnn DAYS means the job is to be submitted every nnn days.

nnn WEEKS means the job is to be submitted every nnn weeks.

nn MONTHS means the job is to be submitted every nn months.

nn YEARS means the job is to be submitted every nn years.

day[, day]... means the job is to be submitted the displayed weekdays. Valid values for day are:

SU Sunday.

MO Monday.

TU Tuesday.

WE Wednesday.

TH Thursday.

FR Friday.

SA Saturday.

EOM‑nn means the job is to be submitted nn days before the end of each month.

CAL‑calendar‑ID means that the indicated PJS calendar was specified for the job request.

CAL‑MULTI means that multiple calendars were specified. Up to three calendars can be specified. The job request must be displayed individually to see all of the specified calendars.

Events tells you how many job request events are posted. Valid values are:

NONE means no events were specified for the job request.

pe OF ne means that some, but not all, of the job request events are posted. The number of posted events is displayed against the total number of events:

pe is the number of posted events.

ne is the total number of events.

POSTED means that all job request events are posted.

Member is the name of the member that contains the job.

JCL Data Set Name is the name of the JCL data set.

Instdata is short for Installation Data. This information field can be used to display site‑specific data. For example, the PJS Installation Data Format Exit can use this field to display site‑specific information.

5.4 PJS Event Panel System

The following diagram provides an overview of the PJS event panel system:

Figure 5. The PJS Event ISPF Panels

The Event Menu Panel is the gateway to the PJS event panel system. From here, you can list, post, reset, or display events. This panel is discussed in Subsection 5.4.1.

The List Events Panel lists events. You can also post, reset, or display events. Additionally, you can display a list of which job requests have specified a given event. If you plan to work with more than one event during a session, it's a good idea to use this panel. The List Events Panel is discussed in Subsection 5.4.2.

The Post Event Panel enables you to post an event. Before you can use this panel, an event must be specified in at least one job request. When an event is posted, the event dependency is satisfied in every job request in which the event is specified. If you have an event specified in more than one job request, but want to post the event in one job request, you can use the Specify Job Request Events Panel, which is discussed in Subsection 5.2.6. If, however, you plan to post an event in every job request that specifies the event, use this panel. The Post Event Panel is discussed in Subsection 5.4.3.

The Reset Event Panel enables you to reset an event. Before you can use this panel, an event must be specified in at least one job request. When an event is reset, event posting is removed, so the job request event in every relevant job request must be posted before PJS can submit the job for execution. Events are automatically reset after job submission. If you have an event specified in more than one job request, but want to reset the event in one job request, you can use the Specify Job Request Events Panel, which is discussed in Subsection 5.2.6. If, however, you plan to reset an event in every job request that specifies the event, use this panel. The Reset Event Panel is discussed in Subsection 5.4.4.

The Display Event Panel displays the status of one PJS event. This panel is discussed in Subsection 5.4.5.

The Job Requests for Event Panel displays the job requests in which a given event was specified. This panel is discussed in Subsection 5.4.6.

5.4.1 Event Menu Panel

Use the Calendar Menu Panel as a gateway to the PJS calendar panel system:

yy/mm/dd hh:mm ----- PJS(tm) - EVENT MENU ----------------------------------- OPTION ===> ___________________________________________________________________ Select one of the following functions: L LIST - List all Events for Owner-ID P POST - Post an Event R RESET - Reset an Event S DISPLAY - Display an Event Event-ID: Owner-ID ===> xxxxxxxx Event Name ===> xxxxxxxx (Required for options A, D, M, and S) Enter Event-ID (if required) and make a selection, then press ENTER.

You can enter this panel from the PJS Main Menu Panel.

The following menu options can be selected by typing the appropriate letter on the OPTIONS command line:

L is short for List. This option will display the List Events panel. This panel is described in Subsection 5.4.2. When using this option the PJS owner-ID to be listed should be entered in the Owner-ID input field.

P is short for Post. This option will display the Post Event panel. This panel is described in Subsection 5.4.3. When using this option the PJS event-ID for the event to be posted should be entered in the Owner-ID and Event Name input fields.

R is short for Reset. This option will display the Reset Event panel. This panel is described in Subsection 5.4.4. When using this option the PJS event-ID for the event to be reset should be entered in the Owner-ID and Event Name input fields.

S is short for Select or diSplay. This option will display the Display Event panel. This panel is described in Subsection 5.4.5. When using this option the PJS event-ID for the event to be displayed should be entered in the Owner-ID and Event Name input fields.

You can exit this panel and return to the PJS Main Menu panel by pressing PF3.

The following input fields are available:

Owner‑ID specifies who "owns" the event you are posting, resetting, listing, or displaying. You must be authorized to access events for an owner-ID other than your own. For more information on the owner‑ID specification, please refer to Section 3.1.

Event Name is the name of the event. If you plan to post, reset, or display an event, you must enter a value in this input field. For more information on this specification, please refer to Section 3.4.

5.4.2 List Events Panel

Use the List Events Panel to display a set of events for a specified owner‑ID:

yy/mm/dd hh:mm ----- PJS(tm) - LIST EVENTS --------------- LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx ^ELSTAREA ^ S Event-ID Last Post Date/Time Status _ xxxxxxxx.xxxxxxxx mm/dd/yyyy hh:mm:ss POST PENDING _ xxxxxxxx.xxxxxxxx mm/dd/yyyy hh:mm:ss RESET PENDING _ xxxxxxxx.xxxxxxxx mm/dd/yyyy hh:mm:ss xxxxxxxxxxxxx _ xxxxxxxx.xxxxxxxx mm/dd/yyyy hh:mm:ss xxxxxxxxxxxxx . . . . . . . . . . . . . . . . . . Line Commands ==> P - Post Event, R - Reset Event, S - Display Event J - List Job Requests for Event

You can enter this panel from the Event Menu Panel.

This panel can be scrolled up and down to display more events. Use PF7 and PF8 keys to scroll the data up and down.

The following line commands can be selected by typing the appropriate letter in the S field for one of the displayed events:

P is short for Post. This option will display the Post Event panel for the selected event. This panel is described in Subsection 5.4.3.

R is short for Reset. This option will display the Reset Event panel for the selected event. This panel is described in Subsection 5.4.4.

S is short for Select or diSplay. This option will display the Display Event panel for the selected event. This panel is described in Subsection 5.4.5.

J is short for Job Requests. This option will display the List Job Requests for Event panel for the selected event. This panel is described in Subsection 5.4.6.

You can exit this panel and return to the PJS Event Menu panel by pressing PF3.

The following fields are displayed for each event:

Event-ID is the event-ID for the event. For more information please refer to Section 3.4.

Last Post Date/Time is the date and time PJS last posted the event. The format of this information field is mm/dd/yyyy hh:mm:ss. If the event has never been posted, this field is blank.

Status describes the current status of the event. Valid values are:

POST PENDING means that a command to post the event has been received. PJS will wait until the current scan interval elapses, then post the job request events.

RESET PENDING means that a command to reset the event has been received. PJS will wait until the current scan interval elapses, then reset the job request events.

Because PJS usually processes post and reset requests quickly, this field will usually be blank. For more information on how PJS processes events, refer to Section 2.5

5.4.3 Post Event Panel

Use the Post Event Panel to post an event in every relevant job request:

yy/mm/dd hh:mm ----- PJS(tm) - POST EVENT ----------------------------------- COMMAND ===> __________________________________________________________________ Event-ID ===> xxxxxxxx.xxxxxxxx Event Status ===> xxxxxxxxxxxxx Date/Time Posted ===> mm/dd/yyyy hh:mm:ss Enter 'YES' and press enter to confirm post ===> xxx Commands ==> REQ - Display Job Requests for Event, END - Complete Post, CANCEL - Cancel Post

You can enter this panel from the Event Menu panel, or the List Events panel.

The following informational fields are displayed:

Event‑ID is the Event-ID for the event to be posted. For more information please refer to Section 3.4.

Date/Time Posted is the date and time PJS last posted the event. The format of this information field is mm/dd/yyyy hh:mm:ss. If the event has never been posted, this field is blank.

Status describes the current status of the event. Valid values are:

POST PENDING means that a command to post the event has been received. PJS will wait until the current scan interval elapses, then post the job request events.

RESET PENDING means that a command to reset the event has been received. PJS will wait until the current scan interval elapses, then reset the job request events.

Because PJS usually processes post and reset requests quickly, this field will usually be blank. For more information on how PJS processes events, refer to Section 2.5

The following data entry field is available:

Enter 'YES'... is the post confirmation field. You must enter YES in this field, then press the ENTER key, then enter the END command (or press PF3), to complete the post.

If you decide not to post the event, enter the CANCEL command.

The following commands can be entered on the COMMAND line:

REQ displays the Job Requests for Event panel. This panel will display all of the job requests that specify this event. For more information on the Job Requests for Event panel, please refer to Subsection 5.4.6.

END completes that post and returns to the Event Menu panel or the List Events panel. You must enter ‘YES’ in the post confirmation field. You can also press the PF3 key to perform this function.

CANCEL exits the panel and returns to the Event Menu panel or the List Events panel without performing any processing. Use this command if you decide not to post the event.

5.4.4 Reset Event Panel

Use the Reset Event Panel to reset an event in every relevant job request:

yy/mm/dd hh:mm ----- PJS(tm) - RESET EVENT ---------------------------------- COMMAND ===> __________________________________________________________________ Event-ID ===> xxxxxxxx.xxxxxxxx Event Status ===> xxxxxxxxxxxxx Date/Time Posted ===> mm/dd/yyyy hh:mm:ss Enter 'YES' and press enter to confirm reset ===> xxx Commands ==> REQ - Display Job Requests for Event, END - Complete Reset, CANCEL - Cancel Reset

You can enter this panel from the Event Menu panel, or the List Events panel.

The following informational fields are displayed:

Event‑ID is the Event-ID for the event to be reset. For more information please refer to Section 3.4.

Date/Time Posted is the date and time PJS last posted the event. The format of this information field is mm/dd/yyyy hh:mm:ss. If the event has never been posted, this field is blank.

Status describes the current status of the event. Valid values are:

POST PENDING means that a command to post the event has been received. PJS will wait until the current scan interval elapses, then post the job request events.

RESET PENDING means that a command to reset the event has been received. PJS will wait until the current scan interval elapses, then reset the job request events.

Because PJS usually processes post and reset requests quickly, this field will usually be blank. For more information on how PJS processes events, refer to Section 2.5

The following data entry field is available:

Enter 'YES'... is the reset confirmation field. You must enter YES in this field, then press the ENTER key, then enter the END command (or press PF3), to complete the reset.

If you decide not to reset the event, enter the CANCEL command.

The following commands can be entered on the COMMAND line:

REQ displays the Job Requests for Event panel. This panel will display all of the job requests that specify this event. For more information on the Job Requests for Event panel, please refer to Subsection 5.4.6.

END completes that reset and returns to the Event Menu panel or the List Events panel. You must enter ‘YES’ in the reset confirmation field. You can also press the PF3 key to perform this function.

CANCEL exits the panel and returns to the Event Menu panel or the List Events panel without performing any processing. Use this command if you decide not to reset the event.

5.4.5 Display Event Panel

Use the Display Event Panel to display characteristics of one event:

yy/mm/dd hh:mm ----- PJS(tm) - DISPLAY EVENT -------------------------------- COMMAND ===> __________________________________________________________________ Event-ID ===> xxxxxxxx.xxxxxxxx Event Status ===> xxxxxxxxxxxxx Date/Time Posted ===> mm/dd/yyyy hh:mm:ss Commands ==> REQ - Display Job Requests for Event

You can enter this panel from the Event Menu panel, or the List Events panel.

The following informational fields are displayed:

Event‑ID is the Event-ID for the event. For more information please refer to Section 3.4.

Date/Time Posted is the date and time PJS last posted the event. The format of this information field is mm/dd/yyyy hh:mm:ss. If the event has never been posted, this field is blank.

Status describes the current status of the event. Valid values are:

POST PENDING means that a command to post the event has been received. PJS will wait until the current scan interval elapses, then post the job request events.

RESET PENDING means that a command to reset the event has been received. PJS will wait until the current scan interval elapses, then reset the job request events.

Because PJS usually processes post and reset requests quickly, this field will usually be blank. For more information on how PJS processes events, refer to Section 2.5

The following commands can be entered on the COMMAND line:

REQ displays the Job Requests for Event panel. This panel will display all of the job requests that specify this event. For more information on the Job Requests for Event panel, please refer to Subsection 5.4.6.

END returns to the Event Menu panel or the List Events panel. You can also press the PF3 key to perform this function.

5.4.6 Job Requests for Event Panel

Use the Job Requests for Event Panel to display job requests with the event specified:

yy/mm/dd hh:mm ----- PJS(tm) - JOB REQUESTS FOR EVENT ---- LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx Request-ID Status Next Date/Time Frequency Events Member xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm nnn YR NONE xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm SU,MO,TU,WE,TH,FR,SA nn OF nn xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm EOM-nn POSTED xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm CAL-xxxxxxxx.xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx.nnn xxxxxxxx mm/dd/yyyy hh:mm xxxxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxxx . . . . . . . . . . . . . . . . . . . . . . . .

yy/mm/dd hh:mm ----- PJS(tm) - JOB REQUESTS FOR EVENT ---- LINE nnnn OF nnnn COMMAND ===> ________________________________________________ SCROLL ===> xxxx S Request-ID Member JCL Data Set Name Instdata _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx _ xxxxxxxx.nnn xxxxxxxx xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx.xxxxxxxx xxxxxxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

You can enter this panel from the List Events Panel, Post Event Panel, Display Event Panel, or Reset Event Panel.

This panel can be scrolled up and down to display more job requests. Use PF7 and PF8 keys to scroll the data up and down. On an 80‑column display, part of the panel extends beyond the right border. Use the PF10 and PF11 keys to scroll the data left and right. As you scroll the Request‑ID field keeps its position:

You can exit this panel by pressing PF3.

The following fields are displayed for each job request:

Request‑ID is the unique ID for the job request. For more information please refer to Section 3.2.

Status is the status of the job request. For more information please refer to Section 3.7.

Next Date/Time is the date and time on which PJS is to submit the job. The format of this information field is mm/dd/yyyy hh:mm.

Frequency is how often PJS is to submit the job request. Valid values are:

ONCE means the job is submitted one time.

nnn MINUTES means the job is to be submitted every nnn minutes.

nnn HOURS means the job is to be submitted every nnn hours.

nnn DAYS means the job is to be submitted every nnn days.

nnn WEEKS means the job is to be submitted every nnn weeks.

nn MONTHS means the job is to be submitted every nn months.

nn YEARS means the job is to be submitted every nn years.

day[, day]... means the job is to be submitted the displayed weekdays. Valid values for day are:

SU Sunday.

MO Monday.

TU Tuesday.

WE Wednesday.

TH Thursday.

FR Friday.

SA Saturday.

EOM‑nn means the job is to be submitted nn days before the end of each month.

CAL‑calendar‑ID means that the indicated PJS calendar was specified for the job request.

CAL‑MULTI means that multiple calendars were specified. Up to three calendars can be specified. The job request must be displayed individually to see all of the specified calendars.

Events tells you how many job request events are posted. Valid values are:

NONE means no events were specified for the job request.

pe OF ne means that some, but not all, of the job request events are posted. The number of posted events is displayed against the total number of events:

pe is the number of posted events.

ne is the total number of events.

POSTED means that all job request events are posted.

Member is the name of the member that contains the job.

JCL Data Set Name is the name of the JCL data set.

Instdata is short for Installation Data. This information field can be used to display site‑specific data. For example, the PJS Installation Data Format Exit can use this field to display site‑specific information.

Prev | Table of Contents | Next

Copyright © Northrop Grumman, 1990, 2004. All rights reserved.