DB Replica IDを書き換える? -4-
<話題の履歴>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
DB Replica IDを書き換える? -3-
前回は、C-APIで取得できるFormatのReplicaID相当の日時の生成を試してみました。
今回は、これまで試したことを使って実際にReplicaIDの書き換えを行ってみます。
話しが少し逸れますが、DB Propertyで確認できるReplicaIDはとても簡単に生成できるのです。
以前、このBlogで紹介しましたが、@Text( @Now ; "*")という非公開関数を使うと簡単に生成できます。
これと同じことを行うのが前回紹介したC-API Functionなのです。
では、早速実際にReplicaIDを書き換えるCodeを書いてみます。
Codeは極めて単純で、以下のように書きました。
少し分かりやすくするために、C-APIのTypeDefをそのまま、LotusScriptのType定義にしています。
Option Public
%Include "lsconst.lss"
%Include "lserr.lss"
Option Declare
'Definition C-API TIMEDATE
Type TIMEDATE
Innards(1) As Long
End Type
'Definition C-API DBREPLICAINFO
Type DBREPLICAINFO
ReplicaID As TIMEDATE
CutoffInterval As Integer
CutoffDate As TIMEDATE
Flags As Integer
End Type
Declare Sub W32_OSCurrentTIMEDATE Lib "nnotes.dll" _
Alias "OSCurrentTIMEDATE" (retTimeDate As TIMEDATE )
Declare Function W32_NSFDBOpen Lib "nnotes.dll" Alias "NSFDbOpen" _
(ByVal dbname As String, dbHandle As Long ) As Integer
Declare Function W32_NSFDBClose Lib "nnotes.dll" Alias "NSFDbClose" _
(ByVal dbHandle As Long ) As Integer
Declare Function W32_NSFDBReplicaInfoSet Lib "NNOTES.DLL" Alias "NSFDbReplicaInfoSet" _
(ByVal dbHandle As Long, retReplicaInfo As DBREPLICAINFO) As Integer
Declare Function W32_NSFDBReplicaInfoGet Lib "NNOTES.DLL" Alias "NSFDbReplicaInfoGet" _
(ByVal dbHandle As Long, setReplicaInfo As DBREPLICAINFO) As Integer
Const TargetDB = "TestRepIDChange.nsf"
Sub Initialize
Dim OS_TimeDate As TIMEDATE
Dim dbhandle As Long
Dim ReplInfo As DBREPLICAINFO
Dim rc As Integer
'Generate new ReplicaID using current OS time
Call W32_OSCurrentTIMEDATE(OS_TimeDate)
'Change ReplicaID
rc = W32_NSFDBOpen(TargetDB, dbhandle&)
rc = W32_NSFDBReplicaInfoGet(dbhandle&, ReplInfo)
ReplInfo.ReplicaID.Innards(0) = OS_TimeDate.Innards(0)
ReplInfo.ReplicaID.Innards(1) = OS_TimeDate.Innards(1)
rc = W32_NSFDBReplicaInfoSet(dbhandle&, ReplInfo)
rc = W32_NSFDBClose(dbhandle&)
End Sub
さて、実際に実行して試してみます。
まずは、TargetDB("TestRepIDChange.nsf")をNotes Localに作成します。
作成したら、DB PropertyでReplicaIDを確認します。

次に、作成したAgentを実行してから、再度ReplicaIDを確認すると、以下のようになります。

