DDS for display files


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 workstations. It can reduce line traffic between the system unit and the remote workstation.

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 workstation in an input buffer. If the workstation 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 workstation. 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 workstation 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 8 and Table 9. 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 8. 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 9. 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 workstation 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.

Example:

The following example shows how to specify the INZINP keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A          R FMT1
00020A  77                                  PUTOVR OVERLAY ERASEINP(*ALL)
00030A  77                                  INZINP
00040A                                  7  8'CUSTOMER NUMBER'
00050A            CUSNBR         6   I  7 26
00060A N77                                  OVRATR
00070A                                  9 12'CUSTOMER NAME'
00080A            NAME          25   B  9 30
00090A N77                                  OVRATR
00100A                                 10  2'CUSTOMER ADDRESS LINE 1'
00110A            ADDR1         25   B 10 30
00120A N77                                  OVRATR
00130A                                 11  2'CUSTOMER ADDRESS LINE 2'
00140A            ADDR2         25   B 11 30
00150A N77                                  OVRATR
00160A                                 12  9'NEW CREDIT LIMIT'
00170A            LIMIT          4  0I 12 30
00180A N77                                  OVRATR
     A

This example illustrates the following:

  1. For the first output operation, the user program sets off option indicator 77. Therefore, the PUTOVR, ERASEINP, and INZINP keywords are not in effect. This causes the following to take place:
  2. For the second output operation, the user program sets on option indicator 77. This causes the following to take place:
Note:
If fields NAME, ADDR1, and ADDR2 had been set to blanks before this second output operation, the input save area would contain all blanks and zeros.


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