Lotus Notes/Domino (R) をこよなく愛して。。。。 -344ページ目

小技/小ネタ:@Text( DateTimeValue ; "*") ?

@Text( DateTimeValue ; "*")


と書かれても何のことか?と思われる人もいるでしょう。


これは、所謂、Notes/Dominoで隠されている関数のパラメーターです。


Notes/Dominoの中には、開発上内部で利用しているが、Helpなどには記載されていない関数というのが存在します。


ここでそのような物を紹介して良いのか?と言われるかも知れませんが、日本のNotes関係のMailing Listでも出回っていましたし、ここでLinkしているNotes411とかでも過去に紹介されていたのではないかと思いますので、皆さんもご存知のことだと思います。


こういった隠し関数とか機能は、Mail Templateを解析していると発見することが多いのも事実で、Mail TemplateというのはNotes/Dominoの機能をフル活用して作成されているのです。


というより、Mailの機能を実現したり、Notesの機能を実現するために開発者がこういった関数を作っているというのが正しいかも知れません。


話を元に戻して、この式の意味ですが、これは例えば、文書にボタンを定義して、その式に以下のように書いてみると分かるでしょう。



   @Prompt([Ok] ; "現在の日時のNotesの16進数表現" ; @Text(@Now ; "*"))



返されるのは、16進数のある値ですが、これを見て皆さんは何を思われるでしょうか?


Replica_ID


これは、DBのReplicaIDであったり、文書のUNIDであったり、要するにNotes/DominoでDBや文書を特定している重要なIDと同じものです。


このような隠し関数があることはどうでもいい訳ですが、このLogicを使ってReplicaIDやUNIDが生成されているということを知ることも重要かも知れません。


Notes/DominoではこのReplicaIDやUNIDというのが非常に重要で、これによって相手が同じもののReplicaであるという判断をしているのです。


そういう意味では、Notes/Dominoを動かすServerやClientの時間をいたずらに変更すべきではありません。


時間を利用して成り立っているのがNotes/Dominoですから、時間を変更することはDBを壊してしまうことにもつながりかねないのです。



話が少し逸れてしまいました。



このReplicaIDやUNIDですが、それは上の式で試したように単に時間なのです。


皆さんも日本でDBを作成すると、ReplicaIDは"4925...."というようになることはご存知でしょうし、USのTemplateとかを見ると、"8525....."となっていることも分かります。


つまり、最初はDBを作成した国によって固定的なのです。


これは、以下のTechnoteを参照するとわかります。


     Lotus Software Knowledge Base Document

     Title: How To Interpret the Hexadecimal Values in a Time/Date Value
     Doc #: 7003019
     URL: http://www.ibm.com/support/docview.wss?rs=899&uid=swg27003019


このTechnoteに書かれているように、最初の2桁はGMTからLocal TimeへのズレとDST(Day Light Saving)を示しているわけであり、DBを作成した国によって一定になるのです。


Technoteの記述から"49"で始まる場合は、日本の東京時間を示していることになる訳です。



これを知っていてどうなのか?ということは無いのですが、こういうことも知っていると、Notes/Dominoにとってどれだけ時間ということが重要であるか?をご理解頂けるのではないかと思います。


一気にUser登録をしたいといった要望から、Toolなどを使って複数のServerでUser登録を行うといったこともあるかも知れません。


その際、Mail DBを生成させると、偶然にも同じReplicaID(時間)のDBもできることもありうる訳です。


Notes/DominoはReplicaIDでDBが同じであるかどうかを判断していて、同一Server上に同一ReplicaIDのDBがあるとReplicationなどで思わぬ動きをしてしまいますが、これは皆さんもご存知のことでしょう。



時間が命のNotes/Dominoだということを、今一度肝に銘じておくべきかも知れません。


Single Copy Templateの仕組 -2-

<話題の履歴>


Single Copy Templateの仕組 -1-



前回は、TechnoteやIBM Siteの情報の提供に終わってしまいました。



今回以降では、Single Copy Template(SCT)の仕組みについて詳細に調べていく訳ですが、まず大事なことは、SCTが登場する前の仕組みも理解しておくことです。


今回はSCTの説明をする前提として、ClientのDesign Cacheの仕組みなどを解説したいと思います。


