Message Class 0302 - Configuring and Controlling Service

The messages have the format:

0302nnnn

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

Messages of class 0302 are caused by the Administration Service or related components. The messages can appear in the log file of the Administration Service.

Messages of class 302 can result, for example, from the programs Defaultbroker, etbsrv, etbadm or in programs generated with Command and Information Services IDLs.

Overview of Messages

03020000 | 03020001 | 03020002 | 03020003 | 03020004 | 03020005 | 03020006 | 03020007 | 03020008 | 03020015 | 03020016 | 03020017 | 03020018 | 03020023 | 03020024 | 03020025 | 03020028 | 03020029 | 03020031 | 03020032 | 03020033 | 03020034 | 03020035 | 03020036 | 03020037 | 03020044 | 03020046 | 03020047 | 03020048 | 03020049 | 03020050 | 03020051 | 03020052 | 03020053 | 03020054 | 03020057 | 03020058 | 03020059 | 03020060 | 03020061 | 03020066 | 03020067 | 03020068 | 03020069 | 03020070 | 03020071 | 03020072 | 03020073 | 03020074

03020000 Admin Service successfully executed
Explanation

The Administration Service action has completed successfully.

Action

None.


03020001 Invalid arguments
Explanation

The Administration Service has detected invalid or missing arguments.

Action

Check and correct the arguments of the program call.


03020002 Rule name missing
Explanation

The name of an authorization rule was not specified.

Action

Check and correct the arguments of the program call.


03020003 Service or topic name missing
Explanation

The name of a service service or topic was not specified or is invalid.

Action

Check and correct the arguments of the program call.


03020004 Class name wrong or missing
Explanation

The name of a class was not specified or is invalid.

Action

Check and correct the arguments of the program call.


03020005 Server name wrong or missing
Explanation

The name of a server was not specified or is invalid.

Action

Check and correct the arguments of the program call.


03020006 Service name wrong or missing
Explanation

The name of a service was not specified or is invalid.

Action

Check and correct the arguments of the program call.


03020007 Topic name wrong or missing
Explanation

The name of a topic was not specified or is invalid.

Action

Check and correct the arguments of the program call.


03020008 User name wrong or missing
Explanation

The name of a user was not specified or is invalid.

Action

Check and correct the arguments of the program call.


03020015 Broker name wrong or missing
Explanation

The name of the broker was not specified or is invalid.

Action

Check and correct the arguments of the program call.


03020016 TCP port duplicate or wrong value
Explanation

The name of the TCP port is duplicate or is invalid.

Action

Check and correct the arguments of the program call.


03020017 SSL port duplicate or wrong value
Explanation

The name of the SSL port is duplicate or is invalid.

Action

Check and correct the arguments of the program call.


03020018 Transport wrong or missing
Explanation

The transport was not specified or is missing.

Action

Check and correct the arguments of the program call.


03020023 Could not create Broker
Explanation

The local broker or broker instance could not be created. The Administration Service tried to create a directory in the EntireX directory config/etb and to store the attribute file in this directory.

Action

Check the permission of config/etb or any directory created. Check the log files of the process to be started. The EntireX directory config/etb/ contains the working directory of all local brokers. For example, if an attempt was made to start broker ETB001, all log files for ETB001 are in directory ETB001. For more information see log files

  • EntireX/config/etb/ETBADM/ETBADM.LOG

  • EntireX/config/etb/ETBADM/ETBSRV.LOG


03020024 Could not create Service
Explanation

The service could not be created. The Administration Service tried to create a directory in the EntireX directory config/service and to store the attribute file and configuration file in this directory.

Action

Check the permission of config/service or any directory created. Check the log files of the process to be started. The EntireX directory config/etb/ contains the working directory of all local brokers. For example, if an attempt was made to start broker ETB001, all log files for ETB001 are in directory ETB001. For more information see log files

  • EntireX/config/etb/ETBADM/ETBADM.LOG

  • EntireX/config/etb/ETBADM/ETBSRV.LOG


03020025 Could not open attribute file ETBnnn.ATR
Explanation

The attribute file config/etb/etbnn.atr could not be opened.

Action

Check the permissions for file config/etb/ETBnnn.ATR.


03020028 Administration Service internal error
Explanation

The Administration Service has detected an internal error.

Action

Contact Software AG support.


03020029 Not yet implemented
Explanation

The function that was called has not yet been implemented.

Action

None.


03020031 Out of memory
Explanation

A storage request of the Administration Service failed.

Action

Check whether sufficient system resources are available.


03020032 Value buffer too small
Explanation

The Administration Service has detected an internal error.

Action

Contact Software AG support.


03020033 Key already exists
Explanation

The key already exists in the data file. An attempt was made to re-create a broker that already exists.

Action

None; the EntireX application issues a suitable message.


03020034 Duplicate value
Explanation

The Administration Service has detected an internal error.

Action

None; the problem was solved by internal programming.


03020035 Could not start process
Explanation

A process could not be started. The Administration Service tried to start up a process: For process type "Broker" in directory config/etb and for process type "Service" in directory config/service. These directories contain attribute file, configuration file and log file.

Action

Check the log files of the process to be started. The EntireX directory config/etb contains the working directory of all local brokers. The EntireX directory config/service contains the working directory of all local known services. For example, if an attempt was made to start broker ETB001, all log files for ETB001 are in directory ETB001. For more information see log files

  • EntireX/config/etb/ETBADM/ETBADM.LOG

  • EntireX/config/etb/ETBADM/ETBSRV.LOG


03020036 Could not start process as user
Explanation

