*********************** * SUBSET HPRF227/0147 * *********************** This subset contains installation information for PSF AIX Upload Version 2, Release 2, 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. 98/11/23 GENERAL INFORMATION 4. 97/06/06 SERVICE RECOMMENDATIONS 5. 99/08/10 CROSS PRODUCT DEPENDENCIES SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 2. 97/06/06 OW27432 UW39048 9706 SUPPORT FOR TCP/IP 3.2.0 1. 97/02/03 OW21017 UW30822 9607 NEW 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 * ************************************************************************ 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. 6. 98/11/23 --------------+---------------+----------------+ Feature UPGRADE SUBSET(s) --------------+---------------+----------------+ PSF base PSFMVS310 HPRF310 JPRF311 --------------+---------------+----------------+ NetSpool NETSPOOL HPRF226/9704 JPRF228 JPRF229 --------------+---------------+---------------- MVS Download PSFMVS310 JPRF312 --------------+---------------+----------------+ AFPUPLOAD AFPUPLOAD HPRF227/9824 --------------+---------------+----------------+ ACIF ACIF HQN2110/9846 --------------+---------------+----------------+ IP PrintWay PRINTWAY HMOS100/9704 JMOS101 JMOS102 +--------------+---------------+----------------+ *** NOTE *** If you have any of the following FMID'S applied to your system _____________________________________________________ Printway HMOS280, JMOS28J, JMOS28S ----------------------------------------------------- Netspool HNET280, HNET28J, HNET28S ----------------------------------------------------- Print Server HOPI280, HOPI28J, HOPI28S ----------------------------------------------------- see the OS/390 Version 2 Release x Program Directory and UPGRADE: OS390Rx SUBSET:INFOPRINT for information regarding the INFOPRINT product and the above FMID's. 5. 97/09/23 Customers who use PL/1 Version 2 Release 3, either with SNA or TCP/IP, need not have OpenEdition Services installed and running. The OpenEdition Services requirement for customers who use LE/370 with TCP/IP is described in another item in this section. 4. 97/09/22 Informational warning messages CEE3640W and IBM0578I followed by abend4093 rc34 active load module at time CEEBINIT are issued because OpenEdition Services feature is not installed. This is required for customer using LE/370 with TCP/IP. 3. 97/03/21 PTF UW30822 includes a hold action (++ HOLD) that describes a new requirement for an additional DDDEF. To apply the PTF you must bypass the hold. Bypassing the hold will cause SMP/E to issue warning message GIM42001W and to yield return code 04. Return code 04 due to message GIM42001W is correct. Please ensure that SMP/E did not issue warning messages other than GIM42001W. A series of the following messages may also be received. They can be ignored. IEW2454W 9203 SYMBOL IBMLLIST UNRESOLVED. NO AUTOCALL (NCAL) SPECIFIED. The SMP/E logic for AFP Upload uses CALLLIBS. When SMP/E first attempts to link a load module it may find that there are unresolved external references, which you cited. However, SMP/E then links the load module again attempting to use CALLLIBS to resolve the external references. And the final link messages for each executable in your held output indicated that the linker resolved all external references 2. 97/03/06 1. AFP Upload - PL/I V2R3 Versus Language Environment for MVS. An AFP Upload installation includes a client program that is shipped with PSF for AIX and runs on AIX and a server program that is purchased as a feature of PSF/MVS and runs on MVS. Most of the MVS server program is written in the PL/I programming language (the rest is written in S/370 assembler language). Therefore, when the MVS server program runs it requires the PL/I run-time libraries. The AFP Upload announcement and AFP Upload Configuration Guides describe that the PL/I Version 2 Release 3 run-time libraries are a required prerequisite. AFP Upload customers can also use the IBM Language Environment for MVS, which includes PL/I run-time libraries, rather than the PL/I V2R3 product. 2. For AFP Upload using TCP/IP, Language Environment Version 1 Release 5 or later is required. And the fix for LE APAR PN81331 must be installed. Finally, OpenEdition MVS Services in MVS/ESA SP V5 must be running. Here is a summary of requirements for using LE with AFP Upload: --------------------------------------------------------- Minimum LE OpenEdition LE APAR PN81331 Services level fix required? required? --------------- --------- ---------------- ------------- AFP Upload using SNA V1R4 no no --------------- --------- ---------------- ------------- AFP Upload using TCP/IP V1R5 yes yes --------------------------------------------------------- 3. The prerequisites for the SNA and TCP/IP programs differ because the AFP Upload TCP/IP program uses PL/I multi-tasking capabilities whereas the AFP Upload SNA program does not. (APPC/MVS provides the multi-tasking capabilities required by the AFP Upload SNA program.) Language Environment for MVS has an error in its PL/I multi-tasking support. The error is addressed by APAR PN81331. You must install the fix for this APAR to run AFP Upload using TCP/IP. You do not need this APAR fix to run AFP Upload using SNA. 4. The PL/I multi-tasking support in Language Environment requires the OpenEdition MVS Services of MVS/ESA SP V5. So, the AFP Upload TCP/IP program requires that OpenEdition MVS Services be running. The AFP Upload SNA program does not. 5. For AFP Upload using SNA, please note that the AUPDDDEF sample JCL on the product tape and sample TP profile on the product tape and in our configuration guide assume that the PL/I V2R3 libraries are used. A few changes are required to use the Language Environment. Here are the changes we made: 1. AUPDDDEF sample JCL : Use ADD DDDEF (PLIBASE) DATASET(CEE.V1R4M0.SCEELKED) SHR. ADD DDDEF (SIBMBASE) DATASET(CEE.V1R4M0.SCEELKED) SHR. instead of ADD DDDEF (PLIBASE) DATASET(PLI.V2R3M0.PLIBASE) SHR. ADD DDDEF (SIBMBASE) DATASET(PLI.V2R3M0.SIBMBASE) SHR. 2. APPC/MVS TP profile sample JCL : Use //STEP EXEC PGM=AUPSNAS //STEPLIB DD DSN=AUP.SAUPLOAD,DISP=SHR // DD DSN=CEE.V1R4M0.SCEERUN,DISP=SHR instead of //STEP EXEC PGM=AUPSNAS //STEPLIB DD DSN=AUP.SAUPLOAD,DISP=SHR // DD DSN=PLI.V2R3M0.PLILINK,DISP=SHR // DD DSN=PLI.V2R3M0.SIBMLINK,DISP=SHR 6. For AFP Upload using TCP/IP, please note that the AUPDDDEF sample JCL on the product tape and sample run JCL and PROC in our configuration guide assume that the PL/I V2R3 libraries are used. A few changes are required to use the Language Environment. Here are the changes we made: 1. AUPDDDEF sample JCL : Use ADD DDDEF (PLIBASE) DATASET(CEE.V1R5M3.SCEELKED) SHR. ADD DDDEF (SIBMBASE) DATASET(CEE.V1R5M3.SCEELKED) SHR. ADD DDDEF (PLITASK) DATASET(CEE.V1R5M3.SIBMTASK) SHR. instead of ADD DDDEF (PLIBASE) DATASET(PLI.V2R3M0.PLIBASE) SHR. ADD DDDEF (SIBMBASE) DATASET(PLI.V2R3M0.SIBMBASE) SHR. ADD DDDEF (PLITASK) DATASET(PLI.V2R3M0.PLITASK) SHR. 2. Sample run JCL : Use //STEP EXEC PGM=AUPTCPS //STEPLIB DD DSN=AUP.SAUPLOAD,DISP=SHR // DD DSN=CEE.V1R5M3.SCEERUN,DISP=SHR instead of //STEP EXEC PGM=AUPTCPS //STEPLIB DD DSN=AUP.SAUPLOAD,DISP=SHR // DD DSN=PLI.V2R3M0.PLILINK,DISP=SHR // DD DSN=PLI.V2R3M0.SIBMLINK,DISP=SHR 1. 97/02/03 1. The AFP Upload announcment and AFP Upload Configuration Guide Using SNA describe that the PL/I Version 2 Release 3 run time libraries are a required prerequisite. 2. Language Environment Version 1 Release 3 lacks several capabilities that are provided by PL/I V2R3 and used by AFP Upload. AFP Upload cannot be used with the Le/370 V1R3. 3. AFP Upload using SNA can be used with Language Environment for MVS Version 1 Release 4 or higher. Some changes need to be made to our SMP/E sample JCL and the JCL in our APPC/MVS TP profile. ** Please note that the AUPDDDEF sample JCL on the product tape and sample TP profile on the product tape and in our configuration guide assume that PL/I libraries are used. Here are the changes required to use the Language Environment. 1. AUPDDDEF sample JCL : Use ADD DDDEF (PLIBASE) DATASET(CEE.V1R4M0.SCEELKED) SHR. ADD DDDEF (SIBMBASE) DATASET(CEE.V1R4M0.SCEELKED) SHR. Instead of ADD DDDEF (PLIBASE) DATASET(PLI.V2R3M0.PLIBASE) SHR. ADD DDDEF (SIBMBASE) DATASET(PLI.V2R3M0.SIBMBASE) SHR. 2. APPC/MVS TP profile sample JCL: Use //STEP EXEC PGM=AUPSNAS //STEPLIB DD AUP.SAUPLOAD,DISP=SHR // DD DSN=CEE.V1R4M0.SCEERUN,DISP=SHR Instead of //STEP EXEC PGM=AUPSNAS //STEPLIB DD DSN=AUP.SAUPLOAD,DISP=SHR // DD DSN=PLI.V2R3M0.PLILINK,DISP=SHR // DD DSN=PLI.V2R3M0.SIBMLINK,DISP=SHR ************************************************************************ * 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. 97/06/06 PROBLEM: (OW27432) AFP UPLOAD USING TCP/IP V3R2 FAILS WITH MESSAGE ' TAKESOCKET ERROR = 113 ' USER AFFECTED: All AFP UPLOAD users that wish to use tcp/ip 3.2.0 RECOMMENDATION: INSTALL UW39048 ON VOLID 9706 ALSO INSTALL LE/370 APAR PN92107. 1. 97/02/03 PROBLEM: (OW21017) Provides the TCP/IP modules for AFP Upload. AUPTCPS USERS AFFECTED: All users who want to use TCP/IP protocols to communicate data. PTF UW30822 includes a hold action (++ HOLD) that describes a new requirement for an additional DDDEF. To apply the PTF you must bypass the hold. Bypassing the hold will cause SMP/E to issue warning message GIM42001W and to yield return code 04. Return code 04 due to message GIM42001W is correct. Please ensure that SMP/E did not issue warning messages other than GIM42001W. A series of the following messages may also received. They can be ignored. IEW2454W 9203 SYMBOL IBMLLIST UNRESOLVED. AUTOCALL (NCAL) SPECIFIED. The SMP/E logic for AFP Upload uses CALLLIB SMP/E first attempts to link a load module find that there are unresolved external references, which you cited. However, SMP/E links the load module again attempting to u CALLLIBS to resolve the external references the final link messages for each executable your held output indicated that the linker resolved all external references RECOMMENDATION: INSTALL UW30822 ON VOLID 9607 ************************************************************************ * 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. 11. 99/08/10 INTERDEPENDENT PRODUCTS: PSF for AIX Infoprint Manager for AIX PROBLEM: (IY02836) The AFP Uploadclienton AIX yields message "Printer needs key operator" when a TCP/IP connection is unexpectedly ended. It should provide a more useful message. USERS AFFECTED: All AFP Upload TCP/IP users RECOMMENDATION: Install the appropriate ptf (When available). 10. 99/08/10 INTERDEPENDENT PRODUCT: LE/370 PROBLEM: (PQ25448) LE produces no message or abend if the REGION size is too small; an AFP Upload subtask is ended without any visible indication. For TCP/IP users, closes the socket connection, causing the AFP Upload client on AIX to report a communication failure. USERS AFFECTED: All LE/370 users RECOMMENDATION: An LE/370 fix will be provided in a future release. Meanwhile, all AFP Upload customers who use LE/370 should specify runtimeoption 'storage(,,,20K)/' in the PARM parameter in their JCL EXEC statement. For example, EXEC PGM=AUPTCPS, PARM='STORAGE(,,,20K)/' or EXEC PGM=AUPTCPS, PARM='STORAGE(,,,20K)/CASE=MIXED' If the REGION size is too small, LE will end the program indicating User Code 4087 reason code 08. ( abendu4087 rc08 ) 9. 98/03/18 INTERDEPENDENT PRODUCT: OS PL/1 LIBRARY 566891101 PROBLEM: (PN68937) When starting AFP UPLOAD (AFPUPLD) an abend4093 rc78 (rc00000078) multitasking not permitted is received. USERS AFFECTED: All AFP UPLOAD running with pl/i runtime libraries. RECOMMENDATION: INSTALL un74369 ON VOLID 9503 8. 97/10/31 INTERDEPENDENT PRODUCT: TCP/IP 3.1.0 PROBLEM: (PN88517) ABEND0C4 in EZBNRNET after start of NCPROUTE in many NCP clients USERS AFFECTED: All AFP UPLOAD users RECOMMENDATION: INSTALL un94873 ON VOLID 9609 (HTCP310) 7. 97/10/31 INTERDEPENDENT PRODUCT: TCP/IP 3.1.0 PROBLEM: (PN92402) Takesocket errno 9 when unexpected OOB data is received and pops the select. Givesocket socket number is lost for any future use. USERS AFFECTED: All AFP UPLOAD users RECOMMENDATION: INSTALL uq01239 ON VOLID 9703 (HTCP310) Make sure un94873 and un94315 are instaled as well. 6. 97/10/31 INTERDEPENDENT PRODUCT: TCP/IP 3.1.0 PROBLEM: (PN87428) Vtam interface is not being cleaned up when client disconnects from defaultappl USERS AFFECTED: All AFP UPLOAD users RECOMMENDATION: INSTALL UN94315 ON VOLID 9608 (HTCP310) 5. 97/07/01 INTERDEPENDENT PRODUCT: LE/370 PROBLEM: (PN92107) ABENDU4091 RC05 or ABEND0C4 in CEEOPMU USERS AFFECTED: Users of le/370 1.5 and up RECOMMENDATION: INSTALL UQ00442 ON VOLID 9701 (HMWL510) INSTALL UQ00443 ON VOLID 9701 (HMWL610) INSTALL UQ00444 ON VOLID 9701 (HMWL710) 4. 97/06/06 INTERDEPENDANT PRODUCT: TCP/IP 3.2.0 PROBLEM: (PN88249) EZASMI macros assembled under TCP/IP 3.1.0 and used with TCP/IP 3.2.0 fail. USER AFFECTED: All AFP UPLOAD users RECOMMENDATIONS: INSTALL UN94504 ON VOLID 9608 (HTCP320) 3. 97/06/06 INTERDEPENDANT PRODUCT: TCP/IP 3.2.0 PROBLEM: (PN90475) Tcp/ip macro EZASMI does not set r15 to 0 on return USER AFFECTED: All AFP UPLOAD users RECOMMENDATIONS: INSTALL UN99683 ON VOLID 9701 (HTCP320) 2. 97/03/06 INTERDEPENDENT PRODUCT: OS PL/I LIBRARY 566891101 PROBLEM: (PN20167) APAR PN20167 is required to support AFP Upload multitasking Support. RECOMMENDATION: INSTALL UN25179 ON VOLID 9206 (HHL2302) 1. 97/02/03 INTERDEPENDENT PRODUCT: LE 370 PROBLEM: (PN81331) APAR PN81331 is required to support AFP Upload using TCP/IP with Languange Environment 370. * Please note that the LE/370 facilities used by the TCP/IP version of AFP Upload require that Open Edition Services be installed on the MVS/ESA system. The LE/370 facilities used by the SNA version of AFP Upload do not require Open Edition Services. ************************************************************************ * 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) * ************************************************************************ INFO APAR II11127 --PTF INCLUDE LIST-- --PTF EXCLUDE LIST-- --PE APAR LIST-- II11127