Step 3: Specifying the IMS data sets

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

Procedure

Specify the IMS and z/OS® 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 table summarizes the IMS and the z/OS DD statements that are required to override the values in the BTS cataloged procedures.

Table 1. IMS and z/OS DD statements for batch mode
DD name	Description
STEPLIB or JOBLIB	The STEPLIB or the JOBLIB DD statement is a required DD statement that defines the following input data sets: IMS library The library that contains the IMS load modules. Program library (PGMLIB) The program library that contains the user-written application programs. Db2® library (optional) The library that contains the Db2 load modules. IBM® MQ library (optional) The library that contains the IBM MQ load modules. Language Environment® library (optional) The library that contains the Language Environment modules. Debug Tool library (optional) The library that contains the IBM Debug Tool modules. Other libraries Other libraries such as language libraries.
IMS	The IMS DD statement is an optional DD statement. This DD statement defines the library that contains the DBD and the PSB that describe the database to be processed.
IMSACB	The IMSACB DD statement is an optional DD statement. This DD statement defines the library that contains the DMB for the database. You can use the IMSACB DD statements to identify the active ACB library.
FORMAT	The FORMAT DD is an optional DD statement that defines the IMS MFS control block library. This DD statement is required for testing IMS MFS applications.
IEFRDER	The IEFRDER DD is an optional DD statement that enables the IMS logging facility. For this DD statement, define the primary system log data set. If IEFRDER DD DUMMY is specified, the log data sets are not used. Important: For KW=DBB, if you do not supply a log data set in the JCL, you must specify DBRC=N as an EXEC parameter; otherwise, the region abends with a U0073.
DFSVSAMP	The DFSVSAMP DD is an optional DD statement that defines the buffer pool configuration of an IMS subsystem. Specify this DD statement if VSAM databases are used. This statement is sometimes required for ISAM and OSAM databases. When KW=DBB is specified, the IOBF keyword must be used to define the length and number of buffers for the ISAM and OSAM buffer pool. Because IMS Batch Terminal Simulator might attach to IMS more than once, the DFSVSAMP DD statement must be defined as a DASD data set so that it can be reread. Related reading: For more information about DFSVSAMP DD, see IMS System Definition.
Note: The DFSRESLB, IEFRDER, IMS, and IMSACB data sets are allocated only when KW=DLI or KW=DBB is specified. For more information about these data sets, see IMS System Definition.

The following example shows how to specify IMS data sets.

//BTSJOB     JOB    ACCNT,NAME,MSGLEVEL=1
//PROCLIB    JCLLIB ORDER=(BTS.PROCLIB)
//BTS        EXEC   BTS
//G.STEPLIB  DD DISP=SHR,DSN=IMS.PGMLIB  
//           DD DISP=SHR,DSN=BTS.SBTSLMD0   
//           DD DISP=SHR,DSN=IMS.SDFSRESL         
//G.FORMAT   DD DISP=SHR,DSN=IMS.FORMAT
//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)
/*
//G.IEFRDER  DD DSN=IMSLOG,DISP=(MOD,KEEP)
//DFSVSAMP   DD DISP=SHR,DSN=IMS.VSAM.PARM(OPTIONS)