DB Replica IDを書き換える? -2-
<話題の履歴>
DB Replica IDを書き換える? -1-
前回は、DB Replica IDの意味と変更する方法のWeb情報を解説しました。
今回からは、実際にWebで公開されているSample Codeを利用しながら、DB Replica IDの変更を行ってみます。
まずは、Webで公開されているCodeの内容を見てみます。
%INCLUDE "LSERR.LSS"
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
ここで、Notes DBのOpen/CloseのFunctionを定義しています。
Declare Function W32_NSFDBCREATE Lib "NNOTES.DLL" Alias "NSFDbCreate" _
(Byval dbname As String, Byval dbClass As Variant, Byval forceIt As Single) As Integer
これは、Notes DBを新規作成するためのFunctionですが、このCodeでは新規にDBを作成する訳ではありませんので不要です。
Declare Function W32_NSFDBREPLICAINFOSET Lib "NNOTES.DLL" Alias
"NSFDbReplicaInfoSet" _
(Byval dbHandle As Long, replInfoStruct As Long) As Integer
Declare Function W32_NSFDBREPLICAINFOGET Lib "NNOTES.DLL" Alias
"NSFDbReplicaInfoGet" _
(Byval dbHandle As Long, replInfoStruct As Long) As Integer
最後に、DBのReplica InfoのSet/Get Functionを定義しています。
では、このC-API Functionを使って、Replica IDを確認するだけのCodeを書いてみましょう。
WebのSample Codeでは、Input BoxでDBの指定をさせていますが、今回は単純にLocalのnames.nsfのReplica IDを確認してみることにします。
まず、"NSFDbReplicaInfoGet" Functionですが、IBMが提供するC-API Referenceにその内容が書かれています。
また、このReplicaInfoの構造は以下のように定義されています。
typedef struct {
TIMEDATE ID; /* ID that is same for all replica files */
WORD Flags; /* Replication flags */
WORD CutoffInterval; /* Automatic Replication Cutoff
Interval (Days) */
TIMEDATE Cutoff; /* Replication cutoff date */
} DBREPLICAINFO;
更に、ここでTIMEDATEの構造は以下のように定義されています。
typedef struct tagTIMEDATE {
DWORD Innards[2];
} TIMEDATE;
つまり、WORD及びDWORDの値が合計で6個、配列で戻ってくるという訳です。
こういうことから、Webで公開されているSample CodeもDWORDに対応するLong型で0-5の配列を定義しているという訳です。
このFunctionをCallすると、Replica ID, Purge Interval, Cutoff Date, Replica flagsが返されるのですが、一体どういう状態で返ってくるかを確認しておきます。
新規にDBを作成し、Action Menuから実行するAgent(対象文書なし)を新規に作成し、以下のCodeを書きます。
Option Public
%Include "lsconst.lss"
%Include "LSERR.LSS"
Option Declare
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_NSFDBREPLICAINFOGET Lib "NNOTES.DLL" Alias "NSFDbReplicaInfoGet" _
(ByVal dbHandle As Long, replInfoStruct As Long) As Integer
Sub Initialize
Dim dbhandle As Long
Dim ReplInfo(5) As Long
Dim rc As Integer
rc = W32_NSFDBOPEN("names.nsf", dbhandle&)
rc = W32_NSFDBREPLICAINFOGET(dbhandle&, ReplInfo(0))
rc = W32_NSFDBClose(dbhandle&)
MessageBox _
ReplInfo(0) & "," & _
ReplInfo(1) & "," & _
ReplInfo(2) & "," & _
ReplInfo(3) & "," & _
ReplInfo(4) & "," & _
ReplInfo(5) , MB_OK , "Replica Info"
End Sub
これを実行すると、以下のように表示されます。

