UPGRADE: PSFVM211 INTRODUCTORY TEXT PG 001 OF 073 ************************ * UPGRADE PSFVM211 * ************************ THIS UPGRADE CONTAINS INSTALLATION INFORMATION AND/OR HIGH IMPACT/PERVASIVE APAR INFORMATION FOR VERSION 2, RELEASE 1, MODIFICATION 1 FOR PSF 2.1.1 FOR VM. ************************************************************************ * P R O D U C T I N D E X ************************************************************************ PID NUMBER SYSTEM DESCRIPTION SUBSET ID 5684141 VM BASE PRODUCT VM/211 5684141 VM ACIF FEATURE VM/111 5684141 VM API FEATURE VM/113 UPGRADE: PSFVM211 ADDITIONAL TEXT PG 002 OF 073 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:" A brief description of the APAR "USERS AFFECTED:" If you have this product/device/situation, you are exposed to the problem. "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: PSFVM211 ADDITIONAL TEXT PG 003 OF 073 VOLID 9XXX - Reflects a PUT tape that the PTF can be located on. CLARIFICATION OF SUP LEVELS A sup level for a subset is represented by a subset name, a slash, and a put level number. (ex: Subset/9104) Please note that a sup level does not represent a put level. It is not labeled as a put because in reality it is a put level + 2 Levels higher of 'reach ahead' service. ** BEWARE ** Do not apply a put tape on top of a SUP tape unless the PUT level is 3 levels higher. Applying a put tape that is not 3 levels higher could cause regression. UPGRADE: PSFVM211 ADDITIONAL TEXT PG 004 OF 073 UPGRADE: PSFVM211 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 005 OF 073 *********************** * 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 28 99/08/10 VM/113 SECTION 4, ADDED ITEM 3 PQ26568 UQ29769 27. 99/05/06 VM/211 SECTION 3, ADDED ITEM 40 26. 99/04/23 VM/211 SECTION 3, ADDED ITEM 39 25. 98/11/13 VM/211 SECTION 3, ADDED ITEM 38 24. 98/08/27 VM/211 SECTION 3, ADDED ITEM 37 23. 98/08/21 VM/211 SECTION 3, UPDATED ITEM 12 UPGRADE: PSFVM211 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 006 OF 073 22. 98/05/18 VM/211 SECTION 3, ADDED ITEM 36 21. 98/03/26 VM/211 SECTION 3, ADDED ITEM 34 35 21. 98/01/20 VM/211 SECTION 3, ADDED ITEM 33 20. 96/07/19 VM/211 SECTION 3, ADDED ITEM 32 19. 96/04/18 VM/211 SECTION 3, ADDED ITEM 31 9. 95/01/27 VM/211 SECTION 1, ADDED ITEM 2 8. 94/07/19 VM/211 SECTION 3, ADDED ITEM 30 7. 94/03/01 VM/211 SECTION 3, UPDATED ITEM 17. 6. 94/02/08 VM/113 SECTION 3, ADDED ITEM 2 5. 93/12/09 VM/211 SECTION 3, ADDED ITEM 29 4. 93/12/07 VM/211 SUBSET REPLACED 3 93/10/19 VM/113 SECTION 4, ADDED ITEM 2 PN45235 UN49243 2. 93/08/03 VM/113 SECTION 3, ADDED ITEM 1 VM/113 SECTION 4, ADDED ITEM 1 1. 93/07/21 UPGRADE/SUBSETS CREATED - SMRG UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 007 OF 073 *********************** * SUBSET VM/211 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR BASE PRODUCT VERSION 2, RELEASE 1, MODIFICATION 1. ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. 95/01/27 INSTALLATION INFORMATION 2. 98/03/22 DOCUMENTATION CHANGES 3. 99/05/06 GENERAL INFORMATION 4. 93/08/10 SERVICE RECOMMENDATIONS 5. 92/09/18 CROSS PRODUCT DEPENDENCIES UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 008 OF 073 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 14. 93/08/10 PN43123 UN47233 9401 PTFSERVA PTFSERVL PTFSERVV 13. 93/08/10 PN43123 UN47232 9401 PTFSERVA PTFSERVL PTFSERVV 12. 93/08/10 PN43123 UN47231 9401 PTFSERVA PTFSERVL PTFSERVV 11. 93/08/10 PN43123 UN47230 9401 PTFSERVA PTFSERVL PTFSERVV 10. 93/08/10 PN43123 UN47229 9401 PTFSERVA PTFSERVL PTFSERVV 9. 93/08/10 PN43123 UN47228 9401 PTFSERVA PTFSERVL PTFSERVV 8. 93/08/06 PN38057 UN44283 9401 ADD SUPPORT FOR ACIF AND AFP 7. 93/08/06 PN38057 UN44282 9401 ADD SUPPORT FOR ACIF AND AFP 6. 93/08/06 PN38057 UN44281 9401 ADD SUPPORT FOR ACIF AND AFP 5. 93/08/06 PN38057 UN44280 9401 ADD SUPPORT FOR ACIF AND AFP 4. 93/08/06 PN38057 UN44279 9401 ADD SUPPORT FOR ACIF AND AFP 3. 93/08/06 PN38057 UN44278 9305 ADD SUPPORT FOR ACIF AND AFP 2. 92/03/16 PN08536 UN09958 9201 SFCM PERIODICALLY NEEDS AUDIT 1. 91/11/26 PL83703 UL97732 9105 PRINTING A GERMAN CHARACTER UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 009 OF 073 ************************************************************************ * 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. 2. 95/01/27 See apar PN18912 (attached) for information when loading fonts. 1. 91/09/25 PAGE 19, SECTION 5.1.2 TARGET SYSTEM REQUIREMENTS OF THE PSF/VM PROGRAM DIRECTORY (G544-3683-00) SHOULD BE UPDATED TO READ: "IBM 3828 REQUIRES EC C06145 (OR HIGHER)" "IBM 3900 REQUIRES EC C14194 (OR HIGHER)" ************************************************************************ * SECTION 2. D O C U M E N T A T I O N C H A N G E S * ************************************************************************ UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 010 OF 073 THIS SECTION OUTLINES MAJOR ERRORS IN THE PRODUCT'S PUBLISHED DOCUMENTATION. 5. 99/03/22 'After applying PQ18523 if you are running the SFCM in a DCSS it will abend and loop doing an IPL. The DCSS is no longer large enough. You must define the DCSS size to be 800-8D0. See doc apar PQ25028 for more info.' 4. 93/01/08 Installing D/T4028 IVP, no print out, no error message, V5684141 PSF/VM SYSTEM PROGRAMMING GUIDE S5443680-00 chapter 5 page 189 fig.34 See DOC APAR PN05808 (attached) 3. 92/08/17 GRP3 DCSS overflowed after applying maintenance. Received MSDMSITP141T - operation exception occurred at x'000006' in routine APRINIT, and MSAPRABN559T - system abend code x'0C1.' The PSF/VM Program Directory is in error. See DOC APAR PN26757 (attached). UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 011 OF 073 2. 92/08/03 S544-3680-00 PSF/VM System Programming Guide page 221. All PSF/VM 2.1.0 customers who create their own SFCM installation exits. See APAR PN25215 (attached) for more information. 1. 92/04/06 The PSF/VM 2.1.0 Program Directory (G544-3683-00) has a error on pages 68-69. The Group3 PDM DCSS (APRGP34D) does NOT need to be identified to GCS using the SEGMENT macro. Therefore the bottom 2/3 of section 10.4 that begins with the sentence " If you are defining shared segments for Group3 printers...." should be deleted. While no malfunctions will occur as a result of following these directions, storage will become unavailable to every member of the GCS group, unnecessarily. This is usually not serious, but if a Group4 PDM is in the same group, it will not be able to support as many printers as it should. ************************************************************************ * SECTION 3. G E N E R A L I N F O R M A T I O N * UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 012 OF 073 ************************************************************************ THIS SECTION CONTAINS GENERAL INFORMATION, I.E. SYSGEN HINTS/TIPS. 40. Prior to applying service, delete any jobs that have been converted but not yet printed. Also delete any START files. After applying service resubmit the jobs. Use the folowing command to see what jobs have been converted for a particular printer or GRP4 printer task: CP QUERY PRINTER PSF DEST (prtid) Print jobs on the spool in converted status have been thru the SFCM conversion process but have not yet printed. The PDM and SFCM machines share data structures. If you do not delete converted jobs prior to applying maintenance, the data structures can be mismatched and when you print those jobs you could have a variety of problems: logic errors, abends, hangs, bad output, etc. 39.99/04/23 "PN78572 added support for resident DBCS raster fonts. UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 013 OF 073 However, PSF/VM does not support referencing a double byte character set resident font by it's registered font ID (GRID). You can only reference it by it's coded font name." 38.98/11/13 The 4230, 4247, 64XX and 4224 printers have been enhanced to support the European currency symbol, the Euro. The Euro character has been added to the resident character sets and codepages have been added which contain the Euro codepoint. PSF/VM supports the 4224 natively. PSF/VM supports the 4230 running in 4224 emulation mode only. PSF/VM supports the 4247 & 64XX printers running in 4234 emulation mode only. PSF/VM module APRFTBLB (Group 4) contains tables of character sets and codepages resident in the 4224 and 4234 type printers. UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 014 OF 073 PSF/VM APAR PQ21057 adds the new codepages to the resident font resource tables in APRFTBLB. If you have customized the APRFTBLB source code shipped with PSF/VM and have printers with the new resident codepages, you will either have to add the new codepages to your version of APRFTBLB or add your modifications to the version of APRFTBLB shipped with PQ21057. See the PSF/VM Systems Programmer's Guide Chapter 8 for more information on modifying, assembling and linkediting APRFTBLB into your Group 4 PDM. 37. 98/08/27 YR2000 changes affect separator page exits. Apars PN83888 and PN86626 modified the APRSEPEC module, the SFCM separator pages exit routine, to accomodate 4 digit years for YR2000 compatibil Fields SPFCDATE and PDMPDATE were cahnged from cl8 to cl10. Thi change was not documented in the apars. Customers using this ex may have to modify their code to accomodate the change. This wi also be documented UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 015 OF 073 in doc apar PQ18828. 36. 98/05/18 When printing to a D/T64xx emulating a D/T4234 you can print a font at 13 CPI but only the fonts listed in table APRFTBLV in the Systems Programming Guide. X0gt13 is not listed, x0d224 is. 35. 98/03/26 Message APRCCM742E the program that created the printfile or pagedef generated invalid data- unsuccessful skip to channel '12'. The input file contained TRC characters and had an invalid skip to channel 8, not 12. The ANZI channel codes are converted to MACHine channel codes on the VM spool. PSF cannot determine whether the codes were originally ANZI or MACH in all cases, so it treats them all as ANZI. The code for channel 8 (x'f8') is converted to x'c3'. This can be the MACH code for channel 8 or the ANZI code for channel 12. See the PSF/VM APPLICATION PROGRAMMING GUIDE chapter 5 table 4 for more information. UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 016 OF 073 34. 98/03/26 Message APRABN559T PDM ABEND-SYSTEM ABEND X'01000' or X'02000'. This is not really a system abend but rather a user abend generated by the PDM due to the fact that it can't communicate with the printer. See the preceeding messages, E.G. APRIIO694S device not available, or APRERC696S permanent I/O error on device nnn. These are th key to the problem. 33. 98/01/20 APAR PQ03048 (Cut Sheet Emulation) changes the behaviour after message APRCCM753E. Prior to this apar, if the printfile called for a copygroup (medium map) that was not in the formdef, PSF/VM would issue message APRCCM753E and processing would continue using the first copygroup in the formdef. With PQ03048, APRCCM753e is issued and processing stops. 32. 96/07/19 After installing UN87705 (for APAR PN78572), the APRSFCM4 SHARED SEGMENT is larger than the DEFSEG command documented in APAR PN73119. The new DEFSEG command should be: DEFSEG UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 017 OF 073 APRSFCM4 800-8D0 SR (Additional symptoms: LOOP ABEND0C1 IPL CMS) 31. 96/04/18 The Application Programming Guide, page 160, specifies your virtual printer must be defined as a 3800 if you are using Table Reference Characters (TRC). This is true if you only have TRCs 0, 1, 2, or 3. A virtual 3800 will only honor TRCs 0, 1, 2 or 3. CP converts these to select translate table commands, of which there are only the four. If a customer has more than 4 TRCs, then they will need to use a non-3800 virtual printer such as a 1403 or VAFP. If the record length is greater than 133, they will need VAFP. Then, using the PSF command, you can specify CC TRC an they will be honored. An alternative which should also work is to run the job with the LINK option on the PSF command. 30. 94/07/19 CMS 10, VMESA 2.1 appears to have substantially increased the amount of virtual storage used by CMS. As an example, virtual storage had to be increased to 6 meg in order to UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 018 OF 073 initialize a Group3 PDM. This may vary for each service machine. One of the symptoms is that the service machine will not complete initialization. 29. 93/12/09 RC=104 from the LOAD command when attempting to build the DCSS for APRPSFC4 installing PSF 2.1.1 with VM/ESA 1.2.1. The failure is due to CMSPIPES segment loaded at 700-75F. The problem can be resolved before installing by doing a "SEGMENT RELEASE CMSPIPES." 28. 93/09/02 Section of the PSF/VM 2.1.1 Installation PSP Bucket, U: PSFVM211 S: VM/211: PSF/VM 2.1.1 is NOT a seperate service stream (rollup of of product with service) from PSF/VM 2.1.0. They are the same service stream, and both use RETAIN release R210. The RETAIN release R211 for Component ID 568414101 was assigned to Resources with the base release of PSF/VM 2.1.0. The resources are the Page Definitions and Form Definitions supplied with PSF. UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 019 OF 073 PSF/VM 2.1.1 differs from PSF/VM 2.1.0 by including two new features, ACIF and AFP API (Component IDs 564806201 and 564806202). 27. 93/02/26 ON VM/SP5 and VM/SP6 systems, if the PSF command DCSS APRPSFC4 is defined in DMKSNT, but the segment isn't actually built, an error will occur upon execution of the PSF command because control will go to the defined location whether the code is loaded in the segment or not. If a PSF command DCSS is no longer desired, DMKSNT must be rebuilt removing the segment name to allow the PSF command to function correctly as a loadlib. 26. 92/10/08 4028 hang condition. If a hang is experienced with a D/T4028, have the CE open a hardware incident with the L2 hardware group and request the "BOULDER PATCH". One of the symptoms is that the job light is ON , yet no output. 25. 92/09/04 Microcode requirements for the control units listed below UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 020 OF 073 are as follows: A. IBM 3174 Establishment Controller with Configuration Support A require Release 5.2 with P6948 (or higher). Configuration Support B requires Release 2.0 with P6612 (or higher). B. IBM 3274 Control Unit Model 41A and 61C, with Configuration Support D, requires Release 65.1 (or higher). 24. 92/08/25 MSCSIGLB024E RPIGCS LOADLIB not found. This GCS error message is normal when RACF is not installed. 23. 92/07/27 II05202 (attached) is an information apar that discuss potential segment problems when defining a GCS SPACE. 22. 92/04/06 RC104 when building the DCSS for APRSFCM4 installing PSF 2.1.0. with VM/ESA. The failure is due to CMSVMLIB segmen being loaded at 8meg. The problem can be resolved before installing PSF by doing a 'SEGMENT RELEASE CMSVMLIB' or by UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 021 OF 073 coding 'SEGMENT RELEASE CMSLIB' into the I5684141 exec. 21. 92/03/03 PROCEDURE TO GO FROM NUCLEUS EXTENTION TO DCSS AFTER THE PRODUCT HAS BEEN INSTALLED: FIRST, PROPER VM DCSS DEFINITIONS MUST BE MADE AS AS DESCRIBED IN THE PSF/VM PROGRAM DIRECTORY. ALSO SEE WSC FLASH 9120 WHICH DESCRIBES SEGMENT PACKING FOR PSF/VM 2.1.0 INSTALL. THEN: 1) CREATE A BLANK MINIDISK 2) FROM PSFMAINT, INVOLK THE CORRECTIVE SERVICE EXEC FOR THE PSF COMPONENT TO BE CHANGED 3) FOLLOW THE STEPS OF THE EXEC UNTIL IT ASKS FOR THE ADDRESS OF THE DISK THAT CONTAINS THE PTF FIXES. 4) ENTER THE ADDRESS OF THE BLANK MINIDISK 5) LATER IN THE EXEC, IT ASKS IF THE COMPONENT IS TO BE GENERATED AS A DCSS. RESPOND 'YES'. 20. 92/02/17 IF A PROBLEM IS EXPERIENCED WHILE RUNNING THE PSF/VM 2.1.0 INSTALLATION EXEC 'I5684141 EXEC', GO TO THE TRACECMD: UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 022 OF 073 PROCEDURE AROUND LINE NUMBER 5910 AND REMOVE THE 'RETURN;' STATEMENT AFTER 'TRACECMD:'. THAT WILL ALLOW THE DEBUGGING PROCEDURE TO TRACE COMMANDS AS THEY ARE EXECUTED DURING THE BUILD PROCESS. THE INSTALLATION EXEC WILL STILL FUNCTION. HOWEVER, WHILE IT IS DOING WORK ALL THE COMMANDS THAT ARE ACTUALLY EXECUTED WILL BE DISPLAYED. THIS WILL HELP DIAGNOSE INSTALLATION PROBLEMS. THE SAME TRICK CAN BE USED WHEN APPLYING PUT SERVICE OR CORRECTIVE SERVICE USING THE PSF/VM SERVICE EXECS. FIRST, YOU MAY CHOOSE TO SAVE A COPY OF THE SERVICE EXEC BEFORE IT IS MODIFIED. THEN, TO FIND THE LOCATION OF THE 'RETURN;' STATEMENT TO DELETE, SEARCH FOR THE PROCEDURE NAME: 'TRACECMD:'. YOU SHOULD FIND A LINE WITH COMMENTS THAT LOOKS LIKE THIS: 'RETURN; /* REMOVE THIS RETURN IF COMMANDS ARE TO BE PRINTED */' DELETING THAT SINGLE LINE OF CODE WILL CAUSE THE TRACECMD: PROCEDURE CODE TO EXECUTE, PROVIDING A VISIBLE TRACE OF COMMANDS EXECUTED. 19. 92/01/31 BEFORE SELECTING IDENTIFIER 'F' (FONTS) FROM I5684141 MENU, ENSURE THE FONTS PRODUCT TAPE IS LOADED AND THE FIRST TWO UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 023 OF 073 FILES ARE LOADED FROM THE FONTS TAPE WHICH WILL CORRECTLY POSITION THE TAPE. 18. 92/01/31 AFTER THE I5684141 EXEC AND MEMO HAVE BEEN LOADED FROM THE INSTALL TAPE ONCE, YOU MUST ENSURE THAT THE TAPE IS POSITIONED AT TAPE FILE 3 BEFORE INVOKING THE I5684141 EXEC AGAIN TO INSTALL ADDITIONAL FEATURES. 17. 92/01/23 IF A D/T3820 OR D/T3812 PDM TERMINATES WITH MSCSIABD230E "COMMAND EXEC FAILED" ABEND0C2, THE PDM ID IS NOT AUTHORIZED TO GCS. THE ABEND0C2 SIGNIFIES THE PDM IS INSTALLED AS A SHARED SEGMENT. IF THE D/T3820 OR D/T3812 TERMINATES WITH MSAPRABN559T PDM ABEND- SYSTEM COMPLETION CODE X'B0A', MSCSIABC230E "COMMAND EXEC FAILED" SYSTEM ABEND B0A-0000, THE PDM ID IS NOT AUTHORIZED TO GCS. THE B0A ABEND MEANS THE PDM IS INSTALLED AS A MODULE. THE GCS GROUP EXEC AND ASSOCIATED PROCEDURES NEED TO BE RUN UNTIL AUTHORIZATION IS SUCCESSFUL AND A CHECK SHOULD BE DONE TO ENSURE AUTHEXIT = YES ON AN APPL STATEMENT WHICH DEFINES UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 024 OF 073 SOME OF THE COMMUNICATIONS CAPABILITIES OF THE APPLICATION PROGRAM. After making these changes, GCS must be regen'd. 16. 91/11/26 THE SAMPLE VM DIRECTORY ENTRIES IN THE PROGRAM DIRECTORY INCLUDE OPTION PARAMETERS OF BMX AND ECMODE. THESE TWO PARAMETERS ARE NOT VALID FOR THE VM/XA OR VM/ESA (WITH THE ESA FEATURE) ENVIRONMENT. DIRMAINT WILL ISSUE A MESSAGE STATING THAT THEY ARE INVALID PARMS FOR THE OPTION STATEMENT. THE MIXED OPTION OF THE DIRECTXA COMMAND WILL IGNORE MOST VM/SP OR VM/SP HPO SOURCE STATEMENTS THAT IT DOESN'T SUPPORT AND WILL SEND A WARNING, BUT WILL CONTINUE TO CREATE THE UPDATED DIRECTORY. SEE THE VM/XA OR VM/ESA (WITH ESA FEATURE) PLANNING AND ADMINISTRATION MANUAL FOR INFORMATION ON THE DIRECTORY STATEMENTS AND THE DIRECTXA COMMAND. 15. 91/11/21 IF THE DATA STREAMING FEATURE IS ENABLED ON THE PRINTER, ENSURE THAT THE UCW IS ALSO SET FOR THE DATA STREAMING UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 025 OF 073 FEATURE. IMPROPER CONFIGURATION OF THE DATA STREAMING FEATURE CAN CAUSE MSAPRS1G000E OR OTHER MESSAGES INDICATING DATA IN AN INPUT RECORD OR RESOURCE IS INVALID. THESE MESSAGES ARE INVALIDLY ISSUED. 14. 91/09/24 CUSTOMERS INSTALLING GROUP4 PDM NEED TO OBTAIN DOC APAR PN05808. USERS AFFECTED: ALL PSF/VM 2.1.0 INSTALLATIONS USING THE GROUP4 PDM. PROBLEM DESCRIPTION: AFTER INSTALLING PSF/VM AND INVOKING THE IVP EXEC (V5684141), THE IVP DID NOT PRINT ON THE GROUP4 PRINTER. RECOMMENDATION: MODIFY THE FORM PDM FILE OR CREATE UNIQUE FORM TASKPRTID FILES TO MATCH INSTALLATION REQUIREMENTS SEE PN05808 (ATTACHED). 13. 91/08/07 THE DMKSNT SFCM SAMPLE FILE SHIPPED WITH PSF/VM 2.1.0 IS INCORRECT. A CORRECT DMKSNT SFCM SAMPLE FILE IS SHOWN BELOW. THE SAMPLE BELOW MATCHES THE SAMPLE DOCUMENTED IN UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 026 OF 073 THE PROGRAM DIRECTORY (G5443683-00) ON PAGE 39, WHICH IS CORRECT: ******************************************************** * PSF/VM (PROGRAM NO. 5684-141 PRINT SERVICES FACILITY * * FOR VM) APRSFCM4 DISCONTIGUOUS SAVE SEGMENT - DCSS * * FOR PSF/SFCM * * HEX LOAD ADDRESS FOR SEGMENT 128 = 8000000 * * NUMBER OF PAGES = 113 ( 112 + 1 FOR CP ) * ******************************************************** APRSFCM4 NAMESYS SYSNAME=APRSFCM4, SYSVOL=XXXXXX, SYSSTRT=(098,010), SYSPGNM=(2048-2159), SYSPGCT=112, SYSHRSG=(128-134), SYSSIZE=2048K, SYSCYL= VSYSRES=, UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 027 OF 073 VSYSADR=IGNORE 12. 91/07/29 THE CORRECTIVE SERVICE EXECS FOR PSF/VM ARE NAMED AS FOLLOWS: PTFSERVP FOR THE PSF COMMAND PTFSERVB FOR PRINT SERVICES (SFCM/BASE) PTFSERVA FOR THE GROUP3 PDM ATTACH SUPPORT PTFSERVL FOR THE GROUP4 PDM ATTACH SUPPORT PTFSERVS FOR THE 3800 PDM ATTACH SUPPORT PTFSERVV FOR THE 3820 PDM ATTACH SUPPORT PTFSERVK FOR THE ACIF PROGRAM PTFSERVQ FOR THE AFP API PROGRAM THE RENAME EXEC'S, WHICH ARE RUN BEFORE THE SERVICE EXEC'S, ARE AS FOLLOWS: FILENAME FEATURE SERVICED RELEASE CONTROL FILENAME 5684141A PSF COMMAND 2B6 PSFCMD 5684141B BASE (SFCM) 210 PSFBASE 5684141C 3800 2B7 PSF3800 UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 028 OF 073 5684141D 3820 2B8 PSF3820 5684141E GRP3 2B9 PSFGRP3 5684141F RESOURCES 211 PSFRES 5684141G GRP4 2BB PSFGRP4 11. 91/07/17 THE RELEASE LEVELS USED FOR PSF/VM 2.1.0 APARS AND PTFS ARE AS FOLLOWS: 2B6 - PSF COMMAND 210 - PSF PRING SERVICES (SPOOL FILE CONVERSION MACHINE-SFCM) 2B7 - 3800 PRINTER DRIVER MACHINE (PDM) 2B8 - 3820 PDM 2B9 - GROUP3 PDM 211 - RESOURCES 2BB - GROUP4 PDM 10. 91/05/30 THE CP MIH/MITIME VALUE FOR A GRP3 PRINTER ATTACHED TO PSF SHOULD NEVER BE LESS THAN THE PSF MITIME VALUE FOR THE PRINTER. IF A NON-ZERO MITIME VALUE IS SPECIFIED IN THE UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 029 OF 073 PSF GRP3 OPTIONS PDM FILE, THEN THE CP MIH/MITIME SHOULD BE TURNED OFF FOR THE PDM VIRTUAL MACHINE OR FOR THAT PRINTER, OR THE CP MITIME VALUE FOR THE PRINTER SHOULD BE SET GREATER THAN THE PSF MITIME VALUE. 9. 91/05/30 IF A D/T3800 IS GENNED WITH DEVTYPE AFP1 RUNNING PSF WITH VM/ESA, THE 3800 PDM WILL NOT INITIALIZE AND NO MESSAGE IS ISSUED. ENSURE THAT THE D/T3800 IS GENNED WITH DEVTYPE OF 3800. 8. 91/05/24 CODE PAGE T1D0BASE IS MAPPED TO 4028 PRINTER RESIDENT CODE PAGE X'3EA' (1002) IN THE APRRSFTB ASSEMBLE FONT RESOURCE TABLE SAMPLE PROVIDED WITH PSF/VM 2.1.0. THERE ARE SOME CODE POINT DIFFERENCES BETWEEN HOST CODE PAGE T1D0BASE AND CODE PAGE 1002. CODE PAGE T1D0BASE IS A SUPERSET OF CODE PAGE 1002. THAT IS, IT CONTAINS A FEW CODE POINTS THAT 1002 DOES NOT. HOST CODE PAGE 1002 (T1001002) AND PRINTER RESIDENT CODE PAGE 1002 ARE EQUIVALENT. IF AN INSTALLATION PLANS TO USE THE ADDITIONAL CODE POINTS UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 030 OF 073 DEFINED IN T1D0BASE BUT NOT DEFINED IN T1001002, THEN THE T1D0BASE ENTRY IN THE APRRSFTB TABLE SHOULD BE COMMENTED OUT OR DELETED. THIS WILL CAUSE PSF/VM TO DOWNLOAD THE FONT USING THE HOST VERSION OF T1D0BASE INSTEAD OF ACTIVATING THE PRINTER RESIDENT VERSION. IN MOST CASES, THIS CHANGE IS RECOMMENDED SO THAT ALL POSSIBLE PRINTED OUTPUT IS CORRECT. 7. 91/05/23 PLEASE REFER TO WSC FLASH 9120 PSF/VM 2.1.0 MANUAL INSTALL PROCEDURES FOR INFORMATION ABOUT PRODUCT INSTALLATION LOGIC. 6. 91/05/16 FOR CUSTOMERS WITH GRP4 PRINTERS ATTACHED TO PSF/VM 1.3.0 OR PSF/VM 2.1.0 IN 3270 DSC (NON-SNA) MODE, THE FOLLOWING CONTROLLER MICROCODE LEVELS ARE REQUIRED: 3174 SUBSYSTEM CONTROL UNIT MICROCODE LEVEL A5.0 OR HIGHER 3274 CONTROL UNIT MICROCODE LEVEL D65.1 OR HIGHER 9370 WORKSTATION ADAPTER (FEATURE 6020) MICROCODE LEVEL UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 031 OF 073 EC A866889 OR HIGHER 5. 91/05/05 WHEN PLANNING AND INSTALLING PSF/VM 2.1.0, OBTAIN A COPY OF THE WASHINGTON SYSTEM CENTER (WSC) FLASH 9117 ENTITLED, 'PSF/VM 2.1.0 AND FONTS'. CONTACT YOUR SE FOR A COPY. 4. 91/04/18 OBTAIN A COPY OF PSP BUCKET UPGRADE: AFPFONT, SUBSET: PSF210, FOR FONT PROBLEMS. 3. 91/04/18 ON A VM/XA OR VM/ESA SYSTEM, SHARED SEGMENT PACKING SHOULD BE USED. IF IT IS NOT USED, IT MAY BE NECESSARY TO DEFINE A FULL 1 MEG SEGMENT FOR EACH DCSS. THIS MAY BE A MEMORY MANAGEMENT PROBLEM WITH ONE SYMPTOM BEING MSCSIABD230E ABEND 0C1, ALTHOUGH THERE MAY BE OTHERS. FOR INFO ON SHARED SEGMENT PACKING, SEE GUIDE TO SAVED SEGMENTS (SC23-0457). 2. 91/04/18 ABENDS 806-0004 ON GROUP 4 PDMS WILL OCCUR IF THE APRGRP44 DCSS IS NOT DEFINED TO GCS. UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 032 OF 073 1. 91/04/18 THE CMS PTF PREREQUISITES LISTED IN THE 'INSTALLATION REQUIREMENTS AND CONSIDERATIONS, SECTION 5.1.2, PAGE 18, OF THE PSF/VM 2.1.0 PROGRAM DIRECTORY ARE REQUIRED. NOTE THAT CMS PTFS UV51488 AND UV46124 ARE BOTH REQUIRED FOR VM/SP5 AND VM/SP HPO5 SYSTEMS. A SYMPTOM INDICATING THAT THE CMS PTFS HAVE NOT BEEN APPLIED IS: MSDMSITP141T OPERATION EXCEPTION OCCURRED AT LOCATION X'00006' IN ROUTINE APRSFCMC. THE D/T3800 PDM AND GROUP3 PDM WILL ALSO ABEND. ANOTHER SYMPTOM THAT THE CMS PTFS ARE NOT APPLIED IS: MSAPRPSF933S "I/O ERROR WRITING TO SPOOL: FILE WAS NOT SPOOLED". ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 033 OF 073 14. 93/08/10 PROBLEM: (PN43123) PTFSERVA PTFSERVL PTFSERVV RC=4 FROM THE LOAD COMMAND WHEN CREATING DCSS. 93/07/02 PTF PECHANGE USERS AFFECTED: PSF/VM users using the PTFSERVL, PTFSERVA or PTFSERVV execs to buildPDM programs in shared segments ( DCSSs ). RECOMMENDATION: INSTALL UN47233 ON VOLID 9401 13. 93/08/10 PROBLEM: (PN43123) PTFSERVA PTFSERVL PTFSERVV RC=4 FROM THE LOAD COMMAND WHEN CREATING DCSS. 93/07/02 PTF PECHANGE USERS AFFECTED: PSF/VM users using the PTFSERVL, PTFSERVA or PTFSERVV execs to buildPDM programs in shared segments ( DCSSs ). RECOMMENDATION: INSTALL UN47232 ON VOLID 9401 UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 034 OF 073 12. 93/08/10 PROBLEM: (PN43123) PTFSERVA PTFSERVL PTFSERVV RC=4 FROM THE LOAD COMMAND WHEN CREATING DCSS. 93/07/02 PTF PECHANGE USERS AFFECTED: PSF/VM users using the PTFSERVL, PTFSERVA or PTFSERVV execs to buildPDM programs in shared segments ( DCSSs ). RECOMMENDATION: INSTALL UN47231 ON VOLID 9401 11. 93/08/10 PROBLEM: (PN43123) PTFSERVA PTFSERVL PTFSERVV RC=4 FROM THE LOAD COMMAND WHEN CREATING DCSS. 93/07/02 PTF PECHANGE USERS AFFECTED: PSF/VM users using the PTFSERVL, PTFSERVA or PTFSERVV execs to buildPDM programs in shared segments ( DCSSs ). UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 035 OF 073 RECOMMENDATION: INSTALL UN47230 ON VOLID 9401 10. 93/08/10 PROBLEM: (PN43123) PTFSERVA PTFSERVL PTFSERVV RC=4 FROM THE LOAD COMMAND WHEN CREATING DCSS. 93/07/02 PTF PECHANGE USERS AFFECTED: PSF/VM users using the PTFSERVL, PTFSERVA or PTFSERVV execs to buildPDM programs in shared segments ( DCSSs ). RECOMMENDATION: INSTALL UN47229 ON VOLID 9401 9. 93/08/10 PROBLEM: (PN43123) PTFSERVA PTFSERVL PTFSERVV RC=4 FROM THE LOAD COMMAND WHEN CREATING DCSS. 93/07/02 PTF PECHANGE USERS AFFECTED: PSF/VM users using the PTFSERVL, PTFSERVA or PTFSERVV execs to buildPDM programs in shared segments ( UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 036 OF 073 DCSSs ). RECOMMENDATION: INSTALL UN47228 ON VOLID 9401 8. 93/08/06 PROBLEM: (PN38057) ADD SUPPORT FOR ACIF AND AFP API TO INSTALLATION AND CORRECTIVE SERVICE EXECS USERS AFFECTED: PSF/VM 2.1.1 users RECOMMENDATION: INSTALL UN44283 ON VOLID 9401 7. 93/08/06 PROBLEM: (PN38057) ADD SUPPORT FOR ACIF AND AFP API TO INSTALLATION AND CORRECTIVE SERVICE EXECS USERS AFFECTED: PSF/VM 2.1.1 users RECOMMENDATION: INSTALL UN44282 ON VOLID 9401 6. 93/08/06 PROBLEM: (PN38057) ADD SUPPORT FOR ACIF AND AFP API TO INSTALLATION AND CORRECTIVE SERVICE EXECS USERS AFFECTED: PSF/VM 2.1.1 users UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 037 OF 073 RECOMMENDATION: INSTALL UN44281 ON VOLID 9401 5. 93/08/06 PROBLEM: (PN38057) ADD SUPPORT FOR ACIF AND AFP API TO INSTALLATION AND CORRECTIVE SERVICE EXECS USERS AFFECTED: PSF/VM 2.1.1 users RECOMMENDATION: INSTALL UN44280 ON VOLID 9401 4. 93/08/06 PROBLEM: (PN38057) ADD SUPPORT FOR ACIF AND AFP API TO INSTALLATION AND CORRECTIVE SERVICE EXECS USERS AFFECTED: PSF/VM 2.1.1 users RECOMMENDATION: INSTALL UN44279 ON VOLID 9401 3. 93/08/06 PROBLEM: (PN38057) ADD SUPPORT FOR ACIF AND AFP API TO INSTALLATION AND CORRECTIVE SERVICE EXECS USERS AFFECTED: PSF/VM 2.1.1 users RECOMMENDATION: INSTALL UN44278 ON VOLID 9305 UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 038 OF 073 2. 92/03/16 PROBLEM: (PN08536) SFCM PERIODICALLY NEEDS AUDIT ON TO CONVERT FILES. END OF ABSTRACT USERS AFFECTED: ALL PSF/VM 2.1.0 INSTALLATIONS WITH AN SFCM DRIVING MORE THAN 1 PDM OR GROUP4 PRINTER TASK PROGRAM. RECOMMENDATION: INSTALL UN09958 ON VOLID 9201 1. 91/11/26 PROBLEM: (PL83703) PRINTING A GERMAN CHARACTER CONSISTING OF AN O WITH TWO DOTS ABOVE IT GIVES INCORRECT OUTPUT USERS AFFECTED: ALL PSF/VM 2.1.0 CUSTOMERS USING THE GROUP3 PDM AND CHANNEL ATTACHED GROUP3 PRINTERS. RECOMMENDATION: INSTALL UL97732 ON VOLID 9105 ************************************************************************ * 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: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 039 OF 073 ************************************************************************ THIS SECTION CONTAINS INFORMATION THAT IS DEPENDENT UPON ANOTHER PRODUCT OTHER THAN THIS SUBSET ID. 4. 92/09/28 INTERDEPENDENT PRODUCT: VM CP PROBLEM: PSF/VM customers on VM/SP5, VM/HPO5, VM/SP6 and VM/HPO6 systems may experience symptom: MSAPRSSE298T "A PSF LOGIC ERROR INVOLVING APROPRC WAS DETECTED, RC(1106)" A CP PE APAR resolves the problem, VM38497 USERS AFFECTED: All with VM35694 using *SPL RECOMMENDATION: Install PTF UV47314 (RD75) on volid 9002 Install PTF UV47312 (RA50) on volid 9002 Install PTF UV47315 (RD76) on volid 9002 Install PTF UV47313 (RA60) on volid 9002 3. 92/09/18 INTERDEPENDENT PRODUCT: VM/ESA CMS R111 PROBLEM: If attempting to print using TRCs from a VM/ESA UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 040 OF 073 1.1.1 CMS print file submittor, the output may print using only the first font. That is, TRCs 0,1,2 and 3 all print with the TRC 0 font. VM51332 fixes a problem in CMS (DMSPIO) which caused this problem. USERS AFFECTED: ALL RECOMMENDATION: INSTALL PTF UM21085 ON VOLID 1000 2. 92/08/07 INTERDEPENDENT PRODUCT: DW/370 PROBLEM: APRLPSFC fails when invoked from DW/370 running above the line. ABENDU1000 is received. USERS AFFECTED: Applications that incorporate APRLSPFC above 16M line. RECOMMENDATION: INSTALL PTF UN03218 ON VOLID 9201 1. 91/09/06 INTERDEPENDENT PRODUCT: PSF/VM & RACF 1.9 USERS AFFECTED: USERS OF PSF/VM AND RACF 1.9 PROBLEM: WHEN OPERATING PSF/VM WHERE RACF 1.9 IS ON THE SAME SYSTEM, OR ON A SYSTEM WHICH SHARES DASD WITH A SYSTEM WHERE RACF 1.9 IS INSTALLED, PLEASE REVIEW AND APPLY PSF/VM UPGRADE: PSFVM211 SUBSET: VM/211 INTRODUCTORY TEXT PG 041 OF 073 1.3.0 APAR PL85977 OR PSF/VM 2.1.0 APAR PN00203. THESE APARS AFFECT THE CMS COMPONENTS OF PSF/VM ONLY (SFCM, 3800 PDM AND GROUP3 NON-SNA PDM). THE GCS COMPONENTS OF PSF/VM (GROUP 4 PDM, 3820 PDM OR GROUP 3 SNA PDM SHOULD NOT ACCESS A DISK CONTAINING RPIUGCS LOADLIB. FOR FURTHER INFORMATION REGARDING VM US DEPARTMENT OF DEFENSE (DOD) SECURITY SUPPORT, SEE ANNOUNCEMENT LETTER 391-029 ENTITLED 'VM US DOD SECURITY SUPPORT TO BE CONSOLIDATED ON VM/ESA 1.1'. RECOMMENDATION: INSTALL PSF/VM APAR PL85977 FOR PSF130 AND PN00203 FOR PSF21. ************************************************************************ * 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: PSFVM211 SUBSET: VM/211 APAR PN18912 PG 042 OF 073 APAR NUMBER = PN18912 LAST UPDATE = 92/05/06 PTF IN ERROR = PIN = YES CURRENT APAR STATUS = CLOSED CLOSING CODE = DOC ORIGINAL APAR NUMBER = SECURITY/INTEGRITY = NO SERVICE NUMBER = 0462041 REPORTED COMPONENT = 568414101 R210 PSF/VM V2 R1.0 FIXED COMPONENT = FAILING MODULE = PROBLEM ABSTRACT: INCOMPLETE PROGRAM DIRECTORY FOR PSF/VM 2.1.0, PSF/VM 2.1.0 MANUAL INSTALL PROCEDURE REPORTED SCP RELEASE: 210 ERROR DESCRIPTION: Missing documentation after modification of aprftblv. System Programming Guide (s5443680-00 p233/4) refers to program directory but the whole documentation for manual installation procedure is missing there. This applies to build loadlibs and txtlibs for psf3800,psf3820. Applies to user which are using manual installation. UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN18912 PG 043 OF 073 TEMPORARY FIX: PROBLEM SUMMARY: **************************************************************** * USERS AFFECTED: PSF/VM 2.1.0 Installers * **************************************************************** * PROBLEM DESCRIPTION: The PSF/VM 2.1.0 Program Directory * * does not contain manual installation * * procedures. This information * * can only be found in the Washington * * Systems Center Flash 9120 entitled * * 'PSF/VM 2.1.0 Manual Install * * Procedure'. The customer requested * * that this FLASH also be made available * * in an APAR so that it could be found * * when searching for installation * * related help. * **************************************************************** * RECOMMENDATION: READ WSC FLASH 9120. * **************************************************************** UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN18912 PG 044 OF 073 PROBLEM CONCLUSION: A list of keywords was extracted from WSC FLASH 9120 and is included in this APAR so that any term found in this APAR will point to the FLASH document. RETAIN system limitations did not permit the inclusion of the entire FLASH in an APAR (as originally requested). . This APAR simply serves as an index into the FLASH. . AFPOPTS APRACTE APRACTEA APRACTEB APRACTEC APRACTES APRACTEV APRACTSL APRCALLL APRCALL4 APRFTBLV APRFTID APRFTIDB APRGP3AL APRGP3DL APRGP34A APRGP34D APRGRP4L APRGRP44 APRINIT APRINITV APRMAINL APRMTSK APROPRCL APROPRML APRPGRP4 APRPSFCC APRPSFCL APRPSFC4 APRP3820 APRRECEC APRSEPEC APRSETXL APRSFCMC APRSFCML APRSFCM4 APRSIOML APRSSCC APRSSCCL APRSSDAL APRSSDBL APRSSDDL APRSSPC APRWRKSL APRXCTLL ATTACH A00-A1F A00000 A20-A6F A20-A7F A20-A8F A20000 A60000 A80-ADF A80000 CHANNEL CLASSA CLASSc CLEAR CONTENTS COPY COPYFILE CP DCF3812 DCKVTBL DCKVTBLL DCKVTBL4 DCSS DEFSEG DMKSNT ESA EXAMPLE EXEC EXIT UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN18912 PG 045 OF 073 FILEDEF FLASH FORM FORMDEF FSF F1IBM GCS GENMOD GLOBAL GP3 Group3 Group4 GRP3 GRP3CHAN GRP3SNA GRP4 GRP4CHAN GRP4PDM GRP4SNA INSTALL INSTALLATION IVP I5684141 LIBE LINK LKED LKEDIT LOAD LOADLIB MAINT MANUAL MAP Meg megabyte member MEMO mode MODULE MOUNT nucleus OPERATOR OPR OPRMSG OPTIONS ORIGIN packing PAGEDEF PDM PDMGRP3 PDMGRP4 PDMREM1 PDM0490 PDM3800 PDM3820 PDM470 PEL PERM PPCC PRINT PROCEDURE PROFGRP3 PROFGRP4 PROFILE PROFS PROFSFCM PROF3800 PROF3820 PROTECT PSF PSF/VM PSFBASE PSFCMD PSFGRP3 PSFGRP3A PSFGRP3D PSFGRP4 PSFMAINT PSFPPCC PSF3800 PSF3820 RENT REP RESET resident resource resources REW RLDSAVE RPM SAVED SAVESEG SAVESYS SC230457 SEGMENT segments SETKEY SFCM shared SNA SPACE SR SYSLIN taskprtid TEXT TXTLIB TXTLIBSV verification VM/ESA VM/SP VM/XA VMFPLC2 WSC XA 19E 191 193 2.1.0 3800 3812 3820 5832 5852 5870 5892 7D0000 700-70F 700000 800-86F 800000 806-0004 9120 MODULES/MACROS: SRLS: G544368300 CIRCUMVENTION: UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN18912 PG 046 OF 073 APPLICABLE COMPONENT LEVEL/SU: UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN05808 PG 047 OF 073 APAR NUMBER = PN05808 LAST UPDATE = 91/09/12 PTF IN ERROR = PIN = YES CURRENT APAR STATUS = CLOSED CLOSING CODE = DOC ORIGINAL APAR NUMBER = SECURITY/INTEGRITY = NO SERVICE NUMBER = 0462041 REPORTED COMPONENT = 568414101 R210 PSF/VM V2 R1.0 FIXED COMPONENT = FAILING MODULE = PROBLEM ABSTRACT: INSTALLING D/T4028 IVP NO PRINT OUT NO ERROR MESSAGE, V5684141 PSF/VM 2.1.0 GROUP4. REPORTED SCP RELEASE: 210 ERROR DESCRIPTION: INSTALLING D/T4028 IVP NO PRINT OUT NO ERROR MESSAGE, V5684141 PSF/VM 2.1.0 GROUP4. THE SFCM DOES NOT CONVERT THE FILE AND THE PRINTER IS IDLE. ERROR IN THE PSF/VM SYSTEM PROGRAMMING GUIDE S5443680-00 CHAPTER 5 PAGE 189 'FIGURE 34 SAMPLE GROUP4 FORM PDM FILE' TEMPORARY FIX: UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN05808 PG 048 OF 073 PROBLEM SUMMARY: **************************************************************** * USERS AFFECTED: ALL PSF/VM 2.1.0 INSTALLATIONS USING THE * * GROUP4 PDM * **************************************************************** * PROBLEM DESCRIPTION: AFTER INSTALLING THE PSF/VM PRODUCT AND * * INVOKING THE INSTALLATION VERIFICATION * * EXEC (V5684141), THE IVP DID NOT PRINT * * ON THE GROUP4 PRINTER. THE SFCM DID * * NOT CONVERT THE FILE. THE FORM PDM * * FILE PROVIDED AS A SAMPLE WAS USED * * UNMODIFIED. THE FORM NAME USED BY THE * * CUSTOMER TO SUBMIT THE PRINT FILE WAS * * 'STANDARD'. FORM 'STANDARD' WAS NOT * * DEFINED IN THE FORM PDM FILE (OR IN A * * UNIQUE FORM TASKPRTID FILE). * **************************************************************** * RECOMMENDATION: UPDATE THE PSF/VM SYSTEM PROGRAMMING GUIDE * * (S5443680-00) PER THIS APAR. MODIFY THE * UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN05808 PG 049 OF 073 * FORM PDM FILE OR CREATE UNIQUE FORM * * TASKPRTID FILES TO MATCH INSTALLATION * * REQUIREMENTS. IF NO CUSTOMIZATION IS * * REQUIRED AND FORM 'STANDARD' IS USED, THEN * * ADD THE LINE 'STANDARD SEP' TO THE FORM PDM * * FILE. * **************************************************************** CHANGE FIGURE 34 'SAMPLE GROUP4 FORM PDM FILE' ON PAGE 189 OF THE PSF/VM SYSTEM PROGRAMMING GUIDE S5443680-00 TO THE FOLLOWING: * SAMPLE FORM PDM FILE FOR A GROUP4 PRINTER * * SEPARATOR PAGES SPECIFIED: STANDARD SEP * SEPARATOR PAGES NOT SPECIFIED: FORMSEP NOSEP * HEADER ONLY: FORMHDR H UPGRADE: PSFVM211 SUBSET: VM/211 APAR PN05808 PG 050 OF 073 PROBLEM CONCLUSION: THE PSF/VM SYSTEM PROGRAMMING GUIDE HAS BEEN MODIFIED TO CORRECT THE PROBLEM. THE SAMPLE FORM PDM FILE SHIPPED WITH THE PSF/VM 2.1.0 GROUP4 PDM (FORM PDMGRP4) SHOULD EITHER BE CHANGED TO MATCH THE ABOVE EXAMPLE OR CUSTOMIZED TO MATCH THE FORM NAMES TO BE USED IN THE INSTALLATION. MODULES/MACROS: SRLS: S544368000 CIRCUMVENTION: APPLICABLE COMPONENT LEVEL/SU: UPGRADE: PSFVM211 SUBSET: VM/111 INTRODUCTORY TEXT PG 051 OF 073 *********************** * SUBSET VM/111 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR ACIF FEATURE VERSION 2, RELEASE 1, MODIFICATION 1. ************************************************************************ * 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: PSFVM211 SUBSET: VM/111 INTRODUCTORY TEXT PG 052 OF 073 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: PSFVM211 SUBSET: VM/111 INTRODUCTORY TEXT PG 053 OF 073 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: PSFVM211 SUBSET: VM/111 INTRODUCTORY TEXT PG 054 OF 073 ************************************************************************ * 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) * ************************************************************************ UPGRADE: PSFVM211 SUBSET: VM/113 INTRODUCTORY TEXT PG 055 OF 073 *********************** * SUBSET VM/113 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR API FEATURE VERSION 2, RELEASE 1, MODIFICATION 1. ************************************************************************ * 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. 95/08/04 GENERAL INFORMATION 4. 99/08/10 SERVICE RECOMMENDATIONS 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES UPGRADE: PSFVM211 SUBSET: VM/113 INTRODUCTORY TEXT PG 056 OF 073 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 3 99/08/10 PQ26568 UQ29769 1000 HIPER STORAGE LEAK IN ENDPAGE 2 93/10/19 PN45235 UN49243 9401 APQPPRF AND APQPVAR ARE 1. 93/08/03 PN36146 UN44747 9401 HIPER 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. 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 * ************************************************************************ UPGRADE: PSFVM211 SUBSET: VM/113 INTRODUCTORY TEXT PG 057 OF 073 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. 3. 95/08/04 When installing apar pn73433 / un79772 message stating the APQEND and APQTERM have unresolved external references to APQXUNLD. The messages are fine and pose no problems. 2. 94/02/08 II07600 (attached) - AFPAPI common problem info apar 1. 93/08/03 API/VM users must recompile all of their API COBOL and PL1 UPGRADE: PSFVM211 SUBSET: VM/113 INTRODUCTORY TEXT PG 058 OF 073 applications due to the copybook changes in PN36146. ************************************************************************ * 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 99/08/10 PROBLEM: (PQ26568) STORAGE LEAK IN ENDPAGE PROCESSING USERS AFFECTED: All AFP/API users. RECOMMENDATION: INSTALL UQ29769 ON VOLID 1000 (R113 ) 2 93/10/19 PROBLEM: (PN45235) APQPPRF AND APQPVAR ARE SHIPPED WITH FILE TYPE OF MACRO INSTEAD OF COPY WITH UN44747. 93/09/28 PTF PECHANGE USERS AFFECTED: All AFPAPI VM users that applied UN44747 (PN36146). RECOMMENDATION: INSTALL UN49243 ON VOLID 9401 1. 93/08/03 PROBLEM: (PN36146) ENHANCED FUNCTION UPGRADE: PSFVM211 SUBSET: VM/113 INTRODUCTORY TEXT PG 059 OF 073 USERS AFFECTED: ALL AFP API USERS RECOMMENDATION: INSTALL UN44747 ON VOLID 9401 ************************************************************************ * 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 * UPGRADE: PSFVM211 SUBSET: VM/113 INTRODUCTORY TEXT PG 060 OF 073 * APARS FOLLOW (IF ANY) * ************************************************************************ UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 061 OF 073 APAR NUMBER = II07600 LAST UPDATE = 97/12/02 PTF IN ERROR = PIN = YES CURRENT APAR STATUS = CLOSED CLOSING CODE = CAN ORIGINAL APAR NUMBER = SECURITY/INTEGRITY = NO SERVICE NUMBER = 5NFO000 000 REPORTED COMPONENT = INFOPALIB R001 PA LIB INFO ITE FIXED COMPONENT = FAILING MODULE = PROBLEM ABSTRACT: AFPAPI COMMON PROBLEM INFO APAR REPORTED SCP RELEASE: 000 ERROR DESCRIPTION: 564806202 HQN2112 R112 R113 ************************************************************** Section A - Modifying CHKSUCC to handle different severity codes Section B - Running APQBINDC ** See SECTION D ** Section C - RC0071 UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 062 OF 073 Section D - msgIEW2456E running APQCOCOB Section E - Buffered interface (apar pn67836) Section F - Measure String (apar pn69627) Section G - Remove the restriction for not moving "up" the page (apar pn70396) Section H - ASCII fonts are not supported in API. Section I - Performance Considerations Section J - AFPINVM Invoke Medium Map Section K - RC0087 as the result of apar pn72810 and pn75041 Section L - RC0218 duplicate font names Section M - Text breaks on font change in Paragraph state. Section N - AFPAPI output is always in 1440 per inch. Section O - APQSAMPL2 in VSE, RC0217 rerun FLIP Section P - Placing an area AFPPARE within another area. Section Q - x'40' & x'41' in API data (perhaps using BARCODES) Section R - Information on the CICS apar pn82150/un89412 UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 063 OF 073 Section S - RC0071 ON AFPPARE. The same API code ran fine before upgrading to OS/390 R3 Section T - MSGIEW2646W RC04 HPRF220N Section U - Sample JCL for LE/370 ******************************************************** Section A The AFP API IVP programs (APQSAMP and APQPSAMP) and sample programs (APQSAMP2 and APQPSMP2) perform error checking after most of the AFP API calls. The error checking routine, CHKSUCC, is provided in APQPERF (COBOL paragraphs) and APQPPRF (PL/1 subroutines). At installation time, CHKSUCC displays an error message and terminates when the severity code is greater than 4. This is because we don't want the IVP program to continue when a severity code 8 is encountered. A severity code greater than 4 indicates that something went wrong when the API was installed. If you use the routines provided in either APQPERF or APQPPRF, and you want your application to handle severity codes of 8 or less, than you must modify CHKSUCC to allow UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 064 OF 073 severity codes less than or equal to 8. Note: AFP API sends return codes and severity codes back to the program after every procedure call. The applica- tion program should monitor these codes after every call and respond accordingly. Checking them aids in debugging your program. ***************************************************** Section B Job APQBINDC, which exists in data set PSF.AFPAPI.SAPQSAM1, must be run after applying maintenance to AFPAPI. This job must be run every time a PTF is applied. Failure to run APQBINDC will result in an ABEND0C4 when trying to run an API program after maintenance has been applied. ** Note this requirement is no longer needed after apar pn48099 / un57780. See Section D of this apar. Also see apar pq14039/uq16129 98/04/06 **************************************************** Section C A RC0071 'INVALID AREA HANDLE SPECIFIED IN A PUT AREA UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 065 OF 073 PROCEDURE CALL. THE AREA DOES NOT EXIST.' can occur if the areas are not compiled in the order they are used. ******************************************************** Section D 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 libary requirement was lifted and the INCLUDE statements for these modules were removed in the new APQCOCOB. The were replaced with INCLUDEs for APQXGET APQXFREE APQXLOAD APQXSRVI and APQXSRVN. *** Additional *** msgiew2456e for APQXUNLD from a recent apar, pn73443. Fixed in apar pn78749. *************************************************************** Section E Buffered Interface (apar pn67836). Adds the ability to direct output from the API to be returned to the program in a buffer rather than written to an output data set. NOTE: Some customer have received an abend0c1 UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 066 OF 073 dd name IEC135 DD statement missing using this interface. Fixed by running from the correct copybooks (IBM SUPPLIED) Upper vs lower case sensitive on some constants. *************************************************************** Section F Measure String (apar pn69627). Allows users to query the width and linespacing depth of a string of characters in a specified font. *************************************************************** Section G Remove the restriction for not moving "up" the page on AFPSPOS (apar pn70396). *************************************************************** Section H ASCII fonts are not supported in API *************************************************************** Section I Performance Considerations 1) Get to current service level. Several problems have been UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 067 OF 073 corrected involving AREAS and TABLES. 2) FONT, ROW and FIELD definitions should be done at the document level rather than the page level. 3) AREAS should be deleted when no longer needed and should be used only where necessary. Apar PN70396 removed the restriction of placing data on the page in top-to-bottom order. This means AREAS do not need to be, nor should be used for this purpose. 4) Do not issue multiple AFPDOC/AFPEDOC or AFPINIT/AFPEND requests unless there is a good reason. You can have multiple groups of pages in a single document. 5) Do not use TABLES unless absolutely needed. Many table-like functions can be done with draw rules and put character strings. *************************************************************** Section J AFPINVM Invoke Medium Maps (copy group). If only one copy group is specified on the page and it is the same (name) as the last copy group used on the previous UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 068 OF 073 page, the copy group is not changed. Error: IMM not picking up the correct copygroup. *************************************************************** Section K A return code rc0087 could be issued if the information in apar pn72810 is not read carefully. This apar requires that rows and fields be defined only at the document level. You can no longer define rows and fields at the page level. This will improve performance. **************************************************************** Section L A rc0218 problem can occur if duplicate font names occur in the library (as indicated on the FLIP report). The rc0218 comes from a duplicate character set. The solution is to make sure all fonts have unique typeface / attributes. **************************************************************** Section M Problem: Text breaks on a font change in Paragraph state. UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 069 OF 073 Fixed: The documentation will be updated to fix this problem. Page 139 of the Program Guide and Reference s544-3872-01 that refers to AFPPTXT the section under concatenate will be changed. The 3rd sentence in the paragraph will change from: 'If no previous AFPPTXT (PUT TEXT) call was issued within the paragraph, the parameter is ignored.' To: 'Initialize the AFP-CONCATENATE field to TRU of the first invocation of AFPPTXT (PUT TEXT) of each field or paragraph.' **************************************************************** Section N The higher resolution of 1440 is the output resolution because of font metrics and 1440 is the highest resolution supported by AFP/API. The output file generated by AFP/API is in 1440 per inch. ************************************************************** Section O Running APQSAMPL2 for VSE and receiving a rc0217. See apar pn38085. Rename members APSR55*.PHASE -> UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 070 OF 073 =.TPHASE. Then buils FLIP (APQFLIP job). ************************************************************** Section P Placing an area (AFPPARE) inside another area per the Programming Guide and Reference (s5443872-01) does not work as documented. Please see Doc apar pn79818. **************************************************************** Section Q Concerning x'40' and x'41' in codepages (perhaps using BARCODES) AFPPCHS for x'41' gets x'40' in error =========================================================== The secret for getting hex 40's to be character data was to have two copies of the codepage, one for API and another for PSF to "hide" the hex 40's in the data from API. In the codepage for API formatting, the CPC was set like this: CPC DEF=SP010000 VAL=1 PRT=0 INC=0 VSC=4040 But once the LIST file had been generated, PSF sends another UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 071 OF 073 version along with the LIST3820. That version had this: CPC DEF=SP010000 VAL=1 PRT=0 INC=0 VSC=4141 This meant that PSF would use 41 for spaces instead of 40's. The redefinition of the hex 40 and 41 codepoints in the codepage doesn't matter to API. We just need a codepage with x'4040' in the VSC field of the CPC for API to process it, and we need another copy of the codepage with something else in the VSC field to get to treat the 40's as ordinary text. ************************************************************** Section R The New Function apar pn82150/un89412 provides API support for use with CICS. AFP API for CICS/ESA requires cics/esa version 3 release 2.1 or later. ************************************************************** Section S 12/97 RC0071 from AFPPARE after upgrading to OS/390 R3. The AFPAPI code ran fine before upgrading the system. The problem was caused by the customer code saving area handles, defined in copybook APQVARS as 9(8) binary, UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 072 OF 073 into a field defined as 9(8). For handle values greater than x'5F5E0FF' (99999999 decimal) the value was truncated to 8 digits, resulting in a mis-compare when AFPPARE searched for a matching area. Recommended Fix is to define variables that store handle values as 9(8) binary. It is suggested that COBOL option TRUNC(OPT) or TRUNC(BIN) be used to ensure no loss of digits in this case. A better solution is to change the definition of all fields defined as HANDLEs in both customer code and copybook APQVARS to be PICX (4), since handles are to be treated as tokens, not arithmetic values. **************************************************************** Section T OS/390 ServerPac job HPRF220N (IVP) failed with msgiew2624w rc04. RC00 is expected per the documentation. See OS390 apar OW30705. **************************************************************** Section - U Sample JCL for use with LE/370. UPGRADE: PSFVM211 SUBSET: VM/113 APAR II07600 PG 073 OF 073 See info apar II11580. *************************************************************** TEMPORARY FIX: PROBLEM SUMMARY: PROBLEM CONCLUSION: MODULES/MACROS: SRLS: CIRCUMVENTION: RP97/12/02 Repinned to add section T. APPLICABLE COMPONENT LEVEL/SU: