Version 9.5 SP1
 —  Error Messages and Codes  —

Message Class 0021 - EntireX ACI - Configuration Error in the Attribute File

This message class is given in case of invalid or missing information in the Broker attribute file. This is mostly a configuration error. The situation can be examined using the error number returned and after correction, the applications can be restarted. The messages have the format:

0021nnnn

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

Overview of Messages

00210013 | 00210014 | 00210015 | 00210018 | 00210019 | 00210023 | 00210024 | 00210025 | 00210026 | 00210027 | 00210028 | 00210029 | 00210030 | 00210032 | 00210033 | 00210034 | 00210036 | 00210037 | 00210038 | 00210040 | 00210043 | 00210045 | 00210096 | 00210097 | 00210112 | 00210269 | 00210385 | 00210402 | 00210414 | 00210415 | 00210416 | 00210423 | 00210431 | 00210446 | 00210447 | 00210459 | 00210460 | 00210461 | 00210462 | 00210463 | 00210470 | 00210474 | 00210490 | 00210491 | 00210501 | 00210547 | 00210548 | 00210549 | 00210559 | 00210564 | 00210568 | 00210591 | 00210594 | 00210622 | 00210628 | 00210629 | 00210630 | 00210760 | 00210761 | 00210762 | 00210763 | 00210764

00210013 Value For Keyword Too Long
Explanation

The specified value for a correct keyword in a configuration file (for instance the Broker attribute file) has too many characters. This response arises in the following situations:

  1. During broker startup when the global resources defined in the section DEFAULTS=BROKER are read, a wrong value length is detected within this section. The Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, a wrong value length is detected within this service definition. The service cannot be registered.

Action

Correct the value assigned to the keyword in the configuration file.


00210014 Class def missing or invalid
Explanation

The definition of a server class is either missing or invalid.

Action

Either specify a class definition or use the correct values to specify one.


00210015 Max Possible NUM-CLIENT Reached
Explanation

This is a temporary resource shortage. The maximum number of EntireX Broker clients that can be active at one time is reached. A new client cannot be handled until client resources are available again by user timeouts.

Action

Increase NUM-CLIENT (or if CLIENT-NONACT has too high a value, decrease it) in the Broker attribute file.


00210018 Max Possible NUM-SERVER Reached
Explanation

This is a temporary resource shortage. The maximum number of EntireX Broker servers that can be active at one time is reached. New servers are not accepted until server resources are available again, either by deregistrations or user timeouts.

Action

Try to register the server to EntireX Broker later. If the error occurs freqently, increase NUM-SERVER (or if SERVER-NONACT has too high a value for some services, decrease it) in the Broker attribute file.


00210019 TRANSLATION Not Specified

00210023 Unknown Keyword
Explanation

A given keyword in a configuration file (for instance the Broker attribute file) is not known by the Broker. This response arises in the following situations:

  1. During broker startup, when the global resources defined in the section DEFAULTS=BROKER are read, a wrong keyword is detected within this section. The Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, a wrong keyword is detected within this service definition. The service cannot be registered.

Action

Correct or remove the keyword in the configuration file as appropriate.


00210024 CONV-LIMIT may not be UNLIM
Explanation

The service-specific CONV-LIMIT value is specified with UNLIM. In this special configuration, this is not allowed because the global NUM-CONVERSATION attribute is set to AUTO. See also Broker Resource Allocation.

Action

Either change the global NUM-CONVERSATION parameter to a defined value, or change the specific CONV-LIMIT value to a particular value.


00210025 CONV-DEFAULT not spec or UNLIM
Explanation

The global CONV_DEFAULT attribute is either specified as UNLIMIT or not specified at all. The error occurs in situations where EntireX Broker cannot calculate the number of conversations needed. This situation occurs if

  • NUM-CONVERSATION=AUTO and CONV-DEFAULT=UNLIM and there is at least one service that does not assign CONV-LIMIT, or

  • NUM-CONVERSATION=AUTO and CONV-DEFAULT is undefined and there is at least one service that does not assign CONV-LIMIT.

