UPGRADE: APA103 INTRODUCTORY TEXT PG 001 OF 021 ****************** * UPGRADE APA103 * ****************** THIS UPGRADE CONTAINS INSTALLATION INFORMATION AND/OR HIGH IMPACT/PERVASIVE APAR INFORMATION FOR VERSION 1, RELEASE 1, MODIFICATION 1 OF THE APA PRODUCT SET. ************************************************************************ * P R O D U C T I N D E X * ************************************************************************ ISD NUMBER SYSTEM DESCRIPTION SUBSET ID 5665307 MVS PRINT MANAGEMENT FACILITY HAU1103 5665340 MVS PRINT SERVICES ACCESS FACILITY HPV1103 5665351 MVS PAGE PRINTER FORMATTING AID/MVS HFF1102 UPGRADE: APA103 ADDITIONAL TEXT PG 002 OF 021 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: APA103 ADDITIONAL TEXT PG 003 OF 021 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: APA103 ADDITIONAL TEXT PG 004 OF 021 UPGRADE: APA103 ADDITIONAL TEXT PG 005 OF 021 UPGRADE: APA103 ADDITIONAL TEXT PG 006 OF 021 UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 007 OF 021 ******************* * SUBSET HAU1103 * ******************* THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR THE PRINT MANAGEMENT FACILITY PRODUCT OF AFP FOR MVS, V1,R1,M1. ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST SECTION CHANGED 1. 86/12/05 INSTALLATION INFORMATION 2. 90/06/21 DOCUMENTATION CHANGES 3. 89/06/13 GENERAL INFORMATION 4. 89/05/19 SERVICE RECOMMENDATIONS 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 008 OF 021 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 5. 89/05/19 OY22635 UY38295 8905 MISSING A ++HOLD(ACTION) 4. 88/08/06 OY13764 UY20749 8805 BAD SYSLIB 3. 88/08/06 OY12274 UY20749 8805 NEW FUNCTION - AFP1 SUPPORT 2. 87/04/04 OY05913 UY07959 8705 SERVICE INFORMATION HIPER 1. 87/02/09 OZ95692 UY90022 8702 KANJI DATA INFO ADDED ************************************************************************ * 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 * ************************************************************************ 6. 86/12/05 MORE PROGRAM DIRECTORY ERRATA: IN THE SECTION 'ALLOCATE NEW DATA SETS', SOME OF THE PRIMARY ALLOCATION AND DIRECTORY BLOCK VALUES HAVE BEEN FOUND TO BE INADEQUATE BY CERTAIN CUSTOMERS. HERE ARE SOME RECOMMENDED VALUES: UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 009 OF 021 DATA SET NAME PRIMARY ALLOCATION ------------- ------------------ 1. VSAPL.ADZJMAC0 184 2. VSAPL.ADZJFLIB 2 3. VSAPL.ADZJPLIB 13 4. VSAPL.DZJDMY1 327 5. VSAPL.DZJPTF 24 NOTE: THIS VALUE WILL DEPEND ON THE AMOUNT OF MAINTENANCE YOU HAVE APPLIED TO PMF. 5. 86/11/24 PRIOR TO THE INSTALLATION OF PMF THE CUSTOMER SHOULD VERIFY THE PROPER WORKING ORDER OF APL AND GDDM. THIS CAN BE DONE BY RUNNING TSOIVP AND GRAPHPAK DEMO PROGRAMS LOCATED IN APLLIB2. IF EITHER OF THESE PROGRAMS FAIL TO COMPLETE SUCCESSFULLY (NON-ZERO RETURN CODES) PLEASE CONTACT THE PROPER SUPPORT GROUP FOR ASSISTANCE. THESE PROGRAMS MAY BE INVOKED IN APL AS FOLLOWS: 1. )LOAD 2 TSOIVP (ENTER) 2. IVP (ENTER) 3. YES (ENTER) WATCH FOR A 00 RETURN CODE FOR AUX PROCESSOR AP126. UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 010 OF 021 2. )LOAD 2 GRAPHPAK (ENTER) 2. DEMO (ENTER) WATCH FOR A 00 RETURN CODE. IF EITHER THE TSOIVP (AP126) OR GRAPHPAK FAIL TO COMPLETE SUCCESSFULLY PMF WILL NOT BE ABLE TO BE INVOKED PROPERLY AFTER THE INSTALLATION OF THE PRODUCT. 4. 86/10/14 IF THE USER DECIDES TO UTILIZE OTHER THEN THE APL DEFAULT EXECLIB NAMES, THESE NAMES MUST ALSO BE SPECIFIED IN DZJLIBS AND DZJLIBD IN ORDER TO INVOKE PMF. 3. 86/05/20 D/T3800 D/T3820 PMF REL 1.0 AND 1.1 SEVERE DATASET DAMAGE CAN OCCUR IF THE NOPROMPT PARAMETER IS CHANGED TO PROMPT IN THE PMFD CLIST AND PMF CLIST. REFERENCE APAR OZ96963. 2. 85/10/23 D/T3800 D/T3820 WORKSPACE FORMATTING UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 011 OF 021 IN THE PROGRAM DIRECTORY UNDER THE SECTION TITLED 'PRINT MANAGEMENT FACILITY SPECIFIC TASKS AFTER LOADING DLIBS', THERE IS A SPECIFICATION ERROR IN THE JCL THAT CALLS APLJAWS TO FORMAT WORKSPACES FOR APL2. UNDER THE COMMENT: //* CALL APLJAWS TO FORMAT WORKSPACES (APL2) *, THERE ARE 2 EXEC STATEMENTS. BOTH EXEC STATEMENTS SHOULD CALL OUT APL2JAWS TO FORMAT THE WORKSPACES, BUT THE SECOND ONE MAY CALL OUT APL1JAWS. THIS SHOULD BE CHANGED TO APL2JAWS. 1. 85/06/06 D/T3800 D/T3820 PROGRAM DIRECTORY ERRATA; A. PAGE 9: THE DIRECTORY BLOCKS REQUIRED FOR ADZJPLIB SHOULD BE 6, NOT 4 AS GIVEN IN THE PROGRAM DIRECTORY. B. PAGE 9: THE DIRECTORY BLOCKS REQUIRED FOR DZJDMY1 SHOULD BE 25, NOT 22 AS GIVEN IN THE PROGRAM DIRECTORY. C. PAGE 10: THE PROGRAM DIRECTORY INCORRECTLY STATES THAT UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 012 OF 021 DZJPTF IS A REQUIRED DDNAME FOR THE ACCEPT STEP. IN FACT, DZJPTF IS A REQUIRED DDNAME FOR THE APPLY STEP AND IS NOT NECESSARY DURING RECEIVE OR ACCEPT PROCESSING ************************************************************************ * 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 ERRORS IN THE PRODUCTS PUBLISHED DOCUMENTATION. 4. 90/06/21 PLEASE READ ATTACHED DOC APAR OY23011 FOR LIBRARY REFORMAT OPTION. 3. 90/06/21 PLEASE READ ATTACHED DOC APAR OY22457 IN REGARD TO MSGAPS554I - ISSUED FOR EVERY DATA SET PROCESSED INDICATING AN OVERLAY WAS SPECIFIED WHEN ONE HAD ALREADY BEEN LOADED. 2. 89/06/13 AS OF THIS DATE, THE LATEST VERSION OF THE PMF USER'S GUIDE UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 013 OF 021 AND FACILITY IS SH35-0059-03. PLEASE ENSURE THAT YOUR USERS ARE PROVIDED A COPY OF THIS MANUAL. THIS MANUAL PROVIDES INFORMATION REGARDING SUPPORT FOR AFP1 PRINTERS AND CHANGES IN SEVERAL PANELS. 1. 88/08/06 ADDED DOCUMENTATION APARS TO THE 'APAR INCLUDE' LIST ************************************************************************ * 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. 11. 89/06/13 SEE ATTACHED DOC APAR OY06158 FOR INSTALLATION PROCEDURES WITH SMP/E. 10. 89/06/13 MANY CUSTOMERS HAVE PROBLEMS INSTALLING PMF BECAUSE THEY HAVE CHOSEN TO BYPASS THE ++HOLD FOR UY20749. BECAUSE OF THIS, THE PTF HAS BEEN PE'D BY UY38295. PLEASE READ THE UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 014 OF 021 COVER LETTER THOROUGHLY AND FOLLOW THE INSTRUCTIONS. THERE ARE NEW JOBS SUPPLIED WITH THE PTF THAT MUST BE RUN IN ORDER TO ACTUALLY INSTALL MAINTENANCE. IF THESE JOBS 'NO RUN', USERS WILL BE RUNNING WITH BASE CODE. SEE ATTACHED INFO APAR II02003 FOR ASSISTANCE IN DETERMINING IF THE INSTALL WAS CORRECT. VS/APL2 RELEASE 2 USERS WILL NO LONGER BE SUPPORTED AFTER APPLICATION OF PTF UY90223 OR HIGHER. 9. 89/06/13 NEW FUNCTION (OY12297) - PROVIDES SOURCE CODE FOR PAGEDEFS AND FORMDEFS. INSTALL PTF UY90224 ON VOLID 8804 8. 88/10/03 PMF AND PSF CUSTOMERS INSTALLING NEW FONT FEATURE TAPE PLEASE BE AWARE, ONE OF THE FONT ENVIRONMENTS USES SMP TO INSTALL. THUS, THE CUSTOMER WOULD HAVE TO DELETE ALL PRIOR JUA1113 INFORMATION TO RE-INSTALL THE FEATURE. PSF DOES NOT USE SMP SO IT WILL USE THE OLD FMID. UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 015 OF 021 7. 88/08/17 ALL PMF USERS PLEASE REVIEW ATTACHED APARS OY14146, OY15022 OY05682, OY06158, OY07535. 6. 87/02/09 KANJI DATA STANDARD PAGEDEFS SUPPLIED BY PSF 1.1 ARE SHIPPED WITH A DATA LENGTH OF 248 BYTES. TO PREVENT TRUNCATION OF KANJI DATA: CHANGE THE DATA LENGTH FIELD (BYTES 31 & 32) OF THE LND STRUCTURED FIELD REBUILD PAGEDEFS 5. 86/09/12 DATA INTEGRITY ALL THE AFP UTILITY PRODUCTS INCLUDING PMF DO NOT DO AN ENQUEUE OR ENQUEUE/RESERVED WHEN WRITING TO THE RESOURCE DATA SETS. THIS CAUSES AN EXPOSURE WHERE MULTIPLE CPU'S OR MULTIPLE JOBS UNDER ONE CPU COULD WRITE TO THE SAME DATA SET AT THE SAME TIME. AS OF YET THERE HAVE NOT BEEN ANY PROBLEMS REPORTED WITH ANY OF THE AFP UTILITY PRODUCTS CONCERNING THE EXPOSURE UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 016 OF 021 MENTIONED ABOVE. THIS ENTRY IS JUST TO DOCUMENT THE EXPOSURE. REFERENCE APAR OY00592 FOR FURTHER INFORMATION. 4. 86/05/22 RESOURCES,SUCH AS FONTS,OVERLAYS,SEGMENTS,FORMDEFS,AND PAGEDEFS,SHIPPED WITH APF PRODUCTS,ARE SUPPORTED BY BOULDER DEVELOPMENT, NOT PROGRAMMING SERVICE. IF YOU HAVE PROBLEMS WITH THESE RESOURCES, YOUR SE CAN INTERFACE WITH DEVELOPMENT. 3. 86/02/21 PLEASE READ ATTACHED INFO APAR II02003 REFERENCING PMF COMMON PROBLEM. 2. 85/09/11 RESOURCE COMPATIBILITY RESOURCES BUILT WITH PMF ARE UPWARD COMPATIBLE, BUT 'MAY' NOT BE DOWNWARD COMPATIBLE WITH PSF. EXAMPLE:FORMDEFS BUILT WITH PMF RELEASE 1.1 CANNOT BE USED BY PSF RELEASE 1.0, BUT 1.0 FORMDEFS CAN BE USED BY PSF 1.1. UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 017 OF 021 1. 85/04/04 D/T3800 D/T3820 THE FOLLOWING ARE THE PRODUCTS THAT ARE REQUIRED BY PRINT MANAGEMENT FACILITY. PSP PRODUCT UPGRADE FMID ----------- ---------- ------- VS/APL REL4 APL040 GDDM REL2 OR GDDM REL3 GDDM130 HGD1300 ******************************************************* NOTE: IF USING GDDM REL3 AND 3274'S, MAKE SURE THAT THE 3274 MICROCODE IS AT REL47 OR HIGHER. ******************************************************* TSO COMMAND UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 018 OF 021 PACKAGE (NONE) JBB1113 (MVS/370) OR TSO/E (NONE) JBB2115 (MVS/XA) ************************************************************************ * SECTION 4: S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ *NOTE* THE RECOMMENDED SERVICE FOR PRINT MANAGEMENT FACILITY IS TAPE 8401 OR ABOVE.. 5. 89/05/19 PROBLEM: (OY22635) PMF PTF UY20749 AND PTF UY90223 DO NOT CONTAIN A ++HOLD(ACTION). USERS AFFECTED: ALL PMF/MVS USERS RECOMMENDATION: INSTALL UY38295 ON VOLID 8905 4. 88/08/06 PROBLEM: BAD SYSLIB POINTERS IN THE ++MAC STATEMENTS USERS AFFECTED: PMF REL 1.1 AND PSF 1.2. AFP1 USERS RECOMMENDATION: INSTALL UY20749 ON VOLID 8805 UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 019 OF 021 *** DO NOT INSTALL UY90223 F804 *** 3. 88/08/06 PROBLEM: NEW FUNCTION TO SUPPORT AFP1 PRINTERS USERS AFFECTED: PMF 1.1 AND PSF 1.2. WITH AFP1 PRINTERS RECOMMENDATION: INSTALL UY20749 VOL 8805 AND READ ATTACHED APAR OY12274 REGARDING APL REQUIREMENTS 2. 87/04/02 PROBLEM: INITIALIZATION TIME OF PMF IS SIGNIFICANTLY INCREASED AFTER PTF UY01002 IS APPLIED.(OY05913) USERS AFFECTED: PMF 1.1 USERS EXPERIENCING LONG INITIALIZATION TIME. RECOMMENDATION: INSTALL UY07959 ON VOLID 8705 1. 87/02/09 PROBLEM: KANJI DATA IS TRUNCATED RO GARBLED WHEN USING SHIFT-IN AND SHIF-OUT FUNCTION OF D/T3800-8 WHEN PRMODE=SOSI2 WAS SPECIFIED. USERS AFFECTED: ALL PSF USERS USING PRMODE SOSI1 / SOSI2 RECOMMENDATION: INSTALL UY90022 ON VOLID 8605. UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 020 OF 021 ************************************************************************ * 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 * ************************************************************************ 1. YY/MM/DD PROBLEM: NO ENTRIES USERS AFFECTED: RECOMMENDATION: UPGRADE: APA103 SUBSET: HAU1103 INTRODUCTORY TEXT PG 021 OF 021 ************************************************************************ * 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) * ************************************************************************