これでは何のことだか分からないと思いますが、以下の順序で返ってきているようです。
TIMEDATE ID; /* ID that is same for all replica files */
(DWORD Innards[2];)
WORD CutoffInterval; /* Automatic Replication Cutoff
Interval (Days) */
TIMEDATE Cutoff; /* Replication cutoff date */
(DWORD Innards[2];)
WORD Flags; /* Replication flags */
つまり、1番目と2番目がReplicaIDという訳です。
今回は、C-API FunctionによってReplicaInfoがどのような形で返されるかを見てみました。
次回は、もう少し詳しく調べていきます。
<続く>
DB Replica IDを書き換える? -1-
前回は、DB Replica IDの意味と変更する方法のWeb情報を解説しました。
今回からは、実際にWebで公開されているSample Codeを利用しながら、DB Replica IDの変更を行ってみます。
まずは、Webで公開されているCodeの内容を見てみます。
%INCLUDE "LSERR.LSS"
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
ここで、Notes DBのOpen/CloseのFunctionを定義しています。
Declare Function W32_NSFDBCREATE Lib "NNOTES.DLL" Alias "NSFDbCreate" _
(Byval dbname As String, Byval dbClass As Variant, Byval forceIt As Single) As Integer
これは、Notes DBを新規作成するためのFunctionですが、このCodeでは新規にDBを作成する訳ではありませんので不要です。
Declare Function W32_NSFDBREPLICAINFOSET Lib "NNOTES.DLL" Alias
"NSFDbReplicaInfoSet" _
(Byval dbHandle As Long, replInfoStruct As Long) As Integer
Declare Function W32_NSFDBREPLICAINFOGET Lib "NNOTES.DLL" Alias
"NSFDbReplicaInfoGet" _
(Byval dbHandle As Long, replInfoStruct As Long) As Integer
最後に、DBのReplica InfoのSet/Get Functionを定義しています。
では、このC-API Functionを使って、Replica IDを確認するだけのCodeを書いてみましょう。
WebのSample Codeでは、Input BoxでDBの指定をさせていますが、今回は単純にLocalのnames.nsfのReplica IDを確認してみることにします。
まず、"NSFDbReplicaInfoGet" Functionですが、IBMが提供するC-API Referenceにその内容が書かれています。
また、このReplicaInfoの構造は以下のように定義されています。
typedef struct {
TIMEDATE ID; /* ID that is same for all replica files */
WORD Flags; /* Replication flags */
WORD CutoffInterval; /* Automatic Replication Cutoff
Interval (Days) */
TIMEDATE Cutoff; /* Replication cutoff date */
} DBREPLICAINFO;
更に、ここでTIMEDATEの構造は以下のように定義されています。
typedef struct tagTIMEDATE {
DWORD Innards[2];
} TIMEDATE;
つまり、WORD及びDWORDの値が合計で6個、配列で戻ってくるという訳です。
こういうことから、Webで公開されているSample CodeもDWORDに対応するLong型で0-5の配列を定義しているという訳です。
このFunctionをCallすると、Replica ID, Purge Interval, Cutoff Date, Replica flagsが返されるのですが、一体どういう状態で返ってくるかを確認しておきます。
新規にDBを作成し、Action Menuから実行するAgent(対象文書なし)を新規に作成し、以下のCodeを書きます。
Option Public
%Include "lsconst.lss"
%Include "LSERR.LSS"
Option Declare
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_NSFDBREPLICAINFOGET Lib "NNOTES.DLL" Alias "NSFDbReplicaInfoGet" _
(ByVal dbHandle As Long, replInfoStruct As Long) As Integer
Sub Initialize
Dim dbhandle As Long
Dim ReplInfo(5) As Long
Dim rc As Integer
rc = W32_NSFDBOPEN("names.nsf", dbhandle&)
rc = W32_NSFDBREPLICAINFOGET(dbhandle&, ReplInfo(0))
rc = W32_NSFDBClose(dbhandle&)
MessageBox _
ReplInfo(0) & "," & _
ReplInfo(1) & "," & _
ReplInfo(2) & "," & _
ReplInfo(3) & "," & _
ReplInfo(4) & "," & _
ReplInfo(5) , MB_OK , "Replica Info"
End Sub
これを実行すると、以下のように表示されます。

