Skip to main content

TPF : Support : Maintenance

Skip to: Abstract | Comments | Solution | Migration | Download

APAR NUMBER:  PK20132                         
PRODUCT:  z/TPFDF
FUNCTIONAL AREA:  TPFDF CENTRAL DATABASE ROUTINES
SHIPPED IN PUT:  2
 

ABSTRACT:
z/TPFDF code updates for return-optional system errors.
 
PACKAGE CONTENTS:
Source Segments:
(C) tpfdf/include/c_cdfmac.h
(C) tpfdf/macro/dflnk.mac
(C) tpfdf/macro/ifl0df.mac
(C) tpfdf/rt/uac0.asm
(C) tpfdf/rt/uae0.asm
(C) tpfdf/rt/uag0.asm
(C) tpfdf/rt/uak0.asm
(C) tpfdf/rt/uan0.asm
(C) tpfdf/rt/uao0.asm
(C) tpfdf/rt/uap0.asm
(C) tpfdf/rt/uaq0.asm
(C) tpfdf/rt/uar0.asm
(C) tpfdf/rt/uas0.asm
(C) tpfdf/rt/uat0.asm
(C) tpfdf/rt/uau0.asm
(C) tpfdf/rt/uav0.asm
(C) tpfdf/rt/ub10.asm
(C) tpfdf/rt/ub20.asm
(C) tpfdf/rt/ub30.asm
(C) tpfdf/rt/ub40.asm
(C) tpfdf/rt/ub60.asm
(C) tpfdf/rt/ub70.asm
(C) tpfdf/rt/ub80.asm
(C) tpfdf/rt/ub90.asm
(C) tpfdf/rt/uba0.asm
(C) tpfdf/rt/ubb0.asm
(C) tpfdf/rt/ubc0.asm
(C) tpfdf/rt/ube0.asm
(C) tpfdf/rt/ubf0.asm
(C) tpfdf/rt/ubg0.asm
(C) tpfdf/rt/ubi0.asm
(C) tpfdf/rt/ubj0.asm
(C) tpfdf/rt/ubk0.asm
(C) tpfdf/rt/ubl0.asm
(C) tpfdf/rt/ubm0.asm
(C) tpfdf/rt/ubo0.asm
(C) tpfdf/rt/ubp0.asm
(C) tpfdf/rt/ufg0.asm
(C) tpfdf/rt/ufg1.asm
(C) tpfdf/rt/ufga.asm
(C) tpfdf/rt/ufgb.asm
(C) tpfdf/rt/ufgc.asm
(C) tpfdf/rt/ufgd.asm
(C) tpfdf/rt/ufge.asm
(C) tpfdf/rt/ufgf.asm
(C) tpfdf/rt/ufgg.asm
(C) tpfdf/rt/ufgh.asm
(C) tpfdf/rt/ufgi.asm
(C) tpfdf/rt/ufgj.asm
(C) tpfdf/rt/ufgl.asm
(C) tpfdf/rt/ufgm.asm
(C) tpfdf/rt/ufgn.asm
(C) tpfdf/rt/ufgo.asm
(C) tpfdf/rt/ufgp.asm
(C) tpfdf/rt/ufgq.asm
(C) tpfdf/rt/ufgr.asm
(C) tpfdf/rt/ufgs.asm
(C) tpfdf/rt/ufgt.asm
(C) tpfdf/rt/ufgu.asm
(C) tpfdf/rt/ufgv.asm
(C) tpfdf/rt/ufgw.asm
(C) tpfdf/rt/ufgx.asm
(C) tpfdf/rt/ufgy.asm
(C) tpfdf/rt/ufgz.asm
(C) tpfdf/rt/ufk1.c
 
Object Only Binaries:
None.
 
