uCosminexus Application Server, Command Reference Guide
![[Contents]](FIGURE/CONTENT.GIF)
![[Index]](FIGURE/INDEX.GIF)
![[Back]](FIGURE/FRONT.GIF)
cjlistjob (Display a list of the batch application information)
Format
- When not using the scheduling functionality
cjlistjob server-name
- When using the scheduling functionality
cjlistjob {[ [schedule-group-name]...]|[-all] }
Function
- When not using the scheduling functionality
- This command outputs the information about the batch application running on batch servers with the specified server name to the standard output.
- The following information is output for batch applications:
- Batch application status
- Batch application name
- PRF root AP information
- Running time of the cjexecjob command
- When using the scheduling functionality
- This command outputs the information about the batch applications running on the specified schedule group to the standard output. This information is output in one line.
- The following information is output for batch applications:
- Schedule group name
- Batch application status
- Batch application name
- PRF root AP information
- Running time of the cjexecjob command
- Start waiting time, start running time, or forceStopping reception time of batch applications
- Job ID
- Name of the server executing batch applications
You can specify the options for the cjlistjob command using usrconf.cfg (option definition file for batch applications). You search the directories storing usrconf.cfg (option definition file for batch applications), in the following order:
- Directory specified in the environment variable (CJBATCHUSRCONFDIR)#
- Directory in which the cjlistjob command is executed
# In the environment variable (CJBATCHUSRCONFDIR), you specify the directory as the absolute path.
Arguments
- server-name
- Specifies the name of the batch server executing batch application for which the information is to be acquired.
- For the server name, you specify a case-sensitive character string in conformity with the server name that you have specified when you set up the batch server.
- schedule-group-name
- Specifies the name of the schedule group executing the batch application for which the information is to be acquired. You can specify multiple schedule groups demarcated with commas (,).
- Note that you can omit the schedule group name. If the schedule group name is omitted, batch.schedule.group.name within usrconf.cfg (option definition file for batch applications) of this command is used. JOBGROUP is the default value.
- -all
- Specify this argument to display the information about batch applications in all the schedule groups that are used by batch servers on the same machine.
Input examples
- When not using the scheduling functionality
cjlistjob MyBatchServer
- When using the scheduling functionality
cjlistjob JOBGROUP
Return values
- 0:
- The information about batch applications is displayed in a list.
- 1:
- An attempt to display the batch application information in a list has failed.
Output format
- When the scheduling functionality is not used
batch-application-status batch-application-name PRF-root-AP-information running-time-of-the-cjexecjob-command
|
- When using the scheduling functionality
schedule-group-name batch-application-status batch-application-name PRF-root-AP-information running-time-of-the-cjexecjob-command start-waiting-start-running-or-force-stopping-reception-time-of-the-batch-applications job-ID name-of-the-batch-server-executing-the-job
|
- Legend:
: One-byte space
The following is the description of output items:
- schedule-group-name
- Displays names of the schedule groups to which the execution requests of batch applications are distributed.
- batch-application-status
- Displays the following status for batch applications:
- Batch application is running: running
- Batch application is waiting: waiting
- Batch application is force stopping: forceStopping
- batch-application-name
- Displays the class name of the Java application specified by the cjexecjob command.
- PRF-root-AP-information
- Displays the communication number of the PRF root application as 16-digit hexadecimal with 0x as the first digit.
- running-time-of-the-cjexecjob-command
- Displays the running time of the cjexecjob command in the following format:
yyyy/mm/dd hh:mm:ss.ssssss
|
- Legend:
: One-byte space
- yyyy/mm/dd
hh:mm:ss.ssssss: Year/Month/Day Hours/Minutes/Seconds
- start-waiting-start-running-or-force-stopping-reception-time-of-the-batch-applications
- This item is output when the scheduling functionality is used.
- Displays the batch application start time, waiting time, or the forceStopping reception time in the following format, depending on the batch application status:
yyyy/mm/dd hh:mm:ss.ssssss
|
- Legend:
: One-byte space
- yyyy/mm/dd
hh:mm:ss.ssssss: Year/Month/Day Hours/Minutes/Seconds
- The following table describes the batch application status and corresponding displayed time:
Table 3-4 Batch application status and displayed time
| Batch application status |
Displayed time |
Description |
| waiting |
Waiting start time |
Time when batch applications entered the schedule queue |
| running |
Running start time |
Time when batch applications left the schedule queue |
| forceStopping |
ForceStopping reception time |
Time when batch applications in the schedule queue were reserved for the forceStopping |
- job-ID
- Displays the job ID of batch application.
- name-of-the-batch-server-executing-the-job
- This item is output when the scheduling functionality is used.
- Displays the name of the batch server executing batch applications. Displays "-", if batch application is in the waiting status.
Output examples
Notes
- In UNIX, Component Container Administrator who started the batch server or the super user can execute the command.
In Windows, a user having administrator privileges can execute the command.
In Windows Server 2012, Windows Server 2008, Windows 8, Windows 7, or in Windows Vista, a user having administrator privileges can execute commands.
- If there are no batch applications, the command will terminate normally without displaying any information.
- When using the scheduling functionality, you can specify the timeout settings for the list display of the batch application information using usrconf.cfg (option definition file for batch applications). For the settings when using the scheduling functionality, see 4. Scheduling Batch Applications in the uCosminexus Application Server Expansion Guide.
- When using the scheduling functionality, you can specify the settings for the communication timeout of the cjlistjob command or the batch server using usrconf.cfg (option definition file for batch applications). The default value 0 leads to infinite waiting.
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.