DDS for display files

Conditioning a field for more than one keyword

If you are conditioning a field, the field name (or the constant) and the last (or only) indicator must be on the same line. If you do not select the field for an output operation, no keywords specified for that field are in effect, regardless of how the keywords are conditioned. For example, in Figure 1, FLDA is selected if either indicator 01 is off or indicator 02 is on. If FLDA is not selected, any keyword associated with that field, such as DSPATR(HI), is ignored.

If you want to condition one or more keywords, the last (or only) indicator must appear on the same line as the keywords. If the conditioning applies to keywords on more than one line, you must use keyword continuation for the indicators to apply to all keywords. See the DDS Reference: Concepts information for details about DDS syntax rules.

Display size condition names

If you want your program to open this file to display devices with display sizes other than 24 lines x 80 characters, specify the DSPSIZ (Display Size) keyword at the file level. You can then condition the use of keywords and the location of fields with the "display size condition names" specified for the DSPSIZ keyword. If you do not specify the DSPSIZ keyword, your program can only open this file to display devices with a 24 x 80 display.

The following table shows the display size condition name for each display device.

Device Display Size Display Size Condition Name (See Note 1)
3179
3180
3196
3197 (Models C1 and C2)
3476
3487 (Models HA, HC, HG, and HW)
3488 (See Note 2)
3486 (Models BA and BG)
5251 (Models 11 and 12)
5291
5292
24 x 80 characters (1920 characters) *DS3
3180
3197 (Models D1, D2, W1, and W2)
3477 (Models FA, FC, FD, and FG)
3487 (Models HA, HC, HG, and HW)
27 x 132 characters (3564 characters) *DS4

Note 1
You can specify a user-defined display size condition name instead of *DS3, or *DS4. See the DSPSIZ keyword description for an explanation of how to specify user-defined condition names.

Note 2
Dependent on monitor attached to display device.

Figure 2 shows how to specify the DSPSIZ keyword and display size condition names.

Figure 2. Specifying the DSPSIZ Keyword and Display Size Condition Names

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A                                             (1)    (2)
00010A                                      DSPSIZ(27 132 *LARGE 24 80 *NORMAL)
00020A          R RECORDA
00030A            FIELDA        10  0   1  2
00040A            FIELDB        10  0   1120
00050A  *NORMAL                         1 49
00060A            FIELDC        10  0  27  1
00070A  *NORMAL                        15  1
     A

In Figure 2, the display size condition name for the primary display size is defined as *LARGE (1) (column 52 to 64) and the display size condition name for the secondary display size is defined as *NORMAL (2) (column 66 to 75). FIELDA appears on line 1, position 2 for both display sizes. FIELDB appears on line 1, position 120 for the primary display size (*LARGE by default), and on line 1, position 49 for the secondary display size (*NORMAL specified in positions 9 through 16). FIELDC appears on line 27, position 1 for the primary display size and on line 15, position 1 for the secondary display size. Only secondary display sizes (in this example, *NORMAL) can be used to condition field locations.

Use display size condition names similar to the way you use option indicators, except that display size condition names do not appear in your program and do not appear in the output record. A display size condition is on if the display file is opened to the corresponding display size. When you use display size condition names, the following rules apply:

Table 1 shows the correct and incorrect combinations of display size condition names and primary display sizes, when both display sizes are specified on the DSPSIZ keyword and the first one specified varies.

Table 1. Valid Display Size Condition Specifications

Display Size Condition Name1 24 x 80 DSPSIZ(*DS3...) or DSPSIZ(24 80...) Primary Display Size 27 x 132 DSPSIZ(*DS4...) or DSPSIZ(27 132...) Primary Display Size
*DS3 Error2 Valid
*DS4 Valid Error2
N*DS3 Valid Error3
N*DS4 Error3 Valid

Notes:

  1. See the DSPSIZ keyword description for user-defined names for these display size condition names.

  2. The display size condition names are in error because that display size is the primary display size.

  3. These display size condition names are in error because a primary and a secondary location are implied for the same display size. A condition name specified with the NOT condition implies an OR relationship. For example, N*DS4 implies *DS3.

Figure 3 and Figure 4 show display size conditioning for a keyword (in this case, MSGLOC, Message Location).

Figure 3. Display Size Conditioning (Example 1)

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00030A                                      DSPSIZ(*DS3 *DS4)
00040A  *DS4                                MSGLOC(26)
     A

In Figure 3, the display size condition name *DS4 is specified, so that the message line is line 26 for a 27 x 132 display and line 25 (the default) for a 24 x 80 display.

Figure 4. Display Size Conditioning (Example 2)

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00080A                                      DSPSIZ(*DS4 *DS3)
00081A                                      MSGLOC(26)
     A

In Figure 4, the message line is also line 26 for the 27 x 132 display and line 25 (the default) for the 24 x 80 display, even though no display size condition name is specified, because the primary display size (*DS4) specified with the DSPSIZ keyword is the default.


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