DSPFやユーザー・コマンドにパネル・グループ(UIM)を使ってヘルプを
定義できることはよく知られているがパネル・グループ(UIM)の
文法を覚えるのが面倒だという方のためにパネル・グループ(UIM)を
端的にまとめてみた。
ヘルプ・パネルを書きたいときはいつでもこのページを開くだけで
ヘルプ・パネル・グループを記述することができる。
・パネル・グループ(UIM)の文法
パネル・グループ(UIM)はHTMLと同じタグ言語であって
始まりは : (コロン)で始まり終わりは . (ビリオド)で終了する。
・先頭行と終了行
CLPが PGMで始まり ENDPGM で終わるのと同じように
パネル・グループ(UIM)も
:PNLGRP. で始まり
:EPNLGRP. で終わる。
・HELP句
パネル・グループ(UIM)はいろいろなセクション(句)で構成されており
ヘルプを記述するには HELP句であり
:HELP NAME='(ヘルプの名前)’. で始まり
:EHELP. で終了する。
例えばこんな具合である。
:PNLGRP. :HELP NAME='最初のヘルプ'. これは最初のヘルプです。 :EHELP. :HELP NAME='2番目のヘルプ'. これは2番目のヘルプです。 :EHELP :EPNLGRP.
・Hx. 見出し(ヘッダー)
4レベルのヘッダーが用意されている。
・H1 – 中央揃えで 高輝度/太文字/下線
・H2 – 左寄せで 高輝度/太文字/下線
・H3 – 左寄せで 高輝度/太文字
・H4 – 左寄せで 太文字
:PNLGRP. :HELP NAME='最初のヘルプ'. これは最初のヘルプです。 :XH1.見出し1. :XH2.見出し2. :XH3.見出し3. :XH4.見出し4. :EHELP. :EPNLGRP.
・P-パラグラフ
表示したいテキストがあればパラグラフ(P)の後に続いて
記述する。
:PNLGRP. :HELP NAME='2番目のヘルプ'. これは2番目のヘルプです。 :H1.バラグラフ :P.これは初めてのバラグラフです。. :P.もうひとつのバラグラフをここに入れます。 :EHELP :EPNLGRP.
・HPx/EHPx - ハイライト
ハイライト・タグはパラグラフ(P)タグの中に入れなければならない。
またハイライト・タグは終了タグも記述しなければならない。
・HP1/EHP1 – 下線表示
・HP2/EHP2 – 高輝度/太線
・HP3/EHP3 – 高輝度/太線/下線
・HP4/EHP4 – 通常のテキスト
・HP5/EHP5 – 反転イメージ
・HP6/EHP6 – 反転イメージ/下線
・HP7/EHP7 – 反転イメージ/高輝度/太線
・HP8/EHP8 – 反転イメージ/高輝度/太線(HP7と同じ)
・HP9/EHP9 – 反転イメージ(HP5と同じ)
:PNLGRP. :HELP NAME='3番目のヘルプ'. これは3番目のヘルプです。 :H1.高輝度 :P.高輝度はパラグラフの中で有効になります。 :P.:HP1.ハイライト1:EHP1. :P.:HP1.ハイライト2:EHP1. :P.:HP1.ハイライト3:EHP1. :P.:HP1.ハイライト4:EHP1. :P.:HP1.ハイライト5:EHP1. :P.:HP1.ハイライト6:EHP1. :P.:HP1.ハイライト7:EHP1. :P.:HP1.ハイライト8:EHP1. :P.:HP1.ハイライト9:EHP1. :EHELP :EPNLGRP.
・UL/EUL – 順不同リスト
順不同リストとは単に項目を列挙するだけのリストのことである。
:PNLGRP. :HELP NAME='4番目のヘルプ'. これは4番目のヘルプです。 :H1.順不同リスト :P.順不同リストは複数個のパラグラフより見やすくなります。 :UL. :LI.項目1 :LI.項目2 :LI.項目3 :EUL. :EHELP :EPNLGRP.
・順序リスト
順不同リストと順序リストのちがいは順序リストは順序番号を
持っていることである。
:PNLGRP. :HELP NAME='5番目のヘルプ'. これは5番目のヘルプです。 :H1.順序リスト :P.順序リストは順序番号を持っています。 :OL. :LI.項目1 :LI.項目2 :LI.項目3 :EOL. :EHELP :EPNLGRP.
・単純リスト
単純リストは項目を並べただけで項目の先頭には記号は持たない。
:PNLGRP. :HELP NAME='6番目のヘルプ'. これは6番目のヘルプです。 :H1.単純リスト :P.単純リストの先頭には記号はありません。 :SL. :LI.項目1 :LI.項目2 :LI.項目3 :ESL. :EHELP :EPNLGRP.
・LINK/ELINK – リンク
リンクとは別のヘルプ・テキストへのリンクを示す。
HTMLのハイパー・テキスト・リンクと同じ働きをする。
:HELP NAME=LINK2. 受注の入力 :H1. パラグラフ :P. これは最初のパラグラフです。 :P. 別のパラグラフをここに入れます。 :EHELP. :HELP NAME=OPTION01. 受注の入力 . :H1. リンクのサンプル :P. リンク . サンプルを下に示します :LINK PERFORM='DSPHELP LINK2'. 別のリンク . :ELINK.. :LINK PERFORM='DSPHELP SECOND_UIM OTHER_UIM'.2 つめのリンク .. :ELINK.. :EHELP.
・この記事の原典は米国サイトのこちらからである。