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
- 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.
- 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) parametersType |
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. |
- Specify other
CLIST parameters.
Table 2. CLIST parametersMode |
Description |
CALLTYPE(mode) |
Specifies the mode of execution for IMS Batch Terminal Simulator. The default
mode is CALLTYPE(CALL).
|
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.