Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-30
POSITION Procedure
(Superseded by FILE_SETPOSITION_ Procedure)
Unless the unstructured file is created with the odd unstructured attribute (also
known as ODDUNSTR) set, the RBA passed in
record-specifier must be
an even number. If the odd unstructured attribute is set when the file is
created, the RBA passed in
record-specifier can be either an odd or
even value. (You set the odd unstructured attribute with the FILE_CREATE_,
FILE_CREATELIST_, or CREATE procedure, or with the File Utility Program
(FUP) SET and CREATE commands.)
For even unstructured files (that is, files created with the odd unstructured
attribute not set), the
record-specifier parameter must be an even byte
address, or the operation fails with file-system error 2.
•
Relative and entry-sequenced files
•
Writing to entry-sequenced files
Inserts to entry-sequenced files always occur at the end of the file.
•
Current-state indicators for structured files
After a successful POSITION to a relative or entry-sequenced file, the current-
state indicators are:
Current position is that of the record indicated by the
record-specifier.
Positioning mode is approximate.
Comparison length is 4.
Current primary-key value is set to the value of the
record-specifier.
Related Programming Manuals
For programming information about the POSITION file-system procedure, refer to the
Enscribe Programmer’s Guide and the Guardian Programmer’s Guide.