Hitachi

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


12.4.24 Detailed Definition - [Monitoring Log Files] dialog box

The Detailed Definition - [Monitoring Log Files] dialog box defines the details on monitoring a log file.

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

Organization of this subsection

(1) Items displayed in common

The following figure shows the items displayed in common.

Figure 12‒150: Items displayed in common in the Detailed Definition - [Monitoring Log Files] 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 is Monitoring-Log-Files.

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 to monitor a log file. Use a character string of up to 255 bytes. If the version of the connection-target JP1/AJS3 - Manager is 09-50 or later, you can specify a macro variable instead. The default is a blank.

This item appears as a text box when either of the following applies:

  • The version of JP1/AJS - View or the connection-target JP1/AJS - Manager is earlier than 09-50

  • The unit is being defined under a remote jobnet

Otherwise, this item appears as a combo box in which you can select an execution agent. You can also directly enter an execution agent name into the combo 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 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 an event job, see 7.6 Notes on using 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 Detailed Definition - [Monitoring Log Files] - [Passing Information] dialog box appears. For more information, see 12.4.18 Detailed Definition - [event-job-icon-name] - [Passing Information] dialog box. This button is located at the bottom of the dialog box.

(2) Definition page

The following figure shows the Definition page in the Detailed Definition - [Monitoring Log Files] dialog box.

Figure 12‒151: Definition page in the Detailed Definition - [Monitoring Log Files] dialog box

[Figure]

The following explains the displayed items.

File to be monitored

Specify the name of the log file to be monitored. Use a character string of up to 256 bytes. If the version of the connection-target JP1/AJS3 - Manager is 09-50 or later, you can specify a macro variable instead. You must specify this item.

If you click the Add button, this item is added to the list. You can add up to 8 senders to the list. The default is a blank.

You can click the ... button to select a file name from the dialog box that will appear.

Data to be trapped

Data to be trapped means a character string that is to be monitored by a log file monitoring job. You must specify this item.

You can specify multiple pieces of data to be trapped.

If a character string that matches the defined conditions is written in a log file, the conditions for a log file monitoring job is established.

Specification method

In the Data to be trapped field in the Detailed Definition - [Monitoring Log Files] dialog box, specify the following items.

  1. Drop-down list

    Select AND or OR conditions.

    Select OR to create new conditions. Select AND to add more conditions to the defined conditions.

    The default is AND.

  2. Check box

    Use the check box to select NOT conditions.

    Clear the Not check box to monitor the records that contain the character string specified in the text field. Select the Not check box to monitor the records that do not contain the character string specified in the text field.

    By default, the check box is not selected.

  3. Text field

    Specify the data to be trapped in a regular expression.

    The default is a blank.

    For details about regular expressions in Windows, see the chapter describing installation and setup in the JP1/Base User's Guide.

    For details about regular expressions in UNIX, see your UNIX documentation.

  4. List

    A list of character strings you added in the text field are displayed as described below. The default is a blank.

    - The start defined conditions or defined conditions for which you have set OR conditions are displayed.

    - Defined conditions for which you have set AND conditions are displayed with an indent added.

    - Conditions defined with multiple AND conditions are displayed so that the first (leftmost) condition is followed by AND conditions each of which is on an indented line.

  5. Add button

    If you click the Add button, the data entered in the text field is added to the list.

  6. Insert button

    If you select data in the list and then click the Insert button, the data entered in the text field is inserted before the data selected in the list.

  7. Edit button

    If you select data in the list and then click the Edit button, the Detailed Definition - [Monitoring Log Files] - [Edit] dialog box opens.

    For details, see 12.4.25 Detailed Definition - [Monitoring Log Files] - [Edit] dialog box.

  8. Delete button

    If you select data in the list and then click the Delete button, the data selected in the list is deleted.

Format used to store the data to be trapped

Information specified in the Data to be trapped field is stored as defined data in the following format:

lftpd=[!]"data-to-be-trapped"[:[!]"data-to-be-trapped-2"...];[lftpd=...]
  • A maximum of 2,048 bytes can be stored in the above format.

  • If you select the Not check box,! is added before the data to be trapped.

  • For the initial defined conditions displayed in the list, the specification of AND/OR conditions is invalid. Those conditions are always created as defined data beginning with lftpd=.

  • Defined data for which you have selected AND conditions consists of lftpd=[!]"data-to-be-trapped":[!]"data-2-to-be trapped"...;, and so on.

  • Defined data for which you have selected OR conditions is created in a new format beginning with lftpd=.

  • Data to be trapped that is displayed in the list is enclosed in double quotation marks so that it is stored in the defined data in "data-to-be-trapped" format.

Data lines except log

