Allocation list primary commands

Primary commands are used to limit the contents of the displayed list, to add pseudo-ddnames, to operate on all the contents of the displayed list and to invoke other ISRDDN options.

All primary commands can be invoked with their minimum unique names. For example, MEMBER can be abbreviated as M, while CLIST can be abbreviated as CL. The allocation list primary commands follow.

You can specify an initial primary command when you start ISRDDN. For example, if you enter DDLISTB 10.??? on an ISPF command line, you will immediately browse the storage containing the TCB control block. When you exit the Browse screen, you are not returned to the DD allocation list. This feature is useful for calling ISRDDN from within a program when, for example, you want to limit the list to specific dd names, view ENQs, save the current allocations, or browse storage.

Only (O) and Exclude (EX, X)

ONLY and EXCLUDE are used to limit the ddnames in the displayed list. They take one operand: a whole or partial ddname. For example, the command O PLI causes the list to contain only ddnames that contain the string "PLI", such as STEPLIB and ISPPLIB.

The ONLY and EXCLUDE commands are useful when you want to limit the ddnames or pseudo-ddnames that are operated on by commands like MEMBER and DUPLICATES. They are also helpful in reducing the size of the displayed list for easier viewing.

Find (F) and Locate (L))

FIND and LOCATE search the list for a string. LOCATE looks only at ddnames and always locates the first matching ddname. FIND looks at everything currently in the displayed list and finds the next occurrence of the string following the current cursor position. You can repeat a FIND operation by pressing the RFIND key.

When a string is found by FIND, the string is highlighted and the cursor is placed on the string. When a string is found by LOCATE, the string is highlighted and the cursor is placed in the line command area next to the located ddname.

Reset (R))

The RESET command rebuilds the list. In most screen formats the list is automatically rebuilt when you press Enter. However, if you have used the COUNT command or the MEMBER command and have messages showing in the list, you might need to use the RESET command to refresh the list.

Short (S) and Long (LON)

The SHORT and LONG commands alter the format of the list. The SHORT command places the ddname of a concatenation next to the first data set (as shown in Figure 1). The LONG command formats the list with ddnames of concatenations placed on a separate line before the data set names (as shown in Figure 1).

Figure 1. Current Data Set Allocations List in LONG Format

                           Current Data Set Allocations            Row 1 of 206

  Volume   Disposition Act DDname   Data Set Name   Actions: B E V M F C I Q
  D$SY01   SHR,KEEP   > _  ALLOCPDS SYS2.SYSPLEXD.ALLOCLIB
  D$IS02   SHR,KEEP   > _  ASMLANGX PDFTDEV.COMMON.WDBLANGX
  D1SY01   SHR,KEEP   > _  HASPINDX SYS2.ISD1.HASPINDX
                      > _  ISPILIB
  D$IS04   SHR,KEEP   > _           PDFTDEV.STG.GIF
  D$IS03   SHR,KEEP   > _           PDFTDEV.INT.GIF
  D$IS03   SHR,KEEP   > _           PDFTDEV.FVT.GIF
  D$IS04   SHR,KEEP   > _           PDFTDEV.SVT.GIF
                      > _  ISPLLIB
  D$PP02   SHR,KEEP   > _           WDB.WDBDEV.LOAD
  D$IS04   SHR,KEEP   > _           PDFTDEV.USERID.LOAD
  D$IS03   SHR,KEEP   > _           PDFTOOL.COMMON.LOAD
  D$IS04   SHR,KEEP   > _           PDFTDEV.STG.LOAD
  D$IS02   SHR,KEEP   > _           PDFTDEV.INT.LOAD
  D$IS02   SHR,KEEP   > _           PDFTDEV.FVT.LOAD
  D$IS04   SHR,KEEP   > _           PDFTDEV.SVT.LOAD
  D$IS03   SHR,KEEP   > _           PDFTOOL.FLM@SCAN.LOAD
  D$IS05   SHR,KEEP   > _           ISPFTEST.LOAD
 Command ===>                                                  Scroll ===> PAGE
  F1=Help    F2=Split   F3=Exit    F5=Rfind   F7=Up      F8=Down    F9=Swap
 F10=Left   F11=Right  F12=Cancel

