Error and Informational Messages

This section contains the following descriptions of error, informational, and warning messages that can be encountered while using the eLink Adapter for XML component. The error messages are divided into two groups:

Conversion service failure
Error messages

Conversion Service Failure

If a data format conversion request should fail, TPESVCFAIL is returned to the calling TUXEDO application in the variable tperrno. See BEA TUXEDO Reference Manual for more information regarding tperrno, tpcall() or TPESVCFAIL. In addition, an FML32 buffer containing additional diagnostic information is returned to the calling TUXEDO application. This FML32 buffer contains two string fields ELINK_ADAPTER_ERR_CODE, and ELINK_ADAPTER_ERR.

ELINK_ADAPTER_ERR_CODE contains a string denoting one of the following error categories:

Error Categories

Description

ELINK_EAPP_API

The application's API returned an error. Note that this refers to the application's API returning an infrastructure level error rather than a business level error.

ELINK_EAPP_UNAVAIL

The application was unavailable.

ELINK_EATMI

An ATMI error occurred.

ELINK_ECONFIG

An error occurred with the adapter configuration data.

ELINK_EFML

An FML error occurred.

ELINK_EINVAL

Invalid value/argument error. For example, an FML32 request buffer is sent to an adapter without all the required FML32 fields being present.

ELINK_EITYPE

An input type mismatch. For example, converting between FML32 and application data types on the input.

ELINK_ELIMIT

Out of range value.

ELINK_ENOENT

No entry found. The application functionality corresponding to the service could not be found.

ELINK_EOS

An operating system error. For example, a memory allocation error.

ELINK_EOTYPE

An output type mismatch. For example, converting between FML32 and application data types on the output.

ELINK_EPERM

A permissions error.

ELINK_EPROTO

A protocol error.

ELINK_ETIME

A timeout error. For example, timing-out while waiting for the application to process the request.

ELINK_ETRAN

A transaction error.

Error Messages

The ELINK_ADAPTER_ERR field contains the complete error message as described in this section. These messages are also logged to the ULOG.

1000:ELINK_EINVAL ERROR

Fml2Bs called with bad params

DESCRIPTION

FML to XML conversion was invoked incorrectly.

ACTION

An Internal Error has occurred.

1001:ELINK_EFML ERROR

Failed lookup of FML32 field < fieldnames> FML error
<error message text>

DESCRIPTION

Attempted Fldid32 call for FML32 field <fieldname> failed.

ACTION

Verify field is defined in FML32 field table.

1002:ELINK_EFML ERROR

Failed to get length of field <field name> : < error mesg text>

DESCRIPTION

Call to Flen for FML32 field <field name> failed

ACTION

Verify field length is specified in FML32 field table.

1003:ELINK_EFML ERROR

Failed to find FML field < field name> : <error mesg text>

DESCRIPTION

Expected FML Field <field name> was not found in FML32 buffer

ACTION

Verify FGF File accurately describes the FML data that is to be converted to XML.

1004:ELINK_ECONFIG ERROR

APPDIR not defined

DESCRIPTION

Environment variable APPDIR is not defined

ACTION

Define APPDIR in ENVFILE.

1005:ELINK_ECONFIG ERROR

Cannot open <filename> (errrno=error number - error message text)

DESCRIPTION

Unable to open MTI File

ACTION

Make sure MTI file exists in APPDIR. Make sure permissions of the file allow read access.

1007:ELINK_EINVAL ERROR

Cannot restore type description from <filename> (rc=<return code>)

DESCRIPTION

Unable to access MTI information from mti_file <file name>

ACTION

Verify configured MTI file was generated using FML importer.

1008:ELINK_EINVAL ERROR

Cannot translate input FML data (rc = <return code>)

DESCRIPTION

Conversion of FML data to XML using MTI information failed

ACTION

Verify FML32 data and FGF File agree in the number of occurrences of FML fields that are to be converted.

1009:ELINK_EATMI ERROR

Error allocating FML32 buffer

DESCRIPTION

tpalloc() for FML32 buffer failed.

ACTION

Contact BEA Support.

1010:ELINK_EATMI ERROR

