SARPAC Reports

SARPAC produces three reports:
view
SARPAC produces three reports:
  • The first report lists the status of all tapes in the database, and can help you determine which tapes need to be consolidated.
  • The second report lists the copied SYSOUT groups when SARPAC actually performs the consolidation.
  • The third report is created only if the SARDRLST DD statement is in the SARPAC JCL.
Contents
Create the Tape Status Report without Running Consolidation
The keyword REPORT can be coded as the second subparameter of the PARM field on the EXEC statement:
PARM='VIEW.SYSTEM1,REPORT'
This keyword indicates that only the tape status report is produced and that no actual tape consolidation is performed.
SARPAC Tape Status List
The following is a sample of the SARPAC Tape Status List:
11/10/2013 14:30:08              CA <view> Output Archival and Viewing (nn.n)                  Page     1 SARPAC                   Expanded Retention Option (ERO) Tape Consolidation - Tape Status List                                                                                                                                                                         Used  Per-                       Total   Processed?  Tseq Data Set Name                 Volser Total Grps  Cent Create     Yrs Dplx   Lines   Yes/No, Remarks ----- ------------------------------------ ----- ---- ----- ---------- --- ----   -----   ----------------------    24 VIEW.SYSTEM1.SARTAPE.T0000024 461079    22    1     4 10/07/2013   1  YES   11600   Y, BELOW PTHRESH    28 VIEW.SYSTEM1.SARTAPE.T0000028 486037     4    3    75 10/15/2013   1       151200   Y, BELOW PTHRESH    29 VIEW.SYSTEM1.SARTAPE.T0000029 486158     1    1   100 10/15/2013   1       126000   Y, CONTINUATION TAPE    30 VIEW.SYSTEM1.SARTAPE.T0000030 486035     3    2    66 10/15/2013   1  YES   25200   Y, BELOW PTHRESH    35 VIEW.SYSTEM1.SARTAPE.T0000035 484885     2    2   100 10/15/2013   1  YES  499747   N, ABOVE PTHRESH    36 VIEW.SYSTEM1.SARTAPE.T0000036 484351     1    1   100 10/16/2013   1  YES  487147   N, CONTINUATION TAPE    37 VIEW.SYSTEM1.SARTAPE.T0000037 486050     1    1   100 10/16/2013   1  YES  487147   N, CONTINUATION TAPE    38 VIEW.SYSTEM1.SARTAPE.T0000038 484426     4    3    75 10/16/2013   1  YES  511347   Y, BELOW PTHRESH    41 VIEW.SYSTEM1.SARTAPE.T0000041 468007     2    0     0 10/28/2013   1            0   N, NO USED GROUPS    42 VIEW.SYSTEM1.SARTAPE.T0000042 479554     1    0     0 10/28/2013   1            0   N, NO USED GROUPS    43 VIEW.SYSTEM1.SARTAPE.T0000043 474440     1    0     0 10/28/2013   1            0   N, NO USED GROUPS    44 VIEW.SYSTEM1.SARTAPE.T0000044 479202     1    0     0 10/28/2013   1            0   N, NO USED GROUPS    45 VIEW.SYSTEM1.SARTAPE.T0000045 427576     1    0     0 10/28/2013   1            0   N, NO USED GROUPS    46 VIEW.SYSTEM1.SARTAPE.T0000046 428393     0    0       10/28/2013   1            0   N, NO USED GROUPS    47 VIEW.SYSTEM1.SARTAPE.T0000047 428119     7    6    85 10/28/2013   1        75600   N, CURRENT BACKUP
SARPAC Tape Status List Fields
The following fields are provided in the report:
  • Tape sequence numbers by which
    View
    references the tapes.
    Note:
    These numbers may not be the same as the T
    nnnnnnn
    qualifier of the data set name when the tapes were created by a database which was later merged into this database.
  • Data set name
  • Volume serial number
  • Total SYSOUT groups written to this tape by either one or more backup cycles or previous tape consolidation executions.
  • Number of SYSOUT groups that are currently active, that is, not expired or deleted.
  • Percentage of the SYSOUT groups that are currently active -- this is a simple percentage of:
    (active SYSOUT groups / total SYSOUT groups) * 100
    Note:
    This number does not represent the percentage of actual tape usage.
  • Creation date
  • Number of years (rounded up) from the date the tape was created
  • Indication that a duplex tape exists
  • Total number of lines for all active SYSOUT groups.
    Note:
    This does not represent the number of lines originally written to the tape.
  • Indication that SARPAC processed the tape and the corresponding remarks
