# Hercules Version 3: System Messages: CF: Configuration Processing

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

### Messages

`HHCCF001S Error reading file filename line lineno: error`
  Meaning
    An error was encountered reading the configuration file named `filename` at line number `lineno`. The error is described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function read_config
`HHCCF002S File filename line lineno is too long`
  Meaning
    The line at line number `lineno` in the configuration file `filename` is too long and cannot be processed.
  Action
    Correct the line and restart Hercules.
  Issued by
    config.c, function read_config
`HHCCF003S Cannot open file filename: error`
  Meaning
    The configuration file named `filename` could not be opened. The error is described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF004S No device records in file filename`
  Meaning
    The configuration file named `filename` does not contain any device definition records. Without them, Hercules cannot do any meaningful work.
  Action
    Specify one or more device definitions in the configuration file and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF005S Error in filename line lineno: Unrecognized argument argument`
  Meaning
    An invalid argument, `argument`, was specified on the `HTTPPORT` configuration statement in the file named `filename` at line number `lineno`. Only the arguments `auth` and `noauth` are valid.
  Action
    Correct the invalid argument and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF006S Error in filename line lineno: Userid, but no password given userid`
  Meaning
    A userid, `userid`, was specified on the `HTTPPORT` configuration statement in the file named `filename` at line number `lineno`, but no password was provided. A password is required if a userid is present.
  Action
    Either remove the userid, or specify a password, and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF007S Error in filename line lineno: Missing argument`
  Meaning
    The `HTTPROOT` configuration statement was specified in the file named `filename` at line number `lineno`, but no directory was specified. A directory is required.
  Action
    Specify the directory where the Hercules web server will find its HTML files, and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF008S Error in filename line lineno: Unrecognized keyword keyword`
  Meaning
    An invalid configuration statement was specified in the file named `filename` at line number `lineno`. The invalid keyword was `keyword`.
  Action
    Correct the invalid statement and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF009S Error in filename line lineno: Incorrect number of operands`
  Meaning
    The configuration statement at line `lineno` of the file named `filename` had an invalid number of operands. For all but the `HTTPPORT` statement, exactly one operand is required.
  Action
    Correct the invalid statement and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF010S Error in filename line lineno: Unknown or unsupported ARCHMODE specification mode`
  Meaning
    The `ARCHMODE` configuration statement at line `lineno` of the file named `filename` specified an invalid architecture. Only `S/370`, `ESA/390`, or `ESAME` are valid. If one of these was specified, then support for that architecture was excluded when the copy of Hercules in use was compiled.
  Action
    Correct the specified value and restart Hercules. If the message was issued because support for the desired architecture was excluded, then recompile Hercules.
  Issued by
    config.c, function build_config
`HHCCF011S Error in filename line lineno: serialno is not a valid serial number`
  Meaning
    The serial number `serialno` specified on the `CPUSERIAL` configuration statement at line number `lineno` of the file named `filename` must be exactly six digits long, and must be a valid hexadecimal number.
  Action
    Correct the serial number and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF012S Error in filename line lineno: modelno is not a valid CPU model`
  Meaning
    The model number `modelno` specified on the `CPUMODEL` configuration statement at line number `lineno` of the file named `filename` must be exactly four digits long, and must be a valid hexadecimal number.
  Action
    Correct the model number and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF013S Error in filename line lineno: Invalid main storage size size`
  Meaning
    The main storage size `size` specified on the `MAINSIZE` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number between 2 and 1024.
  Action
    Correct the main storage size and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF014S Error in filename line lineno: Invalid expanded storage size size`
  Meaning
    The expanded storage size `size` specified on the `XPNDSIZE` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number between 0 and 1024.
  Action
    Correct the expanded storage size and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF015S Error in filename line lineno: Invalid console port number port`
  Meaning
    The console port number `port` specified on the `CNSLPORT` configuration statement at line number `lineno` of the file named `filename` must be a valid nonzero decimal number.
  Action
    Correct the console port number and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF016S Error in filename line lineno: Invalid threadname thread priority priority`
  Meaning
    The thread priority `priority` specified on the `xxxPRIO` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number.
  Action
    Correct the priority on the statement and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF017W Hercules is not running as setuid root, cannot raise threadname priority`
  Meaning
    A negative value for the threadname thread priority parameter `xxxPRIO` was specified, but Hercules is not running as the root user (either directly or via the setuid mechanism). This parameter value would cause the priority of the CPU execution thread to be raised above the normal level if Hercules were running as root. Since it is not, however, the parameter will have no effect.
  Action
    Either specify a positive value to lower the CPU thread priority, zero to not alter the priority, or omit the statement entirely to use the Hercules default CPU thread priority of 15.
  Issued by
    config.c, function build_config
`HHCCF018S Error in filename line lineno: Invalid number of CPUs number`
  Meaning
    The number of emulated CPUs `number` specified on the `NUMCPU` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number between 1 and the maximum number defined when Hercules was built (usually 2; this number is never more than 2 for S/370 mode, or 16 for ESA/390 or ESAME mode).
  Action
    Correct the number of emulated CPUs and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF019S Error in filename line lineno: Invalid number of VFs number`
  Meaning
    The number of emulated Vector Facility engines `number` specified on the `NUMVEC` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number between 1 and the maximum number defined when Hercules was built (usually 2).
  Action
    Correct the number of emulated Vector Facility engines and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF020W Vector Facility support not configured`
  Meaning
    A request for Vector Facility support was made by the `NUMVEC` configuration statement, but Hercules was built without the Vector Facility code. The request has been ignored.
  Action
    If Vector Facility support is desired, recompile Hercules. If not, remove the `NUMVEC` configuration statement.
  Issued by
    config.c, function build_config
`HHCCF021S Error in filename line lineno: Load parameter loadparm exceeds 8 characters`
  Meaning
    The IPL parameter `loadparm` specified on the `LOADPARM` configuration statement at line number `lineno` of the file named `filename` must be no more than 8 characters long.
  Action
    Correct the IPL parameter and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF022S Error in filename line lineno: epoch is not a valid system epoch
Patch config.c to expand the table.`
  Meaning
    The system epoch `epoch` specified on the `SYSEPOCH` configuration statement at line number `lineno` of the file named `filename` must be one of the following: `1900`, `1928`, `1960`, `1988`, or `1970`.
  Action
    Correct the system epoch and restart Hercules. If a different epoch is desired, a change must be made to the Hercules source file config.c and Hercules rebuilt.
  Issued by
    config.c, function build_config
