LIBDEF Display utility

The LIBDEF Display Utility displays all active and stacked LIBDEF definitions for the current logical screen in a scrollable list. Optionally, a specific LIBDEF library definition may be selected.

The ISPF system command, ISPLIBD [libtype] invokes the LIBDEF Display Utility. The optional parameter, libtype, identifies a specific LIBDEF library definition to be displayed. All LIBDEF definitions for the current logical screen are displayed if the parameter is omitted, if the parameter is longer than 8 characters, or if the parameter specifies ISPPROF as the library name.

For each LIBDEF definition displayed, this information is provided:

  • Stack indicator

    An "S" is displayed to the left of the library name when a stacked LIBDEF definition is presented.

  • Library
  • Type
  • ISPxUSR indicator (for type DATASET only)
  • Identification

For type DATASET/EXCLDATA this column contains the data set names. The associated ISPxUSR data set names is shown when the respective DDNAME is allocated. The ISPxUSR data sets are not shown as part of a stacked definition.

For type LIBRARY/EXCLLIBR this column contains the library name (ddname) followed by the first or only allocated data set name.

The LIBDEF Display Utility supports the use of a LOCATE command. LOCATE is used to locate a specific LIBDEF library name. Two command abbreviations, LOC and L, are also supported.

LOCATE ISPPLIB
Locates the LIBDEF definition for ISPPLIB
LOC ISPMLIB
Locates the LIBDEF definition for ISPMLIB
L ISPSLIB
Locates the LIBDEF definition for ISPSLIB

This figure shows a LIBDEF Utility display of all LIBDEF definitions. Figure 2 shows a display of a single LIBDEF definition, and Figure 3 shows a LIBDEF stacked definition.

Figure 1. ISPLIBD - all LIBDEF definitions
┌------------------------- LIBDEF Utility ----------------------------┐
│ ISPLLSA                 ISPF LIBDEF Display        Row 1 to 13 of 16│
│                                                                     │
│                                                                     │
│   Library  Type    USR Identifier                                   │
│                                                                     │
│   ISPFILE              ** LIBDEF not active **                      │
│   ISPLLIB  EXCLDATA    ISPFPROJ.LWGMVS41.LOAD                       │
│                        ISPFPROJ.DMTSO.LOAD                          │
│   ISPMLIB  DATASET     ISPFPROJ.LWGMVS32.MSGS                       │
│                        ISPFPROJ.LWGMVS31.MSGS                       │
│   ISPPLIB  DATASET  X  ISPFPROJ.LWG.PANELS                          │
│                        ISPFPROJ.LWGMVS32.PANELS                     │
│                        ISPFPROJ.LWGMVS31.PANELS                     │
│   ISPSLIB  DATASET     ISPFPROJ.RGG.SKELS                           │
│   ISPTABL  LIBRARY     MYTABLE                                      │
│                        ISPFPROJ.LWGMVS33.TABLES                     │
│   ISPTLIB              ** LIBDEF not active **                      │
│   MYGEN1   LIBRARY     MYTABLE                                      │
│                                                                     │
│ Command ===> _____________________________________ Scroll ===> CSR  │
│  F1=Help      F2=Split     F3=Exit     F7=Backward   F8=Forward     │
│  F9=Swap      F12=Cancel                                            │
⋘---------------------------------------------------------------------┘
Figure 2. ISPLIBD ISPPLIB - ISPPLIB LIBDEF definition
┌------------------------- LIBDEF Utility ----------------------------┐
│ ISPLLSA                 ISPF LIBDEF Display          Row 1 to 3 of 3│
│                                                                     │
│                                                                     │
│   Library  Type    USR Identifier                                   │
│                                                                     │
│   ISPPLIB  DATASET  X  ISPFPROJ.LWG.PANELS                          │
│                        ISPFPROJ.LWGMVS32.PANELS                     │
│                        ISPFPROJ.LWGMVS31.PANELS                     │
│ **End**                                                             │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│ Command ===> _____________________________________ Scroll ===> CSR  │
│  F1=Help      F2=Split     F3=Exit     F7=Backward   F8=Forward     │
│  F9=Swap      F12=Cancel                                            │
⋘---------------------------------------------------------------------┘
Figure 3. ISPLIBD ISPPLIB - ISPPLIB LIBDEF stacked definition
┌------------------------- LIBDEF Utility ----------------------------┐
│ ISPLLSA                 ISPF LIBDEF Display          Row 1 to 4 of 4│
│                                                                     │
│                                                                     │
│   Library  Type    USR Identifier                                   │
│                                                                     │
│   ISPPLIB  DATASET  X  ISPFPROJ.LWG.PANELS                          │
│                        ISPFPROJ.LWGMVS41.PANELS                     │
│ S ISPPLIB  DATASET     ISPFPROJ.LWGMVS32.PANELS                     │
│                        ISPFPROJ.LWGMVS31.PANELS                     │
│ **End**                                                             │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│                                                                     │
│ Command ===> _____________________________________ Scroll ===> CSR  │
│  F1=Help      F2=Split     F3=Exit     F7=Backward   F8=Forward     │
│  F9=Swap      F12=Cancel                                            │
⋘---------------------------------------------------------------------┘

When you are in the Dialog Test utility (test environment), and you issue a LIBDEF for a panel data set from option 7.6, the LIBDEF is set up under the user environment. In order to display a panel from the library for which you issued the LIBDEF or to display the active LIBDEFs, you must go through a Dialog Test utility interface.

For example, from Dialog Test's option 7.6 issue:
LIBDEF ISPPLIB DATASET ID('xxxx.panels')
To display the active LIBDEFs, go to 7.1 (the Invoke Dialog Function/Selection Panel) and type ISPLLS at the PGM prompt and ISPPLIB at the PARM prompt; then press Enter.
Note: If you attempt to issue the ISPLIBD ISPPLIB command from the command line on the Dialog Test utility's option 7.6, the LIBDEF utility will indicate that ISPPLIB has no active LIBDEFs. This is because the Dialog Test utility runs in the test environment, not the user environment.