Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Update MQ Queue Message (5.6.3)


The Update MQ Queue Message screen (5.6.3) allows a message to be added to an MQ queue. Data can be displayed in character, vertical hexadecimal, or dump format. File mapping is available on this screen. For more information on file mapping, see USING.

Access this screen by typing the number 3 on the MQ-Menu-5-6, typing 6.3 on the File-Utility-Menu-5, typing the S line command on the MQ-Queue-List-5-6-1 screen, typing the UPDATE command on the Browse-MQ-Queue-Message-5-6-2 screen, or as described in Transferring Between Screens.

Update MQ Queue Message Screen (5.6.3)

 ----------------------- UPDATE MQ QUEUE MESSAGE (5.6.3) ------------------C024
COMMAND ===>                                                   SCROLL ===> CSR
 MODULE:          CSECT:
VALID COMMANDS: PUT  DEFAULT

 QUEUE NAME : XD06.DEFXMIT.QUEUE                               DEPTH: 000000002


DEC-OFFSET: 000000 ADD-OFFSET: ______   REC-LENGTH: 001168
----+---10----+---20----+---30----+---40----+---50----+---60----+---70----+--->
XQH ....CSQ4SAMP.MAILMGR.ACMEJET0                       XD40
----+---10----+---20----+---30----+---40----+---50----+---60----+---70----+--->

Input Fields

QUEUE NAME

Name of the queue that is accessed. Queues can be aliases, that is, point to another queue. In this case, when a message is displayed, Code Debug CICS displays the entered alias queue name above the name of the queue that is accessed.

HEX/DEC-OFFSET

Displays the current offset within the column’s data. This value is always relative to 0. The data display begins at this offset. This field may be modified. The value entered must be in the range of 0 to the decimal displayed in the REC-LENGTH field. When DEC-OFFSET is displayed, a hexadecimal value with a leading positive (+) sign may be entered instead. For example, 80 and +50 are equivalent.

Important

The HEX/DEC-OFFSET field is protected (non-modifiable) when the USING command is in effect.

ADD-OFFSET

Use with the HEX/DEC-OFFSET field to provide a new starting offset into the I/O area. The entered value is added to the value in the HEX/DEC-OFFSET field to yield a new starting offset value. If the entered value has a leading minus sign (-), the entered value is subtracted from the value in the HEX/DEC-OFFSET field.

If the display mode is HEX DUMP mode, only hexadecimal values can be entered. If the display mode is character (HEX OFF) or vertical hexadecimal (HEX ON), the value can be entered either in decimal or hexadecimal. This can be done by preceding the value with a plus sign (+). To add a negative offset, precede the value by a minus sign (-). A value preceded by a minus sign is treated as decimal when in HEX ON or HEX OFF mode and as hexadecimal when in HEX DUMP mode.

Important

The ADD-OFFSET field is protected (non-modifiable) when the USING command is in effect.

Output Fields

VALID COMMANDS

List of primary commands available for use against this queue.

REC-LENGTH

Current length of the I/O area. The length may exceed the maximum record size for a particular resource. In this case, only the data up to the maximum record length is used. The I/O area may be truncated if any I/O command is issued.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*