PreviousCCI.INI - The CCI Configuration File Attachmate Personal Client v6.3Next

Chapter 9: CCI Status Messages

9.1 CCI Status Messages

All CCI modules produce text based error messages describing the status of the completion of the last CCI operation. Some errors are critical and require remedial action before use of the affected CCI module can continue, others are warnings and may in most cases do not require any action to be taken on the part of the user.

When an error occurs in the communications layer the CCI status codes returned to calling applications will change to reflect the underlying problem that has occurred. All CCI enabled applications can then make a call to CCI to obtain a text message describing the problem.

The manner in which these messages is returned to the application user is specific to each application, however the actual text returned from CCI is the same in all cases. The sections below indicate what the status messages mean, and what steps can be taken by the user to correct the situation which created the error status in the first place.

The text format used for all CCI messages is as follows:-

"CCINETB-0001I A CCINETB call has timed-out."

This is broken down in to the following sections:-

Protocol issuing the message - "CCINETB"

Message number - "0001"

Severity level - "I"

Message text.- "A CCINETB call has timed-out."

Not all the available messages are produced by all the protocol modules, there are also messages which are specific to individual aspects of configuration on specific protocol environments. Some status are intended for use only during the development of CCI enabled applications, where these status are seen by the end user they should contact Micro Focus technical support staff and report the situation and applications which generated the status condition.

9.2 CCI Message Table

The following is a list of status numbers returned which may be produced from CCI modules, along with a brief explanation of their meaning, and, if applicable, a suggestion as to how to resolve the issue being reported. Status numbers which are produced to aid coding of CCI applications have been included in this list.

