bdfp1m36Programming Concepts and Reference

FILTP-Determine File Address Type

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

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

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.