ios_inq_full_key()

IOS_$INQ_FULL_KEY                 Domain/OS                  IOS_$INQ_FULL_KEY


NAME
     ios_$inq_full_key - return a full seek key

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/ios.h>

     void ios_$inq_full_key(
          ios_$id_t &stream_id,
          ios_$pos_opt_t &positon_option,
          ios_$seek_key_t *full_key,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/ios.ins.pas';

     procedure ios_$inq_full_key(
          in stream_id: ios_$id_t;
          in position_option: ios_$pos_opt_t;
          out full_key: ios_$seek_key_t;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/ios.ins.ftn'

           integer*2 stream_id, position_option
           integer*4 full_key(2), status

           call ios_$inq_full_key(stream_id, position_option,
          &                       full_key, status)

DESCRIPTION
     Ios_$inq_full_key returns a full seek key for the position specified in
     position_option.  The seek key returned in full_key can be used in a call
     to ios_$seek_full_key to return the stream marker to the position speci-
     fied in position_option.  Do not rely on the value of full_key.  The only
     guarantee is that a call to ios_$seek_full_key will return a stream
     marker to the same position it was in when ios_$inq_full_key was called
     to obtain the key.

     stream_id
          The ID of the stream to seek on.

     position_option
          Choose one of the following positions:

          ios_$bof
               Return a full key for the beginning of the object (BOF).

          ios_$current
               Return a full key for the current stream marker.

          ios_$eof
               Return a full key for the end of the object (EOF).

     full_key
          A full seek key for the position specified in position_option.

     status
          The completion status.

NOTES
     Domain/OS offers both short (4-byte) and full (8-byte) seek keys.
     Because short seek keys require half the storage space of full seek keys,
     they are useful when a program stores a large number of seek keys.  How-
     ever, short keys allow seeking to record boundaries only, while full keys
     allow seeking into records.

SEE ALSO
     ios_$inq_byte_pos, ios_$inq_rec_pos, ios_$seek.
Museum
