This section includes the following topics:
About managing action items
The CLI utilities provides the ability to manage action items. This includes fetching action items, executing them, and marking them as done.
List action items
To list all action items per instance, run the following command from the main Precise FocalPoint root:
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action action-item-list
[-server <server_name>]
[-proxy-alias <node_alias>]
[-instance-name <instance_name>]
[-technology <technology_code>]
[-id <sequence_id>]
[-resource-id <resource_id>]
[-status <status>]
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action action-item-list
[-server <server_name>]
[-proxy-alias <node_alias>]
[-instance-name <instance_name>]
[-technology <technology_code>]
[-id <sequence_id>]
[-resource-id <resource_id>]
[-status <status>]
The instance details can be dropped to show action items which are not per instance. This creates an XML file containing all relevant action items and their details.
Table 1 Elements of the List action items
| Element | Description |
|---|---|
| i3-user | See Authenticate to CLI Utility on page 8. |
| i3-encrypted-password | See Authenticate to CLI Utility on page 8. |
| action | Values:action-item-list Mandatory: Yes |
| server | Filter action items by server. Values: string Mandatory: No |
| proxy-alias | The proxy alias. Values: alias of the related node Mandatory: Only for a federated installation |
| instance | Filter action items per instance name Values: string Mandatory: No |
| technology | Filter action items by technology code. For more information, see Technology Codes on page 174. Values: string Mandatory: No |
| id sequence | Filter action items to a specific action item Values: number Mandatory: No |
| resource-id | Filter action items to a specific type of action item. Values: number Mandatory: No |
| status | Filter action items by status. Values: WAIT, DONE, ERROR |
Perform action items
To perform action item(s), run the following command from main Precise FocalPoint root:
Windows infra\bin\psin_cli.bat
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action action-item-handle -type <type> [-server <server_name>]
[-proxy-alias <node_alias>]
[-instance-name <instance_name>] [-technology <technology_code>]
[-id <id_sequence>]
[-resource-id <resource_id>]
[-parameter user=<admin3> -parameter password=<@HH>]
UNIX ./infra/bin/psin_cli.sh
-i3-user <user_name>
{-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
-action action-item-handle -type <type> [-server <server_name>]
[-proxy-alias <node_alias>]
[-instance-name <instance_name>] [-technology <technology_code>]
[-id <id_sequence>]
[-resource-id <resource_id>]
[-parameter user=<admin3> -parameter password=<@HH>]
Table 2 Elements of the Perform action items
| Element | Description |
|---|---|
| i3-user | See Authenticate to CLI Utility on page 8. |
| i3-encrypted-password | See Authenticate to CLI Utility on page 8. |
| action | Values: action-item-list Mandatory: Yes |
| server | Filter action items by server Values: string Mandatory: No |
| proxy-alias | The proxy alias. Values: alias of the related node Mandatory: Only for a federated installation |
| instance | Filter action items per instance name Values: string Mandatory:No |
| technology | Filter action items by technology code. For more information, see Technology Codes on page 174. Values: string Mandatory:No |
| id sequence | Filter action items to a specific action item Values:number Mandatory: No |
| resource-id | Filter action items to a specific type of action item Values: number Mandatory: No |
| type | Values: run or performed You can specify "run" only for action items which allows automatic execution. This instructs Precise to automatically perform the related action item. Specify "performed" for action item you've already performed (similar to GUI's "Mark as done"). |
| status | Filter action items by status Values: WAIT, DONE, ERROR Mandatory: No Not specifying the status will return all action items. |