Mask sequence
| -> 6 -> |
|
Function
The MODIFY-MSG mask is the first of a series of four masks that can be called to modify a message unit in the current message file.
Once the message file to be processed has been entered in the main mask MENU and function 6 (Modify) has been selected, MSGMAKER displays the MODIFY-MSG mask.
The first message unit is displayed once a message range has been entered in the First msg-id (and, if applicable, the Last msg-id) field and confirmed by pressing the DUE key.Only then can the message attributes of the message unit be modified in the MODIFY-MSG mask. If the texts are also to be modified (by inserting, appending, deleting or replacing lines of text), highlighting the following fields (and then pressing DUE) calls the relevant masks.
X msg-text | MSG-TEXT mask |
X meaning + response | MEANING / RESPONSE mask |
X Insert attributes | INSERT-ATTRIBUTES mask |
If the modifications only affect the message attributes, they must be confirmed in the MODIFY-MSG mask with DUE and saved to the message file. More complex modifications within a message unit (message text, inserts, ...) are only saved to the message file once the user has run through all the necessary masks.
If a message unit is not to be modified within the selected message range, the user can skip that message code with K1. The function key is offered in the mask as soon as the user has read the message units into the message file with DUE.
Mask
Output fields
File (name of the message file)
The name entered in the main mask MENU is transferred to the MODIFY-MSG mask. This name must not be modified.
The selected message range is displayed at the right-hand edge of the information area. (Note: this is not shown in the mask)
Input fields
First msg-id (first message code of the message range)
If a message range is entered in the First msg-id field and confirmed by pressing the DUE key, all defined message codes of this message range are displayed in turn. The cursor is positioned on the Access method(s) field to enable the message unit to be processed.
Validity criteria:
Seven-character message code or partially qualified message code in which the asterisk * can stand for between one and seven characters and the # character can stand for between one and four digits. The first three characters must be letters (message class).
Example
Valid specifications for <partial msg-id>* or # are:
A*, AB*, ABC*, ABC0*, ABC00*, ABC000*
ABC#, ABC0#, ABC00#, ABC000#
The entry * selects all defined message codes. For further information on message codes, see the “Introduction to System Administration” [5 (Related publications)].
Last msg-id (last message code of the message range)
The specified message code identifies the last message unit of a message range. Only one message unit is selected if the message code matches the specification in the First msgid field or the keyword (same) is transferred.
Validity criteria:
Seven-character message code; if the field is empty, the message code is transferred from the First msg-id field. For further information on message codes, see the “Introduction to System Administration” [5 (Related publications)].
Display: (same)
Access method(s) (MIP message access methods)
Indicates the methods used by the system component MIP to access the messages. It is possible to select more than one access method; however, the ISAM and DLAM methods and the ISAM and LOCAL-DLAM methods must not be combined.
Validity criteria:
The access methods must be marked with the character “X”.
ISAM
MIP searches for messages via the ISAM key.
DLAM
This access method is used for particularly frequent messages. If a message file containing a DLAM message is activated, the DLAM message is loaded into main memory. MIP can output the DLAM message directly without accessing the message file.
LOCAL-DLAM / MINIMIP / BAMR
These access methods are reserved for internal use with the manufacturer.
Destination(s) (message output destinations)
This specification allows the user to document the output destinations. The MSG7X macro and the /HELP-MSG-INFORMATION command do not evaluate this specification.
Validity criteria:
The output destination must be marked with the character “X”.
Entries can be deleted by overwriting the fields with blanks or null characters, and selected again using “X”.
user-task
The message output destination is SYSOUT, SYSLST or a user-specific memory area.
console
The message output destination is a console. The routing code is evaluated as a destination specification.
Routing code
A routing code must be specified if in the Destination(s) field, the output destination console was selected. Further information is provided in the "Introduction to System Administration” [5 (Related publications)].
Validity criteria:
Data type: <alphanum-name 1..1>
Weight (message priority)
A message weight must be specified if in the Destination(s) field, the output destination console was selected. Further information is provided in the "Introduction to System Administration” [5 (Related publications)].
Validity criteria:
Data type: <integer 0..99>
The message attribute “Warranty” is evaluated by MIP.
The warranty declaration indicates that specific parts of the message will not be modified in future BS2000 versions.
The following message components are guaranteed:
message code
numbering and meaning of inserts
The message text is not guaranteed.
MIP creates S variables for warranty messages. Further information is provided in the "Introduction to System Administration” [5 (Related publications)].
Language(s) (1-letter language identifier)
A 1-letter identifier is used as an abbreviation for each language. The letter D stands for German and E for English.
If a language identifier is displayed in the MODIFY-MSG mask, the user can neither modify it by overwriting it with another letter nor delete it by overwriting it with a blank.
The language identifier can be modified only in the MSG-TEXT mask (see the description on "MSG-TEXT mask - Add or modify message text"). The MSG-TEXT and DELETE-MSG masks allow the user to delete the language identifier and thus also the message text.
Validity criteria:
The letters “A” through “Z”.
Edit (text selection)
Selects the texts to be modified.
Validity criteria:
The texts must be marked with the character “X”.
msg text
The MODIFY-MSG mask is followed by the MSG-TEXT mask, which allows the user to modify the message texts in the different languages. For a description of the MSG-TEXT mask, see "MSG-TEXT mask - Add or modify message text".
meaning + response
The MSG-TEXT mask is followed by the MEANING/RESPONSE mask, which allows the user to modify the meaning and response texts. For a description of the MEANING/RESPONSE mask, see "MEANING/RESPONSE mask - Add or modify meaning and response text".
insert attributes
The MSG-TEXT and MEANING/RESPONSE masks are followed by the INSERT-ATTRIBUTES mask, which allows the user to modify the insert attributes. For a description of the INSERT-ATTRIBUTES mask, see "INSERT-ATTRIBUTES mask - Add or modify insert attributes".
Command
For detailed information on
entering statements, see "General mask format"
function key assignment, see "General mask format"
Follow-on operations:
| -> ? |
DUE | The MODIFY-MSG function is initiated; modifications to message attributes are saved to the message file; for text modifications MSGMAKER branches to the selected masks. |
K1 | If a message range is entered in the MODIFY-MSG mask and confirmed with DUE, MSGMAKER offers the skip option K1. The user can then skip this message code. After that, the MODIFY-MSG mask appears with the next message code. |
F3 | The MODIFY-MSG function is aborted; modifications to previously edited messages are stored in the message file and modifications to the current message code are lost. MSGMAKER returns to the original MENU mask. |