|
| |
|
|
|
| |
TPF : Support : Maintenance : TPFDF
 |
SUBJECT: APAR NUMBER: PK02541
REFERENCE: AREA: TPFDF CENTRAL DATABASE ROUTINES
SEGMENT: SW00SR13 - RELEASE: TPFDF (Macro)
SEGMENT: SW02SR13 - RELEASE: TPFDF (Macro)
SEGMENT: UFBW13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBI13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBN13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB113 - RELEASE: TPFDF (Assembler)
Pre-requisite APARs are (TPF only) :
FOR SEGMENT SW00SR13 (Macro) - REL TPFDF
AN31299 PN05393 PN37569 PN38613 PN43714 PN46560 PN57526
PN61834 PN64313 PN71161 PN71348 PN73989 PN77016 PN76852
PN80488 PN83423 PN84757 PN87917 PN92097 PQ00790 PQ02145
PQ04911 PQ05189 PQ07995 PQ10797
PQ10084 PQ15475 PQ16897
PQ21506 PQ24625 PQ23091 PQ25824
PQ25825 PQ32209 PQ36911
PQ37963 PQ32210 PQ50275 PQ48551 PQ55601 PQ64252 PQ51955
PQ74483 PQ75887 PQ79066 PQ80141 PQ90430 PQ94935 PQ95818
PQ96246
FOR SEGMENT SW02SR13 (Macro) - REL TPFDF
PN05393 PN39344 PN49536 PN57526 PN61834 PN64313 PN67252
PN71161 PN73989 PN78104 PN78908 PN92097 PQ05189 PQ10797
PQ10084 PQ23091 PQ26888 PQ32209
PQ42097 PQ32210 PQ74483
PQ94935
FOR SEGMENT UFBW13 (Assembler) - REL TPFDF
PN73989 PN76765 PQ08078 PQ23091 PQ51339 PQ94935
FOR SEGMENT UWBI13 (Assembler) - REL TPFDF
PQ32210 PQ53452 PQ51955 PQ74483
FOR SEGMENT UWBN13 (Assembler) - REL TPFDF
PQ46459 PQ94935
FOR SEGMENT UWB113 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483 PQ75887 PQ80141 PQ83874 PQ94935
PQ96246
To be applied in the order listed for each segment.
ABSTRACT OF PROBLEM
___________________
Database corruption may occur along with other various problems
when migrating a TPFDF database to use FARF6. Furthermore,
certain TPFDF database types are not properly migrated.
COMMENTS ON PROBLEM
___________________
1. When performing a FARF6 migration (either changing the
format of headers or index references), the internal block
filing sequence is not correct. Furthermore, certain error
exit paths in the code will leave the subfile being migrated
in a partially migrated condition. Both of these problems
can lead to corruption in the database. In addition, if an
error occurs on a FINWC call, a CTL-3 system error may
result because base register R8 is not reset when WAITC is
called.
2. Databases with fixed size LRECs in either the data files or
the index files are not migrated properly because the code
assumes variable length LRECs.
3. TPFDF index files that have multiple embedded references
with an LREC (multi-slot index LRECs) are not properly
migrated. In some cases, index LRECs are migrated even
though the corresponding bit in the DBDEF (F6MIGIDX) is not
turned on.
4. For files that have the full backward chain option (SW00OP1
#BIT0) set, the backward chain values may not be correct
after a FARF6 migration.
5. Several miscellaneous problems have been corrected,
including:
a. The HOLD settings for chain blocks (SW00OP2 #BIT5) is
not taken into account for internal find and file com-
mands.
b. The wrong base register is being used for certain parts
of migration processing.
c. The value in SW00CFA is not always the same as the value
in SW00CFA8 when an application regains control after a
DBRST call.
d. The description for SW00OP5 #BIT1 is missing in the
ZUDFM TRACE W/n/OPT display.
e. Unnecessary code is generated for ALCS customers.
f. The text of system error DB0165 is incorrect. It refer-
ences an "LREC TRAILER" when it is supposed to reference
a "BLOCK TRAILER".
g. Miscellaneous comments in SW00SR and SW02SR are incor-
rect.
SOLUTION
________
Segment UWBN has been updated (unless otherwise noted) as
follows:
1. TPF Transaction Manager services (commit and rollback) are
now used to avoid filing records in an unwanted sequence,
and to avoid partially migrated data. When an error condi-
tion occurs, all changes to an individual subfile are rolled
back. In addition, WAITC processing has been adjusted to
ensure that R8 contains the correct program base. The
filing code has been moved into a subroutine for easier code
readability and maintainability.
2. The code now checks SW00ILT so that the appropriate LREC
length is used for both fixed size LRECs and variable length
LRECs.
3. Multi-slot index LREC handling is corrected.
4. The backward chain option is now checked in the migration
code so that the proper backward chain value is used
depending on whether a file uses full backward chains or
not.
5. Several miscellaneous corrections have been provided,
including:
a. The HOLD settings for prime and chain (SW00OP2 Bit4 and
Bit5) are used to determine the internal use of HOLD.
1
b. The correct base register is used.
c. SW00CFA is now updated appropriately on DBRST calls.
d. The description for SW00OP5 #BIT1 has been added to
segment UFBW.
e. The unnecessary code is only generated for TPF customers
in UWB1.
f. The text of system error DB0165 has been changed to ref-
erence a "BLOCK TRAILER".
g. Miscellaneous comments have been updated in SW00SR and
SW02SR.
DEPENDENCIES
____________
Related Segments Affected By This APAR.
_______________________________________
Segments to be assembled or compiled:
Segments to be link edited:
Load Modules to be loaded:
Migration Considerations
========================
The text of system error DB0165 has been changed to reflect what the
system action truly is. It has been changed from:
LREC TRAILER REMOVED DURING MIGRATION
to
BLOCK TRAILER REMOVED DURING MIGRATION
-- END APAR PK02541
Download file(s) using new Server:
Login once to access server, leave window open, then
click on link(s) below.
|
|
|
|
|
|
