Documentation ARexxAPI ADDRLOAD

ADDRLOAD

NAME:: AddrLoad -- Load an address book from disk. (V2.0)

TEMPLATE:: FILENAME/A,OPEN/S

FUNCTION:: Loads the specified address book from disk, replacing the current address book in RAM.

INPUTS:: FILENAME/A - address book to be loaded\ OPEN/S - immediately open the address book window after the address book file has been loaded successfully (V2.8p1)\

RETURNS:: RC is set to 10 if the filename cannot be opened.

 As of V2.4, this condition also triggers an error requester.

NOTES:: Loading a new address book from disk does not count as a change in the address book itself, which means you won't be warned if you try to quit YAM after loading that file, and thus will lose the new information if you forget to save it.

 As of V2.4, YAM pays attention to the contents of the supplied file.
 If the file is not recognised as a valid address book, a requester
 will open to let the user select whether he wants it to be loaded
 as a list of email addresses where items can be specified as

 `<email@example.com> Real name`

 or

 `email@example.com`

 because names are optional.  YAM will automatically create aliases
 for the new items, and the command will not return until the
 requester is satisfied.

EXAMPLE:: {{{#!arexx /* Load an address book from disk */ ADDRLOAD 'mail:addresslist' }}}

BUGS::

SEE ALSO::