jpoagtjobshow

Organization of this page

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

Format

jpoagtjobshow
     [-h host-name]
     [-m manager-host-name...|-all]

To Page Top

Description

Outputs the list of event jobs currently being executed by the agent to the standard output file.

This command is executed by the agent execution host. Execution is possible irrespective of the situation of the job execution requesting manager, because only the information held by the agent is displayed. The list is displayed even if there is no match between the agent and the job execution requesting manager.

To Page Top

Execution privileges

In Windows: Administrators privilege

In UNIX: Superuser privilege

To Page Top

Arguments

`-h` `host-name`

Specifies the local host name or logical host name for the agent for which job information is to be displayed. 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. If the JP1_HOSTNAME environment variable is not specified, the system assumes the local host name.

This command will result in an error if the host executing the command does not have any definition for the agent host name.

`-m` `manager-host-name...|-all`

Specifies the manager host name for which you want to display job information among the managers that are sending a request for job execution to the agent specified in the -h option. Specify the name that is output by the hostname command if you are not operating DNS. Use the FQDN format if you are using DNS.

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

You can specify more than one manager host name. In that case, you must separate the manager host names by at least one space character.

Specify -all if you want to cover all manager hosts.

By default, the system assumes the manager host name which is the same as the agent host name. If the local manager does not exit, only the item names are displayed.

No command error occurs if the specified manager host does not have any job information. No command error occurs even if the specified manager host does not have any definition about the manager host name.

To Page Top

Notes

An error will occur if you execute this command when JP1/AJS3 is not running.
An error may occur if you execute this command when JP1/AJS3 is not completely started. Wait for a while and then retry.
Always separate the option and its value by at least one space character.
For an option requiring a value, the character string you specify next to the option is assumed as the value (Example: if you specify -h -m, the system assumes -m as the host name).
You cannot execute more than one of these commands at the same time. After the first command has been executed, execute the second command.
If you stop the JP1/AJS3 service during command execution, you might not receive any response from the command. In that case, you can cancel the command manually.

To Page Top

Return values

0	Normal end
Values other than 0	Abnormal end

To Page Top

Additional information

The job information is output for each manager. The order in which the agent has received requests for job execution determines the order of managers. For example, suppose that agent A has received requests for job execution from three managers: ManagerA, ManagerB, and ManagerC in that order. The job information is output in the order of ManagerA, ManagerB, and ManagerC.

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.

AGENT

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

MANAGER

Shows the manager host name requesting job execution.

Execution ID

Shows the execution ID.

Unit ID

Shows the unit ID.

Scheduler service name

Shows the scheduler service name.

Kind

Shows the type of job.

This command does not distinguish between an ordinary job and a recovery job. This means that even a recovery job is output in the form of an ordinary job.

evwjb:

JP1 event reception monitoring job or JP1 event reception monitoring job for recovery
flwjb:

File monitoring job or file for monitoring job for recovery
mlwjb:

Email reception monitoring job or email reception monitoring job for recovery
mqwjb:

Message queue reception monitoring job or message queue reception monitoring job for recovery
mswjb:

MSMQ reception monitoring job or MSMQ reception monitoring job for recovery
lfwjb:

Log file monitoring job or log file monitoring job for recovery
ntwjb:

Windows event-log monitoring job or Windows event-log monitoring job for recovery
tmwjb:

Execution interval control job or execution interval control job for recovery

Status

Shows the job status.

ready:

Monitoring is in progress (The request from the agent has been sent to each monitoring process.)
not ready:

Monitoring is not in progress.

Request time

Shows the time at which the agent received a request for job execution from the manager.

Watch kind

Shows the type of monitoring.

E:

Event which has started monitoring through registration (event icon)
O:

Event which has started monitoring through registration (start condition icon)
A:

Event which has started monitoring through JP1/AJS3 restart or the like (event icon)
H:

Event which has started monitoring through JP1/AJS3 restart or the like (start condition icon)

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.

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

To Page Top