**** START OF SPECIFICATIONS ***************************************** * * **** MODULE NAME = APSGUSR3 * * * **** COMP(APS) PROD(PSF) : RELEASE 3.3.0 * * * **** DESCRIPTIVE NAME = PSF FOR OS/390 & z/OS USER'S GUIDE UPDATES * * * **** STATUS = VERSION 3, RELEASE 3, LEVEL 0 * * * **** FUNCTION = * * * * THIS MODULE CONTAINS ALL OF THE UPDATES TO THE PSF * * FOR OS/390 & z/OS USER'S GUIDE SINCE THE LAST PUBLISHED * * VERSION OF THE MANUAL. * * * * THE UPDATES ARE PUT IN THE SAME FORMAT AS THEY WERE BEING * * PUT IN THE DOC ++HOLDS. * * * * EACH TIME A NEW APAR HAS UPDATES THE CHANGE ACTIVITY WILL * * BE UPDATED AND A NEW SECTION WILL BE ADDED TO THE END OF THIS * * MODULE PRECEDED BY A LINE THAT DENOTES THE APAR NUMBER. * * * * DO **NOT** GO PAST COLUMN 64 WITH YOUR DOC CHANGES. THE END OF * * THE DASHED LINES WITH YOUR APAR NUMBER IN THE TEXT INDICATE * * COLUMN 64. * * * **** RESTRICTIONS * * * * DO NOT EDIT OR UPDATE THIS FILE ON SAMPLIB AS THE * * NEXT APAR THAT CHANGES THIS MODULE WILL DO A TOTAL REPLACE * * OF IT THUS OVERLAYING YOUR CHANGES. IF YOU WISH TO MAKE * * CHANGES TO THIS MODULE THEN DO IT IN YOUR OWN COPY OF THIS * * MODULE. * * * * *** CHANGE ACTIVITY = * * $B0=LAPS0009,HPRF330,020131,BDKURLD: INITIAL VERSION * * $01=OW53285, HPRF330,020131,BDKURLD: Rollup d-apar * * $02=OW54452, HPRF330,020430,BDKURLD: Add message for exit 07 * 00400000 * changing AFPSTATS parameter * 00410000 * * **** END OF SPECIFICATIONS ******************************************* All of the following changes are for the PSF for OS/390 & z/OS User's Guide (S544-5630-02). -----------CHANGES FOR OW53285---------------------------------- 1. On page 149 - Add the following subsections to the end of the section titled "Printing XML Data". Element Content When PSF parses the element content: - Leading and trailing space characters are removed and sequences of space characters are replaced by a single space character. If a sequence of space characters are part of a CDATA section, the sequence is left intact. - Any data that follows a nested element is ignored. For example: Here is some data. This element is nested. This follows a nested element. The data "This follows a nested element." will be ignored by PSF. External Entities PSF does not parse external entities. Supported Encoding Schemes and Conversions The encoding schemes supported by PSF for the XML data are: - EBCDIC (Single-byte only) - ASCII (Single-byte only) - UTF-8 - UTF-16 XML data encoded in UTF-16 can use either little endian byte order or big endian byte order. PSF checks the first two bytes of the data for the Byte Order Mark. If the Byte Order Mark indicates little endian byte order, PSF converts the data to big endian byte order. Fonts supported by PSF do not support the little endian byte order. The encoding schemes supported for font code pages in a Page Definition to print XML data are: - EBCDIC (Single-byte only) - ASCII (Single-byte only) - Unicode Presentation (which is UTF-16 without surrogate support) PSF checks the encoding of the XML data against the font encoding to see if the XML data needs to be converted to another encoding. PSF will convert the XML data from: - ASCII or UTF-8 to UTF-16 if the font encoding is Unicode Presentation. PSF assumes the ASCII or UTF-8 data will convert to UTF-16 without surrogates. - UTF-16 to UTF-8 if the font encoding is ASCII. PSF assumes the UTF-16 data will convert to the equivalent of Single-byte ASCII when the data is converted to UTF-8. ASCII is a proper subset of UTF-8. EBCDIC data requires EBCDIC fonts and will not be converted. JCL Parameters These JCL parameters are ignored when printing XML data: - OPTCD=J - TRC - UCS - CHARS In addition, the carriage control character specification on the RECFM subparameter of the DCB parameter is also ignored. Carriage control characters are not valid in XML data. 2. On page 160 - Add this new section after the section titled "Format": Softcopy Records The softcopy report is composed of records that begin with a 10-character Layout ID. The following table lists all the possible softcopy records and describes how the record is used. Layout ID Purpose COMMENT This record is used to add any text string to the report. Usually this record is used to insert blank lines in the report to make it more readable. EVENT The EVENT record identifies significant events that occurred during PSF processing. For example, a "Repositioning" event indicates PSF is repositioning itself to a different point in the input data stream. This could be because of an operator request to backspace, an I/O error, or normal PSF processing. EVENT-LIST PSF uses this record to record each event in a list of events that occurred while processing the print file. HEADING Any part of the softcopy report that is presented in a tabular format starts with headings in a HEADING record. HEADING-DP This record contains the headings for the SUMM-DISP report sub-section. HEADING-EL The headings for the Significant Events sub- section are in this record. HEADING-LC The HEADING-LC record has the headings for the Resource Summary by Resource Type, Reference Summary report sub-section. HEADING-RF This record contains the headings for the SUMM-REF report sub-section. HEADING-SP The headings for the Summary of Pages sub- section are in this record. NOTE This record is used to add important comments to the report. PAGEFOOTER This record is used to identify the page footer to be used in the hardcopy report. It is usually the same as the section TITLE record. PRINTFILE The PRINTFILE record identifies the print file being processed when the report was generated. It also presents some information about PSF and identifies the printer. REPORTLVL Due to service and future PSF development, this report format could change. The REPORTLVL record identifies the specific report format level. RESOURCE This record identifies individual resources used, in the order they are processed by PSF. SECTION A report section might be divided into smaller parts or sub-sections. The SECTION record identifies report sub-sections. SUMM-DSN Resources are obtained by PSF from resource repositories identified to it in the PSF startup procedure or in the USERLIB OUTPUT JCL statement. This record identifies a repository or data set from which PSF has retrieved a resource. SUMM-DSN-R This record contains a list of up to six resources that were retrieved from the resource repository defined in a SUMM_DSN record. SUMM-NAME The SUMM-NAME record identifies a resource and provides statistics about how the resource was introduced, where PSF found the resource, and how the resource request was satisfied by PSF. SUMM-DISP In the SUMM-DISP record, PSF identifies a resource type and how PSF satisfied the resource request for that type of resource. SUMM-LOC PSF might locate resources in various resource repositories, for example, inline, user specified libraries, and system libraries. This record identifies a resource type and where PSF found the resources of that type. SUMM-PAGE The SUMM-PAGE record provides statistics about the source print file such as, number of pages processed, page size, and number of records. SUMM-REF Each SUMM-REF record identifies a resource type and the various ways this resource type was referenced. TITLE The AFP Statistics report is composed of several report sections. The TITLE record identifies the report section. 3. On page 162 - Add the following REPORTLVL record description after the record description for the COMMENT record: The REPORTLVL record identifies the AFP Statistics report level. (This record can be used to identify changes to the AFP Statistics report format.) ================================================================ OFFSET OFFSET DECIMAL HEX LENGTH ======== ======== ======== =============================== 0 (0) 10 Layout ID Value: REPORTLVL 10 (A) 2 Reserved 12 (C) 1 Column separator 13 (D) 8 Report ID Value: AFPSTATS 21 (15) 1 Column separator 22 (17) 8 PSF Version. example: 3.3.0 30 (1E) 1 Column separator 31 (1F) 4 Report level value: 0000 35 (23) 1 Column separator 36 (24) 30 Report description Value: PSF AFP Statistics Report 4. On page 170 - Section Sample Softcopy Report - in the sample softcopy report, add a new record just prior to the first TITLE record: REPORTLVL AFPSTATS 3.3.0 0000 PSF AFP Statistics Report 5. On page 172 - Add a new line above the report section title of Print File Information and centered on the landscape page: PSF AFP Statistics Report - 3.3.0 Level 0000 -----------CHANGES FOR OW54452---------------------------------- 1. On page 159 add the following to the NOTE at the bottom of the page under "Requesting an AFPSTATS Report". If the value is overridden by Exit 7, then informational message APS7004I is printed in the message data set.