bdfp1m36 | Programming Concepts and Reference |
Use this macro to determine if a specified file address is a
fixed file address or a pool file address. If the
file address is a pool address, it can be further classified as
short-term or long-term duplicated. This macro
then branches to a specified label according to the file type that is
determined.
Format
- label
- is a symbolic name assigned to the macro statement.
- fileaddr
- is the location of a 4-byte field that contains the file address.
- POOL=poolbl
- specifies where to branch if the file address is a pool address, where
poolbl is the label for that location.
- FIX=fixlbl
- specifies where to branch if the file address is a fixed address, where
fixlbl is the label for that location.
- SHORTTP=shortlbl
- specifies where to branch if the file address is a short-term pool
address, where shortlbl is the label for that location.
- DPPOOL=dpplbl
- specifies where to branch if the file address is a long term duplicated
pool address, where dpplbl is the label for that location.
- PSEUDST=pslbl
- places the dummy file address used for TPFDF W-type files at the label
specified by pslbl.
- ERROR=errlbl
- specifies where to branch if the specified file address is not valid,
where errlbl is the label for that location. If you do not
specify the ERROR parameter and the specified file address is not valid,
control is passed to the next sequential instruction (NSI).
Entry Requirements
When you specify any parameter except the PSEUDST parameter, the file
address to be checked must be at the label specified by
fileaddr.
Normal Return
- When you specify any parameter except the PSEUDST parameter, the contents
of register 0 (R0), R14, and R15 cannot be predicted.
- When you specify the PSEUDST parameter, the dummy file address used for
TPFDF W-type files is placed at the label specified by pslbl.
Error Return
When you specify any parameter except the PSEUDST parameter, control is
passed to the label specified by the ERROR parameter if the specified file
address is not valid.
Programming Considerations
- If you are running in an ALCS environment, do not assemble
programs using the version of the FILTP macro that is shipped with the TPFDF
product. Use the version of the FILTP macro that is provided with the
ALCS product.
- The SHORTTP and DPPOOL parameters take precedence over the POOL
parameter. That is, if the file address is a short-term pool address,
control will be passed to the label specified by shortlbl, not the
label specified by poolbl.
Examples
The following example checks the file address at label EBCFA0.
FILTP EBCFA0,SHORTTP=STLABEL,POOL=LTLABEL,DPPOOL=LDLABEL
The following shows where control will be passed based on the type of file
address:
File Address
| Control Passed To
|
Short-term pool
| Label STLABEL
|
Long-term duplicated pool
| Label LDLABEL
|
Long-term non duplicated pool
| Label LTLABEL
|
Fixed file address
| Next sequential instruction
|
Not valid
| Next sequential instruction
|
Related Macros
None.