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.
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 |
|
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:
For example, FLD1 and FLD2 are on the primary display located on line 2, position 2 and line 4, position 2, respectively. You cannot use a display size condition name to display FLD2 ahead of FLD1 on the display (on line 1) for a secondary display size.
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:
|
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.
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.