jpomanjobshow

Organization of this page

Format
Description
Execution privileges
Arguments
Notes
Return values
Additional information
Output example

Format

jpomanjobshow
     [-h host-name]
     [-F service-name]
     [-a execution-agent-name...|-all]

To Page Top

Description

Outputs a list of the event jobs currently being executed in the manager to the standard output file.

This command is executed on a host for executing a manager. Regardless of the situation of the job execution agent, you can execute this command because only the information maintained by the manager is displayed. The list is displayed even if versions of the manager and the job execution agent do not match.

To Page Top

Execution privileges

In Windows: Administrators privilege

In UNIX: Superuser privilege

To Page Top

Arguments

`-h` `host-name`

Specify the local host name or logical host name for the manager which is to display job information. You can specify a character string of 1 to 255 bytes.

By default, the system assumes the logical host name specified by the JP1_HOSTNAME environment variable. Without the JP1_HOSTNAME environment variable, however, the system assumes the local host name.

This command results in an error if the command executing host does not have any no definition about the specified manager host name.

`-F` `service-name`

Specify the name of the scheduler service for which you want to display job information.

You can specify a character string of 1 to 30 bytes.

If you omit this option, the system assumes the default scheduler service name.

`-a` `execution-agent-name...|-all`

Of the execution agents on which the manager specified in the -h option requested to execute jobs, you can display job information for only a specific execution agent. To do this, specify the execution agent name in the -a option.

You can specify a character string of 1 to 255 bytes.

You can specify more than one execution agent name. In that case, the execution agent names must always be separated by at least one space character.

Specify -all if you want to cover all execution agents.

If this option is omitted, the default execution agent is assumed.

If the specified execution agent has no job information or does not even exist, the command does not result in an error.

To Page Top

Notes

Before you execute this command, make sure that the JP1/AJS3 service is running.
Do not execute this command while JP1/AJS3 is starting.
Always separate an option and its value by at least one space character.
For options that require a value to be specified, the string specified next to the option is assumed to be a value. For example, if you enter -h -a, -a is assumed as the logical host name specified for the -h option.
You cannot execute more than one these commands at the same time. After the first command has been executed, execute the second command.
If the default scheduler service name assumed when the -F option is omitted is not registered, the command outputs message KAVT8351-E to standard error output and terminates abnormally. Make sure that the default scheduler service name is registered on the command execution host, and then execute the command again.

You can reference the -h option in the command line to identify the host where the command will be executed.

To Page Top

Return values

0	Normal end
Values other than 0	Abnormal end

To Page Top

Additional information

No error occurs even if you execute this command when JP1/AJS3 scheduler service is not running. If there is a job scheduled to be executed next, the information about the job is output.

To Page Top

Output example

Here is an example of file output, together with what the output means.

[Figure]

The following shows the meaning of the output.

COMMAND START TIME

Indicate the date and time at which the command starts its execution in the format of YYYY/MM/DD HH:MM:SS.

MANAGER

Shows the manager host name (either the local host name or the logical host name).

AJSPATH

Shows the jobnet name in the /root-jobnet-name/jobnet-name/ format.

JOBNAME

Shows the job names in the jobnet.

AGENT

Shows the execution agent name.

This item is the name of the execution agent on which job execution is requested.

Execution ID

Shows the execution ID.

Unit ID

Shows the unit ID.

Scheduler service name

Shows the scheduler service name.

Kind

Shows the types of jobs.

evwjb: JP1 event reception monitoring job
revwjb: JP1 event reception monitoring job for recovery
flwjb: File monitoring job
rflwjb: File monitoring job for recovery
mlwjb: Email reception monitoring job
rmlwjb: Email reception monitoring job for recovery
mqwjb: Message queue reception monitoring job
rmqwjb: Message queue reception monitoring job for recovery
mswjb: MSMQ reception monitoring job
rmswjb: MSMQ reception monitoring job for recovery
lfwjb: Log file monitoring job
rlfwjb: Log file monitoring job for recovery
ntwjb: Windows event-log monitoring job
rntwjb: Windows event-log monitoring job for recovery
tmwjb: Execution interval control job
rtmwjb: Execution interval control job for recovery

Information

Shows job information.

unreported:

The execution agent has not received the request for starting job execution because, for example, the execution agent is not running (it is registered with the unreported information file).
(No indication)

There is no information to be reported (nothing is registered in the unreported information file).

In this case, any of the following statuses could exist:

- Nothing is contained in the unreported information file because nothing was processed by the manager.

- An error occurred while the unreported information file was being accessed.

- A request has arrived at the execution agent correctly.

You can use the jpoagtjobshow command to see whether the job has been actually executed in the agent.

COMMAND END TIME

Indicates the date and time at which the command ends its execution in the format of YYYY/MM/DD HH:MM:SS.

The YYYY/MM/DD HH:MM:SS part means calendar-year/month/day hours:minutes:seconds.

To Page Top