Obtain the local postmaster's address.

PASCAL

status = PMDF_get_postmaster_address

(address, address_len)

C

status = PMDFgetPostmasterAddress

(address, address_len)

int PMDFgetPostmasterAddress(char *address, int *address_len)

Arguments

address

String to receive the local postmaster's address. Length must be at least ALFA_SIZE+1 bytes.

address_len

Length in bytes of the postmaster's address. Callers using PMDFgetpostmasteraddress must, on input, supply the maximum length in bytes of address.

Description

PMDFgetPostmasterAddress can be used to obtain the mail address for the local postmaster. Note, however, that it usually is not a good idea for programs to send mail to the postmaster. In many situations, sending mail to the postmaster when failures occur can lead to mail loops; e.g., the mail sent to the postmaster itself fails and generates a message to the postmaster which then fails and generates yet another message to the postmaster, ad infinitum.

Return Values

PMDF__OK	Normal, successful completion.
PMDF__FATERRLIB	Call to LIB$SCOPY_R_DX failed owing to a fatal internal error in the OpenVMS Run Time Library. No address returned.
PMDF__INSVIRMEM	Insufficient virtual memory: call to LIB$GET_VM made by LIB$SCOPY_R_DX has failed. No address returned.
PMDF__INVSTRDES	Invalid string descriptor for address: descriptor has an invalid value in its DSC$B_CLASS field. No address returned.
PMDF__STRTRU	Supplied string was too long; value truncated to fit.