Remarks Field of Tape Status List
The following list explains the remarks in the PROCESSED YES/NO, REMARKS field of the Tape Status List:
  • Y, BELOW PTHRESH %
    Indicates the percentage below PTHRESH initialization parameter.
  • Y, CONTINUATION TAPE
    Indicates that the tape is to be mounted only to retrieve the remaining part of a continued report.
  • Y, EXCEEDS PMXYEARS
    Indicates that the value exceeds the PMXYEARS initialization parameter.
  • Y, EXIT SELECTED
    Indicates that the tape is marked for selection by the user exit SARPACUX.
  • Y, MERGED DATABASE
    Indicates that the tape belongs to a merged database.
  • Y, SYSIN INCLUDED
    Indicates that the tape is selected for processing and that the tape sequence number is within the range specified.
  • N, ABOVE PTHRESH %
    Indicates the percentage above PTHRESH initialization parameter.
  • N, CURRENT BACKUP
    Indicates that the current tape is never processed.
  • N, EXCEEDS PMXTAPES
    Indicates that the value exceeds the PMXTAPES initialization parameter.
  • N, EXIT EXCLUDED
    Indicates that the tape is marked for exclusion by exit SARPACUX.
  • N, NO USED GROUPS
    Indicates that there are no reports on the tape to copy.
  • N, CONTINUATION TAPE
    Indicates that the tape only contains a report that is continued from a previous tape, and that the tape is not being processed.
  • N, INDEX ONLY
    Indicates the following:
    • There are no reports on the tape to copy.
    • The tape has not been deleted because it contains current backup copies of the master index (NGENI=).
  • N, SYSIN EXCLUDED
    Indicates that the tape sequence number is not within the specified range.
SARPAC Copied SYSOUT Groups Report
The second report lists the copied SYSOUT groups. This is a sample of the SARPAC Copied SYSOUT Groups Report.
11/10/2013 14:30:11                     CA <view> Output Archival and Viewing (nn.n)                               Page     1 SARPAC                      Expanded Retention Option (ERO) Tape Consolidation - Copied Sysout Groups                                                                                                                   Id                               Jobname  Jobid     Gen  Seq Arc Date   Time   Xcode Loc   Lines  Pages  Blocks  Tvser  Duplex  Tseq -------------------------------- -------- -----     ---  --- ---------- -----  ----- ---- ------  -----   -----  ------  -----  ---- REPORT1                          COOCH03A JOB03282   21   12 10/13/2013 17:03        PTAP  11600    200       8  428029           48 REPORT1                          COOCH03A JOB05650   23    6 10/15/2013 19:25        PTAP  12600    200      33  428029           48 REPORT1                          COOCH03A JOB05651   23    7 10/15/2013 19:30        PTAP  12600    200      33  428029           48 REPORT1                          COOCH03A JOB05649   23    8 10/15/2013 19:30        PTAP 126000   2000     319  428029           48 REPORT1                          COOCH03A JOB05747   23    9 10/15/2013 21:28        PTAP  12600    200      33  428029           48 REPORT1                          COOCH03A JOB05748   23   10 10/15/2013 21:33        PTAP  12600    200      33  427770           49 REPORT1                          COOCH03B JOB05783   23   12 10/15/2013 22:00        PTAP  12600    200      33  427770           49 REPORT1                          COOCH03A JOB03455   23    1 10/13/2013 21:23        PTAP  11600    200       8  427770           49 SARPAC11  0000008 SYSOUT GROUPS COPIED
SARPAC Copied SYSOUT Groups Report Fields
The following fields are provided in the report.
  • SYSOUT identifiers
  • Name of the job that created the SYSOUT
  • JOBID of the job that created the SYSOUT
  • Archival generation number
  • SYSOUT sequence number for the generation
  • Archival date and time
  • Last print date and time
  • Location of the SYSOUT group
  • Number of lines
  • Number of pages
  • Number of blocks on tape for the report, any indices it may have, and mapping information
  • Exception condition
  • Volume serial numbers of the output tape, if duplexing is being done
  • Tape sequence number by which
    View
    references the output tape