**** 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. * * Device type 3170-3A. * * $03=OW42106, HPRF310,991104,BLDCWJ: loop when small page * * length set at printer * * $04=OW43531, HPRF310,000313,BLDELJ: Clarify OFFSETxx values * * $05=OW46391, HPRF310,001016,BDKUEAS: Clarify CHARS= explanation * * $06=OW46869, HPRF310,001113,BLDSCM: Announce media OID support * * $07=OW49620, HPRF310,010614,BLDRLB: Fix Machine CC note. * * * **** END OF SPECIFICATIONS ******************************************* All of the following changes are for the PSF for OS/390 User's Guide (S544-5630-00). -----------CHANGES FOR OW38168---------------------------------- 1. On page 138, under the section titled "Using Shift-Out, Shift-In (SOSI) Codes", change the first paragraph to read : A data set that contains both single-byte and double-byte character codes may necessitate coding the structured fields in the data set to change from 1 kind of character code to the other. To avoid doing this, you can instruct PSF to provide special processing by specifying PRMODE=SOSI1, PRMODE=SOSI2, or PRMODE=SOSI3 in your JCL; or by specifying a default PRMODE of SOSI1, SOSI2 or SOSI3 using APSUX07. For more information on specifying a default PRMODE in APSUX07, see the PSF/MVS System Programming Guide "Considerations Related to Setting a a Default for PRMODE" in Chapter 17, "Using Installation Exits". The data set can then contain the shift-out code, X'0E', and the shift-in code, X'0F', to indicate to PSF when a font change is required. PSF converts the shift-out and shift-in codes to Set Coded Font Local text controls, described in Mixed Object Document Content Architecture Reference. 2. On page 138, under the section titled "Using Shift-Out, Shift-In (SOSI) Codes", after the third paragraph, add: Note: When the PRMODE keyword is specified in the OUTPUT JCL, it supersedes the default PRMODE specified in APSUX07. When a default PRMODE is specified for both the Initialization and the Begin-Data-Set Calls in APSUX07, the Begin-Data-Set specification supersedes the Initialization specification of PRMODE. -----------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---------------------------------- 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---------------------------------- 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. -----------CHANGES FOR OW46391---------------------------------- On page 43, remove the second sentence of the third paragraph, which reads "If PSF receives MO:DCA data in which no fonts are specified, PSF uses the fonts specified in the JCL." -----------CHANGES FOR OW46869---------------------------------- 1. On page 83, under the section titled "Specifying Paper Source", add the following as the second,third & fourth paragraphs: You can also select the paper source by specifying a component ID (such as 50 for letter-size paper) and / or media name (such as LETTER for letter-size paper). This frees you from knowing which BIN has the paper you wish to use. For more information, refer to IBM Page Printer Formatting Aid: User's Guide. If a component ID is specified in the form definition, PSF uses the component ID to select the paper source. If no component ID is specified or it is not found in the printer, PSF uses the media name, if specified, to select the paper source. If no media name is specified or it is not found in the printer, PSF uses the bin number specified. If no bin number is specified or it is not found in the printer, PSF uses the default paper source. Some printers only support bin numbers, some support bin numbers and media names, some support bin numbers and component IDs, and some support bin numbers, media IDs and component IDs. By specifying all three ways of selecting a paper source, you can free yourself from knowing which bin a paper type is loaded in on those printers with media name and / or component ID support and still be able to print with a bin number on those printers that only support bin numbers. -----------CHANGES FOR OW49620---------------------------------- On page 133, replace the note following Table 4 with the following: Note: PSF ignores the following hexadecimal machine code control characters and does not print lines containing them: 02 through 07, 0A, 12, 23, 43, 63, 6B, 73, 7B, EB, F3, and FB. PSF treats any other machine code control value not listed in the table and not listed above as invalid and prints any data on the line using single spacing.