Setting program options

After you select an existing program option member or enter the command to add a new member, AR/CTL displays the Program Options (ASB) panel.

The program options member contains a list of one or more data set option members (FCBs) that are associated with the program option member. It must include a data set option member for each data set that the application program accesses and for which you want to use AR/CTL data services (such as repositioning at restart).

In addition, if the program option member is meant to replace an IMS PSB for an IMS compatible program, the program option member must contain place holders for the teleprocessing (TP) PCBs and database (DB) PCBs that were in the original PSB. This information is unnecessary if you continue to use an existing PSB with the required PCBs. Do not include a placeholder for the IMS I/O PCB; AR/CTL generates this PCB automatically.

Program Options (ASB) panel

To provide information that defines the application program’s use of data sets and AR/CTL services

1. (Required for IMS compatible programs that do not have an existing IMS PSB; otherwise optional.) In the Program language field, specify the programming language of the application program that will use this program option member. The following values are valid; the default value is COBOL:

   Value	Description
   COBOL	The program is written in COBOL.
   ASM	The program is written in Assembler language.
   PLI	The program is written in PL/I.

2. (Required. Add, delete, or update names in the list of data set option members that are associated with this program option member. ) AR/CTL allows you to select data set option member names from a list of existing members, to insert members by typing their names, or to copy another program option member that contains the associations you want.

   Note

   The data set option members are sorted and stored in the program options member in groups according to data set option member type in the following order: TP (if present), DB (if present), ASAM, and VSAM. Within the ASAM and VSAM group, the data set option members are stored in the order you enter them, with new insertions after old ones.

   Use one of the following commands:

   • To select data set option members from a list, enter this command:

     FCB

     AR/CTL displays the Insert Members from List panel.

   • To insert a new name in the list of data set option members associated with this program option member, enter this command:

     INSert

     AR/CTL displays the Insert Data Set Option Member or Placeholder panel. AR/CTL inserts members at the end of the list of members of the same data set type.

   • To copy the list of data set option members from another program option member to this program option member, enter this command, where member is the name of the member to copy:

     COPY member

   • You cannot change the existing value in the Entry-type field. The following values are valid:

     Value	Description
     VSAM	The data set is a local or remote VSAM data set.
     ASAM	The data set is a sequential data set accessed with the AR/CTL callable interface, GSAM replacement, or dynamic call interception.
     TP	This placeholder is for an IMS teleprocessing (TP) PCB (IMS compatible mode programs only).
     DB	This placeholder is for an IMS database (DB) PCB (IMS compatible mode programs only).
     blank	If the entry type is ASAM, you can change the file usage information (shown in the Usage-option field), the PCB name, or both. Enter U in the Act field to the left of the data set option member name. AR/CTL displays the Set Access type panel (Figure 1). You cannot enter this information for other entry types.

   • To remove a member name from the list of data set option members associated with the program option member, enter R in the Act field to the left of the member name.
3. Required. Use one of the following commands:
   • To save or update the member and return to the List Members panel, enter the END command.
   • To cancel any changes you have made since the last END command and return to the List Members panel, enter the CAN command.