DLG-SETMSG

Display a message on the next panel; define message text and attributes.
Restriction: This topic applies only when the AppMaster Builder AddPack has been installed, and applies only to Windows platforms.

Targets:

DLG

Syntax: for Format 1

SETMSG definition

DLG-SETMSG
... [SHORT 'shortmessagetext']
... [LONG 'longmessagetext']
... [ALARM 'YES'|'NO'] [HELP 'helppanelname']

Syntax: for Format 2

SETMSG definition for execution by Format 3

DLG-SETMSG erroridentifier

... [SHORT 'shortmessagetext']
... [LONG 'longmessagetext']
... [ALARM 'YES'|'NO']
... [HELP 'helppanelname']

Syntax: for Format 3

SETMSG execution

DLG-SETMSG [erroridentifier|messageID]

General Rules:

  1. If you use Format 2, include at least one of the parameters.
  2. Data field DLG-SETMSG-RC checks the return code after call execution.

Parameters:

ALARM

Sound alarm when screen displays.

error-identifier

Unique name referencing predefined message text and attributes.

HELP 'help panelname'

Help panel that displays via PF1.

messageID

ISPF MSGID for SETMSG service.

LONG 'long messagetext'

Display text in long message field when the end user presses PF1 for the first time. Messagetext must fit on the same line as LONG.

SHORT 'short messagetext'

Display text in short message field. Messages longer than 24 characters can cause truncation errors. Messagetext must fit on the same line as SHORT.

Example:

Define a message for an invalid option condition. INVALID-OPT (error identifier) identifies the message information to display when DLG-SETMSG is invoked in the execution format.
DLG-SETMSG INVALID-OPT
... SHORT 'INVALID OPTION'
... LONG  'ENTER ONE OF THE LISTED OPTIONS'
... ALARM 'YES'
Then, display the invalid option message.
IF  SCRA-OPTION = 'value'
    /* VALID CONDITION
ELSE
    DLG-SETMSG INVALID-OPT