Hitachi

JP1 Version 12 JP1/Client Process Automation Configuration and Administration Guide


4.3.5 Procedure to use the function

This section describes the procedure needed to use the AJS3 linkage function.

It is assumed that setups are completed on the relevant hosts. For details on how to set up, see 2.3.3 Configurations for the AJS3 linkage function, and 3.3 Configurations.

Organization of this subsection

(1) Procedure to be done on the CPA host

You need to register a job for the AJS3 linkage function on the CPA host.

Register a job as follows:

  1. In the Job Design View, select the Exec. on event tab, and then click the New button.

    In the displayed Job exec. on event dialog box, create a job for the AJS3 linkage function.

    [Figure]

    The following table lists and describes the setting items for the job you create.

    Item

    Description

    Job name

    Enter a name of the job.

    Details

    Enter a description.

    Execute action

    From the list of action items, select and apply an action item or an action flow you created.

    Event

    From the list of execution condition items, select and apply Monitor the linkage from JP1AJS3.

  2. Click the Register button.

    Register the job executed on event. When the event is registered, AJS3 starts event monitoring.

    [Figure]

  3. Click the Checking the status icon.

    Open the Checking the status dialog box. In the Checking the status dialog box, ensure that the job is in the Monitoring for event state. Then, your configuration on the CPA host is completed.

    [Figure]

    Important

    If you re-execute a job, a new history of executed jobs is added for that job.

    The Start time box displays the time at which the job was re-executed, whereas the End time box displays a copy of the end time of the job that was re-executed.

(2) Procedure to be done on the AJS3 - View host

You need to add a custom job for CPA linkage to a jobnet on AJS3 - View, and register it for execution.

The following procedure shows how to set up.

  1. In the Jobnet Editor window, open the jobnet to which you want to add a custom job for CPA linkage.

    Open the jobnet you want to edit, and select Exclusive edit.

  2. From the icon list, drag the icon of the custom job for CPA linkage and drop it onto the map area.

    This displays the Define Details - [Custom Job] dialog box.

  3. Define attributes such as the unit name.

    For Exec-agent, specify the execution agent name of the host where CPA Option for AJS3 is installed. The value is the name of the execution agent of the AJS3 - Agent host if CPA Option for AJS3 is installed on AJS3 - Agent.

    For details on execution agents, see the manual JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide.

    When a CPA job ends with a warning, you might want to change the state of the custom job for CPA linkage to Ended with warning as well. In this case, specify End judgment in the Definition page as follows:

    • Rule: Judgment by threshold

    • Warning: 0

    • Abnormal: 1

  4. Click the Details button.

    When the Detailed definition window appears, enter the following information.

    [Figure]

    Setting

    Setting value

    Client host name

    The name of the host where CPA is installed

    Job name

    The name of the job for the AJS3 linkage function registered on CPA

    The host names must be resolved between the host specified for the client host name and the execution host corresponding to the execution agent name of the custom job for CPA linkage. Network environment is also required for such hosts to communicate with each other.

  5. In the Define Details - [Custom Job] dialog box, click the OK button.

(3) Executing the job on AJS3

In 4.3.5(2) Procedure to be done on the AJS3 - View host, you defined a custom job for CPA linkage in AJS3 - View. The custom job is triggered by a schedule or event that is registered for execution in AJS3.

When the custom job for CPA linkage is executed, it, in turn, triggers the CPA job you registered. After the CPA job finishes, the execution result (normal end, abnormal end, or others) is applied to the custom job for CPA linkage. Finally, you access the execution result details of the custom job for CPA linkage to view the execution log.

Important
  • The execution results of individual actions and action flows that are called from the jobs executed on CPA need to be checked on CPA.

  • If the custom job for CPA linkage is forced to terminate on AJS3, the execution program remains running rather than ends on CPA. If you want to terminate the execution program, run the cpajobstop command on the CPA host.

  • Custom jobs for CPA linkage are controlled by the setting on the maximum number of concurrently executable jobs in AJS3.