OpenNotesLog (NotesLog - LotusScript®)
Opens a specified Domino® database for logging.
Defined in
Syntax
Call notesLog .OpenNotesLog( server$ , dbfile$ )
Parameters
server$
String. The server on which the database log resides. Use an empty string ("") to indicate the current computer. If the script runs on the workstation, the empty string indicates a local database. If the script runs on a server, it indicates a database on that server.
dbfile$
String. The path and file name of the database. If you specify "" for a server name, you must specify the full path to the log database, including the drive letter.
Usage
One document is created in the database for each error or action that you log. Each document has a Form item set to "Log Entry" and contains the following items:
Item |
Contents |
|
---|---|---|
A$PROGNAME |
The ProgramName property |
|
A$LOGTIME |
The date and time that the error or action was logged |
|
A$USER |
The user of the script at the time the error or action was logged |
|
A$LOGTYPE |
Indicates either "Error" or "Action" |
|
A$ACTION |
A description of the action (actions only) |
|
A$ERRCODE |
The error code (errors only) |
|
A$ERRMSG |
A description of the error (errors only) |
The StdR4AgentLog template
The StdR4AgentLog template (ALOG4.NTF) is designed to display the action and error documents that a NotesLog creates. If the dbfile$ you specify inherits its design from this template, you can use the database's main view to see each of the items listed previously. Several agents can log to the same server$ and dbfile$. The database categorizes each action and error according to the A$PROGNAME item.
Opening a database
A script that attempts to open a database to which it does not have access returns an error. A script needs at least Reader access to a database in order to open it.
Logging actions and errors
For information on how actions and errors get logged to a database log, see the LogAction and LogError methods.