Configuration Independent Binaries:
(C) base/stdlib/libCTDF.so
(C) base/stdload/CTDF.so
(C) tpfdf/obj/ufg0.o
(C) tpfdf/obj/ufg1.o
(C) tpfdf/obj/ufga.o
(C) tpfdf/obj/ufgb.o
(C) tpfdf/obj/ufgc.o
(C) tpfdf/obj/ufgd.o
(C) tpfdf/obj/ufge.o
(C) tpfdf/obj/ufgf.o
(C) tpfdf/obj/ufgg.o
(C) tpfdf/obj/ufgh.o
(C) tpfdf/obj/ufgi.o
(C) tpfdf/obj/ufgj.o
(C) tpfdf/obj/ufgl.o
(C) tpfdf/obj/ufgm.o
(C) tpfdf/obj/ufgn.o
(C) tpfdf/obj/ufgo.o
(C) tpfdf/obj/ufgp.o
(C) tpfdf/obj/ufgq.o
(C) tpfdf/obj/ufgr.o
(C) tpfdf/obj/ufgs.o
(C) tpfdf/obj/ufgt.o
(C) tpfdf/obj/ufgu.o
(C) tpfdf/obj/ufgv.o
(C) tpfdf/obj/ufgw.o
(C) tpfdf/obj/ufgx.o
(C) tpfdf/obj/ufgy.o
(C) tpfdf/obj/ufgz.o
 
Support Files:
tpfdf/lst/CTDF.map
tpfdf/lst/ufg0.lst
tpfdf/lst/ufg1.lst
tpfdf/lst/ufga.lst
tpfdf/lst/ufgb.lst
tpfdf/lst/ufgc.lst
tpfdf/lst/ufgd.lst
tpfdf/lst/ufge.lst
tpfdf/lst/ufgf.lst
tpfdf/lst/ufgg.lst
tpfdf/lst/ufgh.lst
tpfdf/lst/ufgi.lst
tpfdf/lst/ufgj.lst
tpfdf/lst/ufgl.lst
tpfdf/lst/ufgm.lst
tpfdf/lst/ufgn.lst
tpfdf/lst/ufgo.lst
tpfdf/lst/ufgp.lst
tpfdf/lst/ufgq.lst
tpfdf/lst/ufgr.lst
tpfdf/lst/ufgs.lst
tpfdf/lst/ufgt.lst
tpfdf/lst/ufgu.lst
tpfdf/lst/ufgv.lst
tpfdf/lst/ufgw.lst
tpfdf/lst/ufgx.lst
tpfdf/lst/ufgy.lst
tpfdf/lst/ufgz.lst
 
OTHER BINARIES TO BUILD:
(C) <sys>/lib/libUTDF.so
(C) <sys>/load/UFK0.so
(C) <sys>/load/UTDF.so
(C) <sys>/obj/uac0.o
(C) <sys>/obj/uae0.o
(C) <sys>/obj/uag0.o
(C) <sys>/obj/uak0.o
(C) <sys>/obj/uan0.o
(C) <sys>/obj/uao0.o
(C) <sys>/obj/uap0.o
(C) <sys>/obj/uaq0.o
(C) <sys>/obj/uar0.o
(C) <sys>/obj/uas0.o
(C) <sys>/obj/uat0.o
(C) <sys>/obj/uau0.o
(C) <sys>/obj/uav0.o
(C) <sys>/obj/ub10.o
(C) <sys>/obj/ub20.o
(C) <sys>/obj/ub30.o
(C) <sys>/obj/ub40.o
(C) <sys>/obj/ub60.o
(C) <sys>/obj/ub70.o
(C) <sys>/obj/ub80.o
(C) <sys>/obj/ub90.o
(C) <sys>/obj/uba0.o
(C) <sys>/obj/ubb0.o
(C) <sys>/obj/ubc0.o
(C) <sys>/obj/ube0.o
(C) <sys>/obj/ubf0.o
(C) <sys>/obj/ubg0.o
(C) <sys>/obj/ubi0.o
(C) <sys>/obj/ubj0.o
(C) <sys>/obj/ubk0.o
(C) <sys>/obj/ubl0.o
(C) <sys>/obj/ubm0.o
(C) <sys>/obj/ubo0.o
(C) <sys>/obj/ubp0.o
(C) <sys>/obj/ufk1.o
 
PREREQUISITE APARS IN APPLICATION ORDER:

tpfdf/include/c_cdfmac.h
PK14388(2) PK15847(2) PK20132(2) 

tpfdf/macro/dflnk.mac
PK07058(1) PK13183(2) PK20132(2) 

