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.

CICS Dataset List (5.1.1)

Related Topics

Customizing-after-installation

Quick-Reference

The CICS Data set List screen (5.1.1) is used to view a list of data sets that can be accessed from this CICS system as defined in the file control table (FCT or CSD). In addition to the data set name, the screen displays the method used to access the data set, the current status of the data set, and the service requests that can be used to access the file. Note that Code Debug CICS attempts to reposition the display based upon the last data set accessed. To position the display at another entry, use the scrolling commands or the LOCATE command.

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

CICS Data set List Screen (5.1.1)

 -------------------------- CICS DATASET LIST (5.1.1) ---------------------C024
COMMAND ===>                                                   SCROLL ===> CSR
MODULE: CWDEMCB2 CSECT: CWDEMCB2          COMPILED: 28 MAY 2003 - 11.11.29

LINE COMMANDS:  B (Browse)  S (Select)

             ACCESS         CURRENT      SERVICE                    REMOTE
CMD   NAME   METHOD TYPE    STATUS       REQUESTS       OPTIONS   ID     NAME
-------------------------------------------------------------------------------
 _  CCABDUMP  VSAM          CLO ENA REA UPD ADD BRO DEL
 _  DBUGEMP   VSAM          CLO ENA REA         BRO
 _  DBUGPRF   VSAM  KSDS    OPE ENA REA UPD ADD BRO DEL     SHR
 _  DBUGSQL   VSAM          CLO ENA REA UPD ADD BRO DEL
 _  DFHCSD    VSAM          CLO UNE REA UPD ADD BRO DEL RLS SHR
 _  PLAAUTH   VSAM          CLO ENA REA UPD ADD BRO DEL
 _  PLACGBL   VSAM          CLO ENA REA UPD ADD BRO DEL
 _  PLAYDT1   VSAM  KSDS    OPE ENA REA UPD ADD BRO DEL     SHR
 _  PLAYDT2   VSAM          CLO ENA REA UPD ADD BRO DEL
 _  PLAYHLP   VSAM          CLO ENA REA         BRO
 _  SLSD1201  VSAM  RRDS    OPE ENA REA         BRO         SHR
 _  SLSF001   VSAM  RRDS    OPE ENA REA         BRO         SHR
 _  SLSF002   VSAM  RRDS    OPE ENA REA         BRO         SHR
    **END**


Important

Authorized users can modify the current status and add or delete service requests (allow update, remove delete, etc.). To change the service request, the data set first must be closed and disabled.

Input Fields

CMD

Line command entry field. Valid entries are:

If a service request browse has not been defined for the data set, then B functions as S.


    • S (Select): Display and update a single record from a data set with the Edit CICS Data set Record screen (5.1.3).

CURRENT STATUS

Status of the data set as it exists for CICS. Valid entries are:


    • CLO: Closes the data set for access by CICS.
    • OPE: Opens the data set for access by CICS.
    • DIS: Disables access to the data set by CICS.
    • ENA: Enables access to the data set by CICS.
    • UNE: Disables access to the data set by CICS. This status is set when a CLOSE is done for a data set.

Important

Authorized users can overtype these values with the first letter of the request (for example, O for OPE, C for CLO).

These values cannot be overtyped for SLS data sets or SDB data sets.

SERVICE REQUESTS

Service request types of calls that can be performed on a data set. These service requests are defined by the systems programmer in the CICS FCT or CSD. Valid entries are:


    • REA: Read access is allowed.
    • UPD: Updates are allowed for current records.
    • ADD: New records can be added.
    • BRO: Data set can be sequentially browsed in a forward direction. VSAM KSDS data sets can also be browsed in a backward direction.
    • DEL: Records can be deleted.

Important

Authorized users with access to a particular set of service requests can type over the values using the first letter of the request (for example, A for ADD, B for BRO). To remove a particular service request, blank out the type or press Erase EOF to clear it. To add or remove a service request, first CLOSE and DISABLE the current status of the data set.

These values cannot be overtyped for SLS data sets, SDB data sets, or the code coverage XVTCSPEC file.

Output Fields

NAME

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.

ACCESS METHOD

Access method used for this data set. Valid entries are:


    • BDAM: Basic Direct Access Method
    • VSAM: Virtual Storage Access Method.

ACCESS TYPE

Type of access used in the specified 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 for VSAM data sets that are in an OPEN status.

OPTIONS

Options that apply to a data set as defined in the CICS FCT or CSD. These options define the type of enqueue used for the data set when opened by CICS. Valid entries are:


    • EXC: Places exclusive control on the record when a read for update call is made to the record. If the data set is a BDAM data set, exclusive control operates on the entire block rather than the record and lasts until the update is complete. CICS enqueues operate on a single record and last until a sync point is issued or the end of task is reached.
    • RLS: CICS TS Record Level Sharing was selected when defining the data set to CICS. Applicable to VSAM data sets only. RLS and EXC are mutually exclusive.
    • SHR: The data set was defined with the DISP=SHR option.
    • OLD: The data set was defined with the DISP=OLD option.

REMOTE

Information for data sets defined as REMOTE to this CICS system. These data sets are under control of another CICS system, but have been defined in the CICS FCT or CSD as available for access by this CICS system.


    • ID: CICS system ID used to access the data set using the CICS intercommunication facilities.
    • NAME: Name of the data set defined to the remote system. Because different CICS systems can reference the same data set by different names, this field identifies the real name of the data set on the remote system.

 

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