The SHORT format shows more information on one screen. Use the LONG format when you want to use line commands that operate on whole concatenations, such as E and V, on only the first data set in a concatenation.

Member (M)

The MEMBER command is a very useful command in ISRDDN. MEMBER searches the displayed list (or just ddnames containing a given string) for a member whose name matches a pattern. For example, the command M ISRSUBS searches the data sets in the displayed list, the job pack area, and the link pack directory for members named ISRSUBS. Data sets that contain the member are flagged with a message on the left side of the list, as shown in Figure 2.

Figure 2. Results of the MEMBER Command

                           Current Data Set Allocation         Member was found

   Message             Act DDname   Data Set Name   Actions: B E V M F C I Q
                      > _  ALLOCPDS SYS2.SYSPLEXD.ALLOCLIB
                      > _  ASMLANGX PDFTDEV.COMMON.WDBLANGX
                      > _  HASPINDX SYS2.ISD1.HASPINDX
                      > _  ISPILIB  PDFTDEV.STG.GIF
                      > _           PDFTDEV.INT.GIF
                      > _           PDFTDEV.FVT.GIF
                      > _           PDFTDEV.SVT.GIF
                      > _  ISPLLIB  WDB.WDBDEV.LOAD
                      > _           PDFTDEV.USERID.LOAD
                      > _           PDFTOOL.COMMON.LOAD
  Member: ISRSUBS     > _           PDFTDEV.STG.LOAD
                      > _           PDFTDEV.INT.LOAD
                      > _           PDFTDEV.FVT.LOAD
  Member: ISRSUBS     > _           PDFTDEV.SVT.LOAD
                      > _           PDFTOOL.FLM@SCAN.LOAD
                      > _           ISPFTEST.LOAD
                      > _           SYS1.DFQLLIB
                      > _           SYS1.DGTLLIB
 Command ===>                                                  Scroll ===> PAGE
  F1=Help    F2=Split   F3=Exit    F5=Rfind   F7=Up      F8=Down    F9=Swap
 F10=Left   F11=Right  F12=Cancel

If the name is the name of a loaded module in the job pack area or LPA, you also see a panel similar to the one in Figure 4.

When a member name is used on the MEMBER command (such as, M ISRSUBS) and an E, V, or B line command is used next to a data set in which that member is found, ONLY that member is Edited, Viewed, or Browsed. When the M line command is used, the member list is shown with the selected member at the top of the list.

When a member name pattern is used on the member command (such as, M ISR*), the E, V, B, and M line commands display member lists with members that match the given pattern.

Use the MEMBER command in situations when you do not know from where a member is coming or when you suspect that you might be accessing the wrong copy of a member. For example, if you are developing ISPF panels and you do not see your version of the panel being displayed, you can issue the MEMBER command to search for other copies of the panel.

Usually the MEMBER command operates on the entire displayed list. You can add a second operand that is a partial ddname. For example, the command M ISRSUBS PL searches only ddnames containing the string PL, such as ISPLLIB and STEPLIB. This avoids having to use the ONLY command to limit the search.

Clist (CL) or Save (SA)

The CLIST command creates a CLIST that contains TSO ALLOCATE statements to reproduce the allocations in the displayed list. The CLIST is saved in a sequential data set named 'userid.ISRDDN.CLIST' or 'prefix.userid.ISRDDN.CLIST'. If the ISPF configuration table field USE_ADDITIONAL_QUAL_FOR_PDF_DATA_SETS is set to YES, an additional qualifier defined with the ISPF_TEMPORARY_DATA_SET_QUALIFIER field is included before the ISRDDN qualifier. You can use the command name SAVE instead of CLIST.

Use this command when you want to change allocations for testing purposes. For example, to add a panel library to your ISPPLIB concatenation:

Enter ISRDDN
Type O ISPPLIB to limit the displayed list to ddname ISPPLIB
Type CLIST to create and edit the ISRDDN.CLIST data set
Change the ALLOCATE statement to add your data set
Exit ISPF
Execute the CLIST (that is, EX ISRDDN)

