cjlistjob (Display a list of the batch application information)

Organization of this page

Format
Function
Arguments
Input examples
Return values
Output format
Output examples
Notes

Format

When not using the scheduling functionality

cjlistjob server-name

When using the scheduling functionality

cjlistjob {[ [schedule-group-name]...]|[-all] }

To Page Top

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.

To Page Top

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.

To Page Top

Input examples

When not using the scheduling functionality

cjlistjob MyBatchServer

When using the scheduling functionality

cjlistjob JOBGROUP

To Page Top

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.

To Page Top

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.

To Page Top

Output examples

Information about the batch server with the specified server name

runningΔcom.hitachi.mypackage.batchApp1Δ0x0000000000123456Δ2008/04/14Δ17:27:35.689012

Information about the specified schedule group

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

Legend:

Δ: One-byte space

To Page Top

Notes

In UNIX, Component Container Administrator who started the batch server or the super user can execute the command.

In Windows, execute commands as a user with administrator privileges.
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 of 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.

To Page Top