これでは何のことだか分からないと思いますが、以下の順序で返ってきているようです。
TIMEDATE ID; /* ID that is same for all replica files */
(DWORD Innards[2];)
WORD CutoffInterval; /* Automatic Replication Cutoff
Interval (Days) */
TIMEDATE Cutoff; /* Replication cutoff date */
(DWORD Innards[2];)
WORD Flags; /* Replication flags */
つまり、1番目と2番目がReplicaIDという訳です。
今回は、C-API FunctionによってReplicaInfoがどのような形で返されるかを見てみました。
次回は、もう少し詳しく調べていきます。
<続く>
DB Replica IDを書き換える? -1-
皆さんご存知のように、Notes/DominoのDBはReplica IDやDBIIDというIDで識別されています。
特にDB Replica IDはReplicaなどで同じDBであることを認識するために利用されており、このReplica IDは日付情報から生成されるように出来ています。
最近では分かりませんが、昔は、Notesを初期導入する際に、大量のUser登録が必要なために、Toolを使って複数ServerでUser登録を自動で行うといった作業が行われることも多くありました。
このようなことをすると、偶然、DBの作成日時が一致してしまうこともある訳で、それが後々、問題になってしまいます。
というのは、Replicator的には二つのDBは同じ物と見做されてしまうからです。
それ以外にも、UserはLocal ReplicaのBackupを取ったり、年度毎にMail DBのBackupを整理したりすることでしょう。
この場合、単純にNotes ClientでDBのCopyを取っていれば、新しいReplica IDが割り振られるため問題は発生しないのですが、Userはそんなことはしません。
何故なら、Copyを取ってしまうと、未読Tableが無効になってしまうからです。
Userは単純にOS CopyでFile名を変えて保存しておくことでしょう。
こうなると、Notes Clientの中に同じReplica IDを持ったDBが複数存在してしまうことになり、Workspaceにも登録するでしょうから、ReplicatorはどのDBとReplicaを実行するのか訳の分からない状態になる訳です。
こんな問題を回避するには、Replica IDを書き換えてしまうことが一番単純な解決策なのですが、残念ながら、Replica IDの書き換えはLotusScriptなどのNotesの標準言語では出来ないのです。
では、どうすれば良いのか?というと、YtriaというToolがTeamStudioから発売されており、この中にReplica IDを書き換えるToolが存在しますので、これを利用することも考えられるでしょう。
しかし、たったこれだけの為に、Ytriaを購入するのも馬鹿々々しいと思われる方も多いと思います。
実は、Replica IDはNotes標準のC-API Funcitonを使えば書き換えることが出来ます。
Replica IDを書き換えるSampleもInternetで公開されています。
このSampleの例では、あるDBのReplica IDを他のDBに移植するという手法を取っています。
この手法も役立つことは沢山あります。
例えば、Client PCがCrashしてしまい、LocalのReplica Mail DBが無くなってしまった場合に、UserがLocal ClientでDB CopyしてBackupを取っていたような場合には、Backup DB(Copyなので、Replica IDは異なる)のReplica IDをServer側のMail DBと一致させ、Replica DBとして復活させるということも出来る訳です。
今回は、このWebに公開されているReplica IDの変更手法を試して行きたいと思います。
<続く>
特にDB Replica IDはReplicaなどで同じDBであることを認識するために利用されており、このReplica IDは日付情報から生成されるように出来ています。
最近では分かりませんが、昔は、Notesを初期導入する際に、大量のUser登録が必要なために、Toolを使って複数ServerでUser登録を自動で行うといった作業が行われることも多くありました。
このようなことをすると、偶然、DBの作成日時が一致してしまうこともある訳で、それが後々、問題になってしまいます。
というのは、Replicator的には二つのDBは同じ物と見做されてしまうからです。
それ以外にも、UserはLocal ReplicaのBackupを取ったり、年度毎にMail DBのBackupを整理したりすることでしょう。
この場合、単純にNotes ClientでDBのCopyを取っていれば、新しいReplica IDが割り振られるため問題は発生しないのですが、Userはそんなことはしません。
何故なら、Copyを取ってしまうと、未読Tableが無効になってしまうからです。
Userは単純にOS CopyでFile名を変えて保存しておくことでしょう。
こうなると、Notes Clientの中に同じReplica IDを持ったDBが複数存在してしまうことになり、Workspaceにも登録するでしょうから、ReplicatorはどのDBとReplicaを実行するのか訳の分からない状態になる訳です。
こんな問題を回避するには、Replica IDを書き換えてしまうことが一番単純な解決策なのですが、残念ながら、Replica IDの書き換えはLotusScriptなどのNotesの標準言語では出来ないのです。
では、どうすれば良いのか?というと、YtriaというToolがTeamStudioから発売されており、この中にReplica IDを書き換えるToolが存在しますので、これを利用することも考えられるでしょう。
しかし、たったこれだけの為に、Ytriaを購入するのも馬鹿々々しいと思われる方も多いと思います。
実は、Replica IDはNotes標準のC-API Funcitonを使えば書き換えることが出来ます。
Replica IDを書き換えるSampleもInternetで公開されています。
このSampleの例では、あるDBのReplica IDを他のDBに移植するという手法を取っています。
この手法も役立つことは沢山あります。
例えば、Client PCがCrashしてしまい、LocalのReplica Mail DBが無くなってしまった場合に、UserがLocal ClientでDB CopyしてBackupを取っていたような場合には、Backup DB(Copyなので、Replica IDは異なる)のReplica IDをServer側のMail DBと一致させ、Replica DBとして復活させるということも出来る訳です。
今回は、このWebに公開されているReplica IDの変更手法を試して行きたいと思います。
<続く>
Calendar/Task機能を無効にする? -9-
<話題の履歴>
Calendar/Task機能を無効にする? -1-
Calendar/Task機能を無効にする? -2-
Calendar/Task機能を無効にする? -3-
Calendar/Task機能を無効にする? -4-
Calendar/Task機能を無効にする? -5-
Calendar/Task機能を無効にする? -6-
Calendar/Task機能を無効にする? -7-
Calendar/Task機能を無効にする? -8-
前回は、Right Click MenuからCalendar/TaskのCopy Intoや会議招集の機能の無効化を行いました。
今回は、これ以外にCalendar/Task関係のActionが残っていないかをCheckします。
皆さんご存知のように、Notes 9 Client Standardでは標準で導入すると、Sametimeが入ってしまいます。
Mail TemplateにもSametimeの機能は標準で装備されています。
実は、このSametimeのAction Buttonや右クリックで表示されるMenuの中にもCalendar関係の機能が実装されているのです。

