DDS for display files


MSGLOC (Message Location) keyword for display files

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:

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 results in the following:

If the ERRSFL keyword is specified in the file, you may not 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 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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]