tpfdf/macro/ifl0df.mac
PK20132(2) 

tpfdf/rt/uac0.asm
PK20132(2) 

tpfdf/rt/uae0.asm
PK07058(1) PK20132(2) 

tpfdf/rt/uag0.asm
PK07621(1) PK06927(2) PK20132(2) 

tpfdf/rt/uak0.asm
PK20132(2) 

tpfdf/rt/uan0.asm
PK20132(2) 

tpfdf/rt/uao0.asm
PK12199(2) PK20132(2) 

tpfdf/rt/uap0.asm
PK09149(1) PK08095(2) PK20132(2) 

tpfdf/rt/uaq0.asm
PK20132(2) 

tpfdf/rt/uar0.asm
PK20132(2) 

tpfdf/rt/uas0.asm
PK20132(2) 

tpfdf/rt/uat0.asm
PK05909(1) PK20132(2) 

tpfdf/rt/uau0.asm
PK08095(2) PK20132(2) 

tpfdf/rt/uav0.asm
PK07853(2) PK20132(2) 

tpfdf/rt/ub10.asm
PK20892(2) PK20132(2) 

tpfdf/rt/ub20.asm
PK20132(2) 

tpfdf/rt/ub30.asm
PK20132(2) 

tpfdf/rt/ub40.asm
PK20132(2) 

tpfdf/rt/ub60.asm
PK20132(2) 

tpfdf/rt/ub70.asm
PK20132(2) 

tpfdf/rt/ub80.asm
PK20132(2) 

tpfdf/rt/ub90.asm
PK20132(2) 

tpfdf/rt/uba0.asm
PK20132(2) 

tpfdf/rt/ubb0.asm
PK07621(1) PK20132(2) 

tpfdf/rt/ubc0.asm
PK20132(2) 

tpfdf/rt/ube0.asm
PK07621(1) PK20132(2) 

tpfdf/rt/ubf0.asm
PK20132(2) 

tpfdf/rt/ubg0.asm
PK20132(2) 

tpfdf/rt/ubi0.asm
PK20132(2) 

tpfdf/rt/ubj0.asm
PK20132(2) 

tpfdf/rt/ubk0.asm
PK12199(2) PK20132(2) 

tpfdf/rt/ubl0.asm
PK20132(2) 

tpfdf/rt/ubm0.asm
PK20132(2) 

tpfdf/rt/ubo0.asm
PK07621(1) PK20132(2) 

tpfdf/rt/ubp0.asm
PK09496(1) PK20132(2) 

tpfdf/rt/ufg0.asm
PK20132(2) 

tpfdf/rt/ufg1.asm
PK20132(2) 

tpfdf/rt/ufga.asm
PK05895(1) PK14387(2) PK20132(2) 

tpfdf/rt/ufgb.asm
PK20132(2) 

tpfdf/rt/ufgc.asm
PK20132(2) 

tpfdf/rt/ufgd.asm
PK20132(2) 

tpfdf/rt/ufge.asm
PK05895(1) PK20132(2) 

tpfdf/rt/ufgf.asm
PK20132(2) 

tpfdf/rt/ufgg.asm
PK20132(2) 

tpfdf/rt/ufgh.asm
PK05895(1) PK06927(2) PK14384(2) PK20132(2) 

tpfdf/rt/ufgi.asm
PK20132(2) 

tpfdf/rt/ufgj.asm
PK20132(2) 

tpfdf/rt/ufgl.asm
PK20132(2) 

tpfdf/rt/ufgm.asm
PK20132(2) 

tpfdf/rt/ufgn.asm
PK06657(1) PK12956(2) PK20132(2) 

tpfdf/rt/ufgo.asm
PK06657(1) PK20132(2) 

tpfdf/rt/ufgp.asm
PK20132(2) 

tpfdf/rt/ufgq.asm
PK20132(2) 

tpfdf/rt/ufgr.asm
PK05895(1) PK20132(2) 

tpfdf/rt/ufgs.asm
PK20132(2) 

tpfdf/rt/ufgt.asm
PK20132(2) 

tpfdf/rt/ufgu.asm
PK14388(2) PK14387(2) PK15847(2) PK20132(2) 

