Hitachi

JP1 Version 13 JP1/Automatic Job Management System 3 Operator's Guide


12.4.42 Define Details - [Custom Event] dialog box

The Define Details - [Custom Event] dialog box defines the details of a custom event job.

This dialog box contains the items displayed in common, and also contains the following page:

Organization of this subsection

(1) Items displayed in common

The following figure shows the items displayed in common.

Figure 12‒192: Items displayed in common in the Define Details - [Custom Event] dialog box

[Figure]

The following explains the items displayed in common.

Unit name

Specify a unit name. Use a character string of up to 30 bytes. The default depends on the defined custom event job.

Comment

Specify a comment for the unit. Use a character string of up to 80 bytes. The default is a blank.

Exec-agent

Specify the execution agent name to be assigned the task of custom event job execution. Use a character string of up to 255 bytes. You can also specify a macro variable in this field. The default is a blank.

This item is a combo box. One of the values can be selected from a drop-down list or any string can be directly entered in the box. The content of the list component of the combo box differs depending on whether execution agent profiles are enabled, and the contents of those profiles.

When execution agent profiles are disabled

The list is empty.

When execution agent profiles are enabled
  • If the specified job is associated with an execution agent profile

    The list displays the execution agents permitted for the specified job.

  • If the specified job is not associated with an execution agent profile

    If the upper-level unit is associated with an execution agent profile, the list displays the execution agents permitted for the upper-level unit.

    If the upper-level unit is not associated with an execution agent profile, the list will be empty.

For details about execution agents, see 5.1.1 Execution agents in the manual JP1/Automatic Job Management System 3 Overview.

Cautionary notes
  • If you leave this text box blank, the system inherits the specification of the upper-level jobnet.

    If an execution agent group for an upper-level jobnet has been specified, the system uses the execution agent group as the execution agent.

    Because custom event jobs do not support an execution agent group, explicitly specify an execution agent name in Exec-agent. For details about the operation performed if an execution agent group is specified for a custom event job, see 7.10 Notes on using custom event jobs in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

  • When you copy and paste a cell in Excel, a space may be appended to the end of the pasted text. In such a case, delete the space.

Pass Info button

Specify information to be inherited by the subsequent job or jobnet. If you click the Pass Info button, the Define Details - [Custom Event] - [Passing Information] dialog box appears. For more information, see 12.4.18 Detailed Definition - [icon-name] - [Passing Information] dialog box. This button is at the bottom of the dialog box.

(2) Definition page

The following figure shows the Definition page in the Define Details - [Custom Event] dialog box.

Figure 12‒193: Definition page in the Define Details - [Custom Event] dialog box

[Figure]

The following explains the displayed items.

Define detailed info.

If you click the Details button, the window for defining a program to be linked appears. For details about the items displayed in this window, see the program documentation.

(3) Attributes page

The following figure shows the Attributes page in the Define Details - [Custom Event] dialog box.

Figure 12‒194: Attributes page in the Define Details - [Custom Event] dialog box

[Figure]

The following explains the displayed items.

Hold

Specify whether to place the unit in the hold status in advance. You can select No or Yes. The default is No.

This item is unavailable when the custom event job is defined as a start condition.

Type

Set the unit type to Normal or Recovery. The default is Normal.

This item is unavailable when the custom event job is defined as a start condition.

Set timeout period

Specify whether to place the unit in the hold status in advance. You can select No or Yes. The default is No.

This item is unavailable when the custom event job is defined as a start condition.

Timeout period

If you select Yes in Set timeout period, specify a time-out period in minutes. You can set 1 to 1,440 minutes. The default is a blank.

This item is unavailable when the custom event job is defined as a start condition.

Status after close

If you select Yes for Set timeout period, select the status into which the custom event job is to be placed after the timeout period elapses. You can specify Killed, Ended normally, Ended with warning, and Ended abnormally. The default is Killed.

This item is unavailable when the custom event job is defined as a start condition.

Delayed end

Specify whether to monitor delayed end of jobs based on time required for execution. Select the Time-required-for-execution check box to monitor delayed end of jobs. The check box is not selected by default.

When you select the Time-required-for-execution check box, specify the time required for execution for a job from 1 to 1,440 (in minutes).

For details about cautionary notes on monitoring of delayed end of jobs based on time required for execution, see 5.1.3 End delay monitoring based on time-required-for-execution in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

This item is unavailable when the custom event job is defined as a start condition.

Owner

Specify the owner of the unit. Use a character string of up to 31 bytes. The default is the login JP1 user name. Note that if the upper-level unit-attribute inheritance function has been set for the upper-level jobnet, the default is the owner of the upper-level unit.

JP1 resource group

Specify a JP1 resource group name. Use a character string of up to 63 bytes. You can specify alphanumeric characters and underscores (_). The default is the JP1 resource group name of the upper-level unit. If you specify a blank, you are not authorized to access this group.

Executed by

Select the user who executes the job. The default is User who registered. You can select either of the following.

  • User who registered

    The JP1 user who registered the job executes the job.

  • User who owns

    The JP1 user who owns the job executes the job.

    You must perform user mapping on the host where you want to execute the job so that the specified user is converted to a OS user.

    If the execution-user fixing function is configured for the upper-level unit, the execution user conforms to the unit-attribute profile regardless of the contents of this field.