Like the MEMBER command, you can add a whole or partial ddname to limit the number of ddnames that are included in the generated CLIST. For example, to create a CLIST that only contains allocation statements for ddnames containing the string ISP, type CLIST ISP or SAVE ISP.

Check (CH)

The CHECK command turns on or off automatic checking for mixed concatenations. CHECK or CHECK ON enables automatic checking, and CHECK OFF disables it. When checking for mixed concatenations is enabled, ISRDDN checks for concatenations with mixed record formats, mixed fixed record lengths, and mixed data set organizations. Because there are times when these concatenations are intended, you might want to turn off the warning generated by ISRDDN.

Count (C)

The COUNT command displays the number of members in a partitioned data set. The number of members is shown in the message area on the left side of the list.

COUNT can be used to find out if you have empty data sets in your concatenations. For example, if you want to find out if all members of an SCLM-controlled library system were successfully promoted, you can edit the hierarchy, invoke ISRDDN, and use the COUNT command to verify that all of the expected libraries in the concatenation are empty.

Like the MEMBER command, you can add a whole or partial ddname to limit the number of ddnames that are searched.

Duplicates (DUP)

The DUPLICATES command searches all of the partitioned data sets in the displayed list and the LPA and displays a list of duplicate names. From the duplicates list, you can use the E (edit), B (browse), and V (view) line commands to view the PDS member or LPA storage. Use the DUPLICATES command to see where you might have potential conflicts with old or modified versions of load modules, REXX or CLIST programs, ISPF panels, or other PDS members.

For module names found in the Link Pack directory, the address of the module and its size are shown on the left side of the screen. If the name is an alias of a different module, the real name (major name) is shown instead of the size.

The duplicates list is shown in Figure 3. Like the MEMBER command, you can add a whole or partial ddname to limit the number of ddnames that are searched. For example, to search only ddnames that contain the string LLIB, enter DUP LLIB.

Figure 3. The Duplicates List Display

                           Duplicate members list                  Row 1 of 562

 Address  Siz/Maj  DDname   Act Member   Data set name    Actions: B, E, V
                   ISPLLIB  > _ FLM$CP   PDFTDEV.SVT.LOAD
 00D8A5F8 FLMIO24  --LPA--- > _

                   ISPLLIB  > _ FLM$CPI  PDFTDEV.SVT.LOAD
 04668F20 000000E0 --LPA--- > _

                   ISPLLIB  > _ FLM$DE   PDFTDEV.SVT.LOAD
 00D8B218 FLMIO24  --LPA--- > _

                   ISPLLIB  > _ FLM$DT   PDFTDEV.SVT.LOAD
 00D8B9D8 FLMIO24  --LPA--- > _

                   ISPLLIB  > _ FLM$99   PDFTDEV.SVT.LOAD
 00D88DF8 FLMIO24  --LPA--- > _

                   ISPLLIB  > _ FLM@SCAN PDFTOOL.COMMON.LOAD
                   ISPLLIB  > _          PDFTOOL.FLM@SCAN.LOAD

 Command ===>                                                  Scroll ===> PAGE
  F1=Help    F2=Split   F3=Exit    F5=Rfind   F7=Up      F8=Down    F9=Swap
 F10=Left   F11=Right  F12=Cancel

The SAVE command can be entered from the duplicate list display to have the duplicate member data written to a sequential data set named 'userid.ISRDDN.DUPLICAT' or 'prefix.userid.ISRDDN.DUPLICAT'. If the ISPF configuration table field USE_ADDITIONAL_QUAL_FOR_PDF_DATA_SETS is set to YES, an additional qualifier defined with the ISPF_TEMPORARY_DATA_SET_QUALIFIER field is included before the ISRDDN qualifier.

APF, Linklist (LI), Parmlib, and Lpa (LP)

The APF, LINKLIST, PARMLIB, and LPA commands add and remove pseudo-ddnames that show the defined APF libraries, link list libraries, PARMLIB libraries, and LPA libraries respectively. These pseudo-ddnames are shown as if they are allocated ddnames, but no actual allocation to the libraries is made. You can use most of the primary and line commands with these names, just as you would with real ddnames.

