6.2 Integrated 3270 (SYSG) Console

6.2.1 Function

The integrated 3270 (SYSG) console is similar to a local non-SNA 3270 device, except that it is not
addressed by a subchannel number and it is supported only by certain system control programs. The
SYSG console is defined like a 3270 device except that the device type is SYSG and the device address
is ignored. Only one SYSG console can be defined in a configuration.

Use tn3270 client software to connect to the SYSG console device via the port number specified on the
CNSLPORT statement, just as you would connect to a regular local non-SNA 3270 device.

The SYSG console configuration statement recognizes optional arguments which specify group name
and IP address in the same way as previously described for a local non-SNA 3270 device. These optional
arguments provide a means to ensure that a given tn3270 client can connect directly to the SYSG con-
sole.

If the group name and IP address arguments are not specified, then the SYSG console is considered to
be a member of the general pool of devices eligible for connection to any incoming tn3270 client.

6.2.2 Syntax

Descriptive

groupname ipaddr [mask]]]

Diagram

Êʬ¬¬

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

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

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

¬¬
mask ¬¬

6.2.3 Parameter

devaddr

This is the device address. In the case of the integrated 3270 (SYSG) console this
address is ignored.

SYSG

This is the device type. The only valid device type is SYSG.

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.2.4 Examples

Example 1:

Define an integrated 3270 (SYSG) console on device address 0000 (the device address is ignored for
SYSG consoles).

0000 SYSG