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
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.