pico

This command is used to:

  • list, add, or delete EC groups

  • view pico instances

Usage: pico -list | -view <pico name> | -add <ec group name> | -delete <ec group name> | -mark_for_shutdown <ec name>

-list

usage: pico -list

Use pico -list to list available EC groups.

Example - pico -list

The following commands list all EC groups.

mzsh <username>/<password> pico -list

Output:

ecgroup2 ec ecgroup1 ec

-view

usage: pico -view <pico name>

Use pico -view to view the status of pico instances in the system.

Example - pico -view

The following displays the status for all pico instances in the system.

Output:

The Memory column is a comma-separated list of Used, Committed, and Maximum memory, and Response Time is measured in milliseconds.

If Error Status indicates "Error", an OutOfMemoryError has occurred and additional information will be included in the output. For example, in case of an OutOfMemoryError on the Platform, the following could be shown:

OutOfMemoryError is further described in Out of Memory Info in System Log

If Error Status indicates "Connection failure", an RCP error has occurred.

The following command displays the status of the pico instance named ec1.

Output:

-add

usage: pico -add <ec group name>

Use pico -add to add an EC group to the system.

Example - pico -add

The following command adds an EC group named ecgroup1.

Output:

-delete

usage: pico -delete <ec group name>

Use pico -delete to delete an EC group from the system.


-mark_for_shutdown

usage: pico -mark_for_shutdown <ec1 localhost true>

Use pico -mark_for_shutdown to signal to the Platform that an EC is scheduled to be shut down. As a result, the Platform will not assign workflows to the EC/ECSA.

Return Codes

Listed below are the different return codes for the pico command:

Code

Description

Code

Description

0

Will be returned if the command was successful, or if arguments are missing.

1

Will be returned if arguments can not be parsed

2

Will be returned if the communication with the Platform fails.

3

Will be returned if checking of user privileges failed, or if pico already exists when trying to add a new pico.

4

Will be returned if the user does not have permission to add or delete picos.

5

Will be returned if an unexpected error occurs.