Description
Checks whether patch distribution, patch application, parameter settings, or script execution are running.
Synopsis
swrba_admin pi-list [-user <User ID>] [-password <Password>] [-startedafter <yyyy-mm-dd>] [-startedbefore <yyyy-mm-dd>] [-state <Process definition state>] [-piid <Process Instance ID>] [-appid <Automated operation process group ID>] |
Options
This option searches for process instances and displays them in a list. If no parameters are set, it performs a search for all instances. The parameters that can be specified are displayed below:
You can exclude the user ID from the parameters by omitting -user. If the user ID is not configured, you will be required to enter the user ID after the execution of the command.
You can set the password as a parameter by specifying -password. If the password is not configured, you will be required to enter the password after the execution of the command.
The following table shows the initial values for User ID and Password. If these values have been changed from the initial values, use the new values.
User ID | swrbaadmin |
Password | systemwalker#1 |
Specify the start date of the period when the process is running in the following format:
yyyy-mm-dd
Specify the end date of the period when the process is running in the following format:
yyyy-mm-dd
When only -startedafter is specified, the period from the specified date till the current date is searched. When only -startedbefore is specified, the period till the specified date is searched. An error occurs if a format other than the one specified above is used, or if the relationship between the start date and the end date is invalid.
Specify the process instance ID. If this option is not specified, all instances are searched.
Specify the process definition state. If this option is not specified, all states are searched. Specify "running" to search running instances.
Specify the automated operation process group ID to be searched. Specify "cfmgApplication" as the ID.
Return value
Return value | Meaning |
|---|---|
0 | Normal termination |
1 | Parameter error |
2 | Authentication error |
3 | Error on the admin server |
4 | Internal error |
5 | Privilege error |
6 | File input/output error |
Not fixed | Forced termination |
Command location
Admin server
[Windows]
%SWRBA_HOME%\bin |
Note that %SWRBA_HOME% contains the installation directory for Systemwalker Runbook Automation included with Systemwalker Software Configuration Manager.
[Linux]
/opt/FJSVswrbam/bin |
Privilege required/execution environment
[Windows]
Administrator privileges are required. When using Windows Server 2008 or later, run as an administrator.
This command can be executed on the admin server.
[Linux]
This command can only be executed by the system administrator (superuser).
This command can be executed on the admin server.
Notes
This command cannot be executed at the same time as other commands. An exclusive control error will occur if a command is executed while another command is executing.
Execution Result/Output Format
FSP_SW/RB-A_BASE: INFO: 02000: Start pi-list.Option:pi-list -state running -appid cfmgApplication
ProcessInstanceID ProcessInstanceName Status Initiator
171003 patch application request_171003_rhel57ja64_L0705_20(VL2PEOQ9WA0001)
running manage
171318 patch application request _171003_rhel57ja64_L0705_20(VL2PEOQ9WA0001)
running manage
Searched for three instances.
FSP_SW/RB-A_BASE: INFO: 02001: pi-list has terminated normally. Option:pi-list -state running -appid cfmgApplication Code:0