Creating a candidate rejection report

The JCL for the Archive (AXQRCHIV), Restore (AXQRESTR), and Database Report (AXQDBRPT) functions can be modified to generate a candidate rejection report that explains why some candidate data sets were not processed.

1. If you want to generate a rejection report that shows which candidate data sets were rejected because of the way the selection criteria were defined through the //CRITERIA DD statement for the Archive, Restore, or Database Reporting function, include //CANDREJR DD SYSOUT=* (or whatever SYSOUT class you want) in the JCL.
   Note: Be aware that including the //CANDREJR DD statement might generate a very large report.
2. To generate a rejection report that shows which candidate data sets were rejected by Restore or Recycle function processing for reasons other than failure to meet the selection criteria, you must add two DD statements to the JCL:
   1. Add a statement that allocates a rejection report DD statement:

      Function	DD statement
      Restore (AXQRESTR)	//RSTRREJR DD SYSOUT=*
      Recycle (AXQRECYC)	//RCYCREJR DD SYSOUT=*

   2. Add a statement that allocates an input data set from which data set name masks are read.
      the data set name masks determine which rejected data sets were included in the report:

      Function	DD statement
      Archive (AXQRCHIV)	//ARCHREJP DD *
      Restore (AXQRESTR)	//RSTRREJP DD *
      Recycle (AXQRECYC)	//RCYCREJP DD *

      Within the input data set, data set name masks must adhere to these format rules:

      • The statement must include these elements:

        REJECTION_DSN_PATTERN:datasetname_or_mask

        where datasetname_or_mask is either a valid data set name or a data set name mask.

      • The REJECTION_DSN_PATTERN: statement can start at any position in the statement.

      • An asterisk (*) in the first position of the statement indicates a comment.

      • Mask statements support two wildcard characters, the asterisk (*) and the percent symbol (%). An asterisk is interpreted as 0–n characters at that position in the mask string; the characters can have any value that is valid for data set names. A percentage symbol is interpreted as a single non-blank character at that position in the mask string; the character can have any value that is valid for data set names.

        Consider an example data set name, GLORF.PAYROLL.CYCLE23.YEAR.END.DATA. A data set name mask that would match this data set (and therefore select it for inclusion in the rejection report) is *.PAYROLL.%%%%%23*.**.DATA.

        Now consider another example, in which you want to specify a mask that matches any data set name. You could specify *.**, which includes in the rejection report the names of all of the rejected data sets.

        Note: When archiving data sets, the dd name ARCHREJR is dynamically allocated if it is not coded in the execution JCL. This is done to ensure that when data sets fail to be archived that the reason for the failure is reported on.