DAPOS/DXAPO

DAPOS and DXAPO set the address of the next record to be accessed within a file by calling these routines. The record position set may be defined via a prior call to DLOCF. DAPOS is equivalent to the FMGR routine APOSN; DXAPO is equivalent to EAPOS. This routine cannot be used with Type 0 (nondisk) files.

The rb and ioff parameters must be present for all files having variable record length to ensure correct operation.

DAPOS(dcb,err,rec[,rb][,off][,erlc])

DXAPO(dcb,err,rec[,rb][,off][,erlc])

dcb

Four-word array. Data Control Block. (See •RFA

(input/output)

Common Parameters" for more information.)

err

16-bit integer. Error return variable. (See •RFA

 

Common Parameters" for more information.)

rec

16-bit integer/32-bit integer. Next record. A

 

variable set to the number of the next sequential record in the

 

file. Can be determined by a prior call to DLOCF or DXLOC.

 

For DXAPO, rec is a doubleword variable with the same

 

meaning.

rb

16-bit integer/32-bit integer. Relative block

 

address of the next record. A variable set to the block number

 

of the next record. This parameter is required for files of type

 

3, 4, 5, 7, or greater (variable length records). For DXAPO, rb is

 

a doubleword variable containing the block number of the next

 

record.

off

16-bit integer. Block offset of next record. A variable set

 

to the offset in the block of the next record. This parameter is

 

required for files of Type 3 or greater.

erlc

16-bit integer. Optional error condition location. (See

 

•RFA Common Parameters" for more information.)

102 Remote File Access