Data set list filter exit

In the ISPF configuration table keyword file, this exit is set with keyword DATA_SET_LIST_FILTER_PROGRAM_EXIT.

The data set list filter exit is used by option 3.4 to allow the installation to determine what data set names appear in the data set list. The exit is called at two different points:

First, with the DSNAME LEVEL and VOLUME specified on option 3.4 panel
Second, for each data set whose name matches the DSNAME LEVEL and VOLUME.

If an exit routine is not provided, PDF uses the dsname level and volume specified on the panel and adds all data sets that match the data set name level and volume to the list.

PDF calls this exit routine using the standard conventions. The routine must be a program. All ISPF and system services are available to the routine.

See Disable generic high-level qualifiers for an example of a data set list filter exit.

Analyze Dsname and Volume

Table 1. Details of the parameters used to analyze Dsname and Volume
Parameter	Type	Len	Description	Modifiable
CODE	FIXED	4	Code that indicates that this is the analyze dsname and volume call. Call=1.	No
DSNAME LEVEL	CHAR	44	Data set name level that was specified on the option 3.4 panel.	Yes
VOLUME	CHAR	6	Volume that was specified on the option 3.4 panel.	Yes

Analyze data set name

Table 2. Details of the parameters used to analyze the data set name
Parameter	Type	Len	Description	Modifiable
CODE	FIXED	4	Code that indicates that this is the analyze data set name call. Call=2	No
DSNAME LEVEL	CHAR	44	Data set name level that you specified on the option 3.4 panel.	No
VOLUME	CHAR	6	Volume that you specified on the option 3.4 panel.	No
DATA SET NAME	CHAR	44	Data set name that is to be added to the list.	No
VOLUME NAME	CHAR	6	Volume on which this data set resides.	No

Return codes

With the DSNAME LEVEL and VOLUME specified on option 3.4 panel.

0: The data set name and volume is used as entered on the panel.
4: Either the data set name or the volume has been modified by the exit and the modified data set name or volume is used.
8: A list is not displayed.

For each data set whose name matches the DSNAME LEVEL and VOLUME.

0: Data set name and volume is included in the list without any modification.
4: Data set name is not added to the list.
8: The list is stopped, no more items are added to the list.