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 System Management Hub or in the log file of the Administration Service. The Broker Agents of System Management Hub can replace messages of class 0302 with their own messages or dialogs.

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 | 03020019 | 03020020 | 03020021 | 03020022 | 03020023 | 03020024 | 03020025 | 03020028 | 03020029 | 03020031 | 03020032 | 03020033 | 03020034 | 03020035 | 03020036 | 03020037 | 03020038 | 03020044 | 03020046 | 03020047 | 03020048 | 03020049 | 03020050 | 03020051 | 03020052 | 03020053 | 03020054 | 03020055 | 03020057 | 03020058 | 03020059 | 03020060 | 03020061 | 03020064 | 03020065 | 03020066 | 03020067 | 03020068 | 03020069 | 03020070 | 03020071 | 03020072 | 03020073 | 03020074 | 03020083 | 03020084 | 03020085 | 03020086 | 03020087 | 03020088 | 03020089 | 03020090 | 03020091 | 03020092 | 03020093 | 03020094 | 03020095 | 03020097 | 03020098 | 03020100 | 03020102 | 03020104 | 03020105 | 03020106

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.


03020019 Create key failed
Explanation

A new key could not be added to the Administration Service data file.

Action

Check the file config/xds.ini and any directory services that were used. If you are using LDAP, it is possible that the LDAP server is no longer accessible.


03020020 Create key failed
Explanation

A key could not be removed from the Administration Service data file.

Action

Check config/xds.ini and any directory services that were used. If you are using LDAP, it is possible that the LDAP server is no longer accessible..


03020021 Get value failed
Explanation

The value of a key could not be determined from the Administration Service data file.

Action

Check config/xds.ini and any directory services that were used. If you are using LDAP, it is possible that the LDAP server is no longer accessible..


03020022 Set value failed
Explanation

Write access to Administration Service data was not successful.

Action

Check config/xds.ini and any directory services that were used. If you are using LDAP, it is possible that the LDAP server is no longer accessible..


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/etbadm-svc.log

  • EntireX/config/etb/ETBSRV/etbsrv-svc.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/etbadm-svc.log

  • EntireX/config/etb/ETBSRV/etbsrv-svc.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 create a directory in the EntireX directory: 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 permission of target 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. 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/etbadm-svc.log

  • EntireX/config/etb/ETBSRV/etbsrv-svc.log


03020036 Could not start process as user
Explanation

A process could not be started as user. The Administration Service tried to create a directory in the EntireX directory: 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 permission of target 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. 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/etbadm-svc.log

  • EntireX/config/etb/ETBSRV/etbsrv-svc.log


03020037 Process is already started
Explanation

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

Action

None.


03020038 Could not find service in data file
Explanation

The broker or service was not found in the data file or LDAP.

Action

Check and correct the arguments of the program call.


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

None with the parallel processing scenario. Otherwise check the used broker or service ID in the called application. In the case of internal error of an EntireX application, Contact Software AG support.

Check the log files of the process to be used. 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/etbadm-svc.log

  • EntireX/config/etb/ETBSRV/etbsrv-svc.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.


03020055 Value control block does not exist
Explanation

The broker or service value control block for a specified broker or service does not exist. 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

None in the parallel processing scenario. Otherwise check the broker ID or service ID of the called application. In the case of internal error in an EntireX application, contact Software AG support.

Check the log files of the process to be used. 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/etbadm-svc.log

  • EntireX/config/etb/ETBSRV/etbsrv-svc.log


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/ETBSRV/ 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/ETBSRV/ 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/ETBSRV/ contains details on the failed access attempt.


03020064 Download error
Explanation

Reserved for future use.

Action

None.


03020065 Upload error
Explanation

Reserved for future use.

Action

None.


03020066 Could not read file
Explanation

The read access to a file failed.

Action

The Administration Service log in the EntireX directory config/etb/ETBSRV/ 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/ETBSRV/ 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/ETBSRV/ 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/ETBSRV/ 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/ETBSRV/ 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.


03020083 Data file: parameter error
Explanation

Internal Error.

Action

Contact Software AG support.


03020084 Data file: out of memory
Explanation

There is not enough memory available to read in the data file.

Action

Check whether sufficient system resources are available.


03020085 Data file: file I/O error
Explanation

A read/write operation on the data file failed.

Action

Determine the cause of the error and correct it. File config/xds.ini contains detailed information on the data file. Possible source of error:

  • no free memory on the data medium.

  • insufficient permission

  • data medium defective


03020086 Data file: internal error
Explanation

An internal error was detected.

Action

Contact Software AG support.


03020087 Data file: invalid parameter string
Explanation

Internal Error.

Action

Contact Software AG support.


03020088 Data file: invalid directory service
Explanation

A parameter dirservice= in file config/xds.ini contains an invalid value.

Action

Check all parameters dirservice=. Valid values are "FLATDIR" and "LDAPDIR".


03020089 Data file: LDAP initialization failed
Explanation

A connection to the LDAP server could not be established.

Action

Check the hostname and port number in file config/xds.ini.


03020090 Data file: LDAP server bind failed
Explanation

A connection to the LDAP server could not be established.

Action

Check the LDAP parameters, including password in file config/xds.ini.


03020091 Data file: duplicate key
Explanation

An attempt was made to add an existing key.

Action

None.


03020092 Data file: invalid key name
Explanation

An attempt was made to use an invalid key name.

Action

None.


03020093 Data file: generic LDAP error
Explanation

An error occurred when trying to access LDAP.

Action

Check the network connection to the LDAP server and the LDAP installation.


03020094 Data file: duplicate values
Explanation

Duplicate or multiple values were detected.

Action

None.


03020095 Data file: corrupt date file
Explanation

The data file is corrupt. The internal structure was damaged.

Action

Determine the data file using config/xds.ini and replace the data file with a backup. If no backup exists, delete the file and add authorization rules again. The data of the Administration Service will be automatically re-generated when the data file is deleted.


03020097 Data file: no data
Explanation

No data exists in the data file or LDAP.

Action

None.


03020098 Data file: no such key
Explanation

The key that was searched for does not exist in the data file or LDAP.

Action

None.


03020100 Data file: xds.ini file not found
Explanation

The file config/xds.ini was not found.

Action

Add a new file config/xds.ini.


03020102 Data file: invalid parameter
Explanation

Internal Error.

Action

Contact Software AG support.


03020104 Data file: insufficient memory
Explanation

Not enough memory available to read the data file.

Action

Check whether sufficient system resources are available.


03020105 Data file: internal error
Explanation

Internal Error.

Action

Contact Software AG support.


03020106 Data file: duplicate values
Explanation

Duplicate or multiple values were detected.

Action

None.