Working with non-IMS program registration records

To set up an AR/CTL product to participate in the execution of a non-IMS application program, create one or more non-IMS program registration records in the REGISET. In a non-IMS program, IMS is not active and the program does not use IMS type calls and structures.

To work with non-IMS program registration records

1. Access the Application Enhancement Series primary menu.
2. Type 1 (AES records) in the choice entry field.
3. Press Enter.
   The AR/CTL ISPF interface displays the Application Enhancement Series Records panel.
4. Type or verify the BCSID.
5. Type 3 (Non-IMS program registration) in the choice entry field.
6. Press Enter.
   The AR/CTL ISPF interface displays the Limit List of Records panel.
7. Type or verify the qualifiers for limiting the list of records. 
   You can use specific and wildcard characters as explained in Wildcard-characters-in-record-qualifiers.
8. Press Enter.
   The AR/CTL ISPF interface displays the List Records panel, showing a list of records that match your selection criteria.
9. Perform one of the following actions:
   • Select one or more records to display, update or delete.
   • Enter the ADD command to create a new record.
10. Press Enter:

    • If you entered the ADD command, the AR/CTL ISPF interface displays the Add Record (Non IMS program registration) panel.
      
      Add Record (non-IMS program registration) panel

      AESPNIPV                           Add Record                                 
      Command ===>                                                                  
                                                                                   
      BCSID   :   bcsid   Record type : Non-IMS program registration                
                                                                                   
      Type record key information below. Then press Enter.         Commands: CANcel
                                                                                   
      Record ID                                                                     
        PROGNAME  . . . . . . ********     JOBNAME . . . . . . . ********           
        PROCSTEP  . . . . . . ********     MVSID . . . . . . . . ****               
        JOBSTEP . . . . . . . ********                                              
                                                                                   
      ASB name  . . . . . . . . . . . . . . AUTO$ASB                                
      AR/CTL identifier (ARCID) . . . . . .                                         
      DB2 subsystem name  . . . . . . . . .              (required for DB2 programs)
      DB2 plan name . . . . . . . . . . . .                           (DB2-optional)
      Allow Subzero/MVBO DIRECT of step . . N            (N or Y)                   
      DB2 Batch Attachment Facility Only  . N            (N,CAF,RRS=RRSAF)          
          BAFO error return code  . . . . . 0            (0 - 4095)                 
          BAFO abend code . . . . . . . . . 0            (0 - 4095)                 
          BAFO reason code  . . . . . . . . 00000000     (eight hex digits)         
          BAFO bypass AR/CTL DB2 CONNECT  . N            (N or Y)                   
               with Subzero DB2                                                     
    • If you selected a record to display, the AR/CTL ISPF interface displays the Display Record (Non IMS program registration) panel. This panel is similar to the Add Record panel except that you do not enter the record ID to use.
    • The block at the bottom of the Display Record panel displays the message AESM032A, followed by the user ID, date, and time of the last update to the record.
    • If you selected a record to delete, the AR/CTL ISPF interface displays the Delete Record panel to confirm the deletion.

11. On the Add Record panel or the Display Record panel, type or verify the record qualifiers to use. You cannot enter all wildcard characters in the PROGNAME, PROCSTEP, JOBSTEP, and JOBNAME qualifiers; at least one of these qualifier must contain one non-wildcard, non-blank character.Certain program names (for example, IKJEFT01 and ARCCTRL) are not valid for the PROGNAME qualifier of a non-IMS program registration record. The ISPF interface prevents you from entering an invalid program name.

    Error

    Warning

    Indiscriminate use of wildcard characters in the PROGNAME qualifier can cause AR/CTL to initialize in program executions where AR/CTL processing is invalid or unnecessary. Possible results include abnormal termination of multiple programs, unwanted overhead, and other undesirable effects.

12. Type or verify the values to use for these options:

    ASB name	(Optional) Specify the name (1 to 8 characters) of the application specification block (ASB) used by the application program. An ASB is an AR/CTL control block, also known as a program option member, that communicates information between an application program and AR/CTL. The ASB is associated with data set option members (FCBs) that identify information about the data sets that use AR/CTL data services. The panel primes the field with the name of the default ASB, AUTO$ASB. If you enter blanks in this field, AR/CTL uses the program name for the ASB name.
    AR/CTL identifier (ARCID)	(Optional) Specify the ARCID (1 to 4 bytes) to associate with this program. The ARCID is a qualifier of the record ID of many other AR/CTL records in the REGISET. BMC Software recommends that you do not use the Db2 system ID or any other subsystem ID as the ARCID.
    DB2 subsystem name	This option is required for Db2 programs; do not specify for non Db2 programs. Specify the Db2 subsystem name. This value tells AR/CTL that the program uses Db2. AR/CTL uses the name you specify to locate Db2 connection information.
    DB2 plan name	This option is required for Db2 programs if the plan name is the different from the program name; otherwise, not applicable. Specify the Db2 plan name. Warning Note If a non-IMS program registration record and a subsystem member (SSM) both apply to an application execution, AR/CTL uses the plan name in the program registration record.
    Allow Subzero/MVBO DIRECT of step	Use this option to permit the Subzero Db2 (when set to Y) to request MVBO to DIRECT the step to execute on another LPAR. The default value is N.
    DB2 Batch Attachment Facility Only	(Optional) Use this option to enable all AR/CTL services for the application program or to use only the AR/CTL for Db2 batch attachment facility for the program. Specify one of the following values. The default value is N. The following describe the values: N Initialize the program execution environment for the use of all applicable AR/CTL services. CAF Initialize the program execution environment for the AR/CTL for Db2 batch attachment facility only. AR/CTL provides a call attachment facility (CAF) connection to the Db2 subsystem for the registered program. RRS Initialize the program execution environment for the AR/CTL for Db2 batch attachment facility only. AR/CTL provides a Resource Recovery Services (RRS) connection to the Db2 subsystem for the registered program. AR/CTL provides no RRS support other than the connection to Db2.
    BAFO error return code	(Optional) In this field, specify the return code (0-4095) that you want the AR/CTL application supervisor to issue for the application program job step if the AR/CTL batch attachment facility encounters any error with the connection to Db2. The AR/CTL application supervisor returns control to the application program after issuing this return code. If you specify a value other than 0 in this field, you cannot specify a value in the Abend code field. The default value is 0. This option has meaning only if you specify CAF or RRS for the Db2 Attachment Facility Only option.
    BAFO abend code	(Optional) In this field, specify a value (0-4095) if you want the AR/CTL application supervisor to issue an abend for the application program job step if the AR/CTL for Db2 batch attachment facility encounters any error with the connection to Db2. The AR/CTL application supervisor sets the abend code to the specified value and does not return control to the application program. If you specify a value other than 0 in this field, you cannot specify a value in the Error return code field. The default value is 0. This option has meaning only if you specify CAF or RRS for the Db2 Attachment Facility Only option.
    BAFO reason code	(Optional) In this field, specify the reason code (8 hexadecimal digits) that you want the AR/CTL application supervisor to issue when it issues an abend as specified in the Abend code field. If the value in the Abend code field is 0, this field is ignored. The default value is 00000000.
    BAFO bypass AR/CTL DB2 CONNECT with Subzero DB2	Use this option to let AR/CTL (when set to N) perform the Db2 connection processing when the program is running in an AR/CTL BAFO environment with Subzero Db2. If the value is set to Y, the program itself performs all Db2 connection processing. The default value is N.