System Debug Reference Manual (32650-90888)

358 Chapter10
System Debug Standard Functions
func asc
The F directive (fixed field width) selects a fixed field width based on the
type of the value and the selected output base. Fixed field widths are listed
in the following table:
The Wn directive (variable field width) allows the user to specify the
desired field width. The W directive can be specified with an arbitrary
expression. If the specified width is less than the minimum necessary
width to display the value, then the user width is ignored, and the
minimum width is used instead. All significant digits are always printed.
For example:
number:"w6"
number:"w2*3"
The number of positions specified (either by Wn or F) does not include the
characters required for the radix indicator (if specified) or sign (if
negative). Also, the sign and radix indicator is always positioned just
preceding the first (leftmost) character.
Zero versus blank fill applies to leading spaces (for right justification) only.
Trailing spaces are always blank filled.
In specifications with quotes, the quotes do not count in the number of
positions specified. The string is built such that it appears inside the
quotes as it would without the quotes.
The T directive (typed) displays the type of the value, preceding the value.
The U directive (untyped) suppresses the display of the type. Types are
displayed in uppercase, with a single trailing blank. The width of the type
display string varies, based on the type, and it is independent of any
specified width (M, F, or Wn) for the value display.
For values of type LPTR (long pointer,
sid.offset , or seg.offset ) and
EADDR (extended address,
sid.offset or ldev.offset ), two separate
format directives can be specified. Each is separated by a dot, ".", to
indicate individual formatting choices for the "
sid " portion and the
"
offset " portion. This is true for all code pointers (ACPTR - Absolute Code
pointers: CST,
CSTX; LCPTR - Logical Code Pointers: PROG, GRP, PUB, LGRP, LPUB,
Types hex($,H) dec(#,D) oct(%,O) ascii(A,N)
S16,U16 4662
S32,U32 810114
S64 16 20 22 8
SPTR 810114
LPTR Class 8.8 10.10 11.11 8
EADDR Class 8.16 10.20 11.22 12
STR field width = length of the string