メッセージ表示 (DSPMSG)

実行可能場所: すべての環境 (*ALL)
スレッド・セーフ: いいえ

メッセージ表示(DSPMSG)コマンドは，指定されたメッセージ待ち行列で受け取ったメッセージを表示するために，表示装置ユーザーによって使用されます。メッセージ待ち行列がこのコマンドの入力されるジョブにも，また他のどのジョブにも割り振られていない場合には，このコマンドの処理中，このコマンドによってメッセージ待ち行列が暗黙に割り振られます。メッセージが表示される時には，ユーザーが待ち行列から1つまたは複数のメッセージを除去したり，各照会メッセージに対する応答を入力したりできるオプションも表示されます。

注: 1つまたは1グループのメッセージ記述を印刷する方法については，IBM I INFORMATION CENTER (HTTP://WWW.IBM.COM/SYSTEMS/I/INFOCENTER/)の「システム操作の基本」カテゴリーにある「メッセージの処理」というタイトルを持つセクションを参照してください。

制約事項:

*EXCLロック状態で作動するALCOBJコマンドを指定することによって別のジョブがすでにメッセージ待ち行列を割り振っている時には，DSPMSGを指定することはできません。
メッセージ待ち行列が別のジョブに対して*BREAKまたは*NOTIFYモードになっている時には，ユーザーはDSPMSGコマンドを使ってジョブのメッセージを表示できますが，除去することはできません。
メッセージ待ち行列が別のジョブに対して*BREAKモードになっている時には，ユーザーが照会メッセージに応答できるかどうかは，メッセージ待ち行列の中断処理プログラムによって決まります。PGM(*DSPMSG)が指定されている場合には，ユーザーは照会メッセージに応答できますが，PGM(ユーザー・プログラム)が指定されている場合には，照会メッセージに応答できません。
複数のジョブが同じ照会メッセージを表示し，すべてのジョブがそのメッセージに応答した場合には，そのメッセージに対する最初の応答のみが有効となります。他のジョブから後続の応答があると，エラー・メッセージが出されます。

上

パラメーター

キーワード	記述	選択項目	ノーツ
MSGQ	MSG 待ち行列	単一値: WRKUSR, SYSOPR, USRPRF, WRKSTN その他の値: 修飾オブジェクト名	オプショナル, 定位置 1
	修飾子 1: MSG 待ち行列	名前
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB
OUTPUT	出力	, PRINT, *PRTWRAP	オプショナル
MSGTYPE	MSG タイプ	ALL, INFO, INQ, COPY	オプショナル
START	最初に表示するメッセージ	LAST, FIRST	オプショナル
SEV	重大度コード・フィルター	0-99, 0, *MSGQ	オプショナル
ASTLVL	援助レベル	PRV, USRPRF, BASIC, INTERMED	オプショナル

上

MSG 待ち行列 (MSGQ)

表示されるメッセージが入っているメッセージ待ち行列を指定します。

注:このパラメーターに特殊値*WRKSTN, *WRKUSR, *USRPRF,および*SYSOPRを指定する必要があるのは，対話式ジョブを行っている時だけです。

単一値

*WRKUSR: ワークステーションのメッセージ待ち行列にメッセージがある場合は，メッセージはそこから示されます。ユーザーがその画面を終了した後に，現行ユーザーのユーザー・プロファイル・メッセージ待ち行列からメッセージが示されます。ワークステーションのメッセージ待ち行列にメッセージがない場合は，ユーザー・プロファイル・メッセージ待ち行列からのメッセージだけが示されます。
*SYSOPR: システム操作員メッセージ待ち行列(QSYSOPR)からのメッセージが表示されます。
*WRKSTN: メッセージは，ワークステーション自体のメッセージ待ち行列から示されます。
*USRPRF: 現行のユーザー・プロファイル・メッセージ待ち行列からのメッセージが表示されます。

修飾子1: MSG 待ち行列

メッセージ待ち行列名: 表示されるメッセージが入っているメッセージ待ち行列の名前を指定してください。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: 最初に一致するものが見つかるまで，現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。

*CURLIB: メッセージ待ち行列を見つけるために，ジョブの現行ライブラリーが使用されます。ライブラリー・リストに現行ライブラリー項目が存在しない場合には，QGPLが使用されます。
ライブラリー名: メッセージ待ち行列が入っているライブラリーを指定してください。

上

出力 (OUTPUT)

コマンドからの出力を，要求元のワークステーションに表示するか，あるいはジョブのスプール出力で印刷するかを指定します。

*: 出力は表示される（対話式ジョブによって要求された場合）か，あるいはジョブのスプール出力で印刷されます（バッチ・ジョブによって要求された場合）。即時メッセージは長さを512バイトとすることができます。

*PRINT: 出力はジョブのスプール出力で印刷されます。

各メッセージごとに1行のメッセージ・テキストだけが印刷されます。これは，第1レベル・メッセージ・テキストの最初の105バイトになります。

*PRTWRAP: 出力はジョブのスプール出力で印刷されます。メッセージが1行に収まらない場合には，第1レベル・メッセージ・テキストの最大512バイトまでを収容できるように追加の行が印刷されます。

出力が印刷される時には，各メッセージごとに2行以上が印刷されます。最後の行には，次の情報が含まれます。

メッセージを送ったジョブの修飾ジョブ名。これは次の3つのフィールドから構成されます。
- ジョブ名
- ユーザー名
- ジョブ番号
メッセージを送ったプログラムの名前。
メッセージを送ったプログラム内の命令番号。非プログラム・メッセージ待ち行列の場合には，これは常にゼロです。
メッセージが送られた日付および時刻。
メッセージが送られた時にスレッドが実行されていたユーザー・プロファイルの名前。

上

MSG タイプ (MSGTYPE)

表示されるメッセージ待ち行列中のメッセージのタイプを指定します。

*ALL: メッセージ待ち行列中のすべてのメッセージが表示されます。
*INFO: 通知メッセージ（応答を必要としないもの）だけが示されます。
*INQ: 照会メッセージ（応答を必要とするもの）だけが示されます。
*COPY: 他のメッセージ待ち行列に送られ，なお応答を必要とした照会メッセージのコピーが示されます。

上

最初に表示するメッセージ (START)

最初に示されるのは，メッセージ待ち行列の中の最も新しいメッセージか最も古いメッセージかを指定します。表示装置ユーザーは，メッセージ・リストが1画面に収まらない場合には，PAGE UP（前ページ）キーまたはPAGE DOWN（次ページ）キーを使用して，他のメッセージを表示できます。出力がスプール印刷出力ファイルに送られる場合には，このパラメーターは無視されます。

*LAST: 中間ビュー（メッセージの表示）が表示される場合には，メッセージ待ち行列上の最後の（最も新しい）メッセージが画面の最下行に表示されます。表示装置ユーザーはPAGE UP（前ページ）キーを押してより古いメッセージを表示することができます。
基本ビュー（メッセージの処理）が表示される場合には，MSGQ上の最後の（最も新しい）メッセージが画面の最上行に表示されます。表示装置ユーザーはPAGE DOWN（次ページ）キーを押してより古いメッセージを表示することができます。
*FIRST: 中間ビュー（メッセージの表示）が表示される場合には，メッセージ待ち行列上の最初の（最も古い）メッセージが画面の最上行に表示されます。表示装置ユーザーはPAGE DOWN（次ページ）キーを押してより新しいメッセージを表示することができます。
基本ビュー（メッセージの処理）が表示される場合には，メッセージ待ち行列上の最初の（最も古い）メッセージが画面の最後に表示されます。表示装置ユーザーはPAGE UP（前ページ）キーを押してより新しいメッセージを表示することができます。

上

重大度コード・フィルター (SEV)

メッセージがもっている，中断または通知モードでユーザーに配布される最低の重大度レベルを指定します。ここで指定された重大度レベルより低い重大度レベルをもつメッセージがメッセージ待ち行列に到着した場合には，ジョブは中断されず，メッセージ待機中ライトはオンになりません。このようなメッセージはメッセージ表示(DSPMSG)コマンドによって表示されるまで，待ち行列に保留されます。

00: 指定されたメッセージ待ち行列中のすべてのメッセージが表示されます。
*MSGQ: メッセージ待ち行列に指定された重大度コードより大きいか等しい重大度コードを持つすべてのメッセージが表示されます。
重大度コード: メッセージが持つことができ，しかも示され得る最低の重大度コードを指定する00から99の範囲の値を指定します。

上