DLG-SETMSG

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:

If you use Format 2, include at least one of the parameters.
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