Skip to: Abstract | Comments | Solution | Migration | Download
APAR NUMBER: PK59331 PRODUCT: z/TPFDF FUNCTIONAL AREA: TPFDF ZUDFM ROUTINES SHIPPED IN PUT: 5 ABSTRACT: Provide enhancements to the z/TPFDF ZUDFM utility. PACKAGE CONTENTS: Source Segments: (C) tpfdf/include/c_cdfmac.h (C) tpfdf/macro/db110.mac (C) tpfdf/macro/db125.mac (C) tpfdf/macro/db135.mac (C) tpfdf/macro/db140.mac (C) tpfdf/macro/db175.mac (C) tpfdf/macro/dbtab.mac (C) tpfdf/macro/dflnk.mac (C) tpfdf/macro/dftmc.mac (C) tpfdf/macro/dfuex.mac (C) tpfdf/macro/fmsgs.mac (C) tpfdf/macro/gr0vsr.mac (C) tpfdf/macro/ir0vdf.mac (C) tpfdf/macro/spm/#conx.mac (C) tpfdf/macro/spm/#stpf.mac (C) tpfdf/macro/spm/#stph.mac (C) tpfdf/macro/tpfdb.mac (N) tpfdf/macro/zudfmc.mac (C) tpfdf/rt/ufb2.asm (C) tpfdf/rt/ufb4.asm (C) tpfdf/rt/ufb6.asm (C) tpfdf/rt/ufb7.asm (C) tpfdf/rt/ufbf.asm (C) tpfdf/rt/ufbk.asm (C) tpfdf/rt/ufbl.asm (C) tpfdf/rt/ufbm.asm (C) tpfdf/rt/ufbv.asm (C) tpfdf/rt/ufc1.asm (C) tpfdf/rt/ufc6.asm (C) tpfdf/rt/ufca.asm (C) tpfdf/rt/ufcf.asm (C) tpfdf/rt/ufco.asm (C) tpfdf/rt/ufd1.asm Object Only Binaries: None. Configuration Independent Binaries: None. Support Files: None. OTHER BINARIES TO BUILD: YES (C) <sys>/load/UFB2.so (C) <sys>/load/UFB4.so (C) <sys>/load/UFB6.so (C) <sys>/load/UFB7.so (C) <sys>/load/UFBF.so (C) <sys>/load/UFBK.so (C) <sys>/load/UFBL.so (C) <sys>/load/UFBM.so (C) <sys>/load/UFBV.so (C) <sys>/load/UFC1.so (C) <sys>/load/UFC6.so (C) <sys>/load/UFCA.so (C) <sys>/load/UFCF.so (C) <sys>/load/UFCO.so (C) <sys>/load/UFD1.so (C) <sys>/obj/ufb2.o (C) <sys>/obj/ufb4.o (C) <sys>/obj/ufb6.o (C) <sys>/obj/ufb7.o (C) <sys>/obj/ufbf.o (C) <sys>/obj/ufbk.o (C) <sys>/obj/ufbl.o (C) <sys>/obj/ufbm.o (C) <sys>/obj/ufbv.o (C) <sys>/obj/ufc1.o (C) <sys>/obj/ufc6.o (C) <sys>/obj/ufca.o (C) <sys>/obj/ufcf.o (C) <sys>/obj/ufco.o (C) <sys>/obj/ufd1.o PREREQUISITE APARS IN APPLICATION ORDER: tpfdf/include/c_cdfmac.h PK14388(2) PK15847(2) PK20132(2) PK17586(3) tpfdf/macro/db125.mac PK43856(4) PK47200(4) tpfdf/macro/db175.mac PK17586(3) tpfdf/macro/dflnk.mac PK07058(1) PK13183(2) PK20132(2) PK48473(5) tpfdf/macro/tpfdb.mac PK08735(1) PK10134(2) PK06927(2) PK13276(3) PK17586(3) PK19576(4) PK29070(4) PK37474(4) tpfdf/rt/ufb2.asm PK50027(5) PK45691(5) tpfdf/rt/ufb6.asm PK14390(2) PK20130(3) tpfdf/rt/ufb7.asm PK25978(3) tpfdf/rt/ufbf.asm PK08095(2) tpfdf/rt/ufbk.asm PK16842(3) PK34860(4) PK47971(4) tpfdf/rt/ufbm.asm PK08095(2) PK16842(3) PK25978(3) PK34860(4) PK47971(4) PK50027(5) tpfdf/rt/ufbv.asm PK14390(2) tpfdf/rt/ufd1.asm PK07617(1) PK27914(3) <sys>/load/UFB2.so PK12199(2) PK50027(5) PK45691(5) <sys>/load/UFB6.so PK12199(2) PK14390(2) PK20130(3) <sys>/load/UFB7.so PK25978(3) PK37474(4) <sys>/load/UFBF.so PK08095(2) <sys>/load/UFBK.so PK12199(2) PK16842(3) PK34860(4) PK47971(4) <sys>/load/UFBM.so PK08095(2) PK12199(2) PK16842(3) PK25978(3) PK34860(4) PK47971(4) PK50027(5) <sys>/load/UFBV.so PK14390(2) <sys>/load/UFD1.so PK07617(1) PK12199(2) PK27914(3) <sys>/obj/ufb2.o PK12199(2) PK50027(5) PK45691(5) <sys>/obj/ufb6.o PK12199(2) PK14390(2) PK20130(3) <sys>/obj/ufb7.o PK25978(3) PK37474(4) <sys>/obj/ufbf.o PK08095(2) <sys>/obj/ufbk.o PK12199(2) PK16842(3) PK34860(4) PK47971(4) <sys>/obj/ufbm.o PK08095(2) PK12199(2) PK16842(3) PK25978(3) PK34860(4) PK47971(4) PK50027(5) <sys>/obj/ufbv.o PK14390(2) <sys>/obj/ufd1.o PK07617(1) PK12199(2) PK27914(3) COMMENTS: Several enhancements to the z/TPFDF ZUDFM utility are desired. (1) Improving the ZUDFM LOG display to include the processor ID where the ZUDFM DEF command with the INIT parameter specified was entered from. The ZUDFM DEF command rebuilds memory-based DBDEF tables that are processor unique. Therefore, it is important to know for which processor a DBDEF table was built. (2) Allowing logical records (LRECs) that exceed the maximum amount of text that you can enter on the console (command line) to be added with the ZUDFM ADD command. You can then use macro label set (MLS) support with the ZUDFM REPLACE command to easily populate the remaining fields. (3) Preventing accidental database corruption from ZUDFM commands because of residual subfile links. Subfile links should be deleted on failed ZUDFM commands. This ensures that no subsequent ZUDFM entries can be issued after a ZUDFM ACCESS, ZUDFM FAD, or ZUDFM FCH command (with a file address specified) fails until a valid command is entered. APIs can be provided so customer applications and utilities can also clear the subfile links between terminal addresses and z/TPFDF files. In addition, the z/TPF file system can be updated to clear subfile links whenever you log in to the z/TPF file system. (4) Allow additional characters (beyond traditional uppercase letters and numbers) to be displayed by ZUDFM commands. Users should be able to specify the content of the extended character set for their installation in a new user exit in macro DFUEX. SOLUTION: These improvements have been implemented in the z/TPFDF utility. See the Migration Considerations section of the APAR description for more information. COREQS: YES PJ32715 MIGRATION CONSIDERATIONS: YES Functional, automation, and operation changes: New z/TPFDF online messages UDFM0163E UDFM0164E UDFM0165E New z/TPFDF system errors DB0182 Changed z/TPFDF commands ZUDFM ACCESS ZUDFM ADD ZUDFM FAD ZUDFM FCH ZUDFM LOG Changed z/TPF commands ZPVFS LOGIN ZPVFS LOGON Application programming interface (API) changes: New z/TPFDF General Macros ZUDFMC New z/TPFDF General Functions df_clearlink User exit changes: New z/TPFDF user exits DFUEX Case 10 Coexistence, migration, and fallback considerations: After installing this APAR, enter the ZUDFM HELP BUILD command to update the z/TPFDF help database. BUILD COMMANDS AND INSTRUCTIONS: YES #maketpf commands for linux maketpf -f UFBF ufbf.o maketpf -f UFBK ufbk.o maketpf -f UFBL ufbl.o maketpf -f UFBM ufbm.o maketpf -f UFBV ufbv.o maketpf -f UFB2 ufb2.o maketpf -f UFB4 ufb4.o maketpf -f UFB6 ufb6.o maketpf -f UFB7 ufb7.o maketpf -f UFCA ufca.o maketpf -f UFCF ufcf.o maketpf -f UFCO ufco.o maketpf -f UFC1 ufc1.o maketpf -f UFC6 ufc6.o maketpf -f UFD1 ufd1.o maketpf UFBF link maketpf UFBK link maketpf UFBL link maketpf UFBM link maketpf UFBV link maketpf UFB2 link maketpf UFB4 link maketpf UFB6 link maketpf UFB7 link maketpf UFCA link maketpf UFCF link maketpf UFCO link maketpf UFC1 link maketpf UFC6 link maketpf UFD1 link UPDATED INFORMATION UNITS: YES z/TPF and z/TPFDF Migration Guide: PUT 2 and Later z/TPF Operations z/TPF System Installation Support Reference z/TPFDF Commands z/TPFDF Messages (System Error, Online, Offline) z/TPFDF Programming Concepts and Reference See your IBM representative if you need additional information. DOWNLOAD INSTRUCTIONS: http://www.ibm.com/software/htp/tpf/pages/maint.htm APAR URL: http://www.ibm.com/software/htp/tpf/ztpfmaint/put5/PK59331.htm APAR Package