Return Values
On successful operation, the routine returns the value of the channel argument. In the event of an error, the value returned is NULL and the mta_errno variable is set with an error status code. The following table
lists the error status codes and gives a description of each.
Error Status Codes
|
Description
|
MTA_BADARGS
|
There are two reasons to get this return value:
-
A NULL value was supplied for the address argument.
-
An invalid value was supplied for the address_type.
|
MTA_FOPEN
|
Unable to initialize the MTA SDK; can’t read one or more configuration
files. Issue the following command for further information:
imsimta test -rewrite
|
MTA_NO
|
There are two reasons to get this return value:
-
Unable to rewrite the supplied address. Either the address is syntactically
invalid, or it does not match any channel.
-
Unable to initialize the MTA_SDK. Issue the following command for
further information:
imsimta test -rewrite
|
MTA_NOSUCHITEM
|
An invalid item code was specified.
|
MTA_STRTRUERR
|
There are two reasons to get this return value:
-
Supplied address string is too long; length can not exceed ALFA_SIZE bytes.
-
The supplied buffer to receive the channel name is too small.
|