Select Process Command
Use the select process command to display information about Processes in the TCQ. Select Processes by name, number, queue, SNODE, status, submitter, or a combination of these.
Format
The format for the select process command follows:
| Command | Parameters |
|---|---|
| select process | /* Selection Criteria */ |
| [pname=Process name | generic | (list)] | |
| [pnumber=Process number | (list)] | |
| [queue=all | exec | hold | wait | timer] | |
| [snode=snode name | generic | (list)] | |
| [status=ex | hc | he | hi | ho | hr | hs | pe | re | wa | wc | ws | (list)] | |
| [submitter=(node name, userid) | generic | (list)] | |
| /* Display option */ | |
| [detail=yes | no] |
Selection Parameters
Specify one or more of the following selection parameters. If you do not specify one of the following selection parameters, all Processes in the TCQ you are authorized to access are selected.
| Parameter | Description |
|---|---|
| pname=Process name | generic | (list) | Identifies the Process name, up to 8 alphanumeric characters long. |
| pnumber=Process number | (list) | Identifies Processes numbers to select. The Process number is assigned when you submit the Process. Valid Process numbers range from 1–99999. |
| queue=all | exec | hold | wait | timer | Identifies queue names to select. all—Selects 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=snode name | generic | (list) | Identifies the SNODE name, from 1 to 16 alphanumeric characters, to select. |
| status=ex | hc | he | hi | ho | hr | hs | pe | re | wa | wc | ws | (list) | Selects a Process status to select. If you do not specify a status value, information is generated for all status values. ex—Selects Processes from the Execution queue. hc—Selects Processes submitted with hold=call. he—Selects Processes held due to a connection error. hi—Selects Processes submitted with hold=yes. ho—Selects Processes held by a change process command issued with hold=yes. hr—Selects Processes submitted with retain=yes. hs—Selects Processes suspended by a delete process command issued with hold=yes. pe—Selects submitted Processes that are awaiting the Session Manager. After the Session Manager initializes, it places the Process in the Execution queue and changes the status to EX. re—Selects Processes that are waiting for restart after session failure. wa—Selects Processes that are eligible for execution but not yet selected or running. wc—Selects Processes that are ready for execution and awaiting an available connection to the SNODE. ws—Selects Processes waiting in the Timer Queue for a start time. |
| submitter=(node name, userid) | generic |(list) | Selects Processes by node name and user ID of the submitter of each Process. The maximum combined length, including the node name and userid, is 66 characters. |
Display Parameter
The following display parameter generates a detailed report of the select process command.
| Parameter | Description |
|---|---|
| detail=yes | no | Specifies the type of report generated for the selected Process or Processes. The default is no. yes—Generates a detailed report no—Generates a short report |
Examples
The following example shows the report information returned when specifying detail=yes.
|
The following example shows the report information returned when specifying detail=no or omitting the detail parameter.
|
The following command returns status information for Process number 9.
|