CICS アプリケーション・プログラミング・リファ …端末装置または論理装置との会話(CONVERSE) .....638 非同期割り込みの送信(ISSUE SIGNAL).....638

CICS® Transaction Server for OS/390®

CICS アプリケーション・プログラミング・リファレンス

リリース 3

SC88-7690-03

(英文原典：SC33-1688-33)

��

ご注意本書の情報およびそれによってサポートされる製品を使用する前に、xiページの『特記事項』に記載する一般情報をお読みください。

本書は、CICS Transaction Server for OS/390 (プログラム番号 5655-147) のリリース 3 に適用されます。また、新版で特に提示のないかぎり、その後のすべてのバージョン、リリース、および修正レベルにも適用されます。製品のレベルに適した版を使用していることを確認してください。

本書は、前の版である SC88-7690-02 に代わるものです。変更個所の左側には、# が示されています。左マージンの縦線は、CICS Transaction Server for OS/390 バージョン 1 リリース 2 とバージョン 1 リリース 3 の間の変更です。

本マニュアルに関するご意見やご感想は、次の URL からお送りください。今後の参考にさせていただきます。

http://www.ibm.com/jp/manuals/main/mail.html

なお、日本 IBM 発行のマニュアルはインターネット経由でもご購入いただけます。詳しくは

http://www.ibm.com/jp/manuals/ の「ご注文について」をご覧ください。

(URL は、変更になる場合があります)

　原　典： SC33-1688-33CICS® Transaction Server for OS/390®

CICS Application Programming Reference

Release 3

　発　行：日本アイ・ビー・エム株式会社

　担　当：ナショナル・ランゲージ・サポート

第1刷 2001.1

この文書では、平成明朝体™W3、平成明朝体™W9、平成角ゴシック体™W3、平成角ゴシック体™W5、および平成角ゴシック体™W7を使用しています。この (書体*) は、(財) 日本規格協会と使用契約を締結し使用しているものです。フォントとして無断複製することは禁止されています。

注* 平成明朝体™W3、平成明朝体™W9、平成角ゴシック体™W3、平成角ゴシック体™W5、平成角ゴシック体™W7

© Copyright International Business Machines Corporation 1989, 2000. All rights reserved.

Translation: © Copyright IBM Japan 2001

目次

特記事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiプログラミング・インターフェース情報 . . . . . . . . . . . . . . . . . . . . . . . . xii商標 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

まえがき . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii本書について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii本書の対象読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii前提事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii本書の使用方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii本書で扱っていない事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

参考文献 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvCICS Transaction Server for OS/390 . . . . . . . . . . . . . . . . . . . . . . . . . . xv

CICS Transaction Server for OS/390 用の CICS 資料 . . . . . . . . . . . . . . . . . . xvCICS Transaction Server for OS/390 用の CICSPlex SM 資料 . . . . . . . . . . . . . . . xviその他の CICS 資料 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

関連ライブラリーの資料 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviMVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviIMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiシステム・ネットワーク体系 . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiシステム・アプリケーション体系 . . . . . . . . . . . . . . . . . . . . . . . . . xviiSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiその他の関連資料 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

資料が最新のものかどうかの判別 . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

変更の要約. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xixCICS Transaction Server for OS/390 リリース 3 第 3 版における変更 . . . . . . . . . . . . . xixCICS Transaction Server for OS/390 リリース 2 . . . . . . . . . . . . . . . . . . . . . xixCICS Transaction Server for OS/390 リリース 1 . . . . . . . . . . . . . . . . . . . . . xx

CICS API コマンド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Command 形式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1本書で使用する CICS 構文表記法 . . . . . . . . . . . . . . . . . . . . . . . . . . . 2引き数値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Data-areas および Data-values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3COBOL 引き数値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3C 引き数値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4PL/I 引き数値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5アセンブラー言語引き数値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

制約事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8CICS 値データ域 (cvda) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8LENGTH オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9NOHANDLE オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9RESP および RESP2 オプション . . . . . . . . . . . . . . . . . . . . . . . . . . . 9ABEND AICA タイムアウトの危険 . . . . . . . . . . . . . . . . . . . . . . . . . . 10JES に対する CICS インターフェース . . . . . . . . . . . . . . . . . . . . . . . . . 11CICS の JES とのインターフェースの使用 . . . . . . . . . . . . . . . . . . . . . . . 13入力 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13JES 出口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

© Copyright IBM Corp. 1989, 2000 iii

出力 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14機能別コマンド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15異常終了サポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15APPC 基本会話 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15APPC マップ式会話. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15認証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15バッチ・データ交換. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16BMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16組み込み関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16コンソール・サポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16診断サービス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16文書サービス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16環境サービス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16例外サポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17ファイル制御 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17インターバル制御 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17ジャーナル処理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17モニター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17名前付きカウンター・サーバー . . . . . . . . . . . . . . . . . . . . . . . . . . 17プログラム制御 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18スケジューリング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18セキュリティー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18スプール・インターフェース (JES) . . . . . . . . . . . . . . . . . . . . . . . . . 18ストレージ制御 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18同期点. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18タスク制御 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18TCP/IP サービス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19一時記憶域制御 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19端末管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19一時データ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Web サービス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

ABEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22ADDRESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23ADDRESS SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25ALLOCATE (APPC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26ALLOCATE (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29ALLOCATE (MRO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31ASKTIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33ASSIGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34BIF DEEDIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48BUILD ATTACH (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . 50BUILD ATTACH (MRO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53CANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56CHANGE PASSWORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58CHANGE TASK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60CONNECT PROCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61CONVERSE (VTAM デフォルト) . . . . . . . . . . . . . . . . . . . . . . . . . . . 64CONVERSE (APPC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65CONVERSE (LUTYPE2/LUTYPE3) . . . . . . . . . . . . . . . . . . . . . . . . . . 66CONVERSE (LUTYPE4) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67CONVERSE (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68CONVERSE (SCS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

iv CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

CONVERSE (3270 論理装置) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70CONVERSE (3600-3601) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71CONVERSE (3600-3614) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72CONVERSE (3650 インタープリター) . . . . . . . . . . . . . . . . . . . . . . . . . 73CONVERSE (3650-3270) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74CONVERSE (3650-3653) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75CONVERSE (3650-3680) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76CONVERSE (3767) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77CONVERSE (3770) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78CONVERSE (3790 全機能または照会) . . . . . . . . . . . . . . . . . . . . . . . . . 79CONVERSE (3790 3270 ディスプレイ). . . . . . . . . . . . . . . . . . . . . . . . . 80CONVERSE (非 VTAM デフォルト) . . . . . . . . . . . . . . . . . . . . . . . . . 86CONVERSE (MRO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87CONVERSE (システム/3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88CONVERSE (システム/7) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89CONVERSE (2260) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91CONVERSE (2741) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92CONVERSE (2770) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94CONVERSE (2780) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95CONVERSE (3270 ディスプレイ) . . . . . . . . . . . . . . . . . . . . . . . . . . . 96CONVERSE (3600 BTAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97CONVERSE (3735) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99CONVERSE (3740) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100DEFINE COUNTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105DELAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111DELETE COUNTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119DELETEQ TD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121DELETEQ TS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123DEQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125DOCUMENT CREATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127DOCUMENT INSERT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131DOCUMENT RETRIEVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134DOCUMENT SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136DUMP TRANSACTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139ENDBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144ENQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146ENTER TRACENUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150EXTRACT ATTACH (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . 152EXTRACT ATTACH (MRO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156EXTRACT ATTRIBUTES (APPC) . . . . . . . . . . . . . . . . . . . . . . . . . . 160EXTRACT ATTRIBUTES (MRO) . . . . . . . . . . . . . . . . . . . . . . . . . . 162EXTRACT CERTIFICATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164EXTRACT LOGONMSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167EXTRACT PROCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169EXTRACT TCPIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171EXTRACT TCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174FORMATTIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175FREE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179FREE (APPC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180FREE (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182FREE (MRO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

目次 v

||

||

||||||||

||

||

FREEMAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185GDS ALLOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189GDS ASSIGN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192GDS CONNECT PROCESS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193GDS EXTRACT ATTRIBUTES . . . . . . . . . . . . . . . . . . . . . . . . . . . 196GDS EXTRACT PROCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198GDS FREE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200GDS ISSUE ABEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202GDS ISSUE CONFIRMATION . . . . . . . . . . . . . . . . . . . . . . . . . . . 204GDS ISSUE ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206GDS ISSUE PREPARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208GDS ISSUE SIGNAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210GDS RECEIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212GDS SEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214GDS WAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217GET COUNTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219GETMAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224HANDLE ABEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229HANDLE AID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231HANDLE CONDITION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233IGNORE CONDITION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235ISSUE ABEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236ISSUE ABORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238ISSUE ADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240ISSUE CONFIRMATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242ISSUE COPY (3270 ディスプレイ) . . . . . . . . . . . . . . . . . . . . . . . . . . 244ISSUE COPY (3270 論理装置) . . . . . . . . . . . . . . . . . . . . . . . . . . . 245ISSUE DISCONNECT (デフォルト) . . . . . . . . . . . . . . . . . . . . . . . . . 246ISSUE DISCONNECT (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . 248ISSUE END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249ISSUE ENDFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251ISSUE ENDOUTPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252ISSUE EODS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253ISSUE ERASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254ISSUE ERASEAUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256ISSUE ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258ISSUE LOAD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260ISSUE NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261ISSUE PASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263ISSUE PREPARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265ISSUE PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267ISSUE QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269ISSUE RECEIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271ISSUE REPLACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273ISSUE RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276ISSUE SEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277ISSUE SIGNAL (APPC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280ISSUE SIGNAL (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282ISSUE WAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283JOURNAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285LINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293

vi CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

||

MONITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296POINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299POP HANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300POST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301PURGE MESSAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305PUSH HANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306QUERY COUNTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307QUERY SECURITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311READ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314READNEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325READPREV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336READQ TD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346READQ TS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350RECEIVE (VTAM デフォルト) . . . . . . . . . . . . . . . . . . . . . . . . . . . 353RECEIVE (APPC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354RECEIVE (LUTYPE2/LUTYPE3) . . . . . . . . . . . . . . . . . . . . . . . . . . . 355RECEIVE (LUTYPE4). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356RECEIVE (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357RECEIVE (3270 論理装置) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358RECEIVE (3600 パイプライン) . . . . . . . . . . . . . . . . . . . . . . . . . . . 359RECEIVE (3600-3601). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360RECEIVE (3600-3614). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361RECEIVE (3650) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362RECEIVE (3767) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363RECEIVE (3770) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364RECEIVE (3790 全機能または照会) . . . . . . . . . . . . . . . . . . . . . . . . . 365RECEIVE (非 VTAM デフォルト) . . . . . . . . . . . . . . . . . . . . . . . . . . 369RECEIVE (MRO) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370RECEIVE (システム/3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371RECEIVE (システム/7) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372RECEIVE (2260) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373RECEIVE (2741) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374RECEIVE (2980) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375RECEIVE (3270 ディスプレイ) . . . . . . . . . . . . . . . . . . . . . . . . . . . 378RECEIVE (3600 BTAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379RECEIVE (3735) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380RECEIVE (3740) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381RECEIVE (3790 3270 ディスプレイ) . . . . . . . . . . . . . . . . . . . . . . . . . 382RECEIVE MAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386RECEIVE MAP MAPPINGDEV . . . . . . . . . . . . . . . . . . . . . . . . . . . 390RECEIVE PARTN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393RELEASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396RESETBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398RETRIEVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402RETURN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406REWIND COUNTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409REWRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412ROUTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417SEND (VTAM デフォルト) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422SEND (APPC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423SEND (LUTYPE2/LUTYPE3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424SEND (LUTYPE4) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

目次 vii

||

||

||

SEND (LUTYPE6.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426SEND (SCS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427SEND (3270 論理装置) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428SEND (3600 パイプライン) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429SEND (3600-3601) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430SEND (3600-3614) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431SEND (3650 インタープリター) . . . . . . . . . . . . . . . . . . . . . . . . . . . 432SEND (3650-3270) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433SEND (3650-3653) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434SEND (3650-3680) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435SEND (3767) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436SEND (3770) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437SEND (3790 全機能または照会) . . . . . . . . . . . . . . . . . . . . . . . . . . . 438SEND (3790 SCS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439SEND (3790 3270 ディスプレイ) . . . . . . . . . . . . . . . . . . . . . . . . . . 440SEND (3790 3270 プリンター) . . . . . . . . . . . . . . . . . . . . . . . . . . . 441SEND (非 VTAM デフォルト) . . . . . . . . . . . . . . . . . . . . . . . . . . . 445SEND (MRO). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446SEND (システム/3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447SEND (システム/7) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448SEND (2260) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449SEND (2741) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450SEND (2980) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451SEND (3270 ディスプレイ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452SEND (3600 BTAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453SEND (3735) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454SEND (3740) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455SEND CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459SEND MAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464SEND MAP MAPPINGDEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472SEND PAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475SEND PARTNSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479SEND TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480SEND TEXT MAPPED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487SEND TEXT NOEDIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489SIGNOFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493SIGNON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494SPOOLCLOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498SPOOLOPEN INPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500SPOOLOPEN OUTPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503SPOOLREAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508SPOOLWRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511START . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514START ATTACH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523START BREXIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525STARTBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528SUSPEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534SYNCPOINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535SYNCPOINT ROLLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536UNLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537UPDATE COUNTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541VERIFY PASSWORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544

viii CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

||

||||

||

WAIT CONVID (APPC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547WAIT EVENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549WAIT EXTERNAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551WAIT JOURNALNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554WAIT JOURNALNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556WAIT SIGNAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557WAIT TERMINAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558WAITCICS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559WEB ENDBROWSE FORMFIELD . . . . . . . . . . . . . . . . . . . . . . . . . . 562WEB ENDBROWSE HTTPHEADER . . . . . . . . . . . . . . . . . . . . . . . . . 563WEB EXTRACT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564WEB READ FORMFIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566WEB READ HTTPHEADER . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568WEB READNEXT FORMFIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . 569WEB READNEXT HTTPHEADER . . . . . . . . . . . . . . . . . . . . . . . . . . 571WEB RECEIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573WEB RETRIEVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575WEB SEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576WEB STARTBROWSE FORMFIELD . . . . . . . . . . . . . . . . . . . . . . . . . 578WEB STARTBROWSE HTTPHEADER . . . . . . . . . . . . . . . . . . . . . . . . 580WEB WRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581WRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582WRITE JOURNALNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589WRITE JOURNALNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593WRITE OPERATOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594WRITEQ TD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597WRITEQ TS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600XCTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

付録A. EXEC インターフェース・ブロック . . . . . . . . . . . . . . . . . . . . . . 607EIB フィールド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

付録B. ASSIGN によって戻されるコード . . . . . . . . . . . . . . . . . . . . . . . 627ASSIGN TERMCODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627ASSIGN FCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628

付録C. CICS コマンドの変換コード . . . . . . . . . . . . . . . . . . . . . . . . . 629COBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629

‘新しい’ COBOL CALL 構文の使用 . . . . . . . . . . . . . . . . . . . . . . . . 629サンプル集 DFHEIBLC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630

C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630PL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630アセンブラー言語 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631

DFHECALL マクロ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631動的ストレージの拡張 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633複数の基底レジスター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634

付録D. 端末管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637端末装置と論理装置に使用するコマンドおよびオプション . . . . . . . . . . . . . . . . . 637フルワードの長さ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637端末装置または論理装置からの読み取り (RECEIVE) . . . . . . . . . . . . . . . . . . 637端末装置または論理装置への書き込み (SEND) . . . . . . . . . . . . . . . . . . . . 638トランザクションの端末 I/O の同期化 (WAIT TERMINAL) . . . . . . . . . . . . . . . 638

目次 ix

||||||||||||||||||||||||||

端末装置または論理装置との会話 (CONVERSE) . . . . . . . . . . . . . . . . . . . . 638非同期割り込みの送信 (ISSUE SIGNAL). . . . . . . . . . . . . . . . . . . . . . . 638交換回線の切断 (ISSUE DISCONNECT) . . . . . . . . . . . . . . . . . . . . . . . 639

TCAM でサポートされる端末装置および論理装置 . . . . . . . . . . . . . . . . . . . . 639BTAM プログラム式端末 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639テレタイプライターのプログラミング . . . . . . . . . . . . . . . . . . . . . . . . 641メッセージ形式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641メッセージ長 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641VTAM を介しての接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642

ディスプレイ装置の操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642表示情報の印刷 (ISSUE PRINT) . . . . . . . . . . . . . . . . . . . . . . . . . . 642表示情報のコピー (ISSUE COPY) . . . . . . . . . . . . . . . . . . . . . . . . . 643すべての無保護フィールドの消去 (ISSUE ERASEAUP) . . . . . . . . . . . . . . . . . 643データを伴わない入力の処理 (RECEIVE) . . . . . . . . . . . . . . . . . . . . . . 643

付録E. SAA リソース・リカバリー . . . . . . . . . . . . . . . . . . . . . . . . . 645SRRCMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645SRRBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645

付録F. 共通プログラミング・インターフェース・コミュニケーション (CPI コミュニケーション) 647CPI コミュニケーション言語インターフェース . . . . . . . . . . . . . . . . . . . . . 647

付録G. 分散プログラム・リンクの API 制限 . . . . . . . . . . . . . . . . . . . . . . 649制限付き API コマンドの要約 . . . . . . . . . . . . . . . . . . . . . . . . . . . 649API コマンドのリスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

付録H. CVDA 数値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657

付録I. 各国語コード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661

付録J. BMS 関連定数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663磁気スロット読取装置 (MSR) 制御値の定数、DFHMSRCA . . . . . . . . . . . . . . . . . 667MSR 制御バイト値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667アテンション ID 定数、DFHAID . . . . . . . . . . . . . . . . . . . . . . . . . . 668

付録K. BMS マクロの要約 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669マップ・セット、マップ、およびフィールド定義 . . . . . . . . . . . . . . . . . . . . 669

ADS 記述子 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669マップ・セット定義マクロ (DFHMSD) . . . . . . . . . . . . . . . . . . . . . . . 669マップ定義マクロ (DFHMDI) . . . . . . . . . . . . . . . . . . . . . . . . . . . 670フィールド定義マクロ (DFHMDF) . . . . . . . . . . . . . . . . . . . . . . . . . 670マップ・セット定義の終了 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670

区画セット定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670区画セット定義マクロ (DFHPSD) . . . . . . . . . . . . . . . . . . . . . . . . . 670区画定義マクロ (DFHPDI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670区画セット定義の終了 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670フィールド・グループ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671

DFHMDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672DFHMDI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683DFHMSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693DFHPDI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704DFHPSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706

索引 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707

x CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

特記事項

本書において、日本では発表されていない IBM 製品 (機械およびプログラム)、プログラミングまたはサービスについて言及または説明する場合があります。しかし、このことは、弊社がこのような IBM 製品、プログラミングまたはサービスを、日本で発表する意図があることを必ずしも示すものではありません。本書でIBM ライセンス・プログラムまたは他の IBM 製品に言及している部分があっても、このことは当該プログラムまたは製品のみが使用可能であることを意味するものではありません。IBM 製品、プログラム、またはサービスに代えて、IBM の有効な知的所有権またはその他の法的に保護された権利を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBMによって明示的に指定されたものを除き、他社の製品と組み合わせた場合の操作の評価と検証はお客様の責任で行っていただきます。

IBM は、本書で解説されている主題について特許権 (特許出願を含む)、商標権、または著作権を所有している場合があります。本書の提供は、これらの特許権、商標権、および著作権について、本書で明示されている場合を除き、実施権、使用権等を許諾することを意味するものではありません。実施権、使用権等の許諾については、下記の宛先に、書面にてご照会ください。

〒106-0032 東京都港区六本木 3 丁目 2-31AP 事業所IBM World Trade Asia Corporation

Intellectual Property Law & Licensing

以下の保証は、国または地域の法律に沿わない場合は、適用されません。

IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。

本書に対して、周期的に変更が行われ、これらの変更は、文書の次版に組み込まれます。IBM は、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。

本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプログラム (本プログラムを含む) との間での情報交換、および (ii) 交換された情報の相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする方は、下記に連絡してください。

IBM United Kingdom Laboratories, MP151,

Hursley Park, Winchester, Hampshire,

England, SO21 2JN

本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。

本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBMより提供されます。

© Copyright IBM Corp. 1989, 2000 xi

プログラミング・インターフェース情報本書の目的は、ユーザーが CICS のサービスを獲得する EXEC CICS コマンドを使用してアプリケーション・プログラムを作成する、手助けをすることです。

本書は、CICS 提供の汎用プログラミング・インターフェースとその関連情報について説明しています。

商標以下は、IBM Corporation の、米国およびその他の国における商標です。

AFP DB2 MVS/ESABookManager DFSMS RACFCICS DFSMS/MVS System/370CICS/ESA IBM VTAMDATABASE 2 IMS

Java およびすべての Java 関連の商標およびロゴは、Sun Microsystems, Inc の米国およびその他の国における商標または登録商標です。

他の会社名、製品名およびサービス名等はそれぞれ各社の商標または登録商標です。

xii CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

まえがき

本書について本書は、CICS Transaction Server for OS/390 EXEC アプリケーション・プログラミング・インターフェースについて記述したものです。EXEC CICS コマンドを使用し、CICS のもとで実行されるCOBOL、C、PL/I、アセンブラー言語アプリケーション・プログラムの作成に必要な参照情報を記載しています。ガイダンス情報は、「CICS アプリケーション・プログラミング・ガイド」に記載されています。 CICS アプリケーションのデバッグについては、「CICS Problem Determination Guide」を参照してください。

本書の対象読者本書は、主としてアプリケーション・プログラマーの方にご利用いただくことを目的としていますが、システム・プログラマーやシステム分析者の方にもご利用いただけます。

前提事項本書は、読者の方々が、COBOL、C、PL/I、または S370 アセンブラー言語でのプログラム作成をある程度経験していることを前提としています。「CICS アプリケーション・プログラミング入門書 (VS COBOLII)」および「CICS アプリケーション・プログラミング・ガイド」は、読者が本書で説明するコマンドを使用して CICS アプリケーションを設計および作成する際の手助けをします。

本書の使用方法本書は、参照用です。各コマンドは基本的に以下の形式で説明されています。v コマンドの構文v コマンドの機能の説明v オプションとその機能のアルファベット順リストv コマンド実行中に発生する状態とその原因のアルファベット順リスト

本書で扱っていない事項本書では、システム・プログラミングのための EXEC CICS コマンド、すなわち、COLLECT、CREATE、DISABLE、ENABLE、INQUIRE、PERFORM、RESYNC、および SET の各コマンドは扱っていません。これらのコマンドについては、「CICS System Programming Reference」を参照してください。

本書では、CICS フロントエンド・プログラミング・インターフェース機能とともに使用可能な EXECCICS FEPI コマンドについては説明していませんが、「CICS/ESA FEPI 使用者の手引き」で説明しています。

本書では、CICS ビジネス・トランザクション・サービス (BTS) とともに使用可能な EXEC CICS コマンドは扱いません。これらのコマンドについては、「CICS Business Transaction Services」で完全に説明しています。

本書では、CICS C⁺⁺ OO プログラミング・インターフェースは扱いません。これについては、「CICSC++ OO Class Libraries」で定義しています。

© Copyright IBM Corp. 1989, 2000 xiii

|

|

|

|

|

ここでは、CICS Java® プログラミング・インターフェースは扱いません。これについては、/usr/lpp/cicsts/cicsts13 ディレクトリーにある、OS/390 UNIX システム・サービス HFS のdfjcics_docs.zip で提供する Javadoc HTML で定義しています。

xiv CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

|

|

|

参考文献

CICS Transaction Server for OS/390

CICS Transaction Server for OS/390: Transaction Server の計画と導入の手引き GC88-7696CICS Transaction Server for OS/390 リリース・ガイド GD88-7202CICS Transaction Server for OS/390 CICS マイグレーション・ガイド GD88-7203CICS Transaction Server for OS/390 インストール・ガイド GC88-7685CICS Transaction Server for OS/390 Program Directory GI10-2506CICS Transaction Server for OS/390 Licensed Program Specification GC33-1707

CICS Transaction Server for OS/390 用の CICS 資料

概説CICS Master Index SC33-1704CICS User’s Handbook SX33-6104CICS Transaction Server for OS/390 Glossary (ソフトコピーのみ) GC33-1705

管理CICS System Definition Guide SC33-1682CICS カスタマイズ・ガイド SC88-7686CICS リソース定義ガイド SC88-7687CICS 操作およびユーティリティー・ガイド SC88-7688CICS Supplied Transactions SC33-1686

プログラミングCICS アプリケーション・プログラミング・ガイド SC88-7689CICS アプリケーション・プログラミング・リファレンス SC88-7690CICS System Programming Reference SC33-1689CICS FEPI 使用者の手引き SC88-7692CICS C++ OO Class Libraries SC34-5455CICS 分散トランザクション・プログラミングの手引き SC88-7691CICS Business Transaction Services SC34-5268

診断CICS Problem Determination Guide GC33-1693CICS メッセージおよびコード GC88-7693CICS Diagnosis Reference LY33-6088CICS Data Areas LY33-6089CICS Trace Entries SC34-5446CICS Supplementary Data Areas LY33-6090

通信CICS 相互通信ガイド SC88-7694CICS ファミリープロダクト間相互通信 SC88-7260CICS ファミリーシステム/390 CICS からの通信 SD88-7242CICS 外部インターフェース・ガイド SD88-7026CICS インターネットの手引き SD88-7164

特別のトピックCICS 回復および再始動の手引き SC88-7695CICS Performance Guide SC33-1699CICS IMS Database Control Guide SC33-1700CICS RACF Security Guide SC33-1701CICS Shared Data Tables Guide SC33-1702CICS Transaction Affinities Utility Guide SC33-1777CICS DB2 ガイド SC88-7035

© Copyright IBM Corp. 1989, 2000 xv

CICS Transaction Server for OS/390 用の CICSPlex SM 資料

概説CICSPlex SM Master Index SC33-1812CICSPlex SM Concepts and Planning GC33-0786CICSPlex SM User Interface Guide SC33-0788CICSPlex SM Web User Interface Guide SC34-5403CICSPlex SM View Commands Reference Summary SX33-6099

監督官庁および管理CICSPlex SM Administration SC34-5401CICSPlex SM Operations Views Reference SC33-0789CICSPlex SM Monitor Views Reference SC34-5402CICSPlex SM Managing Workloads SC33-1807CICSPlex SM Managing Resource Usage SC33-1808CICSPlex SM Managing Business Applications SC33-1809

プログラミングCICSPlex SM Application Programming Guide SC34-5457CICSPlex SM Application Programming Reference SC34-5458

診断CICSPlex SM Resource Tables Reference SC33-1220CICSPlex SM Messages and Codes GC33-0790CICSPlex SM Problem Determination GC33-0791

その他の CICS 資料

CICS アプリケーション・プログラミング入門書 (VS COBOL II) SC88-7135CICS Application Migration Aid Guide SC33-0768CICS ファミリー API の構成 SC88-7261CICS ファミリークライアント・サーバープログラミング SC88-7429CICS Family: General Information GC33-0155CICS 4.1 Sample Applications Guide SC33-1173CICS/ESA 3.3 XRF Guide SC33-0661

CICS Transaction Server for OS/390 ライブラリーについて質問がある場合には、ハードコピー資料とソフトコピー資料の両方に関する説明と、その注文方法が記載されている「CICS Transaction Server forOS/390: Transaction Server の計画と導入の手引き」を参照してください。

関連ライブラリーの資料

MVS以下の資料を参照してください。

OS/390 MVS Initialization and Tuning Guide

OS/390 MVS Initialization and Tuning Reference

OS/390 MVS JCL User’s Guide

OS/390 MVS System Commands

xvi CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

IMSIMS の情報については、以下の資料を参照してください。CICS-DL/I インターフェースを使用する場合には、以下のいずれかの IMS 資料を参照してください。

IMS/VS V2 CICS/OS/VS 使用者のためのアプリケーション・プログラミング (N:SC26-4177)IMS アプリケーション・プログラミング : 設計の手引き (N:SC26-4279)IMS アプリケーション・プログラミング : EXEC DLI コマンド (N:SC26-4280)IMS アプリケーション・プログラミング : DL/I 呼び出し (N:SC26-4274)

これらの資料は、CICS ユーザーのための IMS アプリケーション・プログラミング情報を記載しており、DL/I インターフェース・ブロック (DIB) で EXEC DLI インターフェースか DL/I CALL インターフェースを使用して、オンライン・プログラムまたはバッチ・プログラムを作成する方法を述べています。

注: EXEC DLI インターフェースは、「CICS アプリケーション・プログラミング・リファレンス」から除かれました。

システム・ネットワーク体系システム・ネットワーク体系 (SNA) の詳細については、以下の SNA 資料を参照してください。

Sessions between Logical Units (GC20-1868)

システム・アプリケーション体系システム・アプリケーション体系 (SAA) の詳細については、以下の SAA 資料を参照してください。システム・アプリケーション体系共通プログラミング・インターフェースコミュニケーション・インターフェース解説書 (N:SC26-4399)

SQLCICS アプリケーション・プログラムでの SQL 実行については、以下の資料を参照してください。

IBM DATABASE 2 Application Programming Guide for CICS Users (SC26-4080)

IBM DATABASE 2 Reference (SC26-4078)

その他の関連資料必要に応じて、以下の IBM 資料を参照することができます。

Distributed Processing Programming Executive/Distributed Presentation Services (DPPX/DPS) :

DPPX/Distributed Presentation Services Version 2 System Programming Guide (SC33-0117)

OS/VS COBOL コンパイラーおよびライブラリープログラマーの手引き (N:SC28-6483)

VS COBOL II アプリケーション・プログラミングの手引き (SC88-7146)

OS PL/I V2 プログラミングの手引き (N:SC26-4307)

3270 情報表示システム入門 (N:GA27-2739)

3274 Control Unit Reference Summary (GX20-1878)

Component Description: IBM 2721 Portable Audio Terminal (GA27-3029)

IBM 2780 Data Transmission Terminal Component Description (GA27-3035)

参考文献 xvii

CICS/ESE 3.3 IBM 3270 Data Stream Device Guide (SC33-0232)

IBM 3270 Data Stream Programmer’s Reference (GA23-0059)

IBM 4700/3600/3630 Guide (SC33-0233)

資料が最新のものかどうかの判別IBM では、新規情報や変更情報により、定期的に資料を更新しています。新規の出版では、通常、ハードコピー版と BookManager ソフトコピー版が同時に出されます。ただし、ハードコピーの資料の印刷と配布に時間が必要であるために、BookManager 版の方が発行直前の変更を反映させやすいと言えます。

以降の更新については、おそらくソフトコピーの方がハードコピーより先に使用できます。これは、リリースが使用可能になってからは、いつでも、ソフトコピーを最新と見なすべきであることを意味します。

CICS トランザクション・サーバー関連資料のソフトコピー更新は、「Transaction Processing and DataCollection Kit CD-ROM」(SK2T-0730-xx) で定期的に提供されます。この CD-ROM は、発行ごとに資料番号の接尾部 (-XX の部分) が大きくなっていきます。たとえば、SK2T-0730-06 は SK2T-0730-05 より新しい版です。さらに、表紙には発行の日付が記載されています。

ソフトコピーへの更新部分には、左側に改訂コード (通常、“#” 文字) が付けられています。

xviii CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

変更の要約

この第 4 版で変更された箇所には、本文の左側に「#」マークが付けられています。

CICS Transaction Server for OS/390 リリース 3 第 3 版における変更この第 4 版で変更された箇所には、本文の左側に垂直バーが付けられています。

本書には、CICS Transaction Server for OS/390 リリース 3 の CICS 要素で導入された新機能または拡張機能についての情報が記載されています。変更箇所は、左余白に縦線で示してあります。

3270 ブリッジ出口を定義するために、新規オプションの BREXIT が START コマンドに追加されました。このオプションは、START コマンドの使用を単純化するために、START ATTACH、START BREXITおよびオリジナルのインターバル制御機能 START の 3 つのバリエーションとして説明されています。この変更は、BREXIT および ATTACH とともに使用できるオプションの数が制限されることを示しています。

新規の DOCUMENT と WEB のコマンドが、CICS Web サポートで使用するために追加されました。

CICS TCP/IP listener をサポートするために、EXTRACT TCPIP が追加されました。

セキュア・ソケット・レイヤー (SSL) をサポートするために、EXTRACT CERTIFICATE が追加されました。

ENQ または DEQ のコマンドの RESOURCE オプションで指定された名前が、インストールされたENQMODEL リソースの名前と同じ場合には、ENQ または DEQ のコマンドのスコープ、すなわち、これらのコマンドのスコープがローカルであるか、あるいはシスプレックスであるかを、リソース定義のENQSCOPE 属性が制御します。ENQ または DEQ コマンドの構文は変わりません。

EUR などの複数文字の通貨記号をサポートするために、BMS マクロ DFHMDF の PICIN オプションおよび PICOUT オプションが変更されました。

CICS Transaction Server for OS/390 リリース 2本書には、CICS Transaction Server for OS/390 リリース 2 の CICS 要素で導入された新規機能または拡張機能についての情報が記載されています。変更箇所は、左余白に縦線で示してあります。

3270 ブリッジ出口をサポートするために、新規キーワードの BRIDGE が追加されました。

マップ・セットでアプリケーション・データ構造 (ADS) 記述子レコードを作成するために、BMS マップ定義マクロが拡張されました。669ページの『付録K. BMS マクロの要約』を参照してください。

端末入出力操作なしで 3270 データ・ストリームをマッピングできるようにするために、RECEIVE MAPMAPPINGDEV および SEND MAP MAPPINGDEV が追加されました。

© Copyright IBM Corp. 1989, 2000 xix

CICS Transaction Server for OS/390 リリース 1従来の WAIT JOURNALNUM と WRITE JOURNALNUM が、新規コマンドの WAIT JOURNALNAMEと WRITE JOURNALNAME で置き換えられました。

journalnum(01) はシステム・ログを表さなくなりましたが、この目的のために journalname(dfhlog) を使用してください。

読み取りコマンドに、新しい RLS キーワード CONSISTENT、REPEATABLE、UNCOMMITTED が追加されました。

READNEXT および READPREV に、新しいオプションの UPDATE と TOKEN が追加されました。

ファイル制御コマンドに、新しい条件 LOCKED と RECORDBUSY が追加されました。

xx CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

CICS API コマンド

本書では、各コマンドの構文を示し、各コマンドとそのオプションの目的と形式について説明し、コマンドの実行中に起こり得る条件のリストを示します。

注: システム・プログラミング・インターフェース (SPI) の INQUIRE および SET コマンドは、主としてシステム・プログラマーが使用するものです。したがって、これらのコマンドについては本書では説明しません。これらのコマンドの詳細については、「CICS System Programming Reference」を参照してください。

コマンド変換の変換プログラム・オプションについては、「CICS アプリケーション・プログラミング・ガイド」を、 JCL については「CICS System Definition Guide」を参照してください。

Command 形式CICS コマンドの一般的な形式では、EXECUTE CICS (または EXEC CICS) の後に、実行するコマンド名が続きます。1 つまたは複数のオプションが続く場合もあります。以下に例を示します。

ここで、

コマンド必要な操作 (READ など) を指定します。

オプション各機能で使用できるオプション機能のうちのいくつかを記述します。一部のオプションには括弧で囲んだ引き数が続きます。オプション (引き数を必要とするものも含む) は任意の順序で指定することができます。

arg (argument の省略形)。 “data-value” や “name” のような値です。“data-value” は定数にすることもできます。つまり、データを CICS に送信する引き数は通常 “data-value” になります。CICS からデータを受け取る引き数は “data-area” でなければなりません。

“data-area” として記述される引き数の中には、データの送信および受信の両方を行うものもあります。このような場合には、“data-area” が保護ストレージにないことを確認しなければなりません。

CICS コマンドの例を以下に示します。

適切なコマンド終了区切り文字を加えなければなりません。詳細については、 2ページの『本書で使用するCICS 構文表記法』を参照してください。

EXEC CICS command option(arg)....

EXEC CICS READFILE('FILEA')INTO(FILEA)RIDFLD(KEYNUM)UPDATE

© Copyright IBM Corp. 1989, 2000 1

本書で使用する CICS 構文表記法CICS の資料では、CICS コマンドは標準的な形で示されています。

各コマンドのキーワードの前に常に指定される “EXEC CICS” は含まれません。また各 CICS コマンドの終わりにコーディングする COBOL の “END-EXEC” ステートメント、または PL/I および C のセミコロン (;) も含まれません。ヌル文字は、C 言語ではストリング終了マーカーとして使用できますが、CICS では認識されません。したがって、コーディング行の中では、コンマやピリオドのあとにブランク (X'40') を入れることはできません。

左から右に矢印をたどって、構文を解釈します。規則は以下のとおりです。

記号意味

�� ABC

�� 選択項目の集合。この中の 1 つを必ずコーディングしなければなりません。

�� ABC

��

選択項目の集合。この中の 1 つを必ずコーディングしなければなりません。複数を、任意の順序で、任意にコーディングすることができます。

��ABC

�� 選択項目の集合。この中の 1 つを任意にコーディングすることができます。

��

ABC

��

選択項目の集合。任意の順序で、一度にコーディングできる任意の数 (なしを含む)。

��A

B��選択項目。A がデフォルトです。

�� 名前 ��

名前:A

B

コマンド構文中の名前 (Name) の代りに、その名前のラベル (Name:) がついたセクションを使用します。

句読点および上段シフト文字示されているとおりにコーディングします。

下段シフト文字ユーザー独自のテキストを必要に応じてコーディングします (name など)

たとえば READ FILE(filename) の場合、 READ FILE および () はこのままコーディングしなければなりませんが、ファイル名を示すには、任意の有効なテキスト・ストリングをコーディングすることができます。

2 CICS TS for OS/390: CICS アプリケーション・プログラミング・リファレンス

引き数値CICS コマンド内のオプションに続く括弧で囲まれた引き数は、以下のようにして指定します。v data-valuev data-areav cvda (CICS 値データ域)v ptr-valuev ptr-refv namev labelv hhmmssv filenamev systemname

Data-areas および Data-valuesdata-area および data-value は、基本引き数型です。この 2 つは、タスクがコマンドを実行するときに情報が流れる方向が違います。data-value は、いつでもかつ排他的に送信側になります。この引き数型は、データを CICS に伝え、 CICS はコマンドを処理するためにそのデータを使用します。data-area は受信側です。CICS がこれを使用し、呼び出し元に情報を戻します。たとえば、CICS に伝えられるデータが可変長 (FROM など) であるとき、あるいは、フィールドが入力と出力の両方に使用される場合には、data-area は、送信側になることもできることに注意してください。

COBOL 引き数値引き数値は以下のように置き換えることができます。

v “data-value” は、その引き数にとって正しいデータ型の COBOL データ名、またはその引き数にとって正しい型に変換できる定数に置き換えることができます。指定できるデータ型は、以下のいずれかです。– ハーフワード 2 進数値 -- PIC S9(4) COMP– フルワード 2 進数値 -- PIC S9(8) COMP– ダブルワード無符号 2 進数値 -- PIC 9(18) COMP– 文字ストリング -- PIC X(n)。“n” はバイト数。

v “data-area” は、その引き数にとって正しいデータ型の任意の COBOL データ名に置き換えることができます。指定できるデータ型は、以下のいずれかです。– ハーフワード 2 進数値 -- PIC S9(4) COMP– フルワード 2 進数値 -- PIC S9(8) COMP– ダブルワード無符号 2 進数値 -- PIC 9(18) COMP– 文字ストリング -- PIC X(n)。“n” はバイト数。

データ型が指定されていない場合は、“data-area” は基本項目またはグループ項目を参照することができます。

v “cvda” については 8ページの『CICS 値データ域 (cvda)』を参照してください。v “ptr-value” は、リンケージのベース・ロケーター (BLL) 名、または BLL セル内のポインターのコピーを含む任意の COBOL データ名に置き換えることができます。

v “ptr-ref” は任意の BLL セル名に置き換えることができます。VS COBOL II では、“ptr-ref” はポインター変数または ADDRESS 特殊レジスターと置き換えることができます。

v “name” は以下のうちのいずれかと置き換えることができます。

CICS API コマンド 3

|

|

– 単一引用符内の文字ストリング (数値以外のリテラル)。これが必要な長さに満たない場合は、ブランクが埋め込まれます。

– その名前に必要な長さをもつ COBOL データ域。“data-area” の値はその引き数が使用する名前です。“data-area” が必要な長さよりも短い場合は、余った文字は定義されません。

FILE (filename) という形で使用される “filename” は、ファイルの名前を指定します。これは、A からZ、0 から 9、$、@、# を使った 1 文字から 8 文字で構成されます。

SYSID (systemname) の形で使用される “systemname” は、要求の送信先のシステムの名前を指定します。これは、A から Z、0 から 9、$、@、# を使った 1 文字から 4 文字で構成されます。

v “label” は任意の COBOL パラグラフ名またはセクション名に置き換えることができます。v “hhmmss” は 10 進数定数または PIC S9(7) COMP-3 という形式のデータ名に置き換えることができます。値は 0HHMMSS+ という形式でなければなりません。この値は以下のようになります。HH 00 から 99 までの値で時間を示します。MM 00 から 59 までの値で分を示します。SS 00 から 59 までの値で秒を示します。

OS/VS COBOL では、LENGTH オプションをコーディングしなければなりません。 VS COBOL II では、参照する変数の長さと異なるデータの読み取りまたは書き込みを行うプログラムが必要にならない限り、 LENGTH オプションをコーディングする必要はありません。

C 引き数値引き数値は以下のように置き換えることができます。

v “data-value” は、その引き数にとって正しいデータ型に変換できる任意の C 式に置き換えることができます。指定できるデータ型は、以下のいずれかです。– ハーフワード 2 進数値 -- 短整数– フルワード 2 進数値 -- 長整数– ダブルワード 2 進数値 -- char[8]– 文字ストリング -- char[n]。“n” はバイト数。

“data-value” はサブセットとして “data-area” を含みます。

v “data-area” は、その引き数にとって正しいデータ型をもつ任意の C データ参照に置き換えることができます。指定できるデータ型は、以下のいずれかです。– ハーフワード 2 進数値 -- 短整数– フルワード 2 進数値 -- 長整数– ダブルワード 2 進数値 -- char[8]– 文字ストリング -- char[n]。“n” はバイト数。

データ型を指定しない場合は、“data-area” はスカラー・データ型、配列、または構造を参照することができます。これは連続したストレージでなければなりません。

v “cvda” については 8ページの『CICS 値データ域 (cvda)』を参照してください。v “ptr-value” (サブセットとして “ptr-ref” を含む) は、アドレスに変換できる任意の C 式に置き換えることができます。

v “ptr-ref” は、任意の C ポインター型参照に置き換えることができます。v “name” は以下のうちのいずれかと置き換えることができます。

– 二重引用符内の文字ストリング (リテラル定数)。

– 名前に許可されている最大長に等しい長さをもつ文字配列に変換できる C 数式または参照。文字配列の値はその引き数が使用する名前です。


|

|



v “label” は C 言語ではサポートされません。v “hhmmss” は整数定数に置き換えることができます。整数定数以外の場合は、アプリケーションは、

CICS に送られる値がパック 10 進数形式であることを確認しなければなりません。言語はパック 10 進数型をサポートしません。HH 00 から 99 までの値で時間を示します。MM 00 から 59 までの値で分を示します。SS 00 から 59 までの値で秒を示します。

多くのコマンドで、アプリケーション・プログラムと CICS の間でデータの転送が行われます。

多くの場合、SET を使用する場合は LENGTH オプションを必ず指定しなければなりません。各コマンドの構文およびそれに関連するオプションで、この規則を適用するかどうかが示されます。

PL/I 引き数値引き数値は以下のように置き換えることができます。

v “data-value” は、その引き数にとって正しいデータ型に変換できる任意の PL/I 式に置き換えることができます。指定できるデータ型は、以下のいずれかです。– ハーフワード 2 進数値 -- FIXED BIN(15)– フルワード 2 進数値 -- FIXED BIN(31)– ダブルワード 2 進数値 -- CHAR (8)– 文字ストリング -- CHAR(n)。“n” はバイト数。

“data-value” はサブセットとして “data-area” を含みます。

v “data-area” は、その引き数にとって正しいデータ型の任意の PL/I データ参照に置き換えることができます。指定できるデータ型は、以下のいずれかです。– ハーフワード 2 進数値 -- FIXED BIN(15)– フルワード 2 進数値 -- FIXED BIN(31)– ダブルワード 2 進数値 -- CHAR (8)– 文字ストリング -- CHAR(n)。“n” はバイト数。

データ型を指定しない場合は、“data-area” は要素、配列、または構造を参照することができます。たとえば、FROM (P->STRUCTURE) LENGTH (LNG) などです。参照は連結ストレージでなければなりません。

データ域にも正しい PL/I 位置合わせ属性が必要です。2 進数項目には ALIGNED、ストリングにはUNALIGNED になります。

明示的な長さをもたない可変データ・ストリングを使用する場合は、渡されるデータは 2 バイトで始まり、その長さはストリングについて宣言された長さです。コマンドに明示的に長さを指定する場合は、渡される長さはその長さになります。つまり、長さを示す 2 バイトに、指定した長さまでのデータが続きます。

v “cvda” については 8ページの『CICS 値データ域 (cvda)』を参照してください。v “ptr-value” (サブセット“ ptr-ref” を含む) は、POINTER に変換できる任意の PL/I 数式に置き換えることができます。

v “ptr-ref” タイプが POINTER ALIGNED の任意の PL/I 参照に置き換えることができます。


|

|

v “name” は以下のうちのいずれかと置き換えることができます。– 単一引用符内の文字ストリング (リテラル定数)。

– 名前に許可されている最大長に等しい長さをもつ文字ストリングに変換できる値をもつ PL/I 数式または参照。文字ストリングの値はこの引き数に使用される名前です。


SYSID (systemname) の形で使用される “systemname” は、要求の送信先のシステムの名前を指定します。これは、A から Z、0 から 9、$、@、# の文字からなります。

v “label” はその値がラベルである PL/I 数式に置き換えることができます。v “hhmmss” は、10 進定数または FIXED DECIMAL (7,0) に変換できる数式に置き換えることができます。値は 0HHMMSS+ という形式でなければなりません。この値は以下のようになります。HH 00 から 99 までの値で時間を示します。MM 00 から 59 までの値で分を示します。SS 00 から 59 までの値で秒を示します。

CICS 変換プログラムに DEFAULT DESCRIPTORS ステートメントを指定することによって生成されたENTRY 宣言に UNALIGNED 属性を加えた場合は、 CICS の data-area 引き数または pointer-reference 引き数も UNALIGNED でなければなりません。同様に ALIGNED 属性の場合も、data-area 引き数またはpointer-reference 引き数も ALIGNED でなければなりません。


ほとんどの場合、転送するデータの長さは、アプリケーション・プログラムで提供する必要があります。ただし、ソースまたはターゲットとしてデータ域を指定した場合は、長さを明示的に指定する必要はありません。コマンド言語変換プログラムが STG (data-area) または CSTG (data-area) のいずれかのデフォルトの長さを適切に生成します。

アセンブラー言語引き数値一般に、引き数はデータのアドレスかデータそのもの (アセンブラー言語では再配置可能式または絶対式)のいずれかです。

再配置可能式には対になっていないブラケット (引用符の外) または対になっていない (長さ属性参照からはずれている) 引用符があってはなりません。この規則に従っていれば、=AL2 (100) などのリテラル定数、20 (0,R11) などの形式、およびマクロ置き換え機能を使用する形式を含めすべての式を使用することができます。

絶対式は、長さ属性参照、または自己定義定数のどちらかの単一の項目でなければなりません。

等号はレジスター (ポインター参照) を参照する場合にのみ使用するようにしてください。たとえば長さに等号を使用すると、等号は長さのアドレスと見なされ、予期しないエラーが起こります。

引き数値は以下のように置き換えることができます。

v “data-value” は、その引き数にとって正しい型のデータのアセンブラー言語参照である再配置可能式、またはその引き数にとって正しい型の定数に置き換えることができます。

v “data-area” は、その引き数にとって正しいデータのアセンブラー言語参照である再配置可能式に置き換えることができます。

v “cvda” については 8ページの『CICS 値データ域 (cvda)』を参照してください。


v “ptr-value” はレジスターのアセンブラー言語参照である絶対式に置き換えることができます。v “ptr-ref” はレジスターのアセンブラー言語の言語参照である絶対式に置き換えることができます。v “name” は単一引用符に囲まれた文字ストリング、または文字ストリングのアセンブラー言語の再配置可能式のいずれかに置き換えることができます。長さは名前に許可されている最大長と同じです。文字ストリングの値はこの引き数に使用される名前です。



v “label” は、制御が渡される宛先アドレスを指します。宛先命令のラベル、または宛先のアドレス定数のラベルのいずれかに置き換えることができます。この定数は長さを指定してはなりません。

式 =A (dest) も使用することができます。“dest” は宛先を示す再配置可能式です。

たとえば、以下のコマンドは同じ意味になります。

v “hhmmss” は自己定義の 10 進定数、または PL4 と定義されたフィールドのアセンブラー言語参照に置き換えることができます。値は 0HHMMSS+ という形式でなければなりません。この値は以下のようになります。HH 00 から 99 までの値で時間を示します。MM 00 から 59 までの値で分を示します。SS 00 から 59 までの値で秒を示します。


ほとんどの場合、転送するデータの長さは、アプリケーション・プログラムで提供する必要があります。ただし、データ域がソースまたはターゲットとして定義されている場合は、長さを明示的に指定する必要はありません。コマンド言語変換プログラムが自動的にデフォルトの長さを生成します。

例:

HANDLE CONDITION ERROR(DEST)HANDLE CONDITION ERROR(ADCON)HANDLE CONDITION ERROR(=A(DEST))...DEST BR 14ADCON DC A(DEST)

xxx DC CL8..EXEC CICS ... LENGTH(L'xxx)


制約事項以下の一般規則は、すべての CICS コマンドに適用されます。

ユーザー・データにアクセスする CICS コマンドに適用される制約事項 :

v CICS サービスを呼び出すときに、プログラムは基本アドレッシング・モードになければなりません。基本アドレス・スペースは、ホーム・アドレス・スペースにしてください。CICS に渡されるすべてのパラメーターは基本アドレス・スペースになければなりません。

v CICS は、CICS コマンドまたはマクロ呼び出しにおいて、常にアクセス・レジスターを保護するわけではありません。プログラムがアクセス・レジスターを使用する場合は、 CICS サービスを呼び出す前にそれを保管して、再び使用する前に復元してください。

CICS 値データ域 (cvda)リソースを記述または定義する多くのコマンドに、オプションがあります。 CICS は、CICS 値データ域に、これらのオプションに関連する値を提供します。これらのオプションは、コマンドの構文では括弧で囲まれた『cvda』で示されます。

cvda を渡す方法は、以下の 2 通りがあります。

v cvda 値に変換プログラム・ルーチン DFHVALUE を割り当てることができます。これによって、cvda値を他の実行時演算項目の結果としてプログラムで変更することができます。

例:

v 必要な処置が常に同じであれば、値を直接宣言することができます。例:

フルワード 2 進データ域を定義し、戻される値をプログラム変換ルーチン DFHVALUE でテストすることにより、cvda 値を受け取ります。例:

MOVE DFHVALUE(NOTPURGEABLE) TO AREA-A.EXEC CICS WAIT EXTERNAL ECBLIST() NUMEVENTS()

PURGEABILITY(AREA-A)

EXEC CICS WAITCICS ECBLIST() NUMEVENTS() PURGEABLE

EXEC CICS CONNECT PROCESS .... STATE(AREA-A)IF AREA-A = DFHVALUE(ALLOCATED) ....IF AREA-A = DFHVALUE(CONFFREE) ....


LENGTH オプションVS COBOL II、PL/I、およびアセンブラー言語では、変換プログラムにデフォルトの長さが用意されています。NOLENGTH 変換プログラム・オプションは指定されていません。つまり、データ域を指定するかどうかは任意です。

OS/VS COBOL および C では、すべての LENGTH オプションを指定しなければなりません。

CICS コマンドで LENGTH オプションをコーディングする際には、一般的に符号付きハーフワード 2 進数値で表されます。LENGTH オプションの理論上の上限値は 32 763 バイトになります。実際は、(リカバリー可能性、出荷される機能などによって) 上限値は異なりますが、この理論上の上限値より少し小さくなります。

安全のため、どの CICS コマンドでも、LENGTH オプションに 24KB を超える値を指定しないでください。ジャーナル・コマンドの場合は、ジャーナル・レコードの全長は 62KB です。これにはユーザー・データ、接頭部データ、および 2 バイトの JTYPEID も含まれます。この値は FLENGTH オプションで指定します。

一時記憶域、一時データ、およびファイル制御コマンドでは、データ・セット定義そのものからさらに制約が生じることもあります。

NOHANDLE オプションすべてのコマンドで NOHANDLE オプションを使用して、コマンド実行の結果発生した条件または AIDに対して処置を取らないことを指定することができます。 NOHANDLE オプションの詳細については、「CICS アプリケーション・プログラミング・ガイド」を参照してください。

C 言語を使用すると、すべてのコマンドに NOHANDLE を指定することになるのでご注意ください。

RESP および RESP2 オプションすべてのコマンドで RESP オプションを使用して、コマンドの実行中に条件が発生したかどうかを調べることができます。一部のコマンドでは、複数の原因のために条件が発生したときに、すでに RESP を指定していれば RESP2 を使用して条件が発生した原因を正確に判別することができます。

RESP(xxx)“xxx” は、ユーザー定義のフルワード 2 進データ域です。コマンドから戻ると、xxx には発生した条件に対応する値が入ります (または正常な戻りに対応する値、つまり、xxx=DFHRESP(NORMAL) が入ります)。以下のように、DFHRESP を用いてこの値をテストすることができます。

上記の形式の DFHRESP は COBOL および PL/I の両方に当てはまります。

EXEC CICS WRITEQ TS FROM(abc)QUEUE(qname)NOSUSPENDRESP(xxx)RESP2(yyy)

.

.IF xxx=DFHRESP(NOSPACE) THEN ...


C での同様のテストの例 :

アセンブラー言語での同様のテストの例:

これを変換プログラムが次のように変更します。

RESP の使用が NOHANDLE を意味するので、 RECEIVE コマンドで RESP を使用する際には注意が必要です。HANDLE CONDITION コマンドと同様に、 NOHANDLE は HANDLE AID コマンドを指定変更し、PF キーの応答は無視されます。

RESP2(yyy)“yyy” は、ユーザー定義のフルワード 2 進データ域です。コマンドから戻される際、ここには特定のコマンドに対する応答をさらに修飾する値が含まれています。 RESP 値とは異なり、RESP2 値には関連付けられた記号名がなく、 DFHRESP に対する変換プログラム組み込み関数がないため、フルワード 2 進数自体をテストしなければなりません。

RESP2 値については、この値を戻す各コマンドの説明に記載されています。

ABEND AICA タイムアウトの危険実行時間が、システム初期設定テーブル (SIT) で指定されたランナウェイ時間 (ICVR) を超えると、CICSによりタスクが異常終了することがあります。このような異常終了は、アプリケーションに EXEC CICSSUSPEND コマンドをコーディングしておくことで避けられます。これにより、ディスパッチャーは、要求を出したタスクの実行を中断して、それより優先順位の高いタスクを実行できるようにします。実行可能なタスクがないときは、中断要求を出したプログラムが再開されます。異常終了 AICA の詳細については、「CICS Problem Determination Guide」を参照してください。

switch (xxx) {case DFHRESP(NORMAL) : break;case DFHRESP(INVREQ) : Invreq_Cond();

break;default : Errors();

}

CLC xxx,DFHRESP(NOSPACE)

CLC xxx,=F'18'


JES に対する CICS インターフェースCICS の JES (ジョブ入力サブシステム) に対するインターフェースは、JES2 および JES3 によって維持されるシステム・スプール・ファイルにアクセスするためのスペシャリスト・プログラマー EXEC コマンドを提供します。他の製品の要件をサポートして、JES リモート・スプーリング通信サブシステム (RSCS)ネットワークを介して接続された他のシステムとの間でファイルを交換することができます。JES という用語は、JES2 と JES3 のどちらの参照にも使用されます。

CICS の JES とのインターフェースを使用すると、次の処理を行うことができます。

v 特定ユーザーのデータをローカル JES スプールから検索する。12ページの図1 を参照してください。v ファイルを作成し、レコードをローカル JES スプールへ直接書き込む。12ページの図2 を参照して�

CICS アプリケーション・プログラミング・リファ …端末装置または論理装置との会話(CONVERSE) .....638 非同期割り込みの送信(ISSUE SIGNAL).....638

Documents