tpfdf/rt/ufgv.asm
PK20132(2) 

tpfdf/rt/ufgw.asm
PK20132(2) 

tpfdf/rt/ufgx.asm
PK20132(2) 

tpfdf/rt/ufgy.asm
PK20132(2) 

tpfdf/rt/ufgz.asm
PK20132(2) 

tpfdf/rt/ufk1.c
PK20132(2) 

<sys>/lib/libUTDF.so
PK06657(1) PK05909(1) PJ30389(1) PK08477(1) PK07058(1) PK09151(1)
PK09496(1) PK07621(1) PK09149(1) PK09153(1) PK07853(2) PK08095(2)
PK10215(2) PK13183(2) PK06927(2) PK12199(2) PK20892(2) PK20132(2) 

<sys>/load/UFK0.so
PK20132(2) 

<sys>/load/UTDF.so
PK06657(1) PK05909(1) PJ30389(1) PK08477(1) PK07058(1) PK09151(1)
PK09496(1) PK07621(1) PK09149(1) PK09153(1) PK07853(2) PK08095(2)
PK10215(2) PK13183(2) PK06927(2) PK12199(2) PK20892(2) PK20132(2) 

<sys>/obj/uac0.o
PK13183(2) PK20132(2) 

<sys>/obj/uae0.o
PK07058(1) PK13183(2) PK20132(2) 

<sys>/obj/uag0.o
PK07621(1) PK13183(2) PK06927(2) PK12199(2) PK20132(2) 

<sys>/obj/uak0.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/uan0.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/uao0.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/uap0.o
PK09149(1) PK08095(2) PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/uaq0.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/uar0.o
PK13183(2) PK20132(2) 

<sys>/obj/uas0.o
PK13183(2) PK20132(2) 

<sys>/obj/uat0.o
PK05909(1) PK13183(2) PK20132(2) 

<sys>/obj/uau0.o
PK08095(2) PK13183(2) PK20132(2) 

<sys>/obj/uav0.o
PK07853(2) PK13183(2) PK20132(2) 

<sys>/obj/ub10.o
PK13183(2) PK20892(2) PK20132(2) 

<sys>/obj/ub20.o
PK13183(2) PK20132(2) 

<sys>/obj/ub30.o
PK13183(2) PK20132(2) 

<sys>/obj/ub40.o
PK13183(2) PK20132(2) 

<sys>/obj/ub60.o
PK13183(2) PK20132(2) 

<sys>/obj/ub70.o
PK13183(2) PK20132(2) 

<sys>/obj/ub80.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/ub90.o
PK13183(2) PK20132(2) 

<sys>/obj/uba0.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/ubb0.o
PK07621(1) PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/ubc0.o
PK13183(2) PK20132(2) 

<sys>/obj/ube0.o
PK07621(1) PK13183(2) PK20132(2) 

<sys>/obj/ubf0.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/ubg0.o
PK13183(2) PK20132(2) 

<sys>/obj/ubi0.o
PK13183(2) PK20132(2) 

<sys>/obj/ubj0.o
PK13183(2) PK20132(2) 

<sys>/obj/ubk0.o
PK13183(2) PK12199(2) PK20132(2) 

<sys>/obj/ubl0.o
PK13183(2) PK20132(2) 

<sys>/obj/ubm0.o
PK13183(2) PK20132(2) 

<sys>/obj/ubo0.o
PK07621(1) PK13183(2) PK20132(2) 

<sys>/obj/ubp0.o
PK09496(1) PK13183(2) PK20132(2) 

<sys>/obj/ufk1.o
PK20132(2) 

base/stdlib/libCTDF.so
PK06657(1) PK05895(1) PK08735(1) PK10134(2) PK06927(2) PK12956(2)
PK14384(2) PK14388(2) PK14387(2) PK15847(2) PK20132(2) 

base/stdload/CTDF.so
PK06657(1) PK05895(1) PK08735(1) PK10134(2) PK06927(2) PK12956(2)
PK14384(2) PK14388(2) PK14387(2) PK15847(2) PK20132(2) 

tpfdf/obj/ufg0.o
PK20132(2) 

