MPE/iX System Utilities Reference Manual (32650-90882)

Chapter 22 203
SOMPATCH
Operation
Syntax
SOM [
somindex ]
[
somname ]
[@ ]
[? ]
Parameters
somindex Specifies an index (starting at 0) of the desired SOM.
somname Indicates the name of the SOM (as shown by the LISTXL command in
linker, or by SOM @.)
@ Shows all SOMs in the current file.
? Shows which SOM is current for patching.
SYMBOL
This command finds the next level 1 procedure after the symbol+offset specified.
Syntax
SYMBOL
symbolname +- offset
Parameters
symbolname The LST symbol name.
offset The byte offset of the patch from symbolname .
This command is used in generating level 1 patches for multi-SOM libraries.
For a very large file, such as the native mode system library, there may be a five-second to
ten-second delay for symbol lookup. In this case, the message searching... is displayed
every 15,000 symbols.
For Pascal level 2 procedures, the code being patched is represented as a positive offset
from the last level 1 procedure; however, this level 1 procedure is often in a different
relocatable object file from the level 2 procedure being patched. This is because of the way
that Pascal code is generated:
------------------------
| Proc A's Level 2 code|
| |
ProcA + 0000-->------------------------
| Proc A -- Level 1 |
| |
------------------------
ProcA + 00xx-->| Proc B's Level 2 code| <-- code being patched
| |
ProcB + 0000-->------------------------
| |
| Proc B -- Level 1 |
------------------------