Job Management Partner 1/Automatic Job Management System 3 Operator's Guide
The Detailed Definition - [Receive MQ Message] dialog box defines the details for monitoring message queue reception.
This dialog box contains the items displayed in common, and also contains the following pages:
- Definition page
- Attributes page
- Organization of this subsection
- (1) Items displayed in common
- (2) Definition page
- (3) Attributes page
(1) Items displayed in common
The following figure shows the items displayed in common.
Figure 15-125 Items displayed in common in the Detailed Definition - [Receive MQ Message] dialog box
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 Receive-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 host to be assigned the task for monitoring message queue reception. Use a character string of up to 255 bytes. The default is a blank.
- Cautionary note
- 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 Job Management Partner 1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
- Pass Info button
- Specify information to be inherited by the subsequent job or jobnet. If you click the Pass Info button, the Detailed Definition - [Receive MQ Message] - [Passing Information] dialog box appears.
- For more information, see 15.4.15 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 - [Receive MQ Message] dialog box.
Figure 15-126 Definition page in the Detailed Definition - [Receive MQ Message] dialog box
The following explains the displayed items.
- Monitoring options
- Specify conditions for monitoring messages received in the message queue.
- Correlation ID
- Specify the correlation ID of the message to be monitored. Use a character string of up to 24 bytes.
- You must specify 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 monitored. Use a character string of up to 24 bytes. You can use the uppercase alphabetic characters (A to Z) and numeric characters (0 to 9). The default is a blank.
- Execution environment
- Specify an operating environment for monitoring message queue reception.
- Message input queue
- Specify the name of the queue you want to monitor for message reception. Use an MQ character string of up to 48 bytes. You must specify this item. The default is a blank. You can use the following characters for the MQ character string. To use MQSeries linkage, specify the default queue name for the queue manager.
- Letters (A to Z and a to z)
- Numbers (0 to 9)
- Periods (.)
- Forward slashes (/)
- Underscores (_)
- Percent signs (%)
- Model queue
- Specify the model queue name of the queue you want to monitor for message reception. 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. To use MQSeries linkage, specify the default queue name for the queue manager.
- Letters (A to Z and a to z)
- Numbers (0 to 9)
- Periods (.)
- Forward slashes (/)
- Underscores (_)
- Percent signs (%)
- Message storage file
- Specify the name of the file where you want to store received messages. Use a character string of up to 256 bytes. The default is a blank.
- You can click the ... button to select a file name from the dialog box that will appear.
- You must use the full path name when specifying a file name.
- A stored file is not automatically deleted. Delete an unnecessary file.
(3) Attributes page
The following figure shows the Attributes page in the Detailed Definition - [Receive MQ Message] dialog box.
Figure 15-127 Attributes page in the Detailed Definition - [Receive MQ Message] dialog box
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.
- 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.
- 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.
- 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 Job Management Partner 1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
- 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 system uses the user authority activating JP1/AJS3 to execute the event job.
Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.