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:

  1. Directory specified in the environment variable (CJBATCHUSRCONFDIR)#
  2. 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[Figure]batch-application-name[Figure]PRF-root-AP-information[Figure]running-time-of-the-cjexecjob-command

When using the scheduling functionality

schedule-group-name[Figure]batch-application-status[Figure]batch-application-name[Figure]PRF-root-AP-information[Figure]running-time-of-the-cjexecjob-command[Figure]start-waiting-start-running-or-force-stopping-reception-time-of-the-batch-applications[Figure]job-ID[Figure]name-of-the-batch-server-executing-the-job

Legend:
[Figure]: 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[Figure]hh:mm:ss.ssssss

Legend:
[Figure]: One-byte space
yyyy/mm/dd[Figure]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[Figure]hh:mm:ss.ssssss

Legend:
[Figure]: One-byte space
yyyy/mm/dd[Figure]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 statusDisplayed timeDescription
waitingWaiting start timeTime when batch applications entered the schedule queue
runningRunning start timeTime when batch applications left the schedule queue
forceStoppingForceStopping reception timeTime 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

Information about the batch server with the specified server name

running[Figure]com.hitachi.mypackage.batchApp1[Figure]0x0000000000123456​[Figure]2008/04/14[Figure]17:27:35.689012

Information about the specified schedule group

JOBGROUP[Figure]running[Figure]com.hitachi.mypackage.batchApp1[Figure]0x0000000000123456​[Figure]2008/04/14[Figure]17:27:35.689012[Figure]2008/04/14[Figure]17:27:37.182777[Figure]HOGE[Figure]MybatchServer1
JOBGROUP[Figure]running[Figure]com.hitachi.mypackage.batchApp2[Figure]0x0000000002345678​[Figure]2008/04/14[Figure]17:45:20.123456[Figure]2008/04/14[Figure]19:21:56.271354[Figure]102[Figure]MybatchServer2
JOBGROUP[Figure]running[Figure]com.hitachi.mypackage.batchApp3[Figure]0x0000000034567890​[Figure]2008/04/14[Figure]18:15:54.397890[Figure]2008/04/14[Figure]19:00:00.123447[Figure]#5HL390_G3CV7[Figure]MybatchServer3
JOBGROUP[Figure]waiting[Figure]com.hitachi.mypackage.batchApp4[Figure]0x0000000045678901​[Figure]2008/04/14[Figure]18:30:24.125444[Figure]2008/04/14[Figure]18:30:25.006220[Figure]112345[Figure]-

Legend:

[Figure]: One-byte space

Notes