PANEL グループ

23. ヘルプ・パネル・グループの要約

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.                                                        

・この記事の原典は米国サイトのこちらからである。