Component Return Codes in EntireX

This section provides information on codes returned to the operating system by the EntireX Broker job or EntireX RPC Server at shutdown.


EntireX Broker Return Codes

01 Return Code
Explanation

During startup, the broker detected a create error when invoking the z/OS Name/Token Services facility. The Broker is immediately shut down.

Action

Ensure that the z/OS Name/Token services facility is available on the version of the z/OS operating system that is running. Also, examine the operating system log. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


02 Return Code
Explanation

During broker startup an error was detected attempting to open the data set referenced by the SYSPRINT DD statement. The attempted output from the echo of the broker startup parameters, the persistent store parameters, and the broker attribute file parameters to the data set referenced by the SYSPRINT DD statement failed.

Action

Examine the SYSPRINT DD statement, the EntireX Broker log data set and the operating system log. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


03 Return Code
Explanation

During broker startup, at least one error was detected in the persistent store component.

Action

Examine the output referenced by the SYSPRINT DD statement as well as the broker log data set and the operating system log. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


04 Return Code
Explanation

During broker startup, at least one error was detected in the broker startup parameters.

Action

Examine the output referenced by the SYSPRINT DD statement as well as the broker log data set and the operating system log. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


05 Return Code
Explanation

During broker startup, the broker persistent store parameters were not specified.

Action

The broker persistent store parameters need to be specified in the input data set referenced by the SYSIN DD statement.


06 Return Code
Explanation

During broker startup, an error was detected in the broker persistent store parameters.

Action

Examine the output referenced by the SYSPRINT DD statement as well as the broker log data set and the operating system log. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


07 Return Code
Explanation

During broker startup, the broker detected a create error when invoking the z/OS Name/Token Services facility in the persistent store component. The broker is immediately shut down.

Action

Ensure that the z/OS Name/Token services facility is available on the version of the z/OS operating system that is running. Also, examine the operating system log. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


08 Return Code
Explanation

During startup, the broker detected an initialization error. The broker is immediately shut down.

Action

Examine the broker log data set and the operating system log as well as the output referenced by the SYSPRINT DD statement. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


09 Return Code
Explanation

During startup, the broker detected a storage error in the persistent store component. The broker is immediately shut down.

Action

Examine the output referenced by the SYSPRINT DD statement as well as the broker log data set and the operating system log. Increase the region size for the EntireX Broker job. Correct any errors and restart the broker. If the cause cannot be determined, contact Software AG Support.


10 Return Code
Explanation

During shutdown, the broker detected a delete error when invoking the z/OS Name/Token Services facility. The broker is immediately shut down.

Action

Ensure that the z/OS Name/Token services facility is available on the version of the z/OS operating system that is running. Also, examine the operating system log. Correct the error and restart the broker. If the cause cannot be determined, contact Software AG Support.


11 Return Code
Explanation

During startup, the broker detected that the EXB library is not APF-authorized in z/OS.

Action

Ensure that the EXB load library referenced by the STEPLIB DD statement has been APF authorized in z/OS. Check the spelling of the data set names for accuracy. Correct any error and restart the broker. If the cause cannot be determined, contact Software AG Support.


EntireX RPC Server Return Codes

0 Return Code
Explanation

RPC server was successful.


1 Return Code
Explanation

Windows specific: one of the required shared libraries (.DLL) could not be found.


4
Explanation

Minor Trouble - RPC server continues.

  • At least 1 worker terminated unsuccessfully because of server (implemented by user and called by RPC server) malfunction.

  • Parameters inconsistent - being repaired.


8 Return Code
Explanation

RPC server stopped.

  • Not even 1 worker could be started.

  • Stopped because EntireX Broker unavailable.

  • Problems during shutdown processing.


12 Return Code
Explanation

Parameter Trouble - RPC server could not be started.

  • Inconsistent parameters specified or not found.

  • Usage error.


16 Return Code
Explanation

Serious Trouble.

  • Problems with underlying operating system.

  • Problems with EntireX RPC Runtime.