Logo
UNICENS V2.1.0-3491
User Manual and API Reference

Transmission result of an application message.

Enumerator:
UCS_AMSTX_RES_SUCCESS 

The transmission succeeded.

UCS_AMSTX_RES_ERR_RETRIES_EXP 

The transmission including all retries have failed.

The following issues may have caused the failure:

  • message corruption
  • transmission timeouts
  • full receive buffers of the destination device
  • full receive buffers of the local device if the destination was the own address, own group or broadcast address
UCS_AMSTX_RES_ERR_INVALID_TGT 

The transmission failed because the specified destination address is not found or not valid.

The following issues may have caused the failure:

  • device with the given destination address is not found
  • destination address is reserved (for future use)
  • destination address is 0xFFFF (un-initialized logical node address is not supported)
UCS_AMSTX_RES_ERR_NOT_AVAILABLE 

The transmission failed since the network or the INIC is not available.

UCS_AMSTX_RES_ERR_BUF_INTERNAL 

The transmission failed because the allocation of an Rx message object failed. The Rx message object is required to receive the message via the own Rx message queue.

This is possible in the following cases:

  • A message is transmitted to the own node address and the allocation of an Rx message object failed.
  • The network transmission to the own group address or broadcast address succeeded but the allocation of an Rx message object failed. The application has to decide whether to retransmit the message to the own address again.
UCS_AMSTX_RES_ERR_UNEXPECTED 

The transmission failed due to an unexpected error. The cause of this failure may be an invalid INIC configuration, or an INIC to UNICENS incompatibility issue.