PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Previous | Contents

PMDF_get_postmaster_address

Obtain the local postmaster's address.

VMS FORMAT

status = PMDF_get_postmaster_address

(address, address_len)

argument information
Argument Data type Access Mechanism
address descriptor read/write reference
address_len unsigned word write reference

C FORMAT

status = PMDFgetPostmasterAddress

(address, address_len)

argument information 
int PMDFgetPostmasterAddress (address, address_len) 
         char *address; 
         int  *address_len;

ARGUMENTS

address

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

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

PMDF_get_postmaster_address may 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.

Previous | Next | Contents