Viewing a Process in the TCQ
The view process command is used to view Processes in the TCQ when the local node is the PNODE. You can search by Process name, Process number, queue, secondary node, status, owner of the Process, or any combination of the search criteria parameters.
You also can specify more than one Process in the search criteria.
There are no required parameters for this command. If you do not specify an optional parameter, IBM® Connect:Direct® selects all Processes executing or waiting for execution. Following are the optional parameters for the view process command:
| Parameter | Description | Value |
|---|---|---|
| pname | Locate the Process to view 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 view 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. |
| queue | Specifies the Processes to be viewed by the specified queue names. | all | exec | hold | wait | timer all—Selects Processes from all queues. This is the default. exec—Selects Processes from the Execution queue. hold—Selects Processes from the Hold queue. timer—Selects Processes from the Timer queue. wait—Selects Processes from the Wait queue. |
| snode | View the Process 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. |
| status | Specifies the Processes to be viewed by Process status. If you do not specify a status value, information is generated for all status values. | EX | HC | HE | HI | HO | HR | HS | PE | WC | WR | WS | (list) EX (Execution)—Specifies to select Processes from the Execution queue. HC (Held for Call)—Specifies to select Processes submitted with hold=call. HE (Held due to Error)—Specifies to select Processes held due to a connection error. HI (Held Initially)—Specifies to select Processes submitted with hold=yes. HO (Held by Operator)—Specifies to select Processes held by a change process command issued with hold=yes. HR (Held Retain)—Specifies to select Processes submitted with retain=yes or retain=initial. HS (Held Due to Execution Suspension)—Specifies to select Processes suspended by a flush process command issued with hold=yes. PE (Pending Execution)—Specifies to select Processes submitted with a maxdelay parameter and assigned PE status by the Process Manager just before a Session Manager is created to execute the Process. After the Session Manager initializes, the Process is placed on the Execution queue and the status is changed to EX. WC (Waiting for Connection)—Specifies to select Processes that are ready for execution, but that all available connections to the remote node are in use. WR (Waiting for Restart)—Specifies to select Processes that are waiting for restart after session failure. WS (Waiting for Start Time)—Specifies to select Processes waiting for a start time. These Processes are on the Timer Queue. list—Specifies a list of status values. Enclose the list in parentheses, and separate each value with a comma. |
| submitter | Locate the Processes to view by the node specification (the IBM Connect:Direct node name) and user ID of the Process owner. The length of this parameter is unlimited. | (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 following command displays the specified Process number:
view process pnumber=1;