**** START OF SPECIFICATIONS ***************************************** * * **** MODULE NAME = APSGUSR1 * * * **** COMP(APS) PROD(PSF) : RELEASE 3.1.0 * * * **** DESCRIPTIVE NAME = PSF FOR OS/390 USER'S GUIDE UPDATES * * * **** STATUS = VERSION 3, RELEASE 1, LEVEL 0 * * * **** FUNCTION = * * * * THIS MODULE CONTAINS ALL OF THE UPDATES TO THE PSF * * FOR OS/390 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 = * * $00=LAPS0007, HPRF310, 980826 BDKURLD: INITIAL VERSION * * $01=OW38168, HPRF220, 990322, BDKURLD: Specify PRMODE via * * exit 07 * * $02=OW36784, HPRF310,990604,BDKULD: Support Infoprint Color 100. * 00540000 * Device type 3170-3A. * 00560000 * $03=OW42106, HPRF310,991104,BLDCWJ: loop when small page * * length set at printer * * $04=OW43531, HPRF310,000313,BLDELJ: Clarify OFFSETxx values * * * **** END OF SPECIFICATIONS ******************************************* All of the following changes are for the PSF for OS/390 User's Guide (S544-5630-00). -----------CHANGES FOR OW38168---------------------------------- 15310000 15320000 1. On page 138, under the section titled "Using Shift-Out, Shift-In 15330000 (SOSI) Codes", change the first paragraph to read : 15340000 15350000 A data set that contains both single-byte and double-byte character 15360000 codes may necessitate coding the structured fields in the data set to 15370000 change from 1 kind of character code to the other. To avoid doing this,15380000 you can instruct PSF to provide special processing by specifying 15390000 PRMODE=SOSI1, PRMODE=SOSI2, or PRMODE=SOSI3 in your JCL; or by 15400000 specifying a default PRMODE of SOSI1, SOSI2 or SOSI3 using APSUX07. 15410000 For more information on specifying a default PRMODE in APSUX07, see the 15420000 PSF/MVS System Programming Guide "Considerations Related to Setting a 15430000 a Default for PRMODE" in Chapter 17, "Using Installation Exits". The 15440000 data set can then contain the shift-out code, X'0E', and the shift-in 15450000 code, X'0F', to indicate to PSF when a font change is required. PSF 15460000 converts the shift-out and shift-in codes to Set Coded Font Local text 15470000 controls, described in Mixed Object Document Content Architecture 15480000 Reference. 15490000 15500000 15510000 2. On page 138, under the section titled "Using Shift-Out, Shift-In 15520000 (SOSI) Codes", after the third paragraph, add: 15530000 15540000 Note: When the PRMODE keyword is specified in the OUTPUT JCL, it 15550000 supersedes the default PRMODE specified in APSUX07. 15560000 15570000 When a default PRMODE is specified for both the Initialization 15580000 and the Begin-Data-Set Calls in APSUX07, the Begin-Data-Set 15590000 specification supersedes the Initialization specification of 15600000 PRMODE. 15610000 -----------CHANGES FOR OW36784---------------------------------- 1. On page 34, section "Object Container Resources", first paragraph, second sentence: change from: ... setup resource and color mapping table resource. change to: ... setup resource, color mapping table resource and Encapsulated PostScript resource. On page 35, after subsection "Color Mapping Table (CMT) Resource", add subsection: Encapsulated PostScript (EPS) Resource An Encapsulated PostScript resource which can contain any combination of text, graphics, and images may now be included along with AFPDS data and printed on an IPDS printer. For more information, see page 127, Using Encapsulated PostScript (EPS) Resources. 2. On page 121, section "Printing with Inline Resources" first paragraph: change from: , and color map tables, in addition ... change to: , color map tables, and Encapsulated PostScript (EPS) resources, in addition ... 3. On page 127, after section "Using Color Mapping Table Resources", add section: Using Encapsulated PostScript (EPS) Resources The EPS resources must be in a PSF system object container library, in a user library specified by the USERLIB parameter, or coded inline as part of the print data set. The EPS is included by an IOB structured field in the input data set. For more information on object containers, see Mixed Object Document Content Architecture (MO:DCA) Reference. o If an EPS resource is inline as part of the print data set, the resource must be contained within an object container. o If an EPS resource is placed in a library, system or user, the resource may or may not be contained within an object container. o For an EPS resources contained within an object container, the library is defined with carriage controls. o For an EPS resources not contained within an object container, the library is defined without carriage control. These librarie may be concatenated with libraries that do have carriage controls. IBM recommends the prefix of E1 for the names of all EPS resources to avoid naming conflicts with other object container resources. However, IBM does not enforce a prefix for the 8-character name of the EPS resource. -----------CHANGES FOR OW42106---------------------------------- 00640000 On page 55, under FORMLEN= keyword, add a new paragraph after third paragraph: The FORMLEN keyword should only be specified in the USER's JCL OUTPUT statement. If the FORMLEN keyword is specified on an OUTPUT statement in the PSF startup procedure, it is ignored. The FORMLEN keyword value specified in the USER's JCL OUTPUT statement is used for all pages in the dataset including the job header, job trailer, dataset header, message dataset, and interrupt message page. The FORMLEN keyword will not be used for JESNEWS pages. JES creates a separate dataset for JESNEWS which does not have the JCL values of the user dataset. JES2 puts the JESNEWS on the the job header page and the form length value comes from the formdef for the job header. JES3 puts the JESNEWS on the job trailer page and the form length value comes from the formdef for the job trailer. Note: PSF uses the XOH Set Media Size (SMS) command to set the printer's physical printable area in the length direction using the FORMLEN value. Although some printers use the SMS values unconditionally, some do not. See your printer hardware manual to determine how SMS is used by the printer. -----------CHANGES FOR OW43531---------------------------------- 15310000 1. On page 56 under OFFSETXB following POINTS, add If you specify the unit as pels or points, you must specify the value as a whole number with no decimal point. 2. On page 57 under OFFSETXF following POINTS, add If you specify the unit as pels or points, you must specify the value as a whole number with no decimal point. 3. On page 57 under OFFSETYB following POINTS, add If you specify the unit as pels or points, you must specify the value as a whole number with no decimal point. 4. On page 57 under OFFSETYF following POINTS, add If you specify the unit as pels or points, you must specify the value as a whole number with no decimal point.