Step 1: Tailor the sample EDGUX100 exit module

During the OPEN processing for the first file on a volume, the sample EDGUX100 exit module retrieves the data set name, job name and job step program name from system control blocks. The sample EDGUX100 exit module then scans the EDMTAB table for a match. If there is a match, the sample EDGUX100 exit module sets the PL100_SET_IGNORE_FILE2_TON bit to request DFSMSrmm only record data set details for the first file.

To use the sample EDGUX100 exit module for this function, define a table as shown in Figure 1. The order in which the table entries are listed is important because the exit scans the table until it finds the first entry where the job name, data set name and program name masks match the current request. You can change the priority of matching by changing the order of the table entries.

Figure 1. Sample table for controlling data set recording

EDMTAB   DS    0F                  start of table
*                  jobname        data set name
         DC    CL8'*       ',CL44'BACKUP*'
         DC    CL8'ABC*'             program name
*
         DC    CL8'STSGWD* ',CL44'*'
         DC    CL8'A*'               program name
*
         DC    CL8'STSG%%* ',CL44'STSG%%.BACKUP.*'
         DC    CL8'DEF%MAIN'         program name
*
         DC    CL8'STSGDPW ',CL44'DAVE.TOOMUCH.DATA'
         DC    CL8'AB999*'           program name
*
         DC    CL8'EDMEND'         end of table marker

The table contains:

jobname

One-to-eight alphanumeric or national characters including % and *.

% can be used to ignore a positional character in the job name.
* can be used to ignore all remaining characters in the job name. A jobname of * means that the entry applies to all jobs.

data set name

Can be up to forty-four characters, following z/OS data set naming conventions, including % and *.

The character % can be used to ignore a positional character in the data set name.
The character * can be used to ignore all remaining characters in the data set name. A data set name of * means that the entry applies to all data sets.
The use of the character * is not the same as in the generic data set names supported by DFSMSrmm for vital records specifications and search data set masks. Here the * works like the characters *.*might in a generic data set name mask.

Program name

A value up to eight alphanumeric character including % and *.

% can be used to ignore a positional character in the program name.
* can be used to ignore all remaining characters in the program name. A program name of * means that the entry applies to all programs.