Defines the interface to the Tamino Non XML control. Transactionality is valid with Tamino Version 2.1 or higher. Please see also the section Command and Response Structure in the chapter X-Machine Programming, which is part of the documentation for the Tamino XML server.
Properties | |
BSTR |
csDatabaseURL The database URL. |
BSTR |
csUserName The username for authentication. |
BSTR |
csPassword The password for authentication. |
BSTR |
SessionID The current session ID if a transactional session is in progress. |
BSTR |
SessionKey The current session key if a transactional session is in progress. |
Note:
In C++ the properties are access using Get/Put method pairs, for example
GetProperty/PutProperty.
Methods |
long Initialize()
LPDISPATCH GetNonXml(BSTR lpszRelURL, BSTR lpszFile)
lpszRelURL
- NULL, or the relative URL added to the
database URL if it does not begin with "http://"lpszFile
- the document or fileIXMLDOMDocument: DOM tree corresponding to response [if NULL use
GetErrorStatus]
LPDISPATCH SetNonXmlWithFilename(BSTR lpszRelURL, BSTR lpszInputFile, BSTR lpszContentType)
lpszRelURL
- NULL, or the relative URL added to the
database URL if it does not begin with "http://"lpszFile
- the name of the document or file to be
readlpszContentType
- the value of the HTTP header
"Content-Type" (e.g., "application/msword")IXMLDOMDocument: DOM tree corresponding to response [if NULL use
GetErrorStatus]
long GetErrorStatus(VARIANT* ErrorText)
ErrorText
contains the error
text. In the case of success the parameter ErrorText
contains the Message-Text/Line from Tamino.VARIANT
by referenceLPDISPATCH StartSession(long IsolationTypes, long LockWaitTypes)
IsolationTypes
- This is one of the following:InoIsolationDefault = 1
(take the
default defined in Tamino),InoUnprotected = 2
,InoShared = 3
,InoProtected = 4
LockWaitTypes
- This is one of the following:InoLockWaitDefault = 1
(take the
default defined in Tamino),InoLockWaitYes = 2
,InoLockWaitNo = 3
IXMLDOMDocument: DOM tree corresponding to response [if NULL use
GetErrorStatus]
LPDISPATCH EndSession()
IXMLDOMDocument: DOM tree corresponding to response [if NULL use
GetErrorStatus]
LPDISPATCH Commit()
IXMLDOMDocument: DOM tree corresponding to response [if NULL use
GetErrorStatus]
LPDISPATCH Rollback()
IXMLDOMDocument
LPDISPATCH Echo()
IXMLDOMElement
LPDISPATCH Ping()
IXMLDOMElement
long SetIsolationLevel(long isolation)
isolation
- This is one of the following:InoIsolationDefault = 1
(take the default
defined in Tamino),InoUnprotected = 2
,InoShared = 3
,InoProtected = 4
,IsolationUncommittedDocument = 5
,IsolationCommittedCommand = 6
,IsolationStableCursor = 7
,IsolationStableDocument = 8
,IsolationSerializable = 9
long SetLockWait(long wait)
wait
- This is one of the following:InoLockWaitDefault = 1
(take the default
defined in Tamino),InoLockWaitYes = 2
,InoLockWaitNo = 3
long SetLockMode(long mode)
mode
- This is one of the following:LockModeDefault = 1
(take the default defined
in Tamino),LockModeUnprotected = 2
,LockModeShared = 3
,LockModeProtected = 4
long UseGlobalTransactions(long flag)
flag
- TRUE or FALSELPDISPATCH SetGlobalTransactionId(VARIANT id, GlobalTransactionTypes type)
id
- BSTR for TipTransaction, BYTE[64] for UtxTransactiontype - This is one of the following:
TipTransaction = 1
,UtxTransaction = 2
LPDISPATCH BeginSession(IsolationTypes isolation, LockWaitTypes wait, LockModeTypes mode)
isolation
- see SetIsolationLevel
for possible
valueswait
- see SetLockWait
for possible valuesmode
- see SetLockMode
for possible valuesIXMLDOMDocument: DOM tree corresponding to response [if NULL use
GetErrorStatus]
LPDISPATCH BeginSessionWithGlobalTransaction(IsolationTypes isolation, LockWaitTypes wait, LockModeTypes mode, VARIANT id, GlobalTransactionTypes type)
isolation
- see SetIsolationLevel
for possible
valueswait
- see SetLockWait
for possible valuesmode
- see SetLockMode
for possible valuesid
- see SetGlobalTransactionId
for possible
valuestype
- see SetGlobalTransactionId
for possible
valuesIXMLDOMDocument: DOM tree corresponding to response [if NULL use
GetErrorStatus]