DELETE-MSG - Delete message unit

Function

The //DELETE-MSG statement deletes one or more message units from the opened message file.
It is also possible to delete language-dependent message components such as message, meaning and response texts. The user should note, however, that the entire message unit is deleted automatically once all its texts have been deleted.

Differences compared with the //DELETE-MSG statement in menu mode

The //DELETE-MSG statement that can be entered in the command area of the screen mask differs from the //DELETE statement in command procedures in that

• in menu mode, the operand value *PANEL-REQUEST can be assigned to any operand.

• an additional value can be specified for the MSG-ID operand.

For further details, see section “Special features of statements in menu mode”.

Format

DELETE-MSG                                                                                                                                                

MSG-ID = *ALL / *CLASS(...) / *INTERVAL(...) / list-poss(2000): <name 7..7>
	*CLASS(...)
		|	MSG-CLASS = <name 3..3>
	*INTERVAL(...)
		|	FROM = <name 7..7>
		|	,TO = <name 7..7>
,LANGUAGES = *ALL / list-poss(8): <name 1..1>

Operands

MSG-ID = *ALL / *CLASS(...) / *INTERVAL(...) / list-poss(2000): <name 7..7>
Designates one or more message units which are to be modified.

MSG-ID = *ALL
All message units of the current message file are deleted.

MSG-ID = *CLASS(...)
Message units whose message code begins with the specified message class are deleted.

MSG-CLASS = <name 3..3>
Specifies the three-letter message class.

MSG-ID = *INTERVAL(...)
All message units whose message code is within the defined message range are deleted. The specified range limits must belong to the same message class.

FROM = <name 7..7>
Specifies the first message code of the message range.

TO = <name 7..7>
The full seven-character message code must be specified.

MSG-ID = list-poss(2000): <name 7..7>
The message unit to be deleted is specified by means of a full message code. A list of message codes may be specified.

LANGUAGES = *ALL / list-poss(8): <name 1..1>
Specifies the identifiers for the defined languages. Message, meaning and response texts in the specified language are deleted.

LANGUAGES = *ALL
The entire message unit is deleted, including all message attributes, insert attributes and texts.

LANGUAGES = list-poss(8): <name 8..8>
Up to eight language identifiers may be specified; the texts in these languages are deleted.

Example

//DELETE-MSG MSG-ID=*CLASS(TST),LANGUAGE=E