PATCH DEPOSIT — VMS 5.5
Use DEPOSIT to deposit new data or instructions into one or more
consecutive locations.
Depositing Data or Instructions:
__________ ____ __ _____________
The DEPOSIT command lets you replace the contents of a
location or of several consecutive locations in terms of the
current mode settings. The DEPOSIT command does not
request verification of the current contents before replacing
the contents with new data or instructions (that is, this command
assumes that you know what you are doing). In cases when you want
to confirm that data or instructions that will be overwritten,
use the REPLACE command.
When you are adding instructions to an image file, the INSERT
command, which performs automatic branching to and from the patch
area, is easier to use.
Depositing Data or Instructions into Patch Area:
__________ ____ __ ____________ ____ _____ _____
The /PATCH_AREA qualifier causes the data or instructions to be
inserted into the current patch area. The location you supply must
be the first free byte in the patch area. To determine the first
free byte in the patch area, issue the SHOW PATCH_AREA command
or the ALIGN/BYTE command. After you deposit the data, PATCH
updates the patch area string descriptor to reflect the modifications.
Unlike the INSERT and REPLACE commands, the DEPOSIT/PATCH_AREA
command requires that you insert the branch instructions into the
appropriate locations to maintain the logical flow of program
execution to and from the patch area.
Format:
DEPOSIT location = new-contents [,...]
Mode Qualifiers Defaults
____ __________ ________
/BYTE
/WORD /LONG
/LONG
/OCTAL
/DECIMAL /HEXADECIMAL
/HEXADECIMAL
/[NO]ASCII /NOASCII
/[NO]INSTRUCTION /NOINSTRUCTION
/[NO]SYMBOLS /SYMBOLS
/[NO]GLOBALS /NOGLOBALS
/[NO]SCOPE /SCOPE
Prompts:
LOC> location
NEW> new-contents
Additional information available:
Parameters
location
Specifies either (1) a single location whose contents are to be
overwritten or (2) the starting address of a sequence of
locations whose contents are to be overwritten.
new-contents
Specifies one or more data entries or instructions to be
inserted. Do not enter conflicting data types with a single
DEPOSIT command.
Qualifiers
Additional information available:
/PATCH_AREA
Signals PATCH to deposit the data or instructions into the
current patch area, starting at the specified location.