jpomanjobshow
- Organization of this page
Format
jpomanjobshow
[-h host-name]
[-F service-name]
[-a execution-agent-name...|-all]
Description
Outputs a list of the event jobs and the custom 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.
Execution privileges
In Windows: Administrators privilege
In UNIX: Superuser privilege
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.
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.
Return values
|
0 |
Normal end |
|
Values other than 0 |
Abnormal end |
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.
Output example
Here is an example of file output, together with what the output means.
![[Figure]](GRAPHICS/ZO020135.GIF)
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
-
cewjb: Custom event job
-
rcewjb: Custom event 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.