IBM Support

Upgrade AFPTOOLBOX, Subset MVS/H23A100

  Preventive Service Planning

Upgrade AFPTOOLBOX, Subset MVS/H23A100

Service Recommendation Summary Installation Information
Documentation Changes General Information
Service Recommendations Cross Product Dependencies
Informational/Documentation PTF/APAR Reference Lists


Upgrade AFPTOOLBOX, Subset MVS/H23A100:

This subset contains installation information for AFP Toolbox
Version 1, Release 1, Modification 0 for MVS.


Change Summary

DATE LAST CHANGED SECTION 1. 16/01/27 INSTALLATION INFORMATION 2. 97/10/01 DOCUMENTATION CHANGES 3. 97/11/18 GENERAL INFORMATION 4. 14/06/30 SERVICE RECOMMENDATIONS 5. 02/02/12 CROSS PRODUCT DEPENDENCIES


Service Recommendation Summary

DATE APAR PTF VOLID COMMENTS 4 14/06/30 PI17494 UI19152 1406 HIPER AFP TOOLBOX PERFORMANCE 3 99/12/23 PQ30980 UQ35196 9912 HIPER REBUILD OF THE MVS TOOLBOX 2 98/11/02 PQ19382 UQ22925 9810 HIPER MSGCEE3204S SYSTEM 1. 97/11/18 PQ10026 UQ11500 9711 HIPER AFPTOOLBOX FOR MVS OS/390


Installation Information