`HHCCF023S Error in filename line lineno: offset is not a valid timezone offset`
  Meaning
    The system timezone offset `offset` specified on the `TZOFFSET` configuration statement at line number `lineno` of the file named `filename` must be five characters long, and a valid decimal number of the form (`+`|`-`)`number`, where `number` must be between zero and 2359 (representing 23 hours, 59 minutes).
  Action
    Correct the time zone offset and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF024S Error in filename line lineno: Invalid TOD clock drag factor drag`
  Meaning
    The TOD clock drag factor `drag` specified on the `TODDRAG` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number between 1 and 10000.
  Action
    Correct the TOD clock drag factor and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF025S Error in filename line lineno: Invalid panel refresh rate rate`
  Meaning
    The control panel refresh rate `rate` specified on the `PANRATE` configuration statement at line number `lineno` of the file named `filename` must be either `F`, `S`, or a valid decimal number between 1 and 5000.
  Action
    Correct the control panel refresh rate and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF026S Error in filename line lineno: Unknown OS tailor specification tailor`
  Meaning
    The OS tailoring value `tailor` specified on the `OSTAILOR` configuration statement at line number `lineno` of the file named `filename` must be either `OS/390`, `z/OS`, `VSE`, `VM`, `LINUX`, `NULL`, or `QUIET`.
  Action
    Correct the OS tailoring value and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF027S Error in filename line lineno: Invalid maximum device threads threads`
  Meaning
    The maximum device threads `threads` specified on the `DEVTMAX` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number greater than -1.
  Action
    Correct the maximum device threads and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF028S Error in filename line lineno: Invalid program product OS permission permission`
  Meaning
    The program product OS permission `permission` specified on the `PGMPRDOS` configuration statement at line number `lineno` of the file named `filename` must be either `LICENSED` (or `LICENCED`, for those who spell as the British do) or `RESTRICTED`.
  Action
    Correct the program product OS permission and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF029S Error in filename line lineno: Invalid HTTP port number port`
  Meaning
    The HTTP server port number `port` specified on the `HTTPPORT` configuration statement at line number `lineno` of the file named `filename` must be either 80, or a valid decimal number greater than 1024.
  Action
    Correct the HTTP server port number and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF030S Error in filename line lineno: Invalid I/O delay value delay`
  Meaning
    The I/O delay value `delay` specified on the `IODELAY` configuration statement at line number `lineno` of the file named `filename` must be a valid decimal number.
  Action
    Correct the I/O delay value and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF031S Cannot obtain sizeMB main storage: error`
  Meaning
    An attempt to obtain the amount of main storage specified by `MAINSTOR` failed for the reason described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF032S Cannot obtain storage key array: error`
  Meaning
    An attempt to obtain storage for the array of storage keys failed for the reason described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF033S Cannot obtain sizeMB expanded storage: error`
  Meaning
    An attempt to obtain the amount of expanded storage specified by `XPNDSTOR` failed for the reason described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF034W Expanded storage support not installed`
  Meaning
    A request was made for expanded storage by the `XPNDSTOR` configuration parameter, but Hercules was built without expanded storage support. The request was ignored.
  Action
    Either remove the XPNDSTOR configuration parameter, or recompile Hercules with expanded storage support included.
  Issued by
    config.c, function build_config
`HHCCF035S Error in filename line lineno: Missing device number or device type`
  Meaning
    The I/O device definition statement at line number `lineno` of the file named `filename` did not contain a device number or a device type.
  Action
    Supply the missing value and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF035S Error in filename line lineno: number is not a valid device number`
  Meaning
    The I/O device definition statement at line number `lineno` of the file named `filename` specified an invalid device number `number`. The device number must be one to four hexadecimal digits.
  Action
    Correct the device number and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF037S Message pipe creation failed: error`
  Meaning
    An attempt to create a pipe for communication with the control panel failed. The error is described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF038S Message pipe open failed: error`
  Meaning
    An attempt to open the pipe for communication with the control panel failed. The error is described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function build_config

    HHCCF039W PGMPRDOS LICENSED specified.
              Licensed program product operating systems are enabled.
              You are responsible for meeting all conditions of your
              software license.

  Meaning
    The configuration parameter `PGMPRDOS LICENSED` was specified. This message is issued to remind you that compliance with the terms of the license for your system's software is your responsibility.
  Action
    Be sure you know what you're doing.
  Issued by
    config.c, function build_config
