Event Handler Notifications (Admin Scriptability)

Domino and Notes 7 include new administration scriptability features for statistics and events. This feature provides the following new actions to take when an event occurs:

• Run an agent. - Runs a specified agent based on the configured Event Handler. Use this method to resolve an issue without user intervention.  -- An in-memory note is created -- This note can be accessed by the agent, and will not be saved to disk, but freed when the agent has finished processing.

Note  You must have the appropriate database access to run an agent from a database.

• Run a program (with new parameters).  -  this event handler has been rewritten to provide the option to pass event parameters using checkboxes. Optionally, you can specify switches for the parameters. You must have full remote console access in the Server document to issue LOAD commands. All parameters are passed as text except for the error code, which is passed as a number.

Note  If you have created Event Handler documents that use the Run Program notification option, using a Domino release issued prior to Domino 7, you need to re-edit and then save those Event Handler documents to allow them to be compatible with Domino 7.

• Send a console command to the server. - An administrator can configure the event handler method to send one or more console commands to the server. You can also use this option to run a console script.

The console command must be delineated by quotes when you enter it. For example
    'SHOW SERVER, SHOW TASK'

• Send a java controller command. - The commands that can be sent to the controller are restart Domino, start Domino, and shutdown Domino. The target server should run under the Java controller. To use the event handler of notification type "Send Java Controller command," you must create a Connection document between the server running the Java controller and the server sending the Java controller command.

Your username (short name)  and Internet password are used by the event task to access the Java controller.The server that is running the Java controller must have entries in these fields in order for the "Send Java Controller command" notification to work correctly:

• Optional network address
• Use the port(s)

To connect to the server controller on the second server, authentication must take place using an id that has administration privileges on the second server. There are two ways to do this. Administrators can either:
 
a. Connect to the second server using the administration client on the first server. The user must authenticate and be connected (or attached) with the second server when the event handler runs.
b. Use the Edit ID Server Controller Username/Password. On the Tools menu of the Configuration tab, open up Certification and click on Set Server Controller’s ID. Fill in the administrator’s short name and a password and Click OK.