Data other than log information means a character string that is not to be monitored by a log file monitoring job.

You can specify multiple pieces of data.

If a character string that matches the defined conditions is written in a log file, the conditions for a log file monitoring job is not established because this character string is not subject to monitoring.

Specification method

In the Data lines except log field in the Detailed Definition - [Monitoring Log Files] dialog box, specify the following items.

  1. Drop-down list

    Select AND or OR conditions.

    Select OR to create new conditions. Select AND to add more conditions to the defined conditions.

    The default is AND.

  2. Check box

    Use the check box to select NOT conditions.

    Clear the Not check box not to monitor the records that contain the character string specified in the text field. Select the Not check box not to monitor the records that do not contain the character string specified in the text field.

    By default, the check box is not selected.

  3. Text field

    Specify the data other than log information in a regular expression.

    The default is a blank.

    For details about regular expressions in Windows, see the chapter describing installation and setup in the JP1/Base User's Guide.

    For details about regular expressions in UNIX, see your UNIX documentation.

  4. List

    A list of character strings you added in the text field are displayed as described below. The default is a blank.

    - The start defined conditions or defined conditions for which you have set OR conditions are displayed.

    - Defined conditions for which you have set AND conditions are displayed with an indent added.

    - Conditions defined with multiple AND conditions are displayed so that the first (leftmost) condition is followed by AND conditions each of which is on an indented line.

  5. Add button

    If you click the Add button, the data entered in the text field is added to the list.

  6. Insert button

    If you select data in the list and then click the Insert button, the data entered in the text field is inserted before the data selected in the list.

  7. Edit button

    If you select data in the list and then click the Edit button, the Detailed Definition - [Monitoring Log Files] - [Edit] dialog box opens.

    For details, see 12.4.25 Detailed Definition - [Monitoring Log Files] - [Edit] dialog box.

  8. Delete button

    If you select data in the list and then click the Delete button, the data selected in the list is deleted.

Format used to store data other than log information

Information specified in the Data lines except log field is stored as defined data in the following format:

lfmks=[!]"data-other-than-log-information"[:[!]"data-other-than-log-information-2"...];[lfmks-...]
  • A maximum of 1,024 bytes can be stored in the above format.

  • If you select the Not check box,! is added before the data other than log information.

  • For the initial defined conditions displayed in the list, the specification of AND/OR conditions is invalid. Those conditions are always created as defined data beginning with lfmks=.

  • Defined data for which you have selected AND conditions consists of lfmks=[!]"data-other-than-log-information":[!]"data-other-than-log-information-2"...;, and so on.

  • Defined data for which you have selected OR conditions is created in a new format beginning with lfmks=.

  • Data other than log information that is displayed in the list is enclosed in double quotation marks so that it is stored in the defined data in "data-other-than-log-information" format.

Log file behavior

Select an output format for log file data to be acquired.

Log file behavior

If you click the Set button, the Detailed Definition - [Monitoring Log Files] - [Log file behavior] dialog box appears. Set an output format for the log file. If you select Apply, the settings become valid.

For details, see 12.4.26 Detailed Definition - [Monitoring Log Files] - [Log File Behavior] dialog box.

Supplementary note

In the File to be monitored section, you can specify blanks and symbols. Note, however, that you must specify a backslash (\) before a special character such as double quotation marks (") to use them as normal characters.

Example:

\log\"file

(3) Attributes page

The following figure shows the Attributes page in the Detailed Definition - [Monitoring Log Files] dialog box.

Figure 12‒152: Attributes page in the Detailed Definition - [Monitoring Log Files] dialog box

[Figure]

The following explains the displayed items.

Hold

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

You cannot specify this item if you defined the log file monitoring job in a start condition.

Type

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

You cannot specify this item if you defined the log file monitoring job in a start condition.

Set timeout period

Select whether to set a time-out period for job execution. You can specify No or Yes. The default is No.

You cannot specify this item if you defined the log file monitoring job in 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.

You cannot specify this item if you defined the log file monitoring job in a start condition.

Status after close

If you select Yes for Set timeout period, select the status into which the 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.

You cannot specify this item if you defined the log file monitoring job in 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).

This section appears for the JP1/AJS3 - View, or JP1/AJS2 - View of version 08-50 or later. 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.

You cannot specify this item if you defined the log file monitoring job in a start condition.

Owner

Even if you specify the owner, the owner will become invalid when the event job is executed.

JP1 resource group

Even if you specify the JP1 resource group, the JP1 resource group will become invalid when the event job is executed.

Executed by

Even if you specify the user who executes the job, the user will become invalid when the event job is executed. The user type for the event job is executed by the user authority activating JP1/AJS3.