tpfdf/obj/ufg1.o
PK20132(2) 

tpfdf/obj/ufga.o
PK05895(1) PK14387(2) PK20132(2) 

tpfdf/obj/ufgb.o
PK20132(2) 

tpfdf/obj/ufgc.o
PK20132(2) 

tpfdf/obj/ufgd.o
PK20132(2) 

tpfdf/obj/ufge.o
PK05895(1) PK20132(2) 

tpfdf/obj/ufgf.o
PK20132(2) 

tpfdf/obj/ufgg.o
PK20132(2) 

tpfdf/obj/ufgh.o
PK05895(1) PK06927(2) PK14384(2) PK20132(2) 

tpfdf/obj/ufgi.o
PK20132(2) 

tpfdf/obj/ufgj.o
PK08735(1) PK10134(2) PK20132(2) 

tpfdf/obj/ufgl.o
PK20132(2) 

tpfdf/obj/ufgm.o
PK20132(2) 

tpfdf/obj/ufgn.o
PK06657(1) PK12956(2) PK20132(2) 

tpfdf/obj/ufgo.o
PK06657(1) PK20132(2) 

tpfdf/obj/ufgp.o
PK20132(2) 

tpfdf/obj/ufgq.o
PK20132(2) 

tpfdf/obj/ufgr.o
PK05895(1) PK20132(2) 

tpfdf/obj/ufgs.o
PK20132(2) 

tpfdf/obj/ufgt.o
PK20132(2) 

tpfdf/obj/ufgu.o
PK14388(2) PK14387(2) PK15847(2) PK20132(2) 

tpfdf/obj/ufgv.o
PK20132(2) 

tpfdf/obj/ufgw.o
PK20132(2) 

tpfdf/obj/ufgx.o
PK20132(2) 

tpfdf/obj/ufgy.o
PK20132(2) 

tpfdf/obj/ufgz.o
PK20132(2) 
 

COMMENTS:
Some z/TPFDF exit dumps should be changed to optionally return control
to the application when a system error has occurred. Rather than always
exiting, the dump should pass a numeric return code back to the
application.
 

SOLUTION:
Dozens of z/TPFDF exit dumps were changed to optionally return control
back to the application when a system error has occurred. These exit
dumps will now pass a numeric return code back to the application for
each dump taken.
 
COREQS:
z/TPF APAR PJ30993
 

MIGRATION CONSIDERATIONS:
When using the return-optional system errors function in assembler 
applications, the size of each TPFDF API macro will expand.  For 
information on using the return-optional system errors function, see 
z/TPF and z/TPFDF Migration Guide: PUT 02 and Later, and z/TPFDF 
Programming Concepts and Reference
 
BUILD COMMANDS AND INSTRUCTIONS:
#maketpf commands for linux
maketpf -f CTDF ufg0.o ufg1.o ufga.o ufgb.o ufgc.o ufgd.o ufge.o ufgf.o
ufgg.o ufgh.o ufgi.o ufgj.o ufgl.o ufgm.o ufgn.o ufgo.o ufgp.o ufgq.o
ufgr.o ufgs.o ufgt.o ufgu.o ufgv.o ufgw.o ufgx.o ufgy.o ufgz.o
maketpf -f UTDF uac0.o uae0.o uag0.o uak0.o uan0.o uao0.o uap0.o uaq0.o
uar0.o uas0.o uat0.o uau0.o uav0.o ub10.o ub20.o ub30.o ub40.o ub60.o
ub70.o ub80.o ub90.o uba0.o ubb0.o ubc0.o ube0.o ubf0.o ubg0.o ubi0.o
ubj0.o ubk0.o ubl0.o ubm0.o ubo0.o ubp0.o
maketpf -f UFK0 ufk1.o
TPF_VERIFY_LINK_REFS=NO maketpf CTDF link
maketpf UTDF link
maketpf UFK0 link
maketpf CTDF link
 
UPDATED INFORMATION UNITS:
z/TPF and z/TPFDF Migration Guide: PUT 2 and Later
z/TPF and z/TPFDF Structured Programming Macros
z/TPF and z/TPFDF System Generation
z/TPF General Services
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/put2/PK20132.htm
APAR Package