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

You can use the data set name change exit to change the name of the data set entered on the data entry panel. This allows PDF to process using the new data set name without the variables originally entered on the panel being changed. Anywhere the data set name is displayed, other than the data entry panel, can reflect either the original or the changed data set name. The data entry fields will not reflect any changes made to the data set name. If the exit is not specified, all data set names are used exactly as they are entered.

PDF calls this exit routine using the standard conventions. The exit is invoked for every data set specified on a data entry panel or in a PDF service call at the point in the PDF processing flow when the data set name is built from its component parts. This includes the library access services, EDIT and BROWSE services, and the PDF product dialogs themselves. The routine must be a program. All ISPF, PDF and system services are available to it.

If more than one ISPF library is specified on a data entry panel, the exit is invoked once for each library specified before each library is allocated. The libraries are not concatenated until each library is processed by the exit and allocated.

Exit parameters

PDF passes the data set name information as it was entered on the panel to the exit routine. Register 1 points to the parameter list.

PDF uses these parameters to communicate with the data set name change exit:

Any of the parameters can be modified and are picked up by PDF with the exception of the Reason field, which is for the information of the exit only. Both an ISPF library (a PROJECT/GROUP/TYPE combination) and an OTHER DATA SET can be present in the parameter list. In this case, the OTHER DATA SET name supersedes the ISPF library name. If an ISPF library combination is specified as input to the exit and the exit wishes to create a new name that does not fit the ISPF library naming convention, the ISPF library name can be replaced by the exit filling in the Other Data Set field.

After the data set name has been changed by the exit, PDF does its normal data set processing, such as appending the user's prefix if an OTHER DATA SET name without quotes is returned by the exit. The changed data set name values are not saved in any variable pool, but are saved internally by PDF. The original input fields on the data entry panel are not changed, but any title line on a panel that contains a data set name can reflect either the original or the changed data set name.

Usage notes

1. Those data sets marked with a reason of TEMP can go through the exit more than once. The exit should not blindly add qualifiers to the TEMP data set names.
2. Any sequential data set that is used for output, such as being edited, the target of a Move/Copy (option 3.3), the source of an Edit MOVE command or the target of an Edit REPLACE command, or being reallocated by Edit after a space ABEND (B37), is sent through the exit twice. In addition, if a member is being browsed via the Library utility browse line command (browse under option 3.1), the data set is sent through the exit twice.
3. Data sets that are allocated in a CLIST as well as a program or that have their data set names built in a CLIST or skeleton cannot be modified by the data set name exit unless the CLIST or skeleton has also been modified to change the data set name in the same way that the exit does. These data sets include:
   • The list data set name produced by the language processors in Foreground and Batch, and the term data sets in Batch.
   • The input and output data sets for SuperC. The CLISTs to be modified are ISRSFORG and ISRSSRCH.
   • The data set created by the Outlist utility (option 3.8) if CLIST ISRUOL is used rather than program ISRUOLP.
4. If the data set is being allocated for recovery, the data set name change exit should check the recovery table and generate a unique data set name.