Action

Correct the error in the attribute file. Define NUM-CONVERSATION with a particular value or define CONV-DEFAULT with a particular value or use the CONV-LIMIT attribute for every single service definition.


00210026 Zero Value For Keyword Not Allowed
Explanation

The specified value for a correct keyword a configuration file (for instance the Broker attribute file) must not be zero or null value. This response arises in the following situations:

  1. During broker startup, when the global resources defined in the section DEFAULTS=BROKER are read, a value of zero or null is detected for a value within this section. The Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, a value of zero or null is detected within this service definition. The service cannot be registered.

Action

Correct the value assigned to the keyword in the configuration file.


00210027 Value For Keyword Out Of Range
Explanation

The specified value for a correct keyword in a configuration file (for instance the Broker attribute file) is out of range. This response arises in the following situations:

  1. During broker startup when the global resources defined in the section DEFAULTS=BROKER are read, the wrong value is detected for a value within this section. The Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, a wrong value is detected within this service definition. The service cannot be registered.

Action

Correct the value assigned to the keyword in the configuration file.


00210028 Invalid Value For Keyword
Explanation

The specified value for a correct keyword in a configuration file (for instance the Broker attribute file) is wrong. This response arises in the following situations:

  1. During broker startup, when the global resources defined in the section DEFAULTS=BROKER are read, a wrong value is detected for a value within this section. The Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, a wrong value is detected within this service definition. The service cannot be registered.

Action

Correct the value assigned to the keyword in the configuration file.


00210029 SHORT-BUFF-LIMIT may not be UNLIM
Explanation

The service-specific SHORT-BUFF-LIMIT value is specified with UNLIM. In this special configuration this is not allowed because the global NUM-SHORT-BUFFER attribute is set to AUTO. See also Broker Resource Allocation.

Action

Either change the global NUM-SHORT-BUFFER parameter to a defined value, or change the specific SHORT-BUFF-LIMIT value to a particular value.


00210030 SHORT-BUFF-DEF not spec or UNLIM
Explanation

The global SHORT-BUFF-DEF attribute is either specified as UNLIMIT or not specified at all. The error occurs in situation where EntireX Broker cannot calculate the number of short buffers needed. This situation occurs if:

  • NUM-SHORT-BUFFER=AUTO and NUM-SHORT-DEF=UNLIM and there is at least one service that does not assign SHORT-BUFF-LIMIT, or

  • NUM-SHORT-BUFFER=AUTO and NUM-SHORT-DEF is undefined and there is at least one service that does not assign SHORT-BUFF-LIMIT.

Action

Correct the error in the attribute file. Define NUM-SHORT-BUFFER with a particular value or define NUM-SHORT-DEF with a particular value or use the SHORT-BUFF-LIMIT attribute for every single service definition.


00210032 LONG-BUFF-LIMIT may not be UNLIM
Explanation

The service-specific LONG-BUFF-LIMIT value is specified with UNLIM. In this special configuration, this is not allowed because the global NUM-LONG-BUFFER attribute is set to AUTO.

Action

Either change the global NUM-LONG-BUFFER parameter to a defined value, or change the specific SHORT-LONG-LIMIT value to a particular value.


00210033 LONG-BUFF-DEF not spec or UNLIM
Explanation

The global LONG-BUFF-DEF attribute is either specified as UNLIM or not specified at all. The error occurs in situation where EntireX Broker cannot calculate the number of long buffers needed. This situation occurs if:

  • NUM-LONG-BUFFER=AUTO and NUM-LONG-DEF=UNLIM and there is at least one service that does not assign LONG-BUFF-LIMIT, or

  • NUM-LONG-BUFFER=AUTO and NUM-LONG-DEF is undefined and there is at least one service that does not assign LONG-BUFF-LIMIT

Action

Correct the error in the attribute file. Define NUM-LONG-BUFFER with a particular value or define NUM-LONG-DEF with a particular value or use the LONG-BUFF-LIMIT attribute for every single service definition.


00210034 SERVICE Section missing
Explanation

