Adds a contact to the contact list which can
be either defined locally on the system or in a global list. Contacts
are users to whom processes such as the Scheduler and Health Monitor
send messages.
The setting of the Database Administration Server (DAS) contact_host configuration
parameter determines whether the list is local or global.
Required connection
None.
Local execution only: this command cannot be used with a remote connection.
Command syntax
>>-ADD CONTACT--name--TYPE-------------------------------------->
>--+-EMAIL----------------------------------------+------------->
'-PAGE--+------------------------------------+-'
'-+-MAXIMUM PAGE LENGTH-+--pg-length-'
'-MAX LEN-------------'
>--ADDRESS--recipients address--+----------------------------------+-><
'-DESCRIPTION--contact description-'
Command parameters
- ADD CONTACT name
- The name of the contact that will be added. By default the contact
will be added in the local system, unless the DB2® administration server configuration parameter contact_host points
to another system.
- TYPE
- Method of contact, which must be one of the following two:
- EMAIL
- This contact wishes to be notified by e-mail at (ADDRESS).
- PAGE
- This contact wishes to be notified by a page sent to ADDRESS.
- MAXIMUM PAGE LENGTH pg-length
- If the paging service has a message-length restriction, it is
specified here in characters.
The notification system uses the SMTP protocol to send
the notification to the mail server specified by the DB2 Administration Server configuration parameter smtp_server.
It is the responsibility of the SMTP server to send the e-mail or
call the pager.
- ADDRESS recipients-address
- The SMTP mailbox address of the recipient. For example, joe@somewhere.org.
The smtp_server DAS configuration parameter
must be set to the name of the SMTP server.
- DESCRIPTION contact description
- A textual description of the contact. This has a maximum length
of 128 characters.