showcpu

You can use the showcpu command to display information about workstations.

Overview

The workstations are the building blocks of HCL Universal Orchestrator on which tasks or workflows run. Use the showcpu command to display workstation details, including type, properties, operating system version, hardware model, and agent version. For more details, see Syntax and command line options section.

Note: When a workstation is removed from the plan, latency might occur when displaying the current status change.

Syntax and command line options

The information can be displayed in standard (default) or info format. The following options are available for filtering results:

ocli plan showcpus | sc [[folder/]workstation] [;info] [;showid]

[folder/]workstation: You can specify the name of the specific workstation you want to display. Optionally, you can specify the folder in which the workstation is defined.

The details that are displayed with each format are as follows:

Standard

The command defaults to the standard format output when no options are specified. This output includes the following information:

CPUID
The name of the workstation.
DATE TIME
The date and time when HCL Universal Orchestrator started the run for the current production plan. The date is displayed in mm/dd/yy format.
State
The state of the following elements:
1. Workstation links and process. The status is displayed in up to six characters.
```
[L] [I] [O] [J] [D] [S]
```
  Each character indicates the following information:
  - L
    The workstation is connected to an engine.
  - I
    The agent is correctly initialized.
  - O
    The workstation status is online. The character is not displayed if the workstation status is offline.
  - J
    JobManager is running.
  - D
    The workstation is using a new configuration package to monitor event conditions. The new configuration to monitor specific event conditions on files is deployed.
  - S
    The workstation status is ignore, and tasks assigned to it are prevented from running.
METHOD
No information is displayed.

info

If you add the info option in the command, results are displayed in the info format. The results include the following information:

CPUID

The name of the workstation.
VERSION

The version of the agent that is installed on the workstation.
TIMEZONE

The time zone of the workstation which is the same value of the TZ environment variable.
INFO

The operating system version and hardware model of the workstation.

Link

If you add the Link option in the command, results are displayed in Link format. The result includes the following information.

CPUID

The name of the workstation.

showid

When you add this option in the command, the results display the unique workstation identifier. The name of the workstation and the location of the folder where it is defined is linked to the unique identifier.

Examples

To display all workstations in all folders, run the following command:

ocli plan sc /@/@

A sample output for this command is as follows:

CPUID              RUN    NODE         LIMIT FENCE DATE     TIME  STATE       METHOD                                   DOMAIN 

                            CLOUD               NA     UNIX CLOUD    100   100 18/07/23 15:58  L IOJ 

                            WS_AGT_0            NA     UNIX AGENT    100   100 18/07/23 15:59  L IOJ 
    
                            WS_AGT_1            NA     UNIX AGENT    100   100 18/07/23 15:59  L IOJ

To display all workstations in the root folder with their unique identifiers, run the following command:

ocli plan sc \;showid

A sample output for this command is as follows:

CPUID              RUN    NODE         LIMIT FENCE DATE     TIME  STATE       METHOD                                   DOMAIN 

                            CLOUD               NA     UNIX CLOUD    100   100 18/07/23 15:58  L IOJ                                                {004203aa-df66-453b-a79d-8ae2f06a8474} 

                            WS_AGT_0            NA     UNIX AGENT    100   100 18/07/23 15:59  L IOJ                                                {da2cb3b6-38f4-4984-9060-a65eb38baa5c} 

                            WS_AGT_1            NA     UNIX AGENT    100   100 18/07/23 15:59  L IOJ                                                {971eed47-cf94-4214-adf7-de3861a2b198}

To display the results in info format, run the following command:

ocli plan showcpus | sc \;info

A sample output for this command is as follows:

CPUID            VERSION  TIME ZONE                        INFO 

                             CLOUD            1.1.0.0   UTC                              Cloud Task Launcher 

                             WS_AGT_0         10.2.0.0  UTC                              Red Hat Enterprise Linux 9.… 

                             WS_AGT_1         10.2.0.0  UTC                              Red Hat Enterprise Linux 9.…

To display the information in link format, run the following command:

ocli plan sc \;link

A sample output for this command is as follows:

CPUID             HOST            FLAGS  ADDR  NODE 

                            CLOUD                                    31111  CLOUD 

                            WS_AGT_0                                 31111  WS_AGT_0 

                            WS_AGT_1                                 31111  WS_AGT_1