Trace Startup Parameters
The following startup parameters for Connect:Direct® traces are all optional:
| Parameter | Description and Options | ||
|---|---|---|---|
| -ttyp= | Specifies the type of trace to start during initialization. You must provide this parameter in order to generate any trace output. Any combination of the following options is valid. c — Starts a Command Manager trace. This trace affects all Command Managers started on behalf of users logging in to the IBM® Connect:Direct for Microsoft Windows server. It shows both the command processing flow and the interactions between the server executable and the IBM Connect:Direct for Microsoft Windows. p — Starts a Process Manager trace. This trace shows all events related to the Process Manager and to Session Manager startup by the main server executable. s — Starts a Session Manager trace. This trace shows all Session Manager processing, including file and communications API access, but does not display information that is sent across the communications line. If you do not specify any further qualifying parameters, the system traces all Session Managers. o — Starts a Communications trace. This trace shows all the communications data that flows across the network between the local and remote Connect:Direct Session Managers. m — Starts a trace of the main-line logic that includes initialization and termination. a — Starts a trace of the Statistics subsystem. This trace shows all records sent to the Statistics thread. x — Starts all trace types. Specifying a value of x is the same as specifying cpsoma. |
||
| -tlvl= | Specifies the trace level. The values are: b — Starts a basic trace that includes only module entry and exit records. This is the default. i — Starts an intermediate trace that shows all trace data produced by b plus function arguments. f — Starts a full trace that shows all trace data produced by i plus certain Connect:Direct control blocks and internal information. |
||
| -twrp | Specifies that the trace file should wrap once it reaches its maximum size. |
||
| -tfil=filespec | Specifies the fully qualified name of the trace file that receives output. The default is CDTRACE.CDT in the directory where the IBM Connect:Direct for Microsoft Windows server executable resides. Microsoft Windows Services treats a backslash (\) as an escape character, so type two backslashes for each backslash in the file path. Example: -tfil=c:\\users\\default\\trace.it |
||
| -tfsz= | Specifies the maximum file size the trace file can reach before it wraps if -twrp is also specified. If -twrp is not specified, -tfsz indicates that the trace file will terminate when it reaches this size. The default is -tfsz=100K. bytes: You can specify the file size in bytes. bytesK: You can specify the file size by using the K (x1000) suffix. bytesM: You can specify the file size by using the M (x1000000) suffix. |
||
For Session Manager (s) or Communications (o) trace types, the following parameters are also available:
| Parameter | Description and Options | ||
|---|---|---|---|
| -tpnum= | Requests a trace of up to eight Process numbers upon the initiation of the Process. If you specify -tpnum, Connect:Direct will only trace the specified Processes. pnum: Process number. (pnum1,pnum2,...,pnum8): Trace of up to eight Process numbers. |
||
| -tpnam= | Requests a trace of up to eight Process names upon the initiation of the Process. If you specify -tpnam, Connect:Direct will only trace the specified Processes. Arguments are: pnam: Process name. (pnam1,pnam2,...,pnam8): Trace of up to eight Process names. |
||
| -tdest= | Requests a trace of up to eight Connect:Direct remote node names that have interaction with this local node. This parameter generates trace information when Connect:Direct submits a Process that is destined for the specified remote node or when the specified remote node establishes a sessionam with this local node. If you specify -tdest, Connect:Direct will only trace the specified remote node names. dest: Destination node name. (dest1,dest2,...,dest8): Trace of up to eight destination node names. |
||
-tlnode= or -tpnode= |
Requests a trace of initiating
node sessions only. This parameter modifies the effect of the -tpnam,
-tpnum, and -tdest parameters by allowing only traces of Processes
submitted on the local node.
Note: Connect:Direct for Microsoft
Windows also supports -tpnode in place of -tlnode.
|
||
-trnode= or -tsnode= |
Requests a trace of remote node sessions only, that is, a session initiated by a remote node. This parameter modifies the effect of the -tpnam, -tpnum, and -tdest parameters by allowing only traces of Processes submitted on remote Connect:Direct nodes. Note: IBM
Connect:Direct for Microsoft
Windows also
supports -tsnode in place of -trnode.
|
||