Hitachi

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


12.4.32 Detailed Definition - [Send MQ Message] dialog box (compatible with version 7)

The Detailed Definition - [Send MQ Message] dialog box defines the details on sending messages through a message queue. The system sends messages to the TP1/Message Queue or MQServer message queue.

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‒168: Items displayed in common in the Detailed Definition - [Send MQ Message] 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 Send-MQ-Message.

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 or execution agent group name to be assigned the task of sending messages through a message queue. Use a character string of up to 255 bytes. 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 have selected Queueless Agent in Exec. service on the Attributes page, specify the name of an execution host.

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

(2) Definition page

The following figure shows the Definition page in the Detailed Definition - [Send MQ Message] dialog box.

Figure 12‒169: Definition page in the Detailed Definition - [Send MQ Message] dialog box

[Figure]

The following explains the displayed items.

Destination

Specify a destination for message queuing.

Queue

Specify the name of the queue to be sent a message. Use a character string of up to 48 bytes.

You must specify this item. The default is a blank. You can set one of the following queues:

  • Local queue

  • Alias local queue

  • Remote queue

  • Alias remote queue

  • Dynamic queue

  • Transmission queue

Queue manager

Specify a queue manager name using an MQ character string of up to 48 bytes. The default is a blank. You can use the following characters for the MQ character string.

  • Letters (A to Z and a to z)

  • Numbers (0 to 9)

  • Periods (.)

  • Forward slashes (/)

  • Underscores (_)

  • Percent signs (%)

Model queue

Specify the name of the model queue to be sent a message using an MQ character string of up to 48 bytes. The default is a blank. You can use the following characters for the MQ character string.

  • Letters (A to Z and a to z)

  • Numbers (0 to 9)

  • Periods (.)

  • Forward slashes (/)

  • Underscores (_)

  • Percent signs (%)

Connection queue manager

Specify the name of the queue management program to be connected for transmission. Use an MQ character string of up to 48 bytes. The default is a blank. You can use the following characters for the MQ character string.

  • Letters (A to Z and a to z)

  • Numbers (0 to 9)

  • Periods (.)

  • Forward slashes (/)

  • Underscores (_)

  • Percent signs (%)

Message

Specify the settings about the message to send.

Correlation ID

Specify the correlation ID of the message to be sent. Use a character string of up to 24 bytes.

Be sure to set this item. You can use the uppercase alphabetic characters (A to Z) and numeric characters (0 to 9). The default is a blank.

Message ID

Specify the message ID of the message to be sent to the message queue. Use a character string of up to 24 bytes. Be sure to set this item. You can use uppercase alphabetic characters (A to Z) and numeric characters (0 to 9). The default is a blank.

Retain

Specify whether to retain the message until a restart occurs. By default, this item is not selected.

Detailed setting

If you click the Set button, the Detailed Definition - [Send MQ Message] - [Detailed Settings] dialog box appears. Set details on the message. If you select Apply, the settings become valid.

For details, see 12.4.33 Detailed Definition - [Send MQ Message] - [Detailed Setting] dialog box.

Platform

Select the platform on which you want to execute jobs. You can select PC or UNIX. The default is PC.

  • PC

    A Windows environment is used.

    In 08-00, no Windows platforms are available.

  • UNIX

    A UNIX environment is used.

(3) Attributes page

The following figure shows the Attributes page in the Detailed Definition - [Send MQ Message] dialog box.

Figure 12‒170: Attributes page in the Detailed Definition - [Send MQ Message] 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.

Type

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

Exec. service

Select the target service. You can specify Standard or Queueless Agent. The default is Standard. Note that this text box appears for connection target JP1/AJS3 - Manager, or JP1/AJS2 - Manager 07-00-/C or later.

Set timeout period

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

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.

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.

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 the following items.

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