The DEFAULTS=SERVICE section in the attribute file could not be found.

Action

Correct the etbfile and provide a valid DEFAULTS=SERVICE section. See Service-specific Attributes under Broker Attributes.


00210036 Unknown service attribute
Explanation

An unknown attribute definition was found. Please refer to the entry in a configuration file (for instance the Broker attribute file) in order to find the line and the column where this error occurred.

Action

Correct the broker attribute file and provide valid attribute definitions. See Service-specific Attributes under Broker Attributes.


00210037 Value must be YES or NO
Explanation

The valid values for this attribute are YES or NO only. Please refer to the entry in the log file to find the line and the column where the error happened.

Action

Correct the etbfile and select either YES or NO for the attribute where the error happened


00210038 Error During Open Of File
Explanation

A configuration file (for instance the Broker attribute file) cannot be accessed. This response arises in the following situations:

  1. During broker startup, when the global resources defined in the section DEFAULTS=BROKER are read, the Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, this service cannot be used.

Action

Contact administrator or check for the following causes:

  1. No configuration file is allocated to the Broker.

  2. The specified configuration file does not exist.

  3. EntireX Broker has no access to the configuration file, for example for security reasons, or the configuration file is enqueued by another process.

  4. The configuration file has an invalid format for the platform used. Refer to the appropriate Installation documentation.


00210040 Error During Close Of File
Explanation

A configuration file (for instance the Broker attribute file) cannot be accessed. This response arises in the following situations:

  1. During broker startup, when the global resources defined in the section DEFAULTS=BROKER are read, the Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, this service cannot be used.

Action

Check all causes listed under error 0038, and then the following:
Ensure that no other process has changed the file characteristics of the configuration file.


00210043 Service Definition Not Found
Explanation

EntireX Broker did not find the service definition within the attribute file when a service attempted to register.

Action

Check the service specified in the CLASS, SERVER and SERVICE fields in the API, or make sure the service definition in the Broker attribute file is valid.


00210045 Keyword Value Must Be Numeric
Explanation

The specified value for a correct keyword in a configuration file (for instance the Broker attribute file) is wrong, that is, not alphanumeric. This response arises in the following situations:

  1. During broker startup, when the global resources defined in the section DEFAULTS=BROKER are read, a wrong value is detected for a value within this section. The Broker cannot be started.

  2. When a server tries to register with EntireX Broker and the service definition from the DEFAULTS=SERVICE section is read, a wrong value is detected within this service definition. The service cannot be registered.

Action

Correct the value assigned to the keyword in the configuration file.


00210096 Max Possible NUM-SERVICE Reached
Explanation

The maximum number of EntireX Broker services that can be active at one time is reached. A subsequent service register request is not accepted.

Action

Try again later. If this error occurs frequently, increase the NUM-SERVICE attribute in the section DEFAULTS=BROKER in the Broker attribute file.


00210097 Max possible NUM-TOPIC reached
Explanation

The maximum number of EntireX Broker topics that can be active at one time is reached.

Action

Try again later. If this error occurs frequently, increase the NUM-TOPIC attribute in the section DEFAULTS=BROKER in the Broker attribute file.


00210112 No SUBSCRIBER-STORE assigned
Explanation

A topic is defined as ALLOW-DURABLE=YES but there is no subscriber store defined to save the subscriber data on any store.

Action

Either change the topic attributes to ALLOW-DURABLE=NO, which makes it impossible to make a durable subscription, or set the value of global attribute SUBSCRIBER-STORE to PSTORE. A valid SUBSCRIBER-STORE requires additional attributes for the persistent store type etc.

Note:
The secondary persistent store (SSTORE) feature is no longer available. We recommend you use the PSTORE persistent store to store your subscriber data, by setting Broker-specific parameter SUBSCRIBER-STORE=PSTORE.


00210269 PSTORE required
Explanation

An EntireX Broker call involving PSTORE is requested but EntireX Broker runs with setting PSTORE=NO. Any PSTORE operation is prohibited.

Action

Contact your Broker Administrator.