これを実行すると、以下のような画面が出てしまいます。

この画面の中の、「会議の作成」ボタンから会議招集が出来てしまうように見えます。
しかし、今回のCustomizeでは、Calendar/TaskのForm自体をNotes Clientから利用不可な状態に設定しておりますので、Buttonを押しても何も起こらず、Mail画面に戻ってしまいます。
蛇足ですが、このSametimeのAction ButtonやRight Click Menuは通常のActionではなく、Notes StandardのJava Viewに埋め込まれた機能となっており、Template Clustomizeでは残念ながら消し去ることができないのです。
以下のように、Side BarからSametimeを使えない状態にしていても表示されてしまうのです。

どうやら、この部分はTemplate Customizeで対応するという観点からは諦めざるを得ないようです。
逆にIBMさんにこの機能をSametimeが有効化されているかどうかによって表示制御する機能を実装して頂きたいと思います。
さて、ここまでTemplateだけでCustomizeするという観点から、Calendar/Taskの機能を利用不可能な状態にしてきました。
少し不満が残った点もありますが、ある程度は利用制限が出来たのではないかと思います。
しかし、賢明な皆さんの中には、気が付かれる方がいらっしゃるかと思いますが、これだけでは実は不十分なのです。
皆さん、ご存知の通り、Notes ClientはViewを移動する「表示」>「移動」Menuが存在します。

