# Hercules Version 3: System Messages: RD - Card Reader Emulation

This page describes the card reader emulation messages for the Hercules S/370, ESA/390, and z/Architecture emulator.

### Messages

`HHCRD001E Out of memory`
  Meaning
    A request to allocate memory for the list of files to be read failed.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD002E File name too long (max=max): "filename"`
  Meaning
    The file name specified by `filename` is too long. The maximum length is `max`.
  Action
    Specify a shorter name.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD003E Unable to access file "filename": error`
  Meaning
    The file specified by `filename` could not be accessed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD004E Out of memory`
  Meaning
    A request to allocate memory for the list of files to be read failed.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD005E Specify 'ascii' or 'ebcdic' (or neither) but not both`
  Meaning
    Both of the character set translation options `ascii` and `ebcdic` were specified. At most one is allowed.
  Action
    Select only one character set translation option.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD006E Only one filename (sock_spec) allowed for socket devices`
  Meaning
    More than one filename argument was given for a socket card reader device. Only one is allowed. This error can also result if an option name is misspelled.
  Action
    Remove the extraneous filenames, or correct the misspelled options.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD007I Defaulting to 'ascii' for socket device address`
  Meaning
    The socket card reader device at address `address` has been set to ASCII mode, since neither translation option was specified. The socket card reader device cannot automatically select the translation option.
  Action
    If you wish to read cards without translation from ASCII to EBCDIC, you must specify the `ebcdic` option on the reader definition.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD008W 'multifile' option ignored: only one file specified`
  Meaning
    Only one file was specified for input to the card reader, and the `multifile` option was specified. This option is meaningless with only one input file. The option has been ignored.
  Action
    If you wish to read more than one input file without signalling end-of-file or intervention required between them, they must all be specified on the same reader definition. If you only wish to process one file, omit the `multifile` option.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD009E File name too long (max=max): "filename"`
  Meaning
    The file name specified by `filename` is too long. The maximum length is `max`.
  Action
    Specify a shorter name.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD010E Unable to access file "filename": error`
  Meaning
    The file specified by `filename` could not be accessed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function cardrdr_init_handler
`HHCRD011E Close error on file "filename": error`
  Meaning
    An attempt to close the file specified by `filename` failed. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function cardrdr_close_device
`HHCRD012I ipaddr (hostname) disconnected from device address (socketspec)`
  Meaning
    The client on the host named `hostname`, with the IP address `ipaddr`, has disconnected from the socket card reader device at address `address`, specified by `socketspec`.
  Issued by
    cardrdr.c, function cardrdr_close_device
`HHCRD013E Error opening file filename: error`
  Meaning
    The file named `filename` could not be opened for reading. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function open_cardrdr
`HHCRD014E Error reading file filename: error`
  Meaning
    An error was encountered while attempting to read the first 160 bytes of the file named `filename` in order to determine its character set. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function open_cardrdr
`HHCRD015E Seek error in file filename: error`
  Meaning
    An error was encountered while attempting to return to the beginnning of file named `filename` after determining its character set. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function open_cardrdr
`HHCRD016E Error reading file filename: error`
  Meaning
    An error was encountered while attempting to read an EBCDIC card image from the file named `filename`. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function read_ebcdic
`HHCRD017E Unexpected end of file on filename`
  Meaning
    Too few characters were read from the file named `filename`. The autopad option was not specified.
  Action
    Either ensure that all records in the file are 80 bytes long, or specify the autopad option on the reader definition.
  Issued by
    cardrdr.c, function read_ebcdic
`HHCRD018E Error reading file filename: error`
  Meaning
    An error was encountered while attempting to read an ASCII card image from the file named `filename`. The error is described by `error`.
  Action
    Correct the error and retry the operation.
  Issued by
    cardrdr.c, function read_ascii
`HHCRD019E Card image exceeds size bytes in file filename`
  Meaning
    A line in the file named `filename` is too long to fit on one card. The trunc option was not specified. The maximum length is `size` bytes.
  Action
    Either ensure that all lines in the file are less than `size` bytes long, or specify the trunc option on the reader definition.
  Issued by
    cardrdr.c, function read_ascii

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

Last updated $Date$ $Revision$