Engine Help Category: NotesSystem
Filtered overview of the Engine Help documentation.
@Accessed
Returns the time of the last access to the document with the NOTEHANDLE NOTEHANDLE1 back.
@ACLGetEffectiveUserAccess
This @Function determines the effective access of a user to the specified database based on a previously read ACL and a name list. Both the access explicitly assigned to the user and the user's direct and indirect group …
@CheckHandle
Checks whether VIEWHANDLE/NOTEHANDLE/DBHANDLE/FILEHANDLE... VIEWHANDLE1/NOTEHANDLE1/DBHANDLE1/FILEHANDLE1... is an open handle. If yes, TRUE returned, otherwise FALSE. FILEHANDLE can only be checked as of version 1.93.
@CloseAgent
Closes the agent (filter) with the AGENTHANDLE AGENTHANDLE1 and returns the closed AGENTHANDLE back.
@CompileFormula
Compiles TEXT1 a Notes formula text into the Notes formula compilation (CNFORMULA) and returns it. TEXT2 is required for column formulas and must contain the column item name. Example @CompileFormula(TEXT1): CNF:=@Compil …
@Created
Returns the time/date value (TD) of the creation of the document with the NOTEHANDLE NOTEHANDLE1.
@CreateDB
Creates a new completely empty database of DBCLASS DBCLASS2 under the NOTESPATH NOTESPATH1 and returns a DBHANDLE to it. With FN OVERWRITE3 can be used to specify whether an existing database with the same name should be …
@DecompileFormula
Decompiles the binary Notes formula (CNFORMULA) CNFORMULA1 into the Notes formula text. FN2 specifies whether this is a view selection formula (=1) or not (=0). With the syntax using one parameter, it is assumed that thi …
@DeleteEnvironment
Deletes the environment variable TEXT TEXT1 physically from NOTES.INI. Returnvalue: 1 = variable could are deleted. 0 = variable not present. @Errro... = An error occurred; the variable was not deleted.
@DestroyNameList
This @Function releases a previously created VSPECHNAMELIST (HNL) and sets the handle contained in it to NULL. It should be called as soon as the name list is no longer required. VSPECHNAMELIST HNAMELIST: A VSPECHNAMELIS …
@Environment
Returns the value of the environment variable TEXT/TEXTLIST TEXT1/TEXTLIST1.
@ExecuteAgent
This @Function executes the agent with the AGENTHANDLE AGENTHANDLE1 either against all documents (without the parameter NOTEHANDLE NOTEHANDLE3) of the DB in which the agent is located, or against a single document, with …
@GetACL
Retrieves the ACL of the database with the OSPATH OSPATH1 or DBHANDLE DBHANDLE1 and returns it split into TEXTLIST USERNAMES, NUMBERLIST USERLEVELS, TEXTLIST USERPRIVILEGES and TEXTLIST PRIVILEGESNAMES. TESTLIST USERNAME …
@GetACLHistory
The ACL change history of the DB with the DBHANDLE DBHANDLE1 as TEXTLIST is returned. Example @GetACLHistory(DBHANDLE1): DBHANDLE1:=@OpenDB("TEST.NSF"); @LogReport(@GetACLHistory(DBHANDLE1)); DBHANDLE1:=@CloseDB(DBHANDLE …
@GetACLMaxINetAccess
Returns the maximum Internet access of the DB with the DBHANDLE DBHANDLE1. LEVEL: 6=Manager 5=Developer 4=Editor 3=Author 2=Depositor 1=Reader 0=No Access Return: FN -> Success @Error -> Error @ERROR ACL NOT …
@GetDBActivity
Retrieves the user-activity log of the database with DBHANDLE1. The @Function result is 1 if there is no error, or @ERROR. The last four arguments of the @Function are return parameters: In RETTDLIST2 the times are retur …
@GetDBCurrentAccess
For the DB with the DBHANDLE DBHANDLE1 the current access level at the time of the call and, optionally, the currently effective flags (NUMBER NRETFLAGS) are returned. In case of an error, @Error is returned. USERLEVELS: …
@GetDBLaunchOptions
Returns the launch DB options of the DB with the DBHANDLE DBHANDLE1 as a bit vector (FN). In TEXTLIST TEXTLIST1 the names of the navigators or the view are returned. In RID RID1 the RID of the DB to which the doclink poi …
@GetDBModified
Returns when the database with the DBHANDLE DBHANDLE1 was last modified. The return value (TD) contains the last modification of a data document and TD TD1 contains the last modification of a non-data document.
@GetDBOptions
Returns the DB options of the DB with the DBHANDLE DBHANDLE1 as a bit vector (FN). In FN FNEXTOPTIONS the extended options of the DB are returned. FNEXTOPTIONS: BIT DEC HEX MEANING if set 01 000001 00001 Allo …
@GetDBQuota
Returns the DB quota of the DB with the DBHANDLE DBHANDLE1 as FLOATLIST with 4 elements. Element No. Meaning 1 Maxium size in kB of the database 2 Actual size in kB of the database 3 Quota in kB of the database 4 …
@GetDBReplicaHistory
Retrieves the replication history of the database with the DBHANDLE DBHANDLE1. A TEXTLIST with the names of the servers/users is returned directly. In RETTD1 a TDLIST with the respective last replication date, correspond …
@GetDBReplicaInfo
Retrieves the replication information: replica ID TD REPLICAID2, replication flags NUMBER FLAGS3, replication deletion interval NUMBER CUTOFFINTERVAL4 and replication deletion time TD CUTOFFTD5 of the database with the D …
@GetDocPrivileges
Returns a FLOATLIST of the document with the NOTEHANDLE NOTEHANDLE1 associated privileges. If the document has no privileges, the list has 0 elements.
@GetDominoUsers
This @Function retrieves the specified fields TEXT/TEXTLIST FIELDLIST for all users registered in the Domino Directory of the specified Domino server TEXT SERVER. The returned field values are provided as a TEXTLIST or H …
@GetFieldComponents
Returns the components of a VSPECDNFIELD DNFIELD1 variable, that is, a field in a form. The parameters PARAMETER2, PARAMETER3, PARAMETER4 and PARAMETER5 are reserved, TEXTLIST KEYWORDS6 contains the keyword list if prese …
@GetNoteClass
Returns the NOTECLASS (see NOTECLASSES) of the document with the NOTEHANDLE NOTEHANDLE1. FN NOTECLASS: DEC BIT meaning 00000 XX No Notes no documents 00001 01 Documents data documents 00002 02 Policy- …
@GetNoteDB
Gets the DBHANDLE DBHANDLE1 from the document with the NOTEHANDLE NOTEHANDLE1. Returned is of the DBHANDLE1 of the document or ein ERROR.
@GetNoteID
Returns the NoteID (ID) of the document with the NOTEHANDLE NOTEHANDLE1. NOTE: Only documents that were opened from a database have a NoteID.
@GetNoteOID
Returns the OID of the document with the NOTEHANDLE NOTEHANDLE1.
@GetNotesErrorString
Returns for einem Notes-Error-Status-Code (FN1) the corresponding error message text.
@GetNoteUID
Returns the UID of the document with the NOTEHANDLE NOTEHANDLE1.
@GetOIDComponents
Returns the components of the OID OID in TD RETTDDBID, TD RETTDNOTE, TD RETTDINSTANCETD and FLOAT RETFLOATINSTANCENUMBER. TD RETTDDBID is the database ID of the database in which the document was created. TD RETTDNOTE is …
@GetOSPath
Returns the physical/local path (OSPATH) for the relative NOTESPATH/NOTESPATHLIST NOTESPATH1/NOTESPATHLIST1. Directory and database links are taken into account. If a NOTESPATHLIST is passed as the input parameter, error …
@GetRemoteDBPathByRID
On the server with the server name TEXT TEXTSERVERNAME the first DB with the replica ID RID DBRID is searched for and the Notes path (TEXT) to it is returned. The found DB can be opened with this Notes path. If no matchi …
@Modified
Returns the time of the last modification of the document with the NOTEHANDLE NOTEHANDLE1.
@NewOID
Returns a OID for a new document in a database with the DBHANDLE DBHANDLE1.
@OpenAgent
Opens in the database with the DBHANDLE DBHANDLE1 the agent/filter named TEXT TITLE2. This @Function is available only as of Notes version 4.5. Return value: If the @Function is executed successfully, an AGENTHANDLE is r …
@OpenDesignNote
Opens the first document in the database with the DBHANDLE DBHANDLE1, that matches the NOTECLASSES NOTECLASSES3 matches and has the TEXT TITLE2 and has the specified title, and returns the NOTEHANDLE NOTEHANDLE4 returned …
@PushAndReplace
This @Function provides a special one-way replicator with additional replace logic. It was created for a customer-specific project requirement and is not intended as a replacement for classic Domino replication. It is in …
@PushWithFormula
Replicates the database with the DBHANDLE FROMDBHANDLE1 with the database with the DBHANDLE TODBHANDLE2 in the direction from FROMDBHANDLE1 to TODBHANDLE2, replicating only the documents that match the Notes-compatible s …
@ReadACL
This @Function creates an in-memory copy of the ACL of the database specified by DBHANDLE DBHANDLE and returns a VSPECHACL (HACL) handle to this copy. When the VSPECHACL handle is no longer required, it must be released …
@ReleaseACL
This @Function releases a previously created VSPECHACL (HACL) and sets the handle contained in it to NULL. It should be called as soon as the in-memory copy of the ACL is no longer required. VSPECHACL HACL: A VSPECHACL h …
@ReorgACLPrivileges
The empty elements of TEXTLIST PRIVNAMES2 are removed and returned in the parameter RETUSERPRIVS3 is returned. The corresponding privilege references in TEXTLIST USERPRIVS1 are adjusted and returned in the parameter RETP …
@Replicate
Replicates the database with DBHANDLE DBHANDLE1 with the database with DBHANDLE DBHANDLE2. FNLIST FNLIST3 is a list of rights where the first element specifies the replication rights in the first database and the second …
@ReplicateWithFieldException
Deprecated! See @ReplicateWithFieldProtection Note : This text was machine-translated and may contain inaccuracies.
@ReplicateWithFieldProtection
Replicates the database referenced by DBHANDLE1 with the database referenced by DBHANDLE2. FNLIST3 contains the replication rights. The first element specifies the rights for replication in the first database, and the se …
@ReplicateWithFormula
Replicates the database referenced by DBHANDLE1 with the database referenced by DBHANDLE2. Only documents that match the Notes-compatible selection formula TEXT/TEXTLIST FORMULA3 are replicated. FORMULA3 can be passed as …
@ReplicateWithFormulaWithFieldException
Deprecated! See @ReplicateWithFormulaWithFieldProtection Note : This text was machine-translated and may contain inaccuracies.
@ReplicateWithFormulaWithFieldProtection
Replicates the database referenced by DBHANDLE1 with the database referenced by DBHANDLE2. Only documents that match the Notes-compatible selection formula TEXT FORMULA3 are replicated. FNLIST4 contains the replication r …