Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

/PATCH_AREA

PATCH DEPOSIT — VMS 5.1-B

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:

ParametersQualifiers

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

/PATCH_AREA

     Signals PATCH to  deposit  the  data  or  instructions  into  the
     current patch area, starting at the specified location.


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