Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
Displays a message on the standard list device. (NM)
ECHO [message]
message The message to be displayed to the $STDLIST.
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.
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.
Commands: CALC, SET, SETVAR Manuals : Appendix A, "Predefined Variables" in the Commands Reference Manual (32650-90003) Back to Main Index