DDS 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:
- 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.
- 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.
- 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:
- Specify the same option indicators for INZINP as for ERASEINP(*ALL),
PUTOVR, and OVERLAY keywords.
- 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.)
- 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.)
- 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:
- 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:
- Fields NAME, ADDR1, and ADDR2 are sent to the workstation.
- The input save area contains:
- CUSNBR
- All blanks
- NAME
- The program value (which appears on the display)
- ADDR1
- The program value (which appears on the display)
- ADDR2
- The program value (which appears on the display)
- LIMIT
- All zeros
- For the second output operation, the user program sets on option indicator
77. This causes the following to take place:
- All input-capable fields are cleared at the workstation.
- No fields are sent to the workstation.
- The input save area contains:
- CUSNBR
- All blanks
- NAME
- The program value (not sent to the display)
- ADDR1
- The program value (not sent to the display)
- ADDR2
- The program value (not sent to the display)
- LIMIT
- All zeros
- 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 ]
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.