THIS SECTION CONTAINS CHANGES TO THE PRODUCT'S PROGRAM DIRECTORY. 4. 16/01/27 SECTION OF PROG. DIRECTORY REFERENCED: 7.2 When customers upgrade their systems and move to Enterprise COBOL V5.1 or higher from a lower level of Enterprise COBOL, there are changes required for the sample job in SATXJCL(ATXCBSAM). The new level of COBOL compiler requires additional DD names on the compile step and no longer supports the pre-linker. Possible error messages with the old sample JCL include: IEW2456E, IEW2606S, IEC130I The suggested change is to follow the example below which uses the IGWCLG catalogued procedure supplied by COBOL 5.1 and above, rather than the JCL given in SATXJCL(ATXCBSAM). The JCL in ATXCBSAM can still be used for earlier levels of Enterprise COBOL. Follow this example instead: //jobname JOB (acctnum,'acct info'),'ATXCBSAM C5____', // NOTIFY=&SYSUID, // CLASS=A,MSGCLASS=T,MSGLEVEL=(1,1),TIME=(5,00), // REGION=0M //* //* 11/13/15 NEW JCL TO WORK WITH ENTERPRISE COBOL 5.1.1 & GREATER //* REMOVED PRE-LINK STEP. //* NOW USING COMPILE/LINK/GO PROC //* POINT TO THE LIBRARY WITH THE COBOL PROCS //* //xxxTST2 JCLLIB ORDER=IGY.SIGYPROC //* //* SAMPLE JCL TO COMPILE, LINK & RUN //* THE SAMPLE COBOL PROGRAM ATXSSEED, THE //* SUPER SUN SEEDS EXAMPLE //*CHANGES FOR ENTERPRISE COBOL V5R1M1 //* //* //FILEOUT SET FILEOUT=xxxx.TBOX.ATXCBTS2.AFP //SYSDEFSD SET SYSDEFSD=xxx.TBOX.SYSDEFSD //* //* CLEANUP ANY OLD LEFTOVER OUTPUT DATASETS FROM THIS JOB //* //DELETE EXEC PGM=IEFBR14 //DD1 DD DISP=(MOD,DELETE),SPACE=(TRK,(0)),UNIT=SYSALLDA, // DSN=&FILEOUT. //DD2 DD DISP=(MOD,DELETE),SPACE=(TRK,(0)),UNIT=SYSALLDA, // DSN=&SYSDEFSD. //* //* //* CALL THE COBOL PROC TO COMPILE, LINK, AND GO //* //CLG EXEC PROC=IGYWCLG, *** COBOL 5.1.1 PROC // LNGPRFX='IGY', // PARM.COBOL='OBJECT,LIST,RENT,PGMNAME(LONGMIXED)', // PARM.LKED='LIST,AMODE=31,RMODE=ANY,RENT,CALL,CASE=MIXED,DYNAM=DLL', // GOPGM=ATXCBTST //* //* COBOL COMPILE STEP //* //COBOL.SYSIN DD DISP=SHR,DSN=ATX.SATXSAMP(ATXCBTST) //COBOL.SYSLIB DD DISP=SHR,DSN=ATX.SATXSAMP //* //* BINDER STEP //* //LKED.SYSLIB DD // DD // DD DISP=SHR,DSN=ATX.SATXIMP // DD DISP=SHR,DSN=ATX.SATXLOAD // DD DSN=CEE.SCEECPP,DISP=SHR //LKED.CBLDECK DD DSN=ATX.SATXIMP,DISP=SHR //LKED.SDECK DD DSN=ATX.SATXIMP,DISP=SHR //LKED.SYSDEFSD DD DISP=(NEW,CATLG),DSN=&SYSDEFSD., // UNIT=SYSALLDA,SPACE=(CYL,(1,1)), // DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=0) //LKED.SYSIN DD * INCLUDE CBLDECK(ATXCOBOL) INCLUDE SDECK(ATXTBOX) AUTOCALL SDECK NAME ATXCBTST(R) /* //* //* GO STEP //* //GO.STEPLIB DD // DD // DD DISP=SHR,DSN=ATX.SATXLOAD //GO.FNTLIBDD DD DSN=SYS1.FONTLIBB,DISP=SHR //GO.TBXFNTDD DD DSN=xxx.TBOX.FONTS,DISP=SHR //GO.DATAFILE DD DSN=ATX.SATXDATA(SUNDATA),DISP=SHR //GO.FILEOUT DD DSN=&FILEOUT.,DISP=(NEW,CATLG), // UNIT=SYSALLDA,SPACE=(CYL,(1,1)), // DCB=(DSORG=PS,RECFM=VBM,LRECL=8205,BLKSIZE=8209 ) // //* END OF JOB 3. 97/11/21 SECTION OF PROG. DIRECTORY REFERENCED: SECTION 7.1.1 PG 29 Do not use the 3800 font library SYS1.FONTLIB as input for the flip index. The program directory states that you can use the same font library concatenantion for the flip index that is used for PSF/MVS. That is not correct. Do not use libraries that contain 3800 fonts. Message: Assertion failed: index < lenght , file:'JLS.AFPTK.CPP(ATXBUFF) line 325 EDC6006E The raise() function was issued for the signal SIGABRT. maybe issued if the 3800 fonts SYS1.FONTLIB is included in the FLIP index. 2. 97/10/09 If you receive compile errors trying to run the COBOL IVP program (ATXCBTST), modify line 456 (MOVE 'N10' TO TERMS-IN.) and line 776 (MOVE 'TOTAL DUE' TO AFP-CHARACTER -STRING.) to change the single quotes to double quotes. 1. 97/07/28 The MVS program directory describes how to run FLIP (ATXFLMVS) on p 29. The first ordered list item talks about the FONTLIBO DD statement being required for concatenated font librarie. This bullet should be a paragraph instead, outside of the list, because FONTLIBO is ALWAYS required when FLIP is run, even if it is the same data set as the font library itself. On p 30, the instructions need to be modified (step 3) to state that FONTLIBO is always required. Finally, in the ATXFLIP JCL member, return code 36 should be updated to state that this RC may also be received if the FONTLIBO DD statement is missing or the data set cannot be written to.


Documentation Changes

THIS SECTION OUTLINES MAJOR ERRORS IN THE PRODUCT'S PUBLISHED DOCUMENTATION. 2. 97/10/01 The Program Directory for AFP Toolbox for MVS, Chapter 5.2.3 Programming Requirements The 4th bullet is incorrect. *IBM COBOL for MVS Compiler (5688-197) Version 1 Release 5 or higher Should read: *IBM COBOL for MVS Compiler (5688-197) Version 1 Release 2 or higher 1. 97/01/21 Text Orientations documentedunder the SetTextOrientation call in the C chapter and C++ chapters are incorrect. They should be: - I0B90_TO - I0B270_TO - I90B180_TO - I90B0_TO - I180B270_TO - I180B90_TO - I270B0_TO - I270B180_TO


