4.1.1 Checking the execution results of jobnets

To determine whether applications (jobnets) automated in JP1/AJS3 operate normally, you must check the execution results of the jobnets.

Organization of this subsection

(1) Checking the execution results of a jobnet
(2) Monitoring the status of jobnet connectors and checking execution results

(1) Checking the execution results of a jobnet

The following table describes the methods you can use to check the execution results of a jobnet.

Table 4‒1: Methods for checking the execution results
Method	Description
JP1/AJS3 - View windows	If the icon for a jobnet or job in the following windows is displayed in the color indicating normal end (light green by default), the jobnet or job has ended normally: JP1/AJS3 - View window (summary monitoring window) Jobnet Monitor window (definition window format) Monthly Schedule window (calendar format) Daily Schedule window (chart format)
Web GUI windows	JP1/AJS3 - Web Console allows users to check the execution statuses of jobs and jobnets by using a web browser.
User application	Original applications (user applications) developed or implemented by using the API released by JP1/AJS3 can be used to check the execution statuses of jobs and jobnets.
Command	`ajsshow` command This command outputs information about a jobnet or a job registered for execution to the standard output file. The information output includes the previous execution results, current status, and next execution schedule.
Log data	Information such as whether a jobnet has ended normally or abnormally is output to a JP1/AJS3 scheduler log file. Use a tool such as a text editor to check the log file. The default locations of these log files are as follows: When a log file is output for each scheduler service: In Windows, if the installation folder is the default installation folder or is in a folder protected by the system: `%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\schedule\scheduler-service-name\ajs-log1.log` `%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\schedule\scheduler-service-name\ajs-log2.log` The default for `%ALLUSERSPROFILE%` is `system-drive\ProgramData`. A folder protected by the system is a folder in any of the following: - `system-drive\Windows` - `system-drive\Program Files` - `system-drive\Program Files (x86)` In Windows, if the installation folder is other than the above: `JP1/AJS3-Manager-installation-folder\log\schedule\scheduler-service-name\ajs-log1.log` `JP1/AJS3-Manager-installation-folder\log\schedule\scheduler-service-name\ajs-log2.log` In UNIX: `/var/opt/jp1ajs2/log/schedule/scheduler-service-name/ajs-log1.log` `/var/opt/jp1ajs2/log/schedule/scheduler-service-name/ajs-log2.log` When a log file is output for each host: In Windows, if the installation folder is the default installation folder or is in a folder protected by the system: `%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\ajs-host-log1.log` `%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\ajs-host-log2.log` The default for `%ALLUSERSPROFILE%` is `system-drive\ProgramData`. A folder protected by the system is a folder in any of the following: - `system-drive\Windows` - `system-drive\Program Files` - `system-drive\Program Files (x86)` In Windows, if the installation folder is other than the above: `JP1/AJS3-Manager-installation-folder\log\ajs-host-log1.log` `JP1/AJS3-Manager-installation-folder\log\ajs-host-log2.log` In UNIX: `/var/opt/jp1ajs2/log/ajs-host-log1.log` `/var/opt/jp1ajs2/log/ajs-host-log2.log`
Windows event log or syslog	When the `NETSYSLOG` environment setting parameter is set, information indicating whether a jobnet has ended normally or abnormally is output to the Windows event log or to syslog. The following describes the event IDs, facilities, and message IDs for normal end and abnormal end of a jobnet. Jobnet normal-end event Event ID: 30261 Facility: `LOG_DAEMON` Message ID: KAVS0261-I Jobnet abnormal-end event Event ID: 30262 Facility: `LOG_DAEMON` Message ID: KAVS0262-E

If a jobnet has ended abnormally, either check whether a recovery unit has been executed or re-execute the jobnet.

For details about the items displayed in the windows and the operating procedures, see the JP1/Automatic Job Management System 3 Operator's Guide.

For details about the ajsshow command options and output examples, see ajsshow in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

For details about the scheduler log output format, see C. Log Information in the manual JP1/Automatic Job Management System 3 Troubleshooting.

To Page Top

(2) Monitoring the status of jobnet connectors and checking execution results

You can use JP1/AJS3 - View and commands to check the execution status and execution results of jobnet connectors and connection-destination jobnets.

