Job Management Partner 1/Automatic Job Management System 3 Operator's Guide
The Detailed Definition - [Send MSMQ Message] dialog box defines the details on sending an MSMQ message.
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-153 Items displayed in common in the Detailed Definition - [Send MSMQ 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 Send-MSMQ-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 an MSMQ message. Use a character string of up to 255 bytes. The default is a blank.
- Cautionary note
- If you have selected Queueless Agent in Exec. service on the Attributes page, specify the name of an execution host.
(2) Definition page
The following figure shows the Definition page in the Detailed Definition - [Send MSMQ Message] dialog box.
Figure 15-154 Definition page in the Detailed Definition - [Send MSMQ Message] dialog box
The following explains the displayed items.
- Destination
- Specify information about a destination.
- Path name
- Specify the queue to which you want to send a message. Use a character string of up to 259 bytes. You can use a macro variable.
- Be sure to specify either Path name or Queue label. The default is a blank. You can specify the following items.
- Public queue for the local computer
- Private queue for the local computer
- Public queue for the remote computer
- Queue label
- Specify the queue label name for the destination. Use a character string of up to 124 bytes. You can use a macro variable. Be sure to specify either Path name or Queue label. The default is a blank.
- Message
- Specify information about a message.
- Correlation ID
- Specify the correlation ID of the message to be sent. Use a character string of up to 20 bytes.
- You must specify this item. The default is a blank. You can use the following characters.
- Uppercase alphabetic characters (A to Z)
- Numeric characters (0 to 9)
- Message label
- Specify the label of the message to be sent. Use a character string of up to 249 bytes. You can use a macro variable. The default is a blank.
- Application information
- Specify application information about a send message. Use a hexadecimal character string. You can set values of 0 to FFFFFFFF. The default is a blank.
- Time to reach queue
- Specify the delivery limit time for the message to be sent in seconds. The default is -2. If you omit this item, a value of -2 is assumed. You can set the following values.
- -2 (LONG_LIVED)
- -1 (INFINITE)
- 0 to 2,147,483,647
- Time to be received
- Specify how many seconds you want to retain the message. The default is -1. If you omit this item, a value of -1 is assumed. You can set the following values.
- -1 (INFINITE)
- 0 to 2,147,483,647 seconds
- Priority
- Specify the priority of the message to be sent. You can set 0 to 7. The highest priority is 7. The default is 3.
- Delivery
- Select delivery mode for a send message. You can select Express or Recoverable. The default is Express.
- Logging
- Specify which log you want to use after a send message is received. By default, this item is not selected.
- Journal queue
Select whether to put a sent message into the journal queue. By default, this item is not selected.
- Dead-letter queue
Select whether to put a message that could not be sent into the dead-letter queue. By default, this item is not selected.
- Message body
- Clicking the Set button displays the Detailed Definition - [Send MSMQ Message] - [Message Body] dialog box. Specify required settings about the body text of the MSMQ message to send. Selecting Apply validates settings.
- For details, see 15.4.32 Detailed Definition - [Send MSMQ Message] - [Message Body] dialog box.
(3) Attributes page
The following figure shows the Attributes page in the Detailed Definition - [Send MSMQ Message] dialog box.
Figure 15-155 Attributes page in the Detailed Definition - [Send MSMQ Message] dialog box
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.
- 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 Job Management Partner 1/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.
- 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.
Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.