DL/1 Segment List (5.4.3)

The DL/1 Segment List screen (5.4.3) is used to view a list of DL/I segments that can be accessed using a PSB and PCB. The list shows the segments in the hierarchical order in which they can be accessed. This screen can be used to highlight the hierarchical path needed to access a segment or select a path for actually processing the segment.

Each PCB in a PSB defines a database to access via this PSB. In addition, it defines the segments that can be accessed in the database. This screen displays each segment that can be accessed via a PCB along with the associated level number for that segment. Each level in the hierarchy is indented one position. This provides a hierarchical view of the database that can be accessed from the PCB. If SSAs have been built, Code Debug CICS highlights the path to the lowest level SSA, indicating how the segment should be accessed within the hierarchy.

Position in the list by using the UP, DOWN, TOP, BOTTOM, and LOCATE primary commands.

Access this screen by typing the number 4.3 on the File-Utility-Menu-5, or typing 3 on the DL/1 DL-1-Database-Menu-5-4, or as described in Transferring Between Screens.

DL/1 Segment List Screen (5.4.3)

Input Fields

SEL

Enter one of the following values:

• S (Select): Selects a hierarchical path and creates skeleton SSAs used to access a segment. Code Debug CICS deletes any previous SSAs built by Code Debug CICS or via the Edit DL/1 Segment (5.4.4) screen, and replaces them with the new skeleton SSAs. The skeleton SSA contains the information, except the key data, needed to allow qualified SSAs to access the segment. After creating new skeleton SSAs, transfer to the Edit DL/1 Segment (5.4.4) screen to perform DL/I calls.
• P (Path): Highlights the hierarchical path required to reach a specific segment. Place the P line command to the left of the lowest level segment to be accessed.

PSBNAME

PSB used to define a set of DL/I databases that can be accessed from a program. When a PSB name is selected from the DL/1 PSB List (5.4.1) screen, Code Debug CICS automatically displays it in this field. You can also enter a valid PSB name in this field. Code Debug CICS checks the PSB name and displays an error message if it is invalid for the CICS system. Always select a PSB to access any DL/I database.

PCB#

Number of the PCB in the selected PSB. Code Debug CICS uses the PCB number instead of the DBD name because multiple PCBs can access the same DBD using the same or slightly different views of the database.

When a DBCTL PSB is selected on the DL/1 PCB List (5.4.2) screen, Code Debug CICS automatically displays it in this field. If none was selected, enter a two-digit PCB number (relative to 1) for the PCB to be accessed in the displayed PSB. Code Debug CICS checks the number and displays an error message if it is invalid.

Output Fields

DBCTL STATUS

Displays the status of DBCTL in this CICS region.

DBCTL ID

Displays the ID of the DBCTL region to which this CICS region is connected.

LEVEL

Level of each segment in the database.

SEGMENT NAME

Name of each segment that can be accessed in this view of the database.

DBD

Name of the DBD that defines the database associated with a PCB.