OISTART

Purpose

Use the OISTART control statement to start the creation of a new operator instruction. The text contained in the OIT statements that follow it will form the new operator instruction.

To identify which AD the operator instruction relates to, supply the ADID keyword. To identify the operation within the AD, also specify at least one of the following:
  • Operation number (OPNO)
  • Job name (JOBN)

You must specify enough of these keywords to uniquely identify the operation. If more than one operation or no operations match your specification, an error message is issued and no OI is created. This also happens if an OI already exists for the same application ID and operation (with a validity time that overlaps the time specified by this request) unless REPLACE is specified on the OPTIONS statement.

If the output is directed to a VSAM data set, the operation can be defined by an ADOP statement occurring later in the input data set. This is because most validity checking occurs after all statements in the input data set are read.

If the output is directed to an active IBM Z Workload Scheduler subsystem, the operation specified must already exist on the AD database. It cannot be defined later in the input data set.

Format


1  OISTART?  ACTION (
2.1! ADD
2.1 SETDEFAULT
1 )  ADID (
2.1 application ID
1 )
1+ .
1  OPNO (
2.1 operation number
1 )
1  JOBN (
2.1 job name
1 )
2?  MEMBER (
3.1 member name
2 )
2?  VALFROMD (
3.1! current date
3.1 yymmdd
2 )
2?  VALFROMT (
3.1! current time
3.1 hhmm
2 )
2?  VALTOD (
3.1! 711231
3.1 yymmdd
2 )
2?  VALTOT (
3.1! 2359
3.1 hhmm
2 )

Restrictions

You cannot use ACTION(SETDEFAULT) to set default values for these keywords:
  • ADID
  • OPNO
  • JOBN
  • MEMBER

Parameters

ACTION (SETDEFAULT | ADD)
If you specify SETDEFAULT, the remaining keyword values that you specify on the OISTART statement become default values for all OISTART statements that follow. No OI is updated. Keywords that you do not specify are assigned their standard defaults.

If you specify ADD or use it by default, the statement can result in an update of the database.

ADID (application ID)
The identifier of the application. If you use DBCS characters, they must be entered as a quoted string started by a shift-out and ended by a shift-in.

You must specify ADID.

JOBN (job name)
The job name of the operation that this OI is for.
MEMBER (member name)
If you specify the MEMBER keyword, the OI text must reside in the partitioned data set (PDS) defined by the EQQOIPDS DD statement. It must be free format in columns 1 to 72. The MEMBER keyword specifies which member in the PDS contains the OI text.
OPNO (operation number)
The operation number of the operation that this OI is for.
VALFROMD (yymmdd | current date)
The start date of validity of this OI. You must specify this in the format yymmdd. See the notes after VALTOT.
VALFROMT (hhmm | current time)
The start time of validity of this OI. You must specify this in the format hhmm. See the notes after VALTOT.
VALTOD (yymmdd | 711231)
The end date of validity of this OI. You must specify this in the format yymmdd. See the notes after VALTOT.
VALTOT (hhmm | 2359)
The end time of validity of this OI. You must specify this in the format hhmm. See the following notes.
Note:
  1. If you do not supply any of these VAL keywords, IBM Z Workload Scheduler assumes that the operator instruction is permanent.
  2. IBM Z Workload Scheduler interprets the yy part as follows:
    YY
    Year
    72 - 99
    1972 - 1999
    00 - 71
    2000 - 2071

Examples

In this example, the OISTART specifies that operator instruction text for operation 020 in the application PAYDAILY will follow this statement: 
OISTART ADID(PAYDAILY) OPNO(020)
OIT …
In this example, the OISTART specifies that operator instruction text for operation 020 in the application PAYDAILY is in the PAYDAILY member of the PDS defined by the EQQOIPDS DD name: 
OISTART ADID(PAYDAILY) OPNO(020) MEMBER(PAYDAILY)