# Hercules Version 3: System Messages: LC - LAN Channel Station Emulation

This page describes the LAN Channel Station emulation messages for the Hercules S/370, ESA/390, and z/Architecture emulator.

### Messages

`HHCLC001E nnnn unable to allocate LCSBLK`
  Meaning
    There is insufficient storage to allocate the control block for LCS device number nnnn.
  Action
    Correct the error and restart Hercules.
  Issued by
    ctc_lcs.c, function LCS_Init
`HHCLC017E nnnn invalid device name devname`
  Meaning
    The value of the -n or -dev parameter in the configuration statement for LCS device number nnnn is missing or too long.
  Action
    Correct the parameter and reinitialize the device.
  Issued by
    ctc_lcs.c, function ParseArgs
`HHCLC018E nnnn invalid MAC address macaddr`
  Meaning
    The value of the -m or -mac parameter in the configuration statement for LCS device number nnnn is not a valid MAC address.
  Action
    Correct the parameter and reinitialize the device.
  Issued by
    ctc_lcs.c, function ParseArgs
`HHCLC019E nnnn too many arguments in statement.`
  Meaning
    The configuration statement for LCS device number nnnn contains too many positional parameters.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function ParseArgs
`HHCLC020E nnnn invalid IP address ipaddr`
  Meaning
    The first positional parameter in the configuration statement for LCS device number nnnn is not a valid IP address.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function ParseArgs
`HHCLC021E Invalid HWADD statement in filename: stmt`
  Meaning
    The port number parameter of the HWADD statement stmt in OAT file filename is not numeric.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC022E Invalid MAC in HWADD statement in filename: stmt (macaddr)`
  Meaning
    The second positional parameter of the HWADD statement stmt in OAT file filename is not a valid MAC address.
  Action
    Correct the parameter and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC023E Invalid ROUTE statement in filename: stmt`
  Meaning
    The port number parameter of the ROUTE statement stmt in OAT file filename is not numeric.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC024E Invalid net address in ROUTE filename: stmt (netaddr)`
  Meaning
    The second positional parameter of the ROUTE statement stmt in OAT file filename is not a valid IP network address.
  Action
    Correct the parameter and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC025E Invalid net mask in ROUTE filename: stmt (netaddr)`
  Meaning
    The third positional parameter of the ROUTE statement stmt in OAT file filename is not a valid IP network mask.
  Action
    Correct the parameter and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC026E Error in filename: Missing device number or mode`
  Meaning
    The OAT file filename contains a statement which cannot be identified.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC027E Error in filename: devnum: Invalid device number`
  Meaning
    The device number devnum specified in the OAT file filename is not a valid hexadecimal number.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC028E Error in filename: stmt: Missing PORT number`
  Meaning
    Statement stmt in OAT file filename for the IP port of an LCS device does not contain a port number.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC029E Error in filename: port: Invalid PORT number`
  Meaning
    The port number port specified in the OAT file filename for the IP port of an LCS device is not a valid decimal number.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC031E Error in filename: stmt: Invalid entry starting at text`
  Meaning
    The parameter text specified in statement stmt in the OAT file filename should be PRI, SEC, or NO.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC032E Error in filename: stmt: Invalid IP address (ipaddr)`
  Meaning
    The parameter ipaddr specified in statement stmt in the OAT file filename is not a valid IP address.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC033E Error in filename: stmt: Missing PORT number`
  Meaning
    Statement stmt in OAT file filename for the SNA port of an LCS device does not contain a port number.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC034E Error in filename: port: Invalid PORT number`
  Meaning
    The port number port specified in the OAT file filename for the SNA port of an LCS device is not a valid decimal number.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC035E Error in filename: stmt: SNA does not accept any arguments`
  Meaning
    Statement stmt in OAT file filename for the SNA port of an LCS device contains positional parameters which are not used for SNA ports.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC036E Error in filename: mode: Invalid MODE`
  Meaning
    Mode mode specified in a device statement in the OAT file filename should be IP or SNA.
  Action
    Correct the statement and reinitialize the device.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC037E Error reading file filename line nnnn: description`
  Meaning
    An error occurred reading the OAT file for an LCS device. description is the operating system's description of the error. The error occurred at line nnnn of file filename.
  Action
    Check that the correct OAT file name is specified in the configuration file.
  Issued by
    ctc_lcs.c, function ReadOAT
`HHCLC038E File filename line nnnn is too long`
  Meaning
    An error occurred reading the OAT file for an LCS device. The error occurred at line nnnn of file filename. Either the line exceeds 255 characters, or there is no linefeed at the end of the file.
  Action
    Correct the OAT file.
  Issued by
    ctc_lcs.c, function ReadOAT
`HHCLC039E Cannot open file filename: description`
  Meaning
    An error occurred opening the OAT file filename for an LCS device. description is the operating system's description of the error.
  Action
    Check that the correct OAT file name is specified in the configuration file.
  Issued by
    ctc_lcs.c, function BuildOAT
`HHCLC040E nnnn LCSDEV mmmm not in configuration`
  Meaning
    The device number mmmm specified in the OAT file does not match the LCS device number nnnn in the configuration file.
  Action
    Correct the OAT file and reinitialize the device.
  Issued by
    ctc_lcs.c, function LCS_Init
`HHCLC055I tapn using MAC hh:hh:hh:hh:hh:hh`
  Meaning
    The MAC address assigned the TUN/TAP device tapn is hh:hh:hh:hh:hh:hh.
  Action
    None.
  Issued by
    ctc_lcs.c, function LCS_LanStats
`HHCLC056W tapn NOT using MAC hh:hh:hh:hh:hh:hh`
  Meaning
    MAC address hh:hh:hh:hh:hh:hh was requested in the configuration statement or in the OAT file for an LCS device but the operating system did not accept the request to change the MAC address for TUN/TAP device tapn.
  Action
    The device will use the MAC address shown in the preceding HHCLC055I message.
  Issued by
    ctc_lcs.c, function LCS_LanStats
`HHCLC073I nnnn: TAP device tapn opened`
  Meaning
    LCS device number nnnn is now associated with the kernel TUN/TAP device named tapn.
  Action
    None.
  Issued by
    ctc_lcs.c, function LCS_Init

If you have a question about Hercules, see the Hercules Frequently-Asked Questions page.

Last updated $Date: 2008-12-23 07:52:53 -0600 (Tue, 23 Dec 2008) $ $Revision: 4975 $