Hercules Version 2: 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 CPU thread priority priority
Meaning
The CPU thread priority priority specified on the CPUPRIO configuration statement at line number lineno of the file named filename must be a valid decimal number.
Action
Correct the CPU thread priority and restart Hercules.
Issued by
config.c, function build_config
HHCCF017W Hercules is not running as setuid root, cannot raise CPU priority
Meaning
A negative value for the CPU thread priority parameter CPUPRIO 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, 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.
Action
Specify a supported device type.
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


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


back

Last updated 16 December 2002