This message class is returned when invalid arguments are specified in the API (ACI) or invalid EntireX Broker function sequences are issued. It is usually an error made by the application programmer. The situation can be examined using the error number returned. The messages have the format:
0020nnnn
where | 0020 | is the message class, and |
nnnn | is the message number in the range 0000 - 9999 |
00200004 | 00200006 | 00200031 | 00200044 | 00200047 | 00200048 | 00200052 | 00200094 | 00200098 | 00200134 | 00200149 | 00200164 | 00200166 | 00200180 | 00200181 | 00200182 | 00200183 | 00200184 | 00200185 | 00200186 | 00200187 | 00200188 | 00200189 | 00200190 | 00200191 | 00200192 | 00200193 | 00200194 | 00200195 | 00200199 | 00200200 | 00200203 | 00200208 | 00200210 | 00200211 | 00200212 | 00200216 | 00200218 | 00200226 | 00200228 | 00200229 | 00200246 | 00200251 | 00200252 | 00200267 | 00200268 | 00200302 | 00200311 | 00200312 | 00200314 | 00200335 | 00200336 | 00200362 | 00200371 | 00200372 | 00200377 | 00200379 | 00200380 | 00200393 | 00200400 | 00200401 | 00200404 | 00200419 | 00200420 | 00200421 | 00200422 | 00200424 | 00200449 | 00200450 | 00200451 | 00200452 | 00200453 | 00200454 | 00200472 | 00200478 | 00200482 | 00200485 | 00200494 | 00200505 | 00200532 | 00200533 | 00200538 | 00200539 | 00200540 | 00200563 | 00200566 | 00200569 | 00200613 | 00200614 | 00200639 | 00200801 | 00200901 | 00200906 | 00209400 | 00209401 | 00209402 | 00209403 | 00209404 | 00209405 | 00209406 | 00209407 | 00209410 | 00209413 | 00209416 | 00209417 | 00209418 | 00209419 | 00209420 | 00209421 | 00209422 | 00209423 | 00209424 | 00209450 | 00209451 | 00209452 | 00209453 | 00209454 | 00209455 | 00209456 | 00209457
00200004 | API: No Function Possible After EOC |
Explanation |
The user has tried to access a conversation after finishing it with
a previous |
Action |
This is a user error. Perhaps an invalid conversation ID was specified. Check the program and correct the error. |
00200006 | API: Last Message Not Found |
Explanation |
This response is given to a |
Action |
This is a user error. Check the program and correct the error. |
00200031 | API: Invalid value for :1: |
Explanation |
This response is given when invalid values for the |
Action |
This is a user error. Check the value for the field in the API of your program. |
00200044 | API: Invalid error buffer ptr or length |
Explanation |
The user has set the |
Action |
This is a user error. The user should either provide an error buffer or
set the |
00200047 | API: QUIESCE invalid for Attach Manager |
Explanation |
Because a service registered with the option |
Action |
Do not use the |
00200048 | API: Already registered with ATTACH |
Explanation |
An application can register a service either with the option |
Action |
Do not try to register a single server as an attach manager and as a normal server simultaneously |
00200052 | API: Already registered without ATTACH |
Explanation |
An application can register a service either with the option |
Action |
Do not try to register a single server as a normal service and as an attach manager simultaneously. |
00200094 | API: MSG Truncated To Fit Receive-Buffer |
Explanation |
The data/message retrieved is larger than the supplied receive buffer.
The data/message has been truncated to the actual length given in
|
Action |
See Error Cases under Using Send and Receive Buffers for information on how to respond to this error code. |
00200098 | API: Function not possible if LOGON only |
Explanation |
The performed function is not valid if only a |
Action |
Do not perform the listed function right after a |
00200134 | LOGON required |
Explanation |
If |
Action |
Make |
00200149 | No Error Text |
Explanation |
The broker stub was unable to initialize the environment.
|
Action |
Depends on the operating system:
|
00200164 | API: USER-ID and TOKEN required |
Explanation |
|
Action |
Supply |
00200166 | Invalid OPTION/PUBLID combination |
Explanation |
The |
Action |
This is a user error. Check the program and correct the error. |
00200180 | API: Invalid TOPIC |
Explanation |
A request was issued and no topic name was specified. |
Action |
Specify a topic name. |
00200181 | API: Invalid User-ID |
Explanation |
The value for the |
Action |
This is a user error. Check the value for the |
00200182 | API: Invalid Function |
Explanation |
The value for the |
Action |
This is a user error. Check the value for the |
00200183 | API: Invalid CLASS/NAME/SERVICE |
Explanation |
The service is missing or invalid in a Broker call that requires a
service, that is, a |
Action |
This is a user error. Make sure that at least one of the following fields
has been provided: |
00200184 | API: Invalid SEND-LENGTH |
Explanation |
The value for the |
Action |
This is a user error. A |
00200185 | API: Invalid FUNCTION/CONVID Combination |
Explanation |
The value for the |
Action |
This is a user error. A |
00200186 | API: Char '.'or',' not allowed in ACI CB |
Explanation |
The character fields within the EntireX Broker ACI must not contain the metacharacter '.' or ','. These characters are used as special characters in the communication protocol between the Broker stub and the Broker. |
Action |
Correct the wrong character in the EntireX Broker ACI. |
00200187 | API: Invalid FUNCTION/OPTION Combination |
Explanation |
The |
Action |
This is a user error. Check the value for the |
00200188 | API: Invalid Option |
Explanation |
The |
Action |
This is a user error. Check the value for the |
00200189 | API: Invalid RECEIVE-LENGTH |
Explanation |
The value for the |
Action |
This is a user error. Check the program and correct the error. |
00200190 | API: Invalid Cmd/Info Services Version | ||||||||||||||||||
Explanation |
The EntireX Broker kernel does not recognize the Command and Information Services API version requested. |
||||||||||||||||||
Action |
This is a user error. Please check the following:
|
00200191 | API: Invalid OPTION/CONV-ID Combination |
Explanation |
The |
Action |
This is a user error. Check the program and correct the error. |
00200192 | API: Invalid parameter count |
Explanation |
More than four pointers have been supplied in the parameter list used to call the Broker stub. |
Action |
Correct the program. A maximum of four pointers can be supplied. |
00200193 | API: Invalid FUNCTION/WAIT Combination |
Explanation |
The |
Action |
This is a user error. Check the program and correct the error. |
00200194 | API: Invalid OPTION/WAIT Combination |
Explanation |
The |
Action |
This is a user error. Check the program and correct the error. |
00200195 | API: Deregister not allowed from clients |
Explanation |
This response is given when a client tries to issue a deregister call to EntireX Broker. |
Action |
Do not issue a |
00200199 | API: Receive/CID=ANY Invalid For Clients |
Explanation |
A client issued a |
Action |
This is a user error. Clients cannot issue a |
00200200 | API: RECEIVE/CID=NEW Invalid For Clients |
Explanation |
A client has issued a |
Action |
This is a user error. Clients cannot issue a |
00200203 | API: No RECEIVE -BUFFER Address |
Explanation |
The address of the receive buffer is missing for the Broker call. That
is, a |
Action |
This is a user error. Check the program and correct the error. |
00200208 | API: Invalid version number |
Explanation |
One of the following errors occurred:
Invalid |
Action |
This is a user error.
Check version of Broker stubs and Broker kernel.
Determine the stub version by using function |
00200210 | API: No Send Buffer Address |
Explanation |
A |
Action |
This is a user error. Check the program and correct the error. |
00200211 | API: No API Control Block Address |
Explanation |
The ACI control block is missing for the call. No address is given to the Broker stub as the first parameter. |
Action |
This is a user error. Check the program and correct the error. |
00200212 | API: (*) In SN/SC/SV Invalid For Function |
Explanation |
The |
Action |
This is a user error. Check the program and correct the error. |
00200216 | API: Invalid BROKER-ID |
Explanation |
The |
Action |
The |
00200218 | SEND/RECV-LEN %d exceeds max (%s) |
Explanation |
The maximum length possible for the send buffer/receive buffer depends on the Broker API version and the transport method (TCP/IP or Entire Net-Work) used, and on the configuration of the EntireX Broker.
|
Action |
Check the API version and the transport method (TCP/IP or Entire
Net-Work) used, and the possible maximum length of send buffer/receive buffer
for the transport method. See the field
Additional actions depend on the extended reason description:
|
00200226 | API Invalid STATUS |
Explanation |
The Broker has returned an invalid status. |
Action |
Contact Software AG support. |
00200228 | API Invalid CONV-STAT |
Explanation |
The Broker has returned an invalid conversation status. |
Action |
Contact Software AG support. |
00200229 | API Invalid value for STORE |
Explanation |
There are two possible error sources:
|
Action |
In situation 1, ensure that the application assigns only a valid value to the field. In situation 2, contact Software AG support. |
00200246 | API: Cannot subscribe durable/non-durable |
Explanation |
A |
Action |
Apply the correct option. |
00200251 | API: Invalid FUNCTION/PUBLID combination |
Explanation |
No publication ID was specified for this |
Action |
Specify the publication ID. |
00200252 | CID=NONE required for this service |
Explanation |
The application tried to start a conversation when issuing an EntireX
Broker command operation. The internal service should be used in
non-conversational mode only ( |
Action |
Change your code. |
00200267 | API: CID=NEW required for this service |
Explanation |
An INFO service request has been started with |
Action |
Always send |
00200268 | API: REGISTER internal service rejected |
Explanation |
The service that you specified is already registered as an internal service. All service definitions with the class SAG are reserved. |
Action |
Choose another service name |
00200302 | EOC error: must back out unit of work |
Explanation |
|
Action |
Do not issue an |
00200311 | API: Invalid Numeric Field |
Explanation |
The API field must be numeric. |
Action |
Correct the field value. |
00200312 | API: Out of Range |
Explanation |
The value of a field is incorrect. |
Action |
Correct the field value. |
00200314 | API: UOW status invalid |
Explanation |
Returned status of UOW is not valid. |
Action |
Check the |
00200335 | No Mixed Message with UOW on the Same CONVID |
Explanation |
You cannot have UOW and non-UOW messages in the same conversation, that is,
the same |
Action |
Check the application and correct the error. |
00200336 | No Mixed UOW with MSG on the Same CONVID |
Explanation |
You cannot have UOW and non-UOW messages in the same conversation, that is,
the same |
Action |
Check the application and correct the error. |
00200362 | API: Broker Stub De-Initialized |
Explanation |
The Broker stub was initialized but had to be de-initialized because none of the shared library pointers (TCP, XTI or ADALNK) was available. |
Action |
Check for any serious errors that may have caused library cleanup. |
00200371 | API: Cannot Specify arch w/o codepage |
Explanation |
You cannot specify a |
Action |
Check the application and correct the error. |
00200372 | API: Error converting locale to codepage |
Explanation |
The locale string sent by a client/server or publish-and-subscribe component could not be mapped to a codepage by the broker's built-in locale string mapping. See Broker's Built-in Locale String Mapping. |
Action |
Identify the locale string that could not be mapped to a codepage. The
value of the |
00200377 | API: Character Conversion Overflow |
Explanation |
The data/message retrieved after character conversion is larger than the
supplied receive buffer. Conversion can increase the amount of your data. No
data is provided in the receive buffer. The minimum buffer length required to
receive the converted data is returned in the |
Action |
For RPC components, the error can be ignored because the reread of the message is
handled inside the RPC layer.
Exception: for older Natural RPC versions it may be necessary to increase the For ACI programming, see Error Cases under Using Send and Receive Buffers for information on how to respond to this error code. |
00200379 | API: Inconsistent security installation |
Explanation |
The setting for security in the Broker kernel is different from the settings in one or more of the Broker stubs. Either the Broker kernel and all stubs must be configured to operate with security, or the kernel and all stubs must be configured to operate without security. For ACI version 8 and above, this error can be caused by an application
not setting the correct value of
|
Action |
Ensure the security settings are consistent for Broker kernel and all the stubs. |
00200380 | Some Characters Could not Be Converted |
Explanation |
When receiving a message, the Broker's
If this condition occurs, the application should consider the received data to be potentially incomplete or missing. |
Action |
Ensure that both sender and receiver are using the correct locale string and that all character values being sent have a corresponding character in the receiver's character set. |
00200393 | API: (*) in TOPIC invalid for FUNCTION |
Explanation |
Wildcard |
Action |
Use specific topic name. |
00200400 | Invalid SSL parameter specified |
Explanation |
The Broker ACI call |
Action |
Check the 2nd parameter of this broker call and the length specified in the Broker ACI control block. |
00200401 | Invalid value specified for EL |
Explanation |
Only values of 0, 1 or 2 are valid encryption levels. |
Action |
Correct the setting in the Broker ACI control block. Note: |
00200404 | CSLNK is not defined, NET disabled |
Explanation |
Entire Net-Work transport layer could not be initialized because the cslnk.so shared library could not be loaded. |
Action |
Set the environment variable |
00200419 | Mismatch of EL and current encryption |
Explanation |
An inconsistency has been detected. The actual security setting to
encrypt the payload buffer does not match the specification of the |
Action |
Verify the Note: |
00200420 | Mismatch of client encryption and ATTR |
Explanation |
The encryption settings of the EntireX client program do not match the settings in the Broker attribute file. |
Action |
Check the Note: |
00200421 | Mismatch of server encryption and ATTR |
Explanation |
For servers with API version below 6, a mismatch was found between the
current security settings and the |
Action |
Change the security settings:
Note: |
00200422 | Server EL and ATTR not identical |
Explanation |
For servers with API version 6 or above, the setting of |
Action |
Either
Note: |
00200424 | SETSSLPARMS only valid for transport=SSL |
Explanation |
ACI function |
Action |
Either change the |
00200449 | API: Invalid Compress option |
Explanation |
Compression is supported, but invalid option was specified. |
Action |
Correct the compress option. |
00200450 | Error during data compression |
Explanation |
Compression of the data was attempted, but resulting size was equal to or greater than original data. |
Action |
The compress option is turned |
00200451 | Error during data decompression |
Explanation |
During a decompress operation, failure occurred; it is most likely the result of insufficient memory for the process. |
Action |
Increase available memory for process, if possible. |
00200452 | Unexpected error during comp/decomp |
Explanation |
Error resulted from a compress or decompress operation, and is not accounted for by errors 0450 or 0451. |
Action |
Save trace information. Contact Software AG support. |
00200453 | Decompressed data corrupt |
Explanation |
When decompressing a compressed data stream, the integrity of the data was compromised. |
Action |
Save trace and data. Contact Software AG support. |
00200454 | API: Compression is not available |
Explanation |
Compression was requested but is not available |
Action |
Retry the operation without compression. |
00200472 | API: No PSTORE but durable subscriber |
Explanation |
A durable |
Action |
Option |
00200478 | EOC Error: Still Unread Unit of Work |
Explanation |
Participant issues the function EOC, but unprocessed UOWs exist for the conversation. The EOC request is rejected. |
Action |
Read the unprocessed UOWs first and issue function EOC afterwards. |
00200482 | API: CONV-ID NONE not supported |
Explanation |
Value |
Action |
Correct application. |
00200485 | API: User [UN]SUBSCRIBE not allowed |
Explanation |
|
Action |
No action is required. |
00200494 | Publish and Subscribe not enabled |
Explanation |
The publish and subscribe subsystem is not enabled due to missing definitions or license issues. Requested EntireX Broker function is rejected. |
Action |
Contact your Broker Administrator. |
00200505 | Illegal operation due to wrong UOW type |
Explanation |
The specified |
Action |
Please correct the |
00200532 | API: Error code missing in REPLY-ERROR |
Explanation |
Stub application did not provide a numeric value in the |
Action |
Send a valid numeric value in the |
00200533 | API: Invalid error code in REPLY-ERROR |
Explanation |
Stub application provided an invalid error code in the Broker control
block, while making |
Action |
Make sure that error code in the Broker control block does not start with '8' and contains only numerals. |
00200538 | API:Must specify locale to do CONVERSION |
Explanation |
Receiving application did not provide its codepage information in
|
Action |
Supply codepage information in the |
00200539 | API: Sender did not specify locale info |
Explanation |
Sender application did not provide codepage information in |
Action |
Supply codepage information in the |
00200540 | API: :1: value truncated |
Explanation |
The value for |
Action |
Upgrade to ACI version 9 or above. |
00200563 | DEREGISTER not completed due to UOWs |
Explanation |
There are still open units of work that have not been committed,
cancelled, or backed out yet. The ACI function |
Action |
Finish the open units of work first before calling |
00200566 | API: Invalid value for COMPRESSION TYPE |
Explanation |
The supplied value is invalid. Broker supports compression types GZIP and ZLIB. |
Action |
Correct the program to supply a valid value. |
00200569 | API: Extension data truncated to fit |
Explanation |
The amount of message extension data to be returned is greater than the
value specified under |
Action |
Set |
00200613 | API: Filter already active |
Explanation |
Command and Information Services were unable to add a command log filter as the specified filter was already active. |
Action |
Specify a filter that is not already active. |
00200614 | API: Filter not found |
Explanation |
Command and Information Services were unable to delete a command log filter as the specified filter did not exist. |
Action |
Specify a filter that does exist. |
00200639 | API: Protected UOWID has been specified |
Explanation |
An application has specified a protected unit of work ID in an API request. Protected unit of work IDs are 0000000000000000 and 0000000000000001. |
Action |
Specify a non-protected unit of work ID. |
00200801 | Unsecure shutdown broker not allowed |
Explanation |
The user is not authorized to shut down EntireX Broker. |
Action |
A security violation has occurred. This message and the related user ID are written to the Broker log. |
00200901 | User did not request SINGLE-CONV-MODE |
Explanation |
A mismatch was detected between settings of service and user regarding the mode chosen to send or receive ARF data. The single conversation mode (one conversation per service) has to be requested by the user before sending or receiving ARF data. It is not possible to change the mode if there are still conversations active that have been created with the old mode. |
Action |
ARF can be configured to use or not to use the ETBSCONV feature (single conversation mode). We strongly recommend using this feature, but it requires a service without any conversations created with the old mode. If the ETBSCONV feature was specified and conversations still exist, these conversations have to be consumed before you change to single conversation mode. |
00200906 | Value starts with an invalid character |
Explanation |
A blank has been deteced as the first character of |
Action |
Correct the value and retry. |
00209400 | FUNCTION NOT SUPPORTED |
Explanation |
An unsupported function ( |
Action |
Check the program and correct the error. |
00209401 | CONV-ID VALUE NOT SUPPORTED |
Explanation |
An unsupported value has been specified for the |
Action |
This is a user error. Check the program and correct the error. |
00209402 | WAIT VALUE NOT SUPPORTED |
Explanation |
An unsupported value has been specified for the |
Action |
This is a user error. Check the program and correct the error. |
00209403 | OPTION NOT SUPPORTED |
Explanation |
An unsupported value has been specified for the |
Action |
This is a user error. Check the program and correct the error. |
00209404 | xxxxxxxx - ADAPTER ERROR |
Explanation |
An error has occurred in the EntireX Broker Services protocol adapter. Depending on the protocol in use, it may be an SNA sense code or an MQM reason code. |
Action |
Obtain the error code from the first 8 bytes of the error message
(xxxxxxxx) or the |
00209405 | INVALID BROKER API REQUEST |
Explanation |
An unsupported value has been specified for |
Action |
This is a user error. Check the program and correct the error. |
Action |
No action is required. |
00209406 | CONV-ID REQUIRED FOR DEREGISTER |
Explanation |
No |
Action |
This is a user error. Check the program and correct the error. |
00209407 | INVALID REMOTE ATTACH FUNCTION |
Explanation |
|
Action |
Check the program and correct the error. |
00209410 | NO ATTACH REQUESTS AVAILABLE |
Explanation |
A Remote Attach Manager program has issued a non-blocked |
Action |
This is an informational message. |
00209413 | CONV-ID REQUIRED FOR RECEIVE |
Explanation |
An ACI |
Action |
Check the program and correct the error. |
00209416 | MODELQ REQUIRES SPECIFIC CONV-ID= |
Explanation |
An ACI |
Action |
Change the program to use a specific, existing |
00209417 | INVALID MSGTYPE=, WAIT= COMBINATION |
Explanation |
A |
Action |
Correct the program logic. |
00209418 | SERVER CANNOT ISSUE SEND CONVID=NONE |
Explanation |
A server program attempted to issue a |
Action |
Correct the program logic. |
00209419 | INVALID MESSAGE TYPE FOR SERVER SEND |
Explanation |
A server program attempted to issue a |
Action |
Correct the program logic. |
00209420 | INVALID MESSAGE TYPE FOR CLIENT SEND |
Explanation |
A client program attempted to issue a |
Action |
Correct the program logic. |
00209421 | OPT=SYNC INVALID WITH SEND WAIT= |
Explanation |
A request was issued with |
Action |
Correct the program logic. |
00209422 | SYNCPOINT REQUIRES OPTION=COMMIT/BACKOUT |
Explanation |
A |
Action |
Correct the program logic. |
00209423 | MSGID REQUIRED WITH CONVID=ANY/NEW/NONE |
Explanation |
A client program must use a specific |
Action |
Correct the program logic. |
00209424 | UNIT FIELD OF WORK NOT SUPPORTED |
Explanation |
An ACI request was received that has specified a value for one of the unit of work fields. |
Action |
Programmer: Ensure no unit of work fields have been specified in the ACI
request. If API Version=3 has been specified in the Broker control block
( |
00209450 | INTERNAL ERROR - GETMAIN FAILED |
Explanation |
An internal buffer shortage has occurred that prevents the function from executing. |
Action |
Review the JES |
00209451 | RECEIVE FAILED - tpname NOT REGISTERED |
Explanation |
A Remote Attach Manager has issued a |
Action |
Modify the Remote Attach Manager program to |
00209452 | REGISTER REJECTED - function ACTIVE |
Explanation |
A Remote Attach Manager has issued a |
Action |
A |
00209453 | UNKNOWN FUNCTION REQUESTED function |
Explanation |
A request was received using the |
Action |
Correct the Remote Attach Manager program and retry. The external trace may contain additional information for debugging. |
00209454 | ENTIREX BROKER SERVICES TERMINATED BY OPERATOR |
Explanation |
EntireX Broker Services have been shut down by the computer operator. |
Action |
No action required; normal processing continues. |
00209455 | function REJECTED, MISSING value |
Explanation |
A Remote Attach Manager has issued a verb that is invalid. |
Action |
The message text will contain the function and missing value. Correct the request and retry. |
00209456 | tpname NOT DEFINED VIA CONTROL OPERATOR |
Explanation |
A |
Action |
Add the |
00209457 | servername STOPPED BY OPERATOR COMMAND |
Explanation |
An Attach Manager |
Action |
The Remote Attach Manager Dispatcher program may be restarted after using
the |