**** 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 * * $15=OW47073, HPRF310,001120,BDKUELJ: Support COPYMARK=NONE * * $16=OW45477 ,HPRF310,000719,BLDCWJ: New sheet eject in CSE * * $17=OW47253, HPRF310,001130,BDKURLD: Separate copy marks and * * jogging * * $18=OW48960, HPRF310,010503,BDKULMM: Abend024 RC8A9 after using a * * checkpoint from another * * release of PSF * * $19=OW53353, HPRF310,020225,BDKULMM: To force supersedes * * $20=OW53830, HPRF310,020403,BDKUMLC: No NPRO with DISCINTV * 04429980 * * **** 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 -----------CHANGES FOR OW47073---------------------------------- 1. Under Parameters for the JES2 Initialization Statement, on page 96, replace COPYMARK=DATASET|JOB|CONSTANT with COPYMARK=DATASET|JOB|CONSTANT|NONE and add after the description of CONSTANT NONE No copy marks are used and no offset stacking is done. 2. Under Copy Marking and Offset Stacking on on page 123, replace the first paragraph under the first bullet with For JES2, the COPYMARK parameter of the PRTnnnn statememt specifies how the copy mark is to be used: Incremented at the end of each data set or copy of a data set or at the end of each job, or no copy mark is to be used. 3. Under Suppressing Copy Marks (added by OW40737) on page 123, replace If you do not want to use copy marks, you can suppress .... with If you do not want to use copy marks, you can suppress them in one of these ways: - Specify COPYMARK=NONE on the JES2 initialization statement (see page 96). - Specify Suppress copy marks = YES in the Printer Inventory (see page 79). - Set XTP7SUCM in Exit 7 (see page 359). 29580000 -----------CHANGES FOR OW45477---------------------------------- 29590000 1. On page 59 in table 2, add the following entry ------------------------------------------------------------- | ISPF Panel | PIDU | |-----------------------------|-----------------------------| |CSE sheet eject |cse-sheet-eject | | | | | Values: | Values: | | / = Yes | yes | | blank = No | no | ------------------------------------------------------------- ... ------------------------------------------------------------- | Equivalent Parameter | Description | |----------------------|------------------------------------| | XTP7NSF | Specifies whether PSF tells | | | the printer to eject to a new | | | sheet on a data set boundary when | | | printing cut-sheet emulation (CSE) | | | mode. | | | See "Things to Consider When Using | | | Cut-Sheet Emulation" on page 156 | | | and XTP7NSF on page 357 for more | | | information. | ------------------------------------------------------------- Note: This parameter was added to the Infoprint Server for OS/390 Printer Inventory with APAR OW47612. 29600000 2. In section "Things to Consider When Using 29610000 Cut-Sheet Emulation" on page 156, add new paragraph after 29620000 last paragraph in the 1st bullet. 29630000 29640000 In addition to the preceding, sheet eject can now be requested for CSE via the Printer Inventory CSE-sheet-eject parameter or Exit 7 new sheet flag (XTP7NSF). When this option is requested, each job and each data set within a 29680000 job causes an eject to a new sheet. The eject to a new sheet 29690000 is done as follows: - If only a job header is requested, before the job header and before the second and subsequent data sets if any. - If a job header and dataset header are requested, before the job header and before the second and subsequent dataset set headers for the data sets if any. - If no headers, before each data set. In addition, if offset stacking is specified in a copy group and that copy group is invoked and offset stacking is being done, an eject to a new sheet occurs. The next page is the first page on this new sheet. See "Copy Marking and Offset Stacking" on Page 122 for more detail. 30210000 3. On page 253 add after XTP7WIDE the following to Table 20 "APSUX07 Options Specified in the Printer Inventory". XTP7NSF CSE sheet eject Controls sheet eject in CSE mode. See "Things to Consider When Using Cut-Sheet Emulation" on page 156. 4. On page 348 in Figure 72 add the following 30220000 after the description of XTP7APSF. 30230000 30240000 .1.. .... XTP7NSF CSE NEW SHEET FLAG 30250000 (VALID ONLY ON 30260000 INITIALIZATION CALL 30270000 "XTP7INIT") 30280000 0 = In CSE mode, JOG(AOS) with 30290000 offset stacking being done 30330000 or start of a data set 30300000 causes skip to next front side partition. 30320000 1 = In CSE mode, JOG(AOS) with 30330000 offset stacking being done 30330000 or start of a data set 30350000 causes skip to new sheet. 30360000 5. On page 357 add the following after the definition of 30370000 XTP7APSF. 30380000 30390000 30490000 XTP7NSF This option can only be set by the 30500000 Printer Inventory or during the INIT call. PSF initially sets this field to B'0' 30510000 to indicate that in CSE mode an AOS 30520000 with offset stacking being done or the start of a data set causes a skip to the next front side partition. 30540000 If Exit 7 sets this flag 30550000 to B'1', then in CSE mode, an AOS 30560000 with offset stacking being done or start of a data set causes a skip to a new sheet. 30590000 6. On page 371 in Table 19 add the following after XTP7APSF. 30600000 The 'IO' in the following lines are in the INIT columns. XTP7NSF IO 30660000 30670000 -----------CHANGES FOR OW47253---------------------------------- 1. On page 69 in table 2, add the following entry ------------------------------------------------------------- | ISPF Panel | PIDU | |-----------------------------|-----------------------------| |Offset Stacking |offset-stacking | | | | | Values: | Values: | | 1 = None | none | | 2 = Dataset | dataset | | 3 = Job | job | ------------------------------------------------------------- ... ------------------------------------------------------------- | Equivalent Parameter | Description | |----------------------|------------------------------------| | XTP7JOG | Specifies offset stacking. | | | If this parameter is not | | | specified, PSF uses the JES | | | COPYMARK parameter to control | | | offset stacking. | | | | | | See "Separating Copy Marking and | | | Offset Stacking" on page 123. | ------------------------------------------------------------- 2. On page 123 add the following subsection at the bottom of the page, after the subsection "Suppressing Copy Marks" : Separating Copy Marking and Offset Stacking You can override the setting for offset stacking (jogging) from the JES COPYMARK parameter by using the Printer Inventory or Exit 7. This support lets you control the offset stacking separately with the Printer Inventory or Exit 7 while the JES COPYMARK parameter only controls the copy marking. With Exit 7 you can set the XTP7JOG field to NONE (no offset stacking is done), to DATASET (offset stacking is done on a data set boundary), or to JOB (offset stacking is done on a job boundary). With the Printer Inventory you can set the offset-stacking field to none (no offset stacking is done), to dataset (offset stacking is done on a data set boundary, or to job (offset stacking is done on a job boundary). If XTP7JOG is set to an incorrect value in Exit 7, PSF defaults to the value set by the JES COPYMARK parameter. You can set the XTP7JOG field in the initialization (INIT) call to Exit 7 (XTP7INIT) or in the begin data set call (BDSC) to Exit 7. In the BDSC, XTP7JOG can only be set ON for the first data set of a job. If it is set ON for any other data set in the job, PSF ignores the setting. For more information, see XTP7JOG on page 267. Note : The JES COPYMARK parameter controls copy marking and offset stacking, unless the Printer Inventory offset-stacking field, or the Exit 7 XTP7JOG field is set. If either of these fields has been set, the JES COPYMARK parameter controls only copy marking, and the Printer Inventory or Exit 7 field controls offset stacking. If the Printer Inventory suppress-copy-marks field, or the Exit 7 XTP7SUCM field is set, copy marks will be suppressed, regardless of the setting of the JES COPYMARK parameter. If an Invoke Medium Map (IMM) structured field which references a copy group requesting offset stacking is present in the data stream, this offset stacking command will override the Printer Inventory offset-stacking field, and the Exit 7 XTP7JOG field. This will also cause the copy mark count to be incremented, unless copy marks have been suppressed through setting the JES COPYMARK parameter to NONE, or setting the Printer Inventory suppress-copymarks field or Exit 7 XTP7SUCM field to ON. 3. On page 254 add the following to Table 20 "APSUX07 Options specified in the Printer Inventory". XTP7JOG Offset Stacking Controls offset stacking. For more information see "Separating Copy Marking and Offset Stacking" on page 123. 4. On page 255 add the following bulleted item to the list under "Begin-Data-Set Call (BDSC)". o Control Offset Stacking. See "Separating Copy Marking and Offset Stacking" on page 123. 5. On page 347 in Figure 72 change "123 (7B) CHARACTER 1 * RESERVED" in the middle of the page to the following. 123 (7B) UNSIGNED 1 XTP7JOG JOGGING VALUE - (VALID FOR INITIALIZATION "XTP7INIT" AND BDSC "XTP7BDS") FOR FIRST DATA SET OF A JOB) 0 = DEFAULT TO JES COPYMARK SETTING. 1 = DO NOT JOG. 2 = JOG ON A DATASET BOUNDARY. 3 = JOG ON A JOB BOUNDARY. 6. On page 356 just before XTP7FMT add the following. XTP7JOG This option can be set by the Printer Inventory or during the INIT call, or during the BDSC, and it remains set between calls. PSF initially sets this field to '0' to indicate that it is not specified and the default is the COPYMARK setting. For more information, see "Separating Copy Marking and Offset Stacking" on page 123. If Exit 7 sets this flag to B'1', B'2', or B'3', PSF uses that value for offset stacking. For information about specifying this option in the Printer Inventory, see Offset Stacking in Table 2 on page 69. 7. On page 371 add the following to Table 29 just ahead of XTP7FMT under INIT and BDSC. XTP7JOG IO IO -----------CHANGES FOR OW48960---------------------------------- 1. On page 96 add a "Note:" paragraph to each of the following PRTnnn parameters: CKPTMODE=PAGE|SEC, CKPTPAGE and CKPTSEC. Note: PSF can only use checkpoint information that was created by the same level of PSF that is currently printing the data set. In other words, if a data set was checkpointed by one version/release of PSF, but is now being printed by another version/release of PSF the checkpoint data will be ignored and the data set restarted from the beginning. 2. On page 102 add a "Note:" paragraph to the end of the following Device parameters: CKPNTPG (started on pg 101) and CKPNTSEC. Note: PSF can only use checkpoint information that was created by the same level of PSF that is currently printing the data set. In other words, if a data set was checkpointed by one version/release of PSF, but is now being printed by another version/release of PSF the checkpoint data will be ignored and the data set restarted from the beginning. 3. On page 279 add a "Note:" to the end of the 3rd paragraph under Normal PSF Recovery: Note: PSF can only use checkpoint information that was created by the same level of PSF that is currently printing the data set. In other words, if a data set was checkpointed by one version/release of PSF, but is now being printed by another version/release of PSF the checkpoint data will be ignored and the data set restarted from the beginning. 4. On page 420 add the following to the end of the definition of checkpoint: PSF can only use checkpoint information that was created by the same level of PSF that is currently printing the data set. In other words, if a data set was checkpointed by one version/release of PSF, but is now being printed by another version/release of PSF the checkpoint data will be ignored and the data set restarted from the beginning. -----------CHANGES FOR OW53830---------------------------------- 1. On page 61, Table 2, under the Description column, change the second and third sentence in the first paragraph to read: "... from JES for this time period, PSF issues a message and ends the session with the printer. If the JES NPRO parameter is nonzero, PSF forces all pages from the last job to reach the ... job to be purged from the spool." 2. On page 61, Table 2, Description column, after the first paragraph, add the following paragraph: "If the JES NPRO parameter is zero, PSF does not force all the pages of the last job to the stacker, but does issue a message and end the session. To force all the pages of the last job to the stacker, send another print job to the printer or stop the PSF FSA." 3. On page 97, under the NPRO parameter, add the paragraph: "If NPRO=0 and the PSF DISCINTV parameter is being used, PSF does not force all the pages of the last job to the stacker when the DISCINTV timer expires. Specify a non-zero NPRO value to force the last pages of the last job to the stacker when the DISCINTV timer expires. For more information, see the DISCINTV parameter in Table 2 on page 61." 4. On page 103, under the NPRO parameter, add the paragraph: "If NPRO=0 and the PSF DISCINTV parameter is being used, PSF does not force all the pages of the last job to the stacker when the DISCINTV timer expires. Specify a non-zero NPRO value to force the last pages of the last job to the stacker when the DISCINTV timer expires. For more information, see the DISCINTV parameter in Table 2 on page 61."