SQLパッケージの作成 (CRTSQLPKG)

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

エラー・メッセージ

SQLパッケージ作成(CRTSQLPKG)コマンドによって,既存の配布SQLプログラムからリレーショナル・データベースに関するSQLパッケージを作成(または再作成)することができます。分散SQLプログラムは,CRTSQLXXXコマンド(ここで,XXX = CBL, CBLI, CI, CPPI, PLI, RPG,またはRPGI)コマンドにリレーショナル・データベース (RDB)パラメーターを指定することによって作成されたプログラムです。

詳細な情報は,IBM i Information Center(http://www.ibm.com/systems/i/infocenter/)の「DB2 for i SQL プログラミング」トピック・コレクションにあります。


パラメーター

キーワード 記述 選択項目 ノーツ
PGM プログラム 修飾オブジェクト名 必須, 定位置 1
修飾子 1: プログラム 名前
修飾子 2: ライブラリー 名前, *LIBL, *CURLIB
RDB リレーショナル・データベース 単純名, *PGM オプショナル, 定位置 2
USER RDBユーザー 名前, *CURRENT オプショナル
PASSWORD RDBユーザー・パスワード 文字値, *NONE, ' ' オプショナル
DFTRDBCOL 省略時のコレクション 名前, *PGM, *NONE オプショナル
OBJTYPE オブジェクト・タイプ *PGM, *SRVPGM オプショナル
MODULE モジュール・リスト 単一値: *ALL
その他の値 (最大 256 回の繰り返し): 名前
オプショナル
TEXT テキスト'記述' 文字値, *PGMTXT, *BLANK オプショナル
GENLVL 重大度レベル 0-40, 10 オプショナル
REPLACE 置き換え *YES, *NO オプショナル
PRTFILE 印刷ファイル 修飾オブジェクト名 オプショナル
修飾子 1: 印刷ファイル 名前, QSYSPRT
修飾子 2: ライブラリー 名前, *LIBL, *CURLIB

プログラム (PGM)

SQLパッケージが作成されるプログラムの名前を指定します。このプログラムは,CRTSQLXXX(ここで,XXX = CBL, CBLI, CI, CPPI, PLI, RPG,またはRPGI)コマンドの1つを使用した作成された分散SQLプログラムでなければなりません。

修飾子1: プログラム

名前
SQLパッケージが作成されるプログラムの名前を指定してください。

修飾子2: ライブラリー

*LIBL
最初に一致するものが見つかるまで,現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。
*CURLIB
プログラムを見つけるために,ジョブの現行ライブラリーが使用されます。ジョブの現行ライブラリーとして現行ライブラリーを指定しない場合には,QGPLが使用されます。
名前
プログラムが入っているライブラリーの名前を指定してください。

リレーショナル・データベース (RDB)

SQLパッケージが作成されるリレーショナル・データベースの名前を指定してください。

*PGM
最初にプログラムを作成したCRTSQLXXX(ここで,XXX = CBL, CBLI, CI, CPPI, PLI, RPG,またはRPGI)コマンドのリレーショナル・データベース (RDB)パラメーターに指定されたリレーショナル・データベース名が使用されます。
名前
SQLパッケージが作成されるリレーショナル・データベースの名前を指定します。リレーショナル・データベース・ディレクトリー項目処理(WRKRDBDIRE)コマンドを使用して,このパラメーターに有効なリレーショナル・データベース名を表示してください。

RDBユーザー (USER)

会話を開始した時にリモート・システムに送られるユーザー名を指定します。

*CURRENT
現行ジョブと関連したユーザー名が使用されます。
名前
アプリケーション・リクエスター・ジョブに使用されるユーザー名を指定してください。

RDBユーザー・パスワード (PASSWORD)

リモート・システムで使用されるパスワードを指定します。

*NONE
パスワードは送られません。この値が指定された場合には,RDBユーザー (USER)パラメーターに指定されたユーザー名は無効です。
文字値
USERパラメーターに指定されたユーザー名のパスワードを指定します。ブランクのパスワードは,*NONEの指定と同じに扱われます。

省略時のコレクション (DFTRDBCOL)

テーブル,ビュー,索引,SQLパッケージ,別名,制約,外部プログラム,ノード・グループ,およびトリガーの修飾されていない名前に使用されるスキーマ名を指定します。このパラメーターが適用されるのは,パッケージ内の静的SQLステートメントに対してだけです。

*PGM
SQLパッケージが作成されるプログラムを作成するために使用されるCRTSQLXXX(ここで,XXX = CBL, CBLI, CI, CPPI, PLI, RPG,またはRPGI)コマンドの省略時のコレクションパラメーターに指定されたスキーマ名が使用されます。
*NONE
プログラムをプリコンパイルするために使用されるCRTSQLXXX(ここで,XXX = CBL, CBLI, CI, CPPI, PLI, RPG,またはRPGI)コマンドのプリコンパイラー・オプション (OPTION)パラメーターに指定された命名規則を使用して,スキーマ名が決定されます。
名前
修飾されていないテーブル,ビュー,索引,SQLパッケージ,別名,制約,外部プログラム,ノード・グループ,およびトリガーに使用されるスキーマ名を指定します。

オブジェクト・タイプ (OBJTYPE)

作成されるSQLパッケージが関係するプログラムのタイプを指定します。

*PGM
プログラム (PGM)パラメーターに指定されたプログラムからSQLパッケージを作成します。
*SRVPGM
PGMパラメーターに指定されたサービス・プログラムからSQLパッケージを作成します。

モジュール・リスト (MODULE)

結合済みプログラムのモジュールのリストを指定します。

単一値

*ALL
プログラム中のすべてのモジュールにSQLパッケージが作成されます。プログラム中のどのモジュールにもSQLステートメントが含まれていない場合,あるいはモジュールのどれも配布プログラムでない場合には,エラー・メッセージが送られます。

その他の値(最大256個指定可能)

名前
SQLパッケージが作成されるプログラム内のモジュールを指定します。パッケージ化を必要とするモジュールが256より多く存在する場合には,複数のCRTSQLPKGコマンドを使用しなければなりません。SQLステートメントを含む少なくとも1つのモジュールをもつプログラムには最大1024個のモジュールを入れることができます。

同じプログラムで重複モジュール名を使用することができます。このコマンドは,プログラム中の各モジュールを検索し,MODULEパラメーターに*ALLまたはモジュール名が指定されている場合には,処理が続行され,SQLパッケージを作成する必要があるかどうかが判断されます。モジュールがSQLを使用して作成され,プリコンパイル・コマンドにリレーショナル・データベース (RDB)パラメーターが指定されている場合には,そのモジュールにSQLパッケージが作成されます。そのSQLパッケージは結合済みプログラムのモジュールと関連付けられます。

テキスト'記述' (TEXT)

SQLパッケージおよびその機能を簡単に記述するテキストを指定します。

*PGMTXT
SQLパッケージが作成されるプログラムのテキストが使用されます。
*BLANK
テキストは指定されません。
'記述'
50文字を超えないテキストを,アポストロフィで囲んで指定してください。

重大度レベル (GENLVL)

SQLパッケージの作成時に検出されたエラーに使用可能な最大の重大度レベルを指定します。指定したレベルを超えるレベルでエラーが起こった場合には,SQLパッケージは作成されません。

10
最大の重大度レベルは10です。
0から40
最大の重大度レベルを指定してください。

置き換え (REPLACE)

指定したライブラリー中の同じ名前の既存のSQLパッケージを新しいSQLパッケージで置き換えるかどうかを指定します。

*YES
同じ名前の既存のSQLパッケージは,新しいSQLパッケージで置き換えられます。
*NO
同じ名前の既存のSQLパッケージは置き換えられません。既に存在している場合には,新しいSQLパッケージは作成されません。

印刷ファイル (PRTFILE)

SQLパッケージの作成のエラー・リストが送られる印刷装置ファイルを指定します。SQLパッケージの作成中にエラーが検出されなかった場合には,リストは作成されません。

修飾子1: 印刷ファイル

QSYSPRT
SQLパッケージの作成のエラー・リストは,IBM提供の印刷装置ファイルQSYSPRTに送られます。
名前
SQLパッケージの作成のエラー・リストが送られる印刷装置ファイルの名前を指定してください。

修飾子2: ライブラリー

*LIBL
最初に一致するものが見つかるまで,現行スレッドのライブラリー・リスト内のすべてのライブラリーが検索されます。
*CURLIB
印刷装置ファイルを見つけるためにジョブの現行ライブラリーが使用されます。ジョブの現行ライブラリーとしてライブラリーが指定されていない場合には,QGPLが使用されます。
名前
印刷装置ファイルが入っているライブラリーの名前を指定してください。

CRTSQLPKG   PGM(PAYROLL)  RDB(SYSTEMA)  TEXT('PAYROLL PROGRAM')

このコマンドは,リレーショナル・データベースSYSTEMA上の分散SQLプログラムPAYROLLからSQLパッケージを作成します。


エラー・メッセージ

*ESCAPE メッセージ

SQL9004
SQLパッケージの作成が正常に実行されなかった。
SQL9006
DB2 Query Manager and SQL Development Kitのインストール・レベルがオペレーティング・システムと同じでない。