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.

Browse CICS Dataset (5.1.2)

Related Topics

Customizing-after-installation

Quick-Reference

The Browse CICS Data set screen (5.1.2) allows access to all records in a CICS defined data set in browse mode. Data can be displayed in either character or vertical hexadecimal format. If authorized, you can delete records from a data set. Under CICS TS, various locked messages may be displayed if the file’s read integrity is defined as consistent or repeatable. RLS LOCKED will be displayed if a record has a Record Level Sharing (RLS) retained lock, and RECORD BUSY will be displayed if a record has an RLS active lock. The CMD field is not available for RLS locked records within the file. Per CICS conventions, the actual record is displayed for those defined as uncommitted, even if the record has a lock.

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.2 on the File-Utility-Menu-5, typing 2 on the CICS Data sets Menu (5.1), or from any screen by typing =5.1.2 in the COMMAND field.

Browse CICS Data set Screen (5.1.2)

 ----------------------------- BROWSE CICS DATASET (5.1.2) ----------------C024
 COMMAND ===>                                                   SCROLL ===> CSR
 MODULE:          CSECT:

                        ACCESS METHOD: VSAM       TYPE: KSDS
 FILENAME: DBUGPRF                                              MAX RECLN: 04089
                                         RECFM: V KEYLN: 00008        RKP: 00000
KEY FIELD: ----+--8
            ALTKEYS
            CDEDCEE4
           13325820

 LINE COMMANDS:  D (Delete)  S (Select)

 CMD RECLN  ----+---10----+---20----+---30----+---40----+---50----+---60----+-->
  _  01348  ALTKEYS PAGE......C CK..TRAP ON                        TRAP_ON .TRAP
  _  01348  ALTKEYSRPAGE......K KK..TRAP ON                        TRAP_ON .TRAP
  _  01341  ANDREWS HALF......K KK..TRAP ON                        TRAP_ON .TRAP
    00010  RLS LOCKED
  _  01341  C.GREEN CSR ......M MK..TRAP ON                        TRAP_ON .TRAP
  _  01341  CHANDLERCSR ......N NK..TRAP ON                        TRAP_ON .TRAP
  _  04081  COWSILL CSR ......K KD..TRAP ON                        TRAP_ON .TRAP
  _  04081  CWX0003 CSR ......N DD..TRAP ON                        TRAP_ON .TRAP
  _  01341  CWX0010.CSR ......K KK..TRAP ON                        TRAP_ON .TRAP

Scroll through the file using the UP, DOWN, TOP and BOTTOM commands.

Use the FIND and RFIND commands to search for data. Code Debug CICS ends a search when it locates the requested data or after searching 100 records. Use RFIND to continue searching. The 100 record limit can be changed in the FILE_UTILITY_MAX_NOT_FOUND_COUNT parameter of the Code Debug CICS global parameters. Use the LEFT and RIGHT commands to scroll left and right through the data.

Input Field

CMD

Line command entry field. Valid entries are:

  • D (Delete): Deletes the record from the data set. Valid only if you are authorized and the DELETE service request is specified in the FCT or CSD.
  • S (Select): Selects the record for display and update and transfers to the Edit CICS Data set Record screen (5.1.3).

Important

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 which 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 parameter of the Code Debug CICS global parameters.

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 first, or top, displayed record. To display a new record, use the scrolling commands or change the data in this field.

Output Fields

ACCESS TYPE

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.

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.

RECLN

Current length of each record or of the locked message for RLS locked records.

I/O area

Data from the Code Debug CICS I/O area that can be displayed in two modes. Each mode supports different scrolling commands, as shown in File Utility Scrolling Commands. The I/O area is where RLS lock messages are displayed if Code Debug is unable to read a record. Note that the record key is not available when a file browse operation encounters a locked record. For more information, see Using the Code Debug CICS I/O Area.

 

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