ISPF Master Class - DSLISTs

and Member Lists and

UDLISTs (Oh My!)
Dan Dirkse
Iuvo Technologies, Inc.

November 4, 2020
Session 4AG
What we are going to cover?

• Data Set List Utility

• Member Lists

• Unix Directory List Utility

2
Data Set List utility

3
4
Dsname Level and Volume serial
• Patterns for Dsname Level
•% Represents any single character
•* Represents 0 or more characters or a single qualifier
• ** Represents 0 or more qualifiers

• Examples
• DEV.V%%R%% Second qualifier with V and R in positions 1 and 4
• **.EXEC All EXEC libraries (catalog search)
• DAND.*.JCL Only data sets with DAND and JCL as 1st and 3rd
qualifiers
• DAND.GDG(-2) Can specify relative GDG numbers

5
Data set list options
• Initial View
• Volume, Space, Attrib, Total (use LEFT/RIGHT from the list to switch)

• Other options (set with /)

• Confirm Data Set Delete
• Confirm Member Delete
• Include Additional Qualifiers (affects list displayed)
• Display Catalog Name
• Display Total Tracks
• Prefix Dsname Level (affects list displayed, may need to use ' prefix)

6
7
8
 Line Commands that have been around

•B Browse a data set/member(s)

•C Catalog a data set
•D Delete a data set/member(s)
•E Edit a data set/member(s)
•F Free unused space units from a data set
•I Display data set information (including PDS directory blocks/members)
•M Display extended member list for a data set (or partial member list)

9
Line Commands that have been around
(cont.)
•P Print the data set attributes and members to LIST data set
• PX Print the data set index listing to the LIST data set
•R Rename a data set
•S Display data set information
•U Un-catalog a data set
•V View a data set/member(s)
•= Repeat previous line
•/ Display pop-up of commands

10
 Line Commands you may not be aware of

• // Block command prefix

• AL Allocate a new data set based upon current
• CO Copy a data set/member(s) to existing or new data set/member
• MO Copy a data set/member(s) to existing or new data set/member
•X Exclude a data set
• NX Show excluded data sets
• NXF Show first excluded data set
• NXL Show last excluded data set
11
 Line Commands you may not be aware of
(cont.)
• RA Add data set to a reference list (REFOPEND command to edit lists)
• RS Reset member statistics
• SC Compare (NDSN, ODSN, NVOL, OVOL, M, PROMPT parms)
• SCE Extended Compare (NDSN, ODSN, NVOL, OVOL, M, PROMPT parms)
• SF SearchFor (search string or B, E, or V parms)
• SFE Extended SearchFor (search string or B, E, or V parms)

12
13
14
15
16
17
18
19
20
21
FIND 3.4 command/macro
FIND EXEC
• Calls VIEW with data set passed, FINDMAC initial macro and find
parameters
• VGETS response from macro
• Sets ZDLMSG variable to set message in 3.4

FINDMAC Macro
• Performs the find
• Checks for count (for when ALL is specified)
• VPUTs response
• CANCELs if string not found
22
23
24
Variables available in SHARED Pool

• ZDLDSN Data Set Name (fully qualified, no quotes) 44

• ZDLCMD Line command 9
• ZDLLCMD Expanded Line command 255
• ZDLVOL Volume 6
• ZDLMVOL Multi-Volume Indicator 1
• ZDLDEV Device type 4
• ZDLMIGR Whether data set is migrated (YES or NO) 3

25
Variables available in SHARED Pool …

• ZDLSIZE Data set size in tracks 6

• ZDLSIZEX Data set size in tracks, long format 12
• ZDLEXT Number of extents used 3
• ZDLEXTX Number of extents used, long format 5
• ZDLUSED Percentage of used tracks 3
• ZDLOVF Space overflow indicator (YES or NO) 3
• ZDLSPACU Space Units 10

26
Variables available in SHARED Pool …

• ZDLDSORG Data set organization 4

• ZDLLRECL Data set record length 5
• ZDLRECFM Data set record format 5
• ZDLBLKSZ Data set block size 5
• ZDLCDATE Creation date 10
• ZDLRDATE Last reference date 10
• ZDLEDATE Expiration date or ***None*** 10

27
Variables available in SHARED Pool …

• ZDLCAT Cataloged Status (0/2/4/6/8) 1

• ZDLCATNM Name of the catalog in which data set located 44
• ZDLCONF Delete confirmation (Y or N) 1
• ZDLDSNTP Data set name type 8
• ZDLXSTAT Exclude Status 1

28
Variables available in SHARED Pool …
(only for Display Total Tracks)

• ZDLSIZET Total Tracks of all data sets in list 19

• ZDLSIZTX ZDLSIZET for only non-excluded data sets 19
• ZDLDST Total number of data sets in the list 6
• ZDLDSX ZDLDST for only non-excluded data sets 6

• Note: ZDLSIZET and ZDLSIZTX are only available if the list is displayed in
SPACE or TOTAL view

29
Variables that can be returned in SHARED
Pool

• ZDLNDSN New data set name to appear in list 44

• ZDLMSG Message to appear in list 16
• ZDLREF Refresh data set information (Y or N) 1

30
Primary Commands that have been around

• APPEND Append a personal list or data set level to the current list
• CONfirm Confirms a data set delete request
• Locate Locates an entry in the list based upon the sorted order
• REFresh Refreshes the displayed list
• RESet Resets excluded data sets and removes line commands/msgs
• SAVE Save the list to the LIST data set or userid.XXX.DATASETS
• SHOWcmd Shows the line command before invoked
• SORT Sorts the list using one or two column names
31
Primary Commands you may not be aware of
• DSLSET Displays the data set list settings panel
• EXclude/X Excludes a data set containing string within data set name
• Find Finds string within data set name
• Member Searches all partitioned data sets for member name/pattern
(X/EX, NX, RECALL1, RECALL2 parms)
• SRCHFOR Search for string among data sets (no parm for panel)
• LC Display the Data Set List Color Change Utility
• VA Display the Attribute view
• VS Display the Space view
• VT Display the Totals view
• VV Display the Volume view

32
33
34
35
36
37
38
Alternate ways to access data set lists
• DSLIST command Display a list from any command line
• DSLIST exec Displays data sets beginning with userid.EXEC
• DSLIST ‘SYS1’ Displays data sets beginning with SYS1
• DSLIST MY Displays the MY reference list
• DSLIST Displays list of reference lists

• LMDLIST Service Queries a list of data sets for a dsname level

• LMDDISP Service Displays a data set list for a dsname level

39
40
 LMDLIST Service
• Creates a list of data sets with data set statistics optionally returned

• LMDINIT service first run to associate the Dsname Level/Volume with a dslist-id

• Options
• LIST – First call builds the list and returns the first data set name, subsequent call returns
next
• FREE – Called after the last LIST call to clear storage
• SAVE/SAVEC – Writes data set names and, optionally, statistics
• TOTALS – sets ZDLSIZET (Total Size) and ZDLDST (Total data set count) variables

• LMDFREE service to free the dslist-id

41
42
43
44
45
46
47
48
49
50
LMDDISP Service
• Displays a data set list

• LMDINIT service first run to associate the Dsname Level/Volume with

a dslist-id

• Option for which view to use initially

• VOLUME, SPACE, ATTRIB, or TOTALS

• LMDFREE service after to free storage

51
52
53
Member Lists

54
Member name patterns
• Patterns for Member name
•% Represents any single character
•* Represents 0 or more characters

• Examples
• A*Z Member names with A as first character and Z as last
• B%%% Four character names starting with B
• *GEN* Member names containing GEN

55
Member list flavors
• Basic
• Used by browse/view, edit, etc.
• Single character line command area
• Single “S” line command
• Protected prompt column

• Enhanced
• Used by option 3.1, browse/view, edit from data set list (if selected)
• One or nine character line command area
• Multiple line commands, user-written line commands
• Unprotected prompt column
• Allows default sort other than member name

56
57
58
59
60
61
Line Commands that have been around
•B Browse a member
•D Delete member(s)
•E Edit a member
•P Print a member to the ISPF LIST data set
•R Rename a member
•S Select a member
•V View a member
•/ Display pop-up of commands

62
Line Commands you may not be aware of
• C Copy member (prompt field for optional member name)
• M Move member (prompt field for optional new member)
• G Reset member statistics
• I Member statistics information
• J Submit Job
• T TSO command/exec (prompt field for command or only T for panel)
• = Repeat previous command (helpful for TSO commands)

* Note: For member lists with 9-character line command areas, TSO
commands/ execs can be entered directly as a line command. TSO
commands/execs can only be run against members in the first library of a
concatenation. (Same for G/J line commands)
63
64
65
Primary Commands that have been around
• CONFIRM Confirms a member delete request
• Locate Locates an entry in the list based upon the sorted order
• REFresh Refreshes the displayed list
• RESet Removes unwanted line commands and messages
• SAVE Save the list to the LIST data set or userid.XXX.MEMBERS
• Select Select a member or members (with optional line command in
enhanced member list)
• S AB* J (or SUB) to submit all members beginning with AB
• S *GEN D to delete all members ending with GEN

• SORT Sorts the list using one or two column names

66
Primary Commands you may not be aware of

• FILTER Display only members with matching attributes

• Find Finds string within member name or another column
• SRCHFOR Search for string among members (no parm for panel)
• MLC Display the Member List Color Change Utility
• MLS Display the Enhanced Member List Initial Sort

67
68
69
70
FIND command
• F ABC Find ABC within the members

• F LAST 1999 CREATED Find last 1999 in the Created field

• F VV 10 Find next version 10

71
72
73
74
Alternate ways to access member lists

• LMMLIST Service Queries a list of members

• LMMDISP Service Displays a member list for processing your

own commands

• MEMLIST Service Displays a member list like option 3.1

75
 LMMLIST Service
• Creates a list of members with member statistics optionally returned

• LMINIT/LMOPEN services first run to associate a data-id with the data set, etc.
and open

• Options
• LIST – First call builds the list and returns the first member, subsequent returns next
• FREE – Called after the last LIST call to clear storage
• SAVE – Writes members and, optionally statistics

• LMCLOSE/LMFREE services after to close and free data-id

76
77
78
79
80
81
82
83
84
LMMDISP Service
• Displays a member list with line command processing as your responsibility

• Options
• DISPLAY – Creates member list, displays it, and returns first selected member
• GET – Returns information for second and other members
• PUT – Saves information in the Line Command and User Data fields
• ADD – Add a member entry to a member list
• DELETE – Delete a member entry from a member list
• FREE – Frees storage for a member list

• See Mark Zelden’s XMEMLIST exec on the CBT tape for a good example

85
 MEMLIST Service
• Simple way to display an enhanced member list with 3.1 line command
functions

• Option for either a 1 or 9 character line command area

• 9 character supports TSO command/exec execution directly

• Option for the default function to be used for the S line command
• Causes member list heading to change from LIBRARY to VIEW, RENAME, etc.

• Option for confirmation of member deletes

86
87
88
Unix Directory List

89
90
91
Pathname
• Must specify a relative (prefix of /) or an absolute pathname (prefix of .) or
home directory (~).

• Special (glob) characters for pathnames

• ? Represents any single character
• * Represents 0 or more characters
• [abc] Represents list of valid characters to match

• Examples
• /www/[il]*/a* Matches /www/log/agent and others
• /samples/IBM/F??????A Matches /samples/IBM/FOMOGBHA and others

92
Directory list options

• Confirm File Delete

• Confirm Non-empty Directory Delete
• Bypass z/OS UNIX File Edit Options panel *
• Display permissions in octal format *
• Enter z/OS UNIX commands in Command field *

* Available from z/OS UNIX Directory List Options pulldown

93
94
95
96
97
98
99
100
Line Commands for Directory List
• AA Auditor auditing
• B Browse a file
• CI Copy data in
• CO Copy data out
• D Delete an entry
• E Edit a file
• EA Edit an ASCII file
• EU Edit a UTF8 file
• FS Display File System attributes
• I Display z/OS UNIX File Information

101
Line Commands for Directory List (continued)
• L List a directory
• MA Manage ACLs
• MF Modify format
• MG Modify group
• MM Modify mode fields
• MO Modify owner
• MX Modify extended attributes
• N Create new entry
• R Rename an entry
• RA Add entry to a reference list

102
Line Commands for Directory List (continued)
• UA User Auditing
•V View a file
• VA View an ASCII file
• VU View a UTF8 file
•X Execute a z/OS UNIX or TSO command
•= Repeat previous command
•/ Display pop-up of commands
• // Block command prefix

103
Primary Commands for Directory List
• Edit Edit a file in the current directory (E/EA/EU)
• FILTER Filter the list with a file name pattern
• Find Find a string in the file name
• Locate Locates an entry in the list based upon the sorted order
• REFresh Refreshes the displayed list
• RESet Removes unwanted line commands and messages
• SAVE Save the list to the LIST data set or userid.XXX.DIRLIST
• SORT Sorts the list using one or two column names
• SRCHFOR Search for string in regular files in the list
• SU Toggle Super-User mode and initial UID
104
Alternate ways to access directory lists
• View and Edit Other name field

• Option 3.4 Dsname Level field

• UDLIST command Display a list from any command line

• UDLIST /samples Displays files in the samples directory
• UDLIST MYFILES Displays the MYFILES reference list
• UDLIST Displays list of reference lists

• DIRLIST Service Displays a directory list

105
DIRLIST Service
• Displays a directory list

• Most flexible service for layout and command overrides

• Option controlling which columns appear in the list

• Option for an alternate line command processor

• Can override built-in line commands
• Can indicate to ISPF to handle the line command after analyzing data

• Variables for file information and for setting message back to list

106
107
108
109
110
111
112
Variables available in SHARED Pool
• ZUDLCMD Line command 8
• ZUDPATH Pathname of file 1023
• ZUDFTYPE File type 4
• ZUDFPERM File Permissions 10
• ZUDFPRMO File Permissions – octal 4
• ZUDFOWN Owner 8
• ZUDFAUDIT Audit Settings 6
• ZUDFEXTA Extended attributes 4
• ZUDFFORM File format 4
• ZUDFGRP Owner group 8

113
Variables available in SHARED Pool …
• ZUDFLNKS Links 14
• ZUDFSIZE File size 20
• ZUDFMDTM Modified date/time 19
• ZUDFCDTM Changed date/time 19
• ZUDFADTM Accessed date/time 19
• ZUDCRDTM Created date/time 19
• ZUDFAUDIT Audit Settings 6

114
Variables that can be returned in SHARED
Pool

• ZUDMESSG Message to appear in list 16

115
116
All example exec/macros are available upon request as
free software under the terms of the GNU General Public License as
published by the Free Software Foundation.

Send an email to:

dan[at]tso-tools.com
Please submit your session feedback!
• Do it online at http://conferences.gse.org.uk/2020/feedback/4AG

• This session is 4AG

GSE UK Conference 2020 Charity
• The GSE UK Region team hope that you find this presentation and
others that follow useful and help to expand your knowledge of z
Systems.
• Please consider showing your appreciation by kindly donating a small
sum to our charity this year, NHS Charities Together. Follow the link
below or scan the QR Code:
http://uk.virginmoneygiving.com/GuideShareEuropeUKRegion