**** START OF SPECIFICATIONS ***************************************** * * **** MODULE NAME = APSGCUS1 * * * * COMP(APS) PROD(PSF) : RELEASE 3.1.0 * * * **** DESCRIPTIVE NAME = PSF FOR OS/390 CUSTOMIZATION UPDATES * * * **** STATUS = VERSION 3, RELEASE 1, LEVEL 0 * * * **** FUNCTION = * * * * THIS MODULE CONTAINS ALL OF THE UPDATES TO THE PSF FOR * * OS/390 CUSTOMIZATION 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 = * * $01=OW40075, HPRF310,990709,BDKUELJ: Clarify CONNINTV * * $02=OW39224, HPRF310,990525,BDKUMLC: FICON bridge support * * $03=0W40173, HPRF310,990726,BDKUELJ: Don't RELDS on repos * * $04=OW40455, HPRF310,990805,BDKULD : APSRCF30 - DBCS warning * * $05=OW40737, HPRF310,990815,BDKURLD: Suppress copy marks * * $06=0W40839, HPRF310,990831,BDKURLD: Provide data set id to exits * * $07=OW37851, HPRF310,990901,BDKUELJ: Printer inventory * * $08=OW41213, HPRF310,991005,BDKUELJ: Reposition hangs with JES3 * * $08=OW41385, HPRF310,991012,BDKUELJ: XTP7RSV1 * * $09=OW42106, HPRF310,991104,BLDCWJ: loop when small page * * length set at printer * * $10=OW42719, HPRF310,000111,BLDCWJ: APS502I issued * * $11=OW42117, HPRF310,000114,BLDDDA: Add sample exit APSUX15M * * $12=OW43463, HPRF310,000302,BDKURLD: Change XTP6PROC * * $13=OW41991, HPRF310,000321,BDKULMM: Enable inline capture with * * WPM * * $14=OW44660, HPRF310,000524,BDKURLD: Indicate simplex/duplex * * * **** END OF SPECIFICATIONS ******************************************* All of the following changes are for the PSF for OS/390 Customization (S544-5622-01). -----------CHANGES FOR OW40075---------------------------------- 1. On page 58 in Table 2 under Connect Interval, replace the sentence which starts For SNA, the connect interval... with For SNA, the connect interval is set when a session request is queued after a busy or a not available condition has occurred. If a VTAM condition such as LU NOT ACTIVE occurs, PSF retries 16 times and then terminates without using the connect interval. -----------CHANGES FOR OW39224---------------------------------- 1. On page 6 under the section "Using ESCON Channel-Attached Printers" change the first sentence in the second paragraph to read, "With an ESCON channel card in the printer, you can attach the printer to an ESCON channel or attach it to a FICON Bridge Card in an ESCON Director. For more information about the FICON Bridge Card, refer to the appropriate ESCON Director manual." 2. On page 7 change the second sentence in the fourth paragraph to read, "When adding an ESCON channel-attachable printer, you can attach it to an ESCON channel(type=CNC) or to a FICON Bridge Card(type=FCV) in an ESCON Director. For more information about the FICON Bridge Card, refer to the appropriate ESCON Director manual." 3. On page 90 under the section "Sharing ESCON Channel-Attached Printers" replace the first sentence of the first paragraph with the following two sentences: "An ESCON channel-attachable printer can be shared among multiple PSF hosts, but it can only be in use by one PSF at a time. The ESCON channel-attachable printer can be natively attached to an ESCON channel or attached to a FICON Bridge Card in an ESCON Director. For more information about the FICON Bridge Card, refer to the appropriate ESCON Director manual." 4. On page 144 under the section "Host-Connected, Channel-Attached Printer" change the first sentence of the third paragraph to read, "With the ESCON channel card installed in a printer, the printer can be attached to the host with an ESCON channel or indirectly to the host with a FICON Bridge Card in an ESCON Director, which can send and receive data faster than a parallel S/370 channel." 5. On page 144 under the section "Host-Connected, Channel-Attached Printer" add the following sentence after the last sentence of the third paragraph, "For more information about the FICON Bridge Card, refer to the appropriate ESCON Director manual." 6. On page 297 in the first section at the top of the page, add the following sentence after the first sentence in the first paragraph, "The ESCON-attached microfilm device can be natively attached to an ESCON channel or attached to a FICON Bridge Card in an ESCON Director. For more information about the FICON Bridge Card, refer to the appropriate ESCON Director manual." 7. On page 297 under the second section "Defining the Microfilm Device to OS/390 or MVS", add the following sentence after the first sentence in the paragraph, "The ESCON-attached microfilm device can be natively attached to an ESCON channel or attached to a FICON Bridge Card in an ESCON Director. For more information about the FICON Bridge Card, refer to the appropriate ESCON Director manual." -----------CHANGES FOR OW40173---------------------------------- 1. On page 279 under Normal PSF Recovery, add a new sub-section at the end of the page Disposition of Spool Data Sets During Repositioning PSF will retain the spool data sets it has obtained from JES while it is repositioning to handle an exception reported by the printer, such as a paper jam or a page adjust. This prevents the reordering of print data sets as a result of repositioning. This is a change from earlier PSF design and can be overridden by APSUX07 on the INIT call by setting XTP7RDSR on. 2. On page 348 add the following after XTP7CINR in Figure 72. .... .1.. XTP7RDSR RELEASE DATA SETS WHEN REPOSITIONING (VALID FOR INITIALIZATION "XTP7INIT") 0 = DO NOT RELEASE DATA SETS WHEN REPOSITIONING 1 = RELEASE DATA SETS WHEN REPOSITIONING 3. On page 357 add the following after XTP7CINR. XTP7RDSR Valid only on the INIT call. PSF initially sets this field to B'0' to indicate that PSF will not release spool data sets during repositioning. IF APSUX07 sets this flag to B'1', PSF will release data sets during repositioning and then reacquire them after printing restarts. See "Disposition of Spool Data Sets During Repositioning" on page 279. 4. On page 372 in Table 29 add XTP7RDSR after XTP7CINR with an 'IO' in the INIT column. -----------CHANGES FOR OW40455---------------------------------- 1. On Page 377, Appendix H. Font Conversion Program, after the second paragraph, add this note. NOTE: APSRCF30 converts 240 pel single byte raster fonts to 300 pel raster fonts. It cannot convert 240 pel double byte raster fonts. Higher resolution double byte fonts are available with double byte outline fonts in the AFP Font Collection, Version 2. APSRCF30 converts a 240 pel single byte raster font to a close approximation of the font at 300 pel resolution. However, IBM does not warrant the quality of the resulting character pattern when using this utility. -----------CHANGES FOR OW40737---------------------------------- 1. On page 123 under "Copy Marking and Offset Stacking" change the 2nd sentence that begins "Copy marking and offset stacking are controlled......" to read as follows. Copy marking and offset stacking are controlled by the following JES initialization parameters. Copy marking can be suppressed by APSUX07. 2. On page 123 after the bulleted list, add the following new sub-section. Suppressing Copy Marks If no copy marks are desired, they can be suppressed by setting XTP7SUCM in APSUX07. See XTP7SUCM on page 357 for more details. 3. On page 255 add the following bulleted item to the list at the bottom of the page. o Suppress the printing of copy marks. See XTP7SUCM on page 357. 4. On page 348 add the following after XTP7RDSR (added by OW40173) in Figure 72. .... ..1. XTP7SUCM SUPPRESS COPY MARKS (VALID FOR INITIALIZATION "XTP7INIT" AND BDSC "XTP7BDS") 0 = DO NOT SUPPRESS COPY MARKS 1 = SUPPRESS COPY MARKS 5. On page 358 add the following after XTP7RDSR (added by OW40173). XTP7SUCM Valid only on the INIT and BDSC calls. PSF initially sets this field to B'0' to indicate that PSF will tell the printer to print copy marks as specified by the JES initialization parameters. IF APSUX07 sets this flag to B'1', PSF will tell the printer to suppress copy marks. 6. On page 372 in Table 29 add XTP7SUCM after XTP7RDSR (added by OW40173) with an 'IO' in the INIT and BDSC columns. -----------CHANGES FOR OW40839---------------------------------- 1. On page 224 in Figure 56 under ECEDSID, remove the line that says "(in Download for OS/390 only)." -----------CHANGES FOR OW37851---------------------------------- 1. On page 75 in table 2, add the following entry ------------------------------------------------------------- | ISPF Panel | PIDU | |-----------------------------|-----------------------------| |Release DS when repositioning|Release-DS-when-repositioning| | | | | Values: | Values: | | / = Yes | yes | | blank = No | no | ------------------------------------------------------------- ... ------------------------------------------------------------- | Equivalent Parameter | Description | |----------------------|------------------------------------| | XTP7RDSR | Specifies whether PSF is to release| | | spool data sets it has obtained | | | from JES when it is repositioning | | | to handle an exception reported by | | | the printer, such as a paper jam or| | | a page adjust. Releasing data sets | | | may cause the print data sets to | | | be reordered when printing resumes.| | | The default is NO, which indicates | | | that PSF will not release data sets| | | when repositioning. See | | | "Disposition of Spool Data Sets | | | During Repositioning" on page 279. | ------------------------------------------------------------- Note: This parameter was added to the Infoprint Server for OS/390 Printer Inventory with APAR OW40904. 2. On page 79 in table 2, add the following entry ------------------------------------------------------------- | ISPF Panel | PIDU | |-----------------------------|-----------------------------| |Suppress copy marks |Suppress-copy-marks | | | | | Values: | Values: | | / = Yes | yes | | blank = No | no | ------------------------------------------------------------- ... ------------------------------------------------------------- | Equivalent Parameter | Description | |----------------------|------------------------------------| | XTP7SUCM | Specifies whether PSF is to tell | | | the printer to suppress copy marks.| | | See "Suppressing Copy Marks" on | | | page 123 for more information. | ------------------------------------------------------------- Note: This parameter was added to the Infoprint Server for OS/390 Printer Inventory with APAR OW40904. 3. On page 123 under "Copy Marking and Offset Stacking" change the 2nd paragraph that begins "Copy marking and offset stacking are controlled......" to read as follows. Copy marking and offset stacking are controlled by the following JES initialization parameters. Copy marking can be suppressed by specifying the Suppress copy marks parameter in the printer inventory or by specifying XTP7SUCM in APSUX07. 4. On page 123 replace the section "Suppressing Copy Marks", with Suppressing Copy Marks If no copy marks are desired, they can be suppressed by specifying the Suppress copy marks parameter in the Printer Inventory (See table 2) or by setting XTP7SUCM in APSUX07 (See XTP7SUCM on page 357). 5. On page 254 in table 20, add the following entries ------------------------------------------------------------- | XTP7RDSR | Release DS when | Specifies whether PSF is to | | | repositioning | release spool data sets it | | | | has obtained from JES when | | | | it is repositioning to handle| | | | an exception reported by the | | | | printer. See "Disposition of | | | | Spool Data Sets During | | | | Repositioning" on page 279 | | | | for more information. | |-----------------------------------------------------------| | XTP7SUCM | Suppress copy | Specifies whether PSF is to | | | marks | tell the printer to suppress | | | | copy marks. See "Suppressing | | | | Copy Marks" on page 123 for | | | | more information. | ------------------------------------------------------------- 6. On page 279 under "Disposition of Spool Data Sets During Repositioning" (added with OW40173), change the last sentence to This is a change from earlier PSF design and can be overridden by the Release data sets during repositioning parameter in the Printer Inventory or by setting XTP7RDSR on in the INIT call of APSUX07. 7. On page 357 change the paragraph added for OW40173 to XTP7RDSR This option can only be set by the Printer Inventory or on the INIT call. PSF initially sets this field to B'0' to indicate that PSF will not release spool data sets during repositioning. IF APSUX07 sets this flag to B'1', PSF will release data sets during repositioning and then reacquire them after printing restarts. See "Disposition of Spool Data Sets During Repositioning" on page 279. For information about specifying this option in the Printer Inventory, See Release DS when repositioning in Table 2 on page 75. 8. On page 357 change the paragraph added for OW40737 to XTP7SUCM This option can only be set by the Printer Inventory or on the INIT or BDSC calls. PSF initially sets this field to B'0' to indicate that PSF will tell the printer to print copy marks as specified by the JES initialization parameters. If APSUX07 sets this flag to B'1', PSF will tell the printer to suppress copy marks. For information about specifying this option in the Printer Inventory, See Suppress copy marks in Table 2 on page 79. -----------CHANGES FOR OW41213---------------------------------- 01040000 1. On page 279, add the following note after the section "Disposition of Spool Data Sets During Repositioning" (added by OW40173) 34660000 Note: JES3 had a restriction prior to OS/390 2.6 which required that PSF release data sets before repositioning. When PSF is running with JES3 on a system prior to OS/390 2.6, data sets will always be released when repositioning. In this case, the Release data sets during repositioning option from the Printer Inventory and the XTP7RDSR flag from APSUX07 are ignored. 34740000 -----------CHANGES FOR OW41385---------------------------------- 01040000 1. On page 348 add the following after XTP7SUCM (added by 35800000 OW40737) in Figure 69. 35810000 35820000 .... ...1 XTP7RSV1 RESERVED - DO NOT USE 35830000 35900000 7. On page 358 add the following after XTP7SUCM (added by OW40737). 35910000 35920000 XTP7RSV1 Reserved - Do not use 35930000 35980000 36300000 -----------CHANGES FOR OW42106---------------------------------- 01040000 1. On page 112 under OUTPUT, add the following after the existing description. The keywords honored on OUTPUT statements in the PSF startup procedure are shown in the following table. All other keywords are ignored on OUTPUT statements in the PSF startup procedure. Keyword Job Header Job Trailer DS Header Message Data Set --------------------------------------------------------------- CHARS honored honored honored honored COLORMAP honored honored honored honored COMSETUP honored honored honored honored COPIES honored ignored ignored ignored FORMDEF honored honored honored honored PAGEDEF honored honored honored honored PIMSG ignored ignored ignored honored RESFMT honored honored honored honored TRC honored honored honored honored -----------CHANGES FOR OW42719---------------------------------- Replace information in table 3 with the following: pg 85 OVLYDD Identifies the DD statement that specifies the default (required/ overlay libraries. optional o Optional if no attempt to print an overlay from the system overlay library. o Required if OVLY240 or OVLY300 is specified. The default library is used when print data does not have a resolution given. Syntax: OVLYDD=*.label pg 86 PSEGDD Identifies the DD statement that specifies the default (required/ page segment libraries. In addition to page optional) segments, the page segment library may contain IOCA, GOCA, and BCOCA resources. o Optional if no attempt to print a page segment from the system page segment library. o Required if PSEG240 or PSEG300 is specified. The default library is used when print data does not have a resolution given. Syntax: PSEGDD=*.label -----------CHANGES FOR OW42117---------------------------------- 01040000 1. On page 218, in section "Changing Exit Routines" of chapter "Using Installation Exits", add the following new entry to the table "PSF Exit Routines in SYS1.SAMPLIB": APSUX15M Sample source routine that provides an indication of whether the data set is the "first", "next", "last", or "only" dataset in the output group. Download for OS/390 will send the information via the -opa parameter to the AIX server daemon. This member is only installed in SYS1.SAMPLIB if Download for OS/390 is present. 2. On page 222 in Figure 55 (Part 1 of 2) replace ECALSTDS and its description and the following reserved field of ..11 1111 with the following. ******************************************************************** 00699060 00699090 Following is the combination of the ECALSTDS and ECAFSTDS 00699120 flags and their meaning 00699150 00699180 00 = Not first or last dataset (middle dataset) 00699210 01 = First dataset 00699240 10 = Last dataset 00699270 11 = Only dataset 00699300 00699330 ******************************************************************** 00699360 .1.. .... ECALSTDS Last dataset 00699390 0 = Not the last dataset 00699420 of the job 00699450 1 = Last dataset of the job 00699480 ..1. .... ECAFSTDS First dataset 00699540 0 = Not the first dataset 00699570 of the job 00699600 1 = First dataset of the job 00699630 ...1 1111 * Reserved -----------CHANGES FOR OW43463---------------------------------- 01040000 1. On page 220 in Figure 54 change the definition of XTP6PROC to read as follows. FSA identifier: The label of the PRINTDEV statement. 2. On page 244 near the top of the page change the definition of XTP6PROC to read as follows. XTP6PROC FSA identifier: The label of the PRINTDEV statement. -----------CHANGES FOR OW41991---------------------------------- 1. pg 4 Under the heading 'Printers Attached through an Intermediate Device' add a 4th bullet to the list: o Workstation Print Manager (WPM) (available only in Japan) 2. pg 4 After the last paragraph on the page add a new paragraph: With WPM you can store (cache) PSF resources in the fixed-disk storage of the personal computer; the stored resources can then be used by a printer that is attached to the intermediate device. PSF will tell WPM not to store resources found in user libraries or inline resources. Exit 07 or the Printer Inventory can be used to allow capture of inline resources. Refer to Capture inline resources in Table 2 on page 52 for more information. 3. pg 54 Under the description for XTP7CINR change all occurrences of "DPF" to "DPF or WPM". 4. pg 168 in the second bullet replace "DPF" with "DPF or WPM". 5. pg 177 In the last bullet replace "DPF" with "DPF or WPM". 6. pg 182 In the third bullet under APSRMARK Considerations replace "DPF" with "DPF or WPM" 7. pg 191 In the second sentence in the third paragraph under "Marking Fonts for Font Capture" replace "DPF" with "DPF or WPM". 8. pg 223, Figure 56 at offset 83 replace the line with description 'Reserved' with the following two new lines: .... 1... ECEWPM WPM is attached. .... .111 * Reserved 9. pg 253, Table 20 In the description for XTP7CINR replace "DPF" with "DPF or WPM". 10. pg 256 in the last bullet at the top of the page replace "DPF" with "DPF or WPM". 11. On page 348 in Figure 72 in the comments for bit XTP7CINR replace "DPF" with "DPF or WPM" 12. On page 357 in the description of flag XTP7CINR replace "DPF" with "DPF or WPM". 13. On pg 426 add a new glossary entry under W: WPM. Workstation Print Manager 14. On pg 464 add a new index entry for "W" with the following item: Workstation Print Manager (WPM) 4, 54, 168, 177, 182, 191, 223 253, 256, 348, 357 -----------CHANGES FOR OW44660---------------------------------- 1. On page 222 in the top half of Figure 55, change "...1 1111 * Reserved" (from apar OW42117) to the following. ...1 .... ECACUTSH Cutsheet Output 0 = Not cutsheet output 1 = Cutsheet output - Either cutsheet printer or continuous forms printer with BTS .... 1... ECADUPEN Duplex Enabled 0 = Duplex not enabled 1 = Duplex enabled - Duplex available from at least one media source .... .111 * Reserved