Host Access Class Library for Java

Appendix C. Host Access Class Library Messages

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 Z and I Emulator for Web, 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.

(ECL0006) Browser version is not valid.

Explanation Z and I Emulator for Web could not create the requested session because the current browser or execution environment does not support all the needed functions. Z and I Emulator for Web 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 HCL Z and I Emulator for Web Getting Started Guide for more information.

(ECL0008) Could not create a secure connection to server %1.

Explanation Z and I Emulator for Web 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:

The value is out of the permitted range.
The value is not recognized.
The value is not valid for the current session type.

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 Z and I Emulator for Web, 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.

(ECL0012) Parameter %1 is not valid. The data contains an incomplete or unrecognized mnemonic keyword.

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.

(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 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 ZIEWeb 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 HCL 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 HCL.

(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 HCL.

(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:

Access to the host has been lost.
The system is heavily loaded and response is being delayed.
The timeout period is too short.
The host is not in the correct state to perform file transfer.

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.

(ECL0160) Error creating PDT.

Explanation The compiler cannot create an empty PDT object.

User Action Contact HCL 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 HCL.

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 HCL 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.

(ECL0181) Bad token detected:

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.

(ECL0183) Compilation failed.

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.

(ECL0252) Invalid host file name. Use the correct format: LibraryName/FileName OR LibraryName/FileName(MemberName) OR /Dir1/.../DirX/FileName

Explanation An incorrect host file name was specified.

User Action Specify the host file in any of the following formats:

LibraryName/FileName
LibraryName/FileName(MemberName)
/Dir1/.../DirX/FileName

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.

(ECL0261) Transfer error: %1

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.

ECL0261: Transfer error: Connection refused
ECL0261: Transfer error: Server socket not accepting.: An unknown problem has occurred.
ECL0261: Transfer error: SOCKS server cannot connect to identd

If you get the following message, please make sure that the environment variable CLASSPATH is set to nothing before invoking 5250 File Transfer.

ECL0261: Transfer error: sun.io.ByteToCharSingleByte: field byteToCharTable Ljava/lang/String; not found

If you get the following message, please add ha5250xn.jar to the list of archives in the HTML file used to start the client.

ECL0261: Transfer error: security.fd.write

(ECL0262) Security error: %1

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 HCL.

(ECL0264) Unable to convert data in UNICODE mode: the current version of the Java VM is not capable of handling %1 encoding.

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.

( ECL0307) The Socks Proxy version configured on the client differs from the actual Socks Proxy server version.

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 Z and I Emulator for Web 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]