**** START OF SPECIFICATIONS ***************************************** 00010000 * * 00020000 **** MODULE NAME = APSGCUS2 * 00030000 * * 00040000 * COMP(APS) PROD(PSF) : RELEASE 3.2.0 * 00050000 * * 00060000 **** DESCRIPTIVE NAME = PSF FOR OS/390 CUSTOMIZATION UPDATES * 00070000 * * 00080000 **** STATUS = VERSION 3, RELEASE 2, LEVEL 0 * 00090000 * * 00100000 **** FUNCTION = * 00110000 * * 00120000 * THIS MODULE CONTAINS ALL OF THE UPDATES TO THE PSF FOR * 00130000 * OS/390 CUSTOMIZATION SINCE THE LAST PUBLISHED VERSION * 00140000 * OF THE MANUAL. * 00150000 * * 00160000 * THE UPDATES ARE PUT IN THE SAME FORMAT AS THEY WERE BEING * 00170000 * PUT IN THE DOC ++HOLDS. * 00180000 * * 00190000 * EACH TIME A NEW APAR HAS UPDATES THE CHANGE ACTIVITY WILL * 00200000 * BE UPDATED AND A NEW SECTION WILL BE ADDED TO THE END OF * 00210000 * THIS MODULE PRECEDED BY A LINE THAT DENOTES THE APAR NUMBER. * 00220000 * * 00230000 **** RESTRICTIONS * 00240000 * * 00250000 * DO NOT EDIT OR UPDATE THIS FILE ON SAMPLIB AS THE * 00260000 * NEXT APAR THAT CHANGES THIS MODULE WILL DO A TOTAL REPLACE * 00270000 * OF IT THUS OVERLAYING YOUR CHANGES. IF YOU WISH TO MAKE * 00280000 * CHANGES TO THIS MODULE THEN DO IT IN YOUR OWN COPY OF THIS * 00290000 * MODULE. * 00300000 * * 00310000 * *** CHANGE ACTIVITY = * 00320000 * $01=OW45610, HPRF320,000815,BDKUELJ: Clarify maximum FSAs - Add * 00330000 * simplex/duplex * 00340000 * $02=OW47073, HPRF320,001120,BDKUELJ: Support COPYMARK=NONE * 00350000 * $03=OW44362, HPRF320,001207,BDKULMM: Infoprint Color 130 Plus * 00360000 * $04=OW44363, HPRF320,001206,BDKURLD: Add line mode migration * 00370000 * $05=OW45477 ,HPRF320,000719,BLDCWJ: New sheet eject in CSE * 00380000 * $06=OW47253, HPRF320, 001218,BDKURLD: Separate copy marks and * 00390000 * jogging * 00400000 * $07=OW48165, HPRF320, 010309,BDKUPG : Northstar follow-up * 00410000 * $08=OW48960, HPRF320, 010502,BDKULMM: Abend024 RC8A9 when using * 00420000 * a checkpoint from another * 00430000 * release of PSF * 00440000 * $09=OW50905, HPRF320, 010910,BDKUDDA: C-exit information * 00450000 * $10=OW52112, HPRF320, 011108,BDKURLD: Side sensitivity support * 00460000 * $11=OW53147, HPRF320, 020129,BDKURLD: Add FSS name * 00470000 * $12=OW53830, HPRF320, 020403,BDKUMLC: No NPRO with DISCINTV * 00480000 * $13=OW55219, HPRF320, 020701,BDKUPG: Side and Edge Sensitivity * 00490000 * support in Printer Inventory * 00500000 * * 00510000 **** END OF SPECIFICATIONS ******************************************* 00520000 00530000 All of the following changes are for the PSF for 00540000 OS/390 Customization (S544-5622-02). 00550000 00560000 -----------CHANGES FOR OW45610---------------------------------- 00570000 00580000 00590000 1. On page 105 under "Defining PSF FSSs and FSAs for Printers", 00600000 replace the first sentence of the Note with: 00610000 00620000 Note: The number of FSAs which can execute concurrently may 00630000 be less than the number of FSAs which can be defined. The 00640000 number of FSAs which can execute concurrently depends on 00650000 several factors, including: 00660000 00670000 2. In the same section, add the following after the bulleted 00680000 list. 00690000 00700000 If you start a large number of FSAs most of which are not 00710000 actively printing at any one time, you may want to specify 00720000 that the resource libraries are to be closed when a printer 00730000 is idle. See "Close libraries when idle" in table 2 on 00740000 page 66. 00750000 00760000 3. On page 232 in the middle of Figure 69, change 00770000 "...1 1111 * Reserved" to the following. 00780000 00790000 ...1 .... ECACUTSH Cutsheet Output 00800000 0 = Not cutsheet output 00810000 1 = Cutsheet output - Either 00820000 cutsheet printer or 00830000 continuous forms printer 00840000 with BTS 00850000 .... 1... ECADUPEN Duplex Enabled 00860000 0 = Duplex not enabled 00870000 1 = Duplex enabled - Duplex 00880000 available from at least 00890000 one media source 00900000 .... .111 * Reserved 00910000 00920000 00930000 -----------CHANGES FOR OW47073---------------------------------- 00940000 00950000 1. Under Parameters for the JES2 Initialization Statement, 00960000 on page 107, 00970000 replace 00980000 COPYMARK=DATASET|JOB|CONSTANT 00990000 with 01000000 COPYMARK=DATASET|JOB|CONSTANT|NONE 01010000 and add after the description of CONSTANT 01020000 NONE No copy marks are used and no offset stacking is done. 01030000 01040000 2. Under Copy Marking and Offset Stacking on 01050000 on page 134, 01060000 replace the first paragraph under the first bullet with 01070000 For JES2, the COPYMARK parameter of the PRTnnnn statememt 01080000 specifies how the copy mark is to be used: Incremented at 01090000 the end of each data set or copy of a data set or at the 01100000 end of each job, or no copy mark is to be used. 01110000 01120000 3. Under Suppressing Copy Marks 01130000 on page 135, 01140000 replace 01150000 If you do not want to use copy marks, you can suppress .... 01160000 with 01170000 If you do not want to use copy marks, you can suppress them 01180000 in one of these ways: 01190000 - Specify COPYMARK=NONE on the JES2 initialization statement. 01200000 (see page 107). 01210000 - Specify Suppress copy marks = YES in the Printer Inventory 01220000 (see page 90).. 01230000 - Set XTP7SUCM in Exit 7 (see page 359). 01240000 01250000 -----------CHANGES FOR OW44362---------------------------------- 01260000 01270000 01280000 Pg 49 Under Chapter 5 Working with Libraries 01290000 Under the bullet for Object container library add the following: 01300000 Because multiple resource types are contained in the object 01310000 container library and PSF does not enforce a prefix for the 01320000 eight-character resource name, you should define a naming 01330000 convention that identifies each type of resource in the object 01340000 container library. IBM recommends a two-character prefix: 01350000 PP PDF single-page object resources 01360000 E1 Encapsulated PostScript resources 01370000 H1 Microfilm setup resources 01380000 I1 IOCA resources 01390000 Note: IOCA resources that are identified in the data stream 01400000 as a hard resource using the Map Data Resource (MDR) structured 01410000 field must be placed in the object container system library, 01420000 a user library or inline with the print data. 01430000 IT IOCA Tile resources 01440000 PR PDF resource objects 01450000 M1 Color Mapping Table resources 01460000 01470000 pg 49 Under Working with Libraries, under the page segment 01480000 bullet, add a note under the "I1 IOCA resource" list entry: 01490000 Note: IOCA resources that are not mapped in the data 01500000 stream (For example, only included with an IOB) can be placed in 01510000 the page segment library, so that all current jobs can 01520000 print the way they always have. However, you must place 01530000 any new IOCA resources in the object container 01540000 library. 01550000 01560000 pg 152, Number and Type of Resources, Add the following to the end 01570000 of the third paragraph: 01580000 Resource management can also increase printer throughput. 01590000 For example, if the print job contains very large resources 01600000 that are used on multiple pages,such as color 01610000 EPS objects or IOCA FS45 images, PSF can manage these resources 01620000 if they are identified as hard resources with 01630000 the Map Data Resource (MDR) structured field. 01640000 PSF sends hard resources 01650000 to the printer once instead of each time they are included in the 01660000 print job. 01670000 01680000 pg 157, Capacity of the I/O Subsystem 01690000 Update the last sentence in the first paragraph to read: 01700000 Some print data sets require more DASD I/O from the spool or the 01710000 PSF resource libraries than other print data sets, depending on 01720000 the density or complexity of the print data. 01730000 01740000 Replace the second paragraph with the following 2 paragraphs: 01750000 The 3390 DASD device can handle large amounts of image data while a 01760000 cache controller can be used to hold frequently accessed resources. 01770000 01780000 If the print data set references very large resource objects, such 01790000 color EPS objects or IOCA FS45 images, 01800000 very fast DASD, such as an Enterprise Storage Server, can be 01810000 used to improve performance. 01820000 01830000 pg 167 Under Managing Resources, update the last sentence in the 01840000 5th paragraph to read: 01850000 Complex pages normally contain many page segments, a variety of 01860000 fonts, several data object resources, or overlays. 01870000 01880000 pg 197 Under Marking Fonts for Font Capture, update the first 01890000 sentence of the third paragraph to read: 01900000 A font character set or code page can be captured by a printer 01910000 only if it is marked PUBLIC, has a date and time stamp for 01920000 resident fonts, and is loaded from a system library. 01930000 01940000 pg 197 Under Single-Byte Raster Font Capture, replace the 01950000 second paragraph with the following: 01960000 The single-byte raster fonts shipped in the IBM AFP Font 01970000 Collection 1.1.0 (Program Number 5648-113), IBM AFP Font 01980000 Collection 2.1.0 or 2.1.1 (Program number 5648-B33) are marked 01990000 correctly for activating resident fonts. To capture fonts, 02000000 you must run APSRMARK with the 02010000 same syntax used to mark fonts for activating 02020000 printer resident fonts. See PSF Resident Font Utility--- 02030000 APSRMARK on page 187 for more information. 02040000 02050000 pg 197 Under Single-Byte Outline Font Capture, replace the 02060000 first paragraph with the following: 02070000 All single-byte outline fonts shipped in all IBM AFP Font 02080000 Collections are marked correctly for activating 02090000 resident fonts and capturing fonts. 02100000 02110000 pg 198 Under Double-Byte Raster Font Capture, replace the 02120000 first paragraph with the following two paragraphs: 02130000 The double-byte raster fonts shipped in the IBM AFP Font 02140000 Collection 2.1.0 (Program number 5648-B33) are marked 02150000 correctly for activating resident fonts. To capture fonts, 02160000 you must run APSRMARK with the 02170000 same syntax used to mark fonts for activating 02180000 printer resident fonts. See PSF Resident Font Utility--- 02190000 APSRMARK on page 187 for more information. 02200000 02210000 The double-byte raster fonts shipped in the IBM AFP Font 02220000 Collection 2.1.1 (Program number 5648-B33) are marked 02230000 correctly for activating resident fonts and capturing fonts. 02240000 You do not need to run APSRMARK. 02250000 02260000 pg 198 Under Double-Byte Outline Font Capture, add a new paragraph 02270000 after the first one: 02280000 The double-byte outline fonts shipped in the IBM AFP Font 02290000 Collection 2.1.0 (Program number 5648-B33) and higher releases 02300000 are marked correctly for activating 02310000 resident fonts and capturing fonts. 02320000 02330000 pg 259 Under Invoking Exit 7, update the Note for XTP7RTYP: 02340000 Note: For GOCA and BCOCA resources, this field indicates a 02350000 page segment resource type. 02360000 For IOCA resources, this field indicates either a page 02370000 segment resource type or object container resource type. 02380000 XTP7RTYP indicates a 02390000 page segment resource if the IOCA resource object is found 02400000 in the page segment library. It indicates object 02410000 container if the IOCA resource is found in the object 02420000 container library. 02430000 02440000 02450000 pg 261 Add a new heading and paragraph above IOCA, GOCA, and 02460000 BCOCA Considerations. 02470000 IOCA Considerations 02480000 IOCA resources can be placed in the page segment library 02490000 and the object container library. 02500000 On entry to Exit 7, the XTP7RTYP field 02510000 indicates either a page segment if the IOCA object is found in the 02520000 page segment library, or an object container if the IOCA object 02530000 is found in the object container library. Because IOCA 02540000 resources reside in libraries with other resource types it 02550000 is recommended that you establish a naming convention to 02560000 differentiate these resources. IBM does not enforce a prefix 02570000 for the eight-character resource name, but you should define a 02580000 convention that identifies each type of resource. 02590000 For IOCA resources IBM recommends an I1 prefix. 02600000 02610000 pg 261 Under IOCA, GOCA, and BCOCA Considerations 02620000 Eliminate IOCA from the heading, the paragraph and the list of 02630000 prefixes. 02640000 02650000 pg 261 Under Overlay Considerations, update the first two 02660000 sentences to include data object resources: 02670000 "Before an overlay containing fonts, page segments, or data object 02680000 resources can be printed, the overlay and its associated 02690000 resources must be loaded in the printer. Fonts, page segments, and 02700000 data object resources must be defined in one of two ways:" 02710000 02720000 pg 264 After Considerations Related to Inline Resources add 02730000 the following new heading and paragraph: 02740000 Considerations for Resource Substitution 02750000 PSF supports substitution of all resource types. These 02760000 considerations apply to resource substitution: 02770000 o Exit 7 cannot substitute inline resources. PSF ignores a 02780000 substitution request for an inline resource. 02790000 o Exit 7 cannot substitute user library resources. PSF ignores 02800000 a substitution request for a user library resource. 02810000 o Exit 7 only substitutes a system library resource with 02820000 another system library resource. 02830000 o Object container resources must be substituted for object 02840000 container resources of the same type. The registration ID 02850000 (object-type OID) must be the same for both resources or an 02860000 error results. 02870000 o A resource referenced by OID cannot be substituted for a 02880000 resource referenced by name, and vice versa. 02890000 o An object container resource with secondary resources can only 02900000 be substituted for an object container with the identical 02910000 secondary resources. If the secondary resources for the 02920000 substituted object container are different, PSF does not use 02930000 them. 02940000 02950000 pg 274 Under Partial Control of Resource Deletion, 3rd paragraph 02960000 under the first bullet. Change the first sentence to read: 02970000 RRLVs have no upper or lower limit; however, for overlays, RRLV is 02980000 always 0. 02990000 03000000 pg 275 Under Full Control of Resource Deletion, update the first 03010000 sentence in the Note to read: 03020000 PSF tries to save all fonts, page segments and object containers 03030000 that are identified as nested resources. 03040000 03050000 pg 276 delete the 2nd bullet at the top of the page 03060000 03070000 pg 324 Under OBJECT CONTAINER, add the following new types: 03080000 o IOCA tile resource object 03090000 o PDF single-page object 03100000 o PDF resource object 03110000 03120000 pg 325 Underneath the PAGE SEGMENT description, add the following: 03130000 IOCA image 03140000 Only the Resource Type and the Enabled For categories are listed 03150000 for a resource object when its resource type is IOCA image. 03160000 03170000 pg 355 Under XTP7RRLV, replace the paragraph for XTP7ROC to read: 03180000 RRLV for object containers. 03190000 03200000 pg 365 03210000 Underneath the RLSTUSER field, add: 03220000 .... ...1 RLSTSOFT Soft resource - can be pseg or 03230000 DOR (object container or IOCA) 03240000 - not valid on access call 03250000 03260000 Underneath this new field, remove: 03270000 .... ...1 * Reserved 03280000 03290000 pg 366 03300000 Underneath the RLSTGRID field, add: 03310000 ..1. .... RLSTOIDR Referenced by OID 03320000 ...1 .... RLSTNAMR Referenced by name 03330000 03340000 Underneath these new fields, change: 03350000 ..11 1111 * Reserved 03360000 to read 03370000 .... 1111 * Reserved 03380000 03390000 Underneath the RLSTRRI field, add: 03400000 ...1 .... RLSTEMSG Issue substitution error message 03410000 Underneath this new field, change: 03420000 ...1 1111 * Reserved 03430000 to read: 03440000 .... 1111 * Reserved 03450000 03460000 Underneath the RLSTHSCF field, add: 03470000 54 (36) UNSIGNED 1 RLSTOIDL Length of OID 03480000 55 (37) UNSIGNED 129 RLSTOID The OID for this resource 03490000 Underneath these fields, change: 03500000 54 (36) CHARACTER 24 * Reserved 03510000 to read: 03520000 184 (B8) CHARACTER 24 * Reserved 03530000 03540000 pg 367 03550000 Add the following sentence underneath the explanation for 03560000 RLSTINL: 03570000 This flag is only valid during the resource-access call 03580000 (RAC). 03590000 03600000 pg 368 03610000 Change the RLSTSPS explanation to read: 03620000 If set, indicates that this is a soft page segment. 03630000 This flag is only valid during the resource-load 03640000 call (RLC). 03650000 03660000 Underneath the explanation of the RLSTUSER field, add: 03670000 RLSTSOFT 03680000 If set, indicates that the resource is a soft 03690000 page segment, IOCA, or object container resource. 03700000 03710000 pg 369 03720000 03730000 Underneath the explanation of the RLSTGRID field, add: 03740000 RLSTOIDR 03750000 Set by PSF to B'1' to indicate that a data object 03760000 resource has been referenced by OID. This flag 03770000 is only valid for data object resources (object 03780000 containers or IOCA resources). 03790000 When this flag is on, the 03800000 RLSTOID field contains an OID. 03810000 03820000 RLSTNAMR 03830000 Set by PSF to B'1' to indicate that a data object 03840000 resource has been referenced by name. This flag 03850000 is only valid for data object resources (object 03860000 containers or IOCA resources. 03870000 When this flag is on, the 03880000 RLSTNAME field contains a valid name. 03890000 03900000 Note : RLSTOIDR and RLSTNAMR are mutually exclusive 03910000 flags. 03920000 03930000 Change the RLSTSMSG explanation to read: 03940000 Issues substitution message APS3503I for data object 03950000 resources (object containers and IOCA resources), or 03960000 substitution message APS563I for all other resource 03970000 types. PSF always sets this flag to '0'. If the exit 03980000 has requested a substitution of this resource and it 03990000 sets RLSTSMSG to '1', PSF issues message APS3503I or 04000000 message APS563I. 04010000 04020000 Underneath the explanation of the RLSTRRI field, add: 04030000 RLSTEMSG 04040000 Issues substitution error message APS3504I in the 04050000 event of a resource substitution error. PSF always 04060000 sets this flag to '0'. If the exit has requested a 04070000 substitution of this resource, it sets RLSTEMSG to 04080000 '1', and if there is a problem in the substitution, 04090000 PSF issues message APS3504I. For a discussion of 04100000 valid and not valid resource substitution, see 04110000 "Considerations for Resource Substitution" on page 264. 04120000 04130000 pg 370 04140000 Underneath the explanation of the RLSTHSCF field, add: 04150000 RLSTOIDL 04160000 The length of the OID for this resource. If this resource 04170000 is referenced by OID, RLSTOIDL and RLSTOID are set, 04180000 and RLSTOIDR is set to B'1'. 04190000 04200000 RLSTOID 04210000 The value of the OID for this resource. If this resource 04220000 is referenced by OID, RLSTOID and RLSTOIDL is set, 04230000 and RLSTOIDR is set to B'1'. 04240000 04250000 04260000 04270000 04280000 pg 377, update the value for All other printers for Object 04290000 containers to be 200. 04300000 04310000 pg 380, Under the Step 4 (Submit the JCL) add a new first step 04320000 to the list under "After converting fonts ..." 04330000 1. Run APSRMARK to mark the fonts for resident use and capture. 04340000 04350000 pg 383 replace Step 7 under "To run APSRAL30" with: 04360000 1. Run APSRMARK to mark the fonts for resident use and capture. 04370000 Then copy the 3 steps on pg 380 listed "After converting fonts 04380000 with APSRCF30.." 04390000 04400000 pg 422 add a new glossary entry: 04410000 data object resource. An object container resource or IO image 04420000 resource that is either printer resident or downloaded. Data 04430000 object resources can be: 04440000 o used to prepare for the presentation of a data object; such as 04450000 with a resident color profile resource object 04460000 o included in a page or overlay via the Include Object (IOB) 04470000 structured field; examples include: PDF single-page objects, 04480000 encapsulated PostScript objects, and IO images 04490000 o invoked from within a data object; examples such as PDF Resource 04500000 objects 04510000 04520000 pg 425 add a new glossary entry: 04530000 hard resource. A resource declared in the appropriate Map 04540000 structured field and loaded in the printer. It can be reused 04550000 during the job without being reloaded to the printer. Contrast 04560000 with soft resource. 04570000 04580000 pg 437 add a new glossary entry: 04590000 soft resource. A resource that is not declared in a Map 04600000 structured field but is sent to the printer inline with data. 04610000 It cannot be reused during the job without being reloaded to the 04620000 printer. Contrast with hard resource. 04630000 04640000 -----------CHANGES FOR OW44363---------------------------------- 04650000 04660000 04670000 1. On page 219 in Table 19 "Installation Exit Names" add the 04680000 following entry after Exit 7. 04690000 04700000 Exit 8 APSUX08 APSUC08 04710000 04720000 04730000 2. On page 226 in Table 21 "PSF Exit Routines in SYS1.SAMPLIB" 04740000 add the following entry after APSUX07Z. 04750000 04760000 APSUX08X APSUC08X Sample source routine for invoking 04770000 line mode migration. 04780000 04790000 3. On page 226 change the 2nd sentence in the NOTE under Table 04800000 21 to read as follows. 04810000 04820000 PSF does not provide object code for the other exits -- 04830000 logical-record processing, SMF type 6 record processing, 04840000 PSF-message processing, resource processing, Line-Mode 04850000 Migration, direct printing 3800 Line-Mode 04860000 Conversion, Download for OS/390, and direct printing. 04870000 04880000 04890000 4. On page 226 change the 1st sentence in the last paragraph 04900000 to read as follows. 04910000 04920000 During PSF initialization, the exit subcomponent issues a 04930000 BLDL request to locate any user-provided routines prefixed 04940000 with APSUlnn (where l is X for assembler language or C for 04950000 C language and nn is replaced with the exit numbers: 01, 02, 04960000 03, 04, 05, 06, 07, 08, 14, 15, 16). 04970000 04980000 04990000 5. On page 231, figure 68, add the following mapping of Exit 8 05000000 fields after the mapping of the Exit 6 fields. 05010000 05020000 =====================================================================05030000 The following fields are used for installation Exit 08 05040000 (Line Mode Migration exit) 05050000 =====================================================================05060000 05070000 0 (0) CHARACTER 1 XTP8FLAG Exit08 Flags 05080000 1... .... XTP8MIG Do Line Mode Migration flag - 05090000 When this flag is set on, 05100000 Line Mode Migration is 05110000 activated. This flag is 05120000 reset when exit 08 is 05130000 called. 05140000 .111 1111 * Reserved 05150000 1 (1) CHARACTER 9 * Reserved 05160000 05170000 05180000 6. On page 234 in Figure 70 "Format of Exit-Communication 05190000 Area Extension, APSUECE" change ECEFECAP near the top 05200000 of the page to read as follows. 05210000 05220000 16 (10) Address 4 ECEFECAP Addr of FSA ECA, used by 05230000 Exits 1-4, 6, 7, 8, 14, 15, 05240000 16. 05250000 05260000 7. On page 235 in Figure 70 "Format of Exit-Communication 05270000 Area Extension, APSUECE" change ECEX08P in the middle 05280000 of the page to read as follows. 05290000 05300000 176 (B0) Address 4 ECEX08P Address of Exit 8. 05310000 05320000 05330000 8. On page 276 add a new section just before the section 05340000 "Direct-Printing Line Mode Exit: Exit 14" as follows. 05350000 05360000 Line Mode Migration Exit: Exit 8 05370000 05380000 PSF gives the APSUX08 or APSUC08 exit control before the 05390000 processing of the data set begins - that is, before any 05400000 separator-page exit begins so the user can invoke Line Mode 05410000 Migration. This call is made for all new 05420000 data sets and for data sets that are restarted after an 05430000 interrupt. Fields in the Exit Communication Area (APSUECA) 05440000 and its extension (APSUECE), which contain information for 05450000 the data set from the user's JCL, are available for use. 05460000 05470000 Input for Exit 8 05480000 05490000 When the Line Mode Migration exit is entered, the contents of 05500000 the registers are as follows: 05510000 05520000 Register 1 05530000 Pointer to the address of parameter area APSGEXTP. 05540000 05550000 Register 13 05560000 Pointer to the caller's save area. 05570000 05580000 Register 14 05590000 Return address. 05600000 05610000 Register 15 05620000 Entry point address. 05630000 05640000 XTP8MIG 05650000 05660000 Do Line Mode Migration flag. 05670000 05680000 Output for Exit 8 05690000 05700000 XTP8MIG 05710000 Do Line Mode Migration flag. 05720000 05730000 Programming Considerations for Exit 8 05740000 05750000 The following general considerations apply to exit 8. 05760000 05770000 o When this routine is entered, Register 1 points to a 05780000 one-word parameter list that contains the address 05790000 of APSGEXTP. APSGEXTP contains a pointer to the exit- 05800000 communications area, APSUECA 05810000 05820000 o The work buffer (ECAWKBUF) in the exit-communications 05830000 area (APSUECA) can be used as a work area by the exit. 05840000 PSF does not clear this area between calls; so the 05850000 exit can store data here between calls for one data set. 05860000 05870000 o When the exit routine is entered, the contents of 05880000 Register 13 point to a standard 18-word save area that 05890000 can be used to save the caller's registers. 05900000 05910000 o Use Register 12 as a base register for all exit routines. 05920000 If Register 12 points to the beginning of the exit 05930000 routine, and the module name begins in the sixth byte 05940000 of the routine, the module name appears on the SDUMP 05950000 title page if an abend occurs. 05960000 05970000 o To request Line Mode Migration, determine whether 05980000 Line Mode Migration is required for the current data set. 05990000 Set the XTP8MIG flag appropriately. 06000000 06010000 06020000 9. Add a new chapter titled, "Line Mode Migration" and use 06030000 the text below for the new chapter: 06040000 06050000 06060000 The Line Mode Migration function can be used to print 06070000 line-mode jobs previously printed on a JES-controlled 4245 06080000 on a PSF-controlled 64xx printer. The job JCL, FCB, and 06090000 application line data do not need to be modified. However, 06100000 without the use of the Line Mode Migration function the 06110000 JCL and line data might need to be modified to print on a 06120000 64xx printer. 06130000 06140000 06150000 Add a section titled, "Understanding Line Mode Migration" 06160000 06170000 06180000 The Line Mode Migration function enables PSF to dynamically 06190000 build and use an inline page definition for a 4245 06200000 line-mode job. The inline page definition is built using 06210000 the FCB specified by the FCB parameter in the job JCL. 06220000 06230000 To build the inline page definition, PSF concatenates the 06240000 prefix FCB2 to the FCB name specified on the FCB parameter in 06250000 the job JCL and uses that FCB name to get the FCB in 06260000 SYS1.IMAGELIB. The FCB is used to calculate the page length 06270000 which goes into the inline page definition. If the LINECT 06280000 parameter is specified in the JCL or in the JES2 PRINTDEF 06290000 statement, the page length is set to either the number of 06300000 lines specified by LINECT or the number calculated using the 06310000 FCB, whichever is smaller. This page length is used to set 06320000 the physical printable area length in the 64xx printer which 06330000 then matches the length of the paper loaded in the 4245 06340000 printer; however, the width of the paper loaded in the 64xx 06350000 must match the width of the paper loaded in the 4245. 06360000 For more information about the PRINTDEF statement, refer to 06370000 JES2 Initialization and Tuning Reference. 06380000 06390000 If no FCB is specified for the job JCL, PSF terminates 06400000 migration processing, issues message APS970I and puts the job 06410000 on the JES hold queue. If an FCB parameter and a FORMLEN 06420000 parameter are specified, PSF terminates migration processing, 06430000 issues message APS981I, uses the FORMLEN value to set the 06440000 page length in the 64xx printer and ignores the FCB 06450000 parameter. PSF then processes the job as a normal AFP job. 06460000 If a PAGEDEF parameter is specified, PSF terminates migration 06470000 processing and processes the job as a normal AFP job using 06480000 the page definition specified. For information about the 06490000 FORMLEN parameter or PAGEDEF parameter, refer to PSF for 06500000 OS/390 User's Guide. 06510000 06520000 The 64xx printer supports three different print quality 06530000 levels: Draft, DP, and NLQ. Not all of these print qualities 06540000 can be used with every font supported by a 64xx printer, for 06550000 example, Gothic can print with a quality of Draft and DP, but 06560000 not NLQ. If a print quality can not be used with a 06570000 particular font, the printer generates an error. The 64xx 06580000 can be configured with a default font and print quality, but 06590000 can be overridden. The default font can be overridden using 06600000 the CHARS parameter on the job JCL or the CHARS parameter on 06610000 the PRINTDEV statement. Using the CHARS parameter on the 06620000 PRINTDEV prevents the need to add the CHARS parameter to the 06630000 job JCL. A print quality supported for that font must be 06640000 used to prevent errors. For information about how PSF 06650000 determines which font to use when printing a data set, see 06660000 Chapter 13, Managing Resources. 06670000 06680000 A form definition must be used to override the default print 06690000 quality set in the printer. The form definition can be 06700000 specified using the FORMDEF parameter on the job JCL or the 06710000 FORMDEF parameter on the PRINTDEV statement. Using the 06720000 FORMDEF parameter on the PRINTDEV prevents the need to add 06730000 the FORMDEF parameter to the job JCL. 06740000 06750000 Three form definitions are provided by PSF where each one 06760000 specifies a different print quality. Form definition 06770000 F1QA0010 specifies NLQ print quality. Form definition 06780000 F1Q50010 specifies DP print quality. Form definition 06790000 F1Q10010 specifies Draft print quality. Each of these form 06800000 definitions specifies a logical page position of 0.0, 0.0 to 06810000 match the page origin on a 4245 printer. For information 06820000 about the FORMDEF parameter and form definitions supplied 06830000 with PSF, refer to PSF for OS/390 User's Guide. 06840000 06850000 06860000 Add a section titled, "Enabling Line Mode Migration" 06870000 06880000 06890000 The Line Mode Migration function can be enabled using the 06900000 Line Mode Migration exit(APSUX08 or APSUC08) and then setting 06910000 the XTP8MIG flag. The XTP8MIG flag defaults to zero which 06920000 means the job is not to be migrated. Line Mode Migration is 06930000 only supported in deferred-printing mode. 06940000 06950000 By using exit 8 it is possible to printing AFP jobs and 4245 06960000 line-mode jobs on the same printer. Exit 8 has access to the 06970000 job JCL parameters, for example, job name or job class, which 06980000 can be used to identify 4245 line-mode jobs that should be 06990000 migrated to print on the 64xx printer. If a job is to be 07000000 migrated, Exit 8 must set the XTP8MIG. If all jobs are to be 07010000 migrated, exit 8 can set the XTP8MIG every time it is called. 07020000 07030000 If a 4245 line-mode job is not migrated, PSF continues to 07040000 process the job as a normal AFP job. PSF treats the FCB 07050000 specified by the FCB parameter on the job JCL as a pagedef 07060000 and attempts to load it from the pagedef libraries. If the 07070000 load fails, PSF uses the default pagedef to print the 4245 07080000 line-mode job which will probably result in data stream 07090000 errors. 07100000 07110000 07120000 Add a section titled, "Considerations and Limitations of 07130000 the Line Mode Migration function" 07140000 07150000 07160000 The inline page definition built by PSF is used for the user 07170000 data set, but the page length determined from the FCB or 07180000 LINECT parameter applies to all pages of the job including 07190000 the separator pages. If the separator page is too long for 07200000 the page length, the separator page is truncated by the 07210000 printer. 07220000 07230000 The 4245 line-mode jobs can be printed on cut-sheet printers 07240000 supported by PSF, but the job must fit on the paper loaded in 07250000 the printer. In this case, PSF uses the paper size returned 07260000 by the printer and not the size calculated from the FCB. 07270000 07280000 For general information about PSF exit processing, see 07290000 Chapter 20, Using Installation Exits. See page 276 for more 07300000 information concerning Exit 8. 07310000 07320000 -----------CHANGES FOR OW45477---------------------------------- 07330000 07340000 1. On page 69 in table 2, add the following entry 07350000 07360000 ------------------------------------------------------------- 07370000 | ISPF Panel | PIDU | 07380000 |-----------------------------|-----------------------------| 07390000 |CSE sheet eject |cse-sheet-eject | 07400000 | | | 07410000 | Values: | Values: | 07420000 | / = Yes | yes | 07430000 | blank = No | no | 07440000 ------------------------------------------------------------- 07450000 ... 07460000 ------------------------------------------------------------- 07470000 | Equivalent Parameter | Description | 07480000 |----------------------|------------------------------------| 07490000 | XTP7NSF | Specifies whether PSF is to tell | 07500000 | | the printer to eject to a new | 07510000 | | sheet on a data set boundry when | 07520000 | | doing cut-sheet emulation (CSE). | 07530000 | | See "Things to Consider When Using | 07540000 | | Cut-Sheet Emulation" on page 166 | 07550000 | | and XTP7NSF on page 359 for more | 07560000 | | information. | 07570000 ------------------------------------------------------------- 07580000 07590000 07600000 Note: This parameter was added to the Infoprint Server for 07610000 OS/390 Printer Inventory with APAR OW47612. 07620000 07630000 07640000 07650000 2. In section "Things to Consider When Using 07660000 Cut-Sheet Emulation" on page 166, replace the last 07670000 sentence in the 1st bullet with the following. 07680000 07690000 If you need to prevent this, you can force the first page 07700000 of a data set to eject to a new sheet by assigning it a form 07710000 definition that specifies N_UP (N_UP 1 will work) or set the 07720000 new sheet flag (XTP7NSF) in installation exit 07. 07730000 07740000 3. In section "Things to Consider When Using 07750000 Cut-Sheet Emulation" on page 166 add the following 07760000 sentence as the last sentence to the bulleted item on the 07770000 page. 07780000 07790000 However, by using installation exit 07 (set XTP7NSF) or 07800000 Printer Inventory, you can force a sheet eject if your 07810000 post processor does not handle left/right offset 07820000 stacking. This causes PSF to eject to 07830000 a new sheet for the first page of a data set and 07840000 for a copy group that contains a jog request that 07850000 has been invoked by an IMM in the data stream. 07860000 07870000 07880000 4. On page 266 add the following to Table 24 "Exit 7 Options 07890000 Specified in the Printer Inventory". 07900000 07910000 XTP7NSF CSE sheet eject Controls sheet eject in CSE mode. 07920000 See "Things to Consider When Using 07930000 Cut-Sheet Emulation" on page 166. 07940000 07950000 5. On page 350 in Figure 84 add the following 07960000 after the description of XTP7APSF. 07970000 07980000 .1.. .... XTP7NSF CSE NEW SHEET FLAG 07990000 (VALID ONLY ON 08000000 INITIALIZATION CALL 08010000 "XTP7INIT") 08020000 0 = In CSE mode, JOG(AOS) 08030000 or first page of a 08040000 data set causes skip to 08050000 next front side partition. 08060000 1 = In CSE mode, JOG(AOS) or 08070000 first page of a data set 08080000 causes skip to new sheet. 08090000 08100000 6. On page 359 add the following after the definition of 08110000 XTP7APSF. 08120000 08130000 08140000 XTP7NSF Valid only on the INIT call. 08150000 PSF initially sets this field to B'0' 08160000 to indicate that in CSE mode An AOS 08170000 or new data set causes a skip to 08180000 the next front side partition. 08190000 If APSUX07 sets this flag 08200000 to B'1', then in CSE mode an AOS or 08210000 new data set causes a skip to a 08220000 sheet. 08230000 08240000 7. On page 373 in Table 19 add the following after XTP7APSF. 08250000 The 'IO' in the following lines are in the INIT columns. 08260000 XTP7NSF IO 08270000 08280000 08290000 -----------CHANGES FOR OW47253---------------------------------- 08300000 08310000 1. On page 80 in table 2, add the following entry 08320000 08330000 ------------------------------------------------------------- 08340000 | ISPF Panel | PIDU | 08350000 |-----------------------------|-----------------------------| 08360000 |Offset Stacking |offset-stacking | 08370000 | | | 08380000 | Values: | Values: | 08390000 | 1 = None | none | 08400000 | 2 = Dataset | dataset | 08410000 | 3 = Job | job | 08420000 ------------------------------------------------------------- 08430000 ... 08440000 ------------------------------------------------------------- 08450000 | Equivalent Parameter | Description | 08460000 |----------------------|------------------------------------| 08470000 | XTP7JOG | Specifies offset stacking. | 08480000 | | If this parameter is not | 08490000 | | specified, PSF uses the JES | 08500000 | | COPYMARK parameter to control | 08510000 | | offset stacking. | 08520000 | | | 08530000 | | See "Separating Copy Marking and | 08540000 | | Offset Stacking" on page 135. | 08550000 ------------------------------------------------------------- 08560000 08570000 08580000 08590000 2. On page 135 add the following subsection at the top of the 08600000 page, after the subsection "Suppressing Copy Marks" : 08610000 08620000 Separating Copy Marking and Offset Stacking 08630000 08640000 You can override the setting for offset stacking (jogging) 08650000 from the JES COPYMARK parameter by using the Printer Inventory 08660000 or Exit 7. This support lets you control the offset stacking 08670000 separately with the Printer Inventory or Exit 7 while the JES 08680000 COPYMARK parameter only controls the copy marking. 08690000 08700000 With Exit 7 you can set the XTP7JOG field to NONE (no offset 08710000 stacking is done), to DATASET (offset stacking is done on a 08720000 dataset boundary), or to JOB (offset stacking is done on a job 08730000 boundary). 08740000 08750000 With the Printer Inventory you can set the offset-stacking 08760000 field to none (no offset stacking is done), to dataset 08770000 (offset stacking is done on a dataset boundary, or to job 08780000 (offset stacking is done on a job boundary). 08790000 08800000 If XTP7JOG is set to an incorrect value in Exit 7, PSF defaults 08810000 to the value set by the JES COPYMARK parameter. 08820000 08830000 You can set the XTP7JOG field in the initialization (INIT) call 08840000 to Exit 7 (XTP7INIT) or in the begin data set call (BDSC) to Exit 08850000 7 (XTP7BDS). In the BDSC, XTP7JOG can only be set ON for the first 08860000 data set of a job. If it is set ON for any other data set in the 08870000 job, PSF ignores the setting. For more information, see XTP7JOG on 08880000 page 267. 08890000 08900000 Note : The JES COPYMARK parameter controls copy marking and offset 08910000 stacking, unless the Printer Inventory offset-stacking field, or 08920000 the Exit 7 XTP7JOG field is set. If either of these fields has 08930000 been set, the JES COPYMARK parameter controls only copy marking, 08940000 and the Printer Inventory or Exit 7 field controls offset 08950000 stacking. 08960000 If the Printer Inventory suppress-copy-marks field, or the Exit 08970000 7 XTP7SUCM field is set, copy marks will be suppressed, regardless 08980000 of the setting of the JES COPYMARK parameter. 08990000 If an Invoke Medium Map (IMM) structured field which references a 09000000 copy group requesting offset stacking is present in the data 09010000 stream, this offset stacking command will override the Printer 09020000 Inventory offset-stacking field, and the Exit 7 XTP7JOG field. 09030000 This will also cause the copy mark count to be incremented, unless 09040000 copy marks have been suppressed through setting the JES COPYMARK 09050000 parameter to NONE, or setting the Printer Inventory 09060000 suppress-copymarks field or Exit 7 XTP7SUCM field to ON. 09070000 09080000 3. On page 225 in Table 21 "Exit Routines in SYS1.SAMPLIB" remove the 09090000 following entries from the table under "C Name". 09100000 09110000 APSUC01P 09120000 APSUC01S 09130000 APSUC02P 09140000 APSUC02S 09150000 09160000 4. On page 227 in Table 22 "Installation Exit Control Blocks" add the 09170000 following entry after IEFDOKEY. 09180000 09190000 IEFDOTUM APSUDOTC Dynamic output text unit mappings 09200000 09210000 5. On page 228 in Table 22 "Installation Exit Control Blocks" remove 09220000 the following entry. 09230000 09240000 APSUSEPS Separator exits header file for APSUC01S and APSUC02S 09250000 09260000 6. On page 267 add the following to Table 24 "APSUX07 Options 09270000 specified in the Printer Inventory". 09280000 09290000 XTP7JOG Offset Stacking Controls offset stacking. For more 09300000 information see "Separating 09310000 Copy Marking and Offset Stacking" 09320000 on page 135. 09330000 09340000 7. On page 268 add the following bulleted item to the list under 09350000 "Begin-Data-Set Call (BDSC)". 09360000 09370000 o Control Offset Stacking. See "Separating Copy Marking and Offset 09380000 Stacking" on page 135. 09390000 09400000 8. On page 349 in Figure 84 change "123 (7B) CHARACTER 1 * RESERVED" 09410000 in the middle of the page to the following. 09420000 09430000 123 (7B) UNSIGNED 1 XTP7JOG JOGGING VALUE - 09440000 (VALID FOR INITIALIZATION 09450000 "XTP7INIT" AND BDSC "XTP7BDS") 09460000 FOR FIRST DATA SET OF A JOB 09470000 0 = DEFAULT TO JES COPYMARK 09480000 SETTING. 09490000 1 = DO NOT JOG. 09500000 2 = JOG ON A DATA SET BOUNDARY. 09510000 3 = JOG ON A JOB BOUNDARY. 09520000 09530000 9. On page 358 just before XTP7FMT add the following. 09540000 09550000 XTP7JOG This option can be set by the Printer Inventory or 09560000 during the INIT call, or during the BDSC, and it 09570000 remains set between calls. PSF initially sets this 09580000 field to '0' to indicate that it is not specified and 09590000 the default is the COPYMARK setting. For more information, 09600000 see "Separating Copy Marking and Offset Stacking" on page 09610000 135. If Exit 7 sets this flag to B'1', B'2', or B'3', 09620000 PSF uses that value for offset stacking. For information 09630000 about specifying this option in the Printer Inventory, 09640000 see Offset Stacking in Table 2 on page 80. 09650000 09660000 10. On page 373 add the following to Table 33 just ahead of XTP7FMT 09670000 under INIT and BDSC. 09680000 09690000 XTP7JOG IO IO 09700000 09710000 09720000 -----------CHANGES FOR OW48165---------------------------------- 09730000 09740000 1. Figure 30, Page 59. Add the following lines: 09750000 / CSE sheet eject 09760000 Offset stacking . . . . . 3 1. None 2. Data set 3. Job 09770000 09780000 The first line (_ CSE sheet eject) is to be added right after 09790000 the _ Suppress copy marks line. 09800000 The second line (Offset stacking . . .) is to be added right 09810000 after the Issue setup messages . . . line. 09820000 09830000 2. Figure 32, Page 61. Chage the following lines: 09840000 09850000 Change: Trace mode . . . . 2 1. None 2. Internal 3. Sync 4. Full 09860000 To: Trace mode . . . . 2 1. None 2. Internal 3. Sync 09870000 4. Full 5. Limit 6. IPDS 09880000 09890000 09900000 3. On page 91 in table 2, change the following entry 09910000 09920000 ------------------------------------------------------------- 09930000 | ISPF Panel | PIDU | 09940000 |-----------------------------|-----------------------------| 09950000 |Trace mode |trace-mode | 09960000 | | | 09970000 | Values: | Values: | 09980000 | 1 = None | none | 09990000 | 2 = Internal | internal | 10000000 | 3 = Sync | sync | 10010000 | 4 = Full | full | 10020000 | 5 = Limit | limit | 10030000 | 6 = IPDS | ipds | 10040000 | | | 10050000 ------------------------------------------------------------- 10060000 ... 10070000 ------------------------------------------------------------- 10080000 | Equivalent Parameter | Description | 10090000 |----------------------|------------------------------------| 10100000 | PARM= (,type) | Specifies the type of PSF tracing | 10110000 | | started during FSA initilization. | 10120000 | | For more information about using | 10130000 | | traces, refer to PSF for OS/390: | 10140000 | | Diagnosis. | 10150000 | | | 10160000 | | Values: NONE: No PSF tracing is | 10170000 | | started during PSF | 10180000 | | initialization. | 10190000 | | | 10200000 | | INTERNAL: An internal trace| 10210000 | | is started (default). It | 10220000 | | reflects only the most | 10230000 | | recent history of PSF | 10240000 | | processing. | 10250000 | | | 10260000 | | SYNC: An FSA SYNC external | 10270000 | | trace is started. An | 10280000 | | internal trace is also | 10290000 | | started. | 10300000 | | | 10310000 | | FULL: An FSA full external | 10320000 | | trace is started. An | 10330000 | | internal trace is also | 10340000 | | started. | 10350000 | | | 10360000 | | LIMIT: A shortened FSA | 10370000 | | external trace is started | 10380000 | | along with an internal | 10390000 | | trace. | 10400000 | | | 10410000 | | IPDS: An FSA IPDS trace is | 10420000 | | started along with an | 10430000 | | internal trace. | 10440000 | | | 10450000 | | Note: The FSA trace dsname | 10460000 | | parameter is required when the | 10470000 | | trace mode is SYNC, FULL, LIMIT or | 10480000 | | IPDS. | 10490000 ------------------------------------------------------------- 10500000 10510000 -----------CHANGES FOR OW48960---------------------------------- 10520000 10530000 1. On page 107 add a "Note:" paragraph to each of the following 10540000 PRTnnn parameters: CKPTMODE=PAGE|SEC, CKPTPAGE and CKPTSEC. 10550000 10560000 Note: 10570000 PSF can only use checkpoint information that was created by the 10580000 same level of PSF that is currently printing the data set. In 10590000 other words, if a data set was checkpointed by one version/release 10600000 of PSF, but is now being printed by another version/release of 10610000 PSF the checkpoint data will be ignored and the data set 10620000 restarted from the beginning. 10630000 10640000 2. On page 112 add a "Note:" paragraph to the end of the following 10650000 Device parameters: CKPNTPG and CKPNTSEC. 10660000 10670000 Note: 10680000 PSF can only use checkpoint information that was created by the 10690000 same level of PSF that is currently printing the data set. In 10700000 other words, if a data set was checkpointed by one version/release 10710000 of PSF, but is now being printed by another version/release of 10720000 PSF the checkpoint data will be ignored and the data set 10730000 restarted from the beginning. 10740000 10750000 3. On page 283 add a "Note:" to the end of the 3rd paragraph under 10760000 Normal PSF Recovery: 10770000 10780000 Note: 10790000 PSF can only use checkpoint information that was created by the 10800000 same level of PSF that is currently printing the data set. In 10810000 other words, if a data set was checkpointed by one version/release 10820000 of PSF, but is now being printed by another version/release of 10830000 PSF the checkpoint data will be ignored and the data set 10840000 restarted from the beginning. 10850000 10860000 4. On page 420 add the following to the end of the definition of 10870000 checkpoint: 10880000 PSF can only use checkpoint information that was created by the 10890000 same level of PSF that is currently printing the data set. In 10900000 other words, if a data set was checkpointed by one version/release 10910000 of PSF, but is now being printed by another version/release of 10920000 PSF the checkpoint data will be ignored and the data set 10930000 restarted from the beginning. 10940000 10950000 -----------CHANGES FOR OW50905---------------------------------- 10960000 10970000 1. On page 221 add the following bullets to "Specific Do's and 10980000 Don'ts for C Exits". 10990000 11000000 o If a C Exit is being used, then the FSS and each FSA runs 11010000 as a "Process". Verify that SYS1.PARMLIB member BPXPRMxx 11020000 values for MAXPROCSYS and MAXPROCUSER are large enough for 11030000 each PSF FSA and the FSS to have a PROC (process). 11040000 The operator command "D OMVS,O" displays the current 11050000 values for these configuration parameters. 11060000 11070000 o The C Exit runs in the LE environment. If problems occur 11080000 because the LE runtime options are inappropriate, they can 11090000 be changed by creating a CEEUOPT object file and linking 11100000 it with each exit. See the "OS/390 Language Environment 11110000 Programming Guide" for details on changing the LE runtime 11120000 options. 11130000 11140000 o Verify that a valid RACF OMVS segment is defined for PSF 11150000 user ID, group ID or both. 11160000 11170000 -----------CHANGES FOR OW52112---------------------------- 11180000 11190000 1. Add a new chapter entitled, "Side and Edge Sensitive Paper 11200000 Handling", and use the text below for the new chapter. 11210000 11220000 You can use the Side and Edge Sensitive Paper Handling function in 11230000 PSF to support side and edge sensitive paper on printers that do not 11240000 have native side and edge sensitive paper support. 11250000 The function also provides improved performance for printers 11260000 that do have this support. 11270000 11280000 Add a section titled, "Understanding Side and Edge Sensitive Paper". 11290000 11300000 Side sensitive paper (for example, letterhead) has a defined front 11310000 and back. Edge sensitive paper (for example, prepunched) has a 11320000 defined edge where the holes are located. 11330000 11340000 For side sensitive paper, applications are coded with respect to 11350000 the front and back of the form. For edge sensitive paper, 11360000 applications are coded with respect to a particular edge. 11370000 11380000 Add a section titled, "Existing Support for Side Sensitive Paper". 11390000 11400000 Many cut-sheet printers require that side sensitive paper 11410000 (letterhead) be loaded one way for simplex (usually front-side 11420000 down) and another way for duplex (usually front-side up). This 11430000 requires either: 11440000 11450000 - Manual operator intervention to reload the tray (also called 11460000 bin) between simplex and duplex jobs. 11470000 11480000 - Two trays that are loaded, one for simplex and the other for 11490000 duplex. The application is coded to select the proper tray. 11500000 11510000 More sophisticated cut-sheet printers have support for side 11520000 sensitive paper. The paper trays have a configuration setting for 11530000 side sensitive paper, and the output prints properly for both simplex11540000 and duplex. However, the output prints by using the duplex paper 11550000 path for both simplex output and duplex output, which cuts simplex 11560000 throughput in half. 11570000 11580000 Add a section titled, "Existing Support for Edge Sensitive Paper". 11590000 11600000 In addition to the requirements for side sensitive paper, many 11610000 cut-sheet printers also require edge sensitive paper (prepunched) to 11620000 be loaded differently for simplex and duplex. This is common for 11630000 printers where the holes are on the leading or trailing edge as the 11640000 paper moves through the printer. The paper is loaded with the holes 11650000 either on the leading or trailing edge for simplex and rotated 180 11660000 degrees for duplex. This requires either: 11670000 11680000 - Manual operator intervention to reload the tray between simplex 11690000 and duplex jobs. 11700000 11710000 - Two trays that are loaded one for simplex and the other for 11720000 duplex. The application is coded to select the proper tray. 11730000 11740000 More sophisticated cut-sheet printers have support for edge 11750000 sensitive paper. The paper trays have a configuration setting for 11760000 edge sensitive paper, and the output prints properly for both 11770000 simplex and duplex. Also, the holes are stacked on the same side in 11780000 the stacker. However, the output prints by using the duplex paper 11790000 path for both simplex output and duplex output, which cuts simplex 11800000 throughput in half. 11810000 11820000 Add a section titled, "Migration Problem with Side and Edge 11830000 Sensitive Paper Handling". 11840000 11850000 When applications that have been printing on printers with side and 11860000 edge sensitive support are moved to printers that do not have this 11870000 support, you will encounter a migration problem. For example, the 11880000 printer you are migrating from had prepunched paper loaded into Tray 11890000 1 and some applications printed simplex and others duplex. For the 11900000 new printer, the only automatic way to provide simplex and duplex 11910000 support is to use two trays, where Tray 1 is loaded for simplex and 11920000 Tray 2 for duplex. Unfortunately, all of the duplex applications use 11930000 form definitions that are coded for Tray 1. You can modify the form 11940000 definitions to use Tray 2, but this might not be practical if many 11950000 form definitions are affected. The next section describes how PSF 11960000 handles this situation. 11970000 11980000 Add a section titled, "Side and Edge Sensitive Paper Handling 11990000 Support in PSF with Exit 7". 12000000 12010000 PSF is able to select different input paper trays (bins) for simplex 12020000 and duplex, regardless of the bin specified in the form definition 12030000 or in the JCL on the OUTPUT statement (INTRAY=). 12040000 This function is activated by setting the XTP7SENS flag in 12050000 installation Exit 7. Up to four different application bin values 12060000 can be mapped to real printer bins for simplex and duplex. 12070000 12080000 The print application specifies a form definition that contains one 12090000 or more copy groups. In each copy group, an input bin number is 12100000 specified that identifies which input paper bin is to be used. 12110000 12120000 Exit 7 has fields that map the input bin number to two real 12130000 printer bins, one for simplex and one for duplex. The input bin 12140000 number is coded in field XTP7BINA, the real simplex bin is coded in 12150000 field XTP7SIMA, and the real duplex bin is coded in field XTP7DUPA. 12160000 12170000 For example, if an application is coded to use edge sensitive 12180000 paper from Bin 1, you can use the Side and Edge Sensitive Paper 12190000 Handling function to use real printer Bin 1 for simplex and real 12200000 printer Bin 2 for duplex. You would then code in installation Exit 12210000 7: 12220000 12230000 - XTP7BINA = 1 (application/form definition bin number) 12240000 - XTP7SIMA = 1 (real bin number for simplex) 12250000 - XTP7DUPA = 2 (real bin number for duplex) 12260000 12270000 When the application requests simplex printing from Bin 1, PSF tells 12280000 the printer to use real Bin 1. When the application requests duplex 12290000 printing from Bin 1, PSF tells the printer to use real Bin 2. 12300000 12310000 Up to four logical bins can be remapped with these fields: 12320000 12330000 XPT7BINA XPT7BINB XTP7BINC XTP7BIND 12340000 XPT7SIMA XPT7SIMB XTP7SIMC XTP7SIMD 12350000 XPT7DUPA XPT7DUPB XTP7DUPC XTP7DUPD 12360000 12370000 The logical sets are identified with a common suffix letter. Sample 12380000 installation exits APSUX07V and APSUC07V can be modified to set any 12390000 of these fields. 12400000 12410000 For printers with native side and edge sensitive paper support, 12420000 you should consider using the support in PSF to achieve better 12430000 performance, if the printer has enough trays. 12440000 12450000 2. On page 350 at the bottom of Figure 84 change offset 196 (C4) 12460000 to read as follows. 12470000 12480000 196 (C4) CHARACTER 12 XTP7BINS SIDE AND EDGE SENSITIVITY BINS 12490000 196 (C4) UNSIGNED 1 XTP7BINA FIRST BIN 12500000 197 (C5) UNSIGNED 1 XTP7SIMA FIRST SIMPLEX BIN 12510000 198 (C6) UNSIGNED 1 XTP7DUPA FIRST DUPLEX BIN 12520000 199 (C7) UNSIGNED 1 XTP7BINB SECOND BIN 12530000 200 (C8) UNSIGNED 1 XTP7SIMB SECOND SIMPLEX BIN 12540000 201 (C9) UNSIGNED 1 XTP7DUPB SECOND DUPLEX BIN 12550000 202 (CA) UNSIGNED 1 XTP7BINC THIRD BIN 12560000 203 (CB) UNSIGNED 1 XTP7SIMC THIRD SIMPLEX BIN 12570000 204 (CC) UNSIGNED 1 XTP7DUPC THIRD DUPLEX BIN 12580000 205 (CD) UNSIGNED 1 XTP7BIND FOURTH BIN 12590000 206 (CE) UNSIGNED 1 XTP7SIMD FOURTH SIMPLEX BIN 12600000 207 (CF) UNSIGNED 1 XTP7DUPD FOURTH DUPLEX BIN 12610000 208 (D0) CHARACTER 1 XTP7MFG2 MORE RESPONSE FLAGS 12620000 1... .... XTP7RSV2 RESERVED - DO NOT USE 12630000 .1.. .... XTP7SENS SIDE AND EDGE SENSITIVITY FLAG 12640000 (VALID ONLY ON INIT CALL 12650000 "XTP7INIT") 12660000 0 = DO NOT USE SIDE AND EDGE 12670000 SENSITIVITY 12680000 1 - ACTIVATE SIDE AND EDGE 12690000 SENSITIVITY 12700000 ..11 1111 RESERVED 12710000 12720000 3. On page 360 add the following after XTP7DRES. 12730000 12740000 XTP7BINS 12750000 A list of possible input bins, mapped from the logical bins, that 12760000 might contain side or edge sensitive paper. 12770000 12780000 XTP7BINA 12790000 First bin that contains side or edge sensitive paper. Once 12800000 set, this field remains set between calls. 12810000 12820000 XTP7SIMA 12830000 First bin that contains simplex side or edge sensitive paper. 12840000 Once set, this field remains set between calls. 12850000 12860000 XTP7DUPA 12870000 First bin that contains duplex side or edge sensitive paper. 12880000 Once set, this field remains set between calls. 12890000 12900000 XTP7BINB 12910000 Second bin that contains side or edge sensitive paper. Once 12920000 set, this field remains set between calls. 12930000 12940000 XTP7SIMB 12950000 Second bin that contains simplex side or edge sensitive paper. 12960000 Once set, this field remains set between calls. 12970000 12980000 XTP7DUPB 12990000 Second bin that contains duplex side or edge sensitive paper. 13000000 Once set, this field remains set between calls. 13010000 13020000 XTP7BINC 13030000 Third bin that contains side or edge sensitive paper. Once 13040000 set, this field remains set between calls. 13050000 13060000 XTP7SIMC 13070000 Third bin that contains simplex side or edge sensitive paper. 13080000 Once set, this field remains set between calls. 13090000 13100000 XTP7DUPC 13110000 Third bin that contains duplex side or edge sensitive paper. 13120000 Once set, this field remains set between calls. 13130000 13140000 XTP7BIND 13150000 Fourth bin that contains side or edge sensitive paper. Once 13160000 set, this field remains set between calls. 13170000 13180000 XTP7SIMD 13190000 Fourth bin that contains simplex side or edge sensitive paper. 13200000 Once set, this field remains set between calls. 13210000 13220000 XTP7DUPD 13230000 Fourth bin that contains duplex side or edge sensitive paper. 13240000 Once set, this field remains set between calls. 13250000 13260000 XTP7MFG2 13270000 Flags that the exit can modify to request certain functions. 13280000 13290000 XTP7RSV2 13300000 Reserved - do not use 13310000 13320000 XTP7SENS 13330000 This option can be set during the INIT call and it remains 13340000 set between calls. PSF initially sets this flag to B'0' 13350000 to indicate that PSF does not use the side and edge 13360000 sensitive paper handling function. If Exit 7 set 13370000 this flag to B'1', PSF activates the side and edge 13380000 sensitive paper handling function. 13390000 13400000 4. On page 373 add the following to the table after XTP7DRES. 13410000 13420000 INIT 13430000 13440000 XTP7BINA IO 13450000 XTP7SIMA IO 13460000 XTP7DUPA IO 13470000 XTP7BINB IO 13480000 XTP7SIMB IO 13490000 XTP7DUPB IO 13500000 XTP7BINC IO 13510000 XTP7SIMC IO 13520000 XTP7DUPC IO 13530000 XTP7BIND IO 13540000 XTP7SIMD IO 13550000 XTP7DUPD IO 13560000 XTP7MFG2 13570000 XTP7SENS IO 13580000 13590000 -----------CHANGES FOR OW53147---------------------------- 13600000 13610000 On page 235 change the last entry in Figure 70 "Format of 13620000 Exit-Communication Area Extension, APSUECE" from: 13630000 13640000 240 (F0) Character 24 * Reserved 13650000 13660000 to: 13670000 13680000 240 (F0) CHARACTER 8 ECEFSSNM FSS name (writer proc name) 13690000 248 (F8) CHARACTER 16 * Reserved 13700000 13710000 -----------CHANGES FOR OW53830---------------------------------- 13720000 13730000 13740000 1. On page 71, Table 2, under the Description column, change 13750000 the second and third sentence in the first paragraph to read: 13760000 13770000 "... from JES for this time period, PSF issues a message and 13780000 ends the session with the printer. If the JES NPRO parameter 13790000 is nonzero, PSF forces all pages from the last job to reach 13800000 the ... job to be purged from the spool." 13810000 13820000 2. On page 71, Table 2, Description column, after the first 13830000 paragraph, add the following paragraph: 13840000 13850000 "If the JES NPRO parameter is zero, PSF does not force 13860000 all the pages of the last job to the stacker, but issues a 13870000 message and ends the session. To force all the pages of the 13880000 last job to the stacker, send another print job to the 13890000 printer or stop the PSF FSA." 13900000 13910000 3. On page 108, under the NPRO parameter, add the paragraph: 13920000 13930000 "If NPRO=0 and the PSF DISCINTV parameter is being used, PSF 13940000 does not force all the pages of the last job to the stacker 13950000 when the DISCINTV timer expires. Specify a non-zero NPRO 13960000 value to force the last pages of the last job to the stacker 13970000 when the DISCINTV timer expires. For more information, see 13980000 the DISCINTV parameter in Table 2 on page 71." 13990000 14000000 4. On page 114, under the NPRO parameter, add the paragraph: 14010000 14020000 "If NPRO=0 and the PSF DISCINTV parameter is being used, PSF 14030000 does not force all the pages of the last job to the stacker 14040000 when the DISCINTV timer expires. Specify a non-zero NPRO 14050000 value to force the last pages of the last job to the stacker 14060000 when the DISCINTV timer expires. For more information, see 14070000 the DISCINTV parameter in Table 2 on page 71." 14080000 14090000 -----------CHANGES FOR OW55219---------------------------------- 14100000 1. In the new "Side and Edge Sensitive Paper Handling" chapter 14110000 (added by APAR OW52112), add a section titled 14120000 "Side and Edge Sensitive Paper Handling Support 14130000 with the Printer Inventory" after the section titled "Side and 14140000 Edge Sensitive Paper Handling Support in PSF with Exit 7". 14150000 14160000 PSF is able to select different input paper trays (bins) for 14170000 simplex and duplex by using the Printer Inventory. This function is 14180000 activated when tray values are specified in the Printer 14190000 Inventory. Up to four different application tray values can be mapped 14200000 to real printer trays for simplex and duplex. 14210000 14220000 The print application specifies a form definition that contains one 14230000 or more copy groups. In each copy group, an input tray number is 14240000 specified that identifies which input paper tray is to be used. 14250000 14260000 The Printer Inventory has parameters that map the input tray 14270000 number (source tray) to two real printer trays (substitution 14280000 trays), one for simplex and one for duplex. You can 14290000 specify the source tray number, the simplex substitution tray, and 14300000 the duplex substitution tray in the Printer Inventory by using the 14310000 Infoprint Server ISPF panels or the Printer Inventory Definition 14320000 Utility (PIDU). 14330000 14340000 To specify the tray values with the ISPF Printer Inventory panels, you 14350000 use the Input Tray Substitution parameter. 14360000 14370000 To specify the tray values with the PIDU statement, you use the 14380000 tray_substitution parameter. 14390000 14400000 For example, if an application is coded to 14410000 use edge sensitive paper from Tray 1, you can use the Side and Edge 14420000 Sensitive Paper Handling function to use Substitution Tray 1 for 14430000 simplex and Substitution Tray 2 for duplex. To do this, use one 14440000 of the following parameters: 14450000 14460000 * PIDU: 14470000 14480000 tray_substitutions={1->{1 2}} 14490000 14500000 Note: Braces must be entered as shown and do not indicate an 14510000 alternative value. 14520000 14530000 * ISPF panel: 14540000 14550000 Input Tray Substitution: 14560000 Source Substitution tray: 14570000 tray: simplex duplex 14580000 _1_ _1_ _2_ 14590000 14600000 When the application requests simplex printing from Tray 1, PSF tells 14610000 the printer to Substitution Tray 1. When the application request dublex 14620000 printing from Tray 1, PSF tells the printer to use Substitution Tray 2. 14630000 14640000 To specify multiple tray values, use one of these parameters: 14650000 14660000 * PIDU: 14670000 14680000 tray_substitutions={1->{1 2}2->{3 4}3->{1 4}} 14690000 14700000 Note: Braces must be entered as shown and do not indicate an 14710000 alternative value. 14720000 14730000 * ISPF panel: 14740000 14750000 Input Tray Substitution: 14760000 Source Substitution tray: 14770000 tray: simplex duplex 14780000 _1_ _1_ _2_ 14790000 _2_ _3_ _4_ 14800000 _3_ _1_ _4_ 14810000 14820000 These examples map source Tray 1 to Substitution Tray 1 for simplex 14830000 and Substitution Tray 2 for duplex. Source Tray 2 is mapped to 14840000 Substitution Tray 3 for simplex and Substitution Tray 4 for duplex. 14850000 Source Tray 3 is mapped to Substitution Tray 1 for simplex and 14860000 Substitution Tray 4 for duplex. 14870000 14880000 For printers with native side and edge sensitive paper support, 14890000 you should consider using the support in PSF to achieve better 14900000 performance, if the printer has enough trays. 14910000 14920000 2. On Figure 31. "Sample ISPF Printer Inventory Panel (Page 2 of 3)" 14930000 on page 60, add the following fields to the ISPF panels after the 14940000 Retained Resource Counts fields: 14950000 14960000 Input Tray Substitution: 14970000 Source Substitution tray: 14980000 tray: simplex duplex 14990000 ___ ___ ___ 15000000 ___ ___ ___ 15010000 ___ ___ ___ 15020000 ___ ___ ___ 15030000 15040000 3. On table 2 "Printer Inventory Parameters Compared to ...", 15050000 add the following table entries on page 62 to describe this new 15060000 Printer Inventory parameter. 15070000 15080000 _________________________________________________________ 15090000 Input Tray Substitution: | tray_substitutions | XTP7BINA | 15100000 Source tray | | XTP7BINB | 15110000 | Syntax: {source1-> | XTP7BINC | 15120000 | {subsim1 subdup1}} | XTP7BIND | 15130000 | | XTP7SENS | 15140000 _________________________|____________________|__________|_________ 15150000 Specifies the mappings for bins for Side and Edge | 15160000 Sensitivity. | 15170000 | 15180000 Values: 1 to 255 | 15190000 | 15200000 Note: Refer to the "Side and Edge Sensitive Paper Handling" | 15210000 chapter for more information about Side and Edge Sensitivity and | 15220000 for information about how to use these parameters. | 15230000 __________________________________________________________________| 15240000 15250000 _________________________________________________________ 15260000 Input Tray Substitution: | tray_substitutions | XTP7SIMA | 15270000 Substitution tray: | | XTP7SIMB | 15280000 Simplex | Syntax: {source1-> | XTP7SIMC | 15290000 | {subsim1 subdup1}} | XTP7SIMD | 15300000 | | XTP7SENS | 15310000 _________________________|____________________|__________|_________ 15320000 Specifies the mappings for bins for Side and Edge | 15330000 Sensitivity. | 15340000 | 15350000 Values: 1 to 255 | 15360000 | 15370000 Note: Refer to the "Side and Edge Sensitive Paper Handling" | 15380000 chapter for more information about Side and Edge Sensitivity and | 15390000 for information about how to use these parameters. | 15400000 __________________________________________________________________| 15410000 15420000 _________________________________________________________ 15430000 Input Tray Substitution: | tray_substitutions | XTP7DUPA | 15440000 Substitution tray: Duplex| | XTP7DUPB | 15450000 | Syntax: {source1-> | XTP7DUPC | 15460000 | {subsim1 subdup1}} | XTP7DUPD | 15470000 | | XTP7SENS | 15480000 _________________________|____________________|__________|_________ 15490000 Specifies the mappings for bins for Side and Edge | 15500000 Sensitivity. | 15510000 | 15520000 Values: 1 to 255 | 15530000 | 15540000 Note: Refer to the "Side and Edge Sensitive Paper Handling" | 15550000 chapter for more information about Side and Edge Sensitivity and | 15560000 for information about how to use these parameters. | 15570000 __________________________________________________________________| 15580000 15590000 4. Add the following entries to Table 24 "Options Specified in the 15600000 Printer Inventory" on page 266: 15610000 15620000 Exit 7 |Printer Inventory |Description | 15630000 ________|_______________________|__________________________________| 15640000 XTP7BINA|Input Tray Substitution|Sets the first source tray mapping| 15650000 |Source tray |for Side and Edge Sensitive Paper | 15660000 | |Handling. For more information, | 15670000 | |see "Side and Edge Sensitive Paper| 15680000 | |Handling" on page ?. | 15690000 ________|_______________________|__________________________________| 15700000 XTP7SIMA|Input Tray Substitution|Sets the first substitution | 15710000 |Substitution tray: |simplex tray for Side and Edge | 15720000 |Simplex |Sensitive Paper Handling. For more| 15730000 | |information, see "Side and Edge | 15740000 | |Sensitive Paper Handling" on page | 15750000 | |?. | 15760000 ________|_______________________|__________________________________| 15770000 XTP7DUPA|Input Tray Substitution|Sets the first substitution | 15780000 |Substitution tray: |duplex tray for Side and Edge | 15790000 |Duplex |Sensitive Paper Handling. For more| 15800000 | |information, see "Side and Edge | 15810000 | |Sensitive Paper Handling" on page | 15820000 | |?. | 15830000 ________|_______________________|__________________________________| 15840000 XTP7BINB|Input Tray Substitution|Sets the second source tray | 15850000 |Source tray |mapping for Side and Edge | 15860000 | |Sensitive Handling. For more | 15870000 | |information see "Side and Edge | 15880000 | |Sensitive Paper Handling" on page | 15890000 | |?. | 15900000 ________|_______________________|__________________________________| 15910000 XTP7SIMB|Input Tray Substitution|Sets the second substitution | 15920000 |Substitution tray: |simplex tray for Side and Edge | 15930000 |Simplex |Sensitive Paper Handling. For more| 15940000 | |information, see "Side and Edge | 15950000 | |Sensitive Paper Handling" on page | 15960000 | |?. | 15970000 ________|_______________________|__________________________________| 15980000 XTP7DUPB|Input Tray Substitution|Sets the second substitution | 15990000 |Substitution tray: |duplex tray for Side and Edge | 16000000 |Duplex |Sensitive Paper Handling. For more| 16010000 | |information, see "Side and Edge | 16020000 | |Sensitive Paper Handling" on page | 16030000 | |?. | 16040000 ________|_______________________|__________________________________| 16050000 XTP7BINC|Input Tray Substitution|Sets the third source tray mapping| 16060000 |Source tray |for Side and Edge Sensitive Paper | 16070000 | |Handling. For more information, | 16080000 | |see "Side and Edge Sensitive Paper| 16090000 | |Handling" on page ?. | 16100000 ________|_______________________|__________________________________| 16110000 XTP7SIMC|Input Tray Substitution|Sets the third substitution | 16120000 |Substitution tray: |simplex tray for Side and Edge | 16130000 |Simplex |Sensitive Paper Handling. For more| 16140000 | |information, see "Side and Edge | 16150000 | |Sensitive Paper Handling" on page | 16160000 | |?. | 16170000 ________|_______________________|__________________________________| 16180000 XTP7DUPC|Input Tray Substitution|Sets the third substitution | 16190000 |Substitution tray: |duplex tray for Side and Edge | 16200000 |Duplex |Sensitive Paper Handling. For more| 16210000 | |information, see "Side and Edge | 16220000 | |Sensitive Paper Handling" on page | 16230000 | |?. | 16240000 ________|_______________________|__________________________________| 16250000 XTP7BIND|Input Tray Substitution|Sets the fourth source tray | 16260000 |Source tray |mapping for Side and Edge | 16270000 | |Sensitive Handling. For more | 16280000 | |information see "Side and Edge | 16290000 | |Sensitive Paper Handling" on page | 16300000 | |?. | 16310000 ________|_______________________|__________________________________| 16320000 XTP7SIMD|Input Tray Substitution|Sets the fourth substitution | 16330000 |Substitution tray: |simplex tray for Side and Edge | 16340000 |Simplex |Sensitive Paper Handling. For more| 16350000 | |information, see "Side and Edge | 16360000 | |Sensitive Paper Handling" on page | 16370000 | |?. | 16380000 ________|_______________________|__________________________________| 16390000 XTP7DUPD|Input Tray Substitution|Sets the fourth substitution | 16400000 |Substitution tray: |duplex tray for Side and Edge | 16410000 |Duplex |Sensitive Paper Handling. For more| 16420000 | |information, see "Side and Edge | 16430000 | |Sensitive Paper Handling" on page | 16440000 | |?. | 16450000 ________|_______________________|__________________________________| 16460000 XTP7SENS|Input Tray Substitution|Controls whether to use Side | 16470000 | |and Edge Sensitive Paper | 16480000 | |Handling. For more information, | 16490000 | |see "Side and Edge Sensitive Paper| 16500000 | |Handling" on page ?. | 16510000 ________|_______________________|__________________________________| 16520000