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.

Edit Queued Record (5.2.3)

Related Tpoics

Quick-Reference

Customizing-after-installation

The Edit Queued Record screen (5.2.3) is used to access any record in a queued (multiple record) CICS temporary storage queue, and if authorized, modify it. Data can be displayed in character, vertical hexadecimal, or dump format. File mapping is available on this screen. See USING for more information on file mapping. In addition to data modifications, you can write records to a queue and delete an entire queue.

Access this screen by typing the number 2.3 on the File-Utility-Menu-5, typing 3 on the Temporary-Storage-Menu-5-2, or as described in Transferring Between Screens.

Edit Queued Record Screen (5.2.3)

 --------------------------- EDIT QUEUED RECORD (5.2.3) -------------------C024
COMMAND ===>                                                   SCROLL ===> CSR
MODULE:          CSECT:
VALID COMMANDS: READ  DELETE  WRITE  WRAUX  REWRITE  NEXT
                                                  TYPE: MULTIPLE RECORD QUEUE
QUEUE NAME: XPEDXIVP           SYSID: TSHR       RECLN: 00060  MAX RECLN: 32755
            EDCCECED                             RECFM: V
            77547957           RECORD NUMBER: 00001
DEC-OFFSET: 000000 ADD-OFFSET: ______
----+---10----+---20----+---30----+---40----+---50----+---60
TEST DUP Q ON SHAREDE: 04 JUN 1997 TERM: A011 USER: MYUSRID
----+---10----+---20----+---30----+---40----+---50----+---60

Users can retrieve a particular record from a queue by changing the record number and entering a READ command. Use the READ FIRST command to obtain the first record in the queue, and use READ LAST to retrieve the last. Use the NEXT or READ NEXT command to retrieve the next record in the queue, and PREV or READ PREV to retrieve the previous record in the queue. If the S (Select) line command was used on the Browse-Temporary-Storage-5-2-2 screen, Code Debug CICS automatically displays the selected record.

Input Fields

QUEUE NAME

Name of the temporary storage queues. Because a temporary storage queue is not restricted to displayable characters, this screen displays queue names in vertical hex format.

SYSID

System ID for shared temporary storage queues only. This field must be cleared before a different main or auxiliary queue can be browsed. The SYSID field is only required/displayed when using a temporary storage table (TST).

RECORD NUMBER

Individual record (item) number of queued (multiple record) temporary storage queue records. Enter the record number to be accessed and use the READ command to retrieve the record. If the entered number is higher than the last record in the queue, Code Debug CICS retrieves the last record in the queue.

Valid entries are from 1 to 32767. Specify a hexadecimal value with a leading plus sign (+) and Code Debug CICS converts it to the corresponding decimal value. For example, +10 is converted to decimal 16.

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 value displayed in the RECLN field. When HEX-OFFSET is displayed, the value will be between 0 and the hexadecimal equivalent of the decimal value displayed in the RECLN field. In addition, when DEC-OFFSET is displayed, a hexadecimal value with a leading positive (+) sign may be entered instead, e.g. 80 or +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 is 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.

I/O area

Data from the Code Debug CICS I/O area that can be displayed in four modes. Each mode supports different scrolling commands, as shown in File Utility Scrolling Commands. For more information, see Using the Code Debug CICS I/O Area.

Output Fields

RECLN

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.

MAX RECLN

Maximum record size that can be used for the current CICS temporary storage resource being accessed.

RECFM

Record format. Valid entries are:

  • F: Fixed-length record
  • V: Variable-length record.

Important

The MAX RECLN field contains the maximum record length.

 

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