Message Number
Severity
Reason
Suggestion
0000 Information The last operation completed successfully No action to take
0001 Information The last operation Timed-out prior to completion. Increase time-out periods if the application allows, or check the status of the remote application to ensure that its host system is still functioning.
0002 Information A buffer given to a CCI receiving operation was too small to contain the incoming data stream. This is a warning intended for applications designers. Contact Micro Focus if you suspect that this is actually causing a problem.
0003 Error A bad parameter was given to a CCI function. This is a application coding problem. Contact Micro Focus technical support and report any of these errors that appear.
0004 Warning This is only generated from a Service initiation.
This status indicates that a Service with the same name was previously registered at the same network address.
No action required, the current Service is now registered with the network, connecting clients will connect to this Service.
0005 Error This is only generated from a Service initiation.
This status indicates that a Service with the same name was previously registered at the same network.
Two services cannot exist on some networks with the same Service name, choose another name to start this Service with.
0006 Error A name parameter passed being used to start a client or a Service was invalid. The range of valid names differs for underlying protocols, please see the sections for the relevant CCI module for the protocol in use for this information.
0007 Error An attempt was made to use a connection which has already been terminated. This is a application coding error, contact Micro Focus technical support and report any occurrence of this error.
0008 Error A broken connection was detected on this link. Check the status of the network supporting this link and determine whether the problem lies at the network or at the machine at the far end of the link.
0010 Warning The CCI module in use was too busy to complete the request. Allow some of the outstanding CCI actions to complete before trying again.
0011 Warning The CCI module discovered that the system was too low on memory to complete an action. Close any unwanted applications, and free up some memory to allow the application to continue.
0012 Error No service was found, the client could not complete a connection request. Check the address passed as a location to the client and try again.
0013 Error The address specified in the direct addressing modes would not accept a client connection. Check the address passed as a location to the client and try again. The service listening at the far end may not be compatible with a CCI client.
0014 Error An error occurred when creating a network endpoint. The local network service provider was incapable of creating a new connection point, this usually means that a resource limit has been reached, or that the network itself is disabled. Check the system status and raise network resources as appropriate.
0015 Error A transport error has occurred CCI full network transport failure has been reported to CCI from the transport provider. Check the network status, correct any problems that are found and try again.
0016 Error A CCI support module was not found on the network. Some CCI protocols and configurations require network support modules, such as CCITCP2, please check to ensure that you have configured your network correctly to use CCI, and that the required support modules are running before starting CCI, then try again.
0017 Error A transport connection error has occurred Where possible CCI will distinguish between this message and message 0016. This message indicates that an individual connection has failed, rather than a general network failure occurring. Check the application at the far end of the link to ensure that it is still functioning.
0018 Information An asynchronous call has not completed yet. This status is intended for application programmers to monitor the status of an ongoing operation, it may be ignored by end users.
0019 Information An asynchronous call has completed correctly. This status is intended for application programmers to monitor the status of an ongoing operation, it may be ignored by end users. It is functionally equivalent to status "0000".
0020 Information An asynchronous call has completed part one of a two part operation.. This status is intended for application programmers to monitor the status of an ongoing operation, it may be ignored by end users.
0021 Error An error occurred when closing a session. This could be a network or operating system failure, however a failure at this time may not affect the overall running of an application. Contact Micro Focus technical support if you suspect that this is actually causing a problem.
0022 Error This is only generated from a Service termination.
Could not de-register a service
There was a problem when terminating a service that prevented it being de-registered from the CCI support modules such as CCITCP2, or from the network provider itself. Subsequent attempts to start a Service with the same name will generate messages 0004 or 0005 depending upon the network which is being used.
0023 Error This is only generated from a Service application.
A client connection could not be completed due to a network level error condition.
The network service provider reported a failure to allow a full connection of an incoming client. Check the connecting clients to determine which of them is failing to connect, then check the network provider on the client and server machines for version compatibility.
0024 Error A call to HANGUP a server session could not complete as data was still queued. This is an application coding error. Contact Micro Focus technical support.
0025 Error Transport initialization failure, INITCLIENT could not find CCITCP2, The UDP support in the TCP/IP service provider configuration may be switched off, or may have run out of available resources. Ensure that UDP is enabled and that sufficient sockets are available, then try again.
0026 Error Transport initialization failure during INITCLIENT. Check the version details of the network service provider to ensure that CCI is compatible with this level of network provider.
0027 Error A call to CCI-Query was made with an invalid session handle. This is an application coding error. Contact Micro Focus technical support.
0028 Error A call to CCI-Wait was made with an invalid session handle. This is an application coding error. Contact Micro Focus technical support.
0029 Error Parameters were incorrectly passed to the call named in the text. This is an application coding error. Contact Micro Focus technical support.
0030 Error A listen call failed as the machine was too busy to receive any more incoming client connections. The system configuration is too small to support the connection load being used, either increase the system capacity for the protocol in use, or reduce the load on this specific system by examining other possible alternative to using this system.
0031 Error A CCI function detected a transport failure during an attempt to receive a data buffer. The network, or the machine at the far end of the connection, experienced an error condition, correct the network error and try again.
0032 Error CCI-Transact function detected a transport failure during an attempt to send a data buffer. The network, or the machine at the far end of the connection, experienced an error condition, correct the network error and try again.
0033 Error CCI-Transact function detected a transport failure during an attempt to receive a data buffer. The network, or the machine at the far end of the connection, experienced an error condition, correct the network error and try again.
0034 Error CCITCP could not find an entry for "mfcobol" in the "services" TCP/IP configuration file. An entry such as :
'mfcobol <TAB> 86/udp'
must be included in the file for CCI to establish a registration ,or make a registration enquiry with a CCITCP2 module.
0035 Error The far end of a connection has been reset. Check this status of the remote end of a connection as it appears to have dropped off the network.
0036 Information CCITCP2 could not be found, a CCI Service could not de-register correctly from CCITCP2. The Service registration module, CCITCP2, may have been closed or the network link to the machine hosting CCITCP2 may have died. If CCITCP2 is still running any requests for this Service will find a registration which is not responding to Client connection attempts. Any further requests to register the Service by the same name will get a status "0004" returned as it was already registered. See the CCITCP configuration guide for further details about using CCITCP2.
0037 Error An invalid service handle was passed to the CCI function named in the text. This is an application coding error. Contact Micro Focus technical support.
0038 Error An invalid async' request handle was passed to CCI-Query or CCI-Wait. This message has been superceded by "0027" and "0028" and should only be found on older CCI installations. See "0027" and "0028" for the correct action to take.
0039 Warning A data buffer and length combination given to CCI crossed a segment boundary in memory. Data was truncated at this boundary. This is an application coding error. Contact Micro Focus technical support.
0040 Error A call to CCI-Suspend was made prior to a call to CCI-Resume. This is an application coding error. Contact Micro Focus technical support.
0041 Error A call to initialize a network service provider has failed Check the network support for the system and correct any problems found, then try again.
0042 Error Could not attach to a Network Server This CCIIPX message indicates that no NetWare server has been found on your network. CCIIPX cannot operate with a NetWare server on its network and so cannot continue.
0043 Error Cannot connect to an incompatible version of CCI A connection has been requested between dissimilar CCI installations, this has been detected and to prevent possible data flow problems a connection cannot be completed. please check the revisions in use and update the CCI installations as required before trying again.
0044 Error Could not register a service This could be a configuration error, see CCITCP2, or the underlying network could have failed to allow the registration due to insufficient capacity of available resources, see message 0025 and CCINETB configuration.
0045 Error A bad address was passed to a CCI initialization call. Check that the addresses used in the configuration are of the correct style and content for the CCI module being used, then try again.
0046 Error CCIAPPC failed to locate an APPC session Ensure that the local LU is defined for this session.
0047 Error A call to CCI failed as CCI has already been terminated. This is an application coding error. Contact Micro Focus technical support.
0048 Error A bad data buffer location was passed to CCI for use in sending or receiving data. This is an application coding error. Contact Micro Focus technical support.
0049 Error CCI-Trace was unable to create trace output files for the CCI module named in the text. There may be insufficient space left on the fixed disk to hold the data trace file. Please clear some space and try again.
0050 Error The requested CCI-TRACE output file could not be opened Check that write permissions are available for the user of the application being traced, and that there is sufficient disk space remaining to store the trace file before trying again.
0051 Error An unexpected CCI error has occurred. This is an internal CCI error. Contact Micro Focus technical support.
0052 Information This status is reserved for future use.
0053 Information This status is reserved for future use.
0054 Information This status is reserved for future use.
0055 Warning Cannot send or receive data on a suspended session. This is an application coding error. Contact Micro Focus technical support.


Copyright © 1998 Micro Focus Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
PreviousCCI.INI - The CCI Configuration File Attachmate Personal Client v6.3Next