MSGLOC (Message Location) keyword for display files
You use this file-level keyword to move the message line to the specified line number.
MSGLOC(line-number)
The parameter value is required and must be in the range 1 through 28. Any of these numbers are always valid, regardless of the display sizes specified on the DSPSIZ keyword. A diagnostic will be issued when the file is opened if a message location is in the 26 to 28 range for a 24 x 80 display size.
- Validity check errors
- Invalid function key messages
- Messages defined as parameter values for the ERRMSG and SFLMSG keywords
- Messages identified by the ERRMSGID and SFLMSGID keywords (the entire display is used for message help)
- Message fields
- Operator error codes and their associated messages
Display size condition names must be specified if the message line for the secondary display size is different from the default message line.
- 24 x 80 display size:
- line 25
- 27 x 132 display size:
- line 28
- If the display is sent to a 5250 device or a 5251 model 12, line 24 is used as the message line.
- If the display is sent to a 3180-2 device or a 3197 model D1, D2, W1, or W2 attached to a local 6040 or 6041 controller, or remotely attached to a 5294 or 5394 controller, line 25 is used as the message line.
- 24 x 80 display size:
- line 24
- 27 x 132 display size:
- line 27
The MSGLOC keyword specification is in effect continuously from file opening to file closing. It can be temporarily overridden if the file you are defining is suspended while another file is opened to the same workstation device. The message location in effect for the other file is used until the file that you are defining is restored.
Any data on the message line before the message appears is saved and restored after the Reset key is pressed.
Option indicators are not valid for this keyword.
Examples
The following examples show how to specify the MSGLOC keyword.
Example 1
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A MSGLOC(1)
A
In this example, the message line is moved to line 1 for the primary display size. (Without the DSPSIZ keyword, the primary display size is the 24 x 80 display.)
Example 2
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A DSPSIZ(*DS3 *DS4)
A MSGLOC(1)
A *DS4 MSGLOC(1)
A
The message line is moved to line 1 for both the primary display size 1 and the secondary display size 2.