Step 2: Specifying the IMS Batch Terminal Simulator data sets

Define the input and output data sets for IMS Batch Terminal Simulator in the IMS Batch Terminal Simulator JCL.

Procedure

Specify the IMS Batch Terminal Simulator DD statements.

The BTS cataloged procedures define the default parameters for the DD statements. To override these default parameters, provide the override parameters in the JCL.

The following IMS Batch Terminal Simulator DD statements are supported.

Table 1. IMS Batch Terminal Simulator DD statements for batch mode
DD name Description
BTSIN The BTSIN DD is a required DD statement that defines the input data set for IMS Batch Terminal Simulator. This data set contains the simulator commands and simulator statements.
Important:
  • The BTSIN data set must not be a concatenated SMS-managed data set. If BTSIN is a concatenated SMS-managed data set, unpredictable results might occur.
  • The BTSIN data set must be in fixed, fixed-block, variable, or variable-block format.
  • When the BTSIN data set is in fixed or fixed-block format, BTSIN LRECL that is longer than 80 bytes is truncated to 80 bytes.
  • When the BTSIN data set is in variable or variable-block format, BTSIN LRECL can be in the range of 5 - 32756 without any truncation.
BTSOUT The BTSOUT DD is a required DD statement that defines the output data set for IMS Batch Terminal Simulator. After the job is run, this data set contains the output listing from the job.

If you are allocating BTSOUT for IBM® 3278 Model 5 display, the LRECL value that you specify can affect the output that IMS Batch Terminal Simulator produces. See LRECL value for BTSOUT data set for 3270 formatting for more information.
BTSACB The BTSACB DD is an optional DD statement that specifies the ACB library. Consider specifying this DD when simulating the application programs that access data entry databases (DEDBs) in BMP or JBP region with IMS 13 or earlier.

See Applications that access DEDBs for more information about specifying BTSACB DD.
BTSISRIO The BTSISRIO DD is an optional DD statement that defines the output data set for the data that the DLI ISRT (Insert) call inserts to IOPCB.

The BTSISRIO data set must be in variable or variable-block format. The LRECL of BTSISRIO must be 32756 to avoid truncation.
BTSSNAP The BTSSNAP DD is an optional DD statement that defines the output data set for snapshot dumps. This data set is used only when you request a snapshot dump by issuing the ./S command.
BTSDEBUG The BTSDEBUG DD is an optional DD statement that defines the output data set for snapshot dumps of the trace table and various control blocks. These snapshots are taken at critical points during an IMS Batch Terminal Simulator run. You can specify this DD in the following formats:
  • //BTSDEBUG DD DUMMY
  • //BTSDEBUG DD SYSOUT=A

Allocation of a data set with the DD name of BTSDEBUG starts the BTS DEBUG function.

The following figure shows an example.

//BTSJOB     JOB    ACCNT,NAME,MSGLEVEL=1         
//PROCLIB    JCLLIB ORDER=(BTS.PROCLIB) 
//BTS        EXEC   BTS                            
//G.BTSOUT   DD SYSOUT=B,                          
//           DCB=(RECFM=FBA,LRECL=133,BLKSIZE=133) 
//G.BTSDEBUG DD DUMMY                              
//G.BTSSNAP  DD SYSOUT=B,SPACE=(TRK,(10,15))       
//G.BTSIN    DD *                                  
BTS commands and simulator statements              
(optional '/FORMAT' statements)                    
(optional '/EXIT' statements)                      
/*