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.

6.9.6.4 OSA Address Table (OAT) Syntax

The syntax for the OSA Address Table file is as follows:

*********************************************************

* Dev Mode Port Entry specific information...

*********************************************************

0400 IP 00 PRI 172.021.003.032

0402 IP 00 SEC 172.021.003.033

0404 IP 00 NO 172.021.003.038

0406 IP 01 NO 172.021.002.016

040E SNA 00

HWADD 00 02:00:FE:DF:00:42

HWADD 01 02:00:FE:DF:00:43

ROUTE 00 172.021.003.032 255.255.255.224

Figure 2: OSA Address Table (OAT) File Syntax

Dev

This is the base device address.

Mode

This is the operation mode: IP or SNA. (Note: The SNA operation mode is currently
not implemented.

Port

This is the virtual (relative) adapter number.

Entry

This applies only for IP Mode and specifies where a packet with an unknown IP
address is forwarded. PRI is the primary default entry, SEC is the entry to use
when the primary is not available and NO specifies that this is not a default entry.

n.n.n.n

This specifies the home IP address.

When the operation mode is IP specify only the even (read) device number dev. The odd (write) address
will be created automatically. Additionally two other statements can be included in the Address Trans-
lation file. These are the HWADD and ROUTE statements.

Use the HWADD statement to specify a hardware (MAC) address for a virtual adapter. The first para-
meter after the HWADD specifies the relative adapter for which the address is applied.

The ROUTE statement is included for convenience. It allows the ‘hercifc’ program to create a network
route for this specific virtual adapter. Please note that it is not necessary to include point-to-point routes
for each IP address in the table. This is done automatically by the emulation module.

The read / write devices can be swapped by coding the odd address of the even-odd pair in the OAT. Up
to 4 virtual (relative) adapters (00-03) are currently supported.

If no Address Translation file is specified, the emulation module will create the following:

- An ethernet adapter (port 0) for TCP/IP traffic only.

- Two device addresses (devnum and devnum+1).

6.9.6.5 Examples

Example 1:

Define LCS (LAN Channel Station emulation) adapters on device addresses 0440 and 0441. The name of
the TUN/TAP special character device is “/dev/net/tun”. The IP address of the Hercules guest OS side is
192.168.200.2.

0440.2 LCS -n /dev/net/tun 192.168.200.2

or

0440 LCS -n /dev/net/tun 192.168.200.2
0441 LCS -n /dev/net/tun 192.168.200.2

Previous Page Next Page