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

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パッケージを作成します。