RDB/VMS RMU/ALTER DEPOSIT — VMS RDB_4.0
Alters specified data fields on the current database page. DEPOSIT is the default at RdbALTER command level. If no other command is present following the prompt, RdbALTER automatically parses the command line as a DEPOSIT.
Additional information available:
Format
─┬──────>─────┬┬─>
S
T
O
R
A
G
E
A
R
E
A ───────┬─> typebox (=) value ──> └─>
D
E
P
O
S
I
T ─┘├─>
C
H
E
C
K
S
U
M ───────────┤ ├─>
C
O
U
N
T ──────────────┤ ├─> deposit-data ───────┤ ├─> deposit-entry ──────┤ ├─>
F
R
E
E
S
P
A
C
E ─────────┤ ├─> deposit-index ──────┤ ├─> deposit-line ───────┤ ├─>
L
O
C
K
E
D
F
R
E
E
S
P
A
C
E ──┤ ├─>
N
U
M
B
E
R ─────────────┤ ├─>
S
P
A
C
E range ────────┤ ├─>
T
I
M
E
S
T
A
M
P ─────────┤ ├─>
N
E
X
T
A
I
P ───────────┤ └─>
A
I
P
E
N
T
R
I
E
S ────────┘
Additional information available:
STORAGE_AREACHECKSUMCOUNTFREE_SPACELOCKED_FREE_SPACE
NUMBERSPACETIME_STAMP
deposit-datadeposit-entryINDEX ndeposit-linevalue
STORAGE_AREA
Deposits a value for the 2-byte storage area identification.
CHECKSUM
Deposits a value for the 4-byte page checksum field.
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.
deposit-data
deposit-data = ──>
D
A
T
A ─┬─┬────────>───────┬─┬───────>──────┬─┬─> offset ──> │ ├>
/
D
E
C
I
M
A
L ─────┤ ├─>
/
B
Y
T
E ─────┤ │ │ └>
/
H
E
X
A
D
E
C
I
M
A
L ─┘ ├─>
/
L
O
N
G
W
O
R
D ─┤ │ │ └─>
/
W
O
R
D ─────┘ │ └──> typebox (/)
A
S
C
I
I ──────────────────────────┘
Additional information available:
DATA offset
Deposits 1, 2, or 4 bytes of data in the radix specified. If you do not specify radix, the default radix is assumed. See the description of the RADIX command in the help file for information on how to set a default radix. The /BYTE, /LONGWORD, and /WORD qualifiers cannot be used with the /ASCII qualifier.
deposit-entry
deposit-entry = ──>
E
N
T
R
Y ──> n ────┬─────────>────────┬─> ├─>
A
B
M ───────────┤ ├─>
L
O
G
I
C
A
L
A
R
E
A ──┤ ├─>
P
H
Y
S
I
C
A
L
A
R
E
A ─┤ ├─>
A
L
E
N
G
T
H ───────┤ ├─>
A
N
A
M
E ─────────┤ ├─>
T
S
N ───────────┤ ├─>
R
E
C
O
R
D
L
E
N
G
T
H ─┤ └─>
I
N
U
S
E ─────────┘
Additional information available:
ENTRYABMLOGICAL_AREAPHYSICAL_AREAALENGTH
ANAMETSNRECORD_LENGTHINUSE
ENTRY
Refers to an area inventory page (AIP) entry on the database page. If you specify a value for n, it must be a number from 0 to 15.
ABM
Deposits the new value on the first area bitmap page for the specified AIP entry. The ABM value is contained in a longword.
LOGICAL_AREA
Deposits the new value for the number of the logical area. The LOGICAL_AREA value is contained in a word.
PHYSICAL_AREA
Deposits the new value for the number of the physical area. The PHYSICAL_AREA value is contained in a word.
ALENGTH
Deposits the new value for the length of the name of the logical area. The ALENGTH value is contained in a byte. The name of the logical area can be from 1 to 31 bytes in length.
ANAME
Deposits the new value for the name of the logical area. The ANAME value is contained in a 31 character text field.
TSN
Deposits the new value of the highest snapshot enabled transaction sequence number (TSN). The TSN value is contained in a longword.
RECORD_LENGTH
Deposits the new value for the length in bytes of the largest record. The RECORD_LENGTH value is contained in a word.
INUSE
Deposits the new value for the entry's in use flag. The INUSE value is contained in a byte.
FREE_SPACE
Deposits a value for the 2-byte field indicating how much free space remains on the page.
INDEX n
Deposits a value for the offset field or the length field for the line index indicated by n. The integers denoting INDEX n are zero based. For example, INDEX 0 refers to the first index, and INDEX 1 refers to the second index. Similarly, if you enter DEPOSIT INDEX 3 OFFSET, the offset address field from the fourth line index is deposited. The integer n is optional. The present value of the relevant pointer is the default. References to INDEX are invalid if the current page is a SPAM page.
deposit-line
deposit-line = ───>
L
I
N
E ────> n ────>
R
E
C
O
R
D
T
Y
P
E ────>
Additional information available:
LINE n
Deposits information for an individual storage segment. You can deposit a value for the record-type field or the entire content of the storage segment line indicated by n. The integers denoting LINE n are zero based. For example, LINE 0 refers to the first line, and LINE 1 refers to the second line. The integer n is optional. The present value of the relevant pointer is the default. References to LINE are invalid if the current page is a SPAM page.
LOCKED_FREE_SPACE
Deposits a value for the 2-byte field indicating how much free space is allocated for exclusive use by a run unit.
NUMBER
Deposits a value for the 4-byte page number field.
SPACE
Deposits a value for a specified range of SPAM entries; it is valid only if the current page is a SPAM page. SPACE is the only option that you can use in DISPLAY and DEPOSIT commands that access a SPAM page. range = ┬─> typebox (*) ─────────────────────────>────────────────────────────────┬─> └─> lower-data-page-number ─┬────────────────>─────────────────┬┘ └─> typebox (:) ──> higher-data-page-number ─┘ The range value can be an asterisk (*), referring to all entries, or a set of consecutive entries that you describe as shown in the preceding syntax diagram. 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.
TIME_STAMP
Deposits a value for the 8-byte time and date stamp field.
value
Specifies the new value of the field you are patching. 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 in double quotation marks ("). Time
stamps must always be enclosed in quotation marks because
they include punctuation characters.
More
Specify the field to be patched just as you would specify a field to be displayed in the DISPLAY command. The patch field specification must be followed by an equal sign (=) and a string of characters specifying the new value of the patched field. Do not use the DEPOSIT command immediately after a ROLLBACK command. The ROLLBACK command removes currency indicators. For this reason you must respecify your location by using either the DISPLAY or AREA...PAGE command immediately after a ROLLBACK command but before a DEPOSIT command.
Examples
Example 1 The following example deposits data 032c with a length of 2 bytes into offset location 0012. RdbALTER> DEPOSIT DATA/WORD 0012=032c