`HHCCF040E Cannot create CPU number thread: error`
  Meaning
    An attempt to create a new thread for execution of CPU `number` failed. The error is described by `error`. The CPU has not been added to the configuration.
  Action
    Correct the error and retry the operation.
  Issued by
    config.c, function configure_cpu
`HHCCF041E Device address already exists`
  Meaning
    An attempt was made to define a device at address `address`. There is already a device at that address.
  Action
    Either choose another device address, or use the `detach` command to remove the existing device.
  Issued by
    config.c, function attach_device
`HHCCF042E Device type type not recognized`
  Meaning
    An attempt was made to define a device of type `type`. This device type is not supported by Hercules. It may also indicate that the system was unable to load the device handler for the specified device type.
  Action
    Specify a supported device type. If the device type is supported, make sure the the system can load the load modules necessary for device operations. Either use the LD_LIBRARY_PATH environment variable or use ldconfig(8) to customize the library search path.
  Issued by
    config.c, function attach_device
`HHCCF043E Cannot obtain device block for device address: error`
  Meaning
    An attempt to allocate memory for the control block describing the device with address `address` failed. The error is described by `error`. The device has not been defined.
  Action
    Correct the error and retry the operation.
  Issued by
    config.c, function attach_device
`HHCCF044E Initialization failed for device address`
  Meaning
    The device at address `address` could not be initialized. The device initialization routine has issued a message describing the problem in further detail; refer to that message for more information.
  Issued by
    config.c, function attach_device
`HHCCF045E Cannot obtain buffer for device address: error`
  Meaning
    An attempt to allocate memory for the data buffer for the device with address `address` failed. The error is described by `error`. The device has not been defined.
  Action
    Correct the error and retry the operation.
  Issued by
    config.c, function attach_device
`HHCCF046E Device address does not exist`
  Meaning
    An attempt was made to remove a device at address `address`. There is no device at that address.
  Action
    Choose another device address to remove, if desired.
  Issued by
    config.c, function detach_device
`HHCCF047I Device address detached`
  Meaning
    The device at address `address` has been successfully removed from the system.
  Issued by
    config.c, function detach_device
`HHCCF048E Device address does not exist`
  Meaning
    An attempt was made to rename a device at address `address`. There is no device at that address.
  Action
    Choose another device address to rename, if desired.
  Issued by
    config.c, function define_device
