cscpireexec (Re-executing process instances)

Format

cscpireexec [-h]
 -user login-user-ID
 -pass login-password
 -csc HCSC-server-name
 {-processname business-process-definition-name
 |-processnamefile business-process-definition-file-name
 |-all}
 [{-processid process-instance-identifier
 |-processidfile name-of- file-containing-process-instance-identifiers
 |-targetcsc name-of-HCSC-server-to-be-re-executed
 [-status activity-status-that-forms-re-execution-condition]}]
 [-encoding encoding-name]
 [-summary]

To Page Top

Function

Re-executes a cancelled process instance according to specified conditions.

This command can also re-execute only the process instances executed on a specified HCSC server. In such cases, the process instances to be re-executed can be specified in accordance with the activity status.

The process instances to be re-executed are as follows:

• Process instances where the invoke service activity status is Executing or Error

• Process instances where the standby activity status is Executing

• Process instances where the scope activity status is Executingwait, Error, or Completedwait

• Process instances where the response activity status is Completedwait

By setting up default values for mandatory options, such as the login user ID, in the HCSC-Manager command definition file, you can omit the specification of these values in this command.

For details on how to use this command, see 6.1.5 Re-executing process instances in the Service Platform Setup and Operation Guide.

To Page Top

Arguments

To Page Top

Examples of input

(1) To re-execute a process instance with a process instance identifier 11111 and the business process definition name PC Lease

cscpireexec -user admin -pass admin -processidfile process_id.txt -csc HCSC -processnamefile processname.txt

Contents of process_id.txt: 11111

Contents of processname.txt: PC Lease

(2) To re-execute the service components with the business process definition name PC Lease in a batch

cscpireexec -user admin -pass admin -csc HCSC -processname "PC Lease"

(3) To re-execute all the target process instances in a batch

cscpireexec -user admin -pass admin -csc HCSC -all

(4) To re-execute the process instances executed on HCSC server CSCSrv2 and in the Executing status, in a batch

cscpireexec -user admin -pass admin -csc CSCSrv1 -all -targetcsc CSCSrv2 -status executing

(5) To re-execute the process instances executed on HCSC server CSCSrv2 and in the statuses Executing, executingwait, and completedwait, in a batch

cscpireexec -user user1 -pass password -csc CSCSrv1 -all -targetcsc CSCSrv2 -status executing,executingwait,completedwait

To Page Top

Display format

(1) When -summary is not specified

ProcessID,ProcessDefinitionName,Result,ErrorMessage
PI-identifier,business-process-definition-name,invocation-result,error-information
PI-identifier,business-process-definition-name,invocation-result,error-information
 ... 

Description

Display item	Content	Description
ProcessID	PI identifier	Indicates the process instance identifier.
ProcessDefinitionName	Business process definition name	Indicates the business process definition name.
Result	Invocation result	Indicates the invocation result. One of the following values is displayed: Success: Invocation ended normally Failure: Invocation failed
ErrorMessage	Error information	Indicates the error information, which is displayed as follows, depending on the contents of the Result column (invocation result): Success: "" Failure: error-information

These display items represent the information for one record in the CSCBP_cluster-name_PROCESS table. For details, see Appendix C.1 Table information about process instance execution log management in the uCosminexus Service Platform Setup and Operation Guide.

(2) When -summary is specified

The KEOS52290-I message, indicating the successful re-execution cases and failed re-execution cases, is displayed. For details, see 2.22 Messages from KEOS50000 to KEOS59999 in the uCosminexus Service Platform Messages.

To Page Top

Return values

Return value	Meaning
0	The command terminated normally.
1	The command terminated abnormally.
2	A communication timeout occurred.
3	An exclusion error occurred.
9	An error occurred when checking the execution permission.

To Page Top

Notes

• You can use this command only when you use a database.

• If many process instances are to be re-executed, the re-execution process might take some time to finish.

• If no process instances are to be re-executed, the command ends abnormally.

To Page Top