ECHO



ECHO

     Displays a message on the standard list device.

SYNTAX

     ECHO [message]


PARAMETERS

message              The message to be displayed to the $STDLIST.


OPERATION

     Displays its argument, message, on the standard list device
     ($STDLIST).  The command ignores delimiters. Quotation marks
     are not required around message.  ECHO does not perform
     dereferencing of any kind.  If you want variable
     dereferencing you must use explicit dereferencing (!) in the
     argument. A null message ( [Return] ) displays a linefeed.

     The ECHO command is not suppressed by OPTION NOLIST in a
     UDC file or command file, nor is it suppressed by any setting of
     the HPMSGFENCE CI variable.

This command is available in a session or a job, in BREAK and
from a program. Pressing [Break] has no effect on this
command.

EXAMPLE(S)

     SETVAR a, 'hi there'  ** sets a to 'hi there' **

     ECHO a
     a

     Although there is a variable name a that has a string value,
     ECHO simply displays the character "a" because no
     dereferencing has been specified.

     ECHO !a
     hi there

     This time, ECHO is given the value of the variable, a
     argument.  Explicit dereferencing has been specified and the
     dereferencing is done before ECHO is executed.

     ECHO !!a
     !a

     Two exclamation points are resolved to one exclamation point
     by string substitution, and MPE/iX is prohibited from making
     the value substitution (even number rule).

     ECHO !!!a
     !hi there

     Triple (or any odd number of) exclamation points treat the
     argument as !!!a, which resolves to ! and !a, giving !hi
     there (odd number rule).

Another example

     IF CIERROR <> 0 THEN
ECHO ** A CIERROR OCCURRED! (CIERR !CIERROR) **

This command line used in a User Command would generate a
message when an error occurred

** A CIERROR OCCURRED! (CIERR 975) **

The first instance of CIERROR has no dereferencing, and so
ECHO treats it literally. The second instance, !CIERROR,
contains explicit dereferencing, and so MPE/iX substitutes a
value for the system variable CIERROR before the message is
displayed to $STDLIST.

ADDITIONAL INFORMATION

Commands:   CALC, SET, SETVAR

Manuals :   Appendix A, "Predefined Variables" in the Commands
            Reference Manual (32650-90003)