show
show ステートメントは、フォームまたは Web ページを表示します。
このステートメントは、以下の種類のコードで有効です。
- メイン・テキスト UI プログラム
- メイン Web トランザクション・プログラム
- 呼び出し先 Web トランザクション・プログラム
- 前のいずれかの種類のプログラムによって呼び出されるライブラリー
さらに、ライブラリー内にある変数を使用してプログラム内で show ステートメントを使用できます。
show ステートメントは以下の影響を与えます。
- リカバリー可能リソースのコミット、ファイルのクローズ、およびロックの解除。
- プログラムが使用する基本レコードをプログラムに渡す (オプション)。使用する場合、 このレコードは、show ステートメント passing 文節に指定されます。
- 最初のプログラムの終了。
- テキスト書式または Web ページのいずれかの表示。
テキスト書式が表示される場合、このステートメントは常に据え置き転送 を実行します。ユーザーは、書式を送信して、新規プログラムまたはトランザクションを起動します。Web ページが表示される場合、据え置き転送はオプションです。 起動されるプログラム、または起動されたトランザクションの最初のプログラムは、 常にメインプログラムです。
構文

- formName
- プログラムに対して可視になっているテキスト書式の名前。 可視性について詳しくは、有効範囲を参照してください。このステートメントに returning 文節を含める場合、そのテキスト書式は、呼び出し先プログラムの inputForm プロパティーのテキスト書式と同じでなければなりません。
- VGUIRecordName
- プログラムに対して可視になっている UI レコードの名前。可視性について詳しくは、有効範囲を参照してください。このステートメントに returning to 文節を含める場合、その UI レコードは、呼び出し先プログラムの inputUIRecord プロパティーの UI レコードと同じでなければなりません。
- targetName
- ユーザーがテキスト書式または Web ページを送信した後に呼び出されるプログラムまたはトランザクションの ID 。 この名前は、 引用符なしのパーツ参照、引用符で囲んだリテラル文字列、定数、または sysVar.transferName か別の変数にすることができます。
- basicRecordName
- 基本レコードの名前。内容は、受け取り側プログラムの入力レコードに代入されます。
- properties
- 1 つプロパティーがサポートされます。そのプロパティーは、ターゲット・プラットフォームとして IMS/VS を使用するテキスト UI プログラムの場合にのみ意味があります。
- isExternal
- Boolean プロパティーです。
- NO (デフォルト) は、EGL 生成プログラムが据え置き転送のターゲットであることを示します。
- YES は、非 EGL 生成プログラムがターゲットであることを示します。
互換性
| プラットフォーム | 問題 |
|---|---|
| CICS® for z/OS® | EGL は、このステートメントを CICS START コマンドで実装し、そのコマンドの COMMAREA オプションを使用してレコードを渡します。 レコード・データは、CICS 共通域の最初のバイトから開始され、最大レコード長は 32763 です。 targetName は CICS トランザクション名を参照します。 show ステートメントは、非 EGL 生成プログラムに対する据え置き転送をサポートしていません。 |
| IBM® i | show ステートメントは、非 EGL 生成プログラムに対する据え置き転送をサポートしていません。 |
| IMS/VS | show ステートメントは、EGL 生成プログラムまたは非 EGL 生成プログラムに対する据え置き転送をサポートします。targetName は IMS™ トランザクション名を参照します。 EGL 生成プログラムとの関連で、以下の規則が適用されます。
EGL 生成でないターゲット・プログラムは、MFS を使用して、渡されたフォームを受け取らなければなりません。MFS マップ名は EGL フォーム名と同じでも構いません。 |
| IMS BMP | show ステートメントはサポートされていません。 |
| z/OS バッチ | show ステートメントはサポートされていません。 |
| Web トランザクション | show ステートメントは、メインまたは呼び出し先の Web トランザクションでサポートされます。 この場合、returning to 文節はオプションで、isExternal プロパティーは効果を持ちません。 |
| その他の Java™ 生成 | show ステートメントは、非 EGL 生成プログラムに対する据え置き転送をサポートしていません。 |