Additional data set processing (RPTTYPE=APP and RPTTYPE=SEP only)

SYSOUT reports written by the integrated auxiliary utilities in the various address spaces are retained in cataloged data sets for the duration of the recovery job.

The MAS RAUX controller copies these data sets, as directed by the REPORT control statement options, to various DD of the MAS JCL. These data sets are then, under normal conditions, deleted and uncataloged by the RAUX control task.

You can see evidence of this activity in the MAS job log by searching for the string “SAS Copy->:” The integrated auxiliary utility SYSOUT report data set names are included in these messages.

Here is an example of what can be searched for in the MAS job log to see evidence of this data set management:
ICUST1A.ICUST1AA IBSS=DR3P0001  DD=WTOs captured                         
-----------------------------------------------------------------------------------     
SAS COPY->: DD=FRXWT@   DSN=DRFHILEV.FRXWTOIB.ICUST1A.ICUST1AA.T0048339

In this example:

  • The RAUX has captured WTO messages associated with building the index for the ICUST1A partition's ICUST1AA database data set in the PR-UAS, under the started task name of DR3P0001.
  • The name of the WTO data set is DRFHILEV.FRXWTOIB.ICUST1A.ICUST1AA.T0048339.
  • The captured messages that were contained in the file were written, along with the identifying address space name, to either the MAS FRXWTO DD or the REPORT DD, depending on the RPTTYPE option.
  • The file was then deleted and uncataloged.

Notice that the heading contains the dbdname.ddname string. This string can be used to find all SYSOUT data gathered by the RAUX for that particular recovered database data set. This is especially useful when RPTTYPE=APP is coded on the REPORT control statement and you are viewing the entire REPORT DD of appended integrated auxiliary utility reports and messages.

These integrated auxiliary utility report data set names are patterned as follows:

&DRFHILEV.FRXxxxxx.&dbdname.&ddname.Thhmmssm

where:

  • &DRFHILEV is taken from the REPORT control statement.
  • xxxxx corresponds to the particular type of integrated auxiliary utility report.
  • &dbdname and &ddname correspond to the database data set being processed (including indexes).
  • hhmmssm is the hour, minute, second, and millisecond of the time the recovery was started.

    The time stamp portion can be used to correlate all integrated auxiliary utility report data sets associated with a given recovery job.

Because of the 44-character DSN length constraint, the possibility exists that the RAUX attempts to allocate, as new, a DSN that already exists.

If the RAUX attempts and fails to dynamically allocate an integrated auxiliary utility report data set, message FRD9003A is written and ABEND U0384-02C is issued. This can occur when an earlier recovery job was:

  • Stopped (by /P command), or
  • Canceled (by /CANCEL command) by a z/OS® operator, or
  • When the RPTRET=Y option is set on the REPORT control card.

To minimize this possibility, set RPTRET=N so that RAUX termination logic deletes the integrated auxiliary utility report data sets.

RAUX termination logic is not driven when the job is stopped or canceled. In this event, it is advisable to delete all integrated auxiliary utility report data sets named with the pattern &DRFHILEV.FRX*.*.*.T* before running the next recovery job.

Furthermore, if RPTRET=N is set, IMS Database Recovery Facility deletes, during initialization, any utility report data sets left from prior executions that would otherwise cause allocation errors due to duplicate DSNs.