SUBJECT: APAR NUMBER: PQ75887
REFERENCE: AREA: TPFDF CENTRAL DATABASE ROUTINES
SEGMENT: #POPAAC#13 - RELEASE: TPFDF (Macro)
SEGMENT: #PUSHAAC13 - RELEASE: TPFDF (Macro)
SEGMENT: #PUSHINS13 - RELEASE: TPFDF (Macro)
SEGMENT: ACPDBE13 - RELEASE: TPFDF (Macro)
SEGMENT: BRCG13 - RELEASE: TPFDF (Assembler)
SEGMENT: BRCT13 - RELEASE: TPFDF (Assembler)
SEGMENT: BRC513 - RELEASE: TPFDF (Assembler)
SEGMENT: BRC713 - RELEASE: TPFDF (Assembler)
SEGMENT: BRC913 - RELEASE: TPFDF (Assembler)
SEGMENT: C$CDFAPI13 - RELEASE: TPFDF (C-Header)
SEGMENT: C$CDFEQ13 - RELEASE: TPFDF (C-Header)
SEGMENT: C$CDFERR13 - RELEASE: TPFDF (C-Header)
SEGMENT: C$CDFMAC13 - RELEASE: TPFDF (C-Header)
SEGMENT: C$IRCEDF13 - RELEASE: TPFDF (C-Header)
SEGMENT: C$IRCJDF13 - RELEASE: TPFDF (C-Header)
SEGMENT: C$SW00SR13 - RELEASE: TPFDF (C-Header)
SEGMENT: DBADD13 - RELEASE: TPFDF (Macro)
SEGMENT: DBGBL13 - RELEASE: TPFDF (Macro)
SEGMENT: DBGETS13 - RELEASE: TPFDF (Macro)
SEGMENT: DBLCL13 - RELEASE: TPFDF (Macro)
SEGMENT: DBRED13 - RELEASE: TPFDF (Macro)
SEGMENT: DBREP13 - RELEASE: TPFDF (Macro)
SEGMENT: DB11513 - RELEASE: TPFDF (Macro)
SEGMENT: DB12513 - RELEASE: TPFDF (Macro)
SEGMENT: DB13013 - RELEASE: TPFDF (Macro)
SEGMENT: DB15513 - RELEASE: TPFDF (Macro)
SEGMENT: DB20013 - RELEASE: TPFDF (Macro)
SEGMENT: DFCLIB13 - RELEASE: TPFDF (Macro)
SEGMENT: DX11513 - RELEASE: TPFDF (Macro)
SEGMENT: DX12513 - RELEASE: TPFDF (Macro)
SEGMENT: DX15513 - RELEASE: TPFDF (Macro)
SEGMENT: DX20013 - RELEASE: TPFDF (Macro)
SEGMENT: IDFRDF13 - RELEASE: TPFDF (Dsect)
SEGMENT: IFL0DF13 - RELEASE: TPFDF (Dsect)
SEGMENT: IMLLA13 - RELEASE: TPFDF (Dsect)
SEGMENT: IMLLC13 - RELEASE: TPFDF (C-Header)
SEGMENT: IRCEDF13 - RELEASE: TPFDF (Dsect)
SEGMENT: IRCJDF13 - RELEASE: TPFDF (Dsect)
SEGMENT: SW00SR13 - RELEASE: TPFDF (Macro)
SEGMENT: SW03SR13 - RELEASE: TPFDF (Macro)
SEGMENT: TPFDB13 - RELEASE: TPFDF (Macro)
SEGMENT: UFAO13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFBB13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFBK13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFBM13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFB113 - RELEASE: TPFDF (Assembler)
SEGMENT: UFB213 - RELEASE: TPFDF (Assembler)
SEGMENT: UFCB13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFCJ13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFCZ13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFC413 - RELEASE: TPFDF (Assembler)
SEGMENT: UFD013 - RELEASE: TPFDF (Assembler)
SEGMENT: UFGASO13 - RELEASE: TPFDF (Copy)
SEGMENT: UFGRSO13 - RELEASE: TPFDF (Copy)
SEGMENT: UFGSSO13 - RELEASE: TPFDF (Copy)
SEGMENT: UFHA1313 - RELEASE: TPFDF (C++)
SEGMENT: UFIL13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFI513 - RELEASE: TPFDF (Assembler)
SEGMENT: UFI713 - RELEASE: TPFDF (Assembler)
SEGMENT: UFI813 - RELEASE: TPFDF (Assembler)
SEGMENT: UFI913 - RELEASE: TPFDF (Assembler)
SEGMENT: UFKABS13 - RELEASE: TPFDF (BuildScr)
SEGMENT: UFKA0013 - RELEASE: TPFDF (C++)
SEGMENT: UFKA0113 - RELEASE: TPFDF (C++)
SEGMENT: UFKA0213 - RELEASE: TPFDF (C++)
SEGMENT: UFKA0313 - RELEASE: TPFDF (C++)
SEGMENT: UFKA0413 - RELEASE: TPFDF (C++)
SEGMENT: UFKA0513 - RELEASE: TPFDF (C++)
SEGMENT: UFTM13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAA13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAB13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAC13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAD13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAE13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAG13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAI13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAK13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAL13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAM13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAN13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAO13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAP13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAQ13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAR13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAS13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAT13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAU13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWAW13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBB13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBC13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBE13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBF13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBG13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBK13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBL13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWBM13 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB013 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB113 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB213 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB413 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB513 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB613 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB713 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB813 - RELEASE: TPFDF (Assembler)
SEGMENT: UWB913 - RELEASE: TPFDF (Assembler)
Pre-requisite APARs are (TPF only) :
FOR SEGMENT #POPAAC#13 (Macro) - REL TPFDF
PN71030 PN86472 PQ50275
FOR SEGMENT #PUSHAAC13 (Macro) - REL TPFDF
PN86472 PQ50275
FOR SEGMENT #PUSHINS13 (Macro) - REL TPFDF
PN46225 PN61610 PN71030 PN86472 PQ50275
FOR SEGMENT ACPDBE13 (Macro) - REL TPFDF
PN39258 PN41660 PN48086 PN52010 PN61834 PN66927 PN67252
PN71161 PN73989 PN82139 PQ19230 PQ23871 PQ32209 PQ39696
PQ42097 PQ32210 PQ42198 PQ52738 PQ65645
FOR SEGMENT BRCG13 (Assembler) - REL TPFDF
PN44448 PN63945 PQ00810 PQ42097 PQ74483
FOR SEGMENT BRC513 (Assembler) - REL TPFDF
1
PN40344 PN49889 PN63712 PN67252 PN87863 PQ42097 PQ49400
PQ56724 PQ57571 PQ65208 PQ65765 PQ69687 PQ69685 PQ65349
PQ74483
FOR SEGMENT BRC713 (Assembler) - REL TPFDF
PN40344 PN49889 PN67252 PN73220 PN73989 PN79639 PQ42097
PQ51935 PQ49400 PQ56724 PQ57571 PQ65208 PQ65765 PQ69687
PQ69685 PQ65349 PQ74483
FOR SEGMENT BRC913 (Assembler) - REL TPFDF
PN35160 PN35161 PN39186 PN40446 PN40506 PN40783 PN49889
PN44448 PN51087 PN60595 PN63714 PN72208 PN81528 PN91687
PQ00810 PQ42097 PQ49400 PQ74483
FOR SEGMENT C$CDFAPI13 (C-Header) - REL TPFDF
PN83423 PN91920 PN91521 PQ04911 PQ08645 PQ32210 PQ49042
PQ65155 PQ74483
FOR SEGMENT C$CDFEQ13 (C-Header) - REL TPFDF
PN57135 PN61834 PN74617 PN83423 PN91920 PN91521 PQ08645
PQ25825 PQ28550 PQ32209 PQ32210 PQ47099 PQ60326 PQ65155
PQ74483
FOR SEGMENT C$CDFERR13 (C-Header) - REL TPFDF
PN73989 PQ08645 PQ16897 PQ50275
FOR SEGMENT C$CDFMAC13 (C-Header) - REL TPFDF
PN57135 PN74617 PN83423 PN91521 PQ03942 PQ04911 PQ08645
PQ32210 PQ65155 PQ74483
FOR SEGMENT C$IRCEDF13 (C-Header) - REL TPFDF
PQ23489 PQ23871 PQ51955 PQ74483
FOR SEGMENT C$IRCJDF13 (C-Header) - REL TPFDF
PQ23489 PQ23871 PQ51955 PQ74483
FOR SEGMENT C$SW00SR13 (C-Header) - REL TPFDF
PN46560 PN61834 PN64313 PN71161 PN73989 PN76852 PN80488
PN83423 PN85070 PQ02145 PQ04911 PQ09236 PQ08645 PQ10084
PQ16897 PQ23091 PQ25825 PQ36911 PQ37963 PQ32210 PQ55601
PQ64252 PQ51955 PQ74483
FOR SEGMENT DBADD13 (Macro) - REL TPFDF
PQ74483
FOR SEGMENT DBGBL13 (Macro) - REL TPFDF
PN45919 PN67830 PN72208 PN84867 PN86473 PN86470 PN86542
PN91687 PQ01256 PQ06909 PQ10797 PQ15199 PQ17413
FOR SEGMENT DBLCL13 (Macro) - REL TPFDF
PN37303 PN45919 PN67830 PN67252 PN72208 PN84867 PN86473
PN86470 PN86542 PN91687 PQ01256 PQ06909 PQ10797 PQ15199
PQ17413 PQ19320 PQ32209 PQ66435
FOR SEGMENT DBRED13 (Macro) - REL TPFDF
PQ74483
FOR SEGMENT DB11513 (Macro) - REL TPFDF
PN61173 PN73989
FOR SEGMENT DB12513 (Macro) - REL TPFDF
PN41982 PN47061 PN50586 PN52010 PN54502 PN57526 PN62258
PN73989 PN76765 PQ06194 PQ32210 PQ42047 PQ55170 PQ51955
PQ74483
FOR SEGMENT DB13013 (Macro) - REL TPFDF
PN55986 PN75079 PQ60511
FOR SEGMENT DB15513 (Macro) - REL TPFDF
PN83423 PQ13787 PQ32210 PQ74483
FOR SEGMENT DB20013 (Macro) - REL TPFDF
PQ32210
FOR SEGMENT DFCLIB13 (Macro) - REL TPFDF
PN73989 PN84757 PN92798 PQ36444 PQ32210
FOR SEGMENT DX12513 (Macro) - REL TPFDF
PQ06194 PQ74483
FOR SEGMENT DX15513 (Macro) - REL TPFDF
PQ13787 PQ74483
FOR SEGMENT IDFRDF13 (Dsect) - REL TPFDF
PQ10084
FOR SEGMENT IFL0DF13 (Dsect) - REL TPFDF
PQ32210 PQ46459 PQ48551 PQ55170 PQ51955 PQ74483
FOR SEGMENT IRCEDF13 (Dsect) - REL TPFDF
PQ23489 PQ23871 PQ54398 PQ74483
FOR SEGMENT IRCJDF13 (Dsect) - REL TPFDF
PQ23489 PQ23871 PQ74483
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
FOR SEGMENT SW03SR13 (Macro) - REL TPFDF
PN61834 PN83423 PN91920 PQ16897 PQ24625 PQ32209 PQ65155
PQ74483
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
FOR SEGMENT UFAO13 (Assembler) - REL TPFDF
PN43688 PN61834 PN77016 PQ17413 PQ19230 PQ32209 PQ32210
PQ55170 PQ62811 PQ51955
FOR SEGMENT UFBB13 (Assembler) - REL TPFDF
PN49196 PN57993 PN64878 PN78904 PQ51955 PQ74483
FOR SEGMENT UFBK13 (Assembler) - REL TPFDF
PN39059 PN41324 PN47368 PN86476 PN92681 PN92851 PQ04911
PQ51955 PQ74483
FOR SEGMENT UFBM13 (Assembler) - REL TPFDF
PN42312 PN73989 PN75827 PN91649 PQ02170 PQ04563 PQ08743
PQ30389 PQ32209 PQ51955 PQ74483
FOR SEGMENT UFB113 (Assembler) - REL TPFDF
PN47122 PN80488 PQ00977 PQ30389 PQ35263 PQ51955 PQ74483
FOR SEGMENT UFB213 (Assembler) - REL TPFDF
PN41065 PN41321 PN55359 PN77897 PN80488 PN86537 PN91649
PN92851 PQ00810 PQ02090 PQ04911 PQ04563 PQ18942 PQ21604
PQ30389 PQ40947 PQ32210 PQ51955 PQ74483
FOR SEGMENT UFCB13 (Assembler) - REL TPFDF
PN88105 PQ51955
FOR SEGMENT UFCJ13 (Assembler) - REL TPFDF
PQ02090 PQ04804 PQ07900 PQ51955
FOR SEGMENT UFC413 (Assembler) - REL TPFDF
PQ30389 PQ51955 PQ74483
FOR SEGMENT UFD013 (Assembler) - REL TPFDF
PN19872 PN84970 PQ00810 PQ51955
FOR SEGMENT UFGASO13 (Copy) - REL TPFDF
PN84867 PN86534 PQ00810 PQ32210 PQ47099 PQ55170 PQ60326
PQ74483
FOR SEGMENT UFGRSO13 (Copy) - REL TPFDF
PN84867 PN86534 PN91920 PQ00810 PQ24310 PQ32210 PQ55170
PQ60326 PQ74483
FOR SEGMENT UFGSSO13 (Copy) - REL TPFDF
PN84867 PN86534 PQ00810
FOR SEGMENT UFHA1313 (C++) - REL TPFDF
PQ23489 PQ23871 PQ74483
FOR SEGMENT UFI513 (Assembler) - REL TPFDF
PQ23489 PQ23871 PQ33410 PQ36341 PQ53168 PQ65645 PQ51955
PQ74483
FOR SEGMENT UFI713 (Assembler) - REL TPFDF
PQ23489 PQ23871 PQ37720 PQ53168 PQ51955 PQ74483
FOR SEGMENT UFI813 (Assembler) - REL TPFDF
PQ23489 PQ23871 PQ32210 PQ51955 PQ74345 PQ74483
FOR SEGMENT UFI913 (Assembler) - REL TPFDF
PQ23489 PQ23871 PQ31377 PQ51955 PQ74483
FOR SEGMENT UFTM13 (Assembler) - REL TPFDF
2
PN73989 PN76852 PN84757 PQ23871 PQ33409 PQ30389 PQ36341
PQ32210
FOR SEGMENT UWAA13 (Assembler) - REL TPFDF
PQ32210 PQ47099 PQ48551 PQ53948 PQ51955 PQ75626 PQ74483
FOR SEGMENT UWAB13 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWAC13 (Assembler) - REL TPFDF
PQ32210 PQ42198 PQ46459 PQ51955 PQ74483
FOR SEGMENT UWAD13 (Assembler) - REL TPFDF
PQ32210 PQ61711 PQ51955
FOR SEGMENT UWAE13 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWAG13 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ50275 PQ48551 PQ52356 PQ51955 PQ74483
FOR SEGMENT UWAI13 (Assembler) - REL TPFDF
PQ32210
FOR SEGMENT UWAK13 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ51955
FOR SEGMENT UWAL13 (Assembler) - REL TPFDF
PQ32210 PQ45798 PQ51955
FOR SEGMENT UWAM13 (Assembler) - REL TPFDF
PQ32210 PQ55601 PQ51955 PQ74483
FOR SEGMENT UWAN13 (Assembler) - REL TPFDF
PQ32210 PQ64252 PQ51955 PQ74483
FOR SEGMENT UWAO13 (Assembler) - REL TPFDF
PQ32210 PQ61136 PQ51955
FOR SEGMENT UWAP13 (Assembler) - REL TPFDF
PQ32210 PQ48551 PQ60572 PQ59219 PQ51955 PQ73578 PQ74483
FOR SEGMENT UWAQ13 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWAR13 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ60572 PQ51955 PQ74483
FOR SEGMENT UWAS13 (Assembler) - REL TPFDF
PQ32210 PQ59969 PQ51955 PQ74483
FOR SEGMENT UWAT13 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ51955
FOR SEGMENT UWAU13 (Assembler) - REL TPFDF
PQ32210 PQ48979 PQ61711 PQ61932 PQ51955 PQ74483
FOR SEGMENT UWAW13 (Assembler) - REL TPFDF
PQ32210 PQ49400 PQ60326 PQ51955 PQ74483
FOR SEGMENT UWBB13 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWBC13 (Assembler) - REL TPFDF
PQ32210 PQ48582 PQ48551 PQ51339 PQ53452 PQ61711 PQ51955
PQ74483
FOR SEGMENT UWBE13 (Assembler) - REL TPFDF
PQ32210 PQ42198 PQ49738 PQ61837 PQ51955 PQ74483
FOR SEGMENT UWBF13 (Assembler) - REL TPFDF
PQ32210 PQ52738 PQ55616 PQ51955 PQ74483
FOR SEGMENT UWBG13 (Assembler) - REL TPFDF
PQ32210 PQ60572 PQ51955 PQ74483
FOR SEGMENT UWBK13 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ51955
FOR SEGMENT UWBL13 (Assembler) - REL TPFDF
PQ46459 PQ74483
FOR SEGMENT UWBM13 (Assembler) - REL TPFDF
PQ46459 PQ74483
FOR SEGMENT UWB013 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWB113 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWB213 (Assembler) - REL TPFDF
PQ32210 PQ52738 PQ69735 PQ51955 PQ74483
FOR SEGMENT UWB413 (Assembler) - REL TPFDF
PQ32210 PQ48551 PQ51955 PQ74483
FOR SEGMENT UWB513 (Assembler) - REL TPFDF
PQ32210 PQ42198 PQ51955 PQ74483
FOR SEGMENT UWB613 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWB713 (Assembler) - REL TPFDF
PQ32210 PQ42198 PQ48551 PQ51955 PQ74483
FOR SEGMENT UWB813 (Assembler) - REL TPFDF
PQ32210 PQ51955 PQ74483
FOR SEGMENT UWB913 (Assembler) - REL TPFDF
PQ32210 PQ46459 PQ48551 PQ55170 PQ51955 PQ74483
To be applied in the order listed for each segment.
ABSTRACT OF PROBLEM
___________________
Currently, TPFDF limits the size of an LREC to 4K or less. The
TPFDF product should be updated to allow larger LREC sizes.
There are various problems introduced by PQ51955 (DECB) and
PQ74483 (FARF6).
COMMENTS ON PROBLEM
___________________
TPFDF currently restricts the size of an LREC to that of the
largest block that can be filed to DASD. On TPF, the largest
block that could be filed to DASD is 4K. The TPFDF product
should be updated to allow larger LREC sizes.
In order to provide this support, several corrections to TPFDF
DECB APAR PQ51955 (TPFDF PUT 18) and TPFDF FARF6 infrastructure
APAR PQ74483 (TPFDF PUT 19) need to be included with this APAR.
SOLUTION
________
The TPFDF product has been updated to allow records greater than
4K in size, known as large logical records (LLRs). This has
been accomplished by introducing buffered access mode (BAM).
With BAM, TPFDF applications manage the storage that contains
the LREC. Two new C functions, a new assembler macro, and
several TPFDF macro parameters and C function options have been
introduced for use with BAM. With these new functions, macro,
parameters and options the application can pass all the neces-
sary information for TPFDF to manage LLRs in a database. BAM is
required when managing LLRs, but can also be used with tradi-
tional LRECs.
With this APAR installed a database can contain LRECs of any
size. No database migration is required before introducing LLRs
into existing databases.
A brief description of the new functions and macro are as
follows:
- DBGETS/dfgetsz() - use this macro/function to get the size of
the
current LREC
- dfsetbam() - Use this function to define a BAM param-
eter
list before specifying the BAM option on
A brief description of the new parameters are as follows:
For DBADD:
- RECADDR= a pointer to the LREC in storage to be added
- RECLEN= specifies the LREC length to be added
For dfadd():
- DFADD_BAM option indicates that an LREC is to be added using
BAM.
3
For DBRED:
- BUFSIZ= specifies the length of the buffer pointed to by
the
RECADDR parameter
- CURRENT specifies that the current record from the previous
DBRED
- RECADDR= a pointer to the buffer that contains the read
LREC. If
the pointer is set to 0, then the size of the LREC
returned in he pointer supplied by RECLEN.
- RECLEN= specifies the length of the LREC being read
For dfred():
- DFRED_BAM option indicates that an LREC is to be read using
BAM.
- DFRED_CURRENT option reads the current LREC.
For DBREP:
- RECADDR= a pointer to the LREC in storage that will replace
the
current LREC
- RECLEN= specifies the LREC length of the LREC that will
replace
current LREC.
For dfrep():
- DFREP_BAM option indicates that an LREC is to be replaced
using
BAM.
Two types of LLR are supported by the TPFDF product. Type-1
LLRs support LRECs that fit in up to three 4K file blocks, and
type 2 LLRs support LRECs that are up to the maximum size set by
the #LLRMLR equate in the ACPDBE macro and exceed 3 file blocks
in length.
An LLR is made up of the following 3 kinds of file blocks:
Master Large Logical record (MLL) - The MLL is the first file
block of an LLR. The MLL contains the following information:
1. TPFDF file header
2. LLR cloaked header which contains control information that
is not
available to the application program
3. Normal LREC length and primary key
4. The first part of the LREC data
5. TPFDF file trailer.
LLR Data Block (LLDB) - LLR data blocks contain the application
data that cannot fit in the MLL. There can be up to 2 LLDBs for
a type-1 LLR and as many LLDBs as are necessary for type-2 LLRs.
LLR Index Block (LLIB) - LLR index blocks are only used for
type-2 LLRs. They contain file pointers the LLDBs that contain
the type-2 LLR data. TPFDF builds as many LLIBs as are required
to point the LLDBs needed for the type-2 LLR
The following restrictions exist for LLR:
1. LLRs cannot be extended LRECs
2. MLS labels that reside in an LLDB cannot be displayed
3. DBDSP and dfdsp cannot display data that resides beyond the
MLL
4. DBMOD and dfmod cannot used with an LLR
5. LLRs cannot be index LRECs
6. Key data must reside in the MLL.
Additional information on LLRs can be found online in the TPFDF
Information Center.
DEPENDENCIES
____________
Related Segments Affected By This APAR.
_______________________________________
Segments to be assembled or compiled:
On ALCS: UFGA, UFGR, UFGS
On TPF: UFGAIC, UFGRIC, UFGSIC
Segments to be link edited:
On ALCS: TPFDFC3, TPFDFH3
On TPF: CTDF, UFHA, UFKA
Load Modules to be loaded:
On ALCS: TPFDFC3, TPFDFH3
On TPF: CTDF, UFHA, UFKA
Migration Considerations ========================
ALCS customers should APPLY ALCS APAR AQ76981 to fix a problem
exposed by this support.
TPF customers that are not using the E-type loader to load this
APAR must apply co-requisite TPF PUT 18 APAR PJ29285.
New segments have been introduced:
o Assembler segments - BRCT, UFCZ and UFIL
o Assembler macro - IMLLA, DBGETS
o C header - imllc
o Build script - UFKABS
o C++ segments - UFKA00, UFKA01, UFKA02, UFKA03, UFKA04 and
UFKA05
For all customers, an updated version of segments ACPDBE and
DBLCL are included with this APAR. Be sure to integrate the
changes to these segments without overlaying existing customized
values at your installation.
The change to ACPDBE is the introduction of a new equate,
#LLRMLR. This is the maximum size of an LLR that the system
will allow. Its value is set to 2,097,151 (x'1FFFFF') by
default. If it is changed, reassemble segments UWAQ and UWBM.
The changes to DBLCL are:
1. the addition of specific BAM indicators
4
2. changing the default value of &ACPDBRF to 0
Setting &ACPDBRF to 0 is required if LLRs exist in the system
because the TPFDF version of RLCHA is required to properly
release pool file addresses comprising an LLR. If this value is
changed, reassemble segment UWB2.
No changes are required for Recoup and CRUISE to chainchase a
LLR structure properly.
-- END APAR PQ75887
Download file(s) using new Server:
Login once to access server, leave window open, then
click on link(s) below.
|
