Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Automatic Job Management System 3 Administration Guide


5.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

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

Table 5‒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)

JP1/AJS3 Console window

You can check the execution results of a specific jobnet in this window.

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 Server 2012 or Windows Server 2008, if the installation folder is in the default folder or 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) (for 64-bit Windows)

In Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:
  • 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 Windows Server 2003:
  • 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 Server 2012 or Windows Server 2008, if the installation folder is in the default folder or 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) (for 64-bit Windows)

In Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:
  • JP1/AJS3-Manager-installation-folder\log\ajs-host-log1.log

  • JP1/AJS3-Manager-installation-folder\log\ajs-host-log2.log

In Windows Server 2003:
  • 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 Job Management Partner 1/Automatic Job Management System 3 Operator's Guide.

For details about the ajsshow command options and output examples, see ajsshow in 2. Commands in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 1.

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

(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.1 Status levels of jobnets, jobs, and jobnet connectors in the manual Job Management Partner 1/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 Job Management Partner 1/Automatic Job Management System 3 Command Reference 1.

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:

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 5‒1: Monitoring in the Jobnet Monitor window

[Figure]

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 15.3.38 Monitor Details - [Jobnet] dialog box in the Job Management Partner 1/Automatic Job Management System 3 Operator's Guide, or 15.14.6 Notes on the Jobnet Monitor window in the Job Management Partner 1/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 5‒2: Monitoring in the Daily Schedule and Monthly Schedule windows

[Figure]

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 Job Management Partner 1/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 15.7.7 Detailed Schedule dialog box in the Job Management Partner 1/Automatic Job Management System 3 Operator's Guide, or 15.14.7 Notes on the Daily/Monthly Schedule window in the Job Management Partner 1/Automatic Job Management System 3 Operator's Guide.