MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 9 507
Command Definitions (MAIL-PUTJCW)
MYCOMMAND
MYCOMMAND
NM and CM callable (difference noted below).
Parses (delineates and defines) parameters for a user-defined command image.
Syntax
I16 CA CA
entrynum :=MYCOMMAND( cmdimage , delimiters ,
I16V I16 I32A
maxparms,numparms,params ,
CA @*
dictionar,definition );
Functional Return
entrynum 16-bit signed integer (assigned functional return)
Returns the command entry number. If the
dictionary parameter is not
specified, 0 is returned.
Parameters
cmdimage character array (required)
A
cmdimage must begin with an alphabetic character. The first
non-alphanumeric character (or space) encountered terminates the
command name. Whatever follows is interpreted as an element of the
parameter list.
Passes one of two things:
• Command name (if the
dictionary parameter is specified), then
parameters and a carriage-return character (%15). The command name
is delimited by the first nonalphanumeric character and cannot be
preceded by any leading blanks. One or more blanks is expected after
the command name, preceding the parameter list. The parameters are
formatted and referenced in the
params array and cmdimage is
converted to uppercase, and the character array specified by
dictionary is searched for a name matching the command.
• Command parameters (if the
dictionary parameter is not specified),
then a carriage-return character (%15). These parameters are
formatted. Leading and trailing blanks are ignored. Lowercase is
upshifted.
delimiters character array (optional)
Passes a string of up to 32 legal delimiters, each of which is an ASCII
special character. The last character must be a carriage return. Each