This appendix contains the messages for Host Access Class Library.
(ECL0001) Internal Host Access Class Library program error.
Explanation
The Host Access Class Library has encountered an internal problem.
User Action
If there are other messages preceding this one, try to correct any indicated problems.
Also ensure you have the latest fixes applied for this product. If the problem persists,
following the directions in the README file for reporting product problems.
(ECL0002) An Host Access Class Library event error occurred.
Explanation
The Host Access Class Library encountered a problem during event generation. This is a
notification message only. There should be other messages logged that provide more
details.
User Action
Look for other messages in the message log to determine the cause of this error.
(ECL0003) Error updating field at %1. The field is protected.
Explanation
You attempted to write to a protected field, which is not allowed.
User Action
If the error was generated during normal use of Host On-Demand, follow the directions in
the README file to report the problem. If the error was generated by another applet,
application or product that uses the Host Access Class Library, contact the originator of
the applet, application or product to report this problem.
(ECL0004) No field found at position %1.
Explanation
No field was found at the specified location. This was probably the result of an internal
error.
User Action
If the error was generated during normal use of Host On-Demand, follow the directions in
the README file to report the problem. If the error was generated by another applet,
application or product that uses the Host Access Class Library, contact the originator of
the applet, application or product to report this problem.
(ECL0006) Browser version is not valid.
Explanation
Host On-Demand could not create the requested session because the current browser or
execution environment does not support all the needed functions. Host On-Demand must run
in a browser or execution environment that fully supports JVM version 1.1.
User Action
Obtain the latest version of the browser from your system administrator or the company
that supplies it.
(ECL0007) Server %1 could not be authenticated for this connection.
Explanation
A secure connection was requested with an authenticated server. however, the server could
not be authenticated.
User Action
Check with your network security personnel to see if server authentication is necessary
for this connection. If server authentication is not necessary, do not request server
authentication when defining the session. If server authentication is necessary, the
common name in the subject field of the server's certificate must be the same as the
server's network name.
See the information about configuring SSL security in the IBM Host On-Demand Getting Started Guide for more information.
(ECL0008) Could not create a secure connection to server %1.
Explanation
Host On-Demand attempted a secure connection to the server, but the attempt was not
successful.
User Action
Make sure the server you are trying to connect to supports SSL 3.0 secure connections.
Also ensure that all certificates owned by the server and the client are valid and have
not expired.
It is also possible that the server does not have enough capacity to accept another secure connection at this time. If this is the case, try the connection when the server is not as busy.
(ECL0010) Parameter %1 is not valid. The value is %2.
Explanation
The value specified for the given parameter is not valid for one of the following reasons:
User Action
If you supplied the value for this parameter, refer to the Host Access Class Library
reference to verify that you are using a valid value.
If the error is generated during normal use of Host On-Demand, follow the directions in the README file to report the problem. If the error is generated by another applet, application or product that uses the Host Access Class Library, contact the originator of the applet, application or product to report this problem.
(ECL0011) Parameter %1 is not valid. The value is null.
Explanation
The value specified for the given parameter is not valid because it is null.
User Action
If you supplied the value for this parameter, refer to the Host Access Class Library
reference to verify that you are using a valid value.
If the error is generated during normal use of Host On-Demand, follow the directions in the README file to report the problem. If the error is generated by another applet, application or product that uses the Host Access Class Library, contact the originator of the applet, application or product to report this problem.
Explanation
The value specified for the given parameter is not valid because it contains a mnemonic
keyword that is either incomplete or unrecognized.
User Action
If you supplied the value for this parameter, refer to the Host Access Class Library
reference to verify that you are using a valid value.
If the error is generated during normal use of Host On-Demand, follow the directions in the README file to report the problem. If the error is generated by another applet, application or product that uses the Host Access Class Library, contact the originator of the applet, application or product to report this problem.
(ECL0030) The server certificate from host %1 is not yet valid.
Explanation
Before establishing a secure session, the server must present a certificate to the client
that is valid only for a specified period of time. In the aborted connection, the
certificate that the host presented will be valid at a future date, but is not currently
valid.
User Action
First, make sure the client configuration has the correct date, time, and time zone. If
any of these values are wrong, make the appropriate corrections.
If the client is correct and you are using a self-signed certificate generated on the server, check the date, time, and time zone of the server. If any of these are wrong, make the appropriate corrections and re-create the self-signed certificate.
(ECL0031) The server certificate from host %1 has expired.
Explanation
Before establishing a secure session, the server must present a certificate to the client
that is valid only for a specified period of time. In the aborted connection, the
certificate that the host presented was valid at a past date, but is not currently valid.
User Action
First, make sure the client configuration has the correct date, time, and time zone. If
any of these values are wrong, make the appropriate corrections.
If the client is correct and you are using a self-signed certificate generated on the server, check the date, time, and time zone of the server. If any of these are wrong, make the appropriate corrections and re-create the self-signed certificate.
If the client is correct and you are using a CA-signed certificate, check the validity of the certificate. If the validity period has expired, you may need to renew the certificate with the CA.
(ECL0076) Sequence %1 is not valid or is unsupported.
Explanation
This message might appear during a VT emulator session. This message is logged by the
DataStream component if a VT host application sends a sequence that HOD does not support
(for example, ansi color sequences), or if it sends a VT sequence that is not valid.
User Action
Receiving these sequences may not affect screen output. If the application is acting
abnormally, turn on trace level 1 for the DataStream component and rerun the scenario.
Submit the trace/log files to the VT Host application administrator.
The administrator can use the trace files to debug an erroneous program. The administrator may determine that the application requires a terminal type different than VT220/VT100/VT52.
(ECL0126) An exception was detected at reference location %1.
Explanation
An exception condition was detected by the file transfer program. The reference location
identifies where in the program the exception was detected.
User Action
This message is usually associated with a program error. Turn on trace level 1 for the
ECL_xfer and Transport components and rerun the scenario. Submit the trace/log files to
IBM support.
(ECL0127) File transfer complete.
Explanation
A file transfer was successfully completed.
User Action
No action is required.
(ECL0128) Error writing file to the host: file transfer canceled.
Explanation
The file could not be written to the host.
User Action
Check to make sure you have enough space and that the disk is still online. Correct any
problems and try to transfer the file again.
(ECL0129) Error reading file from the host: file transfer canceled.
Explanation
The file could not be read from the host.
User Action
Check to make sure you have enough space and that the disk is still online. Correct any
problems and try to transfer the file again.
(ECL0130) Required host storage is unavailable: file transfer canceled.
Explanation
Adequate host resources are not available to store the file.
User Action
Create more room on the host by deleting files or adding space, then try to transfer the
file again.
(ECL0131) Incorrect request code: file transfer canceled.
Explanation
An incorrect request was issued to the host file transfer program.
User Action
Run a trace and report the results to IBM.
(ECL0132) Incorrect or missing TSO data set: file transfer canceled.
Explanation
An incorrect data set was specified for the transfer.
User Action
Make sure you specified the correct file name, then try to transfer the file again.
(ECL0133) Missing or incorrect CMS file identifier: file transfer canceled.
Explanation
An incorrect CMS file identifier was specified.
User Action
Make sure the CMS file identifier is correct, then try to transfer the file again.
(ECL0134) Incorrect option specified: file transfer canceled.
Explanation
An incorrect host file transfer option was specified.
User Action
Make sure the options specified for this transfer are correct, then try to transfer the
file again. If the file transfer still fails, contact the administrator of the host
transfer program for assistance.
(ECL0135) Error reading from or writing to host disk: file transfer canceled.
Explanation
The host computer detected an error reading or writing to disk.
User Action
Check to make sure you have enough space and that the disk is still online. Correct any
problems and try to transfer the file again.
(ECL0136) Only one of TRACKS, CYLINDERS, AVBLOCK allowed: file transfer canceled.
Explanation
Only one media division can be specified.
User Action
TRACKS, CYLINDERS, or AVBLOCKS are not specified by HftpTransfer programmatically. If
these are specified manually, please be sure that such specification is in accordance with
the host file transfer program.
(ECL0137) CMS file not found: file transfer canceled.
Explanation
The requested file was not found.
User Action
Correct the specification of the file you want to transfer, then try to transfer the file
again. If the file transfer still fails, contact the administrator of the host transfer
program for assistance.
(ECL0138) CMS disk is read-only: file transfer canceled.
Explanation
Write access is required but is not available to perform the requested operation.
User Action
Obtain the appropriate write access for the requested operation, then try to transfer the
file again. If the file transfer still fails, contact the administrator of the host
transfer program for assistance.
(ECL0139) CMS disk is not accessed: file transfer canceled.
Explanation
The requested CMS mini-disk is not accessed.
User Action
Obtain appropriate access for the requested operation, then try to transfer the file
again. If the file transfer still fails, contact the administrator of the host transfer
program for assistance.
(ECL0140) CMS disk is full: file transfer canceled.
Explanation
The requested CMS mini-disk is full.
User Action
Allocate additional storage or delete files on the target disk to provide storage to
support the requested transfer, then try to transfer the file again. If the file transfer
still fails, contact the administrator of the host transfer program for assistance.
(ECL0141) Host program error: file transfer canceled.
Explanation
An unspecified error was detected by the host file transfer program.
User Action
Try to transfer the file again. If file transfer still fails, run a trace and report the
results to IBM.
(ECL0142) Host operation failed to complete within timeout period.
Explanation
The host did not respond within the specified timeout period. The timeout period is
applied to the smallest increment of processing that indicates the host is attempting to
service the request. For example, to download a large file the host transfers many
separate buffers of data. The timeout period is applied separately to each buffer
transferred.
It is possible that:
User Action
In some cases, you can extend the timeout period to circumvent this problem. Otherwise, it
will be necessary to determine why the host response is delayed and apply appropriate
corrective action. Change the timeout parameter to a higher value.
(ECL0143) Session with host does not exist. Please close file transfer windows.
Explanation
The host session has been closed or lost. File transfer is not possible.
User Action
Stop file transfer by closing the file transfer windows. To use the file transfer
function, start a new session.
(ECL0144) Unable to open the local file for reading.
Explanation
The file transfer facility attempted to read a file on the local file system but could not
open the file. The filename or filepath may not have been entered correctly. In the case
of a removable disk, the disk may not be installed.
User Action
Verify that the file is correctly specified and that media is correctly mounted.
(ECL0145) Unable to open the local file for writing.
Explanation
The file transfer facility attempted to open a file for writing, but could not open the
file. The specified file may already exist and be write-protected, removable media may not
be installed or may be write-protected, or the media may be full.
User Action
Confirm that the correct filepath is specified. Confirm that the media is installed and is
not write-protected.
(ECL0146) Error while reading from the local file system.
Explanation
This error could be caused by a hardware or media failure. In the case of removable media,
the media may have been inadvertently dismounted during a transfer operation; for example,
someone opened the disk drive.
User Action
Confirm that the media is properly installed.
(ECL0147) Error while writing to the local file system.
Explanation
The disk has become filled to capacity or a hardware failure has occurred. In the case of
removable media, the disk may have been inadvertently removed.
User Action
Verify that the media is properly mounted. Verify that adequate disk capacity is
available. It may be necessary to remove some files to make room for the new files you are
downloading.
(ECL0148) File transfer canceled by an external caller.
Explanation
The file transfer was canceled by a call to ECLXfer.Cancel().
User Action
No action is required.
(ECL0149) Cannot transfer a zero-length file: file transfer canceled.
Explanation
The PC file is of size zero bytes and cannot be transferred to the host.
User Action
Specify a PC file that is not empty.
Explanation
The compiler cannot create an empty PDT object.
User Action
Contact IBM service.
(ECL0168) Could not open the PDT Compiler log.
Explanation
The compiler cannot open the log file pdtc.log.
User Action
Make sure there is enough disk space to open the file.
(ECL0169) The description must begin with a non-blank character.
Explanation
The printer description begins with a blank character.
User Action
Type a printer description that begins with a character other than blank.
(ECL0170) A valid description must be entered.
Explanation
You tried to compile without typing a printer description.
User Action
Enter a valid printer description.
(ECL0171) You must select a valid PDF file.
Explanation
You attempted to compile before selecting a PDF from the choice box.
User Action
Select the PDF you want to compile from the choice box.
(ECL0172) The description may not begin with KEY.
Explanation
You have typed a printer name description that begins with KEY. KEY is reserved by IBM.
User Action
Enter a printer name description that does not begin with KEY.
(ECL0173) The description may not be blank.
Explanation
The printer description field is blank.
User Action
Enter a printer description.
(ECL0174) Compiler failed--internal error.
Explanation
The PDT compiler failed.
User Action
Contact IBM service.
(ECL0175) Error reading macro definition.
Explanation
An error was encountered while reading the PDF from disk to obtain macro definitions.
User Action
Make sure the disk is online and available.
Open the PDF with an editor and make sure that it is valid. Correct any errors.
(ECL0176) Warning: Unrecognized parameter defined:
Explanation
A parameter defined in the PDF is not recognized by the PDT Compiler. It is possible you
have modified the PDF to support a custom function that requires this parameter.
User Action
Usually, no action is required.
(ECL0177) Command name unknown:
Explanation
The PDF contains a command definition that is not recognized by the compiler.
User Action
Remove the command definition from the PDF.
(ECL0179) Error converting decimal string to byte.
Explanation
An attempt was made to code a decimal string larger than 255, which is the maximum value
that can be stored in 1 byte.
User Action
Correct the failing definition in the PDF.
(ECL0180) EQU is not the second token in the macro.
Explanation
A macro definition does not EQU as the second token.
User Action
Add EQU to the PDF definition.
Explanation
A command definition contains a token for which there is no valid macro definition.
User Action
Correct the failing definition in the PDF.
(ECL0182) Could not open PDF file:
Explanation
The compiler can not open the selected PDF.
User Action
Make sure the selected PDF exists.
Explanation
The compiler detected errors.
User Action
Review the errors detected by the compiler.
Correct the failing definitions in the PDF and try to compile again.
(ECL0185) Less than 3 tokens in macro definition.
Explanation
A macro definition has less than 3 tokens.
User Action
Correct the failing definition in the PDF.
(ECL0186) Macro name length not 3.
Explanation
The first token of a macro definition is not 3 characters in length.
User Action
Correct the failing definition in the PDF.
(ECL0251) Unable to contact the host.
Explanation
Unable to get a connection to the host.
User Action
Make sure that the host is running and that you are able to ping it.
Explanation
An incorrect host file name was specified.
User Action
Specify the host file in any of the following formats:
The file name QGPL/QCLSRC is equivalent to /QSYS.LIB/QGPL.LIB/QCLSRC.FILE in IFS format. The file name QGPL/QCLSRC(README) is equivalent to /QSYS.LIB/QGPL.LIB/QCLSRC.FILE/README.MBR in IFS format.
(ECL0253) Host file already exists: file transfer canceled.
Explanation
The host file already exists and the transfer option NEW was specified to avoid
over-writing the existing file.
User Action
Specify a file that does not exist.
(ECL0254) Host file does not exist: file transfer canceled.
Explanation
The host file does not exist.
User Action
Specify an existing host file.
(ECL0255) PC file already exists: file transfer canceled.
Explanation
The PC file already exists and the transfer option NEW was specified to avoid over-writing
the existing file.
User Action
Specify a file that does not exist.
(ECL0256) PC file does not exist: file transfer canceled.
Explanation
The PC file does not exist.
User Action
Specify an existing PC file.
(ECL0257) The selected host file type is not supported.
Explanation
The selected host file can't be transferred to the host. Only AS/400 objects of the type
*FILE are supported under the QSYS library file system. Also, among the AS/400 *FILE
objects, only the file types PF-DTA (Physical Data File), PF-SRC (Source Physical file)
and SAVF are supported.
User Action
Specify a valid host file.
(ECL0258) Only binary mode allowed for transferring AS/400 SAVF files.
Explanation
For transferring SAVF files to the AS/400, the transfer mode must be binary.
User Action
The transfer options ASCII, JISCII or UNICODE should not be specified for transferring
SAVF files to the AS/400.
(ECL0259) Unable to open the host file for writing.
Explanation
The host file cannot be be created or changed.
User Action
Make sure that the user has authority to create or change the file.
(ECL0260) Unable to open the host file for reading.
Explanation
The host file cannot be read.
User Action
Make sure that the user has authority to read the file.
Explanation
Unable to complete the requested transfer operation.
User Action
If you are performing 5250 File Transfer and if an error message ID is included in the
message (Such as: CPF9999), you can get more help by using the CL command DSPMSGD on the
AS/400. Also, if you get any the following error messages when performing 5250 File
Transfer, please refer to the Installation and Planning guide and make sure that the setup
instructions were followed. You could still get any of the following messages, if the host
name is NOT the actual final destination address of the 5250 host. The default file
transfer settings of the Host On Demand session can be changed to correctly indicate the
actual final destination address of the 5250 host. For HACL applications, the transfer
option DSTADDR can be used to set the final destination address for file transfer.
If you get the following message, please make sure that the environment variable CLASSPATH is set to nothing before invoking 5250 File Transfer.
If you get the following message, please add ha5250xn.jar to the list of archives in the HTML file used to start the client.
Explanation
Unable to log on to the host.
User Action
Specify a valid user ID and password to log on to the host.
(ECL0263) Transfer incomplete. Only %1 bytes transferred.
Explanation
Only part of the file has been transferred.
User Action
Try to transfer the file again. If it still fails, run a trace and report the results to
IBM.
Explanation
The current version of the Java Virtual Machine is not capable of handling the specified
encoding.
User Action
Upgrade the Java VM to the latest version and check whether it can support the specified
encoding.
(ECL0300) Unknown socks host %1. No connection made.
Explanation
The Socks proxy host could not be found.
User action
Verify that the name or IP address are correct.
(ECL0301) Communication failure with Socks v%1 host %2 on port %3
Explanation
The Socks proxy host was found but no connection to it could be made.
User action
Verify that the connection was configured correctly.
(ECL0302) Authentication failure with Socks v%1 host %2 on port %3
Explanation
The Socks host could not authenticate with the user ID and password supplied.
User action
Verify that the user ID and password are valid for the Socks host.
(ECL0303) No connection available through Socks v%1 host %2.
Explanation
The type of connection requested through the Socks host is not allowed.
User action
Change the connection type to one that is supported by the Socks host.
(ECL0304) Destination Address Connection failure via Socks v%1 host %2. Status is %3.
Explanation
The Socks host could not connect to the final destination host.
User action
Verify that the final destination host is available and that its IP address or name are correct.
(ECL0305) Error negotiating authentication method with Socks host %1.
Explanation
The Socks authentication method selected is different from the authentication method required by the Socks host
User action
Change the Socks authentication method to one that is supported by the Socks host.
(ECL0306) Configuration error resulting in an error creating socket on socks host.
Explanation
Socks proxy properties were not set up on the client before an attempt was made to open a socket.
User action
Verify that the Socks proxy server properties are set correctly.
Explanation
The Socks proxy host is a Socks v5 proxy, but the user configured Socks v4 and the Socks Proxy host does not allow Socks v4 connections.
User action
Configure a Socks proxy connection on the client that matches the one supported by the Socks proxy host.
(ECL0310) Unknown HTTP Proxy host %1. No connection made.
Explanation
The HTTP proxy could not be found.
User action
Verify that the name or IP address are correct.
(ECL0311) Communication failure with HTTP Proxy %1 on port %2
Explanation
The HTTP proxy was found but no connection to it could be made.
User action
Verify that the connection was configured correctly.
(ECL0312) Authentication failure with HTTP Proxy %1 on port %2
This error message is not currently in use because Host On-Demand does not support HTTP proxy server authentication.
(ECL0313) Connection failure via HTTP Proxy %1 host
Explanation
The HTTP proxy host could not connect to the final destination.
User action
Verify that the final destination host is available and that its IP address or name are correct.
[ Top of Page | Previous Page | Next Page | Table of Contents]