MPE/iX Intrinsics Reference Manual (32650-90875)
508 Chapter9
Command Definitions (MAIL-PUTJCW)
MYCOMMAND
delimiter is identified later by its position in this string.
Default: The delimiter array ",=; (carriage return)".
maxparms
16-bit signed integer by value (required)
Passes the maximum number of parameters expected in
cmdimage
.
Accepts values from 0 to 8192.
numparms
16-bit signed integer by reference (required)
Returns the number of parameters found in
cmdimage
.
params
32-bit signed integer array (required)
Returns an array of
maxparms
entries.
Numparms
entries are returned that
delineate the parameters. Each entry consists of two 32-bit words. When
the intrinsic is executed, the first
numparms
entries are returned to your
process in this array, with the first entry corresponding to the first
parameter, the second entry corresponding to the second parameter, and so
forth. The parameter fields of
cmdimage
are delimited by the delimiters
specified in
delimiters
. The pointer in the first word of each entry points
to the parameter in
cmdimage
. The string in
cmdimage
is upshifted. The
second word of
params
contains the delimiter number and parameter
information. Each word in the array named by
params
contains the
following information:
• Word 1: The pointer to the first character of the parameter. If the
parameter is empty or all blanks, the pointer indicates the location of
the delimiter.
• Word 2: Bits that describe the parameter:
Bits Value/Meaning
27:5 The zero-relative position of the delimiter in
delimiters
. For example, if
you use the default
delimiters
array and the current parameter is
delimited by a semicolon, this field contains 2.
26:1 Special characters indicator bit (set by MYCOMMAND):
0 The parameter contains no special characters.
1 The parameter contains special characters other than
those listed in
delimiters
.
25:1 Numeric character indicator:
0 The parameter does not contain numeric characters.
1 The parameter contains numeric characters.
24:1 Alphabetic characters indicator:
0 The parameter does not contain alphabetic characters.
1 The parameter contains alphabetic characters.
16:8 The length of the parameter in bytes. This value is zero if you omit the
parameter.