z/OS ISPF Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


LMDDISP—data set list service

z/OS ISPF Services Guide
SC19-3626-00

The LMDDISP service allows you to write your own data set list dialog. This service is similar to ISPF option 3.4, the data set list utility, which displays the list of data sets. The LMDDISP service displays any view of the data set list (Volume, Space, Attrib, or Total) that you want to display first. You can then scroll to any other view from the initial display view.

The LMDDISP service is given a data set list ID (dslist-id) which has been associated with a data set level or volume or both by the LMDINIT service. The LMDINIT generates a data set list ID from a data set level or volume or both. The data set list ID must be freed by the LMDFREE service.

Command invocation format

Read syntax diagramSkip visual syntax diagram
>>-ISPEXEC--LMDDISP--LISTID(dslist-id)-------------------------->

>--+--------------------+--+--------------------+--------------->
   |       .-VOLUME-.   |  |          .-YES-.   |   
   '-VIEW(-+-SPACE--+-)-'  '-CONFIRM(-+-NO--+-)-'   
           +-ATTRIB-+                               
           '-TOTAL--'                               

>--+-------------------+--+--------------------+---------------->
   '-PANEL(panel-name)-'  |          .-NO--.   |   
                          '-CATALOG(-+-YES-+-)-'   

>--+-------------------+--+-------------------+----------------->
   |         .-NO--.   |  |         .-YES-.   |   
   '-TOTALS(-+-YES-+-)-'  '-STATUS(-+-NO--+-)-'   

>--+-------------------+--+--------------------+---------------><
   |         .-YES-.   |  |          .-YES-.   |   
   '-EXDATE(-+-NO--+-)-'  '-REFLIST(-+-NO--+-)-'   

Call invocation format

Read syntax diagramSkip visual syntax diagram
>>-CALL--ISPEXEC--(buf-len,buffer);----------------------------><

or

Read syntax diagramSkip visual syntax diagram
                                             .-'VOLUMEbb'-.   
>>-CALL--ISPLINK('LMDDISPb'--,--dslist-id--,-+-'b'--------+----->
                                             +-'SPACEbbb'-+   
                                             +-'ATTRIB--'-+   
                                             '-'TOTALbbb'-'   

     .-'YESbbbbb'-.                      .-'NO--'--.   
>--,-+-'b'--------+--,-+-panel-name-+--,-+-'b'-----+------------>
     '-NO--'------'    '-'b'--------'    '-'YES--'-'   

     .-'NO--'--.    .-'YES--'-.    .-'YES--'-.      
>--,-+-'b'-----+--,-+-'b'-----+--,-+-'b'-----+-);--------------->
     '-'YES--'-'    '-'NO--'--'    '-'NO--'--'      

     .-'YES--'-.      
>--,-+-'b'-----+-);--------------------------------------------><
     '-'NO--'--'      

Parameters

dslist-id
A data set list ID associated with a data set name level or a volume or both by the LMDINIT service. For more information about the data set level and how it determines which data set names are to be included in the data set list, see LMDINIT—initialize a data set list.
VOLUME|SPACE|ATTRIB|TOTAL
The Volume view shows a data set list that contains data set names and the volumes on which they reside. The list is sorted by data set name. Volume is the default.

The Space view shows a data set list that contains data set names, tracks, percentages used, extents, and devices. The list is sorted by data set name.

The Attrib view shows a data set list that contains data set names, data set organizations, record formats, logical record lengths, and block sizes. The list is sorted by data set name.

The Total view shows a data set list that contains all information displayed by the Volume, Space, and Attrib views, plus the created, expired, and referred dates. The list is sorted by data set name and has two lines per data set.

YES|NO (CONFIRM)
This parameter controls whether the Confirm Delete panel appears when using the D (delete data set) line command from the displayed data set list. YES is the default.

If YES is specified, ISPF displays the Confirm Delete panel. This gives you the opportunity to change your mind and keep the data set. If you try to delete an expired data set, the Confirm Purge panel appears following the Confirm Delete panel.

If NO is specified, ISPF does not display the Confirm Delete panel. The data set is deleted without your having to take any additional actions unless you try to delete an unexpired data set. If this is the case, the Confirm Purge panel appears.

panel-name
The name of the panel to use for displaying a data set list. The default is the data set list found in option 3.4, the data set list utility. This can be a customized panel that you provided. See z/OS ISPF Planning and Customizing for more information on developing a customized panel.
YES|NO (CATALOG)
This parameter controls whether the name of the catalog where each data set was located is displayed on the Total view. This parameter is ignored if a value for the volume-serial parameter is passed on the LMDINIT call.
YES|NO (TOTALS)
This parameter controls whether the total tracks of all datasets, the total tracks of all non-excluded data sets, the number of all data sets and the number of all non-excluded data sets in the list is displayed in an additional header line above the column descriptions. This parameter is ignored for the VOLUME and ATTRIB view. The default for the SPACE and TOTAL view is NO. Processing time for the initial view will increase depending on the size of the data set list, as the track information for all data sets has to be collected up front. The progress of the data collection can be displayed in a popup panel by selecting option STATUS.
YES | NO (STATUS)
This parameter controls, whether a popup panel with a progress bar is displayed during the collection of the data set information. The parameter is only applicable when TOTALS is selected on the SPACE or TOTAL view. Note: The progress panel will only be displayed if the data set list contains at least 50 data sets.
YES | NO (EXDATE)
This parameter controls whether the expiration date or the referred date is displayed on the TOTAL view of the data set list. By default, the referred date is displayed.
YES | NO (REFLIST)
This parameter controls whether the dsname level supplied to the corresponding LMDINIT is added to the ISPF reference list.

Return codes

These return codes are possible:
 0
Normal completion.
 8
Error building data set list. The error condition is described in the ISPF system dialog variables.
10
A data set list does not exist for the list-id specified via keyword LISTID.
12
A keyword value is incorrect.
20
A severe error occurred while processing the data set list.

Example

The example shown in Command invocation is an invocation of LMDDISP which will display the Volume view of a data set list with the Delete Data Set Confirmation panel. The variable ID contains a data set list ID generated by the LMDINIT service.

Command invocation

ISPEXEC LMDDISP LISTID('id') VIEW(VOLUME) CONFIRM(YES)

Call invocation

CALL ISPLINK('LMDDISP ',DSLISTID,'TOTAL   ','NO      ');
OR
Set the program variable BUFFER to contain:
BUFFER = 'LMDDISP LISTID('id') VIEW(VOLUME) CONFIRM(YES)';
Set the program variable BUFLEN to the length of the variable BUFFER. Issue the command:
CALL ISPEXEC (BUFLEN, BUFFER);

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014