MAPI と SMTP のシステムプロシージャ

SQL Anywhere には、Microsoft Messaging API 標準 (MAPI) または Internet 標準のメール転送プロトコル (SMTP) を使用して電子メールを送信するためのシステムプロシージャが用意されています。これらのシステムプロシージャは拡張システムプロシージャとして実装されます。各プロシージャは外部 DLL の関数を呼び出します。

これらのプロシージャは dbo ロールに所有されます。ユーザがこれらのシステムプロシージャを使用するには、それらの EXECUTE 権限が必要です。

MAPI または SMTP システムプロシージャを使用するには、データベースサーバコンピュータから MAPI または SMTP E-mail システムにアクセスできるようにします。

MAPI システムプロシージャと SMTP システムプロシージャは、次のとおりです。

xp_startmail MAPI メッセージシステムにログオンして、指定したメールアカウントでメールセッションを開始する。
xp_startsmtp SMTP メッセージシステムにログオンして、指定したメールアカウントでメールセッションを開始する。
xp_sendmail 指定したユーザにメールメッセージを送信する。
xp_stopmail MAPI メールセッションを閉じる。
xp_stopsmtp SMTP メールセッションを閉じる。
xp_get_mail_error_code 最後の SMTP エラーまたは MAPI エラーに関する情報を返します。
xp_get_mail_error_text 最後の SMTP エラーのテキストを返します。

MAPI と SMTP 用のシステムプロシージャのリターンコード

MAPI システムプロシージャまたは SMTP システムプロシージャによって、次のコードが返される場合があります。

リターンコード	意味
-1	未知のエラー¹
0	成功
1	無効なパラメータが指定されました
2	メモリ不足です
3	xp_startmail または xp_startsmtp が呼び出されませんでした
4	ホスト名が不正です
5	接続エラー¹
6	セキュリティで保護された接続のエラー¹
7	MAPI 関数を使用できません¹

¹ リターンコードに関する追加情報を取得するには、xp_get_mail_error_code システムプロシージャを使用します。

例

次のプロシージャは、バックアップが完了したことをユーザグループに通知します。リターンコードはチェックしません。

CREATE PROCEDURE notify_backup( )
BEGIN
    CALL xp_startmail(  mail_user='ServerAccount',
                        mail_password='ServerPassword' );
    CALL xp_sendmail( recipient='IS Group',
                      subject='Backup',
                      "message"='Backup completed' );
    CALL xp_stopmail( );
END;

次のプロシージャは、バックアップが完了してエラーチェックが含まれていることをユーザグループに通知します。

CREATE OR REPLACE PROCEDURE notify_backup_with_error_check( )
BEGIN
    DECLARE result_code INTEGER;
    DECLARE error_code INTEGER;
    DECLARE error_text LONG VARCHAR;
    SET result_code = xp_startmail(  'ServerAccount', -- mail_user
                                     'ServerPassword' -- mail_password
                                  );
    IF result_code = 0 THEN
         SET result_code = xp_sendmail( 'IS Group', --recipient
                                        'Backup', -- subject
                                        NULL, -- cc_recipient
                                        NULL, -- bcc_recipient
                                        NULL, -- query
                                        'Backup completed' -- message
                                      );
    ENDIF;
    IF result_code = 0 THEN
        SET result_code = xp_stopmail( );
    ENDIF;
    IF result_code = 0 THEN
        MESSAGE 'Backup completed message successully sent';
    ELSE
        SET error_code = xp_get_mail_error_code();
        SET error_text = xp_get_mail_error_text();
        MESSAGE 'Error:' || result_code || 
                ' Code:' || error_code || 
                ' Text:' || error_text;
    ENDIF;
END;;

参照

DocCommentXchange で意見交換できます