4.1.2 Description of SYSTEM Parameters

The SYSTEM statement uses the following parameters.

Parameter Value Description
SLEEPTIME sleep-min Specifies the minimum amount of time (decimal, milliseconds) that TMA TCP for IMS delays before checking for work. Default value: 150
- sleep-max Specifies the maximum amount of time (decimal, milliseconds) that TMA TCP for IMS delays before checking for work. Default value: 500
- sleep-delta

Specifies the incremental amount of time (decimal, milliseconds) that TMA TCP for IMS uses to graduate from the minimum sleep time to the maximum sleep time.

TMA TCP for IMS periodically “polls” for new work. The TMA TCP for IMS product uses a graduated polling interval that is set to the minimum sleep time whenever new work is found. The polling interval is then incrementally increased by the delta time until one of the following occurs:

  • New work is found (in which case the polling interval is again reset to the minimum value)
  • The maximum sleep time is reached (in which case the polling interval remains at the maximum value)

This value limits the amount of CPU time required to poll for work when traffic is heavier.

Avoid specifying values that cause the polling interval to be very small (or zero), or values smaller than 100 milliseconds. These values may result in polling too frequently. However, also avoid specifying values that cause the polling interval to be too large (greater than one second). These values may cause TMA TCP for IMS to be unresponsive. Varying the sleep time between 100 and 500 milliseconds in 5 millisecond increments is recommended.

Default value: 5

OTMACLIENT clientname Specifies the XCF client name for TMA TCP OTMA. This parameter is 1-16 characters and referenced by DRU EXIT.
OTMAGROUP groupname Specifies the XCF group name for IMS and TMA TCP. This parameter is 1-8 characters and the same as GRNAME parameter in the IMS system.
OTMASECURITY Yes|No Specifies whether to enable or disable security for user authorization. Specify Yes to enable security or No to disable security. Default value: No
MSGLEVEL msg-level | 4 Specifies the message detail level to be logged by TMA TCP for IMS.

0 - No messages are logged

2 - Error Messages only

3 - Informational Messages and Error Messages

4 - Security Audit Messages

The message level is cumulative. For example, if a message level of 4 is specified, all messages with a message level of 4 or less is logged (such as, security audit, informational, and error messages) and is also displayed on the z/OS console.

Normally, a message level of 4 should be specified, which results in TMA TCP for IMS logging all security, informational and error messages.

Default value: 5

CLIENTSHUTDOWN Yes|No Specifies whether a SHUTDOWN request can be made by a remote client request or as a response to a remote client request. For additional information for shutting down the system, refer to the Monitoring Oracle TMA TCP for IMS.

Default value: No

IDLETIMEOUT nn | 0

Specifies the number of seconds that lapses before the local gateway terminates a session.

Default value: 0

DRUEXIT exit-name Specifies the name of the destination resolution User Exit routine in IMS that this client should use. The default is DFSYDRU0. For a sample of the DFSYDRU0 user exit, refer to the Sample JCL and User Exits.
SPARESOCKETS nn

Specifies the number of spare socket descriptors reserved for dynamic configuration changes, for example, adding a gateway, increasing the maximum number of sessions for a gateway.

Default value: 0.