Removing a Process from the Execution Queue

Edit online

The flush process command removes Processes from the Execution queue. You select the Process to remove by Process name, Process number, secondary node name, submitter, or any combination of the search criteria parameters. Specify at least one of the following search criteria parameters:

Parameter Description Value
pname Locate the Process to remove by Process name.

The Process name is limited to 8 characters on Connect:Direct® for Microsoft Windows and Connect:Direct for z/OS®.

 name | generic | (list)

name—Specifies the Process name, up to 8 alphanumeric characters.

generic—Specifies a nonspecific value for the Process name. This generic value, containing pattern-matching characters, evaluates to a list of zero or more pname strings.

list—Specifies a list of Process names. Enclose the list in parentheses, and separate each value with a comma.
pnumber Locate the Process to remove by Process number. IBM® Connect:Direct assigns the Process number when the Process is submitted. number from 1–99,999 | (list)

number—Specifies the Process number.

list—Specifies a list of Process numbers. Enclose the list in parentheses, and separate each value with a comma.
snode Locate the Process to remove by the secondary node name. This parameter can be used to specify a specific remote node, a generic value for matching remote node names (using pattern matching), or a list of multiple remote node names.

The secondary node name typically contains the 1–16 character remote IBM Connect:Direct node name, but can be any string up to 256 alphanumeric characters long. You can also specify a remote node name as an IP address or hostname and a port number.

remote node specification | generic | (list)

remote node specification—Identifies a specific remote node name.

generic—Specifies a nonspecific value for the remote node name. This generic value, containing pattern-matching characters, evaluates to a list of zero or more remote node names.

list—Specifies a list of remote node specifications. Enclose the list in parentheses, and separate each value with a comma.
submitter Locate the Processes to remove by the node specification (the IBM Connect:Direct node name) and user ID of the Process owner. (node specification, userid) | generic | (list)

node specification, userid—Specifies the node specification (the IBM Connect:Direct node name) and user ID.

generic—Specifies a nonspecific value for node specification and user ID. This generic value, containing pattern-matching characters, evaluates to a list of zero or more node specifications and user IDs.

list—Specifies a list of node specification and user ID pairs. Enclose the list in parentheses, and separate each value with a comma.

The flush process command has the following optional parameters:

Parameter Description Value
force Forcibly terminates an executing Process or terminates a Process in an orderly fashion as the step completes. This parameter is useful if a Process is in the executing state and waiting for unavailable resources. yes | no

yes—Specifies to forcibly and immediately terminate the Process. The SMGR also terminates immediately.

no—Specifies to terminate the Process in an orderly fashion as the step completes. The SMGR closes the statistics file and then terminates. This is the default.
hold Places the terminated Process in the Hold queue where it can be released for re-execution. yes | no

yes—Specifies to place the Process in the Hold queue in HS status after the Process is terminated.

no—Specifies to delete the Process from the TCQ after the Process is terminated. This is the default.

The following command flushes all executing Processes named “Rome” from the Execution queue:

flush process pname=rome force=yes;

The following command flushes all executing Processes on node alma submitted by user ID jones:

flush process submitter=(alma, jones);