For details about the execution status of jobnet connectors and the jobnets connected by the connectors, see 6.1 Status levels of jobnets, jobs, and jobnet connectors in the manual JP1/Automatic Job Management System 3 Overview. For details about how to use a command to check the execution status and execution results, see the manual JP1/Automatic Job Management System 3 Command Reference.

The following describes how to monitor jobnet connectors and connection-destination jobnets in JP1/AJS3 - View.

You can use the following windows to check the execution status and execution results of jobnet connectors and connection-destination jobnets:

Jobnet Monitor window
Daily Schedule window
Monthly Schedule window

The following provides an overview of monitoring with each window.

(a) Monitoring in the Jobnet Monitor window

You can use the Jobnet Monitor window to monitor the execution status and check the execution results for a jobnet connector the same way as for ordinary jobnets. This information is displayed in the same image that was displayed when you defined the jobnets. Double-clicking the jobnet connector in the map area opens another Jobnet Monitor window, where you can check the connection-destination jobnet. When the jobnet connector is selected, you can also choose View and then Jobnet for Destination to open the following windows in which you can check the jobnet:

Daily Schedule (Hierarchy/All Jobs) window
Monthly Schedule window
Jobnet Monitor window

The following figure shows the monitoring available in the Jobnet Monitor window.

Figure 4‒1: Monitoring in the Jobnet Monitor window

In addition, you can choose View and then Detailed Information to display the Monitor Details - [icon-name] dialog box. If you display this dialog box for a jobnet connector, you can check the execution ID of the connection-destination jobnet. If you display this dialog box for the connection-destination jobnet, you can check the execution ID and the setting for the execution order control method for the jobnet connector.

Supplementary notes

If the connection-destination jobnet does not have an execution schedule or has a shutdown status, you cannot display the Jobnet Monitor window for the jobnet.
If the jobnet connector and the connection-destination jobnet are on hosts in different user authentication blocs, you need to log in to the appropriate host to perform the following operations:
- To display the connection-destination jobnet from the jobnet connector, log in to the host on which the connection-destination jobnet resides.
- To display the Monitor Details dialog box for the jobnet connector, log in to the host on which the connection-destination jobnet resides.
- To display the Monitor Details dialog box for the connection-destination jobnet, log in to the host on which the connection-destination jobnet resides.
For details, see 12.3.38 Monitor Details - [Jobnet] dialog box in the JP1/Automatic Job Management System 3 Operator's Guide, or 12.14.6 Notes on the Jobnet Monitor window in the JP1/Automatic Job Management System 3 Operator's Guide.

(b) Monitoring in the Daily Schedule window and Monthly Schedule window

In the tree area of the Daily Schedule or Monthly Schedule window, select a jobnet connector and choose View and then Jobnet for Destination. The following windows, in which you can then check the connection-destination jobnet, appear:

Daily Schedule (Hierarchy/All Jobs) window
Monthly Schedule window
Jobnet Monitor window

The following figure shows the monitoring available in the Daily Schedule and Monthly Schedule windows.

Figure 4‒2: Monitoring in the Daily Schedule and Monthly Schedule windows

In addition, you can choose View and then Detailed Information to display the Detailed Schedule dialog box that shows the detailed schedule information. If you display this dialog box for the jobnet connector, you can check the execution ID of the connection-destination jobnet. If you display this dialog box for the connection-destination jobnet, you can check the execution ID and the setting for the execution order control method for the jobnet connector.

For details about each operating method, see the JP1/Automatic Job Management System 3 Operator's Guide.

Supplementary notes

If the connection-destination jobnet connected by the connector does not have an execution schedule or has been blocked, you cannot display the Jobnet Monitor window for the jobnet.
If the jobnet connector and the connection-destination jobnet are on hosts in different user authentication blocs, you need to log in to the appropriate host to perform the following operations:
- To display the connection-destination jobnet from the jobnet connector, log in to the host on which the connection-destination jobnet resides.
- To display the Detailed Schedule dialog box for the jobnet connector, log in to the host on which the connection-destination jobnet resides.
- To display the Detailed Schedule dialog box for the connection-destination jobnet, log in to the host on which the jobnet connector resides.
For details, see 12.7.7 Detailed Schedule dialog box in the JP1/Automatic Job Management System 3 Operator's Guide, or 12.14.7 Notes on the Daily/Monthly Schedule window in the JP1/Automatic Job Management System 3 Operator's Guide.

To Page Top