bdfp1m1kProgramming Concepts and Reference

dfret-Retain a Logical Record Position

Use this group of functions to retain the file address and displacement in a block of the current logical record (LREC). You can read the LREC later in your application program by using a dfred function with the appropriate option parameter value.

Format

void dfret(dft_fil *file, dft_opt options);
void dfret_stk(dft_fil *file, dft_opt stk_type,
     dft_opt options, dft_xxx stk);



file
is a pointer to the base address of the SW00SR slot (defined in c$sw00sr.h) of the subfile that you want to access and is returned by the dfopn function.

options
are the processing options for this function. Use the following values:

DFRET_CURRENT
specifies that you want to retain the current LREC.

0
specifies that you do not want to use any processing options.

stk
is one of the following based on the value you specify for the stk_type parameter:

stk_type
is one of the following:

DFRET_STACK
specifies that you are supplying a pointer to a stack area in the stk parameter.

DFRET_STACKREF
specifies that you are supplying a stack reference number in the stk parameter.

Both values let you retain a number of LRECs and identify them so that you can later read them with dfred functions.

Entry Requirements

Before using this function, you must open the subfile using the DFOPN_DETAC or DFOPN_HOLD values for the options parameter of the dfopn function.

Normal Return

None.

Error Return

 See Identifying Return Indicators and Errors for information about how to check the error indicators. 

Programming Considerations

Examples

Related Functions

dfred-Read a Logical Record.