INZINP (Initialize Input) Keyword for Display Files

Use this record-level keyword to initialize output/input fields without necessarily sending the initialized data to the display when the PUTOVR and ERASEINP(*ALL) keywords are both in effect.

This keyword has no parameters.

INZINP is particularly useful for applications that perform data entry from remote work stations. It can reduce line traffic between the system unit and the remote work station.

The following steps describe how this keyword is used:

  1. An output operation displays an output/input field for which the OVRDTA or OVRATR keyword is in effect. The system initializes the input save area to the program value of the field. For example, if the program sets NAME1 to the name Bob, the input save area contains the name Bob.
  2. An input operation places data from the work station in an input buffer. If the work station user did not key into the input-capable field and the DSPATR(MDT) keyword is not in effect for the field, the field does not return data from the work station. The system retrieves data from the input save area and places it in the input buffer for use by the program. Thus, all input-capable fields have data in the input buffer, either from the work station or from the input save area.
  3. On another output operation, the following could occur:
Note:
If the ERASEINP(*ALL) keyword is in effect for the output operation, input-capable fields are cleared at the display device (on the display), but the input save area is not cleared. For the contents of the input save area, see Table 5 and Table 6. Fields with the DFT keyword specified are initialized with the value specified for the DFT keyword even if the fields are not selected for display. The values are maintained unless the application program selects the fields for display, then changes their data values. This keyword requires the PUTOVR, OVERLAY, and ERASEINP(*ALL) keywords to be specified at the record level.

The following tables show the effect of the ERASEINP(*ALL) and PUTOVR keywords with and without the INZINP keyword.

Table 5. INZINP Output/Input Fields

OVRATR or OVRDTA Keyword INZINP Keyword Contents of Input Save Area
Not specified Does not apply Previous contents
Specified but not in effect Specified but not in effect Previous contents
Specified but not in effect Specified and in effect Program value (not sent to display)
OVRATR specified and in effect Does not apply Program value (also sent to display)
OVRATR specified and in effect; OVRDTA not specified or not in effect Does not apply Previous contents (not sent to display)

Table 6. INZINP Input Only Fields

OVRATR Keyword INZINP Keyword Contents of Input Save Area
Not specified Does not apply Previous contents
Specified and in effect Does not apply Previous contents
Specified but not in effect Does not apply Character fields: blanks Numeric fields: zeros

Do the following to set the input save area to blanks and zeros to match the fields cleared at the work station by the ERASEINP(*ALL) keyword:

  1. Specify the same option indicators for INZINP as for ERASEINP(*ALL), PUTOVR, and OVERLAY keywords.
  2. Specify OVRDTA or OVRATR for all output/input fields. (Set option indicators off for these keywords if you do not want to send data or attributes to the device. If you enable OVRATR, also enable OVRDTA.)
  3. Specify the OVRATR keyword for all input-only fields. (Set option indicators off for this keyword if you do not want to send attributes to the device.)
  4. Set all output/input fields to blanks (for character fields) or zeros (for numeric fields) before the output operation.

A warning message appears at file creation time if the INZINP keyword is specified on a record with the DSPMOD keyword. At run time, the INZINP keyword is ignored when the display mode changes.

Option indicators are valid for this keyword.