1 03/31/83 remote_input_
2
3
4 Function: The remote_input_ I/O module performs record input from a
5 terminal I/O module, which is assumed to be connected to a remote I/O
6 device, such as a Honeywell Level 6 remote batch facility G115 type,
7 an IBM 2780, or an IBM 3780. Except for hardware restrictions, this
8 module performs some code conversion and control in such a way that
9 remote and local card reading are the same.
10
11 Entry points in this module are not called directly by users; rather,
12 the module is accessed through the I/O system.
13
14 This module in turn constructs an attach description for the module
15 specified in the -terminal control argument, passing the other attach
16 information specified by the caller.
17
18
19 Syntax and Attach Description:
20 remote_input_ -control_args
21
22
23 Control arguments:
24 -device STR
25 STR defines the device type that this I/O module is attempting to
26 simulate. The acceptable values for STR are reader, printer_in, and
27 punch_in. This control argument is optional. If not supplied, a
28 device type of reader is assumed.
29 -physical_line_length N, -pll N
30 This control argument is accepted and ignored for compatibility with
31 other device-level I/O modules. It is not passed on to the terminal
32 I/O module.
33 -record_len N
34 defines the maximum record length buffer size for data from the
35 terminal I/O module in characters. The accepted ranges are 80 to
36 160 for the device type of reader, and 10 to 1024 otherwise. If
37 this control argument is not given, the maximum for the device type
38 is assumed.
39
40
41 -runout_spacing N, -runsp N
42 This control argument is accepted and ignored for compatibility with
43 other device-level I/O modules. It is not passed on to the terminal
44 I/O module.
45 -terminal STR
46 STR specifies the terminal I/O module to be attached by this device
47 I/O module. Required
48
49 All other attach control arguments are assumed to belong to the
50 terminal I/O module. These are passed on as part of its attach
51 description. The -device option passed on to the terminal I/O module
52 specifies one of the following devices: reader, printer, or punch.
53 See the description of the terminal I/O module for a full definition of
54 required and optional control arguments.
55
56
57 Open Operation:
58 The remote input I/O module supports the stream_input opening mode.
59 The terminal I/O module switch is in turn opened with the
60 sequential_input or stream_input modes.
61
62
63 Get Chars Operation:
64 The get_chars entry reads one record from the terminal I/O module and
65 returns up to the number of specified characters. If the number of
66 characters in the record is greater than the requested number,
67 error_table_$data_loss is returned along with the data.
68
69
70 Control Operation:
71 The remote_input_ device I/O module supports the following control
72 operations:
73 get_count
74 returns the current record count. This is the count of records read
75 from the terminal I/O module since the last reset control operation.
76 This operation is not passed on to the terminal I/O module.
77
78
79 The info_pointer must point to the following structure. This
80 structure is taken from the counts structure in
81 prt_order_info.incl.pl1 for compatibility with procedures that use
82 several device I/O modules.
83 dcl 1 counts aligned based,
84 2 prt_data_pad 4 fixed bin,
85 2 record_count fixed bin 35,
86 2 prt_pad fixed bin;
87 The variable record_count will contain the returned value. This
88 corresponds with the variable line_count from the other structure.
89 reset
90 sets the current record count to 0 and passes the control operation
91 on to the terminal I/O module.
92
93 All other control operations are passed on to the terminal I/O module.
94
95
96 Modes Operation:
97 This I/O module supports the modes defined by the terminal I/O module
98 specified in the attach description.