Use this system macro to provide settings that are used by the recoup and
program directory update (PDU) online pool directory handler (BPDH) and the
record ID update table (BRID or BRV7).
Format
- label
- is a symbolic name that can be assigned to the macro statement.
- NOPROC=nextaddr
- specifies that the address being chain chased is an RCI candidate that
should not be processed if it has already been chain chased, where
nextaddr is the location in which to branch if the address has
already been chain chased. If the NOPROC parameter is not specified,
the address will be chain chased even if it has already been chased.
- ERROR=errloc
- specifies the location in which to be branched if an error is detected by
BPDH, where errloc is the location in which to branch.
- LEVEL=level
- specifies the level on which to run the FINDC macro in the TPF Database
Facility (TPFDF) recoup environment, where level is a number from 0
to 7.
- Note:
- Specify the LEVEL parameter when the entry control block (ECB)
level is passed from the TPFDF product.
- DECB
- specifies one of the following:
- decbaddr
- specifies a core location containing the address of a data event control
block (DECB) that will be used in the processing of a FINDC macro.
- (Rx)
- specifies a general register (R1-R7) containing the address of a
DECB that will be used in the processing of a FINDC macro.
Entry Requirements
- Register 9 (R9) must contain the address of the ECB being
processed.
- The LEVEL parameter must be specified if the BBPDH macro is called from
the TPFDF product.
- Registers R14 and R15 must be available for use. Their contents are
not saved.
- Label EBW061 in the ECB contains a recoup restart area index. When
the DECB parameter is coded, the item containing the file address to be
processed is located in the recoup stack area (BC0SA)
Return Conditions
- If an error occurs while interfacing with BPDH, the BBPDH macro branches
to the location specified with the ERROR parameter. Otherwise, control
is returned to the next sequential instruction (NSI).
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
Programming Considerations
- The BBPDH macro can only be used by recoup segments.
- The BBPDH macro uses and modifies the ECB.
- The BBPDH macro enters BPDH to interface with the recoup pseudo
directories.
- The BBPDH macro enters BRID to interface with the recoup record ID counts
table.
- When DECB=(Rx), general registers R1 to R7 are valid.
- The BBPDH macro enters BRV7 to handle alternate ID processing.
Examples
BBPDH ERROR=ERRLOC,LEVEL=0,NOPROC=DUPLOC
BBPDH ERROR=ERRLOC,DECB=(R3)
BBPDH ERROR=ERRLOC,DECB=BC0RDCB