Deleting a Process from the TCQ
The delete process command removes a nonexecuting Process from the TCQ.
You select the Process to delete 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 | Identify the Process to delete by Process name. The Process name is limited to 8 characters on Connect:Direct® for Microsoft Windows and for z/OS. |
name | generic | (list) name—Specifies the Process name up to 8 alphanumeric characters long. 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 | Identify the Process to delete by Process number. IBM® Connect:Direct assigns the Process number when the Process is submitted. Valid Process numbers range from 1–99,999. | number | (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 | Identify the Process to delete 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 | Identify Processes to delete by the node specification and user ID of the Process owner. The character length of this parameter is unlimited. | (node specification, userid) | generic |
(list) node specification, userid—Specifies the node specification 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 following command deletes all nonexecuting Processes submitted by user ID cduser on node dallas:
delete process submitter=(dallas, cduser);