IBM Connect:Direct MODIFY Command

Edit online

The IBM® Connect:Direct® MODIFY command yields the same types of traces as the DEBUG initialization parameter. Unlike the initialization parameter, however, the MODIFY command does not require you to bring down and restart the DTF. The trace starts when you issue the MODIFY command to turn on the trace bits, provided the DD is allocated.

Note: When JES data sets are dynamically allocated, specify FREE=CLOSE to ensure that the DD is deallocated and tracing stopped when you close the trace DD using the MODIFY command.

You can issue the MODIFY command through the batch interface or interactively through the IUI. See Issuing the MODIFY Command Through the Batch Interface or Issuing the MODIFY Command through the IUI. To see the current DEBUG setting, see Displaying DEBUG Settings.

The MODIFY command has the following format and parameters. None of these parameters are required.

Label	Command	Parameters
(optional)	MODIFY	BITS.OFF = X'nnnnnnnn'
		BITS.ON = X'nnnnnnnn'
		CLOSE = ddname
		DDNAME = (ddname, nn)
		DEBUG = nnnnnnnn
		DYN (batch) = 'dynamic allocation string' Note: Use an equal sign before and quotes around the dynamic allocation string.
		DYN (IUI) dynamic allocation string Note: Do not use an equal sign before or quotes around the dynamic allocation string in the IUI screen unless you are entering it on the Command Line Interface..
		INITPARMS = YES
		MODDIR.TRACE = YES
		NODE.TRACE.BITSOFF=(node name, X'nnnnnnnn')
		NODE.TRACE.BITSON=(node name, X'nnnnnnnn')
		NODE.TRACE.ON = (node name, debug bits)
		NODE.TRACE.OFF = node name
		WHERE(SERVER = server name)
		ZIIP = NONE \| EXTCOMP \| SSLTLS \| ALL \| PROJECT

The following table describes the parameters of the MODIFY command.

Parameter	Description
BITS.OFF = X'nnnnnnnn'	Turns individual trace bits off. Refer to Debug Settings for the 'nnnnnnnn' value.
BITS.ON = X'nnnnnnnn'	Turns individual trace bits on. Refer to Debug Settings for the 'nnnnnnnn' value.
CLOSE = ddname	This parameter specifies the DD name that is closed in the IBM Connect:Direct DTF.
DDNAME = (ddname, nn)	This parameter specifies a DD name related to a requested trace. All trace information generated as a result of the BITS.ON setting is directed to the DDNAME indicated in the parameter list, based on the IBM Connect:Direct TASKID number nn. This DDNAME provides a consolidated trace of all activity associated with the task. The DDNAME format is R00000nn, where nn is the TASKID.
DEBUG = nnnnnnnn	Replaces the system-wide debugging bits with the specified debug bits. Refer to Debug Settings to see all possible debug bit values.
DYN = 'dynamic allocation string' (batch)	This parameter specifies that dynamic allocation is invoked in the DTF using a specified allocation string. Use an equal sign before and quotes around the dynamic allocation string in the batch DYN parameter. You must use an equal sign before and quotes around the dynamic allocation string in the Command Line Interface for the IUI.
DYN dynamic allocation string (IUI)	This parameter specifies that dynamic allocation is invoked in the DTF using a specified allocation string. Do not use an equal sign before or quotes around the dynamic allocation string in the MODIFY DYN field on the MODIFY COMMAND screen. Note: If you issue the MODIFY command in the Command Line Interface (CLI), you must use an equal sign before and quotes around the dynamic allocation string.
INITPARMS	Refreshes initialization parameters qualified to be modified dynamically while IBM Connect:Direct is running.
MODDIR.TRACE=YES	Requests a module trace.
NODE.TRACE.BITSOFF = (node name, X'nnnnnnnn')	Turns individual trace bits off for a specified node. The node name is the 1–16 character name of the node on which the trace runs. The * and ? wildcard characters are supported when specifying the node name. Refer to Debug Settings for the 'nnnnnnnn' value.
NODE.TRACE.BITSON = (node name, X'nnnnnnnn')	Turns individual trace bits on for a specified node. The node name is the 1–16 character name of the node on which the trace runs. The * and ? wildcard characters are supported when specifying the node name. Refer to Debug Settings for the 'nnnnnnnn' value.
NODE.TRACE.ON = (node name, debug bits)	Requests a trace run on one or more specified nodes. The node name is the 1–16 character name of the node on which the trace runs. The * and ? wildcard characters are supported when specifying the node name. The debug bits are the 8-character DEBUG bits setting. See the BITS.OFF = X'nnnnnnnn' parameter for a listing of debug bits. The trace runs until turned off by the NODE.TRACE.OFF= parameter.
NODE.TRACE.OFF = (node name)	Turns off a trace set by the NODE.TRACE.ON parameter. The node name is the 1–16 character name of the node on which the trace is running. The * and ? wildcard characters are supported when specifying the node name.
WHERE(SERVER=server name)	This parameter specifies which IBM Connect:Direct/Plex member the MODIFY command applies to. The server name parameter is the 1–8 character name assigned to a IBM Connect:Direct/Server by the CDPLEX.SERVER initialization parameter. If this parameter is omitted, the MODIFY command applies to the IBM Connect:Direct/Manager.
ZIIP = NONE \| EXTCOMP \| SSLTLS \| ALL \| PROJECT	This parameter specifies the setting for the zIIP exploitation feature (ZEF). Refer to zIIP Exploitation Feature and ZIIP = NONE \| EXTCOMP \| SSLTLS \| ALL \| PROJECT.