5.3.8 Starting user-defined receptions
This subsection describes the prerequisites and methods for starting the user-defined reception.
- Organization of this subsection
(1) Prerequisites
To start the user-defined reception, the following conditions must be fulfilled:
-
The HCSC server is in active status.
-
For a user-defined reception whose calling destination is fixed, a business process in which the reception has been defined is already started.
For details on how to check HCSC server status, see "5.3.15 Checking the HCSC server information".
(2) Starting methods
You can start the user-defined reception, by the following methods:
(a) When using screens
The procedure for starting the user-defined reception by using the operating environment screen is as follows:
-
In the tree view, double click the user-defined reception to be started.
The information of the double clicked user-defined reception is displayed in the Operations page of the editor area.
For details on the the Operations page of the user-defined reception, see "4.4 Operations Page" in "Service Platform Reference Guide".
-
Check the contents displayed in the Operations page, and click the [Start] button.
A dialog confirming the start of the user-defined reception is displayed.
-
Check the contents displayed in the dialog, and click the [OK] button.
The process for starting the user-defined reception is initiated. Log during startup process is displayed in the console view.
If you click the [Cancel] button, the system returns to the Operations page without executing startup process.
When the process for starting the user-defined reception is complete, a dialog showing the execution result is displayed.
-
Check the dialog showing the execution result.
- If the start process is successful:
-
Click the [OK] button to return to the Operations page.
In the Operations page, the status of user-defined reception changes to [Start] status. Also, the [Start] button is disabled and the [Stop] button is enabled.
- If the start process fails:
-
Contents of the error are displayed in the dialog. Take appropriate action, by checking the message ID provided in the detail information.
(b) When using commands
To start a user-defined reception, execute the cscrcptnstart command or csccompostart command in the operating environment.
Use the cscrcptnstart and csccompostart commands in the following cases:
-
cscrcptnstart command
-
Use this command to start receptions in a batch.
-
Use this command to start all user-defined receptions deployed on the HCSC server in a batch.
You can also start the user-defined receptions of each cluster in a batch. Note that you cannot start only a specific user-defined reception.
-
Use this command to start the user-defined reception in the operating environment in which the corresponding repository exists.
-
-
Csccompostart command
-
Use this command to start service adapters, business processes, and user-defined receptions in a batch.
You cannot start only user-defined receptions in a batch.
-
Use this command to start a specific user-defined reception deployed on the HCSC server.
You can also start a specific user-defined reception for each cluster.
-
Use this command to start the user-defined reception in the operating environment in which the corresponding repository exists.
-
The description of how to execute each command is as follows:
- When using the cscrcptnstart command
-
Execute the cscrcptnstart command in the operating environment.
For details on the cscrcptnstart command, see "cscrcptnstart (Starting standard receptions and user-defined receptions)" in "Service Platform Reference Guide ".
Execution format of the cscrcptnstart command is as follows:
- To start the user-defined receptions deployed on all HCSC servers within the cluster, in a batch (for each cluster)
-
Execute the command by specifying the cluster name.
The user-defined receptions deployed on all HCSC servers within the cluster specified in the -cluster option are started in a batch (even all the non-started standard receptions are concurrently started).
cscrcptnstart -user <login user ID> -pass <login password> -cluster <cluster name>
If you want to start only the user-defined reception without starting the standard reception, specify the -userdef option.
cscrcptnstart -user <login user ID> -pass <login password> -cluster <cluster name> -userdef
- To start user-defined receptions deployed on the HCSC server in a batch (for each HCSC server)
-
Execute this command by specifying the HCSC server name.
The user-defined receptions deployed on the HCSC server, specified in the -csc option are started (non-started standard receptions are also started concurrently).
cscrcptnstart -user <login user ID> -pass <login password> -csc <HCSC server name>
If you want to start only the user-defined reception without starting the standard reception, specify the -userdef option.
cscrcptnstart -user <login user ID> -pass <login password> -csc <HCSC server name> -userdef
- When using the csccompostart command
-
Execute the csccompostart command in the operating environment.
For details on the csccompostart command, see "csccompostart (Starting HCSC components)" in "Service Platform Reference Guide".
Execution format of the csccompostart command is as follows:
- To start user-defined receptions deployed on all HCSC servers within the cluster, in a batch (for each cluster)
-
Execute the command by specifying the cluster-name and the -all option.
The user-defined receptions deployed on all HCSC servers within the cluster, specified in the -cluster option are started in a batch (all the non-started service adapters and business processes are also started concurrently).
csccompostart -user <login user ID> -pass <login password> -cluster <cluster name> -all
- To start user-defined receptions deployed on the HCSC server in a batch (for each HCSC server)
-
Execute this command by specifying the HCSC server name and the -all option.
The user-defined receptions deployed on the HCSC server specified in the -csc option are started (all the non-started service adapters and business processes are also started concurrently).
csccompostart -user <login user ID> -pass <login password> -csc <HCSC server name> -all
- To start a specific user-defined reception deployed on all HCSC servers within the cluster
-
Execute the command by specifying the cluster-name and the reception ID of the user-defined reception.
csccompostart -user <login user ID> -pass <login password> -cluster <cluster name> -name <reception ID of the user-defined reception>
- To start a specific user-defined reception deployed on the HCSC server
-
Execute the command by specifying the HCSC server name and the reception ID of user-defined reception.
csccompostart -user <login user ID> -pass <login password> -csc <HCSC server name> -name <reception ID of the user-defined reception >
(3) Note
When you attempt to start the SOAP reception, even if the operation you perform from the GUI or CLI normally ends, initialization might sometimes fail. If initialization of the SOAP reception fails, KDJW40002-E is output to the message log. Confirm that this message has not been output.