6.3 Console Printer-Keyboard Devices

6.3.1 Function

These device statements are used to define “Console Printer-Keyboard” devices to Hercules. To use the
Console Printer-Keyboard device a telnet client must connect to the host machine via the port number
specified on the CNSLPORT statement in that configuration file.

If the telnet client software allows it to specify a device type suffix (e.g. ansi@0009) then the suffix can be
used to specify the specific 1052 or 3215 device to which the client should connect. If no suffix is used in
the telnet client software (or the software does not allow it), then the client will be connected to the first
available 1052 or 3215 device for which it is eligible.

6.3.2 Syntax

Descriptive

groupname ipaddr [mask]]]

Diagram

Êʬ¬¬ ¬¬¬ ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬¬¬ * ¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

groupname ipaddr ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬
mask ¬¬

6.3.3 Parameter

devaddr

This is the device address.

devtype

This is the device type. Valid terminal device types are 1052 and 3215.

NOPROMPT

The NOPROMPT argument may be specified to cause suppression of the “ENTER
INPUT FOR CONSOLE DEVICE nnnn” prompt message which is otherwise nor-
mally issued to the device whenever the system is awaiting input from the device.

The NOPROMPT argument, if specified, must preceed the optional group name
and any ipaddr mask arguments.

groupname

If a terminal group name is given on the device statement then a device type suffix
with this group name can be used to indicate that a device in this group is to be
used. If it is specified as a terminal type suffix (e.g. IBM-3278@GROUPNAME) and
there are no devices defined with that group name or no available devices remain-
ing in that group then the connection is rejected. If no group name is specified as a

terminal type suffix then the connection will only be eligible to terminal devices
which also have no group name specified.

The terminal group name should be 1-8 alphanumeric characters in length, the first
character being alphabetic and it should not be a hexadecimal number. Upper and
lower case letters in the group name are considered to be equivalent.

*

The asterisk is used to indicate any terminal group name. It may be omitted if there
are no additional arguments following the group name. If an IP address (and op-
tionally mask) is specified and there is no specific group name desired then the
asterisk must be coded to distinguish the terminal group name and the IP address
arguments.

ipaddr [mask]

The optional IP address and subnet masks specify the IP address(es) at which
client(s) are allowed to connect via the device address identified by the device
statement. This provides an additional means of specifying which device(s) a client
tn3270 session may connect to.

If the IP address and mask (default 255.255.255.255 if not specified) of the tn3270
client attempting to connect match the IP address/mask entered on the device
statement, then the client is eligible to connect at this device address. Otherwise
the client is ineligible to connect at this device address and the next available de-
vice, if any, for which the client is eligible to connect, will be attempted.

If no permissible terminal devices remain (terminal devices for which the client is
eligible to connect) or there are no more available terminal devices then the client
connection is rejected.

The optional IP address and subnet mask may be specified in conjunction with the
terminal group argument. In this case the terminal group argument must be speci-
fied ahead of the optional IP address and subnet mask arguments. To specify an IP
address and a subnet mask without also specifying a terminal group use an aste-
risk (“*”) as the group name substitute or placeholder.

If an IP address / mask are not specified then any client tn3270 session is allowed
to connect to the device (provided they are also a member of the specified terminal
group, if any).

The terminal group name must match if specified, regardless of any optional IP
address / mask. To summarize, the device number suffix always takes precedence
over any group name and any group name always takes precedence over any IP
address/mask value.

6.3.4 Examples

Example 1:

Define a 1052 console printer-keyboard device on device address 0009.

0009 1052

Example 2:

Define a 1052 console printer-keyboard device on device address 0009 and suppress the “ENTER
INPUT FOR CONSOLE DEVICE nnnn” prompt messages.

0009 1052 NOPROMPT