Step 1: Specifying the TSO CLIST parameters

You start IMS Batch Terminal Simulator in interactive mode by using a TSO command list (CLIST). You must define the execution parameters for IMS Batch Terminal Simulator in the TSO CLIST procedure.

About this task

You can create a TSO CLIST to allocate data sets and run IMS Batch Terminal Simulator in the TSO foreground. TSO CLISTs are TSO capability and are not part of IMS Batch Terminal Simulator. The content of this CLIST depends on your installation’s standards.

IMS Batch Terminal Simulator provides a sample CLIST, BTSCLIST. You can copy and use the BTSCLIST, or you can use the CLIST provided by your system administrator to create your TSO CLIST procedure.

Procedure

  1. You can run your application in a DLI region, DBB region, BMP region, or JBP region. Determine the region type by evaluating the characteristics of each region in Determining the types of IMS region.

    To run your application in BMP or JBP region, you must start the IMS control region. You do not need to start the IMS control region if you are running in a DLI region or DBB region.

  2. Define the type of IMS region by specifying the KW(type) parameter.

    The BTS CLIST has a number of optional parameters. One use of the optional parameters is to specify the EXEC PARMs that are passed to the IMS region controller. The CLIST generates the EXEC PARMs based on the KW parameter specification.

    KW(type) indicates the type of IMS region to be used. KW(DLI) and KW(DBB) are used for batch region execution, and KW(BMP) and KW(JBP) are used for online dependent region execution. The following table describes each KW(type) parameter.

    Table 1. KW(type) parameters
    Type Description
    KW(DLI) Requests a DLI region. The parameter string that is generated for this option is the same as that for IMS Procedure DLIBATCH except that the second and third parameters, &MBR and &PSB, are not included.
    KW(DBB) Requests a DBB region. The parameter string that is generated for this option is the same as that for IMS procedure DBBBATCH except that the second and third parameters, &MBR and &PSB, are not included.
    Important: For KW(DBB), if you do not supply a log data set in the CLIST, you must specify DBRC=N as an EXEC parameter; otherwise, the region abends with a U0073. IMS always assumes update intent for BTS DBBBATCH execution. For an explanation of the abend, see IMS Messages and Codes.
    KW(BMP) Requests a BMP region. The parameter string that is generated for this option is the same as that for IMS procedure IMSBATCH except that the second and third parameters, &MBR and &PSB, are not included.
    KW(JBP) Requests a JBP region. The parameter string that is generated for this option is the same as that for IMS procedure IMSBATCH except that the second and third parameters, &MBR and &PSB, are not included.
  3. Specify other CLIST parameters.
    Table 2. CLIST parameters
    Mode Description
    CALLTYPE(mode)

    Specifies the mode of execution for IMS Batch Terminal Simulator. The default mode is CALLTYPE(CALL).

    • CALLTYPE(CALL): Indicates that a TSO CALL is generated.
    • CALLTYPE(TEST): Indicates that IMS Batch Terminal Simulator and the application program are run under control of the TSO TEST monitor.
    • CALLTYPE(BTSCP): Indicates that IMS Batch Terminal Simulator is run under control of TSO command processor BTSCP. Under BTSCP, COBOL application programs can be run under control of COBOL interactive debug (COBTEST).
      Restriction: IMS Batch Terminal Simulator does not support testing of dynamically linked COBOL subroutines. The ./C information is ignored or not processed.
      Related reading: For more information about using COBOL interactive debug, see the following topics:
    ALLOCDS Specifies the creation of the IMS Batch Terminal Simulator data sets and the allocation of all data sets that are necessary for the IMS Batch Terminal Simulator run. After the data sets are created and allocated, IMS Batch Terminal Simulator is started.
    ALLOC Specifies that the IMS Batch Terminal Simulator data sets already exist and that only the allocation is to be performed. After the data sets are allocated, IMS Batch Terminal Simulator is started.
    DELETE Specifies that the IMS Batch Terminal Simulator data sets are to be deleted. IMS Batch Terminal Simulator is not started.
    FREE Specifies that the IMS Batch Terminal Simulator data sets are to be deallocated. IMS Batch Terminal Simulator is not started.

    For the definitions of the execution parameters that can be specified, see IMS System Definition.