DEFINE CLUSTER

アクセス方式サービス・プログラムを使用すると、IDCAMS を 1 回呼び出すだけで一連のコマンドを実行するようにジョブをセットアップすることができます。 モーダル・コマンドの実行は、前のコマンドの成功または失敗に基づいています。

DEFINE CLUSTER は、クラスター全体の属性、およびクラスターのコンポーネントの属性を定義するために使用します。 DEFINE CLUSTER コマンドの一般的な構文は、次のとおりです。
  • DEFINE CLUSTER (パラメーター)-
    • [DATA(パラメーター)]-
    • [INDEX(パラメーター)]-
    • [CATALOG(サブパラメーター)]

DEFINE コマンド属性の優先順位については、 割り当てられたデータ・セット属性の順序について を参照してください。

コマンド パラメーター
DEFINE CLUSTER
    (NAME(項目名)
    {CYLINDERS(1 次[ 2 次])|
     KILOBYTES(1 次[ 2 次])|
     MEGABYTES(1 次[ 2 次])|
     RECORDS(1 次[ 2 次])|
     TRACKS(1 次[ 2 次])}
    VOLUMES(volser[ volser...])
    [ACCOUNT(アカウント情報)]
    [BUFFERSPACE(サイズ)]
    [BWO(TYPECICS|TYPEIMS|NO)]
    [CONTROLINTERVALSIZE(サイズ)]
    [DATABASE(BSON|JSON)KEYNAME|KEYNAMEU(explicit-primary-key-value)]
    [DATACLASS(クラス)]
    [EATTR(NO|OPT)]
    [ERASE|NOERASE]
    [EXCEPTIONEXIT(エントリー・ポイント)]
    [FILE(DD 名)]
    [FREESPACE(CI パーセント[ CA-パーセント]|0 0)]
    [FRLOG(ALL|NONE|REDO|UNDO)]
    [索引付き|LINEAR|NONINDEXED|NUMBERED|ZFS]
    [KEYLABEL(キー値)]
    [KEYS(length offset| 64 0]
    [LOG(NONE|UNDO|ALL)]
    [LOGREPLICATE|NOLOGREPLICATE]
    [LOGSTREAMID(ログ・ストリーム)]
    [MANAGEMENTCLASS(クラス)]
    [MODEL(entryname[ catname])]
    [OWNER(所有者 ID)]
    [RECATALOG|NORECATALOG]
    [RECORDSIZE(平均 最大)]
    [REUSE|NOREUSE]
    [| RLSQUIESCE]RLSENABLE
    [SHAREOPTIONS(クロスリージョン[ クロスシステム]|1 3)]
    [SPANNED|NONSPANNED]
    [SPEED|RECOVERY]
    [STORAGECLASS(クラス)]
   [TO(date)|FOR(日)]
    [WRITECHECK|NOWRITECHECK])
  [DATA (
    {CYLINDERS(1 次[ 2 次])|
     KILOBYTES(1 次[ 2 次])|
     MEGABYTES(1 次[ 2 次])|
     RECORDS(1 次[ 2 次])|
     TRACKS(1 次[ 2 次])}
    [VOLUMES(volser[ volser...])]
    [BUFFERSPACE(サイズ)]
    [CONTROLINTERVALSIZE(サイズ)]
    [ERASE|NOERASE]
    [EXCEPTIONEXIT(エントリー・ポイント)]
    [FILE(DD 名)]
    [FREESPACE(CI パーセント[ CA-パーセント])]
    [KEYS(長さ offset)]
    [MODEL(entryname[ catname])]
    [NAME(項目名)]
    [OWNER(所有者 ID)]
    [RECORDSIZE(平均 最大)]
    [REUSE|NOREUSE]
    [SHAREOPTIONS(crossregion[ crosssystem])]
    [SPANNED|NONSPANNED]
    [SPEED|RECOVERY]
    [WRITECHECK|NOWRITECHECK])]
  [INDEX (
    {CYLINDERS(1 次[ 2 次])|
     KILOBYTES(1 次[ 2 次])|
     MEGABYTES(1 次[ 2 次])|
     RECORDS(1 次[ 2 次])|
     TRACKS(1 次[ 2 次])}
    [VOLUMES(volser[ volser...])]
    [CONTROLINTERVALSIZE(サイズ)]
    [EXCEPTIONEXIT(エントリー・ポイント)]
    [FILE(DD 名)]
    [MODEL(entryname [ catname])]
    [NAME(項目名)]
    [OWNER(所有者 ID)]
    [REUSE|NOREUSE]
    [SHAREOPTIONS(crossregion[ crosssystem])]
    [WRITECHECK|NOWRITECHECK])]
  [CATALOG(catname)]

DEFINE 省略形: DEF

単一のジョブ・ステップで一般的に使用される一連のコマンドには、DELETE -- DEFINE -- REPRO または DELETE -- DEFINE -- BLDINDEX が含まれます。 これらのコマンドでは、DD 名またはデータ・セット名のいずれかを指定できます。 ただし、DD 名を参照すると、ジョブ・ステップの開始時に割り振りが行われます。 これにより、データ・セットの位置 (volser) を変更する DELETE -- DEFINE シーケンスの後に REPRO などのコマンドが続くと、ジョブが失敗する可能性があります。 いずれかの SMS 管理データ・セットで障害が発生する可能性があります。

IDCAMS DEFINE コマンドで VVDS をモデル化することはできません。 また、SMS は強制的に VVDS を非 SMS 管理対象にするため、DATACLAS または MODEL ルーチンのいずれかによる EATTR 値の割り当ては、VVDS の DEFINE では許可されません。 EATTR 割り当ては、DEFINE CLUSTER コマンドでのみ明示的に許可されます。 VVDS DEFINE の EATTR 値を割り当てる他のソースはありません。

重要: IBM® では、DFSMStvs を使用して、単一ステップ内または同じジョブ内で同じデータ・セットに対して削除および定義を行うことはお勧めしません。 削除により、ジョブが終了するまで解放されない排他的 ENQ がスローされます。 ほとんどの場合、これは問題ではありません。ジョブが ENQ を所有しているため、データ・セットの割り振りに問題はありません。 ただし、リカバリー単位が何らかの理由でバックアウト状態になった場合、DFSMStvs はデータ・セットを割り振ることができず、UR は中断される。
IDCAMS ジョブでのモーダル・コマンド・シーケンスによる潜在的な障害を回避するには、以下のようにします。
  • DD 名の代わりにデータ・セット名を指定する。
  • DEFINE コマンドの後に続く一連のコマンド (例えば、REPRO、IMPORT、BLDINDEX、PRINT、または EXAMINE) を実行するには、別のジョブ・ステップを使用します。

推奨: DB2® は、STOGROUP 定義のデータ・セットにアクセス方式サービス DEFINE CLUSTER を使用します。 これにより、同じボリュームに複数のパーティションが定義されている場合、パーティション表スペースのパフォーマンス上の問題が発生する可能性があります。 DB2 は、順次照会のパフォーマンスを向上させるために、パーティション表スペースでソフトウェア・ストライピングを使用します。 スループットは、各ボリュームのデータ配信機能によって制御されます。 各区画は別個のデータ・セットであるため、 IEFBR14 (IDCAMS ではない) ジョブの単一の JCL ステップですべての区画を割り振ることによって、この問題を回避できます。 詳しくは、「 z/OS DFSMS データ・セットの使用 」を参照してください。 この方法ですべての区画を割り振ることができるのは、すべての区画を満たすために、単一の SMS ストレージ・グループ内に、要求されたスペース量で使用可能なボリュームの数が十分にある場合です。

制約事項: IMBED、KEYRANGE、ORDERED、または REPLICATE を指定しても無視されます。