皆さん、Notes/DominoはClient/Serverで動いていて、設計の殆どの要素がClient側で処理されていることはご存知のハズです。


また、設計が変更されなければ、Client Cacheに保持した設計を利用しているということもご存知でしょう。



このように、Notes/DominoはLocalのCache(Cache.dsk/Cache.ndk)に設計をCacheして再利用するこことはこれまでにも述べたと思います。


毎回設計要素を読み込むようなことをすると、Mail DBのような複雑な設計の場合はPerformanceに影響を与えるからです。


別に複雑な設計でなくても、Networkが貧弱な環境では毎回設計要素を読み込むような処理をしていたのではPerformanceは良くはなりません。


流石、この辺はServerもNetworkも貧弱な頃に最適なPerformanceが保てるように設計されたNotes/Dominoのうまい仕組みだと思います。



皆さんもご存知のようにDesign Cacheの動きは基本的に以下のようになります。


Notes Clientで始めてDBにAccessすると、NRPC Commandで設計要素を要求し、その設計要素はCacheに格納されて利用されます。


2回目にAccessした際は、設計要素の更新がされていないかをCheckして、更新されていなければ、Cacheにある設計要素をそのまま利用し、毎回設計要素を読み込むようなことは行わないように出来ているのです。


また、これはReplica DBの場合も同じで、同じ設計であると判断されると、CacheにはEntryを生成して同じであることを示すだけで、設計を二重にCacheするようなことはないのです。




実際にこの動きを見ることは非常に簡単です。



またかと言われそうですが、NRPC Traceを取ることで動きを見ることができるのです。


単純化するために「Notes/Dominoの未読文書管理の仕組」で作成した一つのFormと1つのViewから構成されるDBで試してみると、その動きを見ることができます。


試す前に、Cache(Cache.dsk/Cache.ndk)と、念の為にBookmark(Bookmark.nsf)を削除します。


Bookmark.nsfを削除するのは、R4.xやR5の頃はCacheだけに情報を保持していたのですが、Notes 6以降ではBookmarkも一部Cacheのような機能を持っているからです。



NRPC Traceの取得の設定を行い、DBを開いて文書を開いてみると以下のようなNRPC Traceが取得されます。


(12-54 [12]) OPEN_DB(CN=DomSrv/O=LotusSW!!Test\UnreadTest.nsf): (Connect to DomSrv/LotusSW: 10 ms) (Exch names: 0 ms)(Authenticate: 0 ms.)
(OPEN_SESSION: 0 ms) 0 ms. [134+290=424]
(13-54 [13]) ISDB2_RQST: 0 ms. [14+16=30]
(14-54 [14]) GET_UNREAD_NOTE_TABLE: 10 ms. [290+172=462]
(15-54 [15]) OPEN_NOTE(REP49257118:001FE135-NTFFFF0010,03000400): 0 ms. [48+1018=1066]
(16-54 [16]) OPEN_COLLECTION(REP49257118:001FE135-NT00000116,0040,4000):
(17-54 [17]) OPEN_DB(CN=DomSrv/O=LotusSW!!Test\UnreadTest.nsf): (Connect to DomSrv/LotusSW: 10 ms) (Exch names: 0 ms)(Authenticate: 10 ms.)
(OPEN_SESSION: 0 ms) 0 ms. [134+290=424]
(18-54 [18]) CLOSE_DB(REP49257118:001FE135): 0 ms. [14+0=14]
20 ms. [250+2588=2838]
(19-54 [19]) GET_NOTE_INFO: 0 ms. [18+102=120]
(20-54 [20]) GET_COLLATION: 0 ms. [12+14=26]
(21-54 [21]) READ_ENTRIES(REP49257118:001FE135-NT00000116): 0 ms. [76+1726=1802]
(22-58 [22]) OPEN_NOTE(REP49257118:001FE135-NT000008F6,02400136): 10 ms. [48+458=506]
(23-58 [23]) OPEN_NOTE(REP49257118:001FE135-NT00000136,02400114): 0 ms. [48+2302=2350]
(24-61 [24]) CLOSE_COLLECTION(REP49257118:001FE135-NT00000116): 0 ms. [12+0=12]
(25-61 [25]) CLOSE_DB(REP49257118:001FE135): 0 ms. [14+0=14]


このTraceで黄色で示した部分が設計関係となり、最初は特別な設計要素、2番目がView Collection、3番目がFormとなっています。


