Executing commands used in a batch application

This subsection describes the execution of commands used in a batch application.

You can use the following three types of commands in a batch application:

cjexecjob command (batch execution command)
This command is used for executing a batch application.
cjkilljob command (batch forced stop command)
This command is used to forcefully stop a running batch application.
cjlistjob command (batch list display command)
This command is used for displaying a list of batch application information.

You might not be able to execute these commands depending on the state of the batch server. The following subsections describe batch server states and execution of commands. For details on the commands, see 3.3 Commands used in a batch application in the uCosminexus Application Server Command Reference Guide.

Organization of this subsection: (1) States of batch server and execution of commands; (2) If a batch server terminates abnormally during a command processing; (3) Points to be considered when executing commands

(1) States of batch server and execution of commands

You might not be able to execute the cjexecjob, cjkilljob, and cjlistjob commands depending on the state of a batch server. The following figure shows the state of a batch server and availability of the commands for execution.

Figure 2-10 States of a batch server and availability of commands for execution

[Figure]

You cannot execute the cjexecjob, cjkilljob, and cjlistjob commands after stopping a batch server. The KDJE55010-E message is output.

If another command is processing on the batch server, you might not be able to execute the commands, depending on the type of the command. The following table describes availability of the commands for execution, when a command is processing on a batch server.

Table 2-7 Availability of the commands for execution when a command is processing on a batch server

Command to be executed		Command under processing
Command to be executed		cjexecjob	cjkilljob	cjlistjob	Server management command
cjexecjob		N	N	Y	Y
cjkilljob		Y	N	Y	Y
cjlistjob		Y	Y	Y	Y
Server management command	cjstoprar	N	N	Y	^#1
Server management command	Command other than cjstoprar	Y	Y	Y	^#1
cjstopsv or cmx_stop_target		Y^#2	Y^#2	Y^#2	^#1
cjdumpsv		Y	Y	Y	Y

Legend:

Y: Can be executed

N: Cannot be executed

[Figure] : Varies as per command type

#1: Operations vary as per the type of the server management command. For details, see 3.2.2 Exclusive access control of server management commands in the uCosminexus Application Server Application Setup Guide.

#2: In the case of a running batch application, outputs the KDJE55033-I message and waits for the end of the batch application.

(2) If a batch server terminates abnormally during a command processing

(3) Points to be considered when executing commands

Consider the following when executing commands:

If there is no batch server when executing the cjexecjob, cjkilljob, or cjlistjob command, the command outputs the KDJE55010-E message and ends abnormally.
If the ejbserver.ctm.enabled parameter in the Easy Setup definition file and the value specified in the batch.ctm.enabled key in usrconf.cfg (option definition file for batch application) do not match, an error might occur when executing the following commands:
- When executing the cjexecjob command, the command might output the KDJE55067-E message and end abnormally.
- When executing the cjlistjob command, the batch application information might not be output.

2.3.6 Executing commands used in a batch application

(1) States of batch server and execution of commands

(2) If a batch server terminates abnormally during a command processing

(3) Points to be considered when executing commands