Input

Batch Interface › Batch Move Request Processing › Input

Input

The input to this job consists of a user-defined batch input file. This file is a variable length spanned sequential data set with a record length of 20000. This file is typically created by a user-written program. Copybook APCCIREQ, documented in Appendix C describes the input record layout. Validation is performed in CA‑PanAPT as it is by the corresponding ISPF function. If an error is detected, the Move Request is not updated, and error messages are sent to the output file.

APJJ5970 below is sample JCL that executes program APCS5970:

//APJJ5970 JOB (),'BATCH UPDATE',
 //			TYPRUN=HOLD,
 //			CLASS=P,
 //			MSGCLASS=J
//*
//JOBLIB  DD  DSN=<SPFX>,LOADLIB,DISP=SHR
//*
//*
//APJP5970 EXEC APJP5970,
 //             VSAMPFX='<VPFX>',    <====  VSAM data set prefix
//             SOFTPFX='<SPFX>',    <====  APTMODEL prefix
//             APTIN='<SYSIN>',     <====  Input data set name
//             APTOUT='<SYSOUT>'    <====  Output data set name

Note: The data set names (APTIN='<SYSIN>') and (APTOUT='<SYSOUT>') must be overridden in APJJ5970.

The value specified in the APCSIREQ-PROCESS field determines what type of request is run against the Move Request. The table shown next documents required values:

Request Type	APCSIREQ-PROCESS value
Add	'A'
Change	'G'
Copy	'O'
Delete	'X'
Close	'C'
Verify	'V'
Run verification procedure	'R'

Note: All other APCSIREQ-PROCESS functions are for CA internal processing only. If you try to use them for batch functions, unpredictable results occur.

The fields in the following table must be modified as indicated in APCSIREQ:

Field	Request Type	Value
APCSIREQ-PROCESS	all	'A', 'G', 'O', 'X', 'C', 'V' or 'R'
APCSIREQ-RECORD-LEN	all	The length of the record.
APCSIREQ-RECORD-TYPE	all	'00'
APCSIREQ-USER-ID	all	8 bytes
APCSIREQ-VERSION-STAMP	all	03.1
APCSIREQ-BATCH-INPUT	A, G	Y
APCSIREQ-CKOT-JOB1	A, G, O	The Retrieve job card image (at least one is required, maximum allowed is four).
APCSIREQ-CKOT-JOB2	A, G, O	The Retrieve job card image (at least one is required, maximum allowed is four).
APCSIREQ-CKOT-JOB3	A, G, O	The Retrieve job card image (at least one is required, maximum allowed is four).
APCSIREQ-CKOT-JOB4	A, G, O	The Retrieve job card image (at least one is required, maximum allowed is four).
APCSIREQ-NUMBER	G, O, X, C, V	The move request number.
APCSIREQ-VP-NUM	R	Multiples can be selected.
APCSIREQ-VP-JOB1	R	The verification job card (at least one is required, maximum allowed is four).
APCSIREQ-VP-JOB2	R	The verification job card (at least one is required, maximum allowed is four).
APCSIREQ-VP-JOB3	R	The verification job card (at least one is required, maximum allowed is four).
APCSIREQ-VP-JOB4	R	The verification job card (at least one is required, maximum allowed is four).

In addition to the fields documented in the previous two tables for the APCCIREQ copybook, the description record (record type 01) and member data record (record type 02) are required for the add and the change request. See Description Record and Member Data Record under section APCS5960, Add Move Requests to the Pending File.

Valid MR-PROCESS field values of the Member Data Record for the change request are documented in the following table.

Value	Description
'A'	Add the member.
'G'	Change the member
'X'	Delete the member.
'S'	Assign the member.
'K'	Retrieve the member.

For a change request, Retrieve is performed when the auto-Retrieve flag is on. To Retrieve a member, MR-PROCESS of the member data record must be set to 'K'. Assign is performed if the member is not already assigned. Each of the actions in the table above is described in more detail under the topics Entering Member Data for Any Library Codes and Line Command Processing in the "Move Requests" chapter in the CA‑PanAPT Reference Guide.