The TEMPLATE EXEC

Template is not intended to be executed. Rather, it is a model for creating new execs. It contains a number of generally useful subroutines used in other execs.

Currently included in TEMPLATE are the following subroutines:

linaddr <address>

Converts an address expression to a linear address (without the % prefix). If storage cannot be referenced then a null string is returned.
getstor <h>,<a>,<s>,<f>
Retrieve a byte, word or double word from storage If storage can't be retrieved then the DF error msg is returned.

<h>

is a dump handle
<a>
is a DF address expression
<s>
is the size specified as: B, W or D
<f>
is the optional output format, which may be specified as C for character, N for decimal or X for hexadecimal string. X is the default.
gethxstr <h>,<a>,<l>
Retrieve a string of hex bytes from storage. If storage can't be retrieved then a null string is returned. The string is returned as a concatenated string of bytes.

<h>

is a dump handle
<a>
is a DF address expression
<l>
is the length of storage to retrieve
getbytes <h>,<a>,<l>
Retrieve a one or more bytes from storage. If storage can't be retrieved then a null string is returned. The string is returned as a string of bytes separated by blanks.

<h>

is a dump handle
<a>
is a DF address expression
<l>
is the length of storage to retrieve
getwords <h>,<a>,<l>
Retrieve a one or more words from storage. If storage can't be retrieved then a null string is returned.

<h>

is a dump handle
<a>
is a DF address expression
<l>
is the length of storage to retrieve
getdwords <h>,<a>,<l>
Retrieve a one or more double words from storage. If storage can't be retrieved then a null string is returned.

<h>

is a dump handle
<a>
is a DF address expression
<l>
is the length of storage to retrieve
getqwords <h>,<a>,<l>
Retrieve a one or more quadruple words from storage. If storage can't be retrieved then a null string is returned.

<h>

is a dump handle
<a>
is a DF address expression
<l>
is the length of storage to retrieve
format <name>,<offset>,<base>,<type>,<desc>
Format a field from a control block and returns the value of the field.

<name>

is the field name.
<offset>
is a relative hex offset (prefix with + or -)
<base>
is the base address of the control block
<type>
is the filed type (b=byte, w=word, d=double word)
<desc>
is a description of the filed.
fmtblock <name>,<offset>,<base>,<type>,<number>,<desc>
Formats a table of bytes, words or double words imbedded in a control block.

<name>

is the field name.
<offset>
is a relative hex offset (prefix with + or -)
<base>
is the base address of the control block
<type>
is the filed type (b=byte, w=word, d=double word)
<number>
is the number of entries in the table
<desc>
is a description of the filed.

---

[Back: The PS EXEC]
[Next: Process Dump Formatter]