Working with IMS program registration records

In an IMS program, IMS is active and the program uses IMS calls and structures or AR/CTL common calls. In an IMS compatible program, the program uses IMS type calls and structures or AR/CTL common calls but IMS is not active; an IMS compatible program is registered as an IMS program.

To work with 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 7 (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 (IMS program registration) panel.
      
      Add Record (IMS program registration) panel

      AESPIMPV                           Add Record                                
      Command ===>                                                                 
                                                                                  
      BCSID   : ELMQ      Record type : IMS program registration                   
                                                                                  
      Type positional masking characters and                       Commands: CANcel
      wildcard characters (*) in key fields. Then press Enter.                     
      Record ID                                                                    
        PROGNAME  . . . . . . ********     IMSID . . . . . . . . ****              
        PROCSTEP  . . . . . . ********     MVSID . . . . . . . . ****              
        JOBSTEP . . . . . . . ********                                             
        JOBNAME . . . . . . . ********                                             
        PSBNAME . . . . . . . ********                                             
                                                                                  
      IMS replacement mode? . . . . . . . . . . N           (N,Y), see Note 1 below
      IMS replacement mode default SSM  . . . .                                    
      IMS replacement mode default PROCLIB DSN                                     
                                                                                  
      Note 1:  To register a program that will not run under IMS, set this field   
               to Y.                                                               
                                                                                  
      Allow Subzero/MVBO DIRECT of step . . . . N           (N or Y)                
    • If you selected a record to display, the AR/CTL ISPF interface displays the Display Record (IMS program registration) panel. This panel is similar to the Add Record panel, except that you do not enter the record ID to use.
    • 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 or Display Record panel, type or verify the qualifiers to use in the record ID. You cannot enter all wildcard characters in the PROGNAME, PROCSTEP, JOBSTEP, JOBNAME, and IMSID qualifiers; at least one of these qualifiers must contain one non-wildcard, non-blank character.
    Certain program names (for example, DFSRRC00, DFSURGU0, and DFSURGL0) are not valid for the PROGNAME qualifier of an IMS program registration record. The ISPF interface prevents you from entering an invalid program name.

    Note

    If you use the PROGNAME qualifier, code the program name that is used in the second parameter of the EXEC PGM=DFSRRC00 statement. For an IMS program that uses DB2, this parameter will be DSNMTV01; another qualifier, such as the PSB name, is required.

12. Type or verify the value to use for the following options:

    Note

    AR/CTL will only use the IMS replacement mode default SSM and IMS replacement mode default PROCLIB DSN if you did not specify an SSM and PROCLIB in the job parameter JCL.

    IMS replacement mode?	Required. AR/CTL can replace IMS checkpoint/restart and generalized sequential access method (GSAM) services. For an application program that uses IMS type calls and structures only to obtain IMS checkpoint/restart services, GSAM services, or both, you can use this option to force the use of AR/CTL instead of IMS. IMS will not be invoked. Set one of the following values; there is no default value, but you must specify N if the application program uses any IMS services other than a checkpoint/restart and GSAM: N Use IMS services. This value is required if the application program uses any IMS services other than checkpoint/restart and GSAM. This value is required for a BMP. Y Use AR/CTL IMS compatible mode. If the application program uses any IMS services except checkpoint/restart and GSAM, AR/CTL issues an abend for the job step at the first unsupported call because IMS is not active to service the call. For more information, see Using.
    IMS replacement mode default SSM	Required if you want to connect to DB2 in IMS replacement mode. AR/CTL allows you to specify the DB2 connection information to use for the job. Specify the DB2 connection information. If you use BMP JCL and do not supply the SSM parameter and PROCLIB in the JCL, AR/CTL will append the SSM to the IMSID to create the member name in the PROCLIB.
    IMS replacement mode default PROCLIB DSN	Required if you want to connect to DB2 in IMS replacement mode and you did not specify the PROCLIB in the BMP JCL. AR/CTL allows you to specify a default PROCLIB data set name. AR/CTL will dynamically allocate the PROCLIB data set. Specify the default data set name for the PROCLIB.
    Allow Subzero/MVBO DIRECT of step	Use this option to permit Subzero IMS (when set to Y) to request MVBO to DIRECT the step to execute on another LPAR. The default value is N.