Message Class 0022 - EntireX ACI - Translation and Conversion Errors

This message class is given in case of errors in user exits, e.g. translation routines. The situation can be examined via the error number returned, and after correction, the applications can be restarted. The messages have the format:

0022nnnn

where	0022	is the message class, and
	`nnnn`	is the message number in the range 0000 - 9999

Overview of Messages

00220046 | 00220075 | 00220081 | 00220085 | 00220223 | 00220437 | 00220438 | 00220531 | 00220649 | 00220650

00220046	TRANS: User Error Returned By Routine
Explanation	The translation routine for the service (specified in the service section of the Broker attribute file) has returned an error to EntireX Broker.
Action	Check for the translation routine in use. This is a user error if customer specific translation routines are in use. Contact Software AG Support if the translation routine delivered by Software AG is in use.

00220075 TRANS: Failed To Load Routine

Explanation

The user exit that performs translation services could not be loaded. The translation routine for the service is specified by the TRANSLATION parameter for the service in the attribute file. The routine is loaded during RECEIVE calls to the Broker.

Action

Check the log data set for further load failure messages. Possible causes for the failure are:

An incorrect name for the translation routine is specified.
The translation routine is linked incorrectly.
The translation routine does not reside in a library accessible by the Broker.

00220081	TRANS: Return Len > User Receive-length
Explanation	The return length of the translated string set by the translation routine is greater than the receive length specified in the API by the receiver. Check the translation routine used. The return length given from the translation routine to EntireX Broker must not be set to a value greater than the receive length of the receiver. Check the program and correct the error.
Action	Contact the person who is responsible for the translation routine.

00220085	TRANS: Return Length < 0
Explanation	The return length of the translated string set by the translation routine is less than zero. Check the translation routine used. The return length given from the translation routine to EntireX Broker must not be less than zero. Check the program and correct the error.
Action	Contact the person who is responsible for the translation routine.

00220223	Error from CONVERSION Routine
Explanation	This message is written to the application if the user translation routine has an error.
Action	This is a user error. Check the program and correct the error.

00220437	Some chars inconvertible to target CP
Explanation	Some characters in the sender's message do not exist in the receiver's encoding. Check locale information of the sender of the message.
Action	Contact Software AG Support and provide locale information of sender and receiver.

00220438	Chars to convert undefined in source CP
Explanation	Some of the characters to be converted are not defined in the source codepage. The data that the participant is sending and the conversion codepage do not correspond.
Action	Correct the data being sent.

00220531	Converter Obj may be missing in ICUDATA
Explanation	The converter name cannot be recognized.
Action	Ensure that the ICU data library (libicudataexx.so on UNIX, icudt32.dll on Windows or IXMI32DA on z/OS) is loadable or contact Software AG Support.

00220649	TRANS: User exit returns invalid lengths
Explanation	There is a probable error in external conversion exit. Lengths of payload data after conversion do not match with return code, returned by external exit.
Action	Ensure that `CONVERSION` (or `TRANSLATION`) parameter in attribute file (`DEFAULTS=SERVICE` section) is properly configured. Make sure that the external exit (user-written) is returning right values in the right fields of TRAP structure.

00220650	ATTR: Inval keyword in CONVERSION params
Explanation	There is a syntax error while specifying subparameters in `CONVERSION=(..)` in `DEFAULTS=SERVICE` section.
Action	Ensure that the various option keywords and their values in `CONVERSION` are properly spelled. Each `<keyword=value>` pair must be separated by a ',' delimiter. The last pair is followed by closing parenthesis ')'.