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

Chapter 22 195
SOMPATCH
Operation
?D Decimal
?O Octal (two 6-digit octal numbers)
?C Characters
The display is sent to $STDLIST. The parameter
symbolname may be entered in uppercase
or lowercase or mixed case, unless it is defined in a C procedure, in which case it must be
entered in the specific case in which it is listed out from the linker. If the symbol starts
with an underbar, that should be entered as the first character.
If the values to be displayed are the result of modifications made earlier in the SOMPATCH
utility session, then the
oldvalue|newvalue convention of the MODIFY command is used to
indicate it. In the example below, only the word at iobuf+10 has been modified since the
user invoked the SOMPATCH utility. (It is currently 1234ABCD in the file and will be 200 if
the program is terminated with an EXIT command or a SAVE command.)
sp> display iobuf+2,3,?X
Return
22222222 FFFFFFFF 1234ABCD200|
Error Messages
Symbol symbolname not found.
CAUSE The JCWs are set to their respective WARN status.
ACTION Use the FIND command to search for the symbol.
EXIT
This command is used to exit the program and save the modifications made to the primary
input file. To obtain a backup copy, make one before running the SOMPATCH utility.
If the SOMPATCH utility is being run interactively and patch
xx had an error, the following
message is printed:
Error(s) in patch xx but valid modifies will be applied upon exit.
Syntax
EX[IT]
Parameters
None
FIND
This command displays the following information about a symbol:
• residency status (that is, memory resident, initially resident or neither)
• index of SOM (that is, for a multi-SOM library, which SOM contains the symbol)
• symbol type (CODE, DATA, PRIMARY PROGRAM, ...)
This command can also be used to look for a symbol when its name is not known.