`HHCCF049E Device address already exists`
  Meaning
    An attempt was made to rename a device to address `address`. There is already a device at that address.
  Action
    Either choose another device address, or use the `detach` command to remove the existing device.
  Issued by
    config.c, function define_device
`HHCCF050I Device oldaddr defined as newaddr`
  Meaning
    The device which was previously defined with the address `oldaddr` has been changed to the address `newaddr`.
  Issued by
    config.c, function define_device
`HHCCF051S Error in filename line lineno: verid is not a valid CPU version code`
  Meaning
    The version code `verid` specified on the `CPUVERID` configuration statement at line number `lineno` of the file named `filename` must be exactly two digits long, and must be a valid hexadecimal number.
  Action
    Correct the model number and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF052S Error in filename line lineno: option: invalid argument`
  Meaning
    The argument option on the DIAG8CMD is invalid. Valid options are `enable` and `disable`.
  Action
    Correct the statement and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF053E Incorrect second device number in device range near character c`
  Meaning
    The 2nd argument of a device range contains an incorrect device number
  Action
    Correct the statement and restart Hercules.
  Issued by
    config.c, function parse_devnums
`HHCCF054E Incorrect Device count near character c`
  Meaning
    The count field in a device count specification is invalid
  Action
    Correct the statement and restart Hercules.
  Issued by
    config.c, function parse_devnums
`HHCCF055E Incorrect device address specification near character c`
  Meaning
    The first or only CUU in a device specification statement is invalid
  Action
    Correct the statement and restart Hercules.
  Issued by
    config.c, function parse_devnums
`HHCCF056E Incorrect device address range. CUU1>CUU2`
  Meaning
    The first device number of a range is greater than the last device number
  Action
    Correct the statement and restart Hercules.
  Issued by
    config.c, function parse_devnums
`HHCCF057E CUU is on wrong channel (1st device defined on channel CC)`
  Meaning
    At least one of the devices in a device number specification is on a different channel than a previously defined device number within the same specification. All device numbers on a single configuration line must be on a single channel (Group of 256 devices)
  Action
    Correct the statement and restart Hercules.
  Issued by
    config.c, function parse_devnums
`HHCCF058E Some or all devices in CUU-CUU duplicate devices already defined`
  Meaning
    At least one of the device numbers on a device specification statement defines a device number that is already specified on that same statement.
  Action
    Correct the statement and restart Hercules.
  Issued by
    config.c, function parse_devnums
`HHCCF061W ECPS:VM Statement deprecated. Use ECPSVM instead`
  Meaning
    The "ECPS:VM" statement was encountered. This statement is deprecated in favor of the "ECPSVM" statement.
  Action
    The configuration statement is still carried out, but the statement syntax should be changed as soon as possible.
  Issued by
    config.c
`HHCCF062W Missing ECPSVM level value. 20 Assumed`
  Meaning
    The "ECPSVM" statement keyword "LEVEL" was encountered, but no numeric level followed it
  Action
    The default level of 20 is used, and the ECPS:VM feature is made available. The statement should be corrected as soon as possible.
  Issued by
    config.c
`HHCCF063W Specifying ECPSVM level directly is deprecated. Use the 'LEVEL' keyword instead`
  Meaning
    The deprecated "ECPSVM" level syntax form (without the LEVEL keyword) was found.
  Action
    The ECPS:VM Level is set to the specified value. The configuration statement should be updated to include the "LEVEL" keyword.
  Issued by
    config.c
`HHCCF064W Hercules set priority priority failed: error`
  Meaning
    An attempt to change the priority of the Hercules process to `priority` failed. The error is described by `error`. The process priority has not been changed. Hercules overall performance may be impaired as a result.
  Action
    If performance problems are noted, correct the error and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF065I Hercules: tid=threadid, pid=processid, pgid=processgroupid, priority=priority`
  Meaning
    Hercules thread id is `threadid`, its process id is `processid`, its process group id is `processgroupid` and its execution priority is `priority`.
  Issued by
    config.c, function build_config
`HHCCF066E Invalid HTTPROOT: error`
  Meaning
    The pathname specified on your HTTPROOT statement is invalid. The error is described by `error`.
  Action
    Correct the error and restart Hercules.
  Issued by
    config.c, function build_config
`HHCCF067S Incorrect keyword keyword for the ASN_AND_LX_REUSE statement`
  Meaning
    The keyword specified for the ASN_AND_LX_REUSE statement is not ENABLE or DISABLE
  Action
    Correct the error and restart Hercules.
  Issued by
    bldcfg.c, function build_config
`HHCCF068S Error in filename line lineno: Invalid Auto_SCSI_Mount value: value`
  Meaning
    The automatic SCSI tape mount value is not "NO" nor a value between 1 and 99 seconds inclusive.
  Action
    Correct the error and restart Hercules.
  Issued by
    bldcfg.c, function build_config
`

    HHCCF069I Run-options enabled for this run:
              NUMCPU:           n
              ASN-and-LX-reuse: Enabled/Disabled
              DIAG8CMD:         Enabled/Disabled

