|
| |
|
|
|
| |
TPF : Support : Maintenance : TPFDF
 |
SUBJECT: APAR NUMBER: PQ79120
REFERENCE: AREA: TPFDF CENTRAL DATABASE ROUTINES
SEGMENT: C$CDFEQ13 - RELEASE: TPFDF (C-Header)
SEGMENT: CDFEQ13 - RELEASE: TPFDF (Macro)
SEGMENT: DBERR13 - RELEASE: TPFDF (Macro)
SEGMENT: DBINI113 - RELEASE: TPFDF (Macro)
SEGMENT: DB13513 - RELEASE: TPFDF (Macro)
SEGMENT: DB14013 - RELEASE: TPFDF (Macro)
SEGMENT: DB15013 - RELEASE: TPFDF (Macro)
SEGMENT: TPFDB13 - RELEASE: TPFDF (Macro)
SEGMENT: UFGRSO13 - RELEASE: TPFDF (Copy)
Pre-requisite APARs are (TPF only) :
FOR SEGMENT C$CDFEQ13 (C-Header) - REL TPFDF
PN57135 PN61834 PN74617 PN83423 PN91920 PN91521 PQ08645
PQ25825 PQ28550 PQ32209 PQ32210 PQ47099 PQ60326 PQ65155
PQ74483 PQ75887
FOR SEGMENT CDFEQ13 (Macro) - REL TPFDF
PN57135 PN83423 PQ10088 PQ25825 PQ32210 PQ49042 PQ60326
PQ65155 PQ74483
FOR SEGMENT DBERR13 (Macro) - REL TPFDF
PN61834 PN83423 PQ32210 PQ74483
FOR SEGMENT DBINI113 (Macro) - REL TPFDF
PN50586 PQ25824 PQ32210 PQ60326 PQ51955 PQ74483
FOR SEGMENT DB13513 (Macro) - REL TPFDF
PQ07680 PQ32210 PQ60326 PQ60572
FOR SEGMENT DB14013 (Macro) - REL TPFDF
PN55118 PQ32210 PQ60326
FOR SEGMENT DB15013 (Macro) - REL TPFDF
PN38927 PN73989 PQ25824 PQ25825 PQ32210 PQ60326
FOR SEGMENT TPFDB13 (Macro) - REL TPFDF
PN30016 PN40034 PN41095 PN43714 PN55118 PN61834 PN64719
PN72208 PN73989 PN83423 PN86337 PN87893 PN89980 PQ06194
PQ13787 PQ27195 PQ25824 PQ25825
PQ32209 PQ36156 PQ32210
PQ47099 PQ60326 PQ60572 PQ61932 PQ51955 PQ74483 PQ75887
FOR SEGMENT UFGRSO13 (Copy) - REL TPFDF
PN84867 PN86534 PN91920 PQ00810 PQ24310 PQ32210 PQ55170
PQ60326 PQ74483 PQ75887
To be applied in the order listed for each segment.
ABSTRACT OF PROBLEM
___________________
With APAR PQ60326 applied, applications that used to perform
inline read operations in a large quantity may experience a per-
formance degradation due to the obsoletion of inline read
support in TPFDF.
COMMENTS ON PROBLEM
___________________
Prior to APAR PQ60326, TPFDF supported parameters to provide
inline code for performance critical operations. The TPFDF
fast-link mechanism evolved over the years such that the fast-
link calls were often as efficient as the inline code. Since
inline code was not as beneficial as it previously had been and
required additional costs (such as periodic required reassem-
blies of applications), this support was obsoleted by APAR
PQ60326. However, applications that perform a large number of
basic, sequential reads without keys that is a substantial part
of the overall processing could still take advantage of inline
processing.
SOLUTION
________
Support for the INLINE parameter on the DBRED macro and the
DFRED_INLINE parameter on the dfred() function has been restored
in the TPFDF product. When either of these parameters are spec-
ified, any active keys are turned off and TPFDF attempts to
locate the next record without entering the TPFDF central data-
base routines. If TPFDF is unable to retrieve the next LREC
inline, the central database routines will then be entered.
If the read operation encounters a large logical record (LLR),
or an LREC with an invalid item size (a variable length LREC
with a length less than 3, or an LREC whose current NAB plus
item NAB is greater than the block NAB), the central database
routines will be entered.
Segment DBINI1 has been updated to define the global inline
field. Segments DB135 and DB150 have been updated to process
read inline code. Segment DB140 has been updated to generate an
error if keys are specified with INLINE. Segments CDFEQ,
C$CDFEQ and UFGRSO were updated to provide the assembler INLINE
and C DFRED_INLINE options.
DEPENDENCIES
____________
Related Segments Affected By This APAR.
_______________________________________
Segments to be assembled or compiled:
On ALCS - UFGR
On TPF - UFGRIC
Segments to be link edited:
On ALCS - TPFDFC3
On TPF - CTDF
Migration Considerations
========================
C applications that already have the DFRED_INLINE parameter on the
dfred() function will continue to work and do not need to be recompiled.
Assembler applications that already have the INLINE parameter coded on
the DBRED macro must be reassembled to ensure compatibility with large
logical record (LLR) and File Address Reference Word 6 (FARF6) support.
(Reassembly is not required for compatibility with all other areas
within the TPFDF product, but is still recommended.)
The size of the DBRED macro expansion when used with the INLINE
parameter is larger with this APAR applied compared to the expansion
size before APAR PQ60326 was applied. Furthermore, the future size of
this macro expansion is not guaranteed. The object code from
applications that use DBRED with the inline parameter is not guaranteed
to be compatible with future TPFDF functionality; migration
considerations for such functionality may require application
reassembly.
-- END APAR PQ79120
Download file(s) using new Server:
Login once to access server, leave window open, then
click on link(s) below.
|
|
|
|
|
|
