**** 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
* $03=OW57333, HPRF330,021204,BDKUMLC: 3800 Compatibility Formdefs * 02478000
* *
**** 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.
-----------CHANGES FOR OW57333----------------------------------
1. On page 184, under the section "Compatibility Form
Definitions for the 3831, 3835, and 3900 Printers".
Change the section heading to "Compatibility Form
Definitions".
2. On page 184, under the section "Compatibility Form
Definitions for the 3831, 3835, and 3900 Printers". Change
the first paragraph to the following, but leave the two
bullets.
Table 17 and Table 18 describe compatibility form
definitions supplied with PSF that can be used to print data
formatted for the 3800 or cut-sheet printers on a AFCCU
continuous-forms printer such as a 3900, InfoPrint 3000, or
InfoPrint 4000/4100. Use one of the compatibility form
definitions when printing the following on a continuous forms
printer:
3. On page 184, change the heading on Table 17 to read,
Table 17. Compatibility Form Definitions for AFCCU
continuous forms printers.
4. On page 184, remove the paragraph located below Table 17.
5. On page 185, change the heading on Table 18 to read,
Table 18. N_UP Compatibility Form Definitions for AFCCU
continuous forms printers.
6. On page 185, add the following new paragraphs and table
after Table 18.
Table 18.5 describes compatibility form definitions
supplied with PSF that can be used to print data formatted
for the 3800 printer on a cut-sheet printer such as the
Infoprint 11XX series, Infoprint 2000, and Infoprint
2085/2105. Use one of the compatibility form definitions when
printing the following on a cut-sheet printer:
o Data formatted for either portrait or landscape
presentation on a 3800 printer. The form definition used
depends on whether the data was formatted for printing
on wide or narrow paper.
Table 18.5 3800 Compatibility Form Definitions for
cut-sheet printers.
----------------------------------------------------------------
|Form |Compatible |Presentation| Print |Duplex|Page |
|Defintion|With | Mode |Direction| |Position,|
|Name | | | | |In Inches|
|---------|------------|------------|---------|------|---------|
|F1C010LA |3800 printer| landscape | across |Duplex| 0, 0.50 |
| |wide forms | | |off | |
|---------|------------| -----------|---------|------|---------|
|F1C010PD |3800 printer| portrait | down |Duplex| 0, 0.50 |
| |wide forms | | |off | |
|---------|------------| -----------|---------|------|---------|
|F1C010LD |3800 printer| landscape | down |Duplex| 0, 0.50 |
| |narrow forms| | |off | |
|---------|------------| -----------|---------|------|---------|
|F1C010PA |3800 printer| portrait | across |Duplex| 0, 0.50 |
| |narrow forms| | |off | |
|---------|------------| -----------|---------|------|---------|
|F1C011LA |3800 printer| landscape | across |Normal| 0, 0.50 |
| |wide forms | | |duplex| |
|---------|------------| -----------|---------|------|---------|
|F1C011PD |3800 printer| portrait | down |Normal| 0, 0.50 |
| |wide forms | | |duplex| |
|---------|------------| -----------|---------|------|---------|
|F1C011LD |3800 printer| landscape | down |Normal| 0, 0.50 |
| |narrow forms| | |duplex| |
|---------|------------| -----------|---------|------|---------|
|F1C011PA |3800 printer| portrait | across |Normal| 0, 0.50 |
| |narrow forms| | |duplex| |
|---------|------------| -----------|---------|------|---------|
|F1C012LA |3800 printer| landscape | across |Tumble| 0, 0.50 |
| |wide forms | | |duplex| |
|---------|------------| -----------|---------|------|---------|
|F1C012PD |3800 printer| portrait | down |Tumble| 0, 0.50 |
| |wide forms | | |duplex| |
|---------------------------------------------------------------
|F1C012LD |3800 printer| landscape | down |Tumble| 0, 0.50 |
| |narrow forms| | |duplex| |
|---------|------------| -----------|---------|------|---------|
|F1C012PA |3800 printer| portrait | across |Tumble| 0, 0.50 |
| |narrow forms| | |duplex| |
|---------|------------| -----------|---------|------|---------|