General Information

THIS SECTION CONTAINS GENERAL INFORMATION, I.E. SYSGEN HINTS/TIPS. 7. 97/11/18 The IVP may fail with messages concerning the defining of resources. Example: AFPDEFINEFONT call failed with return code -14. The last step of the IVP may fail with a CBLWriteString failed with return code 15. Apply apar pq07142 ptf uq08195 on volid 9708. 6. 97/01/21 COBOL sample ATXCBSAM uses ATXSLOGO which is an AFP page segment containing IOCA image. To print the output, you must send the output to a printer that supports IOCA image. You can also remove the CBLInclPseg from the sample program, or change the name of the segment that is included to one that will print on your system. 5. 97/01/21 ITEM DELETED 97/02/20 4. 97/01/21 Toolbox on MVS does not support double byte fonts. 3. 97/01/21 Toolbox on MVS cannot read the DCFINDEX member created by the Document Composition Facility (DCF) licensed program, or the AFPINDEX member created by the AFP API. 2. 97/01/21 The AFPWriteString function writes SIA (Set Intercharacter Adjust) PTOCA text control when the intercharacter increment value is greater than 0. Old printers like the d/t3820 and d/t3800-3 will issue an error for the SIA and will not print the page. 1. 97/01/21 You cannot print the output from the C++ sample output with PSF/MVS directly. You can route it to PSF for AIX or use the modified AFRREBLK program which supports fixed block records. The modified AFRREBLK is available on the IBM Printing Systems Web site: (ftp.software.ibm.com/printers) in /printers/products/toolbox/mvs


Service Recommendations

4 14/06/30 PROBLEM: (PI17494) AFP TOOLBOX PERFORMANCE PROBLEM BECAUSE FIELDS WERE NOT DROPPED. . USERS AFFECTED: ALL USERS CREATING TABLES. RECOMMENDATION: INSTALL UI19152 ON VOLID 1406 (H23A100) 3 99/12/23 PROBLEM: (PQ30980) REBUILD OF THE MVS TOOLBOX ATXCOBLH COPYBOOK FOR AFPSETEXTENDEDCOLOR. INCLUDES FIXES FOR APAR PQ31053 AND PQ26180 USERS AFFECTED: All AFP Toolbox users. RECOMMENDATION: INSTALL UQ35196 ON VOLID 9912 (H23A100) 2 98/11/02 PROBLEM: (PQ19382) MSGCEE3204S SYSTEM DETECTED A PROTECTION EXCEPTION WHEN PTX RECORD EXCEEDS 8K OF DATA ON A PAGE USERS AFFECTED: All AFP Toolbox users on MVS or OS/390. RECOMMENDATION: INSTALL UQ22925 ON VOLID 9810 (H23A100) 1. 97/11/18 PROBLEM: (PQ10026) AFPTOOLBOX FOR MVS OS/390 SUPPORT USERS AFFECTED: All OS/390 Toolbox users. RECOMMENDATION: INSTALL UQ11500 ON VOLID 9711


Cross Product Dependencies

THIS SECTION CONTAINS INFORMATION THAT IS DEPENDENT UPON ANOTHER PRODUCT OTHER THAN THIS SUBSET ID. 1. 02/02/12 INTERDEPENDENT PRODUCT: C/C++ for MVS 56551210A PROBLEM: EDC4015 Object Resolution errors running the AFP Toolbox IVP. After appling uq61158 or uq61159. Fix by apar PQ57714. USERS AFFECTED: All AFP TOOLBOX for MVS users RECOMMENDATION: INSTALL UQ63206 ON VOLID F202 (JLB7713)


Informational / Documentation

THESE INFO APARs are attached II10133 II13169


PTF / APAR Reference Lists

PTF Include List
PTF Exclude List
PE APAR List
II10133 II13169


End of Upgrade AFPTOOLBOX , Subset MVS/H23A100 , as of 2016/01/28.



Document information

More support for: z/OS family

Modified date: 2016-01-27