Managing Ensemble Productions - InterSystems Documentation
Managing Ensemble Productions - InterSystems Documentation
Managing Ensemble Productions - InterSystems Documentation
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Message List<br />
Color<br />
White and pale blue,<br />
in alternating rows<br />
Indication<br />
These messages are OK.<br />
8.1.1 Message Details<br />
If you select a message in an <strong>Ensemble</strong> Management Portal page and click Details, additional message information displays<br />
in the lower portion of the screen.<br />
You can display message details by clicking Details next to the message displayed on the following pages of the <strong>Ensemble</strong><br />
Management Portal:<br />
• [<strong>Ensemble</strong>] > [Messages]<br />
• [<strong>Ensemble</strong>] > [Messages] > [Visual Trace] (click on a specific message in the trace)<br />
• [<strong>Ensemble</strong>] > [Queues] > [Contents]<br />
• [<strong>Ensemble</strong>] > [Maintenance] > [Suspended]<br />
Details of the selected message display in the lower portion of the page. The left side of the display shows the entire contents<br />
of the Message Header. Fields include:<br />
• Type — The message type, Request or Response.<br />
• — The object identifier for the message header. Whenever a message header and message body are combined<br />
together as a message, the ObjectId value in the header is used to identify the combined message object. As a result,<br />
this value is the same as the message ID listed in the Message Browser and other pages in the <strong>Ensemble</strong> Management<br />
Portal.<br />
• Priority — The priority of the message relative to others in the queue: RealTime (1), High (2), Normal (3), or Low (4).<br />
The <strong>Ensemble</strong> messaging engine assigns priority values to messages automatically, in the course of normal processing,<br />
for its own use. Message priority cannot be programmed into a message class or configured in any way. Priority values<br />
are based in part on whether the message is synchronous (High) or asynchronous (Normal). Also, messages that start<br />
or stop a production are assigned greater priority than other types of message.<br />
• Invocation — The style of invocation for message: Queue or Inproc.<br />
Inproc means the message is formulated, sent, and delivered in the same process in which it was created. The job is<br />
not released to the sender’s pool until the message is delivered to the target.<br />
Queue means the message is created in one job, then placed on a queue, at which time the original job is released.<br />
Later, when the message is processed, a different job is allocated for the task.<br />
• TimeCreated — The message creation time stamp. For Queue messages, this is the time when <strong>Ensemble</strong> placed this<br />
message on the queue. For Inproc messages, this is the time when <strong>Ensemble</strong> called the Send method.<br />
• TimeProcessed — The message usage time stamp. For Queue messages, this is the time when <strong>Ensemble</strong> took the<br />
message off the queue to be processed. For Inproc messages, this is the time when <strong>Ensemble</strong> began processing the<br />
message. For Inproc messages, TimeProcessed will be very close to TimeCreated.<br />
• Status — Indicates the status of the message within its normal life-cycle: Created, Queued, Delivered, Deferred,<br />
Completed, Discarded, or Suspended. If there is a request-response pair, the value does not indicate an overall status<br />
for the pair; a request may end up with a different Status from its corresponding response.<br />
A message in transit has a Status of Created, until it finds its place on a queue, when it becomes Queued. A message<br />
that reaches its destination is at first Delivered, then finally Completed. An asynchronous response is Discarded if it<br />
arrives after the timeout period for the corresponding request expired. A message response can been Deferred by a<br />
business operation to be sent later on; when a Deferred message is finally sent, it has a Status of Completed.<br />
<strong>Managing</strong> <strong>Ensemble</strong> <strong>Productions</strong> 73