In the confirmation panel, you can type YES to process the libraries, or SKIP to process the libraries and avoid the confirmation panel in the future. Dynamic LPA, Link lists, PARMLIB, and APF lists are all supported.

The LINKLIST and LPA commands add both the LINKLIST and LPALIB pseudo-ddnames. To delete any pseudo-ddname, enter the appropriate command a second time. For example, to add APF libraries to the list, use the APF command. To remove the APF libraries from the list, enter the APF command a second time.

Select (S) and Load (L)

The SELECT command searches the job pack area (JPA) and link pack area (LPA) to see if a module is loaded. If the module is found, you see the CSVQUERY Results panel shown in Figure 4.

Figure 4. The CSVQUERY Results Panel

   ┌─────────────────────────────────────────────────────────────────────┐  197
   │                          CSVQUERY Results                           │
   │                                                        More:     +  │ Q
   │ Module ISRSUBS  was found to be already loaded. Note that           │
   │ invocations of this program name may pick up another copy from      │
   │ STEPLIB or a LIBDEF'ed data set or from a tasklib such as ISPLLIB.  │
   │ Tab to a box and press enter to view the module in storage.         │
   │    +-------------------------+         +-------------------------+  │
   │    | Job pack area resident  |         | PLPA resident           |  │
   │    | Resident above 16 Meg   |         | Resident above 16 Meg   |  │
   │    | Loaded by program fetch |         | Module address:05437000 |  │
   │    |  from ISPLLIB   (Lib 4) |         | Module size:   000D03C0 |  │
   │    | PDFTDEV.STG.LOAD        |         | Reentrant               |  │
   │    | Module address:15EC6000 |         | Serially reusable       |  │
   │    | Module size:   000D3000 |         | Not loadable only       |  │
   │    | Reentrant               |         | AMODE 31                |  │
   │    | Serially reusable       |         | Authorized library      |  │
   │    | Not loadable only       |         | Not Authorized program  |  │
   │    | AMODE 31                |         +-------------------------+  │
   │    | Not Authorized program  |                                      │
   │    +-------------------------+                                      │
 C │ Command ===>                                                        │ PAGE
   │  F1=Help    F2=Split   F3=Exit    F9=Swap   F12=Cancel              │
 F └─────────────────────────────────────────────────────────────────────┘

The information shown in the CSVQUERY Results panel is mostly derived by issuing a CSVQUERY macro. The data set name from which the module was loaded is shown if it can be determined. However, because of the way this information is gathered, the data set name can be incorrect if the original ddname from which the data set was loaded has been reallocated since the module was loaded.

On the CSVQUERY Results panel, you can use the TAB key to place the cursor inside the boxes describing the load module. If you then press Enter, you can browse the load module in storage.

The SELECT command is useful in situations where you need to know where a loaded program came from, for example, when you think you might be running mixed levels of ISPF or of an application under ISPF.

If a module is not loaded but you want to see its attributes, you can use the LOAD command instead of the SELECT command. LOAD uses the current tasklib such as ISPLLIB, but you should verify that the loaded module came from the source you were expecting it to come from. LOAD automatically browses the load module storage.

Custom (CU)

The CUSTOM command shows several settings about your ISPF installation. It shows the values that used to be set in the ISPDFLTS CSECT but are now in the ISPF Configuration table, and it shows the values configured in module ISPTCM. This command is helpful when you are having trouble with the way certain programs are invoked. For more information about ISPTCM, refer to z/OS ISPF Planning and Customizing.

MList (ML)

The MLIST command displays the eyecatchers for some of the ISPF CSECTs contained in modules ISPSUBS and ISRSUBS. This command can sometimes be used to verify that you are running with a particular level of maintenance because the eyecatchers in most ISPF modules contain a release number or a PTF level.

Browse (B)

ISRDDN provides a method of browsing storage using ISPF BROWSE. The storage can be browsed as unformatted data, as minimally formatted data, or as a side-by-side hexadecimal and EBCDIC dump format. ISRDDN also enables you to automatically chain lists, view arrays, and view the data pointed to by control blocks that are mainly lists of pointers (such as CVT).