tprealloc failed <error message text>

DESCRIPTION

Call to tprealloc() failed

ACTION

Verify that there is sufficient memory available on the machine.

1011:ELINK_EFML ERROR

Unable to add FML field <field name> : < error mesg text>

DESCRIPTION

Fadd call failed to add data for FML field <field name>

ACTION

Verify elinkxml.fml is specified in environment variable FIELDTBLS32, and TUXDIR/udataobj is in environment variable FLDTBLDIR32.

1012:ELINK_ECONFIG ERROR

Required parameter -C missing

DESCRIPTION

Server command line option -C was missing

ACTION

Modify elinkxml server entry in UBBCONFIG file to specify configuration file name in CLOPTS with -C.

1012:ELINK_ECONFIG ERROR

Unable to open configuration file <filename>

DESCRIPTION

Unable to open configuration file specified in -C command line option

ACTION

Verify specified configuration file in UBBCONFIG file exists and has read permissions.

1013:ELINK_ECONFIG ERROR

No SERVER section defined in configuration file <filename>

DESCRIPTION

Adapter's configuration file is missing a SERVER section.

ACTION

Add SERVER section to configuration file.

1014:ELINK_ECONFIG ERROR

Invalid SERVER parameter: <error message text>

DESCRIPTION

An unrecognized parameter has been specified in the SERVER section of adapter configuration file.

ACTION

Delete unrecognized parameter from adapter's configuration file.

1015:ELINK_ECONFIG ERROR

No services defined in configfile <filename>

DESCRIPTION

No conversion services were configured in adapter's configuration file.

ACTION

Specify conversion services to be advertised in adapter's configuration file.

1016:ELINK_ECONFIG ERROR

Unrecognized conversion service <service name>

DESCRIPTION

Conversion service specified in adapter configuration file is incorrect

ACTION

Modify conversion service in configuration file to be FML2XML, FMLMTI2XML, or XML2FML.

1017:ELINK_ECONFIG ERROR

Invalid SERVICE parameter: <parameter name>

DESCRIPTION

An unrecognized parameter has been specified in the SERVICE section of adapter configuration file.

ACTION

Delete unrecognized parameter from adapter's configuration file.

1018:ELINK_EFML ERROR

Can't add ELINK_ADAPTER_ERR to err_fbfr

DESCRIPTION

Call to Fchg32 failed.

ACTION

Verify elinkxml.fml is in FIELDTBLS32 environment variable.

1018:ELINK_EFML ERROR

Can't add ELINK_ADAPTER_ERR_CODE to err_fbfr

DESCRIPTION

Call to Fchg32 failed.

ACTION

Verify elinkxml.fml is in FIELDTBLS32 environment variable.

1018:ELINK_EFML ERROR

err_fbfr is not fielded

DESCRIPTION

An internal error has occurred.

ACTION

Contact BEA Customer Support.

1018:ELINK_ELIMIT ERROR

Unable to add <service name> to hashtable

DESCRIPTION

An internal error has occurred.

ACTION

Contact BEA Customer Support.

1019:ELINK_EATMI ERROR

Unable to advertise service <service name>

DESCRIPTION

Call to tpadvertise service <service name> failed.

ACTION

Verify configured service name conforms to TUXEDO service name conventions. Verify that the first 15 characters of service name are not the same as another configured service.

1020:ELINK_EITYPE ERROR

input buffer is not FML32

DESCRIPTION

Input buffer received by conversion service was not FML32

ACTION

Modify TUXEDO application to invoke conversion service using an FML32 buffer.

1020:ELINK_EITYPE ERROR

tptypes() does not recognize input buffer : <error message text>

DESCRIPTION

Conversion service was passed data that was not allocated using tpalloc().

ACTION

Modify calling application to use tpalloc() to allocate FML32 data that is to be converted by conversion service

1021:ELINK_ENOENT ERROR

Unknown service <request name>s

DESCRIPTION

Conversion service call received for unknown service

ACTION

Add service to adapter's configuration file, or modify calling application to invoke correct conversion service.

[Table of Contents] [Prev] [Next]