このように、設計要素はNoteIDで判断することができるのです。


この後、Cacheの内容を見てみると、以下のようにCacheにEntryが作成されたことが確認できます。


SCT_1


Cacheの内容は、Notes Clientで直接Cache(Cache.dsk/Cache.ndk)を開いて確認することもできますが、Notes Clientで確認した場合は当然Cacheの文書を開くことはできません。


Notes Clientで見る場合は、ByURL Viewを使うと、Notes://形式でListされますので、DBのReplica IDが分かっていれば、どのDBのCache Entryなのかを判断できます。


SCT_2


また、ここで文書のPropertyを確認すると、$Title Fieldに設計要素の名前、$SourceDBPathにDBのあるServer名とFile Path、$SourceURLにReplicaIDとUNID/NoteIDによる設計要素のURL Path、$SourceSeqTimeに設計要素の最終更新日、$SourceSequenceに設計要素の改変Sequence No、$ClassNameに設計要素の種類(Formなど)というように保持していることが確認できます。


SCT_3


以前紹介したNotesPeekで見ると、以下のようになり、設計要素の判断はしにくいのですが、内容を一覧で見ることが可能です。


SCT_4


ここで、NRPC TraceのOpenNote Commandに記載されたNoteIDで探していくと、どの設計要素をDBを開く際に取得してCacheしているかが容易に分かるのです。


今回の場合は単純な設計ですので、ViewとFormをCacheしていることがわかります。



もう一度DBを開いて文書を開いた時のNRPC Traceは以下のようになります。


(26-139 [26]) OPEN_DB(CN=DomSrv/O=LotusSW!!Test\UnreadTest.nsf): 0 ms. [134+290=424]
(27-139 [27]) ISDB2_RQST: 0 ms. [14+16=30]
(28-139 [28]) GET_UNREAD_NOTE_TABLE: 10 ms. [290+172=462]
(29-139 [29]) OPEN_NOTE(REP49257118:001FE135-NTFFFF0010,03000400): 0 ms. [48+1018=1066]
(30-139 [30]) OPEN_COLLECTION(REP49257118:001FE135-NT00000116,0040,4000): 0 ms. [250+2588=2838]
(31-139 [31]) GET_NOTE_INFO: 0 ms. [18+102=120]
(32-139 [32]) GET_COLLATION: 0 ms. [12+14=26]
(33-139 [33]) READ_ENTRIES(REP49257118:001FE135-NT00000116): 0 ms. [76+1726=1802]
(34-141 [34]) OPEN_NOTE(REP49257118:001FE135-NT000008F6,02400136): 0 ms. [48+458=506]
(35-145 [35]) CLOSE_COLLECTION(REP49257118:001FE135-NT00000116): 10 ms. [12+0=12]
(36-145 [36]) CLOSE_DB(REP49257118:001FE135): 10 ms. [14+0=14]


ここでお分かり頂けるように、DBの特別な設計要素とView CollectionはOpenNote/OpenCollectionで設計要素を取得するNRPC Commandが発行されますが、Formの設計を取得するNRPC Commandは発行されなくなります。


最初の設計要素というのは特殊な設計要素で、この設計要素はCacheされず毎回読み込まれます。


また、View Collectionも毎回読み込まれるようになっています。


今回の場合は、それ以外の設計要素はFormだけしかありませんので、Formの読み込みが省略された形となっていますが、Mail DBなどの場合はFramesetやPage,Subformなどたくさんの設計要素がありますが、これらの設計要素はCacheされCacheが有効な限り再度読み込みされることはなくなるのです。


つまり、ServerのDBの設計要素が変更されていなければ、Cacheにある設計要素をそのまま利用するようにできている事がわかります。


尚、Cacheに保存される設計要素はServerに配置されたDBの物だけであり、Local DBの設計要素は保存されません。


Localの場合、わざわざCacheしなくてもDBから設計要素を取得すればよいからです。


次に、ServerのDBのForm設計を変更して、同様にNRPC Traceを取得すると以下のようになります。


