Input to batch command interface

It is a PIF application. Note that dates provided in the INPUT must be in real format. If the PIFCWB and PIFHD parameters of the INTFOPTS initialization statement of the Z controller do not follow this rule, the EQQYPARM DD card invoking the BCIT must point to a member where INIT specifies the following:

CWBASE (00)
HIGHDATE (711231)

When the Batch Command Interface is called, it invokes PGM=EQQYCAIN, with an optional PARM field (the sample member EQQYCBAT contains an example of how this program can be invoked). The positional parameters that can be passed with the PARM field are as follows:

Table 1. Positional parameters that can be passed with the Batch Command Interface
Description	Maximum length	Default	Values
SUBSYSTEM NAME	4	OPCA	product name
WTO desired	6	MSGON	MSGOFF, MSGNONE
IA date	6	current date	CPSTDA/ yymmdd
IA time	4	current time	hhmm
CP needed	6	MUSTCP	MISSCP

EXAMPLES:

PARM=’OPGQ, MSGOFF, CPSTDA, 1400’

PARM=’OPGQ,,991207’

PARM=’OPGQ,,,,MISSCP’

The meaning of the keywords is the following:

CPSTDA: Means that the default IA date is the starting date of the CP.
MISSCP: Means that the requested BCIT functions do not require the existence of a CP and that BCIT should not try to access it.
MSGNONE: Means that WTOs (including those issued in case of errors or for commands that do not have performance impacts) are not to be issued any longer.
MSGOFF: Means that WTOs (except those issued in case of errors or for commands that do not have performance impacts) are not to be issued any longer.
MSGON: Means that WTOs are to be issued in any case. It is strongly recommended not to use the default MSGON when the BCIT commands invoked might produce too many WTOs.
MUSTCP: Requests that BCIT accesses the CP, no matter if the requested functions need the existence of CP.

A set of actions, called a program, is specified in a file SYSIN referenced by the DD card: //SYSIN DD. If the SYSIN DD card refers to a DASD file, ensure that the file is defined with RECFM=FB and LRECL=80.

A program with instructions is input for this sample.

An instruction is an action on a resource with any arguments to identify it and other arguments to process it.

An argument has two parts; the right part is its identification and the left part is its value. These two parts are separated by the equal sign (=). An argument is finished by a comma (,) or semicolon (;) if this argument is the last of the instruction, and by a period if it is the last of the program. The blanks before the identifier are ignored but the blanks after the identifier are used. A blank is a character, not a delimiter, if it is before an argument or a value.

An instruction must be finished by a semicolon(;). Only the last instruction of the program is finished by a period (.). A program must be finished by a period (.).

The descriptive fields, such as DESC and EXTNAME, can include special characters only if the field is inserted within single quotation marks. For example,

  DESC='XXXX.AAAAA,BBBBB;'

Note: If you need to use delimiters, such as single quotation marks, in descriptive fields follow these rules:

To use the single quotation mark within a field, you must use two quotation marks.
To use the single quotation mark at the beginning or at the end of a field, you must use three quotation marks.

Example of program:

ACTION=OPTIONS,BL=N,LTP=N;
ACTION=LIST,RESOURCE=ADCOM,ADID=description,IA=9202121500;
ACTION=LIST,RESOURCE=ADCOM,ADID=A%%%B*,IA= 9202121500,
    PRIORITY=5;
ACTION=SELECT,
       RESOURCE=OICOM,
       ADID=ADABASE;
ACTION=OPTIONS,BL=Y;
ACTION=LIST,RESOURCE=LTOCCOM,
       ADID=ADABASE;
ACTION=COPY,RESOURCE=AD,ADID=ADABASE,STATUS=A,VALTO=991231,
 NADID=MATENCIOP,NSTATUS=P;
ACTION=INSERT,RESOURCE=LTPRE,ADID=MATENCIOP,IAD=920215,IAT=0915,
    PREADID=ADABASEOP,PREIAD=920215,PREIAT=0915;
ACTION=LIST,RESOURCE=LTOCCOM,ADID=MATENCIOP;
ACTION=INSERT,RESOURCE=LTOC,ADID=MATENCIOP,IAD=920215,IAT=0915,
    DEADLINE=9202150916;
ACTION=DELETE,RESOURCE=CPPRE,ADID=MATENCIOP,IA=9202062343,OPNO=30,
    PREADID=ADABASE,PREOPNO=10,PREIA=9201310700;
ACTION=LIST,RESOURCE=CPOPCOM,ADID=MATENCIOP,OPNO=30;
ACTION=MODIFY,RESOURCE=CPOP,ADID=MATENCIOP,IA=9202062343,OPNO=30,
  JOBNAME=MATENCIO,DESC='TEST MODIFY CPOP',EDUR=0100,PSUSE=1,R1USE=1,
  R2USE=1,JCLASS=B,OPIA=9202062344,OPDL=9202062345,WSNAME=WSTC,
  STATUS=A;
ACTION=MODIFY,RESOURCE=CPEXT,ADID=MATENCIOP,IA=9202062343,OPNO=30,
  EXTNAME='Operation Extended Name';
ACTION=MODIFY,RESOURCE=CPOC,ADID=MATENCIOP,IA=9202062300,
    IANEW=9202062343,DEADLINE=9202062345;
ACTION=INSERT,RESOURCE=CPPRE,ADID=MATENCIOP,IA=9202042342,OPNO=25,
    PREADID=ADABASE,PREOPNO=10,PREIA=9201310700;
ACTION=DELETE,RESOURCE=LTOC,ADID=MATENCIOP,IAD=920129,IAT=0700;
ACTION=IMPORT,RESOURCE=AD,ADID=MATENCIOP;
ACTION=INSERT,RESOURCE=AD,ADID=MATENCIOP;
ACTION=DELETE,RESOURCE=AD,ADID=MATENCIOP;
ACTION=SELECT,RESOURCE=AD,ADID=MATENCIOP;
ACTION=COPY,RESOURCE=OI,ADID=ADABASE,OPNO=10,
 NADID=MATENCIOP,NOPNO=10;
ACTION=INSERT,RESOURCE=CPOC,ADID=MATENCIOP,IA=9201291500;
ACTION=INSERT,RESOURCE=CPSR,ADID=MATENCIOP,IA=9201291500,RESNAME=name,
   RESUSAGE=X,OPNO=10,QUANTITY=1;
ACTION=INSERT,RESOURCE=CPOP,ADID=MATENCIOP,IA=9202042342,OPNO=25,
JOBNAME=MATENCIO,WSNAME=FTW1,EXTNAME='Operation Extended Name'.

DD CARD EQQMLIB contains the scheduler messages.

Note: In the above example, for simplicity many commands are included in the same SYSIN, but this is not a recommended practice. Because BCIT processes all the statements contained in the SYSIN and does not stop processing if any statement fails (unless ERROR=Y is specified in the OPTIONS card), it is recommended to avoid inserting commands which should not be run in case of failure in one of the previous commands, or to specify ERROR=Y in the OPTIONS card.