TRACE command

The TRACE host command for REXX controls the IMS Connect Extensions trace. You can specify filter conditions to control which additional event records are written to the active IMS Connect Extensions journal data set.

Syntax

Read syntax diagramSkip visual syntax diagram TRACE LEVEL= 1,1LEVEL= 0,LEVEL= 2,KEEP_ACTIVE=NO,1KEEP_ACTIVE=YES,PORT=*,1PORT= port,PORT=LOCAL,,COND=(PORT_ONLY)1COND=(CLIENT_NAME, client_name)COND=(TRANSACTION, transaction_name)COND=(MESSAGE_EXIT, exit_name)COND=(USERID, user_ID)COND=(LTERM, logical_terminal)COND=(IP_ADDRESS, host_name_or_IP),STEM=CEX,STEM= stem,CONID= conid
Notes:
  • 1 Default only when no trace is currently active.

Parameters

LEVEL
Set the tracing level.
0
Deactivate tracing. IMS Connect Extensions stops writing trace records to the active journal.
1
Activate tracing, but do not include client application data in the trace records. If LEVEL is not specified and no trace is currently active, this is the default.
2
OTMA workloads only. Activate tracing and include client application data in the trace records.
KEEP_ACTIVE
The status of tracing after a system restart.
YES
Keep trace active after a system restart.
NO
Tracing continues until it is deactivated or until a system restart. If KEEP_ACTIVE is not specified and no trace is currently active, this is the default.
PORT
Enter a decimal value in the range 1 - 65535 to specify which IMS Connect TCP/IP port you want to initiate a trace against. Use LOCAL to trace against the local port. If PORT is not specified and no trace is currently active, the default is all ports (*).
COND
Set the condition which writes a trace record. For example, if you want to trace activity for a particular transaction use the TRANSACTION condition. You do not need to specify conditions if you are only deactivating tracing (LEVEL=0). Otherwise, you can use one of the following conditions:
CLIENT_NAME
The client name. The value can be up to 8 characters. It must not start with a number.
TRANSACTION
Transaction code. The value can be up to 8 characters. It must not start with a number.
MESSAGE_EXIT
User message exit processing the messages. The value can be up to 8 characters. It must not start with a number.
USERID
User ID specified in the message. The value can be up to 8 characters. The value must specify a string that represents a valid user ID, an asterisk, or a partial user ID ending in an asterisk (*). No other wildcards are permitted.
LTERM
Logical Terminal name. The value can be up to 8 characters. It must not start with a number.
IP_ADDRESS
The IPv4 address, IPv6 address, or host name of the client. If you enter a host name, IMS Connect Extensions will attempt to resolve the IP address.
PORT_ONLY
Trace on the TCP/IP port only. No condition is set. If no COND parameter is supplied and no trace is active, this is the default.
Note: Conditional tracing is not applicable when tracing ODBM activity. To trace ODBM activity, simply specify the port.
STEM
The common stem for the REXX variables that are set by this command. The default stem is CEX.
CONID
A unique connection ID that was established by a previous CONNECT command. If no CONID is specified then the current default connection is used. The default connection is the last connection that was specified either by a CONNECT command or by an OPTION command using the CONID keyword.

Examples

Here are example TRACE statements:

⋮
address CEX "TRACE LEVEL=1,PORT=8889,COND=(USERID,HWSUSR)"
address CEX "TRACE LEVEL=2,PORT=8889,COND=(TRANSACTION,PARTX)"
address CEX "TRACE LEVEL=0"

The CEXRXC11 member in the SCEXSAMP library contains a detailed example of how to change OTMA tracing settings.