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=1440since 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, including SYS1.SCEERUN and SYS1.SCEELKED. Use whatever dataset names are appropriate for your installation.
  • For diagnostic purposes, you may wish to add DD cards for SYSUDUMP and/or CEEDUMP. In the event of an abnormal termination (ABEND), LE/370 writes a formatted dump to CEEDUMP
  • Add a DD card for SYSTCPD 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 for SYSTCPD 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 the MSGLOG 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, code DISP=OLD (or DISP=SHR) in the MSGLOG DD statement; existing messages are lost.
  • If you want to preserve messages from previous executions of TMA TCP for IMS, code DISP=MOD in the MSGLOG 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, code DISP=OLD (or DISP=SHR) in the MSGLOG DD statement; existing messages are lost.