ARRAY PSAM/DAPDB Commands ARRAY
NAME
array - display the contents of array store
SYNOPSIS
array <address> [w] [<typesize>] [<count>]
array <address> r [<typesize>] [<startbit>] [<count>]
array <address> v [<typesize>] [<rows>] [<cols>] [<count>]
DESCRIPTION
The array command displays data in DAP array store. To
access data an address must be supplied. This address is
optionally followed by a parameter specifying the storage
mode of the data. There are three storage modes which can be
displayed: wordpack, rowpack and vertical using the w, r and
v parameters respectively. If no parameter is specified it
is assumed that the data is stored in wordpack mode. A
number of parameters specifying the type of data, the posi-
tion at which to begin displaying data and the number of
items to display may accompany the storage mode parameter.
If conflicting options are requested (such as r v), the last
one is used and previous ones ignored. The address of the
data to be displayed can be specified in the following ways:
name a data section.
name+plane.row.word a name plus an offset.
plane.row.word an absolute address.
plane.row.word(m<1-7>) an address with a modifier. The
contents of the specified MCU
register are added to the absolute
address.
The address parameter must appear first. The order of subse-
quent parameters is not significant. The storage mode param-
eter has already been described. The other parameters are as
follows:
typesize specifies the type and size of data to be output.
This parameter comprises a single character speci-
fying the type of data optionally followed by an
integer specifying the length of the data in bits.
Valid values for type are:
a address
b bit
c character
e real
h hexadecimal
i integer
AMT Release 4.1S Last change: 8th January 1990 1
ARRAY PSAM/DAPDB Commands ARRAY
The default type is h and the default size is 32.
The size of integer, bit and hexadecimal data must
be in the range 1 to 64. The size of real numbers
must be a multiple of 8 in the range 24 to 64.
The size of character data must be a multiple of 8
in the range 8 to 64. The size of data displayed
in address format must be 32.
rows specifies the number of rows to be displayed
within a matrix. It takes the form:
[<firstrow>]-[<lastrow>]
<firstrow> and <lastrow> are integers in the range
0 to ES-1, where ES is the edge size of the DAP.
The default for <firstrow> is 0 and that for <las-
trow> is ES-1. This parameter is only applicable
in vertical mode.
cols specifies the number of columns to be displayed
within a matrix. It takes the form:
[<firstcol>]| [<lastcol>]
<firstcol> and <lastcol> are integers in the range
0 to ES-1. The default for <firstcol> is 0 and
that for <lastcol> is ES-1. This parameter is only
applicable in vertical mode.
count specifies the number of times the current command
will be repeated on successive items of data. It
takes the form:
*<number of data items>
<number of data items> is an integer. Note that in
vertical mode a data item is the whole of a
matrix.
startbit specifies the bit in a row at which the required
data starts. It takes the form:
/<bit offset>
<bit offset> is an integer. If no bit offset is
specified printing begins from the first bit of
the data. This parameter is only applicable in
rowpack mode.
Repeated array store data in wordpack or rowpack storage
mode is subject to term collection if the Term_collection
AMT Release 4.1S Last change: 8th January 1990 2
ARRAY PSAM/DAPDB Commands ARRAY
environment variable has a value greater than zero.
Array store data in vertical storage mode is regarded as
two-dimensional and term collection occurs on the first or
both dimensions if Term_collection has the value 1 or 2
respectively. In addition, the display of data in vertical
1-bit storage mode is controlled by the Pattern_mode
environment variable. Values of 1 or 2 cause such data to be
displayed as 1-dimensional or 2-dimensional patterns respec-
tively.
EXAMPLES
array 400.3 prints one 32-bit hexadecimal value
at plane 400 row 3.
array ..4000 i17 *10 prints 10 wordpacked 17-bit
integers starting at word 4000.
array dataname+.25 r b12 /5
prints one 12-bit binary value
starting at bit 5 in row 25 of data
section dataname.
array 0(m5) v e24 27- prints rows 27 to the last row of a
matrix of 24-bit real data items
starting at the plane addressed by
MCU register M5.
array 20 v b1 prints plane 20 as a matrix of 1-
bit data items.
array 120 v e32 1|5 7-10 prints the region between columns 1
to 5 and rows 7 to 10 inclusive of
the matrix of 32-bit real data
items starting at plane 120.
SEE ALSO
attributes, map, print, register, set
AMT Release 4.1S Last change: 8th January 1990 3