Inserting data set option members or placeholders
When you enter the INSERT command on the Set Program Options panel, AR/CTL displays the Insert Data Set Option Member or Placeholder panel.
Use this panel to insert a data set option member (and associated information, if applicable) in the list of members to associate with the program option member or to insert a placeholder for an IMS TP or DB PCB.
Insert Data Set Option Member or Placeholder panel
Command ===> __________________________________________________________________
ASB Library : PAG.AES.ASBLIB
ASB member : ARCTST02
Type values; press Enter to insert currently displayed Commands: CANcel
information. Enter END or CANcel command when finished.
Data set option member or placeholder type . . . ____ (ASAM,VSAM,TP,DB)
If type is ASAM or VSAM, member name . . . . . . ________
(required for ASAM, VSAM; ignored for TP, DB)
If type is ASAM, ASAM access type . . . . . . . _____ (IN,OUT)
(required for ASAM; ignored for VSAM, TP, DB)
If type is ASAM, PCB name . . . . . . . . . . . ________
(optional for ASAM; ignored for VSAM, TP, DB;
used for IMS-compatible programs only)
To insert data set option member names or placeholders
Type or verify the data set option member file type. The following values are valid:
Value
Description
ASAM
The data set is a sequential data set accessed with the AR/CTL callable interface, GSAM replacement, or dynamic call interception.
VSAM
The data set is a local or remote VSAM data set.
TP
This placeholder is for an IMS TP PCB (IMS compatible mode programs only).
DB
This placeholder is for an IMS DB PCB (IMS compatible mode programs only).
- If the data set option member type is ASAM or VSAM, type or verify the name of the data set option member to insert. You can enter the name of an existing member, a member that has not yet been defined, a member that is in a different data set option library than the specified one, or a member with a blank member type. This field is ignored for types TP and DB.
If the data set option member type is ASAM, you might need to type or verify the ASAM access type. The following values are valid:
Value
Description
IN
The data set will be used for input (PROCOPT=GS).
OUT
The data set will be used for output (PROCOPT=LS).
This field corresponds to the processing option ( PROCOPT ) field in an IMS PCB. This field is not needed in most cases; AR/CTL can determine the processing intent from the data set OPEN request. The PROCOPT is required when you insert a data set option member into a program option member if all of the following conditions are true:
- The program accesses the ASAM data set through GSAM-format calls.
- The program does not use IMS (IMS is not available during execution).
- An IMS PSB containing a GSAM PCB for the data set is not available.
- The program does not issue an explicit OPEN request for the data set.
- If the data set option member type is ASAM and this program option member is for use with an IMS compatible program, you can type or verify the name of the PCB used to refer to the PCB through an application interface block (AIB).
- Press Enter. AR/CTL updates the program option member in storage. You can type over the values in the fields and press Enter again to add another data set option member, or you can enter the END command or CANCEL command. AR/CTL returns to the Program Options (ASB) panel.