Summary reports

An AFP Statistics (AFPSTATS) report is available in PSF to produce summary data about the resources used to print a document. The data in the report identifies resources used, describes how a resource is specified to PSF, and indicates the resource library (also called the repository) from which the resource is obtained.

The AFPSTATS report summarizes these resource types:

• Character sets
• Coded fonts
• Code pages
• Form definitions
• Object containers
• Overlays
• Page definitions
• Page segments
• TrueType and OpenType fonts
• Printer-resident fonts with a 16-digit global resource identifier (GRID)

The AFPSTATS report provides print file processing details that let you:

• Determine in which resource libraries PSF found each resource
• Determine whether PSF attempted to reload a resource and whether the reload completed, failed, or was ignored
• Determine whether PSF attempted to substitute one resource for another and whether the substitution completed or was ignored
• Determine whether one font was mapped to another
• Determine whether an inline resource was not used
• Diagnose some resource selection problems
• Obtain statistical data about how a print file is printed, such as the total number of pages, the number of times a specific resource was referenced, and the number of significant events
• Diagnose some print file printing performance problems

To generate an AFPSTATS report for a print file, the system programmer must first define an AFPSTATS repository, which is a partitioned data set where AFPSTATS reports are written. You define the repository with the AFPSTATS DD statement in the PSF startup procedure and then allocate the data set. After the AFPSTATS repository is defined and allocated, an AFPSTATS report can be requested for a print file by:

• Specifying the AFPSTATS keyword on the OUTPUT JCL statement. See PSF for z/OS: User’s Guide.
• Using the XTP7ASAP flag in Exit 7.

The print file owner can use the OUTPUT JCL statement to request an AFPSTATS report for any PSF print file he or she owns; however, if XTP7ASAP is changed by the installation exit, it overrides the OUTPUT statement.

For information about defining an AFPSTATS repository and using Exit 7 to request an AFPSTATS report, see PSF for z/OS: Customization.

When an AFPSTATS report is written to the AFPSTATS repository, you can view it as a softcopy report or format it as a hardcopy report and print it.

For more information about the AFPSTATS report, including the format of a softcopy or hardcopy AFPSTATS report, see PSF for z/OS: User’s Guide.