RDB/VMS RMU/ALTER DEPOSIT — VMS RDB_4.0B
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 command.
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_STAMPNEXT_AIPAIP_ENTRIES
deposit-datadeposit-entrydeposit-indexdeposit-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 the number of bytes specified. If you do not specify the /HEXADECIMAL or /DECIMAL parameter, 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. The value specified for n must be a number between 0 and the number of AIP_ENTRIES.
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 a value for the last TSN to enable snapshots for a logical area. The TSN value is contained in a longword.
RECORD_LENGTH
Deposits a value for the length in bytes of the record size. 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.
deposit-index
deposit-index = ──>
I
N
D
E
X ──> n ──┬─>
O
F
F
S
E
T ──┬─> └─>
L
E
N
G
T
H ──┘
Additional information available:
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. 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. 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. 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.
NEXT_AIP
Deposits a value for the page number of the next area inventory page.
AIP_ENTRIES
Deposits a value for the number of AIP_ENTRIES on the current area inventory page.
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 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 a value of 1 for SPAM entries on
pages 2 and 3 of the current storage area:
RdbALTER> AREA 6 PAGE 1
RdbALTER> DISPLAY SPACE 2:3
0000000000000000000000000000000B 0016 page 2: threshold 3
page 3: threshold 2
pages 4-65: threshold 0
RdbALTER> DEPOSIT SPACE 2:3=1
RdbALTER> DISPLAY SPACE 2:3
00000000000000000000000000000005 0016 pages 2-3: threshold 1
pages 4-65: threshold 0
Example 2
The following example deposits data 032c with a length of 2
bytes into offset location 0012 (decimal 18):
RdbALTER> DEPOSIT DATA/WORD 0012=032c
Example 3
The following example deposits the new value of 0002 in the
storage area identification field.
RdbALTER> AREA 1 PAGE 1
RdbALTER> DISPLAY STORAGE_AREA
0001 0000 area 1
RdbALTER> DEPOSIT STORAGE_AREA=0002
RdbALTER> DISPLAY STORAGE_AREA
0002 0000 area 2