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

Notes/DominoのConsole Logの取得 -1-

皆さん、Notes/Dominoでは障害の際の情報収集などにLog.nsfではなく、Console Logを取得するようにサポートから言われたこともあるのではないでしょうか?



というのもLog.nsfにLogされないDebug用の情報があり、問題を分析する際はConsole Logの取得が重要になるためです。


また、Crashなどの問題の場合、Log.nsfには直前のErrorが記録されていない場合もありますので、Console Logの取得は非常に重要になります。




Domino R5以前の場合は、Debug_Outfile=<File Path>の指定で指定したFile名のFileにConsole Logが取得されます。



Domino 6以降では、Console_Log_Enabled=1の設定で、IBM_TECHNICAL_SUPPORT Folder(Directory)にconsole.logが生成され、Domino Serverを再起動する毎に、console_<ServerName>_yyyy_mm_dd@hh_mm_ss.logという形式で古いConsole LogがRenameされて新しいconsole.logが生成されるようになっているのです。



さて、このConsole Logですが、Domino 6.xで通常運用している場合は取得していない場合が殆どだと思いますが、Domino 7に上げてからConsole Logが取得されるようになってしまったという経験をお持ちの方もいらっしゃるかも知れません。



実は、Lotus技術情報(Technote)で「Lotus Notes/Domino 7.x では再起動の度に 1KB のコンソールログが出力される」 という表題で紹介されているように、Domino 7からはConsole Logの取得がDefaultに変更されています。



Domino 7を導入すると、Lotus技術情報(Technote)にも紹介されているように、Domino 7以降の場合は、


   Console_Log_Enabled=1
   Console_Log_Max_KBytes=1


という行が追加されていなくても、Console Logの取得が行われ、Logの上限値は1KBとなります。


この場合、Console Logの上限が決められていますので、Diskを圧迫することも少ないかも知れませんが、IBM_TECHNICAL_SUPPORT Folder(Directory)に1KBのLogが溜まることになります。



また、Domino Server Consoleから以下を入力すると、このConsole Logの停止や再開が可能です。



   stop consolelog


   start consolelog


ここで、Notes.iniにConsole Log取得のパラメーターが設定されていない場合、stop consolelog/start consolelogを実行すると、LogのSizeは1KBの制限値が解かれ、無制限の取得が開始されます。


つまり、明示的にConsole Logを開始させた場合は、制限なくConsole Logが取得されるのです。


ただ、このstop consolelog/start consolelogはNotes.iniのパラメーターを追加することはありませんので、Domino Serverを再起動すると、また元の状態に戻り、1KBに制限されたConsole Logが取得されるようになります。


また、Notes.iniに以下のパラメーターを明示的に指定するとどうでしょうか?


   Console_Log_Enabled=1


この場合は、明示的にConsole Logの取得の指定がされていますので、Console Logの上限値は設定されません。


つまり、明示的にConsole Logの取得を指定した場合は、以下のパラメーターが指定されていない限り、Console Logの上限は無いということです。


   Console_Log_Max_KBytes=1



Domino 7からたった1KBのConsole Logが取得されるようになった理由は私にもよく理解できません。


1KBのLogだと、ほんの数行になり、解析に役立つ情報が取れるとは限りませんから。



Console Logの上限を確認するには、Domino 7でServer Consoleから、


   Show Server


Commandを打つと、7.0.1以降では、以下のような情報が表示されます。


   Diagnostic Directory: C:\Lotus\Domino\Data\IBM_TECHNICAL_SUPPORT
   Console Logging: Enabled (1K)
   Console Log File: C:\Lotus\Domino\Data\IBM_TECHNICAL_SUPPORT\console.log


これでConsole Logが1KBに制限されているということが分かるようになっています。



このあと、先ほど紹介した、stop consolelog/start consolelogを実行してから確認すると、以下のように制限が解かれたことが確認できるのです。


   Diagnostic Directory: C:\Lotus\Domino\Data\IBM_TECHNICAL_SUPPORT
   Console Logging: Enabled
   Console Log File: C:\Lotus\Domino\Data\IBM_TECHNICAL_SUPPORT\console.log


これでDomino 7でのConsole Logの取得のDefaultが変更されていることがご理解頂けると思います。



また、障害などでConsole Logを取得する必要がある場合は、Notes.iniにConsole_Log_Enabled=1を設定しておかないと、DominoのRestartで元の1KBの設定に戻ってしまいますのでご注意ください。


この設定は、当然Server Consoleから以下のCommandで可能で、以下を入力することで、Notes.iniの変更とConsole Logの有効化が同時に行われます。


   Set Config Console_Log_Enabled=1






今回は、DominoのConsole LogのDefaultが変更になったという話をしましたが、実はNotes Clientの場合も同様にConsole Logがとられる様になっているのです。



次回は、もう少しConsole Logの話題を紹介していきます。




<続く>



【お詫び】


Commentでご指摘頂いたように、一部内容が誤っておりましたことをお詫びいたします。

訂正が完了しておりますので、頂いたCommentが不整合となりましたこと、お許しください。


【お知らせ】記事投稿が暫くの間少なくなります

先週後半から記事投稿がされていないことは皆さんもお気づきだとは思いますが、年末になり、公私共々色々と忙しい季節となりました。


つきましては、誠に申し訳ありませんが、年末から年始にかけて、記事の投稿数が激減します。


まだ書かなければならないことはたくさんあるのですが、記事を書く時間が取れませんので、ご了承ください。



年末年始の休暇を利用して、新しい記事を貯めていく予定ですので、来年にご期待ください。


簡単な記事や時間が空いた時には年内も投稿しますので、時々覗いてください。




以上、よろしくお願いいたします。


Notes/Domino 7.0.2 Mail Templateでのちょっとした改善 -4-

