Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

7.1.1 ABORT Parameters

MSGTXT

MSGID

MSGF

MSGDTA

Anchor
MSGTXT
MSGTXT
MSGTXT

Allows up to 80 characters of message text to be specified. This text will be displayed when the function ends as an error message. The message text specified should be enclosed in quotes. Use either the MSGTXT parameter or the MSGID/MSGF parameters but not both.


Anchor
MSGID
MSGID
MSGID

Allows a standard message identifier to be specified as the message that should be issued when the function ends. Message identifiers must be 7 characters long. Use this parameter in conjunction with the MSGF parameter.


Anchor
MSGF
MSGF
MSGF

Specifies the message file in which the message identified in the MSGID parameter will be found. This parameter is a qualified name. The message file name must be specified. If required the library in which the message file resides can also be specified. If no library name is specified, library *LIBL is assumed.


Anchor
MSGDTA
MSGDTA
MSGDTA

Use this parameter only in conjunction with the MSGID and MSGF parameters. It specifies from 1 to 20 values that are to be used to replace "&n" substitution variables in the message specified in the MSGID parameter.

...

When using alphanumeric literals in this parameter, remember that trailing blanks may be significant. For instance, if a message is defined as:

...

   "&1 are out of stock ... reorder &2"

where &1 is defined as (*CHAR 10) and &2 as (*DEC 7 0), then the message will NOT be issued correctly if specified like this:

...

   MSGDTA('BOLTS' #ORDQTY)

or like this:

...

   MSGDTA('BOLTS     ' #ORDQTY)

To make LANSA aware of the trailing blanks, the parameter must be specified like this:

...

   MSGDTA('''BOLTS     ''' #ORDQTY)

When expandable expressions are used, the expanded field list must not exceed the maximum number of substitution variables allowed in the parameter.