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

ARCPPGMJ           Insert Data Set Option Member or Placeholder                
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

  1. 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).

  2. 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.
  3. 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.
  4. 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).
  5. 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.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*