HP StorageWorks Reference Information Storage System V1.5 Administrator Guide (T3559-96044, June 2006)

C Collec tin g held messages for HP
technical su pport
The Get Held Messages Notes application recovers mail.box m essages that are in the Hold state, so
they can be used for RISS and RIM diagnostics.
After the application recovers a held message from mail.box, it resubmits the message to the router
severa l times, giving it another chance to be delivered.
The number of retries can be configured. After the maximum number of retries, the message is saved in
Get Held 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 server, 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
server.
2. Open the S
etup Controls view in the file.
3. Open 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 D esigner:
a. Open the agent named Get Held Messages.
b. Settheagent’sschedulesothatitrunseveryfewhours.
(In special circumstances, it can run as often as every 5 minutes.)
c. Make sure the agent is set to run on the gateway server.
d. Enable
the ag ent.
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 the following configuration change on the gateway server:
a. Click
the Configurations tab in the Domino Admin client.
b. Clic
k Servers,andthenclickConfigurations.
c. Select the gateway server’s name from the list, and then click the Router/SMTP, Advanced,and
Controls tabs.
d. Clic
ktheEdit Server Configuration button, change the Hold Undeliverable Mail field to Enabled,
and
save the configuration document.
Reference Information Storage System Version 1.5
171