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 CICS Dataset Record (5.1.3)

Related Topics

Customizing-after-installation

Quick-Reference

The Edit CICS Data set Record screen (5.1.3) allows access to any record in a CICS-defined as well as authorized modifications to the accessed record. Normal security rules and the security provided via the Code Debug CICS global parameters are followed. 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, records can be written to or deleted from a data set .

Important

Under CICS TS, RLS locked records cannot be read or updated unless their read integrity is uncommitted. Uncommitted read integrity enables reading, but not updating. If a file’s read integrity is consistent or repeatable, several situations may occur when trying to read a locked record. If the record has a retained lock, the locked response will be returned. If the record has an active lock, Code Debug will keep waiting for the record to be released. If it is not released within the time limit specified in the global parameter SECONDS_TO_WAIT_FOR_DBFL_TO_COMPLETE, the message WAITED TOO LONG, POSSIBLE LOCKOUT will be displayed. In this case, the user should try to read the record again at a later time. The Browse CICS Data set screen (5.1.2) can be used to verify this by checking for the recordbusy response.

This screen only allows access to CICS data sets in the CICS FCT or CSD. To access temporary storage queues, transient data sets, DL/I databases, Db2 tables, or MQ queues exit this screen and select the desired option from the File-Utility-Menu-5.

Access this screen by typing the number 1.3 on the File Utility Menu (5), typing 3 on the CICS Data sets Menu (5.1), or as described in Transferring Between Screens.

Edit CICS Data set Record Screen (5.1.3)

 ----------------------- EDIT CICS DATASET RECORD (5.1.3) -----------------C024
COMMAND ===>                                                   SCROLL ===> CSR
MODULE: CWDEMCB2 CSECT: CWDEMCB2          COMPILED: 28 MAY 2003 - 11.11.29
VALID COMMANDS: READ  NEXT  PREV  CLOSE
                       ACCESS METHOD: VSAM        TYPE: KSD
FILENAME: DBUGEMP                                RECLN: 00080  MAX RECLN: 00080
DEC-OFFSET: 000000 ADD-OFFSET: ______   RECFM: F KEYLN: 00005        RKP: 00000
KEY FIELD: ----5
           00020
           FFFFF
           00020
----+---10----+---20----+---30----+---40----+---50----+---60----+---70----+--->
00020EMPLOYEE #20   .<00020000
FFFFFCDDDDECC47FF44404FFFFFFFF4444444444444444444444444444444444444444444444444
00020547368550B200000C000200000000000000000000000000000000000000000000000000000
----+---10----+---20----+---30----+---40----+---50----+---60----+---70----+--->


Important

If authorized, you can change data in a record by typing directly over it. Once modified, use the REWRITE command to update the file.

While at a break/abend, do not attempt to access records that have been read for update. Reads and writes are done by a separate transaction that Code Debug CICS starts. If this transaction does a CICS call and CICS does not complete the call in 14 seconds, Code Debug CICS instructs the transaction to cancel once control returns to it. A message is displayed that the request was not completed. The wait interval of 14 seconds can be changed in the SECONDS_TO_WAIT_FOR_DBFL_TO_COMPLETE global parameter.

Warning

When adding records to a keyed data set, change the KEY FIELD on the screen along with the actual key data in the record.

Input Fields

FILENAME

Name of the data set as defined in the CICS FCT or CSD and used in CICS file control calls to access the data set.

KEY FIELD

Key of the current record. To retrieve a record, type the key into this field and enter a READ command. A generic read may be performed by typing the partial generic key in the KEY field, pressing the Erase EOF key — not the spacebar — to clear the remainder of the key, typing READ in the COMMAND field, and pressing Enter. To create a new record, type in the key and enter the WRITE command.

Warning

For a WRITE command, the key data must also be entered in the record data itself at the correct offset. The correct offset is shown in the RKP field.

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  For more information, see Using the Code Debug CICS I/O Area.

Output Fields

ACCESS METHOD

Type of access used in the access method for the data set. Valid entries are:

  • DA-UNB: BDAM direct access, unblocked data set
  • DA-REL: BDAM blocked data set, deblocked by relative record
  • DA-KEY: BDAM blocked data set, deblocked by key
  • KSDS: VSAM key-sequenced data set
  • RRDS: VSAM relative record data set
  • ESDS: VSAM entry-sequenced data set.

Important

KSDS, RRDS, and ESDS are only displayed when VSAM data sets are in an OPEN status.

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 file 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.

KEYLN

Key length.

RKP

Relative key position — an offset into the record in which key is found.

 

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