これも表示されないようにしてしまわない事には、Calendar/Taskの機能にAccessが出来てしまう訳です。
今回行ったCustomizeではCalendar/Task Form自体を無効にしていますので、新しいEntryが作成できる訳ではありませんが、Userの中にはViewの移動機能を使って利用しようとするUserもいるかも知れません。
Ctrl+Shift+「移動」を使うと、更にCalendar/Task関係の隠しViewにAccessすることも可能です。
この場合は、Calendar/Task関係のViewを全てNotes Clientから利用不可に設定してしまうことで対処可能ですが、簡単な作業ですので、今回は解説は割愛させて頂きます。
また、これ以外にも、プリファレンスの中にもCalendarの設定があります。
これはタブ付表で出来ているので、文字の非表示制御で表示を隠したり、タブ自身を削除してCustomizeしてしまうことが考えられますが、今回は割愛させて頂きます。
さて、どうだったでしょうか?
MailだけでNotesのMail Templateを使うためにはこのようなCustomizeが必要となる訳です。
私は、Full機能を活用して仕事の生産性を上げて欲しいと思いますが、会社の方針などから機能制限が必要な場合もあるかと思い、今回の記事を書かせて頂きました。
少しでもご参考になれば幸いです。
<終わり>
Calendar/Task機能を無効にする? -1-
Calendar/Task機能を無効にする? -2-
Calendar/Task機能を無効にする? -3-
Calendar/Task機能を無効にする? -4-
Calendar/Task機能を無効にする? -5-
Calendar/Task機能を無効にする? -6-
Calendar/Task機能を無効にする? -7-
Calendar/Task機能を無効にする? -8-
前回は、Right Click MenuからCalendar/TaskのCopy Intoや会議招集の機能の無効化を行いました。
今回は、これ以外にCalendar/Task関係のActionが残っていないかをCheckします。
皆さんご存知のように、Notes 9 Client Standardでは標準で導入すると、Sametimeが入ってしまいます。
Mail TemplateにもSametimeの機能は標準で装備されています。
実は、このSametimeのAction Buttonや右クリックで表示されるMenuの中にもCalendar関係の機能が実装されているのです。

これを実行すると、以下のような画面が出てしまいます。

この画面の中の、「会議の作成」ボタンから会議招集が出来てしまうように見えます。
しかし、今回のCustomizeでは、Calendar/TaskのForm自体をNotes Clientから利用不可な状態に設定しておりますので、Buttonを押しても何も起こらず、Mail画面に戻ってしまいます。
蛇足ですが、このSametimeのAction ButtonやRight Click Menuは通常のActionではなく、Notes StandardのJava Viewに埋め込まれた機能となっており、Template Clustomizeでは残念ながら消し去ることができないのです。
以下のように、Side BarからSametimeを使えない状態にしていても表示されてしまうのです。

どうやら、この部分はTemplate Customizeで対応するという観点からは諦めざるを得ないようです。
逆にIBMさんにこの機能をSametimeが有効化されているかどうかによって表示制御する機能を実装して頂きたいと思います。
さて、ここまでTemplateだけでCustomizeするという観点から、Calendar/Taskの機能を利用不可能な状態にしてきました。
少し不満が残った点もありますが、ある程度は利用制限が出来たのではないかと思います。
しかし、賢明な皆さんの中には、気が付かれる方がいらっしゃるかと思いますが、これだけでは実は不十分なのです。
皆さん、ご存知の通り、Notes ClientはViewを移動する「表示」>「移動」Menuが存在します。

これも表示されないようにしてしまわない事には、Calendar/Taskの機能にAccessが出来てしまう訳です。
今回行ったCustomizeではCalendar/Task Form自体を無効にしていますので、新しいEntryが作成できる訳ではありませんが、Userの中にはViewの移動機能を使って利用しようとするUserもいるかも知れません。
Ctrl+Shift+「移動」を使うと、更にCalendar/Task関係の隠しViewにAccessすることも可能です。
この場合は、Calendar/Task関係のViewを全てNotes Clientから利用不可に設定してしまうことで対処可能ですが、簡単な作業ですので、今回は解説は割愛させて頂きます。
また、これ以外にも、プリファレンスの中にもCalendarの設定があります。
これはタブ付表で出来ているので、文字の非表示制御で表示を隠したり、タブ自身を削除してCustomizeしてしまうことが考えられますが、今回は割愛させて頂きます。
さて、どうだったでしょうか?
MailだけでNotesのMail Templateを使うためにはこのようなCustomizeが必要となる訳です。
私は、Full機能を活用して仕事の生産性を上げて欲しいと思いますが、会社の方針などから機能制限が必要な場合もあるかと思い、今回の記事を書かせて頂きました。
少しでもご参考になれば幸いです。
<終わり>