MSGLOC (Message Location) keyword for display files

You use this file-level keyword to move the message line to the specified line number.

The format of the keyword is:

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.

If MSGLOC is not specified, the message line is the last line of the display. The message line is the display location for the following messages:

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.

If you do not specify the MSGLOC keyword, the following default values are to be established:

24 x 80 display size:: line 25
27 x 132 display size:: line 28

The default of line 25 for the 24 x 80 display size gives the following results:

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.

If the ERRSFL keyword is specified in the file, you cannot specify a message location value of 25 for the 24 x 80 display size or 28 for the 27 x 132 display size. When the ERRSFL keyword is in the file, but MSGLOC is not specified, the following default values are to be established:

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.