00210385 Topic definition not found
Explanation

EntireX Broker did not find the topic definition within the attribute file when a topic attempted to subscribe.

Action

Check the topic specified in the TOPIC field in the API, or make sure the topic definition in the Broker attribute file is valid.


00210402 SECURITY/ENCRYPTION-LEVEL mismatch
Explanation

A mismatch in the Broker attribute file has been detected: If an ENCRYPTION-LEVEL is specified, then SECURITY must be set to YES.

Action

Verify that the security exit is present and set SECURITY=YES to enable ENCRYPTION-LEVEL processing.

Note:
The Broker attribute setting SECURITY=NO cannot be used with any encryption level not equal to 0 (= zero); otherwise the 00210402 error condition will occur when application issues registration command.


00210414 SUBSCRIBER-STORE needs PSTORE
Explanation

SUBSCRIBER-STORE=PSTORE is defined in Broker attribute file, but PSTORE is set to NO in order to disable the persistent store for this Broker run.

Action

Set PSTORE=COLD or PSTORE=HOT to run Broker with enabled PSTORE.


00210415 NUM-SUBSCRIBER-TOTAL too small
Explanation

NUM-SUBSCRIBER-TOTAL must be greater than or equal to NUM-SUBSCRIBER. This parameter is required if SUBSCRIBER-STORE=PSTORE is defined.

Action

Set NUM-SUBSCRIBER-TOTAL to AUTO or use a value greater than or equal to NUM-SUBSCRIBER.


00210416 NUM-TOPIC-TOTAL too small
Explanation

NUM-TOPIC-TOTAL must be greater than or equal to NUM-TOPIC. This parameter is required if SUBSCRIBER-STORE=PSTORE is defined.

Action

Set NUM-TOPIC-TOTAL to AUTO or use a value greater than or equal to NUM-TOPIC.


00210423 AUTO/Catch-All Service mismatch
Explanation

A mismatch in the broker attribute file has been detected: if the catch-all service has been defined (CLASS= *, SERVER= *, SERVICE = *) then the value of AUTO is not allowed for the NUM-CONVERSATION, NUM-LONG-BUFFER or NUM-SHORT-BUFFER attributes.

Action

If the catch-all service is defined, make sure the attributes NUM-CONVERSATION, NUM-LONG-BUFFER and NUM-SHORT-BUFFER all have specified values.


00210431 Error during read of file
Explanation

A configuration file (for instance the Broker attribute file) cannot be read.

Action

Make sure that the configuration file is readable and not corrupt.


00210446 ATTR: SERVER-LIMIT may not be UNLIM
Explanation

The service-specific SERVER-LIMIT value is specified with UNLIM. In this special configuration, this is not allowed because the global NUM-SERVER attribute is set to AUTO. See also Broker Resource Allocation.

Action

Either change the global NUM-SERVER parameter to a defined value, or change the specific SERVER-LIMIT value to a particular value.


00210447 ATTR: SERVER-DEFAULT not spec or UNLIM
Explanation

The global SERVER-DEFAULT attribute is either specified as UNLIM or not specified at all. The error occurs in situations where EntireX Broker cannot calculate the number of servers needed. This situation occurs if

  • NUM-SERVER=AUTO and SERVER-DEFAULT=UNLIM and there is at least one service that does not assign SERVER-LIMIT, or

  • NUM-SERVER=AUTO and SERVER-DEFAULT is undefined and there is at least one service that does not assign SERVER-LIMIT.

Action

Correct the error in the attribute file. Define NUM-SERVER with a particular value or define SERVER-DEFAULT with a particular value or use the SERVER-LIMIT attribute for every single service definition.


00210459 PUBLICATION-DEFAULT not spec/UNLIM
Explanation

The global PUBLICATION-DEFAULT attribute is either specified as UNLIM or not specified at all. The error occurs in situations where EntireX Broker cannot calculate the number of publications needed. This situation occurs if

  • NUM-PUBLICATION=AUTO and PUBLICATION-DEFAULT=UNLIM and there is at least one topic that does not assign PUBLICATION-LIMIT, or

  • NUM-PUBLICATION=AUTO and PUBLICATION-DEFAULT is undefined and there is at least one topic that does not assign PUBLICATION-LIMIT.