A process could not be started as user. The Administration Service tried to startup a process: For process type "Broker" in directory config/etb and for process type "Service" in directory config/service. These directories contain attribute file, configuration file and log file.

Action

Check the log files of the process to be started. The EntireX directory config/etb contains the working directory of all local brokers. The EntireX directory config/service contains the working directory of all local known services. For example, if an attempt was made to start broker ETB001, all log files for ETB001 are in directory ETB001. For more information see log files

  • EntireX/config/etb/ETBADM/ETBADM.LOG

  • EntireX/config/etb/ETBADM/ETBSRV.LOG


03020037 Process is already started
Explanation

A process could not be started because it was already active.

Action

None.


03020044 Broker Service not running
Explanation

The Administrative Broker Service process is not started.

Action

Under UNIX, start the Broker Service daemon. Under Windows, start Broker Service from Window Service. Repeat the failed operation.


03020046 Invalid command
Explanation

Invalid RPC command.

Action

Internal error of an EntireX application, contact Software AG support.


03020047 Broker or Service already exists
Explanation

The Broker or Service already exists.

Action

Change the name of the broker or service in the called application.


03020048 Duplicate ports not allowed
Explanation

Duplicate port numbers are not allowed.

Action

Change the port number in the called application.


03020049 BROKER-ID wrong or missing
Explanation

No broker ID or an invalid ID was passed to the Administration Service.

Action

Reenter the Broker ID in the used application; do not use special characters.


03020050 CIS Information service request failed
Explanation

A broker CIS information request failed.

Action

If the target broker has started, check its log file. For detailed information, it may be necessary to increase the trace level.


03020051 CIS Command service request failed
Explanation

A broker CIS command request failed.

Action

If the target broker has started, check its log file. For detailed information, it may be necessary to increase the trace level.


03020052 Control block does not exist
Explanation

The broker or service control block for a specified broker or service does not exist. An invalid broker or service ID was used. This error can occur when two commands are processed in parallel, whereby one of the commands is a delete broker or delete service command.

Action

Check the log files of the process to be started. The EntireX directory config/etb contains the working directory of all local brokers. The EntireX directory config/service contains the working directory of all local known services. For example, if an attempt was made to start broker ETB001, all log files for ETB001 are in directory ETB001. For more information see log files

  • EntireX/config/etb/ETBADM/ETBADM.LOG

  • EntireX/config/etb/ETBADM/ETBSRV.LOG


03020053 Invalid credentials
Explanation

Invalid credentials were used to access the Administration Service or a specific broker. This message can be given after a change of password.

Action

Log on required in the used application.


03020054 Process is already stopped
Explanation

An attempt was made to stop a broker or service that has not started.

Action

None.


03020057 Copy text file failed
Explanation

A text file (e.g. attribute file or SSL certificates) could not be copied by the Administration Service.

Action

The Administration Service log in the EntireX directory config/etb/ETBADM contains details of the failed copy attempt.


03020058 SSL certificate or key file not found
Explanation

The SSL certificates could not be found in the EntireX directory config/etb/.

Action

Create your own SSL certificates and make available in the EntireX directory config/etb.


03020059 Could not write attribute file
Explanation

The attribute file could not be created by the Administration Service.

Action

The Administration Service log in the EntireX directory config/etb/ETBADM contains details of the failed write or copy attempt.


03020060 Forbidden character in file name
Explanation

The Administration Service checks the broker or service name for illegal characters. ID, directory and file names are generated automatically from the name. This error message is issued if the name contains invalid special characters.

Action

Correct the broker or service name in the used EntireX application.


03020061 Could not open file
Explanation

A file could not be opened.

Action

The Administration Service log in the EntireX directory config/etb/ETBADM contains details on the failed access attempt.


03020066 Could not read file
Explanation

The read access to a file failed.

Action

The Administration Service log in the EntireX directory config/etb/ETBADM contains details on the failed access attempt.


03020067 Could not write file
Explanation

The write access to a file failed.

Action

The Administration Service log in the EntireX directory config/etb/ETBADM contains details on the failed access attempt.


03020068 Invalid attribute file
Explanation

The contents of the attribute file are invalid. This error can occur when a broker attribute file is being migrated, or when a broker or service is to be added with command etbsrv BROKER|SERVICE CREATE <name> <attribute file name> using an existing attribute file.

Action

Correct the attribute file.


03020069 Could not write attribute file
Explanation

The write access to an attribute file failed.

Action

In the Administration Service log in the EntireX directory config/etb/ETBADM contains details on the failed access attempt.


03020070 Internal error
Explanation

General internal error of the Administration Service.

Action

Contact Software AG support.


03020071 Could not open attribute file
Explanation

The attribute file of a newly created broker could not be opened for writing.

Action

The Administration Service log in the EntireX directory config/etb/ETBADM contains details on the failed access attempt.


03020072 Could not open attribute file for ETBSRV
Explanation

The Administration Service could not open its own attribute file. The error can only occur during installation.

Action

The Administration Service log in the EntireX directory config/etb/ETBADM contains details on the failed access attempt.


03020073 Request timeout occurred
Explanation

A request to start, stop or restart a broker could not be performed within a defined period. This error can occur if a broker process is stopped immediately due to an error in the broker attribute file.

Action

Check the broker log file.


03020074 Access denied by Security Facility
Explanation

The Broker Administration Service security has returned an error. The user is not authorized to use the command-line utility of the Broker Administration Service.

Action

A security violation has occurred. This message and the related user ID are written to the Broker Administration Service log.