ANLRMSHLP.HLB  —  POSITION

1    /BUCKET

 Directly positions the structure pointer to a specific bucket of an
 indexed file or a relative file.

    Format

      POSITION/BUCKET  bucket_vbn [/INDEX=n]

1.1  –  Parameter

 bucket_vbn

    The virtual block number (VBN) of the selected bucket. If the
    bucket includes more than one block, specify the VBN of the first
    block.

1.2  –  Qualifier

1.2.1    /INDEX

       /INDEX=n

    Specifies the relative key for the bucket of an indexed file.
    The /INDEX qualifier is necessary only when the index number
    information is unavailable in the bucket header. For example,
    you use this qualifier to analyze a Prolog 1 or Prolog 2 file (no
    bucket header) or a Prolog 3 file with a corrupted bucket header.
    You can also use this qualifier to override the index number in a
    Prolog 3 file bucket header.

    The number you use specifies the key. For example, /INDEX=0
    specifies that the bucket is a primary index or primary data
    bucket, and /INDEX=1 specifies that the bucket is found in the
    first alternate index structure.

2    /RECORD

 Positions the pointer at a specific record in an indexed or relative
 file.

    Format

      POSITION/RECORD  record-offset

    The offset (in bytes) from the beginning of the bucket to the
    desired record. By default, the offset is a decimal number. If
    you want to use hexadecimal notation to specify the offset, use
    the format %Xn.
Close Help