Action

Correct the error in the attribute file. Define NUM-PUBLICATION with a particular value or define PUBLICATION-DEFAULT with a particular value or use the PUBLICATION-LIMIT attribute for every single topic definition.


00210460 PUBLICATION-LIMIT may not be UNLIM
Explanation

The topic-specific PUBLICATION-LIMIT value is specified with UNLIM. In this special configuration, this is not allowed because the global NUM-PUBLICATION attribute is set to AUTO. See also Broker Resource Allocation.

Action

Either change the global NUM-PUBLICATION parameter to a defined value, or change the specific PUBLICATION-LIMIT value to a particular value.


00210461 SUBSCRIBER-DEFAULT not spec/UNLIM
Explanation

The global SUBSCRIBER-DEFAULT attribute is either specified as UNLIM or not specified at all. The error occurs in situations where EntireX Broker cannot calculate the number of subscribers needed. This situation occurs if

  • NUM-SUBSCRIBER=AUTO and SUBSCRIBER-DEFAULT=UNLIM and there is at least one topic that does not assign SUBSCRIBER-LIMIT, or

  • NUM-SUBSCRIBER=AUTO and SUBSCRIBER-DEFAULT is undefined and there is at least one topic that does not assign SUBSCRIBER-LIMIT.

Action

Correct the error in the attribute file. Define NUM-SUBSCRIBER with a particular value or define SUBSCRIBER-DEFAULT with a particular value or use the SUBSCRIBER-LIMIT attribute for every single topic definition.


00210462 SUBSCRIBER-LIMIT may not be UNLIM
Explanation

The topic-specific SUBSCRIBER-LIMIT value is specified with UNLIM. In this special configuration, this is not allowed because the global NUM-SUBSCRIBER attribute is set to AUTO. See also Broker Resource Allocation.

Action

Either change the global NUM-SUBSCRIBER parameter to a defined value, or change the specific SUBSCRIBER-LIMIT value to a particular value.


00210463 TOPIC Section missing
Explanation

The DEFAULTS=TOPIC section in the attribute file could not be found.

Action

Correct the etbfile and provide a valid DEFAULTS=TOPIC section. See Topic-specific Attributes under Broker Attributes.


00210470 AUTO/Catch-All Topic mismatch
Explanation

A mismatch in the broker attribute file has been detected: if a catch-all topic has been defined (example: TOPIC= *), then the value of AUTO is not allowed for the NUM-PUBLICATION, NUM-LONG-BUFFER, NUM-SHORT-BUFFER, or NUM-SUBSCRIBER attributes.

Action

If a catch-all topic is defined, make sure the attributes NUM-PUBLICATION, NUM-LONG-BUFFER, NUM-SHORT-BUFFER, and NUM-SUBSCRIBER all have specified values.


00210474 Durable SUBSCRIBE not allowed
Explanation

TOPIC attribute specifies ALLOW-DURABLE=NO, but application has requested to subscribe durably.

Action

Ensure broker attribute file is consistent with the intention of the application.


00210490 Max possible NUM-PUBLISHER reached
Explanation

This is a temporary resource shortage. The maximum number of EntireX Broker publishers that can be active at one time is reached. A new publisher cannot be handled until publisher resources are available again by user timeouts.

Action

Increase NUM-PUBLISHER (or if PUBLISHER-NONACT has too high a value, decrease it) in the Broker attribute file.


00210491 Max possible NUM-SUBSCRIBER reached
Explanation

This is a temporary resource shortage. The maximum number of EntireX Broker subscribers that can be active at one time is reached. A new subscriber cannot be handled until subscriber resources are available again by user timeouts.

Action

Increase NUM-SUBSCRIBER (or if SUBSCRIBER-NONACT has too high a value, decrease it) in the Broker attribute file.