(101-3455 [101]) OPEN_DB(CN=DomSrv/O=LotusSW!!Test\UnreadTest.nsf): 0 ms. [134+290=424]
(102-3455 [102]) ISDB2_RQST: 0 ms. [14+16=30]
(103-3455 [103]) GET_UNREAD_NOTE_TABLE: 0 ms. [290+172=462]
(104-3455 [104]) OPEN_NOTE(REP49257118:001FE135-NTFFFF0010,03000400): 0 ms. [48+1018=1066]
(105-3455 [105]) OPEN_COLLECTION(REP49257118:001FE135-NT00000116,0040,4000): 0 ms. [250+2588=2838]
(106-3455 [106]) GET_NOTE_INFO: 0 ms. [18+102=120]
(107-3455 [107]) GET_COLLATION: 0 ms. [12+14=26]
(108-3455 [108]) READ_ENTRIES(REP49257118:001FE135-NT00000116): 20 ms. [76+1726=1802]
(109-3460 [109]) OPEN_NOTE(REP49257118:001FE135-NT000008F6,02400136): 0 ms. [48+458=506]
(110-3460 [110]) OPEN_NOTE(REP49257118:001FE135-NT00000136,02400114): 0 ms. [48+2302=2350]
(111-3472 [111]) CLOSE_COLLECTION(REP49257118:001FE135-NT00000116): 0 ms. [12+0=12]
(112-3472 [112]) CLOSE_DB(REP49257118:001FE135): 0 ms. [14+0=14]


設計変更されたForm設計要素をNRPC Commandで再度取得していることがご理解いただけるでしょう。


また、Cacheの内容を確認すると、以下のように、CacheされたFormのSequenceとSequence Timeが変更されていることが確認できます。


SCT_5


このように、Notes ClientはLocal Cacheをうまく活用して、ServerとのNetwork Trafficを少なくし、Performanceを上げるようにできているのです。


今回は、設計のCacheについてNRPC Traceを使って見てみました。


次回は、別のServerにReplica DBがあった場合の動きについて解説します。



<続く>

Notes/Dominoの未読文書管理の仕組 -13-

<話題の履歴>


Notes/Dominoの未読文書管理の仕組 -12-

Notes/Dominoの未読文書管理の仕組 -11-

Notes/Dominoの未読文書管理の仕組 -10-

Notes/Dominoの未読文書管理の仕組 -9-

Notes/Dominoの未読文書管理の仕組 -8-

Notes/Dominoの未読文書管理の仕組 -7-

Notes/Dominoの未読文書管理の仕組 -6-

Notes/Dominoの未読文書管理の仕組 -5-

Notes/Dominoの未読文書管理の仕組 -4-

Notes/Dominoの未読文書管理の仕組 -3-

Notes/Dominoの未読文書管理の仕組 -2-

Notes/Dominoの未読文書管理の仕組 -1-



前回は、Notes/Domino 6.5/6.0.3より拡張された異なるServerのReplica DB間での未読情報の同期機能のKeyとなっているUnread Activity Logの内容を可能な範囲で調べてみました。


今回は、前回残っていたUnread Activity LogのPurgeについて調べてみます。



Technoteによると、Unread Activity Logは全てのUserの未既読操作を記録していく訳ですのでその量は膨大な物になっていくことが考えられます。


1つの操作を記録するために60 Bytesが使われるわけですから、DBの多くの文書を読んだりすると、数百の未既読操作Logが記録されることもあるでしょう。


これを永遠に残すようなことを行っていると、DBはUnread Activity Logで一杯になってしまうのです。


Notes/Dominoは、ここでも「良い諦め」をしています。


Technoteに記述されているように、Cutoff Intervalの期間だけ保持するようになっているのです。


Cutoff Intervalは下図のように、Replication設定で行え、Defaultは90日となっています。


Notes_Unread_8


つまり、90日以上たったUnread Activity Logは消え去ってしまうわけです。



話が逸れてしまいますが、皆さんは、このCutoff Intervalは文書の削除を示す削除スタブの保存期間にも関係していることはご存知でしょう。


削除スタブもDBがReplicaされている環境では非常に重要で、削除情報を持っていることで、Replica相手に削除を伝えたりすることができるのです。


削除スタブの場合はCutoff Intervalの1/3の期間でPurgeされるようになっています。



話を元に戻しましょう。


賢明な皆さんはここでお気づきになるかと思いますが、この仕組みだとCutoff Interval以上たってから別のReplica DBをAccessしても未読情報は一致しないということになります。



