DSPMOD (Display Mode) keyword for display files

You use this record-level keyword to specify which mode (display size) you want to use for the 3180, the 3477, or the 3197 Model D1, D2, W1, or W2 display station.

*DS3 (24 x 80) and *DS4 (27 x 132) are both supported for the 3180, 3477, 3487 Models HA, HC, HG, and HW, 3488, and the 3197 Model D1, D2, W1, or W2 display stations.

The format of the keyword is:

DSPMOD(condition-name)

This keyword is valid only when both the 24 x 80 and 27 x 132 display sizes are specified on the DSPSIZ keyword. The first of the two display sizes specified on the DSPSIZ keyword is the default display mode. The record is displayed using this mode unless the DSPMOD keyword indicates that the second specified display size should be used.

Note: This keyword is a runtime keyword and not a compile-time keyword.

You can specify the default display size with this keyword only if you do not specify option indicators for this keyword.

The capability to display in the 27 x 132 mode is allowed only on a 3180-2 or a 3197 Model D1, D2, W1, or W2 device attached locally to a 6040 or 6140 controller or remotely to a 5294 or 5394 controller. The DSPMOD keyword is ignored unless these controllers are used.

When a record with DSPMOD causes the mode to be changed, all records currently on the display are deleted. The record with DSPMOD active is then sent to the display. The mode for this record is maintained on the display as long as the DSPMOD keyword is active. Setting DSPMOD off or writing to another record without DSPMOD causes the display mode to be placed back in the primary display size for the device.

The following keywords are ignored if the display modes have changed:

ALWROL
ASSUME
CLRL
ERASEINP/INZINP
ERRMSG
ERRMSGID
KEEP

OVERLAY
PROTECT
PUTOVR
PUTRETAIN
SFLMSG
SFLMSGID

When you create a file specifying any of the above keywords and DSPMOD on the same record, a warning message results at create-time. However, a diagnostic message is not issued during processing.

This keyword is not valid for user-defined records (USRDFN keyword).

The DSPMOD keyword cannot be specified on a subfile record (SFL keyword). The subfile is be displayed according to the DSPMOD of the corresponding subfile control record.

Option indicators are valid for this keyword. If the option indicator is on at the time of processing, the display mode you have chosen will be used to display the record. However, if the option indicator is off at the time of processing, the default display mode will be used.

Note: Switching display modes is similar to displaying a record without OVERLAY.

Example 1

The following example shows how to specify the DSPMOD keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A                                      DSPSIZ(*DS3 *DS4)
     A          R RECORD1                   DSPMOD(*DSP4)
     A          R RECORD2
     A          R RECORD3
     A  03                                  DSPMOD(*DS4)
     A

The DSPMOD keyword gives the following results:

If you write RECORD1, RECORD1 is displayed in *DS4 mode.
If you write RECORD2, the display is cleared and RECORD2 is displayed in *DS3 mode.
If you write RECORD3 with indicator 03 off, RECORD3 is displayed in *DS3 mode. RECORD2 remains on the display.
If you write RECORD3 with indicator 03 on, the display is cleared and RECORD3 is displayed in *DS4 mode.

Example 2

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A                                      DSPSIZ(24 80 *NORM +
     A                                            27 132 *WIDE)
     A          R RECORD1
     A  03                                  DSPMOD(*WIDE)
     A