F.6.2.1. Working With the LCS Device Driver

The LAN channel station (LCS) device driver supports OSA-2 Ethernet/Token Ring, OSA-Express Fast Ethernet in non-QDIO mode, and OSA-Express High Speed Token Ring in non-QDIO mode. For z990, the LCS driver also supports Gigabit Ethernet in non-QDIO mode (including 1000Base-T).

Based on the type of interface being added, the LCS driver assigns one of two base interface names: eth<n> for OSA-Express Fast Ethernet and Gigabit Ethernet tr<n> for Token Ring, where <n> is an integer that uniquely identifies the device. <n> is 0 for the first device of that type, 1 for the second, and so on.

Load the device driver:
```
# modprobe lcs
```
Create the group device:
```
# echo <read_device_bus_id>,<write_device_bus_id> > /sys/bus/ccwgroup/drivers/lcs/group
```
Due to the length of this command, it has been broken into two lines.
Configure the device.

OSA cards can provide up to 16 ports for a single CHPID. By default, the LCS group device uses port 0. To use a different port, issue a command similar to the following:
```
# echo <portno> > /sys/bus/ccwgroup/drivers/lcs/<device_bus_id>/portno
```
For more information about configuration of the LCS driver, refer to the following:

http://oss.software.ibm.com/developerworks/opensource/linux390/docu/lx26apr04dd01.pdf (Linux for zSeries and S/390 Device Drivers, Features, and Commands)

Set the device online:

# echo 1 /sys/bus/ccwgroup/drivers/lcs/<read_device_bus_id>/online

Define the alias.

Based on the type interface being added, add a line to /etc/modprobe.conf that is similar to one of the following:
```
eth<n> alias lcs
tr<n> alias lcs
```

Create a configuration script.

Create a file in /etc/sysconfig/network-scripts/ with a name like one of the following:

ifcfg-eth<n>
ifcfg-tr<n>

The file should look similar to the following:

/etc/sysconfig/network-scripts/ifcfg-eth0
# IBM LCS
DEVICE=eth0
BOOTPROTO=static
HWADDR=00:06:29:FB:5F:F1
IPADDR=9.12.20.136
NETMASK=255.255.255.0
ONBOOT=yes
NETTYPE=lcs
SUBCHANNELS=0.0.09a0,0.0.09a1
PORTNAME=0
TYPE=Ethernet

Based on the type interface being added, the DEVICE parameter should be one of the following:

DEVICE=eth<n>
DEVICE=tr<n>

Activate the device.

Based on the type interface being added, issue an ifup command:
```
# ifup eth<n>
# ifup tr<n>
```