UPGRADE: PSFMVS211 INTRODUCTORY TEXT PG 001 OF 054 ************************ * UPGRADE PSFMVS211 * ************************ THIS UPGRADE CONTAINS INSTALLATION INFORMATION AND/OR HIGH IMPACT/PERVASIVE APAR INFORMATION FOR VERSION 2, RELEASE 1, MODIFICATION 1 FOR PRINT SERVICES FACILITY (MVS) ************************************************************************ * P R O D U C T I N D E X ************************************************************************ PID NUMBER SYSTEM DESCRIPTION SUBSET ID 5695040 MVS PSF 2.1.1 BASE HPRF102/9311 5695040 MVS PAGE PRTR MIGR PROG 2.1.0 JPRF114 5648062 MVS ACIF HQN2110 5648062 MVS AFPAPI HQN2112 UPGRADE: PSFMVS211 ADDITIONAL TEXT PG 002 OF 054 HIGH IMPACT/PERVASIVE (HIPER) APAR INSTRUCTIONS Included in this Upgrade may be one or more APARs that describe problems that are of a High Impact or extremely pervasive nature. The following fields provide an outline of those APARs in section 4: "PROBLEM:" Brief description of the APAR "USERS AFFECTED:" If you have this Product/device/situation, you are exposed to the problem. The APAR or PTF fix should be applied in those cases. "RECOMMENDATION:" Take action that is described, most often that will be the application of an APAR or PTF fix. VOLID'S VOLID 1000 - Reflects corrective service (not on a PUT tape) UPGRADE: PSFMVS211 ADDITIONAL TEXT PG 003 OF 054 VOLID 9XXX - Reflects a PUT tape that the PTF can be located on. VOLID FXXX - Reflects a PUT tape. The 'F' represents a '9' and the XXX represents a PUT number. ******* ATTENTION: MVS SMP/E USERS (CBPDO NO CHARGE OFFERING): ***** Customers ordering the Custom Built Product Delivery Offering (CBPDO) also receive PSP information in softcopy. In addition, CBPDO "VOLIDs" will appear in the PSP subset sections 3, 4 and 5. A VOLID of "1YWW", where Y is the year and WW is the week within that year, indicates that the PTF was included on that CBPDO and successive CBPDOs. Customers wishing more information should contact their IBM Marketing Branch Office. UPGRADE: PSFMVS211 ADDITIONAL TEXT PG 004 OF 054 UPGRADE: PSFMVS211 ADDITIONAL TEXT PG 005 OF 054 UPGRADE: PSFMVS211 ADDITIONAL TEXT PG 006 OF 054 UPGRADE: PSFMVS211 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 007 OF 054 *********************** * SUBSET CHG/INDEX * *********************** THE PURPOSE OF THIS SUBSET IS TO TRACK ALTERATIONS TO THE VARIOUS ELEMENTS OF THIS UPGRADE. *********************************************************************** * C H A N G E I N D E X * *********************************************************************** DATE SUBSET ALTERED COMMENTS 48. 96/08/26 HPRF102/9311 SECTION 3, ADDED ITEM 13 47 96/08/07 HPRF102/9311 SECTION 4, ADDED ITEM 7 OW19962 UW29809 46. 96/02/02 HQN2110 SECTION 3, ADDED ITEM 1 45 95/11/08 HQN2110 SECTION 4, ADDED ITEM 3 PN77224 UN83595 44. 95/11/03 HPRF102/9311 SECTION 4, ADDED ITEM 6 43 95/10/04 HQN2110 SECTION 4, ADDED ITEM 2 PN72026 UN81782 UPGRADE: PSFMVS211 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 008 OF 054 42. 95/08/18 HPRF102/9311 SECTION 3, ADDED ITEM 12 41. 95/08/04 HQN2112 SECTION 3, ADDED ITEM 4 40. 95/07/31 HPRF102/9311 SECTION 3, ADDED ITEM 11 39 95/07/18 HQN2112 SECTION 4, ADDED ITEM 2 PN71721 UN78246 38. 95/06/30 HQN2112 SECTION 3, ADDED ITEM 3 37. 95/03/27 HPRF102/9311 SECTION 2, ADDED ITEM 2 36 94/10/24 HPRF102/9311 SECTION 4, ADDED ITEM 5 OW07612 UW11414 35. 94/10/20 HPRF102/9311 SECTION 3, ADDED ITEM 10 34. 94/10/11 HQN2112 SECTION 1, ADDED ITEM 7 33. 94/09/15 HQN2112 SECTION 1, ADDED ITEM 6 32. 94/08/25 HPRF102/9311 SECTION 1, ADDED ITEM 8 31. 94/08/15 HPRF102/9311 SECTION 1, ADDED ITEM 7 30. 94/08/12 HPRF102/9311 SECTION 5, UPDATED ITEMS 2,3 HPRF102/9311 SECTION 1, ADDED ITEM 7 29 94/07/20 HPRF102/9311 SECTION 4, ADDED ITEM 4 OW06321 UW08937 28. 94/07/19 HPRF102/9311 SECTION 5, ADDED DELETED ITEM 1 HPRF102/9311 SECTION 5, ADDED UPDATED TIMES 2,3 27. 94/06/15 HPRF102/9311 SECTION 1, ADDED ITEM 6 26 94/04/04 HPRF102/9311 SECTION 4, ADDED ITEM 3 OW03566 UW04995 UPGRADE: PSFMVS211 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 009 OF 054 25. 94/03/03 HPRF102/9311 SECTION 1, ADDED ITEM 5 23. 94/02/08 HQN2112 SECTION 3, ADDED ITEM 2 22. 94/02/01 HQN2112 SECTION 1, UPDATED ITEM 1 21. 93/12/10 HPRF102/9311 SECTION 5, ADDED ITEM 8 20. 93/11/30 HQN2112 SECTION 1, ADDED ITEM 5 19 93/11/24 HPRF102/9311 SECTION 4, ADDED ITEM 2 OY67479 UW00222 18. 93/11/10 HPRF102/9311 SECTION 1, ADDED ITEM 4 17. 93/11/03 HPRF102/9311 SECTION 1, ADDED ITEM 3 16 93/10/22 HPRF102/9311 SECTION 4, ADDED ITEM 1 OY62792 UY92850 15. 93/10/14 HPRF102/9311 SECTION 5, ADDED ITEM 7 14. 93/09/23 HPRF102/9311 SECTION 5, UPDATED ITEM 2 13. 93/09/21 HPRF102/9311 SECTION 2, ADDED ITEM 1 12. 93/09/17 HQN2112 SECTION 1, ADDED ITEM 4 11. 93/09/16 HPRF102/9311 SECTION 1, ADDED ITEM 2 10 93/08/02 HQN2112 SECTION 4, ADDED ITEM 1 PN36146 UN44746 9. 93/07/09 HPRF102/9311 SECTION 3, ADDED ITEM 9 8 93/07/05 HQN2110 SECTION 4, ADDED ITEM 1 PN39451 UN43866 7. 93/06/30 HQN2112 SECTION 1, ADDED ITEM 3 HQN2112 SECTION 3, ADDED ITEM 1 UPGRADE: PSFMVS211 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 010 OF 054 HQN2112 SECTION 1, UPDATED ITEM 2 6. 93/06/29 JPRF114 SUBSET CREATED 5. 93/06/28 HPRF102/9311 SECTION 5, ADDED ITEM 6 HQN2112 SECTION 1, ADDED ITEM 2 4. 93/06/14 HQN2110 SECTION 1, ADDED ITEM 1 HQN2112 SECTION 1, ADDED ITEM 1 HPRF102/9311 SECTION 1, ADDED ITEM 1 3. 93/05/18 HPRF102/9311 SECTION 3, ADDED ITEM 8 2. 93/05/17 HPRF102/9311 SECTION 3 & 5 REPLACED 1. 93/04/30 UPGRADE/SUBSETS CREATED - SMRG UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 011 OF 054 *********************** * SUBSET HPRF102/9311 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR PSF BASE VERSION 2, RELEASE 1, MODIFICATION 1. ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. 94/08/25 INSTALLATION INFORMATION 2. 95/03/27 DOCUMENTATION CHANGES 3. 96/08/26 GENERAL INFORMATION 4. 96/08/07 SERVICE RECOMMENDATIONS 5. 94/08/12 CROSS PRODUCT DEPENDENCIES UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 012 OF 054 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 7 96/08/07 OW19962 UW29809 9606 HIPER EXCESSIVE I/O TO FONT 6. 95/11/03 OW12081 UW18067 9505 HIPER IECVAFP1 USING INCORRECT 5 94/10/24 OW07612 UW11414 9410 INCOMPLETE DATASET RELEASED 4 94/07/20 OW06321 UW08937 9407 LOST PAGES ON SNA ATTACHED 3 94/04/04 OW03566 UW04995 9403 PSF LOOPS IN APSPPNPR AFTER 2 93/11/24 OY67479 UW00222 9311 ABEND024 RC0333 ISSUED FROM 1. 93/10/22 OY62792 UY92850 F304 WHEN PRINTING TO PSF/2 USING ************************************************************************ * SECTION 1. I N S T A L L A T I O N I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS CHANGES TO THE PRODUCT'S PROGRAM DIRECTORY. 8. 94/08/25 Section 6.1.5 UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 013 OF 054 The transfer of ownership job (APSWMFID) should not be run under the following circumstances. 1. Customer is HDP3330 or above and never had PSF installed. 2. Customer is any level DFP, and had prior PSF installed in BCP CSI and is installing new PSF in BCP CSI. ********************************************************* Note: If the job is run under these circumstances, a RC4 will be received. ********************************************************* All other situations should run the APSWMFID job. However, if you have DFP HDP2240 or higher installed, you will receive RC4 due to IGE0000E not being present. The RC4 is acceptable. After the APPLY and ACCEPT have been run, an SMPE query should indicate that PSF HPRF102 is the owner of the module/macros. 7. 94/08/12 SECTION OF PROG. DIRECTORY REFERENCED: 6.1.8 UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 014 OF 054 Load module APQIVUM listed in second bullet should be APQINVM. Also, APQIOBJ should be added to the list of load modules expected to get an unresolved external reference. 6. 94/06/15 If you presently have PSF V2.1.0 installed, and the maintenance level of V2.1.0 is PUT 9301 or higher, DO NOT INSTALL V2.1.1. If you do apply V2.1.1, you may regress modules that are already at a higher level. If you received an ACCUM tape with your order, RECEIVE and APPLY the ACCUM tape maintenance only. 5. 94/03/03 SECTION OF PROG. DIRECTORY REFERENCED: 5.3.1 Figure 12 shows that ACF/VTAM 3.2 is required to run PSF 2.1.1. This is incorrect as VTAM 3.2 went off support 9/30/92. Since version 3.2 is no longer supported, ACF/VTAM 3.3 is now required. 4. 93/11/10 SECTION OF PROG. DIRECTORY REFERENCED: 5.3.7.3 The FDEFLIB and AFDEFLIB DD statements in the APSWALOC UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 015 OF 054 job (Figure 29) have an incorrect number of Directory Blocks specified. They have 'SPACE=(8209,(5,1,1))' and should be 'SPACE=(8209,(5,1,3))'. Figure 22 in section 5.3.7.1 and figure 26 in section 5.3.7.2 specify the correct number of directory blocks (3) for the FDEFLIB and AFDEFLIB. 3. 93/11/03 SECTION OF PROG. DIRECTORY REFERENCED: 5.3.6 A note should be added to Figure 17 which reads: If installing HPRF102 in the same CSI as a previous release of PSF, please note that IGE0000E is deleted from SYS1.LPALIB and is loaded into SYS1.LINKLIB. 2. 93/09/16 SECTION OF PROG. DIRECTORY REFERENCED: 5.3.1 In Section 5.3.1, Operating System and Programming Requirements on page 23, under "MVS/ESA SP Version 4 Release 1.0:" it states: "To use PSF/MVS Version 2.1.1 under MVS/ESA SP Version 4 Release 1.0, the system must be at, or above, the following levels: UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 016 OF 054 - Data Facility Product (MVS/SP DFP) Version 3 Release 3.0" The last statement should read: - Data Facility Product (MVS/SP DFP) Version 3 Release 2.0 or higher. 1. 93/06/14 SECTION OF PROG. DIRECTORY REFERENCED: 5.3.4 For those customers that already have PSF V2.1.0 installed and are at a current maintenance level (9205 and above) it is NOT necessary to install V2.1.1 to be able to PRINT ACIF output. However, APAR OY60684, PTF UY89007 from PUT tape 9301 MUST be applied. ************************************************************************ * SECTION 2. D O C U M E N T A T I O N C H A N G E S * ************************************************************************ THIS SECTION OUTLINES MAJOR ERRORS IN THE PRODUCT'S PUBLISHED DOCUMENTATION. UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 017 OF 054 2. 95/03/27 PSF MVS V2.1.1 PROGRAM DIRECTORY G544-3668-01 SECTION 5.3.3 MACHINE REQUIREMENTS ADD TO ALL AREAS THAT MENTION IBM 3174 Establishment Controller CONFIGURATION SUPPORT C, RELEASE 5.1 with PTRB1E4 and PTRB1D9 or V6.0 with PTRB1D9. 1. 93/09/21 PSF/MVS System Programming Guide (S544-3672-01) APSPPIEP PPT entry in SCHEDxx member of parmlib no longer necessary after MVSXA 2.1.0. See DOC APAR OY66645 (attached) for more detail. ************************************************************************ * SECTION 3. G E N E R A L I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS GENERAL INFORMATION, I.E. SYSGEN HINTS/TIPS. 13. 96/08/26 The MVS 'D U' (DISPLAY UNIT) command will show a device UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 018 OF 054 type 3820 for device types 3791L and 3174. The UCBTYPE for the d/t3820 is the same as for the 3791L and 3174 because PSF uses the d/t3791L device support code for d/t3820 devices. The device type will show as 3820 for UCBs created with either MVSCP or HCD. Even if a d/t3791L or d/t3174 is specifically defined after a d/t3820, the 'D U' command will show a device type of 3820. It is important to note that the devices are defined correctly and will work accordingly. This is a known restriction and is documented in SUG apar OY49195. Because the 3820 is an older printer with limited currency, PSF currently has no plans to rewrite the 3820 device support code. 12. 95/08/18 If you would like to receive a listing of all of the NEW FUNCTION apars and ptfs and WHAT THEY CAN DO FOR YOU, please fax a note to 1-800-865-9053 requesting the NEW FUNCTION APAR LIST for PSF V2.x.x UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 019 OF 054 PLEASE PROVIDE US WITH YOUR MAILING ADDRESS. 11. 95/07/31 Please notice that the DEFAULT PSF startup procs listed in the APPENDIX 'B' of the PROGRAM DIRECTORY are SAMPLES. The values supplied may NOT work for your installation. Specifically, the values specified for default FORMDEF, PAGEDEF and CHARS may need changing if your installation uses paper sizes other than 8.5" x 11".(US Standard) 10. 94/10/20 APS532I OR APS280I WHEN USING IBM SUPPLIED APSWPROB STARTUP PROC MSGAPS532I 'FONT NOT FOUND' or APS280I 'RESOLUTION OF THE FONT DOES NOT AGREE WITH THE RESOLUTION OF THE DEVICE' is issued when customer uses IBM supplied APSWPROB startup proc for SNA attached 300 pel printers and does not follow the directions that precede the CHARs parameter. 9. 93/07/09 II06598 (attached) - WAIT025 WAIT035 WAIT055 WAIT064 after install of PSF V2.1.1. UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 020 OF 054 8. 93/05/18 II06878 (attached) - Hung draining or starting in a multi-FSA environment 7. 92/11/02 Information for fonts contained in separate licensed programs, in PSF and PMF. See Info APAR II05010 (attached). 6. 92/05/07 The following informational APARs should be reviewed prior to PSF installation and periodically due to changes. II01835 Blank page before the trailer page when M=Y is specified in the JES parms. II03268 Diagnosis aids for PSF/MVS. II04452 Abend0c4 received when running print services facility in the MVS environment. II01933 AFP fonts - common user errors and misc information. II02890 JES2/FSS Startup - Information regarding steplib JCL statements when used in the JES2 and/or FSS (e.g. PSF) startup procedures. UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 021 OF 054 II02083 PSF printers. II02026 Single blank page between jobs. II01933 AFP Fonts - Common user errors and miscellaneous information. 5. 92/05/05 Various abends (abend0c4, abend0c1, abend027 rc0010) can occur if a steplib is done in the JES startup proc and the same steplib is not done in the PSF startup proc. JES and PSF must be pointing to the same members HASPFSSM and HASPSSSM. Please refer to info apars II04452 and II02890. 4. 92/05/05 See II05992 (attached) - Clarification on how to use the SMF MAPPING MACRO (IFASMFR) TO ACCESS VARIOUS SECTIONS of the TYPE6 PSF record. 3. 91/12/10 See WSC FLASH 9146 if using BTS/CTS post-processing devices with the 3900 printer. 2. 91/06/12 Running MVS/PSF211 with D/T4224 or D/T4234 at UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 022 OF 054 unsupported model types or serial numbers, gets MSGAPS927I. See inof apar II05102 (attached) for more information. 1. 91/01/10 There are a few potential checkpoint problems when migrating from PSF version 1 to PSF version 2, or from version 2 back to version 1. 1) It should be noted that PSF 1.3.0 interrupted datasets will not print on PSF 2.1.0. If it is attempted, a symptom that can be expected is an ABEND024 RC08A8. 2) When more than one level of PSF is running at the same time on a single system or across multiple systems in a MAS complex, and the different versions can select jobs from a single queue, it is important that printer selection parameters be set so that any given print file is not eligible for selection by more than one level of PSF. The reason for these restrictions is because each level of PSF has a unique internal format of the checkpoint UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 023 OF 054 data. PSF has addressed this problem by recognizing that a checkpoint data set was originally run on version 1 (PSF 1.2.1 or 1.3.0). PSF will cause this data set to be reprinted from the beginning. All pages printed before the interrupt will be reprinted. ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ 7 96/08/07 PROBLEM: (OW19962) EXCESSIVE I/O TO FONT LIBRARY WHEN USING USERLIBS. USERS AFFECTED: All PSF/MVS 2.1.0 and 2.1.1 users who have applied PTF UW23082 and all PSF/MVS 2.2.0 users who have applied PTF UW23083 or UW23722 and code the USERLIB keyword on the OUTPUT JCL statement or specify inline Fonts. RECOMMENDATION: INSTALL UW29809 ON VOLID 9606 UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 024 OF 054 6. 95/11/03 PROBLEM: (OW12081) IECVAFP1 USING INCORRECT UCB MAPPING CAUSES STORAGE OVERLAY. MVS/ESA 5.1 WITH ESCON ATTACHED DEVICES. MANDATORY APAR USERS AFFECTED: PSF/MVS 2.1.0, 2.1.1 and 2.2.0 users using MVS 5.1.0 with ESCON channel-attached printers. (MVS 5.1 or higher) RECOMMENDATION: INSTALL UW18067 ON VOLID 9505 5 94/10/24 PROBLEM: (OW07612) INCOMPLETE DATASET RELEASED BACK TO JES AS COMPLETE AFTER ERROR. 94/08/22 PTF PECHANGE USERS AFFECTED: All PSF/MVS 2.1.0, 2.1.1 and 2.2.0 users. RECOMMENDATION: INSTALL UW11414 ON VOLID 9410 4 94/07/20 PROBLEM: (OW06321) LOST PAGES ON SNA ATTACHED PRINTER AFTER APPLICATION OF OY67509 PTFS UW00750 OR UW04749. UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 025 OF 054 USERS AFFECTED: PSF/MVS Release 2.1.0 or 2.1.1 customers with APAR OY67509 applied or customers with Release 2.2.0 running to a D/T3812, D/T3816, D/T4028, D/T3930 or any of their follow-ons that report asynchronous data stream exceptions (action code '19'X). RECOMMENDATION: INSTALL UW08937 ON VOLID 9407 3 94/04/04 PROBLEM: (OW03566) PSF LOOPS IN APSPPNPR AFTER APPLICATION OF UW04370. 94/03/29 PTF PECHANGE USERS AFFECTED: PSF/MVS 2.1.0 and PSF/MVS 2.1.1 users. RECOMMENDATION: INSTALL UW04995 ON VOLID 9403 2 93/11/24 PROBLEM: (OY67479) ABEND024 RC0333 ISSUED FROM APSQDEQ AT OFFSET X'980' FOLLOWING A $C OR $I COMMAND IN JES2 or *C COMMAND IN JES3 UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 026 OF 054 USERS AFFECTED: All users of PSF/MVS 2.1.0 and PSF/MVS 2.1.1. RECOMMENDATION: INSTALL UW00222 ON VOLID 9311 1 93/10/22 PROBLEM: (OY62792) WHEN PRINTING TO PSF/2 USING DPF ABEND0C4 PIC11 AT X'95C' INTO APSCOPCI. USERS AFFECTED: All PSF/MVS 2.1.0 and 2.1.1 users. RECOMMENDATION: INSTALL UY92850 ON VOLID F304 ************************************************************************ * SECTION 5. C R O S S P R O D U C T D E P E N D E N C I E S * ************************************************************************ THIS SECTION CONTAINS INFORMATION THAT IS DEPENDENT UPON ANOTHER PRODUCT OTHER THAN THIS SUBSET ID. 8. 93/12/10 INTERDEPENDENT PRODUCT: VTAM 4.1 (HVT4101) UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 027 OF 054 PROBLEM: (OY66273) MSGAPS928I RC0F16 or RC0F14 and SNS10086000 USERS AFFECTED: Those printing to a channel attached LU6.2 D/T3820 RECOMMENDATION: INSTALL UY97293 ON VOLID T9308 7. 93/10/14 INTERDEPENDENT PRODUCT: Functional Subsystem Interface (FSI) PROBLEM: PSF Direct Attached printing causes ABEND0C4 in VSM when called from IAZFSIT. USERS AFFECTED: Users of HBB4430 RECOMMENDATION: INSTALL UY91339 ON VOLID 9303 6. 93/06/28 INTERDEPENDENT PRODUCT: SMPE 7.0 PROBLEM: IR23048 - WAIT025 at IPL USERS AFFECTED: Installers of PSF using SMPE 7.0 RECOMMENDATION: See APAR IR23048 FOR MORE DETAIL. 5. 93/02/19 Interdependent product: MVS/ESA 4.3 UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 028 OF 054 PROBLEM: See APAR OY59040 (attached) PSF in Direct Attach(DPSS) mode may receive MSGAPS520I System Function RDJFCB was unsuccessful. Also: ABEND013 RCC0. USERS AFFECTED: PSF user's in Direct Attach(DPSS) RECOMMENDATION: INSTALL UY86559 ON VOLID 9210 4. 91/07/27 Interdependent product: RPM PROBLEM: See apars IC02349 (RPM V2) and IC02346 (RPM V3) for added functions in PSF/MVS 2.1.0 for which corresponding RPM changes are required. USERS AFFECTED: RPM users 3. 91/06/11 Interdependent product: JES3 JES3 users should review the following apars and apply the appropriate PTFs: OY28880 - ABEND0C4 when switching between PSF 2.1.1 & 1.3.0 OY37020 - ABEND024 RC00C1 OY34990 - ABENDB0A UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 029 OF 054 OY56566 - IAT7968 OW04123 - FSS HANG or WAIT OW05477 - FSS HANG or WAIT OW06507 - Checkpoint Restart 2. 91/01/28 Interdependent product: JES2 JES2 users should review the following APARS and apply the appropriate PTFS: OY28880 - ABEND0C4 when switching between PSF 2.1.1 and 1.3 OY38709 - No trailer page after $Z issued to printer OY35171 - ABEND0C4 to D/T4234 OY37020 - ABEND024 RC00C1 OY34990 - ABENDB0A OY49466 - Printer prints 5 pages and hesitates 3 seconds OY57695 - Lines not displayed with $DU,PRTnnn OY57987 - PSF gets ABEND0C4 after PSF restart OY56563 - $TO command cannot be used to modify CHARS= OY56894 - Multi data set job does not get requeued for UPGRADE: PSFMVS211 SUBSET: HPRF102/9311 INTRODUCTORY TEXT PG 030 OF 054 printing if PSF has I/O error OY50197 - Using $T command to alter SEPDS does not take effect until draining the printer". OY57919 - Doc apar - $TOJ with DEST change will cause data set to restart printing at beginning and not at point of interruption. OY61553 - After paper jam outgroup prints again OY65893 - Printer hung when $ZPRTxxx followed by a cancel FSS OW04205 - FSS WAIT or HANG OW05885 - ABEND0C4 in HASPFSSM 1. 91/01/11 ITEM DELETED 94/07/19 ************************************************************************ * I N F O R M A T I O N A L / D O C U M E N T A T I O N * * APARS FOLLOW (IF ANY) * ************************************************************************ UPGRADE: PSFMVS211 SUBSET: HQN2110 INTRODUCTORY TEXT PG 031 OF 054 *********************** * SUBSET HQN2110 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR ACIF VERSION 2, RELEASE 1, MODIFICATION 1. ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. 93/06/14 INSTALLATION INFORMATION 2. YY/MM/DD DOCUMENTATION CHANGES NO ENTRIES 3. 96/02/02 GENERAL INFORMATION 4. 95/11/08 SERVICE RECOMMENDATIONS 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES UPGRADE: PSFMVS211 SUBSET: HQN2110 INTRODUCTORY TEXT PG 032 OF 054 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 3 95/11/08 PN77224 UN83595 9511 HIPER ACIF NOT COLLECTING ALL 2 95/10/04 PN72026 UN81782 9509 HIPER ROLLUP OF APPLICABLE PSF 1. 93/07/05 PN39451 UN43866 9307 MSGAPK411S ANYTIME TRYING TO ************************************************************************ * SECTION 1. I N S T A L L A T I O N I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS CHANGES TO THE PRODUCT'S PROGRAM DIRECTORY. 1. 93/06/14 SECTION OF PROG. DIRECTORY REFERENCED: 5.3.7.3 Job APKQALOC contains some incorrect &DVOL and &TVOL 'VOL=SER=' designations for DD statements SAPKMOD1, AAPKSAM1,AAPKSAM2,AAPKULIB,AAPKSAM3,SAPQMOD1,SAPQMOD2, AAPQULIB and AAPQSAM1. See apar PN41826. UPGRADE: PSFMVS211 SUBSET: HQN2110 INTRODUCTORY TEXT PG 033 OF 054 ************************************************************************ * SECTION 2. D O C U M E N T A T I O N C H A N G E S * ************************************************************************ THIS SECTION OUTLINES MAJOR ERRORS IN THE PRODUCT'S PUBLISHED DOCUMENTATION. 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 3. G E N E R A L I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS GENERAL INFORMATION, I.E. SYSGEN HINTS/TIPS. 1. 96/02/02 WARNING! ACIF 2.2.0 WILL DELETE ACIF 1.1.0 IF INSTALLED IN THE SAME SMP/E ZONE. UPGRADE: PSFMVS211 SUBSET: HQN2110 INTRODUCTORY TEXT PG 034 OF 054 If you are installing or have already installed RMDS 2.2.0 (HQK3220) and ACIF 2.2.0 (HQN2220), DO NOT INSTALL HQN2110 supplied with PSF. Please see the Program Directory for ACIF 2.2.0 and the PSP bucket UPGRADE: ACIF220 SUBSET: HQN2220 for more details. ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ 3 95/11/08 PROBLEM: (PN77224) ACIF NOT COLLECTING ALL CHARACTER SETS WITH RESTYPE=FONT OR RESTYPE=ALL SPECIFIED USERS AFFECTED: ALL USERS OF ACIF RECOMMENDATION: INSTALL UN83595 ON VOLID 9511 2 95/10/04 PROBLEM: (PN72026) ROLLUP OF APPLICABLE PSF MAINTENANCE INTO ACIF USERS AFFECTED: All users of ACIF. RECOMMENDATION: INSTALL UN81782 ON VOLID 9509 UPGRADE: PSFMVS211 SUBSET: HQN2110 INTRODUCTORY TEXT PG 035 OF 054 1 93/07/05 PROBLEM: (PN39451) MSGAPK411S ANYTIME TRYING TO USE TAPE. UNABLE TO OPEN FILE, ERROR CODE 9. USERS AFFECTED: All PSF/MVS 2.1.1 users of ACIF (5648-062) using tape input or output and all users who direct SYSPRINT to a TSO terminal or who override SYSPRINT block size to less than 137 or who point SYSPRINT to SYSOUT. RECOMMENDATION: INSTALL UN43866 ON VOLID 9307 ************************************************************************ * SECTION 5. C R O S S P R O D U C T D E P E N D E N C I E S * ************************************************************************ THIS SECTION CONTAINS INFORMATION THAT IS DEPENDENT UPON ANOTHER PRODUCT OTHER THAN THIS SUBSET ID. UPGRADE: PSFMVS211 SUBSET: HQN2110 INTRODUCTORY TEXT PG 036 OF 054 1. YY/MM/DD INTERDEPENDENT PRODUCT: PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX ************************************************************************ * I N F O R M A T I O N A L / D O C U M E N T A T I O N * * APARS FOLLOW (IF ANY) * ************************************************************************ UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 037 OF 054 *********************** * SUBSET HQN2112 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR AFPAPI VERSION 2, RELEASE 1, MODIFICATION 1. ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. 94/10/11 INSTALLATION INFORMATION 2. YY/MM/DD DOCUMENTATION CHANGES NO ENTRIES 3. 95/08/04 GENERAL INFORMATION 4. 95/07/18 SERVICE RECOMMENDATIONS 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 038 OF 054 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 2 95/07/18 PN71721 UN78246 9506 HIPER ABEND0C4 IN APKQTMOD WHEN 1. 93/08/02 PN36146 UN44746 F306 ENHANCED FUNCTION ************************************************************************ * SECTION 1. I N S T A L L A T I O N I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS CHANGES TO THE PRODUCT'S PROGRAM DIRECTORY. 7. 94/10/11 MSGIEW2456E is received when running the old version of APQCOCOB. This is because there are INCLUDEs for EDCXGET, EDCXFREE, EDCXLOAD, EDCXSRVI and EDCXSRVN in the old version. Since apar PN48099/UN57780 the 'C' runtime library requirement was lifted and the INCLUDE statements for these modules were removed in the new APQCOCOB. They UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 039 OF 054 were replaced with INCLUDEs for APQXGET, APQXFREE, APQXLOAD, APQXSRVI and APQXSRVN. 6. 94/09/15 SECTION OF PROG. DIRECTORY REFERENCED: 7.3 AFP API Installation Verification Procedure The API IVP will not print correctly to a D/T3812 or a NON-TURBO D/T3816 (which can be identified by microcode level that is less than V4.0). The output from the IVP will receive Off Logical Page errors and may contain Vector lines that point to where the OVERLAY should be placed on the page. The D/T3812 can be used to print API output, as long as the output does not contain an OVERLAY. The D/T3816 must be upgraded to the TURBO level to print OVERLAYS included in the API output. This can be accomplished by having your PENNANT marketing rep order FREE RPQ S02134. This RPQ will upgrade the processor and microcode for the D/T3816 to V4.0. UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 040 OF 054 5. 93/11/30 SECTION OF PROG. DIRECTORY REFERENCED: 7.3.3 A Link-Edit failure can occur when running PL/I IVP, APQCOPLI. IEW2272S "TEST option contains invalid value of 'ALL'." This causes a RC08 on the job. STEP3 and STEP4 both contain PARM='...TEST(ALL)...' This can be removed from either or both steps. 4. 93/09/17 SECTION OF PROG. DIRECTORY REFERENCED: 7.3.2 Before running the AFPAPI COBOL IVP (APQCOCOB) make sure your compile options are: ADV QUOTE NOAWO BUFSIZE(4096) NOCMPR2 NOCOMPILE(S) DATA(31) NODBCS NODECK NODUMP NODYNAM NOEXIT NOFASTSRT NOFDUMP FLAG(1) NOFLAGMIG NOFLAGSAA NOFLAGSTD LANGUAGE(EN) LIB LINECOUNT(60) LIST NOMAP NONAME NONUMBER NUMPROC(NOPFD) OBJECT NOOFFSET NOOPTIMIZE OUTDD(SYSOUT) RENT RESIDENT SEQUENCE SIZE(MAX) SOURCE SPACE(1) NOSSRANGE NOTERM NOTEST TRUNC(STD) NOVBREF NOWORD NOXREF ZWB 3. 93/06/30 SECTION OF PROG. DIRECTORY REFERENCED: 7.3.3 IVP for PL/I UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 041 OF 054 Potential Link-edit errors running IVP for PL/I (APQCOPLI). The DD DSN=pli.V2R3M0.AIBMMOD1,DISP=SHR card in the JOBLIB and SYSLIB concatenations in APQCOPLI specifies the wrong data set. To fix this potential problem, delete the DD DSN=pli.V2R3M0.AIBMMOD1, DISP=SHR card in the JOBLIB concatenation and replace the DD DSN=pli.V2R3M0.AIBMMOD1,DISP=SHR card in the SYSLIB concatenation with A DD DSN=pli.V2F3M0.PLILINK,DISP=SHR card. 2. 93/62/28 SECTION OF PROG. DIRECTORY REFERENCED: 7.3.2 Potential compile errors running IVP for COBOL APQCOCOB 1) The SYSLIB DD DSNNAME=cob.V131.COB2LIB,DISP=SHR card on the compile step in APQCOCOB can cause a compile error because of a RECFM mismatch in SYSLIB concatenation. To fix this problem, delete the SYSLIB DD DSNNAME=cob2.V131.COB2LIB,DISP=SHR card. 2) Compile errors will occur when you compile the IVP for COBOL APSCOCOB with an "APOST" COBOL compile option UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 042 OF 054 because the sample program uses double quotes. One solution for this problem would be to recompile the sample program with a "Q"(double quotes) COBOL compile option. If you can NOT specify the "Q" compile option a your installation, then you should replace all double double quotes with single quotes in the following parts: APQPERF, APQSAMP, APQSTRL, and OF APQTRIM. 1. 93/06/14 Section of the Program Directory Referenced - 7.3.1 You must have the X0N2100C Times New Roman 240 or 300 pel Core Interchange Font installed. The Core Interchange Fonts do not come automatically with PSF 2.1.1 and must be ordered additionally at no additional cost. The FMIDs and feature numbers follow: PEL FMID PRODUCT # FEATURES 240 JPRF175 5695-040 6002 6008 6005 6011 (3480 cartridge) 6001 6007 6004 6010 (6250 BPI) 300 JPRF160 5695-040 6014 6017 (3480 cartridge) UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 043 OF 054 6013 6016 (6250 BPI) ************************************************************************ * SECTION 2. D O C U M E N T A T I O N C H A N G E S * ************************************************************************ THIS SECTION OUTLINES MAJOR ERRORS IN THE PRODUCT'S PUBLISHED DOCUMENTATION. 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 3. G E N E R A L I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS GENERAL INFORMATION, I.E. SYSGEN HINTS/TIPS. 4. 95/08/04 When installing apar pn73433 / un79772 message stating the UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 044 OF 054 APQEND and APQTERM have unresolved external references to APQXUNLD. The messages are fine and pose no problems. 3. 95/06/30 To verify that you have installed the AFP/API correctly, you must have Times New Roman Latin1 or equivalent installed via FLIP in order for the installation verification program (APQIVCOB for COBOL and APQIVPLI for PL/1) to generate an APQSAMP LISTAFP output file. The following fonts are required for the installation verification program: 1. The 10-point Roman Medium Times New Roman (240 PEL or 300 PEL) 2. The 12-point Roman Medium Times New Roman (240 PEL or 300 PEL) 3. The 12-point Roman Bold Times New Roman (240 PEL or 300 PEL) 4. The 12-point Italics Medium Times New Roman (240 PEL or 300 PEL) If your PSF/MVS, PSF/VM, or PSF/VSE product was shipped UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 045 OF 054 prior to May 1, 1995, and included the Latin1 complement of the optional IBM Core Interchange Fonts, you have the required fonts. After May 1, 1995, the Core Interchange Fonts are no longer available with the PSF products, and must be obtained through the new AFP Font Collection product (5648-113). IBM Software Announcements 294-691 and 294-692, dated November 1, 1994, provide details of these changes. 2. 94/02/08 II07600 (attached) - AFPAPI common problem info apar 1. 93/06/30 Applying the AFPAPI D-APAR * Increase the size and/or secondary extent allocation value prior to applying UN44746 (PN36146 - AFPAPI MVS D-APAR) * Apply UN44746 * Run APQBINDC job after installing UN44746 * Recompile all of your AFPAPI COBOL and PLI programs due to the copybook changes UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 046 OF 054 ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ 2 95/07/18 PROBLEM: (PN71721) ABEND0C4 IN APKQTMOD WHEN RUNNING FROM SYSTEM LINKLIST USERS AFFECTED: Eventually, every customer would be affected by not having this linkage editor fix. RECOMMENDATION: INSTALL UN78246 ON VOLID 9506 1 93/08/02 PROBLEM: (PN36146) ENHANCED FUNCTION USERS AFFECTED: ALL AFP API USERS RECOMMENDATION: INSTALL UN44746 ON VOLID F306 ************************************************************************ * SECTION 5. C R O S S P R O D U C T D E P E N D E N C I E S * ************************************************************************ UPGRADE: PSFMVS211 SUBSET: HQN2112 INTRODUCTORY TEXT PG 047 OF 054 THIS SECTION CONTAINS INFORMATION THAT IS DEPENDENT UPON ANOTHER PRODUCT OTHER THAN THIS SUBSET ID. 1. YY/MM/DD INTERDEPENDENT PRODUCT: PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX ************************************************************************ * I N F O R M A T I O N A L / D O C U M E N T A T I O N * * APARS FOLLOW (IF ANY) * ************************************************************************ UPGRADE: PSFMVS211 SUBSET: HQN2112 APAR PN36146 PG 048 OF 054 APAR NUMBER = PN36146 LAST UPDATE = 94/06/02 PTF IN ERROR = PIN = YES CURRENT APAR STATUS = CLOSED CLOSING CODE = UR1 ORIGINAL APAR NUMBER = SECURITY/INTEGRITY = NO SERVICE NUMBER = 0X66520 REPORTED COMPONENT = 564806202 R112 AFPAPI FIXED COMPONENT = 564806202 AFPAPI FAILING MODULE = APQBDOC PROBLEM ABSTRACT: ENHANCED FUNCTION AFPAPI REPORTED SCP RELEASE: 112 ERROR DESCRIPTION: enhanced function TEMPORARY FIX: PROBLEM SUMMARY: **************************************************************** * USERS AFFECTED: ALL AFP API USERS * **************************************************************** UPGRADE: PSFMVS211 SUBSET: HQN2112 APAR PN36146 PG 049 OF 054 * PROBLEM DESCRIPTION: Enhanced function * **************************************************************** * RECOMMENDATION: Apply the applicable PTF. * **************************************************************** PROBLEM CONCLUSION: MODULES/MACROS: APQBDOC APQBFLD APQBGRP APQBPAG APQBPAR APQBROW APQBTBL APQCARE APQCMUOT APQCOCOB APQCOPLI APQCREND APQDEFS APQDFLD APQDFNT APQDROW APQEARE APQEDOC APQEFLD APQEGRP APQEND APQEPAG APQEPAR APQEROW APQERROR APQESBEG APQESFLP APQESOBP APQESSCA APQETBL APQEXTRA APQFILES APQFRMT0 APQFRMT1 APQFRMT2 APQINDEX APQINIT APQINVM APQIOBJ APQIOVL APQIPSG APQLPDOT APQLPKIO APQLPLDT APQLPLIT APQLPPDT APQMEMRY APQPARE APQPBOX APQPCHS APQPERF APQPPRF APQPRINT APQPRUL APQPTAG APQPTXT APQPUTS APQPVAR APQQATT APQQPOS APQQUERY APQREQS APQROUTR APQSATTS APQSCLR APQSFNT APQSICS APQSLIB APQSOUT APQSPOS APQSRTH APQSUNI APQSWSP APQTERM APQTFAFP APQTFARM APQTFARP APQTFCPY APQTFLBS APQTFLNB APQTFOUT APQTFPGL APQTFSUB APQTFWGL APQTKINT APQTSBEG APQTSEND APQTSFLP APQTSOBP UPGRADE: PSFMVS211 SUBSET: HQN2112 APAR PN36146 PG 050 OF 054 APQTSSCA APQTSUOT APQVARS APQVERBS APQVMEND APQXARE DSMACTT DSMADDRT DSMAFPWA DSMBCS DSMCALL DSMCMDEF DSMCS DSMDEF DSMECOB DSMEICB DSMFIB DSMHHCC DSMLDT DSMMSG DSMPDB DSMPDT DSMPLDT DSMPLPC DSMPPDT DSMPSEG DSMSCO DSMSECT DSMSLDT DSMSMSV DSMSPDT DSMTSDEF DSMWDPT O1APQL2 SRLS: CIRCUMVENTION: APPLICABLE COMPONENT LEVEL/SU: ENV=HQN2112 PS=Y PTF=UN44746 CLOSED AVAIL=NO VOLID=F306 ENV=113 PS=Y PTF=UN44747 CLOSED AVAIL=NO VOLID=9401 UPGRADE: PSFMVS211 SUBSET: JPRF114 INTRODUCTORY TEXT PG 051 OF 054 *********************** * SUBSET JPRF114 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR PAGE PRINTER MIGRATION PROG VERSION 2, RELEASE 1, MODIFICATION 0. ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. YY/MM/DD INSTALLATION INFORMATION NO ENTRIES 2. YY/MM/DD DOCUMENTATION CHANGES NO ENTRIES 3. YY/MM/DD GENERAL INFORMATION NO ENTRIES 4. YY/MM/DD SERVICE RECOMMENDATIONS NO ENTRIES 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES UPGRADE: PSFMVS211 SUBSET: JPRF114 INTRODUCTORY TEXT PG 052 OF 054 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 1. YY/MM/DD XXXXXXX XXXXXXX XXXX XXX ************************************************************************ * SECTION 1. I N S T A L L A T I O N I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS CHANGES TO THE PRODUCT'S PROGRAM DIRECTORY. 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 2. D O C U M E N T A T I O N C H A N G E S * ************************************************************************ THIS SECTION OUTLINES MAJOR ERRORS IN THE PRODUCT'S PUBLISHED UPGRADE: PSFMVS211 SUBSET: JPRF114 INTRODUCTORY TEXT PG 053 OF 054 DOCUMENTATION. 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 3. G E N E R A L I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS GENERAL INFORMATION, I.E. SYSGEN HINTS/TIPS. 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ 1. YY/MM/DD PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX UPGRADE: PSFMVS211 SUBSET: JPRF114 INTRODUCTORY TEXT PG 054 OF 054 ************************************************************************ * SECTION 5. C R O S S P R O D U C T D E P E N D E N C I E S * ************************************************************************ THIS SECTION CONTAINS INFORMATION THAT IS DEPENDENT UPON ANOTHER PRODUCT OTHER THAN THIS SUBSET ID. 1. YY/MM/DD INTERDEPENDENT PRODUCT: PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX ************************************************************************ * I N F O R M A T I O N A L / D O C U M E N T A T I O N * * APARS FOLLOW (IF ANY) * ************************************************************************