4.2.6.1 JCL for OTMA Clients
When running the product as an OTMA client, TMA TCP for IMS runs
in its own address space under z/OS as a started task or long
running job. Member RUNOTM
in the JCL distribution
library is a sample job for executing TMA TCP for IMS.
When tailoring the JCL for your OTMA installation, pay particular attention to the following:
- Local Services and IMS Host Systems Definition
TIME=1440
since TMA TCP for IMS executes as a non-ending job. - TMA TCP for IMS is written in the C language and requires
access to the LE/370 runtime environment. Add DD cards to the
STEPLIB
for the LE/370 runtime datasets, includingSYS1.SCEERUN
andSYS1.SCEELKED
. Use whatever dataset names are appropriate for your installation. - For diagnostic purposes, you may wish to add
DD
cards forSYSUDUMP
and/orCEEDUMP
. In the event of an abnormal termination (ABEND
), LE/370 writes a formatted dump toCEEDUMP
- Add a
DD
card forSYSTCPD
pointing to the TPC/IP Data file (for example, TCPIP.V3R1.DATA – change the dataset name as necessary to conform to your installation). This dataset is used by TCP/IP in the TMA TCP for IMS address space (when using IBM TCP/IP). - Add a
DD
card forSYSTCPD
pointing to the TPC/IP Data file (for example, TCPIP.V3R1.DATA – change the dataset name as necessary to conform to your installation). This dataset is used by TCP/IP in the TMA TCP for IMS address space (when using IBM TCP/IP). - If you want to preserve messages from previous executions of
TMA TCP for IMS, code
DISP=MOD
in theMSGLOG
DD
statement; new messages are appended to the end of the dataset (existing messages are preserved). If you want the Message Log to be overwritten with each new execution of TMA TCP for IMS, codeDISP=OLD
(orDISP=SHR
) in theMSGLOG
DD
statement; existing messages are lost. - If you want to preserve messages from previous executions of
TMA TCP for IMS, code
DISP=MOD
in theMSGLOG
DD
statement; new messages are appended to the end of the dataset (existing messages are preserved). If you want the Message Log to be overwritten with each new execution of TMA TCP for IMS, codeDISP=OLD
(orDISP=SHR
) in theMSGLOG
DD
statement; existing messages are lost.
Parent topic: Task 6: Create JCL to Run TMA TCP for IMS