00210501 TCP-PORT numbers not unique
Explanation

You cannot specify the same PORT number twice for the same HOST.

Action

Specify a different PORT number.


00210547 Max num AUTHORIZATIONRULE reached
Explanation

The maximum number of AUTHORIZATIONRULE entries in the attribute file has been reached. The current maximum number is 16 authorization rules.

Action

Reduce the number of AUTHORIZATIONRULE entries.


00210548 Max num HOST entries reached
Explanation

You cannot specify more than five HOST entries per section.

Action

Reduce number of HOST entries.


00210549 Max num PORT entries reached
Explanation

You cannot specify more than five PORT entries per section.

Action

Reduce number of PORT entries.


00210559 ATTR: TRANSPORT = NET and NUM-CCOM = 0
Explanation

The minimum value NUM-CCOM=1 is required if you want to run the Entire Net-Work communicator on UNIX.

Action

Set NUM-CCOM=1, or higher.


00210564 SSL-PORT numbers not unique
Explanation

You cannot specify the same PORT number twice for the same HOST.

Action

Specify a different PORT number.


00210568 Max num STACK-NAME entries reached
Explanation

You cannot specify more than five STACK-NAME entries per section.

Action

Reduce number of STACK-NAME entries.


00210591 DEFAULTS section missing
Explanation

The broker attribute file is missing a DEFAULTS section. Additional error information will display the section name.

Action

Consult the additional error text and take appropriate action.


00210594 ATTR: Variable not expanded
Explanation

A variable in a configuration file (for instance the Broker attribute file) could not be exanded. Additional error information will display the variable name.

Action

Consult the additional error text and take appropriate action.


00210622 Transport type not supported
Explanation

Transport types SSL or TCP are supported for Broker attribute PARTNER-CLUSTER-ADDRESS.

Action

Adjust the PARTNER-CLUSTER-ADDRESS to use a supported transport type.


00210628 Expect PSTORE=HOT in STANDBY mode
Explanation

The Standby Broker instance must use PSTORE=HOT in order to perform a PSTORE takeover if necessary.

Action

Define PSTORE=HOT for your Standby Broker.


00210629 Expect PSTORE=COLD in LOAD mode
Explanation

The Load Broker (RUN-MODE=PSTORE-LOAD) must use PSTORE=COLD in order to create a new persistent store.

Action

Define PSTORE=COLD for your Load Broker.


00210630 Expect PSTORE=HOT in UNLOAD mode
Explanation

The Unload Broker must use PSTORE=HOT in order to migrate a persistent store.

Action

Define PSTORE=HOT for your Unload Broker.


00210760 PARTNER-CLUSTER-ADDRESS mismatch
Explanation

The PARTNER-CLUSTER-ADDRESS defined in the Standard Broker does not match any of the TCP or SSL transport entries defined in the Standby Broker.

Action

Either adjust PARTNER-CLUSTER-ADDRESS in Standard Broker or start Standby Broker with a matching transport entry.


00210761 PARTNER-CLUSTER-ADDRESS missing
Explanation

There is no PARTNER-CLUSTER-ADDRESS definition in the Standard Broker.

Action

Define PARTNER-CLUSTER-ADDRESS in the Standard Broker to allow running a Standby Broker.


00210762 PSTORE-TYPE mismatch
Explanation

The persistent store defined in Standard Broker and Standby Broker must be exactly the same.

Action

Adjust the attributes for PSTORE-TYPE and the PSTORE specific sections in each Broker attribute file so both Broker instances match.


00210763 PSTORE-TYPE missing
Explanation

There is no PSTORE defined in the partner Broker instance.

Action

Run the partner Broker with matching persistent store attributes.


00210764 Same PSTORE for UNLOAD and LOAD
Explanation

The persistent stores defined in Load Broker and Unload Broker must be different.

Action

Adjust the attributes for PSTORE-TYPE and the PSTORE specific sections for both Broker instances. Make sure the Load Broker is assigned to a new persistent store, and your Unload Broker is assigned to the persistent store you wish to unload.


Top of page