Hercules V4.00.0 - User Reference Guide

6.9.6 LCS (LAN Channel Station)

6.9.6.1 Function

This statement defines an emulated LAN Channel Station adapter. This emulation mode appears to the
operating system running in the Hercules machine as an IBM 8232 LCS device, an IBM 2216 router, an
IBM 3172 running ICP (Interconnect Communications Program), the LCS3172 driver of an IBM P/390, or
an IBM Open Systems Adapter (OSA).

Rather than a point-to-point link, this emulation creates a virtual ethernet adapter through which the guest
operating system running in the Hercules machine can communicate. As such, this mode is not limited to
TCP/IP traffic, but in fact will handle any ethernet frame.

6.9.6.2 Syntax

Descriptive

-n --name]

-o --oatfile]

---mac]

[---debug]

[guestip]

Diagram

ÊÊ¬¬¬ ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

-n ¬¬¬
¬¬§¬¬¬ name

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

-o ¬¬
¬¬¬§¬¬¬ file

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

-m ¬¬
¬¬¬§¬¬¬ mac

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

-guestip

6.9.6.3 Parameter

devaddr

This is the address pair of the LCS device. This pair must be an even-odd address.
This can be specified as two separate LCS statements with a single device address
(“0E20 LCS…” and “0E21 LCS …”) or as a single statement with a device address
count (“0E20.2 LCS …”).

LCS

This specifies the LAN Channel Station (LCS) device/protocol type.

-n name

Identifies the host network adapter to use:

On Linux systems this is name of the TUN/TAP special character device, normally
/dev/net/tun.

On Windows this is either the IP or MAC address of the host systems network card.
TunTap32 will automatically select the first network adapter it finds if the option is
omitted, this may be not desirable for some users.

--dev name

This is the same as “-n name”.

-o file

file specifies the filename of the OSA Address Table (OAT). If this option is
specified the optional --mac and guestip entries are ignored in preference to
statements in the OAT file. For a description of the OAT file see next section.

--oat file

This is the same as “-o file”.

-m mac

mac is the optional hardware address of the interface coded in the format
“xx:xx:xx:xx:xx:xx”. If you use the “-o/--oat” option do not specify an address here, it
will be ignored.

--mac mac

This is the same “-m mac”.

-d

Specifies that debugging output has to be produced on the Hercules control panel.
This should normally be left unspecified.

--debug

This is the same as “-d”.

guestip

This is an optional IP address of the Hercules (guest OS) side. This is only used to
establish a point-to-point routing table entry on the driving system. If you use the
“ -o/--oat” option do not specify an address here, it will be ignored.