REPOSIT (XFILE)


9.0D

 

The REPOSIT instruction positions the recordset's pointer to the specified value. This instruction is normally used in conjunction with the FPOSIT instruction. The instruction uses the following format:

 

[label]

REPOSIT

{xfile}{sep}{offset}

 

Where:

label

Optional. A Program Execution Label.

xfile

Required. A previously defined and opened XFILE variable whose current position is set.

sep

Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, or INTO.

offset

Required. A a previously defined Numeric Variable or Expression containing the recordset position to which the file is positioned.

Flags Affected: OVER, ZERO

Note the following:

  1. The value contained in {offset} is the new value for the recordset pointer. If {value} equals zero (0), the pointer is set to the beginning of the records.

  2. If the specified location is at the End Of File (EOF), the OVER Condition Flag is set. If it is past the EOF, the ZERO Condition Flag is set.

 

 

See Also: XML Support



PL/B Language Reference READKGP (XFILE) SETFILE (XFILE)