4.5.5 Executing the commands used in batch applications
The same types of commands used in batch applications, status of batch servers and execution of commands are used as in the case when a scheduling functionality is not used, except the points described below. The differences are:
-
You can execute the cjexecjob command even when you are processing the cjexecjob command on a batch server.
-
When the status of a batch server is any one of the following, and if you execute the cjexecjob, cjkilljob, or cjlistjob command, the KDJE55046-E message is output:
-
When a batch server is starting
-
When a batch server is stopping
-
After the batch server is stopped
-
-
Between the cjexecjob command and the batch server, you can set up a time until a timeout occurs between the cjkilljob or cjlistjob command and CTM. Set up a timeout by using the batch.request.timeout key in usrconf.cfg (option definition file for batch applications). For details on how to set up a timeout, see 4.7.3 Settings for the commands to be used with batch applications.
For the points other than these differences, see 2.3.6 Executing commands used in a batch application.
This subsection describes the countermeasures that you need to take in the case of an abnormal end during the processing of a command used in a batch application, and the points to be considered when executing the commands.
- Organization of this subsection
(1) When a batch server ends abnormally while processing a command
When the cjexecjob, cjkilljob, or cjlistjob command is processing on a batch server, if the batch server ends abnormally, the KDJE55021-E message is output. Confirm the status of the batch server and re-execute the command.
(2) When a CTM daemon or a CTM regulator ends abnormally while processing a command
When the cjexecjob, cjkilljob, or cjlistjob command is processing, if the CTM daemon or the CTM regulator ends abnormally, the KDJE55047-E message is output. This message is output if a process ends abnormally while communicating with the CTM daemon or the CTM regulator, after acquiring the schedule group name from Smart Agent. Confirm the status of the CTM daemon and the CTM regulator, and re-execute the command.
(3) Points to be considered when executing commands
The following points are to be considered when executing the commands:
-
On a machine having multiple IP addresses, if an IP address is not specified in usrconf.cfg (option definition file for batch applications) or in an environment variable, the IP address to which the ORB gateway connects is automatically determined.
-
If you use the scheduling functionality, you execute batch applications on the batch server to which CTM distributes the applications. As a result, you cannot directly execute the cjexecjob command for batch servers.
-
If you execute the cjkilljob command for a standby batch application, CTM reserves the batch application for deletion. The batch application, which is reserved for deletion, is deleted when removed from the schedule queue. In such cases, the batch application, which is reserved for deletion, remains in the schedule queue, so consider the following points:
-
You cannot use a job ID that duplicates with the batch application reserved for deletion.
-
Due to execution of the cjexecjob command, if the number of batch application execution requests exceeds the number that you can register in a schedule queue, the KDJE55060-E message is output and the batch server ends abnormally.
-
-
If you execute the cjkilljob command for a standby batch application, the cjexecjob command does not end until the batch application is taken out from the schedule queue.
-
If no batch server exists, when you execute the cjexecjob, cjkilljob, or cjlistjob command, a message is output and the command ends abnormally. An output message varies according to the specification of the batch.ctm.enabled key in usrconf.cfg (option definition file for batch applications).
-
If true is specified,
The KDJE55010-E or KDJE55046-E message is output.
-
If false is specified,
The KDJE55010-E message is output.
-
-
When executing the cjexecjob command, the command might end abnormally depending on the specification in the Easy Setup definition file and usrconf.cfg (option definition file for batch applications).
-
If true is specified in the ejbserver.ctm.enabled parameter of the Easy Setup definition file, and if false is specified using the batch.ctm.enabled key in usrconf.cfg (option definition file for batch applications), the KDJE55067-E message is output, and the command ends abnormally.
-
If false is specified in the ejbserver.ctm.enabled parameter of the Easy Setup definition file, and if true is specified using the batch.ctm.enabled key in usrconf.cfg (option definition file for batch applications), the KDJE55046-E message is output, and the command ends abnormally.
-
-
When executing the cjlistjob command, if false is specified in the ejbserver.ctm.enabled parameter of the Easy Setup definition file, and if true is specified using the batch.ctm.enabled key in usrconf.cfg (option definition file for batch applications), the command is not received on the batch server. In such cases, the batch application information is not output.