The BROWSE primary command accepts a storage address, module name, or TSO TEST address locator string.

Table 1. Some examples invoking BROWSE
Command	Explanation
B ISRSUBS	Browse the already loaded module named ISRSUBS.
B 10.	Browse storage at hexadecimal location 10. To distinguish hexadecimal addresses from module names, absolute addresses must end with a period.
B 0.+21c?+b4?+108?+8	Browse storage based on a TSO TEST style string. In this case, the control block called the Protected Step Control Block or PSCB is shown.
B ISRSUBS+60?	Browse the address pointed to by the 4 bytes at offset hexadecimal 60 into module ISRSUBS.
B ? or B +0?	When executed from within the storage browser, this command uses the address 0 bytes from the beginning of the displayed storage as a pointer and starts a new browse session to show that storage.

Enq (E)

You can view ENQs on the system using the ENQ command. A display similar to the one shown in Figure 5 appears. You can reduce the size of the list by specifying a QNAME, RNAME, address space name, and a system name. All entries are treated as prefixes, so you might not need to specify complete names.

Figure 5. The System ENQ Status List Panel

                           System ENQ Status                       Row 1 of 183

        Scroll LEFT or RIGHT to see type or system name.

 Major name prefix . . . SYSDSN    (SYSDSN, SPFEDIT, etc)
 Minor name prefix . . .                                              (dsn etc)
 Address id prefix . . . USERID    (Job name, User id, etc)
 System prefix . . . . .           (System name)
   Major      Minor                                                  Job Name
 ┌──────────┬──────────────────────────────────────────────────────┬──────────┐
 │ SYSDSN   │ AOP.SAOPEXEC                                         │ USERID   │
 │ SYSDSN   │ AOP.SAOPMENU                                         │ USERID   │
 │ SYSDSN   │ AOP.SAOPPENU                                         │ USERID   │
 │ SYSDSN   │ AZZ.V1R1.SAZZCLIB                                    │ USERID   │
 │ SYSDSN   │ AZZ.V1R1.SAZZMENU                                    │ USERID   │
 │ SYSDSN   │ AZZ.V1R1.SAZZPENU                                    │ USERID   │
 │ SYSDSN   │ AZZ.V1R1.SAZZSENU                                    │ USERID   │
 │ SYSDSN   │ BZZ.SBZZCLIB                                         │ USERID   │
 │ SYSDSN   │ BZZ.SBZZMENU                                         │ USERID   │
 │ SYSDSN   │ BZZ.SBZZPENU                                         │ USERID   │
 │ SYSDSN   │ BZZ.SBZZSENU                                         │ USERID   │
 Command ===>                                                  Scroll ===> PAGE
  F1=Help    F2=Split   F3=Exit    F5=Rfind   F7=Up      F8=Down    F9=Swap
 F10=Left   F11=Right  F12=Cancel

The Major column shows the QNAME. The Minor field shows the RNAME and if the RNAME is 8 bytes or less, it shows the hexadecimal representation of the RNAME next to the EBCDIC representation.

In the System ENQ Status list, the Job Name field is color-coded to indicate the type of ENQ that the address space holds or is waiting for. Green indicates a shared ENQ. Red indicates an exclusive ENQ.

If an address space does not hold the ENQ but is waiting for it, the job name is shown highlighted in reverse video.

On narrow screens, you can scroll right or left for more information. By scrolling left and right you see the system name and ENQ options (SYS (system), SYSS (systems), STEP, G (global), and R (reserve)). On wide screens you see all of the information on one screen without scrolling left or right.

On the System ENQ Status display, press END to return to the Current Data Set Allocations list, or enter CON to view the System ENQ Contention display. You can also use the ALL command to view all ENQs or use the RESET command to see only the data set ENQs (QNAME SYSDSN) for your TSO user id.

Con (C)

You can view ENQ contention on the system by using the CON command. When ENQ contention exists, you see a screen similar to the one in Figure 5, but without the input fields. When no contention exists, a message displays instead of the list.