`
  Meaning
    This message confirms the setting of various run-time options specified in the configuration file at startup time.
  Action
    None.
  Issued by
    bldcfg.c, function build_config
`HHCCF074E Unspecified error occured while parsing Logical Channel Subsystem Identification`
  Meaning
    A logic error occured while parsing the Logical Channel Subsystem Identification component of a device number or device number group.
  Action
    Notify hercules support. This is an error in the hercules parsing routines.
  Issued by
    config.c, function parse_lcss
`HHCCF075E No more than 1 Logical Channel Subsystem Identification may be specified`
  Meaning
    While specifying a device number or device number group, more than 1 ':' character was encountered while parsing the Logical Channel Subsystem Identification component. There can be only one Logical Channel Subsystem Identification for a device or group of devices.
  Action
    Correct the device number or device number group specification and either reissue the command or restart the hercules engine (depending on whether the error occured while issuing a command or while starting the engine).
  Issued by
    config.c, function parse_lcss
`HHCCF076E Non numeric Logical Channel Subsystem Identification XX`
  Meaning
    While specifying a device number or device number group, a non decimal value was encountered while parsing the Logical Channel Subsystem Identification component. The Logical Channel Subsystem Identification for a device or group of devices must be specified as a numeric value.
  Action
    Correct the device number or device number group specification and either reissue the command or restart the hercules engine (depending on whether the error occured while issuing a command or while starting the engine).
  Issued by
    config.c, function parse_lcss
`HHCCF077E Logical Channel Subsystem Identification NN exceeds maximum of 3`
  Meaning
    While specifying a device number or device number group, a Logical Channel Identification was encountered that exceeded the architecture maximum value of MM. The Logical Channel Subsystem Identification for a device or group of devices must be within 0 and 3 (inclusive).
  Action
    Correct the device number or device number group specification and either reissue the command or restart the hercules engine (depending on whether the error occured while issuing a command or while starting the engine).
  Issued by
    config.c, function parse_lcss
`HHCCF081I fname Will ignore include errors .`
  Meaning
    An `ignore include_errors` statement was encountered in file fname requesting that any `include` statements subsequently found within file fname which happen to reference include files which do not exist should simply cause a `HHCCF084W` warning instead of a `HHCCF085S` fatal error.
  Action
    Processing continues. This is an informational-only message.
  Issued by
    bldcfg.c, function build_config
`HHCCF082S Error in fname line nnn: Maximum nesting level (nn) reached`
  Meaning
    The maximum number of nested `include` statements has been exceeded. The `include` statement which caused the maximum nesting level of nn to be exceeded is identified as statement number nnn of file fname.
  Action
    This is a fatal error. Configuration file processing is immediately terminated and Hercules startup is aborted. Correct the error and restart Hercules.
  Issued by
    bldcfg.c, function build_config
`HHCCF083I fname1 Including fname2 at nnn.`
  Meaning
    An `include` statement for file fname2 was encountered on line nnn of file fname1.
  Action
    Configuration file processing switches immediately to processing the statements contained in file fname2. Once all of the ststements in file fname2 have been completely processed, configuration file processing will then return to statement nnn+1 of file fname1. This is an informational-only message.
  Issued by
    bldcfg.c, function build_config
`HHCCF084W fname1 Open error ignored file fname2: error`
  Meaning
    File fname1 contained an `include` statement for file fname2 which could not be opened because of error.
  Action
    Processing continues. This is a informational warning only. Check to make sure the filename specified by fname2 was spelled correctly and restart Hercules if desired.
  Issued by
    bldcfg.c, function build_config
`HHCCF085S fname1 Open error file fname2: error`
  Meaning
    File fname1 contained an `include` statement for file fname2 which could not be opened because of error.
  Action
    This is a fatal error. Configuration file processing is immediately terminated and Hercules startup is aborted. Correct the possible misspelling of filename fname2 and restart Hercules.
  Issued by
    bldcfg.c, function build_config

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

Last updated 19 October 2005