SUBJECT: APAR NUMBER: PK03608
REFERENCE: AREA: TPFDF CENTRAL DATABASE ROUTINES
SEGMENT: IFL0DF13 - RELEASE: TPFDF (Dsect)
SEGMENT: SW00SR13 - RELEASE: TPFDF (Macro)
SEGMENT: TPFDB13 - RELEASE: TPFDF (Macro)
SEGMENT: UFGCSO13 - RELEASE: TPFDF (Copy)
SEGMENT: UFGESO13 - RELEASE: TPFDF (Copy)
SEGMENT: UWAC13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAO13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBC13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBK13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBN13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBP13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB113 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB913 - RELEASE: TPFDF (Assembler)
Pre-requisite APARs are (TPF only) :
FOR SEGMENT IFL0DF13 (Dsect) - REL TPFDF
PQ32210 PQ46459 PQ48551 PQ55170 PQ51955 PQ74483 PQ75887
PQ80141
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 PK02541
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
PQ79120 PQ96246
FOR SEGMENT UFGCSO13 (Copy) - REL TPFDF
PN84867 PN86534 PQ00810 PQ32209
FOR SEGMENT UFGESO13 (Copy) - REL TPFDF
PN84867 PN86534 PQ00810 PQ05192 PQ10088 PQ32209 PQ32210
PQ47054 PQ47099
FOR SEGMENT UWAC13 (Assembler) - REL TPFDF
PQ32210 PQ42198 PQ46459 PQ51955 PQ74483 PQ75887 PQ78532
PQ96616 PQ96246
FOR SEGMENT UWAO13 (Assembler) - REL TPFDF
PQ32210 PQ61136 PQ51955 PQ75887 PQ94935
FOR SEGMENT UWBC13 (Assembler) - REL TPFDF
PQ32210 PQ48582 PQ48551 PQ51339 PQ53452 PQ61711 PQ51955
PQ74483 PQ75887 PQ80141 PQ94935 PQ90239 PQ91310 PK01852
FOR SEGMENT UWBK13 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ51955 PQ75887 PQ94935 PQ91734
FOR SEGMENT UWBN13 (Assembler) - REL TPFDF
PQ46459 PQ94935 PK02541
FOR SEGMENT UWBP13 (Assembler) - REL TPFDF
PQ46459
FOR SEGMENT UWB113 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483 PQ75887 PQ80141 PQ83874 PQ94935
PQ96246 PK02541
FOR SEGMENT UWB913 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ48551 PQ55170 PQ51955 PQ74483 PQ75887
PQ80141 PQ88509
To be applied in the order listed for each segment.
ABSTRACT OF PROBLEM
___________________
With APAR PQ32210 installed, a DB0146 system error occurs when
TM=YES is specified in the DBDEF and subfile is opened without
being used, such as what might occur during a DBSRT operation.
COMMENTS ON PROBLEM
___________________
There are three distinct problems causing this DB0146.
1. Prior to CEP APAR PQ32210, when an API overrode the TM=
value in the DBDEF, a bit was set to indicate the value was
overridden. With CEP, the processing changed. A trans-
action begin (TXBGC) would occur if either (a) TM=YES and a
file was internally opened, or (b) a file is not yet inter-
nally opened and TM=YES is specified on an API. However, a
TXCMC would occur whenever TM=YES was specified. As a
result, if a DBOPN was issued without TM= specified, and the
file was closed without having been internally opened, a
DB0146 system error would occur.
2. The DB0146 system error that is issued in problem (1) (open
TPFDF file is detected while closing the commit scope) does
not describe the actual problem (TXCMC issued without
TXBGC). This is because code in TPF segment CCOMIC does not
check to see whether a TXBGC was issued before entering the
code to process the TXCMC.
3. TPFDF does not handle protocol errors. When any of the
commit/rollback APIs fail, the error is not passed back to
the user.
These problems occur on TPF systems only.
SOLUTION
________
1. SW00IDF,#BIT4 was initially used for two purposes. One
purpose was to indicate that the TM= override parameter is
specified on an API. Segments UWAC, UWA0, UWBC, UWBK,
UFGCSO, and UFGESO were updated so that all instances of
SW00IDF,#BIT4 being used for this purpose have been removed.
The other use of SW00IDF,#BIT4 was as a flag to indicate
DETAC mode in pack processing. This code has been left
intact and the SW00SR macro has been updated to reflect this
usage.
2. The checks in TPF segment CCOMIC have been fixed with TPF
APAR PJ30241.
3. The following segments have been updated to check for errors
when ever any of the commit/rollback APIs are issued: UWAC,
UWBC, UWBN, and UWBP. If one of these calls fails, an
appropriate system error is issued. The following system
errors are introduced with this APAR: DB0175, DB0176,
DB0177, DB0178, DB0179, and DB017A. The new errors are
defined in segments UWB9 and IFL0DF. As a result of code
updates to UWBN, we ran out of space in that segment. UWBP
was created in order to free up space in UWBN. The fol-
lowing routines from UWBN were moved to UWBP: subroutine
HEAD4TO8, the subroutine to convert a 4-byte header to an
8-byte header and subroutine HEAD8TO4, the subroutine to
convert an 8-bytes header to a 4-byte header.
1
DEPENDENCIES
____________
Related Segments Affected By This APAR.
_______________________________________
Segments to be assembled or compiled:
o On ALCS: UFGC, UFGE
o On TPF : UFGCIC, UFGEIC
Segments to be link edited:
o On ALCS: TPFDFC3
o On TPF : CTDF
Load Modules to be loaded:
o On ALCS: TPFDFC3
o On TPF : CTDF
Migration Considerations
========================
TPF APAR PJ30241 is a co-requisite APAR.
The following system errors are added with this APAR:
DB0175
Program: Displayed on the console and in the dump.
Error message: None.
Explanation:
The TXBGC macro did not complete successfully.
System action: The entry control block (ECB) exits.
User response: Report the problem to your IBM service representative.
Related information: None.
DB0176
Program: Displayed on the console and in the dump.
Error message: None.
Explanation:
The TXCMC macro did not complete successfully.
System action: The entry control block (ECB) exits.
User response: Report the problem to your IBM service representative.
Related information: None.
DB0177
Program: Displayed on the console and in the dump.
Error message: None.
Explanation:
The TXRBC macro did not complete successfully.
System action: The entry control block (ECB) exits.
User response: Report the problem to your IBM service representative.
Related information: None.
DB0178
Program: Displayed on the console and in the dump.
Error message: None.
Explanation: Resource managers were not opened at the time the TXBGC
macro was issued.
System action: The entry control block (ECB) exits.
User response: Report the problem to your IBM service representative.
Related information: None.
DB0179
Program: Displayed on the console and in the dump.
Error message: None.
Explanation: the Commit/rollback APIs were not issued in the correct
sequence.
A TXCMC was issued with no previous TXBGC.
System action: The entry control block (ECB) exits.
User response: Report the problem to your IBM service representative.
Related information: None.
DB017A
Program: Displayed on the console and in the dump.
Error message: None.
Explanation: the Commit/rollback APIs were not issued in the correct
sequence.
A TXRBC was issued with no previous TXBGC.
System action: The entry control block (ECB) exits.
User response: Report the problem to your IBM service representative.
Related information: None.
-- END APAR PK03608
Download file(s) using new Server:
Login once to access server, leave window open, then
click on link(s) below.
|