どうでしょう?現在のOSの時間を使ったReplicaIDで書き換わっていることが確認できます。
とても簡単なCodeでReplicaIDの書き換えが行えることがお分かり頂けたと思います。
このようにすると、MailのLocal ReplicaもOS Copyした後に、このToolでReplicaIDを変更すれば、別のDBとして動作するようになり、Replicatorに混乱を与えることはなくなるのです。
ただ、本来DBのReplicaIDというのはDBの作成時間から生成されるものですので、今回の変更ではReplicaIDを変更しただけで、作成日とずれてしまっています。
今回は、ReplicaIDの書き換えを行ってみました。
次回は、気になっていることをもう少しだけ調べてみたいと思います。
<続く>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
DB Replica IDを書き換える? -3-
前回は、C-APIで取得できるFormatのReplicaID相当の日時の生成を試してみました。
今回は、これまで試したことを使って実際にReplicaIDの書き換えを行ってみます。
話しが少し逸れますが、DB Propertyで確認できるReplicaIDはとても簡単に生成できるのです。
以前、このBlogで紹介しましたが、@Text( @Now ; "*")という非公開関数を使うと簡単に生成できます。
これと同じことを行うのが前回紹介したC-API Functionなのです。
では、早速実際にReplicaIDを書き換えるCodeを書いてみます。
Codeは極めて単純で、以下のように書きました。
少し分かりやすくするために、C-APIのTypeDefをそのまま、LotusScriptのType定義にしています。
Option Public
%Include "lsconst.lss"
%Include "lserr.lss"
Option Declare
'Definition C-API TIMEDATE
Type TIMEDATE
Innards(1) As Long
End Type
'Definition C-API DBREPLICAINFO
Type DBREPLICAINFO
ReplicaID As TIMEDATE
CutoffInterval As Integer
CutoffDate As TIMEDATE
Flags As Integer
End Type
Declare Sub W32_OSCurrentTIMEDATE Lib "nnotes.dll" _
Alias "OSCurrentTIMEDATE" (retTimeDate As TIMEDATE )
Declare Function W32_NSFDBOpen Lib "nnotes.dll" Alias "NSFDbOpen" _
(ByVal dbname As String, dbHandle As Long ) As Integer
Declare Function W32_NSFDBClose Lib "nnotes.dll" Alias "NSFDbClose" _
(ByVal dbHandle As Long ) As Integer
Declare Function W32_NSFDBReplicaInfoSet Lib "NNOTES.DLL" Alias "NSFDbReplicaInfoSet" _
(ByVal dbHandle As Long, retReplicaInfo As DBREPLICAINFO) As Integer
Declare Function W32_NSFDBReplicaInfoGet Lib "NNOTES.DLL" Alias "NSFDbReplicaInfoGet" _
(ByVal dbHandle As Long, setReplicaInfo As DBREPLICAINFO) As Integer
Const TargetDB = "TestRepIDChange.nsf"
Sub Initialize
Dim OS_TimeDate As TIMEDATE
Dim dbhandle As Long
Dim ReplInfo As DBREPLICAINFO
Dim rc As Integer
'Generate new ReplicaID using current OS time
Call W32_OSCurrentTIMEDATE(OS_TimeDate)
'Change ReplicaID
rc = W32_NSFDBOpen(TargetDB, dbhandle&)
rc = W32_NSFDBReplicaInfoGet(dbhandle&, ReplInfo)
ReplInfo.ReplicaID.Innards(0) = OS_TimeDate.Innards(0)
ReplInfo.ReplicaID.Innards(1) = OS_TimeDate.Innards(1)
rc = W32_NSFDBReplicaInfoSet(dbhandle&, ReplInfo)
rc = W32_NSFDBClose(dbhandle&)
End Sub
さて、実際に実行して試してみます。
まずは、TargetDB("TestRepIDChange.nsf")をNotes Localに作成します。
作成したら、DB PropertyでReplicaIDを確認します。

次に、作成したAgentを実行してから、再度ReplicaIDを確認すると、以下のようになります。

どうでしょう?現在のOSの時間を使ったReplicaIDで書き換わっていることが確認できます。
とても簡単なCodeでReplicaIDの書き換えが行えることがお分かり頂けたと思います。
このようにすると、MailのLocal ReplicaもOS Copyした後に、このToolでReplicaIDを変更すれば、別のDBとして動作するようになり、Replicatorに混乱を与えることはなくなるのです。
ただ、本来DBのReplicaIDというのはDBの作成時間から生成されるものですので、今回の変更ではReplicaIDを変更しただけで、作成日とずれてしまっています。
今回は、ReplicaIDの書き換えを行ってみました。
次回は、気になっていることをもう少しだけ調べてみたいと思います。
<続く>
Domino 9.0.1 FP5 IF1環境にはLanguage Pack 9.0.1適用不可
Domino 9.0.1 FP5の環境に、Interim Fix 1を適用した環境にLanguage Packを適用しようとすると、Version CheckでErrorして適用することが出来ないようです。
新たに環境を作る際は、英語版のDomino 9.0.1 FP5を適用した後に、Language Packを導入してから、IF1を適用した方が良いようです。
通常のFix適用の場合には問題は発生しませんが、新規にDomino Serverを立てる際には導入順序にご注意ください。
新たに環境を作る際は、英語版のDomino 9.0.1 FP5を適用した後に、Language Packを導入してから、IF1を適用した方が良いようです。
通常のFix適用の場合には問題は発生しませんが、新規にDomino Serverを立てる際には導入順序にご注意ください。
DB Replica IDを書き換える? -3-
<話題の履歴>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
前回は、C-API FunctionによってReplicaInfoがどのような形で返されるかを見てみました。
今回は、もう少し詳しく調べていきます。
前回確認した戻り値は以下のようになっていました。