では、実際にこの動きを検証してみたいと思います。


まさか、90日も待っていられませんので、今回はCutoff Intervalを1日に変更して行ってみることにしましょう。


両方のDBのReplication設定のCutoff Intervalを変更し、片方のReplica DBで未既読情報を変更してから(今回は両方のReplica DBを全て未読にしてから、片方のReplica DBで全てを既読に変更します)、Replicationを行い、2日放置しておきます。


Notes ClientのUnread Journalを無効にするために、前回設定したNotes.iniは設定したままで作業をおこない、2日間は未読情報を更新したReplica DBへのAccessは行いますが、もう一方のReplica DBには一切Accessしないようにします。


これが、通常の皆さんの使い方に近いものとなります。


この試験で期待しているのは、Cutoff Intervalを過ぎてUnread Activity LogがPurgeされ、同期が取れなくなるという現象を確認することです。


2日たったら、再度Notes Clientを起動し、幾つかの文書の未読情報を変更し、Server間でDBをReplicaしてから、これまでAccessしていなかったReplica DBを開きます。


直前に未読情報を変更した文書は未読情報が一致していますが、それ以外は未読情報が一致しなくなったことが確認できます。


この検証で言えることは、いくら未読文書のReplica設定を行っても、Cutoff Intervalで指定された期間内にReplica DBにAccessしないと、未読情報は狂ってしまうということです。


一般的に、Mail DBなどをDomino Cluster構成されている場合に、この未読情報のReplicaの設定を行っているとしましょう。


Domino Clusterの場合、Server Availability Index(SAI)によって、どちらのServerに接続するかが決定されます。


Domino ClusterはServerのSAIに関して、どこまでの値であればBusyとみなすかという指定も可能です。


つまり、ClusterとしてActive-ActiveでLoad Blanceすることも出来ますし、Active-Standbyの構成をとる事もできるのです。


Active-Activeの場合は、Replica DBの両方にAccessすることもあるでしょうが、Active-Standbyの場合は、通常はHome Mail ServerにしかAccessしません。


となると、Standby Server側のReplica DBを開くことは滅多にないという状況が生じます。


そのような状況の場合、Unread Activity Logは既に消滅しており、Replica間での未読情報が食い違うということが発生するのです。


こういうことから、Active-Standby構成のDomino Clusterでは未読の交換指定は意味をなさない場合がありますし、Active-Activeの場合であっても、Serverの能力が十分な場合でServer Downもなく運用されているような場合は未読の交換指定は意味をなさないのです。


逆に、Replication負荷を少し上げてしまうだけという結果になります。


しかし、最初に書いたように、全てのUnread Activity Logを残すことは、膨大なDataを残すことになり、好ましくないことですから、Notes/Dominoは「良い諦め」をして、このような機能にしているのです。


こういったことは、Performanceを考えてSystemを構築する場合、他のSystemでも同じような事をするのではないでしょうか?


また、前回見たようにUnread Activity Logには、「全ての文書を未読に」とか「全ての文書を既読に」といった操作を行った場合も、文書ごとに未既読情報を変更したというLogが生成される訳です。


以前紹介したNotes ClientのUnread Journalでは、これらの操作は1 Transactionとして記録されます。


この辺の特性も理解しておくと役立つでしょう。


前回から設定しているUnread Journalを無効化するNotes.iniの設定は、User IDを切り替えて利用したり、別のPCで利用したりする場合は非常に有効な手法ですが、Unread Journalを無効にしてしまうことになります。


Unread Activity Logが期間で消える、Unread Journalは最大数で消えるという特性を考えた場合、自分のPCでIDを切り替えずに使い続けるUserの場合は、Unread Journalも残しておいた方がいいことになります。


もし、通常は同じPCで使っていて、自宅からなどから利用する場合に別のPCを使うというUserの場合は、時々使うPCのNotes.iniにのみ、Unread Journalを無効にする設定を行っておくべきだと思います。


これから考えると、サテライトOfficeなどで共有PCを運用される場合は、このNotes.iniは必須の設定ということになります。



今回は、Unread Activity Logの保持期間に関する検証と、Unread Journalの使い分けなどの考慮点を書いてみました。



次回は、これらの実験結果を踏まえながら、もう一度Technoteの内容を整理して、未読管理の仕組を調査していきます。



<続く>