HP Reference Information Storage System v1.6 Administrator Guide (T3559-96073, July 2007)
CCollectingheldmessagesforHP
technical suppor t
The Get Held Messages Notes application recovers mail.box messages that are in the Hold state, so
theycanbeusedforRISSandRIMdiagnostics.
After the application recovers a held message from mail.box, it resubmits the message to the router
several times, giving it another chance to be delivered.
The numb er of retries can be configured. After the maximum number of retries, the message is saved in
Get H eld Messages and is not returned to mail.box.
Setting up the application
During the RISS system installation, you will work with the HP service representative to set up the
application. It is installed on the gateway ser ver, which transfers messages from a Domino domain to
the RISS sys
tem.
To set up Get Held Messages:
1. Copy the get_held_messages.nsf file to the default Domino data directory on the gateway
serv er.
2. O pen the S
etup Controls view in the file.
3. O pen each setup control and adjust it as necessary for the installation.
Each control contains an explanation of how to use it.
4. Using Dom
ino Designer:
a. Open the a gent named Get Held Messages.
b. Set the agent’s schedule so that it runs every few hours.
(In special circumstances, it can run as often as every 5 minutes.)
c. Makesuretheagentissettorunonthegatewayserver.
d. Enable
the agent.
5. Sign th
e application with a Notes ID that has the following privileges:
• Access to run restricted agents on the gateway server.
• Ability to read and delete documents in mail.box on the gateway server.
This c
an be done by adding the code signing ID to the group LocalDomainAdmins.
If the
re is more than one mail.box, each with a slightly different name, make sure all are readable.
6. Make t
he following configuration change on the gateway server:
a. Click the Configurations tab in the Domino Admin client.
b. Click Servers, and then click Configurations.
c. Select the g ateway server’s name from the list, and then click the Router/SMTP, Advanced,and
Cont
rols tabs.
d. Click the Edit Server Configuration button, change the Hold Undeliverable Mail field to Enabled ,
and save the configuration document.
Version 1.6 173