この1番目と2番目がReplicaIDを示す値であることは前回も述べましたが、皆さんが良く見るReplicaIDとは全く異なる物のように見えます。
実際、私の環境のnames.nsfのReplicaIDは以下のようになっています。

これはどういうことかと言うと、C-API Referenceにも書かれていますが、独自のFormatでGMTの値で保存されているからです。
また、このFormatでの時間の生成はC-API以外では出来ないとも書かれていますが、実はこの値は計算可能です。
これは別途解説したいと思います。
では、このFormatでReplicaIDを生成するにはどうしたら良いのでしょうか?
これもC-API Referenceに記載されていて、OSCurrentTIMEDATEというFunctionが用意されています。
このFunctionで現在のOSの日時をC-APIで扱うTIMEDATE Formatに変換してくれるようです。
このFunctionは戻り値が定義されていませんので、LotusScriptの定義としてはFunctionではなく、Subとして定義します。
では、実際に試してみましょう。
前回と同様に、Agentを作成して以下のCodeを記述します。
Option Public
%Include "lsconst.lss"
%Include "LSERR.LSS"
Option Declare
Type TIMEDATE
innards(1) As Long
End Type
Declare Sub W32_OSCurrentTIMEDATE Lib "nnotes.dll" _
Alias "OSCurrentTIMEDATE" (retTimeDate As TIMEDATE )
Sub Initialize
Dim OS_TimeDate As TIMEDATE
Call W32_OSCurrentTIMEDATE(OS_TimeDate)
MessageBox OS_TimeDate.innards(0) & "," _
& OS_TimeDate.innards(1) ,_
MB_OK , "Current OS Timedate"
End Sub
今回は、C-APIで使うTIMEDATEをTypeで定義して取得しています。
これを実行すると、以下のように表示されます。

これで、現在のOS時間を取得して、ReplicaIDとして格納されているFormatの日時を取得することができました。
最初に紹介した、WebのSample Codeでは、あるDBから別のDBにReplicaIDをCopyするというものですが、これを使えば、ReplicaIDのCopyではなく、全く新しいReplicaIDを与えることが出来るようになります。
今回は、C-APIで取得できるFormatのReplicaID相当の日時の生成を試してみました。
次回は、ReplicaIDの書き換えを行ってみます。
<続く>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
前回は、C-API FunctionによってReplicaInfoがどのような形で返されるかを見てみました。
今回は、もう少し詳しく調べていきます。
前回確認した戻り値は以下のようになっていました。

この1番目と2番目がReplicaIDを示す値であることは前回も述べましたが、皆さんが良く見るReplicaIDとは全く異なる物のように見えます。
実際、私の環境のnames.nsfのReplicaIDは以下のようになっています。

これはどういうことかと言うと、C-API Referenceにも書かれていますが、独自のFormatでGMTの値で保存されているからです。
また、このFormatでの時間の生成はC-API以外では出来ないとも書かれていますが、実はこの値は計算可能です。
これは別途解説したいと思います。
では、このFormatでReplicaIDを生成するにはどうしたら良いのでしょうか?
これもC-API Referenceに記載されていて、OSCurrentTIMEDATEというFunctionが用意されています。
このFunctionで現在のOSの日時をC-APIで扱うTIMEDATE Formatに変換してくれるようです。
このFunctionは戻り値が定義されていませんので、LotusScriptの定義としてはFunctionではなく、Subとして定義します。
では、実際に試してみましょう。
前回と同様に、Agentを作成して以下のCodeを記述します。
Option Public
%Include "lsconst.lss"
%Include "LSERR.LSS"
Option Declare
Type TIMEDATE
innards(1) As Long
End Type
Declare Sub W32_OSCurrentTIMEDATE Lib "nnotes.dll" _
Alias "OSCurrentTIMEDATE" (retTimeDate As TIMEDATE )
Sub Initialize
Dim OS_TimeDate As TIMEDATE
Call W32_OSCurrentTIMEDATE(OS_TimeDate)
MessageBox OS_TimeDate.innards(0) & "," _
& OS_TimeDate.innards(1) ,_
MB_OK , "Current OS Timedate"
End Sub
今回は、C-APIで使うTIMEDATEをTypeで定義して取得しています。
これを実行すると、以下のように表示されます。

これで、現在のOS時間を取得して、ReplicaIDとして格納されているFormatの日時を取得することができました。
最初に紹介した、WebのSample Codeでは、あるDBから別のDBにReplicaIDをCopyするというものですが、これを使えば、ReplicaIDのCopyではなく、全く新しいReplicaIDを与えることが出来るようになります。
今回は、C-APIで取得できるFormatのReplicaID相当の日時の生成を試してみました。
次回は、ReplicaIDの書き換えを行ってみます。
<続く>