ICIBackupArchiveInfo Interface
Use the ICIBackupArchiveInfo interface members to retrieve or specify backup information. For details of backing up or restoring EFT Server, refer to "Backing Up or Restoring Server Configuration" in the EFT Server documentation.
interface ICIBackupArchiveInfo : IDispatch
Members
-
Property ARMAuthenticationType As ARMAuthenticationType
Retrieves or specifies audit database authentication type – SQL server authentication or Windows authentication.
HRESULT ARMAuthenticationType([out, retval] ARMAuthenticationType* pVal); HRESULT ARMAuthenticationType([in] ARMAuthenticationType newVal);
Example (VBScript):
Retrieving:
If WindowsAuthentication = oBackup.ARMAuthenticationType Then '… End If
Specifying:
oBackup.ARMAuthenticationType = SQLServerAuthentication
EFT v6.3 and later
Retrieves or specifies ARM database name.
HRESULT ARMDatabaseName([out, retval] BSTR *pVal); HRESULT ARMDatabaseName([in] BSTR newVal);
Example (VBScript):
Retrieving:
MsgBox "ARM database name is: " & oBackup.ARMDatabaseName
Specifying:
oBackup.ARMDatabaseName = "EFTDB"
EFT v6.3 and later
Property ARMDatabaseType As ARMDatabaseType
Retrieves or specifies audit database type.
HRESULT ARMDatabaseType([out, retval] ARMDatabaseType* pVal); HRESULT ARMDatabaseType([in] ARMDatabaseType newVal);
Example (VBScript):
Retrieving:
If Oracle = oBackup.ARMDatabaseType Then '… End If
Specifying:
oBackup.ARMDatabaseType = SQLServer
EFT v6.3 and later
Retrieves or specifies folder to save auditing data when the database has an error.
HRESULT ARMFailureAuditFolder([out, retval] BSTR* pVal); HRESULT ARMFailureAuditFolder([in] BSTR newVal)
Example (VBScript):
Retrieving:
Auditfolder = oBackup.ARMFailureAuditFolder
Specifying:
oBackup.ARMFailureAuditFolder = "C:\some_folder"
EFT v6.3 and later
Retrieves or specifies a failure notification list of emails. The property is a string with the following format:
email :== recipient_name<addr@server.domain> | addr@server.domain email_list :== email; email_list | e HRESULT ARMFailureEmailList([out, retval] BSTR* pVal); HRESULT ARMFailureEmailList([in] BSTR newVal);
Example (VBScript):
strEmailList = oBackup.ARMFailureEmailList If strEmailList <> "" Then strEmailList = strEmailList + "; " End If strEmailList = strEmailList + "NewRecipientName<SomeAddr@SomeMailServer.com>" oBackup.ARMFailureEmailList = strEmailList
EFT v6.3 and later
Enables or disables the ARM connection healing mechanism.
HRESULT ARMHealConnection([out, retval] VARIANT_BOOL *pVal); HRESULT ARMHealConnection([in] VARIANT_BOOL newVal);
Example (VBScript):
Retrieving:
If MyBackupArchiveInfo.ARMHealConnection Then ‘Healing connection mechanism is enabled … End If
Specifying:
MyBackupArchiveInfo.ARMHealConnection = False ‘Healing connection mechanism have disabled
EFT v7 and later
Enables or disables email notification about ARM database disconnect (recipients defined in ARMFailureEmailList).
HRESULT ARMNotifyOnDisconnect([out, retval] VARIANT_BOOL *pVal); HRESULT ARMNotifyOnDisconnect([in] VARIANT_BOOL newVal);
Example (VBScript):
Retrieving:
If MyBackupArchiveInfo.ARMNotifyOnDisconnect Then ‘Notify on ARM database disconnect is enabled … End If
Specifying:
MyBackupArchiveInfo.ARMNotifyOnDisconnect = False ‘Notify on ARM database disconnect have disabled
EFT v7and later
Enables or disables email notification about ARM database reconnect (recipients defined in ARMFailureEmailList).
HRESULT ARMNotifyOnReconnect([out, retval] VARIANT_BOOL *pVal); HRESULT ARMNotifyOnReconnect([in] VARIANT_BOOL newVal);
Example (VBScript):
Retrieving:
If MyBackupArchiveInfo.ARMNotifyOnReconnect Then ‘Notify on ARM database Reconnect is enabled … End If
Specifying:
MyBackupArchiveInfo.ARMNotifyOnReconnect = False ‘Notify on ARM database reconnect have disabled
EFT v7 and later
Retrieves or specifies ARM database password.
HRESULT ARMPassword([out, retval] BSTR *pVal); HRESULT ARMPassword([in] BSTR newVal);
Example (VBScript):
Retrieving:
MsgBox "ARM database password is: " & oBackup.ARMPassword
Specifying:
oBackup.ARMPassword = "swordfish"
EFT v6.3 and later
Retrieve or specify the reconnect period to ARM database. If a database error occurs and ARMHealConnection is enabled, then EFT tries to reconnect to the database every ARMReconnectPeriod seconds, from 7 seconds to 86,400 seconds (24 hours).
HRESULT ARMReconnectPeriod([out, retval] LONG *pVal); HRESULT ARMReconnectPeriod([in] LONG newVal);
Example (VBScript):
Retrieving:
MsgBox “Reconnect period: ” & CStr(MyBackupArchiveInfo.ARMReconnectPeriod)
Specifying:
MyBackupArchiveInfo.ARMReconnectPeriod = 60 ‘every one minute
EFT v7 and later
Retrieves or specifies database host address.
HRESULT ARMServerName([out, retval] BSTR *pVal); HRESULT ARMServerName([in] BSTR newVal);
Example (VBScript):
Retrieving:
MsgBox "ARM database host address is: " & oBackup.ARMServerName
Specifying:
oBackup.ARMServerName = "192.168.0.55"
EFT v6.3 and later
Retrieves or specifies server behavior in case of database error. If ARMStopAuditingOnError is true, then after database error, audit will stop. Otherwise, auditing will be continued in the folder specified by the ARMFailureAuditFolder property.
HRESULT ARMStopAuditingOnError([out, retval] VARIANT_BOOL* pVal); HRESULT ARMStopAuditingOnError([in] VARIANT_BOOL newVal);
Example (VBScript):
Retrieving:
If oBackup.ARMStopAuditingOnError Then '… End If
Specifying:
oBackup.ARMStopAuditingOnError = true
EFT v6.3 and later
Retrieves or specifies database user name.
HRESULT ARMUserName([out, retval] BSTR *pVal); HRESULT ARMUserName([in] BSTR newVal);
Example (VBScript):
Retrieving:
MsgBox "ARM database username is: " & oBackup.ARMUserName
Specifying:
oBackup.ARMUserName = "User_1"
EFT v6.3 and later
Retrieves path to the backup archive file.
HRESULT BackupArchivePath([out, retval] BSTR* pVal);
Example (VBScript):
MsgBox "File backup archive path: " & oBackup.BackupArchivePath
EFT v6.3 and later
Retrieves administrator account name that created the backup.
HRESULT CreatedBy([out, retval] BSTR* pVal);
Example (VBScript):
MsgBox "Backup created by: " & oBackup.CreatedBy
EFT v6.3 and later
Retrieves backup creation time.
HRESULT CreationTime([out, retval] DATE* pVal);
Example (VBScript):
MsgBox "Backup created: " & oBackup.CreationTime
EFT v6.3 and later
Retrieves or specifies enable/disable ARM.
HRESULT EnableARM([out, retval] VARIANT_BOOL *pVal); HRESULT EnableARM([in] VARIANT_BOOL newVal);
Example (VBScript):
Retrieving:
MsgBox "ARM is enabled: " & CStr(oBackup.EnableARM)
Specifying:
oBackup.EnableARM = True
EFT v6.3 and later
Retrieves ICISiteBackupInfo interface by index.
HRESULT GetSiteBackupInfo([in] LONG nIndex, [out, retval] IDispatch** pVal);
Example (VBScript):
Set oSiteBackupInfo = oBackup.GetSiteBackupInfo(0)
EFT v6.3 and later
Specifies Site backup information.
HRESULT SetSiteBackupInfo([in] IDispatch* newVal);
Example (VBScript):
oBackup.SetSiteBackupInfo oSiteBackupInfo
EFT v6.3 and later
Retrieves number of Sites in the backup archive.
HRESULT SitesCount([out, retval] LONG* pVal);
Example (VBScript):
MsgBox "Sites count: " & CStr(oBackup.SitesCount)
EFT v6.3 and later
Property type As String read-only
Retrieves string representation of backup type.
HRESULT Type([out, retval] BSTR* pVal);
Example (VBScript):
MsgBox "Backup type: " & oBackup.Type
EFT v6.3 and later