LINEDIT !lacro HEX, expression
converts the given expression to graphic hexadecimal format and
substitutes it in the message text. The expression may be a
symbolic address or symbol equate; it is evaluated by means of a
LOAD ADDRESS (LA) instruction. For example, if your program has a
label BUFF1, the line:
LINEDIT TEXT='BUFFER IS LOCATED AT •••••• ',SUB=(HEX,BUFP1) miqht result in the display: BUFFER IS LOCATED AT 0201AC. If vou code fewer than eight periods in the message text, leading are truncated; leading zeros are not suppressed.
DEC, (req) converts the value in the specified register into graphic deciaal
format and substitutes it in the message text. Leading zeros are
suppressed. If the number is negative, a leading minus sign is
inserted. For example, if register 3 contains the decimal value 10,345, then the macro instruction:
LINEDIT TEXT=' REG 3 = •••••• ', SUB= (DEC, (3») results in the line:
REG 3 = 10345. DEC, expression
converts the given expression to graphic decimal format and
substitutes it in the message text. The expression may be a
symbolic label in your program or a symbol equate. For example, if program contains the statement: VALUE EQU 2003 then the macro instruction:
LINEDIT TEXT='VALUE IS •••••• ',SUB=(DEC,VALUE+5) results in the display: VALUE IS 2008. HEXA,address converts the fullword at the specified address to graphic heradecimal format and substitutes it in the message text. If you
code fewer than eight periods in the message text, leading digits
are truncated; leading zeros are not removed. For example, if you
coda:
LINEDIT TEXT='HEX VALUE IS ••••• ·,SUB=(HEXA,CODE) then the last five hexadecimal digits of the fullword at the label
CODE are substituted into the message text.
HE XA, (reg)
converts the fullword at the address indicated in the specified reqister into graphic hexadecimal format and substitutes it in the
message text. For example, if you code:
LINEDIT TEXT='REGISTER 5 -> •••••• ·,SUB=(HEXA,(5») section 6. C!lS !lacro Instructions 323

LINEDI'!' Macro
then the last six hexadecimal digits of the fullword whose address
is in register 5 are substituted in the message text.
If you code fewer than eight digits, leading digits are truncated;
leading zeros are not suppressed. DECA,address converts the fullword at the specified address to graphic decimal
format. Leading zeros are suppressed; if the number is negative, a
minus sign is inserted. For example, if you code: LINED IT TEXT='COUNT = •••••• ·,SUB=(DECA,COUNT) then the fullword at the location COUNT is converted to graphic
decimal format and substituted in the message text. DECA, (reg)
converts the fullword at the address register into graphic decimal format
message text. For example:
specified in the indicated
and substitutes it in the
LINEDIT TEXT='SUM = .......... ·,SUB=(DECA,(3») causes the value in the fullword whose address is in register 3 to
be displayed in graphic decimal format. HEX4A.,address converts the data at the specified address into graphic hexadecimal
format, and inserts a blank character following every four bytes
(eight characters of output). The data to be converted does not have to be on a fullword boundary. When you code periods in the message text for substitution, you
must code sufficient periods to allow for the blanks. Thus to
display 8 bytes of information (16 hexadecimal digits), you must
code 17 periods in the message text.
For example, to display seven bytes of hexadecimal data beginning
at the location STOR in your program, you could code: LINEDIT TEXT='STOR: ••••••••••••••• ·,SUB=(HEX4A,STOR) might result in a display: STOR: OA23F115 78ACFE Note that 15 periods were coded in the message text, to allow for
the blank following the first four bytes displayed.
HE 1(4 A., (r eg)
converts
register
character
output) .
the data at the address indicated in the specified
into graphic hexadecimal format and inserts a blank
following every four bytes displayed (eight characters of When you code the
sufficient periods
inserted.
message text for substitution, you must code
to allow for the blank characters to be
For example, the line:
L INEDI T TEXT=' BU FFER: ••••••••••••••••••••• , SUB= (HEX4 A, (6) )
324 IBM VM/370 CMS Command and Macro Reference