DSNJU003 制御ステートメントの構文とオプション
DSNJU003 ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。
DSNJU003 が使用するステートメントは複数あり、それぞれ別々のジョブでサブミットします。 以下のステートメントがあります。
- NEWLOG
- DELETE
- CRESTART
- NEWCAT
- DDF
- CHECKPT
- HIGHRBA
- DELMBR
- RSTMBR
DSNJU003 (ログ目録変更) 構文図
NEWLOG ステートメント
>>-NEWLOG--DSNAME=data-set-name-+-| new active log |--+---------> '-| new archive log |-' >--+-----------------------------------+----------------------->< '-STARTIME=startime,ENDTIME=endtime-'
new active log:
>>-+-,COPY1-+--+----------------------------------+------------>< '-,COPY2-' '-,STARTRBA=startrba,ENDRBA=endrba-'
new archive log:
>>-+-,COPY1VOL=vol-id-+-,STARTRBA=startrba,ENDRBA=endrba,UNIT=unit-id--> '-,COPY2VOL=vol-id-' .-,CATALOG=NO--. >--+--------------+--+------------------------------------+---->< '-,CATALOG=YES-' '-STRTLRSN=startlrsn,ENDLRSN=endlrsn-'
DELETE ステートメント
>>-DELETE--+-DSNAME=data-set-name-+------------------+-+------->< | +-,COPY1VOL=vol-id-+ | | '-,COPY2VOL=vol-id-' | '-CCSIDS------------------------------------'
CRESTART ステートメント
>>-CRESTART--+-CREATE--| create-spec |-+----------------------->< '-CANCEL------------------'
create-spec:
>>-+-+--------------------+--+----------------+-+---------------> | '-,STARTRBA=startrba-' '-,ENDRBA=endrba-' | +-,ENDLRSN=endlrsn---------------------------+ +-,SYSPITR=log-truncation-point--------------+ +-,ENDTIME=log-truncation-timestamp----------+ '-,SYSPITRT=log-truncation-timestamp---------' >--+--------------------+---------------------------------------> '-,CHKPTRBA=chkptrba-' .-,FORWARD=YES-. .-,BACKOUT=YES-. >--+-+--------------+--+--------------+-+---------------------->< | '-,FORWARD=NO--' '-,BACKOUT=NO--' | '-,CSRONLY---------------------------'
NEWCAT ステートメント
>>-NEWCAT--VSAMCAT=catalog-name--------------------------------><
DDF ステートメント
>>-DDF--+-| ip-spec |-+---------------------------------------->< +-| lu-spec |-+ '-| no-spec |-'
ip-spec:
.-,-------------------------------------------------------------------. V (1) | >>-+-------+-LOCATION=locname--------------------------------------------+-+-+->< | +-PORT=port---------------------------------------------------+ | | +-RESPORT=resport---------------------------------------------+ | | +-SECPORT=secport---------------------------------------------+ | | | .-,--------------------------------------------. | | | | V | | | | +---ALIAS=---alias-name--+------------------------------+-+---+ | | | +-:--alias-port----------------+ | | | | '-:--alias-port-:alias-secport-' | | | '-IPNAME=ipname-----------------------------------------------' | | .-,------------------------------------------------------. | | V (2) | | '-------+-IPV4=IPV4-address-+--------------------------+-+-+--------------' | '-,GRPIPV4=group-ipv4-addr-' | '-IPV6=IPV6-address-+--------------------------+-' '-,GRPIPV6=group-ipv6-addr-'
- 各オプション (LOCATION や PORT など) は 1 回だけ指定できます。
- 各オプション (IPV4 および IPV6) は 1 回だけ指定できます。
lu-spec:
.-,--------------------------------------------------. V (1) | >>-------+-LOCATION=locname---------------------------+-+------>< +-LUNAME=luname------------------------------+ +-PASSWORD=password--------------------------+ +-GENERIC=gluname----------------------------+ +-PORT=port----------------------------------+ +-RESPORT=resport----------------------------+ | .-,---------------------------. | | V | | '---ALIAS=---alias-name--+-------------+-+---' '-:alias-port-'
- 各オプション (LOCATION や PORT など) は 1 回だけ指定できます。
no-spec:
>>-+-NOPASSWD----------+--------------------------------------->< +-NGENERIC----------+ +-NOALIAS-----------+ +-NOIPV4 , NGRPIPV4-+ +-NOIPV6 , NGRPIPV6-+ +-NGRPIPV4----------+ +-NGRPIPV6----------+ +-NOIPNAME----------+ '-NOLUNAME----------'
CHECKPT ステートメント
>>-CHECKPT--STARTRBA=startrba-----------------------------------> >--+-,ENDRBA=endrba--,TIME=time--+------------------+-+-------->< | '-,ENDLRSN=endlrsn-' | '-,CANCEL------------------------------------------'
HIGHRBA ステートメント
>>-HIGHRBA------------------------------------------------------> >--+-STARTRBA=startrba-+------------------+-,TIME=time-+------->< | '-,OFFLRBA=offlrba-' | '-OFFLRBA=offlrba-----------------------------------'
DELMBR ステートメント
>>-DELMBR--+-DEACTIV-+--,MEMBERID=member-id-------------------->< '-DESTROY-'
RSTMBR ステートメント
>>-RSTMBR--MEMBERID=member-id----------------------------------><
オプションの説明
- NEWLOG
- 次のいずれかのデータ・セットを宣言します。
- アクティブ・ログ・データ・セットとして使用できる VSAM データ・セット。
キーワード DSNAME=、COPY1、および COPY2 のみを使用します。
- 入出力エラーがあったログ・データ・セットに
置き換わるアクティブ・ログ・データ・セット。
キーワード DSNAME=、COPY1、COPY2、STARTRBA=、および ENDRBA= のみ を使用します。
- アーカイブ・ログ・データ・セット・ボリューム。
キーワード DSNAME=、COPY1VOL=、COPY2VOL=、 STARTRBA=、ENDRBA=、UNIT=、CATALOG=、STRTLRSN=、 および ENDLRSN= のみを使用します。
アーカイブ・ログ・データ・セットを作成し、 それをこのユーティリティーを使用して BSDS に追加する 場合は、Db2® も生成する可能性がある名前を指定することができます。Db2 は、DSNCAT.ARCHLOGx.Annnnnnn の 形式のアーカイブ・ログ・データ・セット名を生成します。 ここで、
- DSNCAT と ARCHLOG は、インストール・パネル DSNTIPA2 および DSNTIPH で指定した、 データ・セット接頭部の一部です。
- x は、ログの最初のコピーの場合は 1 で、2 番目のコピーの場合は 2 です。
- Annnnnnn は、Db2 がアーカイブ・ログ・データ・セット名として生成する 下位修飾子のシリーズを表します。A0000001 で始まり、A0000002、 A0000003、のように増分します。
データ共用の場合、命名規則は DSNCAT.ARCHLOG1 または DSNCAT.DSN1.ARCLG1 です。
仮に Db2 と同じ命名規則を使って名前を指定した場合、Db2 でその名前が生成されるときに、動的割り当てエラーを受け取ります。 エラー・メッセージ DSNJ103I が、1 回発行されます。次に Db2 は下位修飾子を増分して、連続する次のデータ・セット名を生成し、Db2 が次回にアーカイブするときにそれをオフロードします。 (それまでにオフロードされなかったアクティブ・ログは、このデータ・セットにオフロードされます。)
あらたに定義されたアクティブ・ログは、開始 LRSN および終了 LRSN を指定することはできま せん。Db2 は、開始すると、 一定の RBA 範囲を持つ新規アクティブ・ログ・データ・セットを読み取って LRSN 範囲を判別し、 それらの新規ログ・データ・セットについて BSDS 内で開始および終了 LRSN を更新 します。アクティブ・ログ・データを収容する新規アクティブ・ログの開始 LRSN および終了 LRSN は、ログ目録変更 NEWLOG ステートメントで指定された新規アクティブ・ログ・データ・セットから、Db2 の始動時に読み取られます。 ログ目録変更で定義される新規アーカイブ・ログに対しては、 ユーザーが開始 RBA および終了 RBA を指定する必要があります。 データ共用の場合、ユーザーは開始 LRSN と終了 LRSN も指定する必要があり ます。Db2 は、これらの値を始動時に新規アーカイブ・ログ・データ・セットから見つけようとはしません。
- アクティブ・ログ・データ・セットとして使用できる VSAM データ・セット。
- DSNAME= data-set-name
- ログ・データ・セットを指定します。
data-set-name の長さは、最大 44 文字まで可能です。
- COPY1
- データ・セットをアクティブ・ログ・コピー 1 データ・セットに設定します。
- COPY2
- データ・セットをアクティブ・ログ・コピー 2 データ・セットに設定します。
- STARTRBA= startrba
最大 20 文字までの 16 進数を示します。
使用文字数が 20 個未満の場合は、先行ゼロが追加され
ます。startrba は '000' で終わっていなければなりません。
そうでないと、Db2 は DSNJ4381 エラー・メッセージ
を戻します。RBA は、メッセージから、あるいはログ・マップを印刷すれば、入手できます。
NEWLOG ステートメントの startrba は、 DSNAME で指定する置換アクティブ・ログ・データ・セットまたはアーカイブ・ログ・データ・セット・ボリューム の開始ログ RBA を指定します。
CRESTART ステートメントの startrba は、 再始動中に使用されるログの最も早い RBA です。STARTRBA を省略すると、Db2 がログ範囲の先頭を判別します。
CHECKPT ステートメントの startrba は、 開始チェックポイント・ログ・レコードを指定します。
STARTIME が指定されている場合は、STARTRBA は必須です。
HIGHRBA ステートメントの startrba は、 アクティブ・ログ・データ・セット内での書き込まれた最高位置のログ・レコードのログ RBA を表します。
- ENDRBA= endrba
endrba は、最大 20 文字までの 16 進数です。使用文字数が 20 個未満の場合は、先行ゼロが追加され
ます。endrba は '000' で終わる必要があります。そうでないと、Db2 は DSNJ4381 エラー・メッセージを返します。
NEWLOG ステートメントの endrba は、 DSNAME で指定する置換アクティブ・ログ・データ・セットまたは アーカイブ・ログ・データ・セット・ボリュームの 終了ログ RBA (ログ内の相対バイト・アドレス) を指定します。
CRESTART ステートメントの endrba は、再始動中に 使用されるログの最後の RBA であり、再始動後に書き込まれる次のアクティブ・ログの 開始 RBA でもあります。 ブートストラップ・データ・セット、 アクティブ・ログ、およびアーカイブ・ログ内のログ情報のうち、RBA が endrba より 大きいものは廃棄されます。ENDRBA を省略すると、Db2 がログ範囲の終わりを判別します。
ENDRBA の値は、4096 の倍数でなければなりません。(16 進数値は、000 で終わる必要があります。) また、この値は STARTRBA の値以上でなければなりません。STARTRBA と ENDRBA が等しいと、次の再始動はコールド・スタートに なります。つまり、再始動時にログ・レコードは処理されません。指定された RBA が、 新しいログの開始 RBA になります。
CHECKPT ステートメントの endrba は、 開始チェックポイント・ログ・レコードに対応する終了チェックポイント・ログ・レコードを 指定します。
- COPY1VOL= vol-id
- vol-id は、DSNAME の後に指定されるコピー 1 アーカイブ・ログ・データ・セットの ボリューム通し番号です。
- COPY2VOL=vol-id
- vol-id は、DSNAME の後に指定されるコピー 2 アーカイブ・ログ・データ・セットの ボリューム通し番号です。
- UNIT=unit-id
- unit-id は、 DSNAME の後に指定されるアーカイブ・ログ・データ・セットの 装置タイプです。
- CATALOG
- アーカイブ・ログ・データ・セットをカタログするかどうかを示します。
- NO
- アーカイブ・ログ・データ・セットはカタログしないことを示します。 これ以降のデータ・セットの割り当てはすべて、ステートメントで指定された装置およびボリューム情報 を使用して行われます。
- YES
- アーカイブ・ログ・データ・セットをカタログすることを示します。
これ以降のデータ・セットの割り振りはすべて、カタログを使用して行われます。
Db2 は、ディスク上のアーカイブ・ログ・データ・セットがすべて カタログされていることを必要とします。アーカイブ・ログ・データ・セットがディスク上にある場合は、CATALOG=YES を選択してください。
- STRTLRSN= startlrsn
NEWLOG ステートメントの startlrsn は、
新規アーカイブ・データ・セット内の最初の完全なログ・レコードのログ・レコード・ヘッダー中の LRSN を
指定します。startlrsn は、最大 20 文字までの 16 進数です。
使用文字数が 20 個未満の場合は、先行ゼロが追加され
ます。
データ共用環境では、ログ・マップ印刷ユーティリティーを実行して、
アーカイブ・ログ・データ・セット、開始と終了の RBA、および開始と終了の LRSN を見つけてください。
- ENDLRSN=endlrsn
endlrsn は、最大 20 文字までの 16 進数です。使用文字数が 20 個未満の場合は、先行ゼロが追加され
ます。データ共用環境では、ログ・マップ印刷ユーティリティーを実行して、
アーカイブ・ログ・データ・セット、開始と終了の RBA、および開始と終了の LRSN を見つけてください。
NEWLOG および CHECKPT ステートメントの場合、ENDLRSN オプションは、データ共用環境でのみ有効 です。CRESTART ステートメントの場合、ENDLRSN オプションは、データ共用環境でも、非データ共用環境でも 有効です。 このオプションは、STARTRBA または ENDRBA と一緒に指定することはできません。
NEWLOG ステートメントの endlrsn は、 新規アーカイブ・データ・セット内の最後のログ・レコードのログ・レコード・ヘッダー中 の LRSN です。
データ共用環境では、CRESTART ステートメントに指定された endlrsn は、 ログ切り捨てポイントとして使用される LRSN 値です。有効なログが切り詰められるポイントとは、指定された LRSN 値以上の LRSN を持つログ・レコードが 存在する場合の LRSN 値です。 ブートストラップ・データ・セット、アクティブ・ログ、およびアーカイブ・ログの ログ情報は、LRSN が endlrsn より大きい場合はいずれも廃棄され ます。ENDLRSN を省略すると、Db2 がログ範囲の終わりを判別します。
非データ共用環境では、endlrsn は、再始動時に使用される最後のログ・レコードの 開始と一致する RBA 値です。 ブートストラップ・データ・セット、アクティブ・ログ、およびアーカイブ・ログ内の ログ情報は、RBA が endlrsn より大きい場合はいずれも廃棄され ます。開始位置が endlrsn RBA 値と一致するログ・レコードが ない場合、Db2 再始動 は失敗します。ENDLRSN を省略すると、Db2 がログ範囲の終わりを判別します。
CHECKPT ステートメントの endlrsn は、 終了チェックポイント・ログ・レコードの LRSN です。
- STARTIME=startime
- BSDS に RBA の開始時刻を記録できるようにします。このフィールドはオプションです。
startime は、以下のタイム・スタンプ・フォーマットで、開始時刻を指定します。
yyyydddhhmmsstこのフォーマットの意味は、以下のとおりです。
- yyyy
- 年 (1989~2099) を表します。
- ddd
- 通年日 (0~365、うるう年は 366) を表します。
- hh
- 時 (0~23) を表します。
- mm
- 分 (0~59) を表します。
- ss
- 秒 (0~59) を表します。
- t
- 10 分の 1 秒を表します。
パラメーター STARTIME または ENDTIME に対して 14 桁未満の値を指定すると、 後書きゼロが追加されます。
STARTIME を指定する場合は、ENDTIME、STARTRBA、および ENDRBA オプションも指定する必要があります。
- ENDTIME= endtime
- BSDS に RBA の終了時刻を記録できるようにします。このフィールドはオプションです。
endtime は、STARTIME オプションと同じタイム・スタンプ・フォーマットで終了時刻を指定します。 ENDTIME 値は、STARTIME の値以上でなければなりません。
- DELETE
- ブートストラップ・データ・セットから、CCSID 情報またはログ・データ・セット情報のいずれかを 削除します。CCSID 情報を削除する場合は、CCSIDS オプションを指定します。 指定されたログ・データ・セットまたはボリュームの情報をすべて削除する場合は、DSNAME オプションを 指定します。
- CCSIDS
- BSDS から CCSID 情報を削除します。ユーザーが間違えて CCSID 値を変更
してしまうことのないように、CCSID 情報は BSDS に保管されています。
BSDS 内の CCSID 情報が正しくない場合、IBM® ソフトウェア・サポートからの指示のもとで このオプションを使用してください。DELETE CCSIDS オプションを指定して DSNJU003 ジョブを 実行すると、次に Db2 が開始されたときに、アプリケーション・デフォルト・ロード・モジュールである CCSID 値が BSDS に記録されます。
- CRESTART
- 新しい条件付き再始動制御レコードを作成するか、現在アクティブな条件付き再始動制御レコードを取り消すことによって、Db2 の次の再始動を制御します。
- CREATE
- 新しい条件付き再始動制御レコードを作成します。新しいレコードが作成されると、前の制御レコードは 非アクティブになります。
- SYSPITR=log-truncation-point
- システム・リカバリー用のポイント・イン・タイムのログ切り捨てポイントを表す
ログ RBA (非データ共用システム) またはログ LRSN (データ共用システム) を指定し
ます。RESTORE SYSTEM ユーティリティーを実行してシステム・データをリカバリーする前
に、DSNJU003 の SYSPITR オプションを使用する必要があります。このオプションを使用すると、
システム・ポイント・イン・タイム・リカバリー用
のログを切り捨てるための、条件付き再始動制御レコードを作成することができます。
値 FFFFFFFFFFFFFFFFFFFF を指定して、ログ切り捨てを行わずにポイント・イン・タイム・リカバリーを行うこともできます。
log-truncation-point は、ログ RBA、ログ LRSN、またはログ FFFFFFFFFFFFFFFFFFFF を指定します。
非データ共用環境では、log-truncation は、再始動時に使用される最後のログ・レコードの
開始と一致する RBA 値です。開始位置が RBA 値と一致する
ログ・レコードがない場合、Db2 再始動は失敗します。データ共用環境の
場合、log-truncation は有効なログ切り捨てポイントである LRSN 値です。
有効なログが切り詰められるポイントとは、指定された LRSN 値以上の LRSN を持つログ・レコードが
存在する場合の LRSN 値です。
ログ切り捨てを必要とするデータ共用グループのすべてのメンバーに対して、
同じ LRSN 値を使用してください。その他のオプションは、いずれも CREATE または SYSPITR と一緒に指定することはできません。
- ENDTIME= log-truncation-timestamp
- ログ切り捨てポイントとして使用される終了時刻値を指定します。
切り捨てポイントが任意の UTC タイム・スタンプで表され、指定したタイム・スタンプ値以上のタイム・スタンプを持つログ・レコードがそれに存在すれば、その切り捨てポイントは有効です。ブートストラップ・データ・セット、
アクティブ・ログ、およびアーカイブ・ログ内のログ情報のうち、タイム・スタンプが ENDTIME より大きいものは廃棄されます。ENDTIME が
指定されていない場合、Db2 が
ログ範囲の終わりを決定します。
CREATE、ENDTIME と共に他のオプションを指定することはできません。
- SYSPITRT= log-truncation-timestamp
- システム・リカバリー用のポイント・イン・タイム・ログ切り捨てポイントを表すタイム・スタンプ値
を指定します。RESTORE SYSTEM ユーティリティーを実行してシステム・データをリカバリーする前に、
DSNJU003 の SYSPITR または SYSPITRT オプションを使用する必要があります。これらのオプション
を使用すると、システム・ポイント・イン・タイム・リカバリー用のログを切り捨てる
ための条件付き再始動制御レコードを作成することができます。
log-truncation-timestamp は、 ログ切り捨てポイントとして使用されるタイム・スタンプ値を指定します。ログ切り捨てポイントが任意の UTC タイム・スタンプで表され、指定したタイム・スタンプ値以上のタイム・スタンプを持つログ・レコードがそれに存在すれば、その切り捨てポイントは有効です。ブートストラップ・データ・セット、 アクティブ・ログ、およびアーカイブ・ログ内のログ情報のうち、タイム・スタンプが SYSPITRT より大きいものは廃棄されます。SYSPITRT が 省略されている場合、Db2 が ログ範囲の終わりを決定します。ログ切り捨てを必要とするデータ共用グループのすべてのメンバーに対して、 同じタイム・スタンプ値を使用してください。
CREATE、SYSPITRT と共に他のオプションを指定することはできません。
注: startime キーワードは、yyyydddhhmmsst のタイム・スタンプ・フォーマットで、開始時刻を指定します。 タイム・スタンプの詳細については、STARTIME オプションを参照してください。 - CANCEL
- CRESTART ステートメントでは、 現在アクティブな
条件付き再始動制御レコードを非アクティブにします。レコードは、履歴情報として BSDS に残ります。
他のキーワードは、CRESTART ステートメントでは CANCEL と併用できません。
CHECKPT ステートメントでは、 STARTRBA キーワードによって指定された パラメーターと一致する開始 RBA が入っているチェックポイント・キュー項目が削除されます。
重要: このステートメントを使用すると、データの整合性を維持しようとする DB2® の試みが無効になることがあります。条件付き再始動処理について理解していない場合は、このステートメントを使用しないでください。 - CHKPTRBA= chkptrba
- 再始動時に使用されるチェックポイント・レコードの開始ログ RBA を指定します。
STARTRBA または ENDRBA を使用し、CHKPTRBA を使用しない場合は、DSNJU003 ユーティリティーが適切な チェックポイント・レコードの RBA を選択し ます。CHKPTRBA を使用すると、ユーティリティーによって選択された値がオーバーライドされます。
chkptrba は、startrba および endrba、あるいは そのデフォルト値によって決められた範囲内になければなりません。
CHKPTRBA は、できれば使用しないでください。そして、このユーティリティーがチェックポイント・レコード の RBA を決定するようにしてください。
CHKPTRBA=0 を用いると、ユーティリティーによる選択がオーバーライドされます。Db2 は、 再始動時に、最新のチェックポイント・レコードを使用しようとします。
- FORWARD=
- Db2 再始動の順方向ログ・リカバリー・フェーズを使用するかどうかを示します。
このフェーズでは、ログを順方向に読み取って、Db2 が最後に停止した時点では
次の 2 つのいずれかの状態にあったリカバリー単位をすべてリカバリーします。
- 未確定 (リカバリー単位がコミットの最初のフェーズを終了しているが、2 番目 のフェーズを開始していない)。
- コミット中 (コミットの 2 番目のフェーズを開始はしたが、終了していない)
- YES
- 順方向ログ・リカバリーを可能にします。
コールド・スタートを指定する (STARTRBA と ENDRBA に同じ値を使用する) と、 リカバリー処理は行われません。
- NO
- ログ・レコードが処理される前に、順方向ログ・リカバリーを終了します。FORWARD=NO が指定されていると、Db2 は 未確定またはコミット中のリカバリー単位の順方向リカバリーを完了させる目的で、 ログの中のそれらのリカバリー単位の先頭まで戻ることはしません。非常に古い未確定のリカバリー単位が存在する場合、この オプションを使用して非常に長い再始動を回避するようにしてください。コミット中および 未確定のリカバリー単位は、バイパスされたものとして、および完了したものとし てログの中にマークが付けられます。ただし、ログの最後でペンディング状態にあるどのデータベー ス書き込み (他のリカバリー単位からの更新を含む) も、再始動の順方向フェ ーズ時点で、やはり書き出されます。例えば未完了状態もしくはアボート中のリカバリー単位に対し てロールバックが必要となるどのような更新も、再始動のバックアウト・フェーズ 時点で行われます。
- BACKOUT=
- Db2 再始動の逆方向ログ・リカバリー・フェーズを使用するかどうかを示します。
このフェーズでは、Db2 が最後に停止した時点で以下の 2 つの状態のいずれかにあった
リカバリー単位をすべてロールバックします。
- 未完了 (コミットの最初のフェーズを完了しなかった)
- アボート中 (打ち切りを開始したが、終了していない)
- YES
- 逆方向ログ・リカバリーを可能にします。
コールド・スタートを指定する (STARTRBA と ENDRBA に同じ値を使用する) と、 リカバリー処理は行われません。
- NO
- ログ・レコードが処理される前に、逆方向ログ・リカバリーを終了します。
- CSRONLY
- 再始動処理の最初と 2 番目のフェーズのみを実行します (ログ初期化と現行状況再作成)。
これらのフェーズの後、システムの状況が表示され、再始動は終了します。
ログの更新および STARTRBA や ENDRBA 情報の表示を含む、ログ初期化の一部が行われません。
このオプションを有効にして Db2 を再始動すると、 条件付き再始動制御レコードは非アクティブの状態にはなりません。 制御レコードをアクティブのまま残ることのないように するには、CRESTART CANCEL を用いて、または新しいアクティブ制御レコードを 作成するための CRESTART CREATE を用いて、DSNJU003 ユーティリティーをもう一度使用します。
- NEWCAT
- BSDS の VSAM カタログ名を変更します。
- VSAMCAT= catalog-name
- BSDS 内の VSAM カタログ名項目を変更します。
catalog-name の長さは、最大 8 文字まで 可能です。先頭文字は英字でなければなりませんが、 残りの文字は英数字でも構いません。
- DDF
- BSDS 内の LOCATION、LUNAME、および他の DDF 関連情報値を更新します。このステートメントを使用して新しい値を BSDS に挿入する 場合は、少なくとも LOCATION を DDF ステートメントに組み込む必要があります。 既存の値のセットを更新する場合は、変更したい値だけを組み込み ます。DDF レコードは、追加後は BSDS から削除できなくなります。変更のみが可能となります。
- LOCATION= location-name
- BSDS 内の LOCATION 値を変更します。
location-name はローカル Db2 サイトの名前を指定します。
- PORT
- 着信接続要求を受け入れるために DDF が使用する TCP/IP ポート番号を示します。
この値は、0 と 65535 の間 (65535 を含む) の 10 進数でなければなりません。ゼロは、DDF の TCP/IP サポートを非アクティブにすることを示します。
DDF が VTAM® のみを使用する必要があり、TCP/IP は使用しない場合、PORT を 0 に設定します。
Db2 がデータ共用グループの一部である場合は、Db2 データ共用グループのメンバーは、すべて同じ PORT 値を持っている必要があります。
- RESPORT
- 着信 DRDA 2 フェーズ・コミット再同期要求を
受け入れるために DDF が使用する TCP/IP ポート番号を指定します。この値は、0 と 65535 の間 (65535 を含む) の 10 進数でなければなりません。
ゼロは、DDF の TCP/IP サポートを非アクティブにすることを示します。
RESPORT が非ゼロの場合は、RESPORT は PORT で与えられた値と同じであってはなりません。
データ共用 Db2 システムの場合、どの 2 つの Db2 メンバーも 2 フェーズ・コミットの再同期に関して同じ TCP/IP ポートを使用しないようにするために、各 Db2 メンバーに RESPORT が固有に割り当てられる必要があります。
- SECPORT
- インバウンドのセキュア DRDA 接続要求を 受け入れるために DDF が使用する TCP/IP ポート番号を指定します。この値は、0 と 65535 の間 (65535 を含む) の 10 進数 でなければなりません。ゼロは、TCP/IP 用の DDF のセキュア接続サポートを非アクティブにすることを示します。
- ALIAS= alias-name :alias-port :alias-secport
- ロケーションに対する 1 つ以上の別名を指定します。別名とは、ロケーション名以外に、接続処理が受け入れることができる名前です。
別名を指定しても、データベース・オブジェクトのロケーション ID は変更されません。
重要: ALIAS は DRDA 接続にのみ適用されます。
DSNJU003 ユーティリティーを使用することにより、最大 8 個までのロケーション別名を指定および変更できます。
8 個を超える別名を指定するには、ALIAS オプションを指定した MODIFY DDF コマンドを使用してください。
alias-name は、1 から 16 文字で ロケーション名の別名を指定します。alias-name は有効な DSNJU003 キーワードと同じであってはなりません。
:alias-port では、DDF が分散要求を受け入れるために使用する 別名の TCP/IP ポート番号を指定します。 この値は、1 と 65535 の間 (65535 を含む) の 10 進数でなければなりません。 この値は、PORT、RESPORT、および SECPORT オプションの値と異なる必要があり、他の定義済み別名の alias-port や alias-secport で指定されたどの値とも異なっていなければなりません。 分散要求を受け取るデータ共用メンバーのサブセットを指定したい場合は、 alias-port に値を指定してください。
:alias-secport は、 SSL を使用してセキュア分散要求を DDF が受け入れるために使用できる、別名のための セキュア TCP/IP ポート番号を指定します。この値は、1 と 65535 の間 (65535 を含む) の 10 進数でなければなりません。 この値は、SECPORT、PORT、および RESPORT オプションの値と異なる必要があり、他の定義済み別名の alias-port や alias-secport で指定されたどの値とも異なっていなければなりません。 セキュア分散要求を受け取るデータ共用メンバーのサブセットを指定したい 場合は、alias-secport に値を指定してください。alias-secport の値を 指定する場合、:alias-port 値はオプションです。
ALIAS オプションを指定しなおすことによって、別名を追加したり、置き換えることができます。 新しい名前のリストによって、既存のリストは置き換えられます。
関連情報: - IPNAME=ipname
- IPNAME 値を識別し、DDF に関連付けます。
ipname は、長さが 8 バイトまでの、英字で始まる英数字でなければなりません。 このオプションが指定されていると、LUNAME の値があるかどうかに関わらず、DDF はその TCP/IP 通信サポートのみをアクティブにします。TCP/IP を介したインバウンドおよびアウトバウンドの DRDA プロトコル通信のみが許可されます。Db2 は、SNA/APPC 通信のサポートのアクティブ化は試みません。
指定する値は、エンタープライズ内でのこの Db2 サブシステムに固有の値であるか、または、Db2 サブシステムがデータ共用グループのメンバーとして構成されている場合は、この Db2 サブシステムがメンバーになっているデータ共用グループに固有の値でなければなりません。データ共用グループのすべてのメンバーが TCP/IP 通信サポートのみを アクティブにする場合は、すべてのメンバーが同じ IPNAME 値を使用して定義されている 必要があります。データ共用グループのいくつかのメンバーが SNA/APPC (および TCP/IP 通信サポートも) を アクティブにする場合、TCP/IP のみのメンバーに対して選択される IPNAME 値は、TCP/IP 通信サポート だけでなく SNA/APPC もアクティブにするメンバーに対して指定される GENERIC 値と 一致していなければなりません。
IPNAME に指定される値 は、Db2 によって、 作業単位 ID のネットワーク ID 部分として使用されます。作業単位 ID は、通常、 ネットワーク ID、LU 名、タイム・スタンプから作成される 6 バイトのユニーク ID、 および 2 バイトの現行コミット・カウント値で構成されます。ある IPNAME 値を使用して 実行する際、作業単位 ID の LU 名の部分は、TCP/IP 再同期ポート (RESPORT) に指定された値の 16 進表記の 4 バイトの文字表記 から作成されます。TCP/IP 通信のみをアクティブにするこのサポートは、Db2 が V9 新機能モードで 稼働している場合のみ発生します。
IPNAME と TCP/IP 外部名 (ホスト名またはドメイン・ネームなど) を混同しないでください。 IPNAME に指定した値は、Db2 によって、 または、別の DRDA サーバーとの DRDA 交換で、内部的に使用されるだけです。 この値を TCP/IP 外部 (ping など) で参照することはできません。また、Db2 が稼働しているシステム のホスト名を IPNAME にする選択も適当ではありません。なぜなら、複数の Db2 が同じ システムで稼働している可能性があり、すべての Db2 または Db2 データ共用グループに 指定される IPNAME 値は、エンタープライズ内でユニークでなければならないからです。
- IPV4= ipv4-address
- この特定のサブシステムのみへの着信接続要求を受け入れるための、
定数の IPv4 IP アドレスを指定し、DDF と関連付けます。このアドレスは、
ドット 10 進形式で入力する必要があります。IP アドレスが指定されていない場合、Db2 が
自動的に TCP/IP から IP アドレスを判別します。
Db2 が データ共用グループのメンバーである場合、動的仮想 IP アドレス (DVIP) を参照することを 強くお勧めします。グループ IP アドレス GRPIPV4 も指定 する必要があります。
- IPV6= ipv6-address
- この特定のサブシステムのみへの着信接続要求を受け入れるための、
定数の IPv6 IP アドレスを指定し、DDF と関連付けます。このアドレスは、
コロン 16 進形式で入力する必要があります。IP アドレスが指定されていない場合、Db2 が
自動的に TCP/IP から IP アドレスを判別します。
Db2 が データ共用グループのメンバーである場合、動的仮想 IP アドレス (DVIP) を参照することを 強くお勧めします。グループ IP アドレス GRPIPV6 も指定 する必要があります。
- GRPIPV4
- 定数の IPv4 IP アドレスを指定し、この DDF がメンバーになっている
データ共用グループと関連付けます。この IP アドレスは、データ共用グループの任意のメンバーで
サービスを受けることのできる着信接続要求を受け入れるために使用
されます。このアドレスは、
ドット 10 進形式で入力する必要があります。グループのこの特定メンバーと関連付けられた IP アドレスを指定するため、
関連する IPv4 サブシステム/メンバーのアドレスも指定する必要があります。IP アドレスが指定されていない場合、Db2 が
自動的に TCP/IP から IP アドレスを判別します。
シスプレックス・ディストリビューターが所有する 分散動的仮想 IP アドレス (DVIPA) を参照することを強くお勧めします。
- GRPIPV6
- 定数の IPv6 IP アドレスを指定し、この DDF がメンバーになっている
データ共用グループと関連付けます。この IP アドレスは、データ共用グループの任意のメンバーで
サービスを受けることのできる着信接続要求を受け入れるために使用
されます。このアドレスは、
コロン 16 進形式で入力する必要があります。グループのこの特定メンバーと関連付けられた IP アドレスを指定するため、
関連する IPv6 サブシステム/メンバーのアドレスも指定する必要があります。IP アドレスが指定されていない場合、Db2 が
自動的に TCP/IP から IP アドレスを判別します。
シスプレックス・ディストリビューターが所有する 分散動的仮想 IP アドレス (DVIPA) を参照することを強くお勧めします。
- LUNAME= luname
- BSDS の LUNAME 値を変更します。
luname は、LUNAME 値を指定し ます。BSDS 内の LUNAME には、VTAM ネットワークに対してローカル Db2 サブシステムを識別する値が常に含まれていなければなりません。
- PASSWORD=
- DDF パスワードは VTAM 規則
に従いますが、Db2 により、1 文字から 8 文字までの
英数字に制限されます。
先頭の文字は、大文字もしくは拡張英字でなければなりません。
残りの文字は、英数字と拡張英字で構成することができます。
- password
- オプションで、分散データ環境用の通信を確立する分散データ機能通信レコードに パスワードを割り当てます。Db2 を VTAM に対して定義するために、APPL 定義ステートメントの PRTCT=password オプションが使用されます。
- GENERIC= gluname
- BSDS 内の Db2 GENERIC LUNAME サブシステム・パラメーターの値を置き換えます。
gluname は、GENERIC LUNAME 値を指定します。
- NOPASSWD
- この操作の後に作成された、すべてのアーカイブに対するアーカイブ・パスワード保護を除去します。 前に存在していたパスワードも、DDF レコードから除去します。 他のキーワードは、NOPASSWD と併用できません。
- NGENERIC
- BSDS 内の Db2 GENERIC LUNAME を 2 進ゼロに 変更します。これは、VTAM 総称 LU 名サポートが要求されないことを意味します。
- NOALIAS
- 指定されたロケーションには、別名は存在しないことを示します。前の DSNJU003 ユーティリティー・ジョブで指定された別名は、いずれも除去されます。
- NOIPV4
- BSDS から定数 IPv4 アドレスを除去します。関連するグループ・アドレスがあればそれも 確実に除去されるようにするため、NGRPIPV4 キーワードも指定する必要があります。
- NOIPV6
- BSDS から定数 IPv6 アドレスを除去します。関連するグループ・アドレスがあればそれも 確実に除去されるようにするため、NGRPIPV6 キーワードも指定する必要があります。
- NGRPIPV4
- BSDS から定数データ共用グループ IPv4 アドレスを除去します。
- NGRPIPV6
- BSDS から定数データ共用グループ IPv6 アドレスを除去します。
- NOIPNAME
- DDF レコードから IPNAME 値を除去します。NOIPNAME と共に他のキーワードを使用することはできません。
- NOLUNAME
- DDF レコードから LUNAME 値を除去します。NOLUNAME と共に他のキーワードを使用することはできません。
- CHECKPT
- チェックポイント・キューを、開始チェックポイントと終了チェックポイント・ログ・レコード
で更新できるようにします。
重要: このステートメントを使用すると、データの整合性を維持しようとする DB2 の試みが無効になることがあります。条件付き再始動処理およびチェックポイント処理について理解していない場合は、このステートメントを使用しないでください。
- TIME= time
- CHECKPT ステートメント上で、開始チェックポイント・レコード
の書き込まれた時刻を指定します。
HIGHRBA ステートメント上で、TIME は、ログ・レコードが最高位置の RBA で ログに書き込まれた時点を指定します。
time は、時刻値を指定します。タイム・スタンプのフォーマットについては、STARTIME オプションの説明を参照してください。
- HIGHRBA
- アクティブまたはアーカイブ・ログ・データ・セットのいずれかで、
最高位置に書き込まれたログの RBA を更新します。
重要: このステートメントを使用すると、データの整合性を維持しようとする DB2 の試みが無効になることがあります。条件付き再始動処理について理解していない場合は、このステートメントを使用しないでください。
- OFFLRBA= offlrba
- アーカイブ・ログで最高位置にオフロードされた RBA を指定します。
offlrba は、最大 20 文字までの 16 進数です。
使用文字数が 20 個未満の場合は、先行ゼロが追加され
ます。この値は 16 進 X'FFF' で終わっていなければなりません。
- DELMBR
- データ共用グループのメンバーを非アクティブ化または破棄します。
- DEACTIV
- データ共用グループのメンバーに非アクティブ化のマークを付けます。
非アクティブ化は、データ共用グループからメンバーを削除するための最初のステップです。
メンバーを非アクティブにするには、その前にそれが静止状態でなければならず、未処理の作業が存在してはなりません。 ログおよび BSDS が存在する必要があります。
- DESTROY
- データ共用グループからメンバーの削除を完了します。
メンバーが破棄された後、そのメンバー ID を再使用することができ、ログと BSDS を削除できます。
- RSTMBR
- データ共用グループの非アクティブ化されたメンバーを静止状態に復元します。
- MEMBERID= member-id
- 非アクティブ化、破棄、または復元の対象となるデータ共用グループ・メンバーを指定します。
member-id は、1 から 32 までの範囲内の数値です。 この数値は、DISPLAY GROUP コマンドまたは DSNJU004 (ログ・マップ印刷) ユーティリティーからの出力に示されるメンバー ID です。