Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Format

More

Examples

STORAGE_AREA

CHECKSUM

COUNT

FREE_SPACE

LOCKED_FREE_SPACE

NUMBER

SPACE

TIME_STAMP

deposit-data

deposit-entry

INDEX n

deposit-line

value

DATA offset

ENTRY

ABM

LOGICAL_AREA

PHYSICAL_AREA

ALENGTH

ANAME

TSN

RECORD_LENGTH

INUSE

LINE n

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:

FormatMoreExamples

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

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

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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026