<話題の履歴>



Notes/Domino 7.0.2 Mail Templateでのちょっとした改善 -3-

Notes/Domino 7.0.2 Mail Templateでのちょっとした改善 -2-

Notes/Domino 7.0.2 Mail Templateでのちょっとした改善 -1-



前回は、To/Cc/Bccの宛先をList表示する機能を別名Userで試し、別名対応されていないことを設計を参照しながら解説しました。



今回は、この機能を別名対応していきます。



ただ、これはMail TemplateのCustomizeになりますので、実際に行われた場合はMail Templateに関してはIBMのサポートが受けられなくなりますのでご注意ください。



まず、宛先Fieldというのは、基本名を保持しているSendTo/CopyTo/BlindCopyToという3つのFieldがあります。


この基本名を保持したFieldに対応して、別名を保持するFieldもAltSendTo/AltCopyTo/AltBlindCopyToというFieldがあります。


今回は、このAltSendTo/AltCopyTo/AltBlindCopyToを表示するように修正を行うわけですが、例ですので、SendTo/AltSendToの場合を例に紹介していきます。


 
まず、前回、このTo Listを表示するために、Actionから以下の@Dialogboxが実行され、情報を表示していることは分かっています。


 @DialogBox("(SepToField)"; [AutoVertFit]:[AutoHorzFit]:[NoCancel]:[SizeToTable]; "Send To List")


このDialogを表示しているSubformである"(SepToField)" Subformは前回紹介したように、Formで"SendTo" Fieldを引き継ぎ、それを"displaySendToSepValue"というFieldでSortして改行で分かりやすく表示していました。


このDialogboxで表示される"displaySendToSepValue"というFieldはSendToだけを使って処理されているため、別名が表示されないことも前回紹介した通りです。



では、このSubformをCustomizeしていくことにしましょう。


今回は"AltSendTo"を利用しなければなりませんので、以下のように、現在の"SendTo" FieldをCopyして、隣に貼り付けた後に、Fieldの名前を"AltSendTo"に変更します。



Mail_Template_702_New_13



これで、@DialogboxでこのSubformが表示された時には、Mailの"AltSendTo" Fieldの値がこのForm上に設定されるようになります。



次に、このFieldを使ってTableに配置された"displaySendToSepValue" Fieldの値を別名を表示するように変更します。



変更はいとも簡単ですが、まず、e-MailなどのようにこのFieldが無い場合も考慮して以下のように記述して見ます。



   AddrList :=@If(@IsAvailable("AltSendTo")&AltSendTo !="";AltSendTo;SendTo);

   @Sort(AddrList)



ここでは、"AltSendTo" Fieldが存在するかどうかと"AltSendTo" Fieldが""でないかどうかを判断して、それによってSortして表示するFieldを変更するというLogicになっています。


通常は@IsAvailableの判断は必要ないでしょう。



この変更を行ったら、一度Subformの設計を保存してNotes ClientからActionを実行してみてください。


以下のように別名情報が表示されるようになります。



Mail_Template_702_New_14


しかし、このままでは別名が設定されていれば、何時も別名が表示されてしまうでしょう。


これでは困ってしまうこともあるのではないでしょうか?



英語Templateの場合はViewでの表示は常に基本名になりますが、To/Cc/Bcc Fieldの表示はLocation文書の設定により別名が表示されたり基本名が表示されたりすることは皆さんご存知のことでしょう。


つまり、こういった表示は以下のLocation文書の別名表示の設定で変化して貰わないと困ります。



Mail_Template_702_New_15



次に、このLocation文書の別名表示設定によって処理を変えることを考えて見ましょう。



実はこれを行うためのHintはMail DBの"($Inbox)"の設計に隠されています。



この検証では英語版のTemplateを使っていますが、英語版ではViewに別名が表示されることはありませんが、日本語版TemplateではViewにも別名が表示されていることは皆さんご存知のことでしょう。


それは何故かというと、View/Folderの列は条件によってNotes Clientに非表示にすることが出来るようになっているからです。


"($Inbox)" FolderをDomino Desingerで確認すると2つの"Who"列が定義されているのです。


その最初の"Who"列の非表示式を見ると以下のように設定されていることが確認できるでしょう。



  TemplateLang := "en";
  @If(@ClientType = "Notes"; @LocationGetInfo([NamePreference]) = "1"; @False)



この列は基本名を表示する列なのですが、@LocationGetInfo([NamePreference])で別名表示の情報を取得し、値が"1"の場合(即ち別名表示が有効な場合)は@Falseを返すということですから、非表示式でFalseなので、表示されるということになります。


その右の列は別名表示の列ですが、逆の式が書かれています。



つまり、@LocationGetInfo([NamePreference])で別名表示の情報を取得して条件を変えてやれば、Location情報によって振る舞いを変更することが出来るのです。



では、先程書いた、"displaySendToSepValue" Fieldの式を以下のように変更して見ましょう。



  AltNameEnabled :=@If(@ClientType = "Notes"; @LocationGetInfo([NamePreference]) = "1"; @True);
  AddrList :=@If(@IsAvailable("AltSendTo")&AltSendTo !=""&AltNameEnabled;AltSendTo;SendTo); 

  @Sort(AddrList)



この変更を保存して、Location文書で別名表示をOn/Offして試してみてください。



別名表示が有効な場合は別名でTo Listが作成され、別名表示が無効な場合は基本名でTo Listが作成されたことが確認できたのではないでしょうか?




今回は、To/Cc/Bcc List表示を別名対応するためのCustomize方法を紹介しました。



しかし日本のUserの場合は、もっと親切な対応を求めるかも知れません。



次回以降では、もう少しCustomizeを行い、様々な表示を行ってみたいと思います。




<続く>