HP 3000 Manuals

MESSAGE Command [ HP ALLBASE/4GL Developer Reference Manual Vol. 2 ] MPE/iX 5.0 Documentation


HP ALLBASE/4GL Developer Reference Manual Vol. 2

MESSAGE Command 

The MESSAGE command displays a message on the screen.

Formats 

     MESSAGE message_name 

Parameters 

message_name 

The name of a message defined previously using the dictionary message
definition screen.

Description 

The MESSAGE command displays a message on the screen.  You can use this
command to request user input, to query input, or to display information
and warnings.

You must define the message using the dictionary message definition
screen (refer to chapter 5.

A code associated with each message determines how HP ALLBASE/4GL
displays the message.  The codes are:

   *   Mess.  A note for user information only.  No user response is
       required.

   *   Query.  A query or prompt that requires a response from the user.

   *   Warn.  A warning requiring no response from the user.

   *   Error.  An error that requires corrective action by the user.

   *   Abort.  A system error that terminates the current HP ALLBASE/4GL
       application.

HP ALLBASE/4GL displays all messages on a two-line window at screen lines
23 and 24.

Query 
Messages 

When you use a MESSAGE command to request and acquire user input, the
system positions the cursor at the start of an input field in the message
window to receive the user's response.

Pressing Return terminates the user's entry.  A carriage return character
by itself is acceptable as data.  HP ALLBASE/4GL checks the user's
response to ensure that it complies with the the edit code defined for
the message response item.  HP ALLBASE/4GL stores data entered by the
user in the response item specified in the message definition screen.

Example 

     MESSAGE no_stock

This command displays the message no_stock within the message window.



MPE/iX 5.0 Documentation