RMUALTER72.HLB  —  DEPOSIT  Arguments

1  –  STORAGE_AREA

    Deposits a value for the 2-byte storage area identification.

2  –  CHECKSUM

    Deposits a value for the 4-byte page checksum field.

3  –  COUNT

    Deposits a value for the 2-byte field showing the number of line
    index entries. If this number is 1, the page contains only the
    SYSTEM record.

4  –  DATA offset

    Deposits the number of bytes specified. If you do not specify
    the HEXADECIMAL or the DECIMAL qualifier, the default radix is
    assumed. See the help entry for the RADIX command

    The BYTE, LONGWORD, and WORD qualifiers cannot be used with the
    ASCII qualifier.

5  –  ENTRY

    Refers to an area inventory page (AIP) entry on the database
    page. The value specified for n must be a number between zero and
    the number of AIP entries.

6  –  ABM

    Deposits the new value on the first area bit map (ABM) page
    for the specified AIP entry. The ABM value is contained in a
    longword.

7  –  LOGICAL_AREA

    Deposits the new value for the number of the logical area for the
    AIP entry. The LOGICAL_AREA value is contained in a word.

8  –  PHYSICAL_AREA

    Deposits the new value for the number of the physical area for
    the AIP entry. The PHYSICAL_AREA value is contained in a word.

9  –  ALENGTH

    Deposits the new value for the length of the name of the logical
    area for the AIP entry. The ALENGTH value is contained in 1 byte.
    The name of the logical area can be from 1 to 31 bytes in length.

10  –  ANAME

    Deposits the new value for the name of the logical area for the
    AIP entry. The ANAME value is contained in a 31-character text
    field.

11  –  TSN

    Deposits a value for the last transaction sequence number (TSN)
    to enable snapshot (.snp) files for the logical area of the AIP
    entry.

                                   NOTE

       Beginning in Oracle Rdb V7.0, Oracle Rdb stores any
       transaction sequence number that is larger than a longword
       by using both the TSN field on the page and the page TSN
       base. Oracle Rdb calculates the actual TSN by applying a
       formula to these two values. Oracle Corporation recommends
       that you do not change a TSN value that is larger than a
       longword. When a TSN is larger than a longword, a nonzero
       number is stored in the page TSN base (the page tail). The
       following example shows the location of the page TSN and the
       page TSN base:

                     000A 00000003  0000  page 3, physical area 10
                          9D091204  0006  checksum = 9D091204
                 009A2C0F ED786D2E  000A  time stamp = 23-MAY-1996 09:08:53.36
                         0000 03C4  0012  964 free bytes, 0 locked
                              0001  0016  1 line
                         0005 03E4  0018  line 0: offset 03E4, 5 bytes

       page TSN ----->    00000000  001C  line 0: TSN 0

          .
          .
          .
                              2001  03E4  line 0 (10:3:0) SYSTEM record
                           00 0001  03E6  1 byte in 0 sets/dynamic items
                        0000000000  03E9  padding '.....'

                          FFFFFFFF  03EE  snap page pointer -1
                          00000000  03F2  snap pointer TSN 0
                              0000  03F6  MBZ '..'
                          00000000  03F8  page sequence number 0
       page TSN base -------> 0000  03FC  page TSN base 0
                             0000  03FE  MBZ '..'

12  –  RECORD_LENGTH

    Deposits a value for the length, in bytes, of the record size for
    an AIP entry. The RECORD_LENGTH value is contained in a word.

13  –  INUSE

    Deposits the new value for the AIP entry's in-use flag. The INUSE
    value is contained in 1 byte.

14  –  FREE_SPACE

    Deposits a value for the 2-byte field indicating how much free
    space remains on the page.

                                   NOTE

       In the next two parameters, the integers denoting INDEX
       and LINE are zero based. For example, INDEX 0 refers to the
       first index, and LINE 3 refers to the fourth line.

       References to INDEX and LINE are invalid if the current page
       is a space area management (SPAM) page, an AIP page, or an
       ABM page.

15  –  INDEX n

    Deposits a value for the offset field or the length field for
    the line index indicated by n. For example, if you enter DEPOSIT
    INDEX 3 OFFSET, the offset address field from the fourth-line
    index is deposited.

16  –  LINE n

    Deposits information for an individual storage segment. You can
    deposit a value for the RECORD_TYPE field.

17  –  LOCKED_SPACE

    Deposits a value for the 2-byte field indicating how much free
    space is allocated for exclusive use by a recovery unit.

18  –  NUMBER

    Deposits a value for the 4-byte page number field.

19  –  SPACE

    SPACE range

    Deposits a value for a specified range of SPAM entries; it is
    valid only if the current page is a SPAM page. (The SPACE and
    DATA parameters are the only ones that you can use in DISPLAY
    and DEPOSIT commands that access a SPAM page.) The range value
    can be an asterisk (*),  referring to all entries, or a set of
    consecutive entries, which you describe as follows:

    lower-data-page-number[:higher-data-page-number]

    Each entry on a SPAM page consists of 2 bits, containing a value
    0 through 3 that represents a fullness threshold. For example, if
    the nth SPAM entry contains a 2, it means that the nth data page
    in the interval has reached a percentage of fullness greater than
    the second threshold for the area, but less than or equal to the
    third threshold.

20  –  TIME_STAMP

    Deposits a value for the 8-byte time and date stamp field.

21  –  NEXT_AIP

    Deposits a value for the page number of the next area inventory
    page (AIP).

22  –  AIP_ENTRIES

    Deposits a value for the number of area inventory page (AIP)
    entries on the current area inventory page.

23  –  value

    Specifies the new value of the field you are altering. The value
    is deposited in the default radix unless you specify otherwise in
    one of these ways:

    o  With a prior RADIX command.

    o  By specifying HEXADECIMAL or DECIMAL in a DEPOSIT DATA
       command.

    o  By enclosing ASCII data within quotation marks (" ").
       Timestamps must always be enclosed within quotation marks
       because they include punctuation characters.
Close Help