ca endevor® software change manager - … endevor software...ca technologies...

シナリオガイドバージョン 16.0.00

CA Endevor® Software Change Manager

このドキュメント（組み込みヘルプシステムおよび電子的に配布される資料を含む、以下「本ドキュメント」）は、

お客様への情報提供のみを目的としたもので、日本 CA 株式会社（以下「CA」）により随時、変更または撤回される

ことがあります。

CA の事前の書面による承諾を受けずに本ドキュメントの全部または一部を複写、譲渡、開示、変更、複本することは

できません。本ドキュメントは、CA が知的財産権を有する機密情報です。ユーザは本ドキュメントを開示したり、

（i）本ドキュメントが関係する CA ソフトウェアの使用について CA とユーザとの間で別途締結される契約または (ii)

CA とユーザとの間で別途締結される機密保持契約により許可された目的以外に、本ドキュメントを使用することはで

きません。

上記にかかわらず、本ドキュメントで言及されている CA ソフトウェア製品のライセンスを受けたユーザは、社内で

ユーザおよび従業員が使用する場合に限り、当該ソフトウェアに関連する本ドキュメントのコピーを妥当な部数だけ

作成できます。ただし CA のすべての著作権表示およびその説明を当該複製に添付することを条件とします。

本ドキュメントを印刷するまたはコピーを作成する上記の権利は、当該ソフトウェアのライセンスが完全に有効と

なっている期間内に限定されます。いかなる理由であれ、上記のライセンスが終了した場合には、お客様は本ドキュ

メントの全部または一部と、それらを複製したコピーのすべてを破棄したことを、CA に文書で証明する責任を負いま

す。

準拠法により認められる限り、CA は本ドキュメントを現状有姿のまま提供し、商品性、特定の使用目的に対する適合

性、他者の権利に対して侵害のないことについて、黙示の保証も含めいかなる保証もしません。また、本ドキュメン

トの使用に起因して、逸失利益、投資損失、業務の中断、営業権の喪失、情報の喪失等、いかなる損害（直接損害か

間接損害かを問いません）が発生しても、CA はお客様または第三者に対し責任を負いません。CA がかかる損害の発

生の可能性について事前に明示に通告されていた場合も同様とします。

本ドキュメントで参照されているすべてのソフトウェア製品の使用には、該当するライセンス契約が適用され、当該

ライセンス契約はこの通知の条件によっていかなる変更も行われません。

本ドキュメントの制作者は CA です。

「制限された権利」のもとでの提供：アメリカ合衆国政府が使用、複製、開示する場合は、FAR Sections 12.212、52.227-14

及び 52.227-19(c)(1)及び(2)、ならびに DFARS Section252.227-7014(b)(3) または、これらの後継の条項に規定される該当

する制限に従うものとします。

Copyright © 2013 CA. All rights reserved. 本書に記載された全ての製品名、サービス名、商号およびロゴは各社のそれぞ

れの商標またはサービスマークです。

CA Technologies 製品リファレンス

このマニュアルが参照している CA Technologies の製品は以下のとおりで

す。

■ CA Endevor® Software Change Manager（CA Endevor SCM）

■ CA Endevor® Software Change Manager Automated Configuration （CA

Endevor Automated Configuration）

■ CA Endevor® Software Change Manager Parallel Development （CA Endevor

Parallel Development）

■ CA Endevor® Software Change Manager Quick Edit（CA Endevor Quick Edit）

■ CA Endevor® Software Change Manager External Security Interface（CA

Endevor External Security Interface）

■ CA Endevor® Software Change Manager InfoMan Interface （CA Endevor

InfoMan Interface）

■ CA Endevor® Software Change Manager CA Librarian® Interface （CA

Endevor CA Librarian Interface）

■ CA Endevor® Software Change Manager Integration for the Natural

Environment（CA Endevor Integration for the Natural Environment）

■ CA Endevor® Software Change Manager CA Netman™ Interface （CA

Endevor CA Netman Interface）

■ CA Endevor® Software Change Manager for CA Panvalet® Interface （CA

Endevor for CA Panvalet Interface）

■ CA Endevor® Software Change Manager CA Roscoe® Interface （CA Endevor

CA Roscoe Interface）

■ CA Librarian® Base for z/OS（CA Librarian）

■ CA Panvalet® for z/OS（CA Panvalet for z/OS）

CAへの連絡先

テクニカルサポートの詳細については、弊社テクニカルサポートの Web

サイト（http://www.ca.com/jp/support/）をご覧ください。

http://www.ca.com/jp/support/

目次 5

目次

第 1 章：はじめに 11

第 2 章：グローバルタイプシーケンス 13

グローバルタイプシーケンスを有効にする方法 .............................................................................................. 14

前提条件の確認 ................................................................................................................................................. 16

PARMLIB データセットの割り当て ................................................................................................................ 19

サイトのタイプシーケンスメンバの作成 ................................................................................................... 20

C1DEFLTS に対するタイプシーケンスメンバの定義................................................................................... 25

タイプシーケンスメンバの確認 ................................................................................................................... 26

第 3 章：並行アクション処理 27

並行アクション処理を有効化および保護する方法 ............................................................................................ 27

前提条件の確認 ................................................................................................................................................. 31

並行アクション処理の概要 ............................................................................................................................. 33

CAP の生成パラメータの有効化 ..................................................................................................................... 39

CAP に対する CAICCI 生成機能の有効化 ......................................................................................................... 41

CAP のセキュリティの設定..................................................................................................................................... 46

CAP に対して CA Top Secret を設定する方法 ................................................................................................. 47

CAP に対して CA ACF2 を設定する方法 .......................................................................................................... 49

CAP に対して RACF を設定する方法 ............................................................................................................... 50

CAP のセキュリティ制御チェックポイントの設定 ...................................................................................... 51

並行アクション処理をアクティブにする方法 .................................................................................................... 53

バッチ JCL での CAP のアクティブ化 .............................................................................................................. 54

前景でサブミットされるパッケージでの CAP のアクティブ化 ................................................................. 56

前景でサブミットされるバッチジョブでの CAP のアクティブ化 ............................................................ 57

CAP の SCL 要件 .................................................................................................................................................. 58

並行アクション処理を監視する方法 .................................................................................................................... 58

アクションステータスの表示 ........................................................................................................................ 59

第 4 章： AUTOGEN アクションオプション 61

「using」エレメントを自動的に生成する方法 .................................................................................................... 62

前提条件の確認 ........................................................................................................................................................ 64

AUTOGEN アクションオプション .......................................................................................................................... 65

6 シナリオガイド

AUTOGEN アクションオプションが処理に及ぼす影響 ............................................................................... 67

AUTOGEN をコード化する方法 ....................................................................................................................... 69

AUTOGEN SPAN オプションの動作 .................................................................................................................. 72

影響分析用のシミュレーションモードでの AUTOGEN の実行 .................................................................. 74

AUTOGEN および AUTOGEN SPAN 処理の例 ........................................................................................................... 75

すべての例の処理前のイメージ ..................................................................................................................... 76

例 1： AUTOGEN または AUTOGEN SPAN NONE .............................................................................................. 76

例 2： AUTOGEN SPAN ALL ................................................................................................................................ 78

例 3： AUTOGEN SPAN SYSTEMS ....................................................................................................................... 80

例 4：AUTOGEN SPAN SUBSYSTEMS ................................................................................................................. 81

第 5 章：パッケージ配布機能 83

パッケージ配布を設定する方法 ............................................................................................................................ 84

パッケージ配布を有効にする方法 ........................................................................................................................ 85

前提条件の確認 ................................................................................................................................................. 88

パッケージ配布ユーティリティ ..................................................................................................................... 89

パッケージ配布の仕組み ................................................................................................................................. 90

パッケージ配布と USS ファイルの仕組み ..................................................................................................... 93

Ship Asis 機能 ..................................................................................................................................................... 95

Post-Ship スクリプトの実行 ............................................................................................................................. 96

配布後スクリプトの実行の仕組み ................................................................................................................. 97

転送方法に関する考慮事項 ............................................................................................................................. 99

Ship Asis の有効化............................................................................................................................................ 103

ホスト JCL の設定 ............................................................................................................................................ 104

リモートパッケージ配布 JCL の変更 ........................................................................................................... 111

配布先の作成 ................................................................................................................................................... 120

マッピングルール .......................................................................................................................................... 126

モデル通信制御ステートメントのカスタマイズ ....................................................................................... 136

外部パッケージ配布ジョブストリームの作成方法 .................................................................................. 144

パッケージシップ用に USS サポートファイルを有効にする方法 ................................................................. 148

パッケージ配布用の USS サポートファイルの有効化 .............................................................................. 149

USS ソース出力ファイルのバックアウトを有効にする方法 .................................................................... 154

ENUSSUTL ユーティリティ ............................................................................................................................. 156

配布後スクリプトの実行を有効にする方法 ...................................................................................................... 158

配布後スクリプト用の C1DEFLTS の設定 ..................................................................................................... 159

配布後スクリプト用のプロセッサの更新 ................................................................................................... 160

配布後スクリプトデータセットのマッピングルールの定義 ................................................................. 161

配布先設定ファイルの作成 ........................................................................................................................... 162

モデルスクリプトステップの作成 ............................................................................................................. 164

目次 7

ホストパッケージ出荷ジョブステップ ............................................................................................................. 167

配布の作成およびステージング方法 ........................................................................................................... 167

ステージングデータセット ......................................................................................................................... 168

リモート実行 JCL ............................................................................................................................................. 170

リモート JCL 実行コマンド ............................................................................................................................ 170

データセット対応関係ファイル .................................................................................................................. 171

配布コンテンツ ............................................................................................................................................... 172

配布を転送する方法 ....................................................................................................................................... 173

転送を確認する方法 ....................................................................................................................................... 174

ステージングデータセットの削除方法 ..................................................................................................... 175

リモートコピー/削除ジョブステップの動作 ................................................................................................... 175

配布を作成、追跡、確認する方法 ...................................................................................................................... 178

1 つのパッケージの 1 つの配布先への配布 ................................................................................................ 179

1 つのパッケージの複数の配布先への配布 ................................................................................................ 180

複数のパッケージの 1 つの配布先への配布 ............................................................................................... 181

パッケージ配布パネル ................................................................................................................................... 182

パッケージ選択リスト ................................................................................................................................... 183

配布先選択リスト ........................................................................................................................................... 184

配布するパッケージの確認 ........................................................................................................................... 185

配布先の追跡および確認 ............................................................................................................................... 186

リクエストキュー .......................................................................................................................................... 192

配布ステータスの表示 ................................................................................................................................... 192

パッケージ配布 SCL ........................................................................................................................................ 193

パッケージ配布の管理 .......................................................................................................................................... 197

パッケージ配布レポート ............................................................................................................................... 198

パッケージ配布アセンブラレポート .......................................................................................................... 202

配布確認電子メール通知 ............................................................................................................................... 202

第 6 章： Web サービス 203

Web サービスを有効にする方法 ......................................................................................................................... 204

前提条件の確認 ............................................................................................................................................... 205

Web サービス用に CA Endevor SCM を構成する方法 ......................................................................................... 210

Web サービス用のデフォルトテーブルの設定 .......................................................................................... 212

MODHLI データセットの Web サービスセキュリティ要件の決定 ......................................................... 213

エレメントタイプのサポート ...................................................................................................................... 214

テキストファイル用のエレメントタイプを定義する方法 ..................................................................... 216

バイナリファイル用のエレメントタイプを定義する方法 ..................................................................... 218

zFS リニアデータセットのサイズを変更する方法 ................................................................................... 220

Web サービス用に STC 定義を有効化する方法 .................................................................................................. 222


CA Common Services コンポーネントが実行中であることの確認 ............................................................ 223

Web サービス用のスターティッドタスクの定義 ...................................................................................... 224

CA Endevor SCM SYSID の検索 ......................................................................................................................... 227

設定値の記録 ................................................................................................................................................... 228

Web サービスへのセキュリティアクセスを有効にする方法 ......................................................................... 229

Web サービス用のセキュリティソフトウェアのカスタマイズ .............................................................. 230

MODHLI データセットへのユーザアクセスの有効化 ............................................................................... 235

Tomcat サーバを起動する権限の有効化 ...................................................................................................... 236

Web サービスを構成および展開する方法 .......................................................................................................... 237

Web サービスコンポーネント用の Tomcat ディレクトリ構造の作成 .................................................... 241

Tomcat 設定ファイルの編集 .......................................................................................................................... 245

Tomcat サーバによって使用される JVM 環境の値の編集 ......................................................................... 246

Apache Tomcat サーバの起動 ......................................................................................................................... 247

Apache Tomcat のインストールおよび構成の確認 ..................................................................................... 248

Tomcat で HTTPS を設定する方法 .................................................................................................................. 249

Web サービスの既存の展開を更新する方法 ...................................................................................................... 251

Tomcat の新しいリリースで Web サービスを実行する方法 ............................................................................ 252

データソースへのアクセスの仕組み ................................................................................................................. 253

設定ファイルを作成する方法 .............................................................................................................................. 254

ASCII エンコードファイルの編集 ................................................................................................................. 255

V16 データソース設定ファイルテンプレート .......................................................................................... 256

ENDEVOR.cfg のパラメータ ............................................................................................................................ 257

データソース設定の内容を表示する方法 ......................................................................................................... 266

STC プーリングを有効にする方法 ....................................................................................................................... 267

STC プールの管理方法 .................................................................................................................................... 268

ユーザ作成のクライアントプログラム ............................................................................................................. 269

クライアントスタブを作成する方法 .......................................................................................................... 270

Java クライアントプログラムオブジェクトおよびパラメータ .............................................................. 271

ユーザ作成のクライアントプログラムの有効な操作 .............................................................................. 274

第 7 章：ベストプラクティス実装 283

ベストプラクティス実装を実行する方法 ......................................................................................................... 284

前提条件の確認 ............................................................................................................................................... 286

本番環境の実装計画 ....................................................................................................................................... 288

BPI ソフトウェアインベントリのライフサイクル .................................................................................... 289

ベストプラクティス実装のソースファイル ............................................................................................. 305

BPISTART を実行します。 .............................................................................................................................. 306

BPI 入力テーブルのカスタマイズ ................................................................................................................. 307

BPI ジョブカードの準備 ................................................................................................................................ 319

目次 9

BPI ジョブのシンボル値の定義 ..................................................................................................................... 320

BPI ジョブのサブミット ................................................................................................................................. 321

BPI プロセスの繰り返し ................................................................................................................................. 323

第 1 章：はじめに 11

第 1 章：はじめに

このガイドには、CA Endevor SCM のシナリオがすべて含まれています


第 2 章：グローバルタイプシーケンス

ここでは、CA Endevor SCM 管理者がタイプシーケンスメンバを作成し、

グローバルタイプシーケンスを有効にする方法を説明します。

このセクションには、以下のトピックが含まれています。

グローバルタイプシーケンスを有効にする方法 (P. 14)

グローバルタイプシーケンスを有効にする方法



変更マネージャ（CA Endevor SCM 管理者）は、グローバルタイプシーケ

ンスを有効にしてバッチ処理のパフォーマンスを改善できます。この機

能が有効な場合、API エレメントアクション（ワイルドカードまたはマス

クを使用する場合）および SCL エレメントアクションは、管理者によって

作成されたタイプシーケンスメンバ内のサイトレベルで定義された単一

のタイプシーケンスによって処理されます。

グローバルタイプシーケンスは以下の機能の前提条件です。

■ 並行アクション処理（CAP） -- 処理用にサブミットされたバッチジョ

ブまたはパッケージに対して CAP が指定された場合、特定のエレメン

トアクション要求が同時に実行されます。 CAP は、グローバルタイプ

シーケンスを使用して、どのアクションを同時に処理できるかを判断

します。

■ ADD、UPDATE、GENERATE アクションの AUTOGEN オプション — エレ

メントに対して AUTOGEN が指定された場合、このコンポーネントエ

レメントを使用するエレメントが自動的に生成されます。 AUTOGEN

にはグローバルタイプシーケンスが必要で、これにより、すべてのコ

ンポーネントの処理が完了した後、コンポーネントを使用するエレメ

ントが生成されます（たとえば、ソースの前にマクロ、ロードモジュー

ルの前にソース、など）。

以下の図は、グローバルタイプシーケンスを有効にする方法を示してい

ます。



グローバルタイプシーケンスを有効にするには、以下の手順に従います。

1. 前提条件の確認 (P. 16)。

2. PARMLIB データセットの割り当て (P. 19)

3. サイトのタイプシーケンスメンバの作成 (P. 20)

4. C1DEFLTS に対するタイプシーケンスメンバの定義 (P. 25)

5. タイプシーケンスメンバの確認 (P. 26)



前提条件の確認

グローバルタイプシーケンスを有効にする前に、処理がどのように動作

するかを理解していることを確認します。以下のトピックを確認してく

ださい。これらのトピックでは、デフォルトのタイプ処理とグローバルタ

イプシーケンスの違い、および並行アクション処理に対するグローバル

タイプシーケンスの影響について説明します。

■ バッチジョブのタイプ処理 (P. 16)

■ バッチジョブのデフォルト処理の動作 (P. 17)

■ グローバルタイプシーケンスの動作 (P. 17)

■ 並行アクション処理に対するグローバルタイプシーケンスの影響 (P.

18)

バッチジョブのタイプ処理

CA Endevor SCM 管理者は、特定の順序で処理する必要がある CA Endevor

SCM タイプの処理シーケンスを設定できます。たとえば、COBOL コピー

ブックは、COBOL プログラムの前に処理する必要があります。このタイ

プ処理シーケンスは、システムレベル（デフォルト）、またはグローバ

ルタイプシーケンスと呼ばれるグローバルレベルのいずれかで設定でき

ます。 JCL など、その他のタイプは任意の順序で処理できます。このよう

なタイプは、タイプ処理シーケンスで定義する必要はありません。

バッチリクエストに複数のエレメントタイプが含まれる場合、CA Endevor

SCM は、まず 2 つのリクエストチェーンを作成します。 1 つのチェーンは

タイプシーケンス順のシーケンスタイプで構成され、もう 1 つのチェー

ンはアルファベット順の非シーケンスタイプで構成されます。その後、

CA Endevor SCM は、以下のようにシーケンスタイプチェーンを最初に処

理します。

■ デフォルト処理（グローバルタイプシーケンスなし）を使用する場合、

タイプは、各ターゲットシステムに対して定義されたタイプの順序で

処理されます。

■ グローバルタイプシーケンスを使用する場合、タイプは、サイトレ

ベルで定義された処理順序に従って処理されます。

グローバルタイプシーケンスは、並行アクション処理オプションの前提

条件です。このオプションを使用すると、特定のタイプを同時に処理で

きます。



バッチジョブのデフォルト処理の動作

バッチジョブのデフォルト処理では、タイプは、システムレベルで定義

されたタイプの順序で処理されます。エレメントアクションは、各シス

テム内で、管理者によってタイプがシステムおよびステージに対して定義

されたのと同じ順序、または管理者によって並べ替えられたのと同じ順序

で実行されます。以下に、この処理の詳細を示します。

1. 管理者がタイプを定義すると、それらは、システム MCF 内のタイプ

シーケンスの末尾に追加されます。

2. 管理者は、以下のように、前景またはバッチ内でこのシーケンスを並

べ替えることができます。

a. タイプシーケンスパネル — グローバルタイプシーケンスが有効

でない場合に限り、このパネルを使用してシーケンスを並べ替え

ることができます。

b. タイプシーケンスステートメントの定義 — グローバルタイプ

シーケンスが有効であるかどうかに関係なく、このバッチ管理 SCL

ステートメントを使用してシーケンスを並べ替えることができま

す。ただし、グローバルタイプシーケンスが有効な場合は、アク

ションが実行中であっても、警告メッセージが生成されます。

3. バッチジョブがサブミットされると、ターゲットシステムの MCF に

保持されているシーケンスを使用して、各システムでエレメントアク

ションが実行されます。

グローバルタイプシーケンスの動作

グローバルタイプシーケンスは、バッチ処理用のオプションの方法です。

グローバルタイプシーケンスを使用する場合、API エレメントアクショ

ン（ワイルドカードまたはマスクを使用する場合）および SCL エレメント

アクションは、管理者によって作成されたタイプシーケンスメンバ内の

サイトレベルで定義された単一のタイプシーケンスによって処理されま

す。以下に、この処理の詳細を示します。

1. 管理者がグローバルタイプシーケンスを有効にします。このタスク

には、タイプシーケンスメンバ内のサイトレベルでタイプシーケン

ス順を定義することが含まれます。

2. グローバルタイプシーケンスを使用する場合、エレメントアクショ

ンは、タイプシーケンスメンバ内で定義されたタイプシーケンスで




3. タイプシーケンスメンバに含まれていないタイプは、タイプシーケ

ンスメンバ内のすべてのタイプの処理が完了した後に処理されます。

タイプシーケンスメンバに含まれていないタイプは、ターゲットシ

ステムの MCF レコードで定義されている順序で処理されます。

並行アクション処理に対するグローバルタイプシーケンスの影響

並行アクション処理（CAP）を使用する場合、グローバルタイプシーケン

スが必要です。同時に処理できるタイプのカテゴリ定義を追加すること

により、CAP をさらに効率化できます。カテゴリは、グローバルタイプ

シーケンステーブルで定義されています。

重要：グローバルタイプシーケンステーブルでカテゴリを指定しても、

シーケンスタイプと非シーケンスタイプのリクエストを作成および並べ

替える方法には影響しません。カテゴリは、並行アクション処理がアク

ションをディスパッチする方法にのみ影響します

CAP は、以下のようにリクエストを処理します。

1. CA Endevor SCM は、同時に処理するエレメント要求をディスパッチす

る場合、どのアクション要求をディスパッチするかを決定するときに、

タイプ、およびそのタイプに関連付けられているカテゴリの両方を参

照します。

a. シーケンスタイプチェーン内の次のリクエストに前のリクエス

トと同じカテゴリ値が含まれる場合、そのエレメントアクション

は使用可能な STC にディスパッチできます。

カテゴリを指定した場合、カテゴリ値が前のリクエストに一致す

る限り、CA Endevor SCM はシーケンスタイプチェーンからエレメ

ントアクションを継続的にディスパッチします。 1 つのカテゴリ

値からのシーケンスタイプリクエストが処理中で、処理対象の非

シーケンスタイプリクエストが存在しない場合のみ、使用可能な

STC が待機する必要があります。



b. 次のリクエストが同じカテゴリ値を持っていない場合、CA Endevor

SCM は、非シーケンスタイプチェーンからリクエストをディス

パッチします。

カテゴリを指定しない場合、次のシーケンスタイプ番号のエレメ

ントアクションは、前のシーケンスタイプのすべてのアクション

の処理が完了するまで待機する必要があります。次に、非シーケ

ンスタイプエレメントアクションは、STC が使用可能になるか、

またはすべてのシーケンスタイプリクエストがディスパッチさ

れた後にディスパッチされます。シーケンスタイプリクエストが

処理中で、処理対象の非シーケンスタイプチェーンからのリクエ

ストが存在しない場合は、使用可能な STC がアイドルのままになり

ます。

2. 特定のシーケンスタイプおよびカテゴリのすべてのリクエストが処

理されると、CA Endevor SCM は、次のシーケンスタイプのリクエスト

の処理を開始します。

3. すべてのシーケンスタイプチェーンからのリクエストが完了すると、

非シーケンスタイプチェーンからの残りのリクエストがディスパッ

チされます。

PARMLIB データセットの割り当て

タイプシーケンスメンバを含めるには、PARMLIB データセットが必要で

す。 PARMLIB データセットを割り当てるには、サイトの CA Endevor SCM

JCLLIB データセット内の BC1JEPRM メンバを編集し、バッチジョブを実行

します。

注：代替 ID 機能がアクティブな場合、CA Endevor SCM は PARMLIB ファイル

にアクセスするときに代替 ID を使用します。



サイトのタイプシーケンスメンバの作成

グローバルタイプシーケンスのタイプ処理シーケンスを指定するには、

サイトにタイプシーケンスメンバが必要です。タイプシーケンスメンバ

内のタイプレコードの順序が、処理の順序を表します。メンバ内で定義

されていないタイプは、タイプシーケンスファイル内で定義されている

すべてのタイプが処理された後に、ターゲットシステムの MCF に保持さ

れているタイプ名の順に処理されます。以下の手順に従います。

以下のいずれかの方法でファイルを作成します。

■ BC1JBTSE ユーティリティを使用して順次作業ファイルに対するタイ

プシーケンスファイルを作成し、このファイルを編集します。

■ 標準の ISPF エディタを使用します。サイトに合わせて、タイプシー

ケンスレコードを追加します。

BC1JBTSE ユーティリティを使用したタイプシーケンスメンバの作成

グローバルタイプシーケンス用のタイプシーケンスメンバを作成する

には、ビルドユーティリティ BC1JBTSE を使用します。

次の手順に従ってください：

1. インストールの要件に合わせて、メンバ BC1JBTSE を編集します。次に、

このジョブを実行します。ビルドユーティリティは、サイトの CA

Endevor SCM CSIQJCL データセット内のメンバ BC1JBTSE です。

JCL は、順次作業ファイルにタイプシーケンスファイルを作成します。

ユーティリティは、サイトに対して定義されたすべてのタイプのタイ

プシーケンスレコードを作成します。このユーティリティは、サイ

トの C1DEFLTS テーブルで定義されているすべての MCF タイプを抽出

します。見つかった固有のタイプ名に対して、タイプシーケンスレ

コードが作成されます。 1 つのシステムのタイプシーケンスを別のシ

ステムのタイプシーケンスにマージすることはしません。固有のタイ

プレコードが、最初に定義されている C1DEFLTS 環境およびステージ

の組み合わせの最初のシステムから始めて、処理に従ってファイルに

書き込まれます。



タイプシーケンスレコードの説明フィールドには、最初の固有のタイ

プレコードの説明が格納されます。このユーティリティは、各タイプ

位置の出現を識別するために、コメントレコードを生成します。たと

えば、タイプ MAC がシステム BASE の下の環境 DEV （ステージ 1、2）

と、BASE の下の QA （ステージ 1、2）で定義されている場合、タイプ

シーケンスレコードの後に 4 つのコメントレコードが現れます。

シーケンスレコードの説明フィールドには、タイプの説明の値が設定

されます。

注：サイトにユーティリティで除外したい環境がある場合、これらの

環境を除外する一時 C1DEFLTS テーブルを作成し、一時 C1DEFLTS に対

してユーティリティを実行できます。たとえば、プロモートされたこ

とがない多数のエレメントが含まれる多数のテストシステムを持つ

環境が存在するとします。この環境を除外すると、生成される TYPE ス

テートメントの数が制限され、最初のタイプシーケンス順を定義する

のが簡単になります。その後、除外された環境から任意の有効なタイ

プを手動で追加します。

2. タイプレコードの順序を並び替えるか、またはタイプレコードを削除

して、このファイルを編集します。ファイル内のレコードの順序に

よって、タイプを処理する順序が決まります。

3. PARMLIB データセットにファイルをコピーします。

エディタを使用したタイプシーケンスレコードの作成

タイプシーケンスメンバ内のタイプレコードによって、グローバルタイ

プシーケンスのタイプ処理の順序を指定します。 ISPF エディタを使用し

て、タイプシーケンスファイルを作成できます。


1. タイプレコード構文 (P. 22)を使用して、ISPF エディタでタイプレ

コードをコード化します。サイトに合わせて、タイプレコードを追加

します。

2. タイプを処理する順序で、レコードの順序を指定します。



タイプシーケンスファイルのタイプレコード構文

タイプレコード構文によって、グローバルタイプ処理に対してタイプ

シーケンスメンバのタイプ処理シーケンスを定義します。

タイプレコードは、以下の構文を使用します。

TYPe ‘Type-name’ [SYStem ‘system-name’] [CATegory ‘category-value’]

DESCription ‘Sample Type Description’.

以下の一般的なルールが、タイプレコード構文に適用されます。

■ 文末の区切り文字であるピリオド（.）は必須です。

■ タイプ名と説明フィールドは、別々の行に存在してもかまいません。

■ レコードは、それぞれ 80 バイトです。

■ 列 73 から 80 にはテキストは表示されません。

■ 最初の列にアスタリスクを入力することで、ファイルにコメントを表

示できます。

TYPE Type-name

1 ～ 8 文字でタイプを指定します。単一引用符で名前を囲むのは任意

です。名前は大文字に変換されます。

SYSTEM system-name

（オプション）タイプが存在するシステム名を 1 ～ 8 文字で指定しま

す。単一引用符で名前を囲むのは任意です。同じ名前のタイプが別の

システムに存在する場合、この句により、各タイプとシステムの組み

合わせに別の処理順を指定できます。この句を省略すると、そのタイ

プ名のタイプシーケンス順がサイト全体に適用されます。名前は大文

字に変換されます。



CATEGORY category-value

（オプション）タイプグループに、1 ～ 8 文字の英数字で名前を指定

します。単一引用符でカテゴリ値を囲むのは必須です。並行アクショ

ン処理（CAP）のディスパッチ中に、カテゴリが指定されている場合、

そのカテゴリ値が前のリクエストと比較されます。カテゴリ値が一致

する場合、アクションは、前のリクエストと同時にディスパッチされ


カテゴリ値は、リクエストチェーンを構築または並べ替える方法に影

響せず、また通常の処理順序にも影響しません。このパラメータは、

両方のリクエストが同じカテゴリグループに存在する場合、シーケン

スの前のタイプが終了する前に、シーケンスの次のタイプが処理を開

始できるようにします。 CATEGORY 句を省略すると、タイプは、引き

続き順番に処理されます。

値は大文字に変換されます。 CAP が有効でない場合、CATEGORY 句は

効果がありません。

注： CAP が有効である場合に限り、タイプグループ化機能が処理に影

響します。これは、グローバルタイプシーケンス自体には効果があり

ません。グローバルタイプシーケンスのみでは、単にタイプシーケ

ンスで定義されたタイプ処理順が使用され、アクションの同時処理は

実行されません。

DESCription description

最大 50 文字でタイプの説明を入力します。単一引用符で説明を囲む

のは必須です。テキストに単一引用符が含まれる場合、これらの引用

符は空白に変換されます。説明文は、大文字または小文字で入力でき

ます。

例：タイプカテゴリを持つグローバルタイプシーケンス

この例では、以下の表に、管理者がタイプを処理したいと望む順序でエレ

メントタイプを示します。カテゴリ列は、並行アクション処理に関する

同時処理用のカテゴリを示します。したがって、並行アクション処理機

能を使用している場合、タイプ ASMMAC、CHDR、および COPYBOOK は同

時に処理できます。並行アクション処理が使用されているかどうかに関

係なく、タイプ CICSMAP のエレメントは、タイプ COPYBOOK のすべての

エレメントが完了するまで処理を開始できません。

タイプシステムカテゴリ説明

INCLUDE プロセッサの内容



PROCESS CA Endevor プロセッサ

OPT CONPARMX およびコンパイラオプション

PARM ユーティリティパラメータ

ASMMAC 1 アセンブラプログラムマクロ

CHDR 1 プログラムヘッダ

COPYBOOK 1 COBOL コピーブック

CICSMAP CICS マップ

ASMPGM 2 アセンブラプログラムソース

CPGM 2 C プログラムソース

COBOL 2 COBOL プログラムソース

FORTRAN 2 FORTRAN ソース

JAVA 2 JAVA ソース

PL1 2 PL/1 ソース

EZTINCL EZTRIEVE の内容

EZTRIEVE EZTRIEVE ソース

LINK Linkage-Editor JCL

BIND データベースのバインド



C1DEFLTS に対するタイプシーケンスメンバの定義

グローバルタイプシーケンスを有効にするには、PARMLIB データセット

とタイプシーケンスメンバの両方をデフォルトテーブル C1DEFLTS に定

義する必要があります。 PARMLIB データセットには、タイプシーケンス

メンバが格納されます。タイプシーケンスメンバが C1DEFLTS に定義され

ており、PARMLIB が定義されていないと、C1DEFLTS テーブルは正しくアセ

ンブルされません。タイプシーケンスメンバが空の場合、タイプ名の順

にタイプシーケンスが実行されます。

PARMLIB データセットとタイプシーケンスファイルを定義するには、

PARMLIB= パラメータおよび TYPESEQMBR= パラメータを C1DEFLTS に追加

し、アセンブルして、メンバ C1DEFLTS として許可ライブラリにリンクエ

ディットします。

例： C1DEFLTS でのタイプシーケンスメンバの定義

以下の例では、PARMLIB データセットとタイプシーケンスメンバが

C1DEFLTS テーブルで定義されています。 PARMLIB データセット名は

BST.CASCMMF.PARMLIB であり、タイプシーケンスメンバ名は ETYPESEQ で

す。

Col 1 Col 16 Col 72

C1DEFLTS TYPE=MAIN, X

.

.

.

PARMLIB='BST.CASCMMF.PARMLIB', X

TYPESEQMBR=ETYPESEQ, X

.

.

.

注：環境のサイト情報パネルには、C1DEFLTS から、サイト情報パネルの 2

番目の画面に、PARMLIB 情報が表示されます。



タイプシーケンスメンバの確認

タイプシーケンスメンバを作成し、C1DEFLTS テーブルで CA Endevor SCM

で識別した後、メンバの構文をテストできます。


1. CA Endevor SCM CLIST を起動します。

タイプシーケンステーブルが正しく定義されている場合、CA Endevor

SCM が開始します。テーブルにコーディングエラーがある場合、エ

ラーを識別するコンソールメッセージが表示されます。以下に例を示

します。

+ TYPE TYPE1 SYSTEM SYS1 CATEGORY 12345678A DESCRIP

+BSTPPARS: E006 VALUE SPECIFIED IS TOO LONG: 12345678A

+h:mm:ss B1TS011E TYPE SEQUENCE TABLE HAS ERRORS

+h:mm:ss B1TS012E SCL PROCESSING IS NOW DISABLED.

2. エラーがあれば修正し、再度 CLIST を起動します。 CA Endevor SCM が

表示されたら、前景でタイプシーケンス表示を開きます。

表示された処理シーケンスは、タイプシーケンスメンバで定義された

シーケンスと一致します。


第 3 章：並行アクション処理

ここでは、バッチジョブとパッケージの処理を高速化する並行アクショ

ン処理（CAP）機能を有効化、理解、アクティブ化、および管理する方法

について説明します。

この機能を有効にするには、CA Endevor SCM 管理者は、以下のロールのサ

ポートを必要とします。

■ CA Common Services 管理者（またはシステムプログラマ） — このロー

ルは、CAP に対して CA Common Services Common Communications

Interface （CAICCI）の生成機能を有効にするために必要です。

■ セキュリティ管理者 — このロールは、CAP に対して生成機能が動作で

きるようにサイトのセキュリティソフトウェアを設定するために必

要です。また、このロールは、CAP をアクティブ化できるユーザを制

限する場合にも必要です。


並行アクション処理を有効化および保護する方法 (P. 27)

CAP のセキュリティの設定 (P. 46)

並行アクション処理をアクティブにする方法 (P. 53)

並行アクション処理を監視する方法 (P. 58)

並行アクション処理を有効化および保護する方法

変更マネージャ（CA Endevor SCM 管理者）は、並行アクション処理（CAP）

機能を有効にして、バッチジョブとパッケージの処理を高速化できます。

CAP は、特定のエレメントアクション要求を同時に実行します。この処

理方法により、複数のアクションの処理に要する時間が短縮されます。

この機能のセットアップを完了するには、CA Common Services 管理者（ま

たはシステムプログラマ）およびサイトセキュリティ管理者のサポート

が必要です。必要に応じて、CAP を使用できるユーザを制限できます。



以下の図は、CAP を有効にする方法、および必要に応じて CAP へのユーザ

アクセスを保護する方法を示しています。



CAP を有効にする方法

CAP を有効にするには、以下のロールとタスクを使用します。

CA Endevor SCM 管理者

このロールは、以下の手順を実行します。

1. 前提条件を確認します (P. 31)。

2. CAP の生成パラメータを有効にします (P. 39)。

3. CA Common Services 管理者に、CAP に対する CAICCI 生成機能の有効

化タスクの実行を依頼します。また、このタスクが正しく完了し

たときに通知するよう依頼します。

4. セキュリティ管理者に、セキュリティソフトウェアでの CAP に対

する生成の有効化タスクの実行を依頼します。また、このタスク

が正しく完了したときに通知するよう依頼します。

CA Common Services 管理者


1. CAP に対する CAICCI 生成機能の有効化 (P. 41)

2. CA Endevor SCM 管理者に、CAP に対する CAICCI 生成機能の有効化

タスクが完了したことを通知します。

セキュリティ管理者


1. セキュリティソフトウェアで CAP の生成機能を有効にします。サ

イトで使用されているセキュリティソフトウェアに応じて、以下

のいずれかのタスクを完了します。

■ CAP に対して CA Top Secret を設定する方法 (P. 47)。

■ CAP に対して CA ACF2 を設定する方法 (P. 49)。

■ CAP に対して IBM RACF を設定する方法 (P. 50)。

2. CA Endevor SCM 管理者に、サイトのセキュリティソフトウェアが

CAP の生成機能を有効にするように設定されていることを通知し

ます。



CAP へのユーザアクセスをセキュリティ保護する方法

必要に応じて、CAP を使用できるユーザを制限できます。 CAP へのユー

ザアクセスを保護するには、以下のロールとタスクを使用します。

CA Endevor SCM 管理者


1. CAP のセキュリティ制御チェックポイントの設定 (P. 51)

2. セキュリティ管理者に、セキュリティソフトウェアで CAP への

ユーザアクセスを有効にするように依頼します。また、このタス

クが正しく完了したときに通知するよう依頼します。

セキュリティ管理者


1. セキュリティソフトウェアでの CAP へのユーザ読み取りアクセス

の有効化 — セキュリティ管理者は、CA Endevor SCM 管理者が CAP

に対するセキュリティチェックポイントとして定義した擬似デー

タセットに対して、サイトのセキュリティソフトウェアでユーザ

アクセスを有効にします。これは通常の手順のため、データセッ

トへのアクセスを有効にする方法の詳細は、CA Endevor SCM ド

キュメントには含まれていません。

2. CA Endevor SCM 管理者に、CAP データセットへのユーザアクセス

の有効化タスクが完了したことを通知します。




並行アクション処理にバッチジョブまたはパッケージをサブミットする

には、特定の前提条件を満たす必要があります。以下の前提条件を満た

します。

■ グローバルタイプシーケンスが有効になっていることを確認します。

グローバルタイプシーケンスは、サイトレベルで定義されたタイプ

シーケンスで、エレメントアクションのバッチ処理を実行します。 CAP

は、この機能を使用して、どのアクションを同時に処理できるかを判

断します。並行アクション処理（CAP）を使用する場合、グローバルタ

イプシーケンスが必要です。同時に処理できるタイプのカテゴリ定義

を追加することにより、CAP をさらに効率化できます。グローバルタ

イプシーケンスの詳細については、「並行アクション処理に対するグ

ローバルタイプシーケンスの影響 (P. 18)」を参照してください。グ

ローバルタイプシーケンスの有効化の詳細については、「グローバル

タイプシーケンスを有効にする方法」を参照してください。

■ CA Endevor SCM 管理者は、CAP を有効にする前に、生成パラメータを

正しく設定するために CAP がどのように動作するかを理解する必要が

あります。以下のトピックで、CAP の処理に関する説明を確認してく

ださい。

– 並行アクション処理 (P. 33)

– 並行アクション処理の仕組み (P. 34)

■ CA Endevor SCM をホストする z/OS メインフレームに、以下の CA

Common Services コンポーネントがインストールされ、実行されている

ことを確認します。

– CAIENF — イベント通知機能は、CAICCI 通信インターフェースコン

ポーネントを介して並行アクション処理を有効にします。サイト

で CAIENF r12 以降を実行している場合、並行アクション処理に

データベースは必要ありません。

– CAICCI — 共通通信インターフェースは、並行アクション処理、Web

サービス、Eclipse-Based UI、または CA CMEW を使用する場合にの

み必要です。

注： CA Endevor SCM は、CAIRIM （CA Common Services リソース初期化

マネージャ）コンポーネントを使用して製品のライセンスを許可しま

す。サイトで CAP または CA CMEW を使用するかどうかに関係なく、

CAIRIM は CA Endevor SCM を実行するために必須です。



注：コンポーネントがインストールされているかどうかを判断する方

法の詳細については、「CA Common Services 実行の確認 (P. 46)」を参

照してください。

■ （オプション） IBM z/OS VSAM レコードレベル共有（RLS）機能で CA

Endevor SCM VSAM データセットを管理できるようにします。これら

のデータセットには、すべてのマスタ制御ファイル（MCF）、エレメ

ントカタログと EINDEX、およびパッケージデータセットが含まれま

す。

RLS は、VSAM のパフォーマンスを改善し、CAP のパフォーマンスを向

上させます。

■ ルーティング領域 JCL 内で参照されている C1DEFLTS が、アクション要

求領域のプロシージャ JCL 内で参照されている C1DEFLTS と同じであ

ることを確認します。

■ EXIT が想定どおりに動作することを確認します。

ユーザ EXIT は、ルーティング領域およびアクション要求領域内で呼び

出されます。以下の表に、これらの EXIT の要約を示します。 EXIT の

詳細については、「Exits Guide」を参照してください。

EXIT 番号呼び出し場所呼び出されるタイミング

1 ルーティング領域、アクション要求領域セキュリティ呼び出し後

2 アクション要求領域のみアクション実行前

3 アクション要求領域のみアクション実行後

4 アクション要求領域のみ ADD、UPDATE、RETRIEVE の EXIT 2 の

前

5 ルーティング領域、アクション要求領域各ジョブで 1 度ずつ

6 ルーティング領域、アクション要求領域各 CA Endevor SCM の終了で 1 度ずつ

7 ルーティング領域、アクション要求領域各 CA Endevor SCM 起動で 1 度ずつ

注：処理のためにサブミットされるジョブ内の SCL 要求に対して、特定の

要件が適用されます。エレメント名には、ワイルドカードを使用できま

せん。また、すべての ADD、UPDATE、RETRIEVE アクションに関する To ス

テートメントと From ステートメントは、カタログ式データセットを参照

する必要があります。 SCL 要求の詳細については、「CAP の SCL 要件 (P.

58)」を参照してください。



並行アクション処理の概要

並行アクション処理（CAP）により、バッチジョブとパッケージの処理が

高速化されます。 CAP では、特定のエレメントアクション要求を同時に

実行できるため、複数のアクションの処理に要する時間が短縮されます。

CAP は、グローバルタイプシーケンスを使用して、どのアクションを同

時に処理できるかを判断します。 CAP 機能は、同じタイプの特定のエレメ

ントアクションを並行して処理し、次のタイプのエレメントの処理が開

始される前に、同じタイプのすべてのアクションの処理を完了する必要が

あります。ただし、グローバルタイプシーケンスで定義されていないア

クションタイプは、別のアクションと並行して処理することができます。

ADD、UPDATE、RETRIEVE、MOVE、GENERATE、DELETE、SIGNIN および CA

Endevor SCM から CA Endevor SCM への TRANSFER の各アクションは、同時

に処理することができます。要求のその他すべてのアクションは、シリ

アルに処理されます。

管理者は、CAP が許可されるかどうか、また単一のジョブが並行処理のた

めにスターティッドタスクをいくつ作成できるかを指定できます。これ

らのパラメータは、C1DEFLTS テーブルで設定されます。管理者は、ESI

（External Security Interface）を介して、CAP の使用を許可するユーザを制

限できます。この処理方法は、自動的には開始されません。ユーザが、

ジョブレベルで CAP を要求する必要があります。

注： CA CM Enterprise Workbench を使用した並行アクション処理は、パッ

ケージとエンタープライズパッケージでのみ使用でき、エレメントアク

ションでは使用できません。



並行アクション処理の仕組み

並行アクション処理（CAP）は、追加のサーバアドレス空間を動的に作成

して、特定のアクションを並行して処理します。この処理方法により、

多数のアクションの処理に要する時間が短縮されます。したがって、CAP

により、バッチジョブとパッケージの処理が高速化されます。

並行アクション処理を要求すると、要求は以下のように処理されます。

1. ワイルドカードまたはマスク処理されたアクションはすべて展開され、

タイプシーケンス順にアクションがソートされ、エレメントアクショ

ン要求のチェーンが作成されます。

注：予期しない結果を回避するため、同じジョブ内で 1 つのアクショ

ン（たとえば、すべての ADD アクション）をサブミットする場合のみ、

ワイルドカードまたはマスクを使用します。

2. RESTORE、アーカイブファイルからの LIST、TRANSFER などの、アーカ

イブファイルを入力として使用するアクションは、ルーティング領域

内で順次実行されます。これらのアクションは、必ずルーティング領

域内で順次実行されます。

3. その他のアクションを実行する前に、CA Endevor SCM は、CAP が有効

かどうか、またユーザが以下の順序で許可されるかどうかを判断しま

す。

a. CA Endevor SCM は、グローバルタイプシーケンスが有効かどうか

を判断します。

b. グローバルタイプシーケンスが有効な場合、要求 JCL に EN$CAP ま

たは EN$CAPnn DD カードがあるかどうかが調べられます。これら

のパラメータは、JCL が並行アクション処理を要求するかどうかを

示します。

c. JCL が CAP を要求する場合、C1DEFLTS パラメータの SPAWN と

SPAWNCNT の値が確認され、CAP が有効かどうかが確認されます。

d. ESI（External Security Interface）を通じて、ユーザがアクションの同

時処理を要求する許可を持っているかどうかが確認されます。

いずれかの条件が満たされていない場合、すべてのアクションが順次

実行されます。

4. ステップ 3 で CAP が要求され、検証済みとして許可されている場合、

ステップ 1 および 2 から残っているアクション要求のチェーンが確認

されます。その後、チェーンで見つかったすべての ADD、UPDATE、

RETRIEVE 要求が、以下のように前処理されます。



a. DDNAME はすべてデータセット名に変換されます（DDNAME が

ローカライズされます）。これらのデータセット名は、以下のよ

うにして作成されます。

■ CA Endevor SCM サーバが一時的なデータセット名を割り当て

ると、CA Endevor SCM は obname ではなく、CA Endevor SCM で

生成された名前にある jobnumber ノードを使用して名前を作

成します。これは、アクション要求領域間のデータセットの

競合を避けるために必要です。

■ 場合によっては、CA Endevor SCM では、システムで生成される

一時データセットの名前が、システム内で一意であることが要

求されます。これは、サーバ間のデータセットの競合を避け

るためです。現在、システムで生成された名前を持つ一時デー

タセットが CA Endevor SCM によって割り当てられる際、

DALDSNAM テキストユニットが指定されます。これにより一

時データセット名は以下の形式となり、一意でない可能性があ

ります。

SYSyyddd.Thhmmss.RA000.jobname.dsname.Hnn

ただし、アクションの同時処理用に作成されるアクション要求

領域では、CA Endevor SCM は一時データセットの一部に対して

DALDSNAM を除去する場合があります。これにより、生成され

る名前が、以下の形式で一意になります。

SYSyyddd.Thhmmss.RA000.jjobname.Rggnnnnn

注：同じプロセッサ手順で作成および削除された一時データセッ

トでは（つまり、DISP=(NEW,DELETE,DELETE) を指定して割り当てら

れている、または DISP を指定せずに割り当てられている）、

DALDSNAM は除去されません。これは、アクションの同時処理を

使用している場合でも、データセットは常に

SYSyyddd.Thhmmss.RA000.jobname.dsname.Hnndsname.Hnn として

生成されることを意味します。そのため、このようなデータセッ

トでは競合が発生する可能性があります。



b. 指定されたデータセット（DSNAME パラメータまたは DDNAME パ

ラメータを使用）が確認され、カタログ式データセットであるか

どうかが判断されます。データセットがアンカタログされたファ

イル（たとえば、SYSIN/SYSOUT データセット、一時データセット、

または NEW の配置を持つ非 SMS データセット）を参照する場合、

並行アクション処理を有効にすることはできません。また、アク

ションは順次処理されます。

重要： ADD 、UPDATE、または RETRIEVE アクションの実行の前に、EXIT

4 プログラムを使用して入力ファイルと出力ファイルを変更する場合、

SCL で指定するデータセットはカタログ式データセットである必要

があります。この要件は、データセット名を変更する EXIT 4 プログラ

ムが存在する場合にも適用されます。

5. アクション要求領域は、C1DEFLTS テーブルで設定された SPAWNCNT の

値と同じ数だけ作成されます。ただし、SPAWNCNT の値がジョブリク

エストで上書きされている場合は、その値を使用してアクション要求

領域の最大数が決定されます。この値は、以下の方法で特定のジョブ

に対して変更できます。

■ バッチリクエストでは、バッチジョブリクエスト JCL に

EN$CAPnn DD カードを使用。

■ 前景リクエストでは、パッケージのサブミットパネルまたはバッ

チオプションメニューで同時数フィールドを使用。

注： CA Endevor SCM がプロセッサから呼び出されると、サーバは作成

されません。また、並行アクション処理中にアクション要求領域が作

成されると、その領域では追加のサーバが作成されません。

6. アクション ADD、UPDATE、RETRIEVE、MOVE、GENERATE、DELETE、SIGNIN

および TRANSFER （CA Endevor SCM から CA Endevor SCM へ）は、アク

ション要求領域にディスパッチされます。同時に処理可能なアクショ

ンは、元のジョブのルーティング領域からアクション要求領域にルー

ティングされ、並行して処理されます。

■ ルーティング領域は、アクションを同時に処理するよう要求した

バッチジョブ、TSO セッション、または CA CM Enterprise Workbench

セッションです。

■ アクション要求領域は、アクションを処理するために作成される

スターティッドタスクです。複数のアクション要求領域が作成さ

れます。アクション要求領域はルーティング領域から個別のアク

ション要求を受け取り、それを処理し、結果を返します。



CAP は、グローバルタイプシーケンスを使用して、どのアクションを

同時に処理できるかを判断します。アクションを同時に処理できるか

どうかは、グローバルタイプシーケンスで決まります。同じタイプ

シーケンスのエレメントは、同時に処理できます。また、グローバル

タイプシーケンスにないエレメントは、どのエレメントとも同時に処

理できます。同じタイプシーケンスのエレメント（またはタイプシー

ケンスにないエレメント）に対するアクションが、SCL に現れる順序

で実行されるという保証はありません。しかし、同じ名前のエレメン

トに対するアクションは、エレメント名が明示的であれば、SCL に現

れる順序で順次処理されます。必ず 1 つのアクションが完了してから

次のアクションがディスパッチされます。

注： AUTOGEN を指定すると、アクションを処理する前に、SCL 要求が

現在のインベントリ内容に基づいてすべて解決されます。たとえば、

同じリクエスト内に AUTOGEN オプションを指定した GENERATE アク

ションと、複数の MOVE アクションが存在すると仮定します。 MOVE ア

クションには、GENERATE アクションの結果としてコピーバックされる

追加アクションは含まれません。

7. その他のすべてのアクションの処理が完了した後、データセットを

アーカイブする PRINT、ARCHIVE、LIST、および TRANSFER アクションが、

ルーティング領域で順次実行されます。

並行アクション処理に対するグローバルタイプシーケンスの影響

並行アクション処理（CAP）を使用する場合、グローバルタイプシーケン

スが必要です。同時に処理できるタイプのカテゴリ定義を追加すること

により、CAP をさらに効率化できます。カテゴリは、グローバルタイプ

シーケンステーブルで定義されています。

重要：グローバルタイプシーケンステーブルでカテゴリを指定しても、

シーケンスタイプと非シーケンスタイプのリクエストを作成および並べ

替える方法には影響しません。カテゴリは、並行アクション処理がアク

ションをディスパッチする方法にのみ影響します



CAP は、以下のようにリクエストを処理します。

1. CA Endevor SCM は、同時に処理するエレメント要求をディスパッチす

る場合、どのアクション要求をディスパッチするかを決定するときに、

タイプ、およびそのタイプに関連付けられているカテゴリの両方を参

照します。

a. シーケンスタイプチェーン内の次のリクエストに前のリクエス

トと同じカテゴリ値が含まれる場合、そのエレメントアクション

は使用可能な STC にディスパッチできます。

カテゴリを指定した場合、カテゴリ値が前のリクエストに一致す

る限り、CA Endevor SCM はシーケンスタイプチェーンからエレメ

ントアクションを継続的にディスパッチします。 1 つのカテゴリ

値からのシーケンスタイプリクエストが処理中で、処理対象の非

シーケンスタイプリクエストが存在しない場合のみ、使用可能な

STC が待機する必要があります。

b. 次のリクエストが同じカテゴリ値を持っていない場合、CA Endevor

SCM は、非シーケンスタイプチェーンからリクエストをディス

パッチします。

カテゴリを指定しない場合、次のシーケンスタイプ番号のエレメ

ントアクションは、前のシーケンスタイプのすべてのアクション

の処理が完了するまで待機する必要があります。次に、非シーケ

ンスタイプエレメントアクションは、STC が使用可能になるか、

またはすべてのシーケンスタイプリクエストがディスパッチさ

れた後にディスパッチされます。シーケンスタイプリクエストが

処理中で、処理対象の非シーケンスタイプチェーンからのリクエ

ストが存在しない場合は、使用可能な STC がアイドルのままになり

ます。

2. 特定のシーケンスタイプおよびカテゴリのすべてのリクエストが処

理されると、CA Endevor SCM は、次のシーケンスタイプのリクエスト

の処理を開始します。

3. すべてのシーケンスタイプチェーンからのリクエストが完了すると、

非シーケンスタイプチェーンからの残りのリクエストがディスパッ

チされます。



CAP の生成パラメータの有効化

CAP オプションでは、Defaults テーブル（C1DEFLTS）生成パラメータを有

効にする必要があります。 CAP はこれらのパラメータを使用して、複数の

エレメントアクションの同時処理を可能にするアドレス空間を生成しま

す。


1. iprfx.iqual.CSIQSRC にある C1DEFLTS メンバを開きます。

2. C1DEFLTS テーブルの TYPE=MAIN セクションで SPAWN=N を SPAWN=Y

に変更します。

CAP 用の生成機能は、CAP を有効にするように設定されます。

3. C1DEFLTS テーブルで以下のパラメータを設定します。

SPAWNCNT=n

CAP 使用時に開始された、生成領域のデフォルト番号を指定します。

有効な値は 2 ～ 99 ですが、パラメータ SPAWNMAX の値を超えるこ

とはできません。 SPAWN=Y の時に CAP を無効にするために、この

フィールドを 0 に設定することもできます。 SPAWN=N の場合、

SPAWNCNT を 0 に設定する必要があります。

SPAWNMAX=n

単一のジョブで生成可能なタスクの最大数を指定します。有効な

値は 2 から 99 です。 SPAWN=Y の時に CAP を無効にするために、

このフィールドを 0 に設定することもできます。 SPAWN=N の場合、

SPAWNMAX を 0 に設定する必要があります。

注： CA Common Communications Interface（CAICCI）SERVICE 定義

MAX#_PROCESSES を使用して、システム上のサービスプロセスの

合計数を制限できます。

SPAWNPROC=CAP_server_name

CAP サーバの 1 ～ 8 文字の名前を指定します。この名前は、CAICCI

SERVICE 定義 service_name およびスターティッドタスクプロシー

ジャ名である必要があります。名前が必要なのは、SPAWN=Y の場

合のみです。

注： SPAWN=Y および SPAWNCNT=0 の場合、CAP は無効です。ただし、

ジョブリクエスト JCL で EN$CAPnn DDNAME を使用することで、ユー

ザは特定のジョブの SPAWNCNT 値をオーバーライドできます。ただし、

ユーザは SPAWNMAX 値はオーバーライドできません。



End キーを押します。

C1DEFLTS へのユーザの変更が保存されます。生成パラメータは、ユー

ザの基本設定に合わせて設定されます。編集セッションが終了し、エ

ントリの編集パネルが表示されます。

4. フィールドへの入力を完了して、インストールライブラリ

iprfx.iqual.CSIQJCL にある BC1JTABL メンバを選択します。 Enter キーを

押します。

サンプル JCL BC1JTABL が ISPF Edit パネルで開きます。

5. ユーザのインストール基準に合うように、iprfx.iqual.CSIQJCL にあるサ

ンプル JCL BC1JTABL を編集します。ジョブを実行します。

Defaults テーブルはアセンブル、リンクエディットされ、メンバ

C1DEFLTS としてユーザの許可ユーザライブラリ、iprfx.iqual.CSIQAUTU

へ格納されます。生成パラメータは CAP 処理に有効です。ただし、

CAICCI 生成機能が CAP に対して有効になるまで、CAP は使用できませ

ん。

注：ステップ 4 および 5 の代わりに、SMP/E USERMOD を使用して、

C1DEFLTS をアセンブルおよびリンクエディットできます。

例: CAP 用の C1DEFLT 生成パラメータ

この例では、C1DEFLTS テーブルの生成パラメータは、CAP を有効にするよ

うに設定されています。 SPAWN=Y であるため、CAP 用の生成機能はアク

ティブにされます。 CAP が使用される場合、CAICCI は生成プロシージャ

ENDEVOR を使用します。 8 つの生成領域が開始されます。また、1 つのジョ

ブで最大 99 のアドレス空間を生成できます。

SPAWN=Y ACTIVATE THE SPAWN FACILITY

SPAWNCNT=8, SPAWN COUNT

SPAWNMAX=99, MAXIMUM SPAWN COUNT

SPAWNPROC=ENDEVOR, NAME OF SPAWN PROC

注： CA Common Services 管理者（または、システムプログラマ）に、CAP に

対して CAICCI 生成機能を有効化にするように依頼します。また、管理者

に、このタスクが正しく完了したときに通知するよう依頼します。



CAP に対する CAICCI 生成機能の有効化

CAP は CA Common Services Common Communications Interface（CAICCI）の

生成機能を使用します。この機能は、複数のアクションの同時処理を可

能にするために、複数のアドレス空間を生成します。この生成機能を使

用するには、以下のセットアップ手順が必要です。

■ CA Event Notification Facility（CAIENF）プロシージャで、CAP 生成パラメー

タ定義ファイルを、SPNPARMS DD の最後に追加する必要があります。

■ 生成パラメータファイルをカスタマイズする必要があります。このカ

スタマイズによって、CA Endevor SCM がインストールされている z/OS

環境に、アドレス空間を生成する生成機能を有効にするスターティッ

ドタスクを指定します。


1. ユーザの CAI.CAIPROC ライブラリにある CAIENF メンバを開きます。

注： CAIENF が CAI.CAIPROC ライブラリにない場合、システム管理者は

CAIENF メンバをユーザのシステム PROCLIB にコピーした可能性があ

ります。

2. 「SPNPARMS DD」という名前の CAP 生成パラメータファイル定義を

CAIENF プロシージャ JCL の最後に追加します。たとえば、以下のサン

プル JCL で、太字の 2 行を追加しカスタマイズします。

//ENF PROC OPTLIB='SYS2.CA90S.PARMLIB',

// ENFDB='SYS2.CA31.ENFDB',

// ENFPARM=ENFPRM31,

// SPNPAR1=SPWNSNMP,

// SPNPARn=ndvspawn,

// CCIPARM=CCIPCA31,

// ENFCMDS=ENFCMD31,

//ENF EXEC PGM=CAS9MNGR,TIME=1440

//CASRT01 DD UNIT=SYSDA,SPACE=(CYL,(5,1))







//SPNPARMS DD DISP=SHR,DSN=&OPTLIB(&SPNPAR1)

// DD DISP=SHR,DSN=&OPTLIB(&SPNPARn)

//SPNPRINT DD SYSOUT=X

//SPNDEBUG DD SYSOUT=X

//SRVDEBUG DD SYSOUT=X

//ENFDB DD DISP=SHR,DSN=&ENFDB

//ENFPARMS DD DISP=SHR,DSN=&OPTLIB(&ENFPARM)

// DD DISP=SHR,DSN=&OPTLIB(&CCIPARM)

//ENFCMDS DD DISP=SHR,DSN=&OPTLIB(&ENFCMDS)

//SYSPRINT DD SYSOUT=X

SPNPARn

CAIENF パラメータメンバのシンボリックを指定します。「n」の

値は、生成機能のパラメータファイルのリストで、連続する次の

番号である必要があります。

ndvspawn

CAP の生成パラメータファイルを指定します。この手順の全体で、

このファイルは「ndvspawn」と呼ばれます。ステップ 4 でメンバ

を保存する場合、メンバにユーザのサイトに適した名前を付ける

ことができます。しかし、SPNPARMS DD ステートメントのここなど、この手順で ndvspawn が参照される場合は常に、必ずその名前を置換してください。


変更内容が保存されます。 CAP 生成パラメータファイルは、CAICCI 用

の CAIENF 手順に定義されます。編集セッションが終了し、エントリ

の編集パネルが表示されます。

3. インストールソースライブラリ iprfx.iqual.CSIQOPTN にある CAPCCI メ

ンバを、ISPF 編集パネルで開きます。



4. CAPCCI ファイル内の CAICCI SERVICE および PROCESS ステートメントを

編集して、生成パラメータをカスタマイズします。 procname とタスク

名が同じであることを確認します。サンプルファイルで提供されてい

るステートメントをそのまま保持し、スペースおよび列の配列も変更

しません。

********************************************************************

* CCI SERVICE STATEMENTS FOR ENDEVOR

********************************************************************

ENDEVOR SERVICE SERVER_NAME=MVS_START_SERVER,

DEALLOCATE=TERMINATE,

LOST_CLIENT=DEALLOCATE,

MAX#_SERVICES=100,

MAX#_CLIENTS=1,

MAX#_PROCESSES=100,

SERVICE_UNAVAILABLE=START_SERVICE,

START=SPAWN_ONLY,

SIGNON/NOPASSCHK=SERVICE

********************************************************************

* CCI PROCESS STATEMENTS FOR ENDEVOR

********************************************************************

PROCESS PROCESS_TYPE=MVS_STC,

PROCNAME=ENDEVOR,

SERVICE ステートメント

ホストアプリケーションを指定します。

PROCESS ステートメント

CA Endevor SCM を実行する JCL プロシージャを指定します。



PROCNAME=procname

生成機能が開始するスターティッドタスクプロシージャの名前

を指定します。たとえば、PROCNAME=ENDEVOR のように指定しま

す。

次に、Save コマンドを入力し、CAP の生成パラメータファイル

（ndvspawn）の名前を指定します。

CAP 生成パラメータファイル（ndvspawn）は、CAP のアドレススペー

スを生成するために CAICCI が使用できるスターティッドタスクプロ

シージャを指定するためにカスタマイズされます。変更内容が保存さ

れます。編集セッションが終了し、エントリの編集パネルが表示され

ます。

5. カスタマイズされたファイルを CAI.PARMLIB データセットに、メンバ

ndvspawn として保存します。

これで、ファイルは CAP のアドレススペースを生成するために CAICCI

がそれを使用できる場所に保存されました。

6. CA Endevor SCM で配布される CSIQJCL ライブラリにある ENDEVOR メ

ンバを、ISPF 編集パネルで開きます。

7. ユーザのサイトに適するようにサンプル ENDEVOR スターティッドタ

スクプロシージャを編集します。次に、コマンドラインで「Copy」

と入力し、ファイルをコピーする JES に定義されている PROCLIB を指

定します。

変更内容が保存されます。スターティッドタスクプロシージャ

ENDEVOR は、複数のエレメントアクションの同時処理が可能なアドレ

ス空間の生成に使用できます。編集セッションが終了し、エントリの

編集パネルが表示されます。



8. CAICCI をリサイクルするか、IPL を実行します。

CAICCI への変更は有効です。そのため、CAICCI SPAWN 機能は CAP に対

して有効で、CA Endevor SCM は CAP オプションでサブミットされた

ジョブを処理できます。ユーザが前景パネルからバッチジョブまたは

パッケージをサブミットする場合、CAP を指定するオプションはパネ

ルで使用可能です。

注： ENDEVOR 以外の PROC 名を使用する場合は、PROC 名が使用される他の

ロケーションを更新します。 C1DEFLTS テーブル内の SPAWNPROC パラメー

タ、および PROCLIB メンバ内の CAICCI サービス名および CAICCI PROC のす

べてに同じ値が含まれていることを確認します。このパラメータは、

CAICCI 定義で指定される PROCNAME= 値と同じ名前です。

これで、バッチジョブおよびパッケージの処理を高速化するために、同

時アクション処理（CAP）機能の有効化に成功しました。

注： CA Endevor SCM 管理者に、CAP に対して CAICCI 生成機能が有効になっ

ていることを通知します。

CAP のセキュリティの設定


CA Common Services が実行中であることの確認

CA Common Services コンポーネント CAIRIM、CAIENF、CAICCI がメインフ

レームにインストールされていて、実行中である必要があります。 CAIENF

と CAICCI が必要になるのは、同時アクション処理機能または CA CMEW を

使用する場合のみです。それらがまだインストールおよび実行されてい

ない場合は、「CA Common Services for z/OS 導入ガイド」に記載されてる手順に従って、それらのサービスをインストールする必要があります。

CAIENF と CAICCI がインストールされており実行されているかどうか判断する方

法

1. SDSF ステータス表示に移動し、プレフィックス「ENF*」を入力します。

注：システム上にアクティブな ENF* がない場合は、システムプログラ

マに連絡して、それを起動してもらってください。

2. ジョブが実行されている場合は、それを選択し、ジョブ内で CAICCI を

検索します（見つけます）。

■ CAICCI が見つかる場合、CAIENF と CAICCI は実行されています。

■ CAICCI が見つからない場合は、ユーザサイトの CAI.CAIPROC ライブ

ラリを確認して、サイトで CAICCI を実行するために ENF メンバが

変更されているかどうかを確認します。

ENF メンバが存在しない場合は、CA Common Services 管理者（また

はシステムプログラマ）に連絡して、システム上の CAIRIM、CAIENF、

CAICCI のステータスを判断してください。


サイトのセキュリティ管理者は、サイトで使用されているセキュリティ

ソフトウェアに応じて、セキュリティソフトウェアで CAP に対して生成

機能を有効にする必要があります。 CA Endevor SCM 管理者は、CA Endevor

SCM で CAP のセキュリティ制御チェックポイントを設定する必要があり

ます。これらのタスクについて、以下に説明します。



CAP に対して CA Top Secret を設定する方法

CAIENF （CA, Inc. Event Notification Facility）で C1DEFLTS テーブルに定義さ

れた SPAWNPROC を生成するには、対応するデフォルトユーザ ID を使用

してセキュリティソフトウェアパッケージにタスクを定義する必要があ

ります。これらの定義を使用して、CAIENF は生成されたタスクを開始し

ます。タスクはデフォルトユーザ ID のセキュリティコンテキストで開始

されますが、その後、CA Endevor SCM ジョブをサブミットするユーザのセ

キュリティコンテキストに切り替えられます。

重要：以下の説明では、ENDEVOR は、SPAWNPROC スターティッドタスク

名およびその対応するユーザ ID の両方を表します。サイトに代替ユーザ

ID として定義した ENDEVOR というユーザ ID がすでに存在する場合は、

ENDEVOR をタスク名またはタスクユーザ ID として使用しないでくださ

い。代わりに、別の値を選択します。代替 ID（ALTID）は、C1DEFLTS テー

ブルに RACFUID=ENDEVOR として定義されます。

サイトで CA Top Secret セキュリティを使用する場合は、以下の手順に従い

ます。

1. CAP に対する新しい機能名 ENDEVOR を定義します。これを実行するに

は、以下の定義を Top Secret セキュリティパラメータファイル

（PARMFIELD DD ステートメントによって指定）に追加します。

* USERnn FACILITY FOR

*

FAC(USERnn=NAME=ENDEVOR)

FAC(ENDEVOR=xxxx)

ここで、「xxxx」は、デフォルト以外に設定されるその他の機能制御

オプションです。機能は、TSS MODIFY コマンドを使用して動的に定義

できます。以下に例を示します。

TSS MODIFY(FAC(USERnn=NAME=ENDEVOR))

TSS MODIFY(FAC(ENDEVOR=xxxx))

TSS MODIFY コマンドは、CA Top Secret の次のリサイクルまでのみ有効

です。



2. 以下のコマンドを入力して、ENDEVOR という名前の新しい ACID を定

義します。

TSS CRE(ENDEVOR) NAME(endevor user-id?) TYPE(USER) FAC(STC,ENDEVOR) PAS(xxxx,0)

TSS ADD(ENDEVOR) FAC(STC)

CA Top Secret は、すべてのスターティッドタスク（STC） ACID にパス

ワードを指定すること、および CA Top Secret パラメータファイルに

OPTIONS(4) を設定することを推奨しています。 OPTIONS(4) を設定する

と、STC が開始するときに、パスワード用のプロンプトが表示されま

せん。ただし、STC ACID でログオンする場合、パスワードを知ってい

る必要があります。

ENDEVOR ACID の NODSNCHK、NORESCHK、および NOSUBCHK バイパス

属性が必要な場合があります。それ以外の場合は、ACID に対して、必

要とするすべてのファイルとリソースへのアクセスが許可されている


3. 以下のコマンドを入力して、ENDEVOR ACID に MASTFAC 定義を指定し

ます。

TSS ADD(ENDEVOR) MASTFAC(ENDEV0R)

4. 以下のコマンドを入力して、CAICCI 生成タスク ENDEVOR のデフォルト

の ACID として、ユーザ ID ENDEVOR を割り当てます。

TSS ADD(STC) PROCNAME(ENDEVOR) ACID(ENDEVOR)

5. 以下のコマンドを入力して、CA SCM for Mainframe の各ユーザに、

ENDEVOR 機能へのアクセス権を付与します。

TSS ADD(USER-ID) FAC(ENDEVOR

注：新しい機能の定義の詳細については、「CA Top Secret Security

Control Options 」を参照してください。 CRE コマンドと ADD コマンド

の詳細については、「CA Top-Secret Security Command Functions 」を参




CAP に対して CA ACF2 を設定する方法














CAP に対して CA ACF2 を設定するには、以下の手順に従います。

1. 以下のコマンドを入力して、並行アクション処理のスターティッドタ

スクに対して、ENDEVOR という名前の STC ログオン ID を作成します。

ACF

INSERT ENDEVOR NAME(ENDEVOR) STC

2. ENDEVOR ログオン ID が UID 文字列の作成に使用されるフィールドな

どのサイト固有のログオン ID フィールドで定義されていることを確

認します。

3. ログオン ID 用の CA ACF2 セキュリティアクセスルールを作成して、

ENDEVOR ログオン ID が ENDEVOR タスク内のすべてのデータセット

に対するアクセス権を持つことを確認します。

注： CA ACF2 の設定の詳細については、「ACF2 Security Administration

Guide」を参照するか、または CA ACF2 のテクニカルサポートまでお問い

合わせください。



CAP に対して RACF を設定する方法














IBM RACF をカスタマイズして並行アクション処理のスターティッドタス

クを正しく初期化できるようにするには、以下の手順に従います。

1. 以下のいずれかの方法を使用して、RACF に対してスターティッドタス

クを定義します。

■ STARTED クラスに対して新しいプロファイルを定義（IBM が推奨）

■ スターティッドプロシージャテーブル（ICHRIN03）に新しいエン

トリを追加

注：詳細については、「IBM RACF Security Administrator Guide」を参照

してください。



2. スターティッドタスク xxxxxxxx に RACF ユーザ ID を割り当て、スター

ティッドプロシージャの開始を許可されている RACF グループにユー

ザ ID を割り当てます。 xxxxxxxx に RACF ユーザ ID を定義するには、

ADDUSER コマンドを使用して、以下のように既存のスターティッドタ

スクの RACF グループに関連付けます。

ADDUSER user_name DFLTGRP(default_group) OWNER(default_group) NOPASSWORD

user_name

新しい RACF ユーザ ID の名前を指定します。この名前は、CAP が

使用する PROCLIB 内のスターティッドタスクメンバと同じ名前に

する必要があります。

default_group

システムのすべてのスターティッドタスクが含まれるデフォルト

グループを指定します（例： STCGROUP）。

注：このコマンドは一例です。 ADDUSER コマンドの使用方法の詳細に

ついては、RACF 管理者にお問い合わせください。

注：デフォルトグループの名前が不明な場合は、RACF 管理者にお問い

合わせください。 RACF STARTED クラスの実装、またはスターティッド

タスクテーブル（ICHRIN03）の変更の詳細については、「IBM RACF

Security Administrator Guide」を参照してください。

CAP のセキュリティ制御チェックポイントの設定

CA Endevor SCM External Security Interface （ESI）で擬似データセットを定

義することにより、CAP に対してセキュリティ制御チェックポイントを設

定できます。擬似データセットは、データセットアクセスルールを表し

ます。擬似データセットは物理データセットを参照しません。

セキュリティ制御チェックポイントは、サイトのセキュリティソフト

ウェアと共に動作して、ユーザに CAP を使用する権限があるかどうかを判

定します。ユーザに CAP の使用を許可するには、セキュリティソフトウェ

アでユーザに対して擬似データセットへの読み取りアクセスを許可する

必要があります。ユーザに CAP を使用する権限がない場合、アクション

は、グローバルタイプシーケンスで定義された順序で処理されます。


1. iprfx.iqual.CSIQSRC インストールライブラリにある External Security

Interface （ESI）の Name Equates テーブルのメンバ BC1TNEQU を開き

ます。



2. NAMEQU CONCURRENT_ACT_PROC エントリを追加して、L1 と L2 の値を

指定します。

NAMEQU CONCURRENT_ACT_PROC.

L1=('high_level_qualifier'),

L2=('next_level_qualifier')

NAMEQU CONCURRENT_ACT_PROC

CAP 処理を保護するために RACROUTE マクロが使用する擬似デー

タセット名を指定します。以下の値を設定します。

L1

データセットの高レベル修飾子を指定します。

L2

データセットの次のレベルの修飾子を指定します。擬似デー

タセットの用途がわかりやすいように、CAP の値を指定するこ

とをお勧めします。


変更内容が保存されます。 CAP のセキュリティチェックポイントとし

て機能する擬似データセット名が ESI の Name Equates テーブルで定

義されます。編集セッションが終了し、エントリの編集パネルが表示

されます。

3. BC1TNEQU メンバをアセンブルおよびリンクエディットします。

ユーザが CAP へのアクセスを要求すると、External Security Interface

（ESI）で定義された擬似データセットが、セキュリティ制御チェック

ポイントとして動作します。サイトのセキュリティソフトウェアが

ユーザに擬似データセットへの読み取りアクセスを許可している場

合、ユーザは CAP を使用できます。

注： CAP へのアクセスを許可したいユーザに擬似データセットへの読み

取りアクセス権を付与するようセキュリティ管理者に依頼します。また、

セキュリティ管理者に、このタスクが正しく完了したときに通知するよう

依頼します。

並行アクション処理をアクティブにする方法


例： Name Equates テーブル用のサンプル CONCURRENT_ACT_PROC ルール

この例では、Name Equates テーブルに以下のエントリが含まれます。

NAMEQU CONCURRENT_ACT_PROC.

L1=('C1'),

L2=('CAP')

データセットライブラリ C1.CAP に対する読み取り権限を持つユーザは、

CAP を要求する権限があります。


バッチジョブとパッケージの処理の高速化に、並行アクション処理（CAP）

オプションを使用しできます。 CAP をアクティブにするには、CA Endevor

SCM を実行するジョブステップに EN$CAP ステートメントまたは

EN$CAPnn DD ステートメントが必要です。また、CAP 処理に対してサブ

ミットされるバッチジョブまたはパッケージ内の SCL ステートメントが、

特定の要件を満たしている必要があります。

DD ステートメントを追加し CAP をアクティブにするには、以下のいずれ

かの方法を使用します。

■ バッチ JCL での CAP のアクティブ化 (P. 54)

■ 前景でサブミットされるパッケージでの CAP のアクティブ化 (P. 56)

■ 前景でサブミットされるバッチジョブでの CAP のアクティブ化 (P.

57)

SCL 要件の詳細については、「CAP の SCL 要件 (P. 58)」を参照してください。

注： CAP を使用するには、CA Endevor SCM 管理者がこのオプションを有効

にする必要があります。 CAP の有効化の詳細については、「並行アクショ

ン処理を有効化および保護する方法 (P. 27)」を参照してください。



バッチ JCL での CAP のアクティブ化

多数のアクションを含むバッチジョブとパッケージの処理を高速化する

ために、CA Endevor SCM を実行する JCL で並行アクション処理を要求でき

ます。


1. SCL 要求が以下の要件を満たしていることを確認します。

■ すべてのエレメントが完全に修飾されており、ワイルドカードが

使用されていない。

■ すべての ADD、UPDATE、REQUEST ステートメントで、参照される

データセットがカタログ式データセットである。

注： SCL の要件の詳細については、「CAP の SCL 要件 (P. 58)」を参照し

てください。

2. CA Endevor SCM を実行するジョブステップに EN$CAP ステートメント

または EN$CAPnn DD ステートメントを追加します。

注：前景パネルからバッチ処理用のジョブまたはパッケージをサブ

ミットする場合、パネル上に並行アクション処理を指定するオプショ

ンがあります。このオプションを選択すると、サブミットされた JCL に

EN$CAPnn DD ステートメントが自動的に追加されます。

//EN$CAP DD SYSOUT=*

このジョブに対して作成可能な並行アクション処理プロセッサの数が、

C1DEFLTS 内の SPAWNCNT の値と等しくなるように指定します。並行

アクション処理を実行するためには、C1DEFLTS 内で SPAWN=Y をコー

ド化し、SPAWNCNT に 1 よりも大きな値を設定する必要があります。



//EN$CAPnn DD SYSOUT=*

nn

1 つのジョブに対して許可されるアクション要求領域の最大数を

指定します。このパラメータは、CAP によって使用される ECSA

（Extended Common Storage Area）を制限します。

00 – 並行アクション処理は使用されず、アクションは順次処理さ

れます。

02-nn – ジョブに対して許可されるアクション要求領域の最大数を

示します。 C1DEFLTS の SPAWNCNT の値はこの値で上書きされます

が、C1DEFLTS の SPAWNMAX の値は指定変更されません。並行アク

ション処理を有効にするには、C1DEFLTS 内で SPAWN=Y をコード化

する必要があります。 nn に指定する値を算出するには、以下の式

を使用します。式内の x は EN$CAPnn の nn の値と同じです。

■ CAP が開始される前に解放する必要がある ECSA の最小値を算

出するには、以下の式を使用します。

ECSA の最小値 = 3.6K*x + 3.2K

■ CAP ジョブが使用できる ECSA の最大値を算出するには、以下

の式を使用します。

ECSA の最大値 = 40.1K*x + 3.2K

■ すべての ECSA 空きストレージを消費せずに CAP ジョブが使用

できる ECSA ストレージ領域のサイズを算出するには、以下の

ように最大値に 20% を追加します。

ECSA の最大値 + 20% = (40.1K*x + 3.2K)1.20

処理設定が行われます。ジョブをサブミットすると、設定に従って処

理されます。ジョブステップに対して JCL 内に複数の EN$CAPnn カー

ドが含まれている場合、最初のカードだけが使用されます。



前景でサブミットされるパッケージでの CAP のアクティブ化

多数のアクションを含むバッチジョブとパッケージの処理を高速化する

ために、CA Endevor SCM を実行する JCL で並行アクション処理を要求でき

ます。








てください。

2. パッケージのサブミットパネルで、以下のオプションを編集します。

注： CAP が有効でない場合、パネルの以下のオプションはグレー表示さ

れます。

並行アクション処理

このフィールドは、並行アクション処理を使用するかどうかを指

定するために使用します。有効な値は、Y および N です。パネル

を表示した時点のデフォルト値は N です。サイトでこの機能が有

効でない場合、このオプションは読み取り専用です。

同時数

並行アクション処理を使用している場合に、並行して処理するア

クションの数を指定します。デフォルトは、C1DEFLTS で設定され

た SPAWNCNT の値です。デフォルトを上書きし、次にデフォルト

を使用する場合は、このフィールドにデフォルト値を入力してか

ら空白にします。有効な値は、02 からパネルに表示されている最

大数の範囲です。最大数は、C1DEFLTS で指定された SPAWNMAX の

値です。

処理設定が設定されます。ジョブをサブミットすると、設定に従って




前景でサブミットされるバッチジョブでの CAP のアクティブ化

前景のパッケージのサブミットパネルからバッチ処理用のジョブをサブ

ミットする場合、並行アクション処理を要求できます。








てください。

2. バッチオプションメニューで以下のオプションを編集します。

Concurrent Action Processing

このフィールドは、並行アクション処理を使用するかどうかを指

定するために使用します。有効な値は、Y および N です。パネル

を表示した時点のデフォルト値は N です。サイトでこの機能が有

効でない場合、このオプションは読み取り専用です。

同時数

並行して処理するアクションの数を指定します。デフォルトは、

C1DEFLTS で設定された SPAWNCNT の値です。デフォルトを上書き

し、次にデフォルトを使用する場合は、このフィールドにデフォ

ルト値を入力してから空白にします。有効な値は、02 からパネル

に表示されている最大数の範囲です。最大数は、C1DEFLTS で指定

された SPAWNMAX の値です。

処理設定が行われます。ジョブをサブミットすると、設定に従って処

理されます。

並行アクション処理を監視する方法


CAP の SCL 要件

バッチジョブまたはパッケージが CAP 処理に対してサブミットされる場

合、正しく処理されるために、これらのジョブ内の SCL ステートメントが

以下の要件を満たす必要があります。

■ 同じジョブでさまざまなアクションをサブミットする場合は、SCL で

明示的なエレメント名を使用します。

エレメント名またはメンバ名内でワイルドカードを使用している場合

は、同じエレメントに対するアクションが、指定された順序で処理さ

れない可能性があります。たとえば、以下のようなコードを作成し、

ADD ステートメントの後に GEN を続けた場合、GEN を開始する前に

ADD が完了しない可能性があります。

ADD ‘*’ TO ENV ‘TESTENV’ SYSTEM ‘TESTSYS’ SUBSYSTEM ‘TESTSBS’ TYPE ‘TESTTYPE’…

GEN ‘*’ FROM ENV ‘TESTENV’ SYSTEM ‘TESTSYS’ SUBSYSTEM ‘TESTSBS’ TYPE ‘TESTTYPE’

…

■ ジョブごとに 1 つのアクションをサブミットする場合は、ワイルド

カードまたはマスクを使用できます。たとえば、同じジョブで複数の

ADD アクションをサブミットする場合、ワイルドカードを使用できま

す。

■ SCL 要求を調べます。ジョブで並行アクション処理を使用する場合は、

すべての ADD、UPDATE、および RETRIEVE アクションを確認し、TO FILE、

TO DSNAME、TO DDNAME、および FROM FILE、FROM DSNAME、FROM

DDNAME で参照されているすべてのデータセットがカタログ式デー

タセットであることを確認します。アンカタログデータセット、一

時データセット、JES2 ファイルデータセットにすることはできませ

ん。

■ サイトで EXIT 4 プログラムを使用して、ADD、UPDATE、RETRIEVE の実

行前に入出力ファイルを変更する場合、EXIT 4 プログラムがデータ

セット名を変更する場合であっても、SCL 内で指定されたデータセッ

トがカタログ式データセットであることを確認します。


並行アクション処理（CAP）を監視する場合、CA Endevor SCM 管理者は、

MVS modify コマンドを使用してアクションステータスを表示 (P. 59)でき

ます。



アクションステータスの表示

アクションのステータスを判定するために、ルーティング領域に対して

MVS の MODIFY コマンドを実行することができます。応答は領域のジョ

ブログに書き込まれます。

MVS MODIFY コマンドの一般的な形式は以下のとおりです。

F jobname.identifier,parameters

D[ISP] STAT

D[ISP] STATS

D[ISP] STATISTICS

統計を表示します。

DISPLAY STATISTICS コマンドは、以下の応答を返します。

Number of Completed Requests nnnnnn

Number of Executing Requests nn

Number of Action Request regIons nn

Max Elapsed Time so far nnnnnn Act# num Stmt #num action element

type

Min Elapsed Time so far nnnnnn Act #num Stmt #num action

element type

Total Elapsed Time collected so far nnnnnn

D[ISP] ACTIVE REQS

D[ISP] ACTIVE REQUESTS

現在アクティブなアクション要求のステータスを表示します。このパ

ラメータは、以下の応答を返します。

ACT# num Stmt #num ACTIVE ON jobname jobnumber cci-id action element type.

D[ISP] SERVERS

作成されたサーバのステータスを表示します。サーバが要求の処理で

ビジー状態の場合、要求に関する情報を表示します。このパラメータ

は、以下の応答を返します。

REGION jobname jobnumber cci-id status [ACT# nnnn STMT# nnnn action element-type]

cci-id ステータスは、BUSY、AVAILABLE、UNINITIALIZED のいずれかにな

ります。アクション要求領域が BUSY の場合、アクション番号、ステー

トメント番号、実行中のアクション、処理対象のエレメント、エレメ

ントタイプが表示されます。


第 4 章： AUTOGEN アクションオプション

ここでは、ソフトウェア開発者が ADD、UPDATE、GENERATE アクションの

ターゲットであるコンポーネントを使用するエレメントを自動的に生成

する方法を説明します。この機能は、AUTOGEN アクションオプションを

使用します。


「using」エレメントを自動的に生成する方法 (P. 62)

前提条件の確認 (P. 64)

AUTOGEN アクションオプション (P. 65)

AUTOGEN および AUTOGEN SPAN 処理の例 (P. 75)

「using」エレメントを自動的に生成する方法



ソフトウェア開発者は、コンポーネントを使用するエレメントを自動的に

生成できます。このようなエレメントは、using エレメントと呼ばれてい

ます。たとえば、コンポーネントエレメントのコピーブック COPYA を持っ

ている場合、そのコピーブックを使用するプログラムは using エレメント

です。自動的に using エレメントを生成するには、コンポーネントエレメ

ントを処理する ADD、UPDATE、GENERATE アクションに対して AUTOGEN ア

クションオプションを指定します。このオプションはバッチでのみ使用

可能です。パッケージでは使用できません。

以下の図は、using エレメントを自動的に生成する方法を示しています。



自動的に using エレメントを生成するには、以下の手順に従います。


2. バッチ処理リクエストで、AUTOGEN または AUTOGEN SPAN アクション

オプションをコード化します (P. 69)。

3. （オプション）影響分析用に、シミュレーションモードで AUTOGEN

バッチジョブを実行します (P. 74)。

4. バッチリクエストをサブミットします。注：バッチジョブのサブミッ

トの詳細については、「User Guide」を参照してください。

注： AUTOGEN アクションオプションはバッチでのみ使用できますが、コ

ンポーネントエレメントは、前景またはバッチで以下のように生成でき

ます。

■ GENERATE アクションは、アクションのターゲットを生成します。

■ エレメントを追加、更新、転送、または復元すると、自動的に生成さ

れます。ただし、前景でエレメントの生成オプションを N に設定する

か、バッチで Bypass GENERATE プロセッサを指定した場合、エレメン

トは生成されません。これらのオプションは、エレメントの追加、更

新、転送、復元後にプロセッサの生成を実行しないように CA Endevor

SCM に指示します。




AUTOGEN アクションオプションを使用する前に、以下の前提条件を満た

していることを確認します。

■ サイトで CA Endevor Automated Configuration オプションを購入して、

有効にしていることを確認します。［サイト表示］パネルを使用する

と、ユーザのサイトでこのオプションが有効（ASCM=Y）に設定されて

いるかどうかを確認できます。

■ グローバルタイプシーケンスが有効になっていることを確認します。

この処理オプションは、サイトレベルで定義されたタイプシーケンス

で、エレメントアクションのバッチ処理を実行します。 AUTOGEN に

はグローバルタイプシーケンスが必要で、これにより、すべてのコン

ポーネントの処理が完了した後、コンポーネントを使用するエレメン

トが生成されます（たとえば、ソースの前にマクロ、ロードモジュー

ルの前にソース、など）。グローバルタイプシーケンスの有効化の

詳細については、http://www.ca.com/support で「How to Enable Global

Type Sequencing」を参照してください。

■ オプション機能テーブルで AUTOGEN_SOURCE 設定を確認します。

AUTOGEN_SOURCE がオンではない場合、using エレメントの GENERATE

アクションは、NoSource オプションで作成されます。これはデフォル

トです。管理者は、オプション機能テーブル（ENCOPTBL）で

AUTOGEN_SOURCE をアクティブにすることにより、AUTOGEN 機能の動

作を変更できます。このオプションがアクティブな場合、using エレ

メントの GENERATE アクションは、NoSource オプションではなく

Copyback オプションで作成されます。

■ このシナリオは、ユーザが以下の知識を持っていることを前提として

います。

■ 前景または ISPF パネルを使用して、バッチタスクを実行する方法。

詳細については、「User Guide」の「Performing Batch Tasks in

Foreground」を参照してください。

■ SCL ステートメントをコード化する方法。詳細については、「SCL

Reference Guide」を参照してください。

AUTOGEN アクションオプション


■ AUTOGEN がどのように動作するかを理解します。 AUTOGEN は、ター

ゲットコンポーネントと同じ論理マップにある using エレメントのみ

を生成します。また、特定の AUTOGEN SPAN オプションも、論理マッ

プにある環境とステージ内のさまざまなシステムとサブシステムにあ

る using エレメントを生成します。以下のトピックでは、さまざまな

AUTOGEN オプション、およびそれらがどのように処理に影響するかに

ついて説明します。

– AUTOGEN アクションオプション (P. 65)

– Autogen アクションオプションが処理に及ぼす影響 (P. 67)

– AUTOGEN SPAN オプションの動作 (P. 72)

– AUTOGEN および AUTOGEN SPAN 処理の例 (P. 75)

– AUTOGEN SPAN ユースケース


コンポーネントエレメントの ADD、UPDATE、GENERATE アクションにおい

て指定された場合、AUTOGEN アクションオプションは using エレメントを

自動的に生成します。 using エレメントは、コンポーネントエレメントを

使用するエレメントです。たとえば、AUTOGEN がコピーブック COPYA に

対して指定された場合、そのコピーブックを使用するプログラムは using

エレメントです。マクロタイプのエレメントに対して AUTOGEN を指定す

ると、マクロを使用するソースエレメントを自動的に生成します。その

後、適切なリンクエレメントを生成します。

AUTOGEN は、ADD、UPDATE、GENERATE アクションに対して、バッチでの

み利用可能であり、パッケージでは使用できません。元の生成されたエ

レメントからの CCID およびコメントが使用されます。 AUTOGEN は、ター

ゲットコンポーネントと同じインベントリロケーションまたは論理マッ

プの上部にある using エレメントのみを生成します。システムまたはサブ

システム全体に存在する using エレメントを生成するには、AUTOGEN SPAN

オプションを使用できます。 SPAN オプションの詳細については、「管理ガイド」の「システムおよびサブシステム間の AUTOGEN SPAN (P. 72)」を

参照してください。



ステートメントグループ内のいずれか 1 つにおいて AUTOGEN オプショ

ンを指定すると、ステートメントが実行される前に、これらすべてのス

テートメントが現在のインベントリの内容に基づいて解決されます。

GENERATE ELEMENT* などのステートメントは、GENERATE アクションのロ

ケーションおよびオプションに基づいてアクションを作成します。処理

中、重複した GENERATE アクションは排除され、AUTOGEN で作成されたす

べての GENERATE アクションに対してソースなしオプションが有効にな

ります。管理者は、オプション機能テーブル（ENCOPTBL）で

AUTOGEN_SOURCE をアクティブにすることにより、AUTOGEN 機能の動作

を変更できます。このオプションがアクティブな場合、using エレメント

の GENERATE アクションは、NoSource オプションではなく Copyback オプ

ションで作成されます。

AUTOGEN はコンポーネントの重複処理を排除し、必要なユーザ操作を減

らすことによって処理効率を向上させます。ユーザは、Automated

Configuration Manager Query （ACMQ）機能を使用してエレメントコンポー

ネントに対する追加 GENERATE アクションを作成し、それから処理用に別

のバッチジョブを実行するという操作をする必要がなくなりました。

AUTOGEN をシミュレーションモードで実行して、AUTOGEN リクエストの

影響を確認することができます

AUTOGEN には以下の制限が適用されます。

■ AUTOGEN にはグローバルタイプシーケンスが必要で、これにより、

すべてのコンポーネントの処理が完了した後、コンポーネントを使用

するエレメントが生成されます（たとえば、ソースの前にマクロ、ロー

ドモジュールの前にソース、など）。

■ AUTOGEN は、タイプがグローバルタイプシーケンステーブルにリス

トされているコンポーネントにのみ動作します。コンポーネントのタ

イプがグローバルタイプシーケンステーブルにリストされていない

場合、AUTOGEN リクエストは無視されます。

■ サイトでは、オプションの CA Endevor Automated Configuration を購入

およびアクティブ化しておく必要があります。［サイト表示］パネル

を使用すると、ユーザのサイトでこのオプションが有効（ASCM=Y）に

設定されているかどうかを確認できます。



■ AUTOGEN は、パッケージに含まれるアクションでは指定できません。

承認者は承認すべき SCL ステートメントを参照する必要があるためで

す。

■ AUTOGEN および BYPASS GENERATE ELEMENT （GENERATE ELEMENT=N）

オプションは排他関係にあります。

■ AUTOGEN はバッチオプションです。フォアグラウンドリクエストで

は指定できません。

AUTOGEN アクションオプションが処理に及ぼす影響

AUTOGEN は、ADD、UPDATE、GENERATE アクションに対して、バッチでの

み利用可能であり、パッケージでは使用できません。 Generate ステート

メントまたは ADD または UPDATE リクエストをからエレメントが生成さ

れ、Autogen オプションが指定されると、CA Endevor SCM は要求を以下の

ように処理します。

1. 生成中のコンポーネントエレメントを使用するすべてのエレメント

に対して、ACMQ 検索が実行されます。

2. 各 using エレメントに対して GENERATE アクションが作成され、実行さ

れるアクションのリストに追加されます。ただし、重複した GENERATE

アクションは除去されます。そのため、同じエレメントを使用する複

数のコンポーネントが生成されている場合でも、個々の using エレメ

ントは一度だけ生成されます。

個々の using エレメントに対して作成された GENERATE アクションは、

以下のように実行されます。

■ コンポーネントと同じインベントリの場所に using エレメントを

生成する。

■ 元のステートメントで指定したのと同じ CCID および COMMENT を

使用する。

■ 元のステートメントで指定されている場合、サインアウトを無視

する。

■ NoSource オプションを使用する。

注：管理者は、オプション機能テーブル（ENCOPTBL）で

AUTOGEN_SOURCE をアクティブにすることにより、AUTOGEN 機能

の動作を変更できます。このオプションがアクティブな場合、using

エレメントの GENERATE アクションは、NoSource オプションでは

なく Copyback オプションで作成されます。



そのため、using エレメントは以下の GENERATE ステートメントに指定

したように生成されます。

GENERATE エレメント名

FROM <元のコマンドのインベントリの場所>

TYPE タイプ

OPTION CCID <同じ CCID>

COMMENT <同じ COMMENT>

<元のコマンドで指定されている場合、サインアウトを無視>

NOSOURCE.

元のアクションで Copyback オプションが指定されている場合、

Copyback は元のリクエストで指定されているコンポーネントエレメ

ントにのみ適用されます。 NoSource オプションは、管理者が ENCOPTBL

で AUTOGEN_SOURCE オプションをアクティブにしている場合を除き、

using エレメントに対して作成されたすべての GENERATE ステートメ

ントで常に使用されます。

3. AUTOGEN は、タイプがグローバルタイプシーケンステーブルにリス

トされているコンポーネントにのみ動作します。コンポーネントのタ

イプがグローバルタイプシーケンステーブルにリストされていない

場合、AUTOGEN リクエストは無視されます。

4. グローバルタイプシーケンスを使用して、エレメントを作成する順序

を指定します。ただし、AUTOGEN オプションを指定すると、アクショ

ンを処理する前に、SCL 要求が現在のインベントリ内容に基づいてす

べて解決されます。複数のアクションが指定され、そのアクションの

尐なくとも 1 つに Autogen オプションが指定されている場合、アク

ションを処理する前にすべてのアクションが展開されます。名前のマ

スキングはすべて解決され、個々のアクションが作成されます。次に、

展開されたアクションがグローバルタイプシーケンスの順序に従っ

て実行されます。

したがって、AUTOGEN 生成オプションが指定され、いくつかの MOVE

アクションが同じリクエストに含まれている場合、MOVE アクション

には GENERATE アクションの結果としてコピーバックされる追加の要

素は含まれません。



例：同じリクエストに MOVE アクションが含まれている場合の Autogen の処理

この例では、Macro MD1 は DEV ステージ 1 の場所に存在します。このマ

クロは、DEV ステージ 1 の場所にあるプログラム PD1、および QA ステー

ジ 2 の場所にあるプログラム PQ2 と PQ3 で使用されます。同じバッチ

ジョブに、以下の 2 つのアクションが含まれています。

SET FROM ENV DEV SYS SYS1 SUBS SUB1 STAGE NUM 1.

GENERATE ELE MD1 OPTION AUTOGEN

MOVE ELE *

DEV ステージ 1 のロケーションで生成されるエレメント MD1、PD1、PQ2、

および PQ3 の場所でアクションの結果を生成します。ただし、MOVE アク

ションでは、MD1 と PD1 のエレメントのみが論理マップの次の場所に移

動されます。 PQ2 と PQ3 は STG1 の場所に存在しなかったため、DEV ス

テージ 1 の環境に残ります。

AUTOGEN をコード化する方法

自動的に using エレメントを生成するには、バッチで ADD、UPDATE、

GENERATE アクションに対して AUTOGEN アクションオプションのいずれ

かを指定します。この手順では、前景バッチパネルからこのタスクを実

行する方法について説明します。前景でバッチタスクを実行する代わり

に、ISPF メニューからバッチタスクを実行できます。

1. プライマリオプションメニューから、オプション 3 （バッチ）を選択

します。

バッチオプションメニューが表示されます。

2. タスクに応じてフィールドに入力します。オプション 1 （SCL の作成）

を選択して、Enter キーを押します。

SCL 生成パネルが表示されます。このパネルでは、生成するアクショ

ン要求のタイプを選択できます。

3. 実行するアクション（ADD、UPDATE、GENERATE）に対応するオプショ

ン番号を指定し、Enter キーを押します。

Enter キーを押すと、選択したアクションオプションに対応するアク

ションパネルが表示されます。



4. ADD、UPDATE、GENERATE アクションをコード化し、次のいずれかの

AUTOGEN アクションオプションを指定します。また、BYPASS

GENERATE PROCESSOR オプションが設定されていないことを確認しま

す。

AUTOGEN

アクションのターゲットであるコンポーネントを使用するすべて

のエレメントを生成します。これらの using エレメントは、SCL ス

テートメントで指定されたターゲットロケーションに生成されま

す。ターゲットロケーションに存在しない場合、これらのエレメ

ントはオプション機能テーブル（ENCOPTBL）の設定に応じて、ソー

スなしエレメントまたはソース付きエレメントとしてターゲット

ロケーションに戻されます。 SOURCE_OPTION パラメータを

ENCOPTBL に設定する方法については、CA Endevor SCM 管理者にお

問い合わせください。 CA Endevor Quick Edit または前景バッチパネ

ルから AUTOGEN または AUTOGEN SPAN NONE を指定した場合、SCL

は「AUTOGEN SPAN NONE」として記述されます。

AUTOGEN SPAN NONE

処理対象のコンポーネントを使用するすべてのエレメントを生成

します。このオプションは「AUTOGEN」オプションと同じ効果が

あります。

AUTOGEN SPAN ALL

コンポーネントの論理マップにある環境とステージ内のすべての

システムとサブシステムの組み合わせにある using エレメントを

生成します。



AUTOGEN SPAN SYSTEMS

エレメントのサブシステム名がターゲットコンポーネントのサブ

システム名と一致するすべてのシステムにある using エレメント

を生成します。コンポーネントの論理マップまたはマップ上部の

環境とステージ内にあるシステムのみが検索されます。このオプ

ションは、同じサブシステム名を持つその他のシステムが検索さ

れるという点で AUTOGEN オプションとは異なります。

AUTOGEN SPAN SUBSYSTEMS

指定されたコンポーネントの同じ名前のシステムを持つすべての

サブシステムから using エレメントを生成します。コンポーネント

の論理マップまたはマップ上部の環境とステージ内のターゲット

コンポーネントのシステムにあるサブシステムのみが検索されま

す。このオプションは、同じシステムを持つその他のサブシステ

ムが検索されるという点で AUTOGEN オプションとは異なります。

ADD、UPDATE、GENERATE リクエストの SCL ステートメントには、選択

した AUTOGEN オプションが含まれます。

注： AUTOGEN、または任意の AUTOGEN SPAN アクションオプションは、Set

Options ステートメントで指定できます。 Set Options ステートメントは、

次の Set Options ステートメントまたは Clear Options ステートメントが出

現するか、処理が終了するまで、すべての後続のアクションに対して 1 つ

または一連のオプションを適用するように CA Endevor SCM に指示します。

エレメントアクションステートメントにオプションを入力し、Set Options

ステートメントでそのオプションをコード化した場合、アクションス

テートメントのエントリは Set Options の選択内容を上書きします。



AUTOGEN SPAN オプションの動作

AUTOGEN は、ターゲットコンポーネントと同じ論理マップにある using エ

レメントのみを生成します。また、AUTOGEN SPAN オプションも、論理マッ

プにある環境とステージ内のさまざまなシステムとサブシステムにある

using エレメントを生成します。 using エレメントは、AUTOGEN リクエス

トで指定されたターゲット環境およびステージで生成されますが、using

エレメントのシステムとサブシステム内になります。 SPAN 拡張機能によ

り、システムまたはサブシステムにわたって using エレメントを容易に配

置および生成できます。

すべての AUTOGEN および AUTOGEN SPAN の結果について、ターゲットロ

ケーションに現在存在しない生成されたエレメントが、ソースなしエレメ

ントとして戻されます。ただし、管理者は、オプション機能テーブル

（ENCOPTBL）で AUTOGEN_SOURCE をアクティブにすることにより、

AUTOGEN 機能の動作を変更できます。このオプションがアクティブな場

合、using エレメントの GENERATE アクションは、NoSource オプションで

はなく Copyback オプションで作成されます。

また、すべての AUTOGEN および AUTOGEN SPAN の結果について、using エ

レメントがマップされていない環境にあるか、それらがコンポーネントの

ターゲットロケーションの下位にある場合、using エレメントは生成され

ません。

AUTOGEN SPAN オプションをシミュレーションモードで実行して、

AUTOGEN リクエストの影響を確認することができます。

AUTOGEN オプションで有効な値は、以下のとおりです。

■ AUTOGEN または AUTOGEN SPAN NONE：指定したコンポーネントと同

じ論理マップにある using エレメントのみを生成します。「AUTOGEN」

または「AUTOGEN SPAN NONE」を指定した場合、SCL は「AUTOGEN SPAN

NONE」として記述されます。

■ AUTOGEN SPAN ALL：すべてのシステムおよびサブシステムから using

エレメントを生成します。

■ AUTOGEN SPAN SYSTEMS：指定されたコンポーネントの同じ名前のサ

ブシステムを持つすべてのシステムから using エレメントを生成しま

す。

■ AUTOGEN SPAN SUBSYSTEMS：指定されたコンポーネントの同じ名前の

システムを持つすべてのサブシステムから using エレメントを生成し

ます。



SPAN オプションには、以下の制限があります。

■ 共通ライブラリは、using エレメントのシステムおよびサブシステムの

GENERATE プロセッサ連結に含まれている必要があります。ライブラ

リが含まれていない場合、GENERATE アクションには、システムまたは

サブシステムにわたって検索する際にコンポーネントに対して行われ

た変更が含まれます。

■ 同じシステムおよびサブシステムは、それぞれの環境およびステージ

の場所に存在する必要があります。たとえば、ELEMENTA が PROD 環

境のシステム A の using エレメントである場合は、システム A が DEV

環境にも存在する必要があります。

■ SPAN には、ターゲット環境およびマップの上部にあるシステムまたは

サブシステムの using エレメントのみが含まれます。

■ SPAN には、環境マップの外部の using エレメントは含まれません。



影響分析用のシミュレーションモードでの AUTOGEN の実行

AUTOGEN をアクティブにして実際にアクションを実行しなくても、

AUTOGEN オプションをシミュレーションモードで実行して、結果を確認

することができます。シミュレーションモードでは、バッチジョブ内の

すべてのアクションの実行がバイパスされます。更新は行われません。こ

の手順では、AUTOGEN で処理するアクションに対して、すでに AUTOGEN

がコード化されていることを前提にしています。


1. AUTOGEN オプションが含まれるバッチジョブに EN$AUSIM DD ステー

トメントを追加します。前景バッチリクエスト（または CA Endevor

Quick Edit リクエスト）に対して、Include Additional JCL オプションを使

用して DD ステートメントを追加します。以下に、DD ステートメント

の例を示します。

//EN$AUSIM DD SYSOUT=*

2. 処理するジョブをサブミットします。

C1MSGS1 および C1MSGS2 レポートは、アクションが実行された場合の

構文リクエストレポートおよびアクションサマリレポートを表示し

ます。シミュレーションモードでジョブが実行されたことを示す「***

AUTOGEN シミュレーション ***」というタイトルの見出しが表示され

ます。

3. これらのレポートを影響分析に使用して、アクションが実行された場

合の結果を確認します。

AUTOGEN および AUTOGEN SPAN 処理の例



以下の例では、同じエレメントに対するさまざまな AUTOGEN アクション

オプションの影響を示します。それぞれの例では、いずれかのオプショ

ンでのインベントリの元の状態に対する影響を示します。

すべての例において、システム SYSTEMC のサブシステム SUB1 および

SUBC には、アプリケーションシステム SYSTEM1、SYSTEM2、SYSTEM3 で

プログラムのコンパイルに使用されるエレメントが含まれています。図

には、コンポーネントエレメント COPYC1 と using プログラム PGMC1 およ

び PGMC2 が強調表示で示されています。

DEV は QAS にマッピングされ、QAS は PRD にマッピングされます。 EMER

環境は PRD にマッピングされます。 ADMIN は独立しており、その他のす

べての環境が使用するプロセッサを保持しています。

すべての例は、以下の条件を前提としています。

■ 共通 SYSTEMC ライブラリは、全環境のすべてのアプリケーションシス

テムのすべての GENERATE プロセッサで連結されます。

■ したがって、DEV の共通システムで行われたすべての変更は、PRD へ

のパッケージまたはプロモーションが実行される前に、すべてのス

テージでアプリケーションシステムによって自動的に適用されます。

■ これらのユースケースでは、COPYC1 はすべての PGMC、PGMC1、およ

び PGMC2 プログラムのコンポーネントです。

■ 各ユースケースでは、エレメントとロケーションが元の図に示すとお

りであることを前提にしています。ユースケースは、前のユースケー

スによる影響を受けません。



すべての例の処理前のイメージ

AUTOGEN を指定した GENERATE の前 — 以下の図は、AUTOGEN を指定した

GENERATE リクエストを実行する前の元の状態のエレメントを示していま

す。

例 1： AUTOGEN または AUTOGEN SPAN NONE

この例では、開発者は、DEV の共通 SYSTEMC のサブシステム SUB1 内の

COPYC1 を変更し、同じ論理マップ内ですべての using エレメントを自動的

に生成します。これを実行するため、開発者は、AUTOGEN または AUTOGEN

SPAN NONE を指定した以下の GENERATE リクエストを実行します。

GENERATE ELEMENT 'COPYC1'

FROM ENVIRONMENT 'DEV'

SYSTEM 'SYSTEMC'

SUBSYSTEM 'SUB1'

TYPE COPYBOOK

STAGE NUMBER 1

OPTIONS CCID REQ#43023

COMMENT 'EDIT COMMON COPY BOOKS'

COPYBACK

AUTOGEN SPAN NONE .



以下に、この GENERATE リクエストの影響を示します。

■ コピーブック COPYC1 は、コピーバックされ、DEV/SYSTEMC/SUB1/1 で

生成されます。

■ マップの上部の PRD/SYSTEMC/SUB1/2 にある PGMC1 は、NOSOURCE エ

レメントとして DEV/SYSTEMC/SUB1/1 で生成されます。

■ コンポーネントの論理マップの外部の、その他の using プログラムは

影響を受けません。

これで、開発者はテストを完了して、影響を受けるすべてのエレメントが

含まれるパッケージを MOVE アクションを使用して作成できます。

AUTOGEN を指定した GENERATE の後 — 以下の図は、AUTOGEN または

AUTOGEN SPAN NONE を指定した GENERATE リクエストが、ターゲットロ

ケーションの環境「DEV」、ステージ 1、システム「SYSTEMC」、サブシス

テム「SUB1」の COPYC1 に対して実行された後の結果を示しています。



例 2： AUTOGEN SPAN ALL


COPYC1 を変更し、すべてのシステムおよびサブシステムでコピーブック

を使用するすべての using エレメントを自動的に生成します。これを実行

するため、開発者は、AUTOGEN SPAN ALL を指定した以下の GENERATE リ

クエストを実行します。



SYSTEM 'SYSTEMC'

SUBSYSTEM 'SUB1'

TYPE COPYBOOK

STAGE NUMBER 1



COPYBACK

AUTOGEN SPAN ALL .




■ マップの上部の PRD/SYSTEMC/SUB1/2 にあるエレメント PGMC1 は、

NOSOURCE エレメントとして DEV/SYSTEMC/SUB1/1 で生成されます。

■ マップの外部の PRD/SYSTEMC/SUBC/2 にあるエレメント PGMC2 は、

NOSOURCE エレメントとして DEV/SYSTEMC/SUBC/1 で生成されます。

■ マップの外部の PRD/SYSTEM1/SUB1/2 にあるエレメント PGMC1 は、

NOSOURCE エレメントとして DEV/SYSTEM1/SUB1/1 で生成されます。



■ マップの外部の DEV/SYSTEM2/SUB1/1 にあるエレメント PGMC は、そ

の場所で生成されます。

■ AUTOGEN SPAN はターゲット環境の PGMC のシステムおよびサブシス

テムで GENERATE リクエストを作成しようとしますが、

DEV/SYSTEM2/SUBA/1 が存在しないため、マップの外部の

PRD/SYSTEM2/SUBA/2 にあるエレメント PGMC はバイパスされます。







■ マップの外部の EMER/SYSTEM2/SUB1/2 にあるエレメント PGMC は、

EMER がコンポーネント COPYC1 の環境マップ内に存在しないため、影

響を受けません。



AUTOGEN SPAN ALL の後 — 以下の図は、AUTOGEN SPAN ALL を指定した

GENERATE リクエストが、ターゲットロケーションの環境「DEV」、ステー

ジ 1、システム「SYSTEMC」、サブシステム「SUB1」の COPYC1 に対して

実行された後の結果を示しています。



例 3： AUTOGEN SPAN SYSTEMS


COPYC1 を変更し、サブシステムを除くすべてのシステムでコピーブック

を使用するすべての using エレメントを自動的に生成します。これを実行

するため、開発者は、AUTOGEN SPAN SYSTEMS を指定した以下の GENERATE

リクエストを実行します。



SYSTEM 'SYSTEMC'

SUBSYSTEM 'SUB1'

TYPE COPYBOOK

STAGE NUMBER 1



COPYBACK

AUTOGEN SPAN SYSTEMS .








■ マップの外部の DEV/SYSTEM2/SUB1/1 にあるエレメント PGMC は、そ

の場所で生成されます。



■ マップの外部の EMER/SYSTEM2/SUB1/2 にあるエレメント PGMC は、

EMER がコンポーネント COPYC1 の環境マップ内に存在しないため、影


■ サブシステム SUB1 を除くその他のサブシステムは、AUTOGEN SPAN

SYSTEMS リクエストによる影響を受けないため、サブシステム SUBA、

SUBC、SUB2 の using エレメントは生成されません。





AUTOGEN SPAN SYSTEMS の後 — 以下の図は、AUTOGEN SPAN SYSTEMS を指

定した GENERATE リクエストが、ターゲットロケーションの環境「DEV」、

ステージ 1、システム「SYSTEMC」、サブシステム「SUB1」の COPYC1 に

対して実行された後の結果を示しています。

例 4：AUTOGEN SPAN SUBSYSTEMS


COPYC1 を変更し、現在のシステム内のすべてのサブシステムでコピー

ブックを使用するすべての using エレメントを自動的に生成します。これ

を実行するため、開発者は、AUTOGEN SPAN SUBSYSTEMS を指定した以下

の GENERATE リクエストを実行します。



SYSTEM 'SYSTEMC'

SUBSYSTEM 'SUB1'

TYPE COPYBOOK

STAGE NUMBER 1



COPYBACK

AUTOGEN SPAN SUBSYSTEMS .








■ マップの外部の PRD/SYSTEMC/SUBC/2 にあるエレメント PGMC2 は、

NOSOURCE エレメントとして DEV/SYSTEMC/SUBC/1 で生成されます。

■ その他のサブシステムは AUTOGEN SPAN SUBSYSTEMS リクエストによ

る影響を受けないため、システム SYSTEM1、SYSTEM2、SYSTEM3 の using

エレメントは生成されません。



AUTOGEN SPAN SUBSYSTEMS の後 — 以下の図は、AUTOGEN SPAN

SUBSYSTEMS を指定した GENERATE リクエストが、ターゲットロケーショ

ンの環境「DEV」、ステージ 1、システム「SYSTEMC」、サブシステム「SUB1」

の COPYC1 に対して実行された後の結果を示しています。


第 5 章：パッケージ配布機能

ここでは、CA Endevor SCM 管理者がパッケージ配布機能を有効化、使用、

および管理する方法を説明します。この機能を使用すると、ホストサイ

トからリモートサイトにパッケージ出力（USS ファイル、ソース、オブジェ

クト、リスト、またはロードモジュール)、パッケージバックアウトメン

バ、または USS バックアウトメンバを転送できます。さらに、配布後ス

クリプト機能を使用すると、パッケージ配布プロセスが完了した後、ユー

ザが作成したジョブステップ（スクリプト）を有効にしてリモートの配

布先で条件付きで実行することができます。


パッケージ配布を設定する方法 (P. 84)

パッケージ配布を有効にする方法 (P. 85)

パッケージシップ用に USS サポートファイルを有効にする方法 (P. 148)

配布後スクリプトの実行を有効にする方法 (P. 158)

ホストパッケージ出荷ジョブステップ (P. 167)

リモートコピー/削除ジョブステップの動作 (P. 175)

配布を作成、追跡、確認する方法 (P. 178)

パッケージ配布の管理 (P. 197)

パッケージ配布を設定する方法


パッケージ配布を設定する方法

変更マネージャ（CA Endevor SCM 管理者）は、パッケージ配布機能を有効

にして、必要に応じて USS サポートファイルの配布を準備できます。

以下の図は、複数のシナリオで構成される、この複雑なシナリオを示して

います。

■ パッケージ配布機能を有効にする方法 (P. 85)

■ USS サポートファイルのバックアップファイルを作成する方法 (P.

148)

パッケージ配布を有効にする方法



CA Endevor SCM 管理者は、パッケージ配布機能を有効にして、パッケージ

出力（ソース、オブジェクト、リスト、またはロードモジュール）また

はパッケージバックアウトメンバをホストサイトから別のサイトに送信

できます。バックアウトメンバを配布すると、パッケージ出力の以前の

配布を元に戻すことができます。このユーティリティは、ソフトウェア

をセントラル（ホスト）サイトで開発し、別の（リモート）サイトにソー

ス、オブジェクト、または実行可能コードを送信したいユーザ向けに設計

されています。

以下の図は、パッケージ配布機能を有効にする方法を示しています。



パッケージを配布する前に、以下の手順に従ってパッケージ配布を有効に

します。


2. パッケージ配布ユーティリティプログラムの設定 (P. 104) — パッ

ケージ配布ユーティリティプログラムをサイトで設定する必要があ

ります。

注： USS サポートファイル（HFS、zFS、または NFS ファイル）を配布

する場合は、バックアップファイルを作成する必要があります。この

手順の詳細については、「パッケージ配布用に USS サポートファイル

を有効にする方法 (P. 148)」を参照してください。

3. リモートの配布先を確立します (P. 120)。

4. データセットマッピングルールを確立します (P. 126)。

5. モデル転送制御ステートメントの作成 (P. 136) — ローカルの転送方

法を使用しない場合は、以下のデータ転送パッケージのいずれかが使

用可能である必要があります。

■ XCOM（CA）

■ 大量データ転送プログラム（IBM）、バージョン 2、または NJE/NJI

を使用

■ NetView File Transfer Program （IBM）

■ CONNECT:Direct

注：パッケージは、DASD を共有する CPU 間でも配布できます。この

転送方法は「ローカル」と呼ばれます。

6. （オプション）配布後スクリプト機能の有効化 (P. 158) — この機能は、

パッケージ配布プロセスの完了前または完了後に、リモートの配布先

でスクリプトと呼ばれるカスタムジョブステップの条件付きの実行

を有効にします。

7. （オプション） Ship Asis 機能の有効化 (P. 103) — この機能は、パッ

ケージのバックアウトステータスに従って、出力およびバックアウト

メンバ（および HFS ファイル、または両方）の配布を可能にします。有

効でない場合、パッケージが実行された時点からの出力は、パッケー

ジのバックアウトステータスにかかわらず配布されます。




ユーザがパッケージを配布できるようになるには、特定の前提条件を満た

す必要があります。以下の前提条件を満たします。

■ パッケージ配布がどのように動作するかを理解します。以下のトピッ

クを確認してください。

– パッケージ配布ユーティリティ (P. 89)

– パッケージ配布の仕組み (P. 90)

– パッケージ配布と USS ファイルの仕組み (P. 93)

– Ship Asis 機能 (P. 95)

– 配布後スクリプト機能 (P. 96)

– 配布後スクリプトの実行の仕組み (P. 97)

■ パッケージ配布機能はデータ転送ソフトウェアを必要とします。以下

のデータ転送方法のいずれかが使用可能であることを確認します。

– CA XCOM

– 大量データ転送プログラム（IBM）、バージョン 2、または NJE/NJI

を使用

– NetView File Transfer Program （IBM）

– CONNECT:Direct

注：パッケージは、DASD を共有する CPU 間でも配布できます。この

転送方法は「ローカル」と呼ばれます。

■ 以下のセキュリティ要件が満たされていることを確認してください。

– 関連するすべての ID に OMVS セグメントが必要です。これは、こ

れらのセグメントによって、ID がシェル環境の開始および USS コ

マンドの発行を行えるためです。これらの ID には、配布を実行す

る ID（サインオンしたユーザ）、代替 ID、および転送方法スター

ティッドタスク（XCOM、Connect direct など）が含まれます。

– 配布を行うユーザ（ACID または XAUTH 権限）に代わって、転送方

法スターティッドタスクにジョブのサブミットを許可する必要が

あります。

– 転送方法ステップを実行しているユーザ ID には、適切なロードラ

イブラリへのアクセス権限が必要です。



– 関連するユーザは、ACL を使用し、CHOWN CHMOD コマンドをリ

モートコマンドファイルに挿入するために、ステージングディレ

クトリロケーションプレフィクス（デフォルトでは /tmp/）およ

びターゲットディレクトリに対する読み取り/書き込み権限が必

要です。

– オプション機能 PACKAGE_SHIP_WITH_ALTID がオンになっている場

合、以下が必要です。

■ 代替 ID に、適切なロードライブラリへの読み取りアクセス権

限が必要です。

■ 転送方法スターティッドタスクに、代替 ID に代わってジョブ

をサブミットする権限を許可する必要があります。

パッケージ配布ユーティリティ

パッケージ配布ユーティリティ（C1BMX000 プログラム）は、データ転送

プログラムを使用して、パッケージ出力（USS ファイル、ソース、オブジェ

クト、リスト、またはロードモジュール）、パッケージバックアウトメ

ンバ、または USS バックアウトメンバをホストサイトから別のサイトに

送信します。このユーティリティは、ソフトウェアをセントラル（ホス

ト）サイトで開発し、別の（リモート）サイトにファイル、ソース、オブ

ジェクト、または実行可能コードを送信したいユーザ向けに設計されてい

ます。

以下の条件を満たすパッケージのみ配布できます。

■ パッケージが、パッケージバックアウトオプションを有効にして作成

されている。

■ パッケージは、実行されているがコミットされていない。

注：パッケージ配布機能を使用する場合、Ship Asis 機能は、パッケージの

バックアウトおよびバックインステータスが配布に影響を与えるかどう

かを判定します。詳細については、「Ship Asis 機能 (P. 95)」を参照してく

ださい。



パッケージ配布の仕組み

パッケージを配布する際に、リクエストはホストサイトおよびリモート

サイトで以下のように処理されます。

ホストサイト処理 - パッケージ配布をリクエストすると、CA Endevor SCM

はホストサイトでジョブストリームをサブミットします。このジョブは、

以下を実行します。

1. 以下を作成します。

■ ホストサイトのステージングデータセット。

注：ステージングデータセットは、配布実行中に取得された情報

を使用して、動的に作成されます。ステージング名の高レベル修

飾子はマッピングの配布先から取得され、他方次のレベル修飾子

は実行パラメータの DATE および TIME 詳細から取得されます。こ

れらの修飾子は DMMDDYY および THHMMSS として作成されます。

複数の配布が JES に同時にサブミットされる場合、これらの修飾子

が一意ではない可能性があります。このケースは結果として、重

複したデータセット名の配布が試行されていることを示す JCL エ

ラーになる場合があります。このエラーを回避するには、同じ秒

内に複数の配布をサブミットしないように、サイト実装によって

待機メカニズムを使用する必要があります。

■ ステージングデータセットからリモート本番環境データセット

にパッケージ出力をコピーするジョブストリーム。

■ ホストおよびリモートサイトで、本番環境とステージングのデー

タセットの対応関係を持つファイル

■ 上記のすべてをリモートサイトに転送する、データ転送コマンド

（ローカル転送には適用できません）。

2. ホストステージングデータセットにパッケージ出力を取り込みます。

3. ホストステージングデータセットおよびその他のファイルをリモー

トサイトに転送します（ローカル転送には適用できません）。

4. 転送を確認します。

5. ホストサイトでステージングデータセットを削除します（オプショ

ン）。



リモートサイト処理 - ステップ 1 でホストサイトで作成されたジョブス

トリームがリモートサイトで実行されると、以下が実行されます。

1. パッケージ出力を、リモートステージングデータセットから本番環

境ライブラリにコピーします。ローカル転送については、出力はホス

トステージングデータセットから本番環境ライブラリにコピーされ

ます。

2. 本番環境ライブラリで、ホストで削除されたすべてのパッケージメン

バを削除します。

3. ホストサイトに確認を転送します。

4. （オプション）リモートサイトで、ステージングデータセットを削

除します（ローカル転送には適用できません）。



以下の図は、この基本プロセスを表しています。

注：ローカル転送に対しては、リモートステージングデータセットは削

除されません。ホストステージングデータセットは共有 DASD に存在す

る必要があり、リモート本番環境ライブラリに直接コピーされます。



パッケージ配布と USS ファイルの仕組み

配布用の USS ファイルが含まれるパッケージをリクエストすると、プロセ

スが若干変更され、USS ファイルの配布に必要な追加のステップが含めら

れます。

1. 一時ステージングパス構造は、配布先レコードで指定されたホストプ

レフィクスを使用して割り当てられます。

2. USS オブジェクトは、マップされた各ディレクトリにつき 1 つのパス

で、この構造にコピーされます。

注：パッケージユーティリティは ENUSSUTL ユーティリティによって

作成されたバックアウトレコードを使用して、パッケージ作成時の関

連ソースを正しく識別します。

3. オプションで、補足ファイルがリクエストされている場合、これらの

バックアウトファイルはステージングディレクトリの下の独自のパ

スセットにもコピーされます。

4. ステージングディレクトリ全体は圧縮されて、アーカイブ（.PAX）ファ

イルに格納されます。

5. アーカイブファイルは次に、アーカイブの展開を実行するジョブスト

リームおよびコマンドと共に、リモートロケーションに転送されます。

6. リモートロケーションで、アーカイブは展開され、リモートコピーコ

マンド（.ARUCD データセットに含まれている）はステージングディ

レクトリから最終の本番環境ロケーションへコピーするために実行

されます。

7. 補足ファイルがリクエストされると、必要に応じて、補足ファイルを

リモートステージングディレクトリからコピーするのに必要なコマ

ンドを含む追加ファイル（.CRJOB）が、リモートロケーションで作成

されます。

以下の図は、USS プロセスの拡張を示します。



Ship Asis 機能

パッケージ配布機能を使用する場合、Ship Asis 機能は、パッケージのバッ

クアウトおよびバックインステータスが配布に影響を与えるかどうかを

判定します。有効な場合、このオプションは、パッケージのバックアウ

トステータスに従って、出力およびバックアウトメンバ（および HFS ファ

イル、または両方）の配布を可能にします。これは、Ship Asis が有効でパッ

ケージの一部または全部がバックアウトされている場合、パッケージ配布

アクションに以下の影響があることを意味します。

■ 出力の配布は、以下のように実行されます。

– バックアウトされていないエレメントのパッケージ出力を配布し

ます。

– バックアウトされているエレメントのパッケージ済み出力を配布

します。

■ バックアウトの配布は、以下のように実行されます。

– バックアウトされていないエレメントのパッケージ済み出力を配

布します。

– バックアウトされているエレメントのパッケージ出力を配布しま

す。

Ship Asis が有効でない場合、パッケージが実行された時点からの出力は、

パッケージのバックアウトステータスにかかわらず配布されます。この

場合、パッケージを配布する際には、パッケージ全体またはエレメントの

一部がバックアウトされていても、元の出力が配布されます。同様に、

バックアウトを配布する際には、元のパッケージバックアウトが配布さ

れます。パッケージのバックアウトおよびバックインステータスは、配

布に影響を与えません。



Ship Asis 機能が有効で、パッケージの一部または全部がバックアウトされ

ている場合は、ユーザは常に配布先サイトへの配布が同期するように注意

する必要があります。この機能を有効にすると、パッケージのバックア

ウトおよびバックインアクション（エレメントアクションのバックアウ

トおよびバックインを含む）の実行時に、これらのアクションの前にこの

パッケージが送信されたすべての配布先に対して、パッケージログに

メッセージが記録されます。これらのメッセージの目的は、バックアウ

トまたはバックインアクションがパッケージ出力を変更したため、パッ

ケージの再配布が必要になる可能性があることをユーザに警告すること

です。メッセージの重大度レベルは注意または警告に設定できます。注

意メッセージの例を以下に示します。

PKMR632C PACKAGE WAS PREVIOUSLY SHIPPED TO THE FOLLOWING DESTINATION(S) PRIOR TO

[BACK-OUT| BACK-IN]

PKMR633C JDLSHIP 19DEC12

PKMR633C JDOSHIP 19DEC12

理由:

このパッケージは、バックアウトまたはバックイン機能が実行される前に配布されました。各配布先に配

布されたパッケージのそれぞれの日時に対して 1 つのメッセージが表示されるため、複数の PKMR633C

メッセージが表示されます。

処置：

バックアウト機能がパッケージ出力を変更している場合は、パッケージの再配布が必要になります。

Post-Ship スクリプトの実行

Post-Ship スクリプト機能は、パッケージ配布プロセスの完了前または完了

後に、リモートの配布先でスクリプトと呼ばれるカスタムジョブステッ

プの条件付きの実行を有効にします。スクリプトファイルは通常のプロ

セッサ実行によって作成され、マッピングルールによって「(SCRIPT-FILES)」

として識別されます。カスタムスクリプトジョブステップは、サイトの

要件に基づき、管理者が配布 JCL モデルを編集して作成します。また、右

側にスクロールすると、新しいスクリプトの実行ステータスが返され、配

布ステータスビューに表示されます。スクリプトは、特定の機能（CICS

NEW COPY や DB2 BIND など）を実行できます。



配布後スクリプトの実行の仕組み

配布後スクリプト機能は、パッケージ配布プロセスの完了前または完了後

に、リモートの配布先でスクリプトと呼ばれるカスタムジョブステップ

の条件付きの実行を有効にします、このプロセスは以下のように機能し

ます。

1. 管理者は、サイトの要件に基づいて配布 JCL モデルを編集し、カスタ

ムスクリプトジョブステップを作成します。これらのモデルには、

リモートジョブの追加のジョブステップが含まれています。このジョ

ブステップは、スクリプトデータセットが配布に含まれている場合

にのみ、ジョブがパッケージ出力をターゲットデータセットへコピー

する前またはコピーした後に実行できます。条件付き実行を有効にす

る場合、シンボルは各スクリプトデータセットを表します。シンボ

ルは、ホストデータセット名の最後の修飾子に基づいており、文字 ZZ

が先頭に付けられます（たとえば、データセット BST.USER12.SCRIPT で

は &ZZSCRIPT になります）。シンボルの値は、スクリプトデータセッ

トのリモートステージングデータセット名です。したがって、スク

リプトジョブステップは、データセットのシンボルを解決してスク

リプトデータセットが配布に存在するかどうかを判定することで、条

件に応じてリモートジョブステップに含めることができます。

2. 管理者は、必要に応じて、配布先ごとの一意のシンボルをスクリプト

データセットメンバに含めることができます。配布先に固有のシン

ボルを使用する場合、管理者は、各配布先の一意のシンボルの値を定

義する PARMLIB を使用して、配布先設定メンバを作成します。配布プ

ロセス中にスクリプトデータセットメンバ内のシンボルは、ホスト

ステージングデータセットに書き込まれる前に、配布先設定メンバで

定義されたシンボルの値と置き換えられます。設定メンバ内にコード

化された配布先は、定義済みの配布先として検証されません。パッ

ケージ配布が実行されるまでメンバは処理されません、また、スクリ

プトデータセットが配布に含まれている場合にのみ処理されます。

メッセージはパッケージ配布中に生成され、スクリプトデータセット

が存在すること、配布先設定メンバが存在するかどうか、および変数

が置換されたかどうかを示します。

3. サイトのスクリプトデータセットは、通常のプロセッサ実行によって

作成されます。



4. メンバがホストステージングデータセットに書き込まれる前に未解

決のシンボルを解決できるように、スクリプトデータセットは識別さ

れる必要があります。スクリプトデータセットは、パッケージ配布

プロセス中に、マッピングルールによってスクリプトデータセット

として識別されます。マッピングルールでは、リモートデータセッ

ト名が (SCRIPT-FILES) として定義されます。

注：スクリプトデータセットは常に配布されますが、コピーステップ

がモデル制御メンバによってスクリプトジョブステップに追加され

ていない場合、リモートターゲットデータセットに自動的にコピー

されません。

5. ホストステージングデータセットは、その他のすべてのパッケージ

出力データセットと一緒に配布されます。

6. その後、リモートコピージョブはスクリプト実行の追加のステップと

共に実行されます。シンボルは、スクリプトデータセットがモデル

制御メンバによって使用されていることを表すために作成され、スク

リプトデータセットのリモートステージングデータセットを解決

します。これにより、スクリプトデータセットをスクリプトジョブ

ステップの入力として使用できます。

以下の図は、配布後スクリプトの実行を含むパッケージ配布プロセスを示

しています。



転送方法に関する考慮事項

使用する転送方法に応じて、パッケージ出力の転送に、一定の情報交換お

よび準備作業が必要になる場合があります。このセクションでは、以下

のデータ伝送方法の準備作業について説明します。

■ CA XCOM

■ NJE/NJI を使用した大量データ転送プログラム（BDT）

■ 大量データ転送プログラム（BDT）、バージョン 2

■ NetView File Transfer Program （FTP）

■ CONNECT:Direct

■ ローカルファイル転送

CA XCOM を使用する方法

CA Endevor SCM に XCOM の配布先を定義するには、配布先の定義でリモー

トのノード名または IP 名、および IP ポートアドレスを指定する必要があ

ります。ノード名は VTAM 論理ユニット名および IP 名です。また、IP ポー

トは TCP/IP アドレスです。 IP ポートは、ターゲットサーバの XCOM

SERVPORT の指定に一致する必要があります。

配布先の定義は、前景で CA Endevor SCM プライマリオプションパネルの

環境オプションを使用するか、またはバッチで Define Ship Destination SCL

を使用して、作成または更新できます。

XCOM は、リモートサイトにデータセットをコピーしてそこでジョブを

実行するバッチジョブを実行します。サイト固有の情報を使用してサン

プル JCL を変更する必要があります。また、EXEC PARM には追加の XCOM

パラメータが必要な場合があります。

（パッケージ配布ジョブスケルトン C1BMXJOB 内の） NDVRSHIP ジョブス

テップは、CONTROL という名前のメンバが含まれる PDS

（prfx.XCOMCMD.FILE）を作成します。メンバには、以下のコマンドが含

まれます。

■ 各ファイルを送信するための SEND TYPE=FILE コマンド。

■ 各配布先で配布を受信してリモートコピー/削除ジョブを実行するた

めの SEND TYPE=JOB コマンド。

■ ホストステージングデータセットを削除するための SEND TYPE=JOB

コマンド。



ステージングデータセット削除用の JCL および制御カードは、

prfx.XCOMCMD.FILE 内のメンバ「destid.D」です。（スケルトン C1BMXCOM

内の） XCOM を実行するジョブステップは、CONTROL メンバを SYSIN とし

て使用して配布を実行します。転送がすべて完了すると、

prfx.XCOMCMD.FILE は削除されます。 XCOM 転送制御機能（XTC）はファイ

ル転送およびジョブ実行を従属同期します。

CA Endevor SCM は、名前が #PSXCOM で始まるメンバとして CSIQOPTN ライ

ブラリのモデル XCOM 制御ステートメントを配布します。通常、これら

のモデルを変更する必要はありません。

注： XCOM の詳細については、「CA-XCOM Data Transport for z/OS User

Guide」を参照してください。 XCOM は CA の製品です。

大量データ転送プログラムと NJE/NJI を使用する方法

CA Endevor SCM に NJE/NJI を使用する BDT の配布先を定義するには、配布

先定義パネルでリモートジョブ情報を入力する必要があります。この情

報には、以下のものが含まれています。

■ 有効な JOB ステートメントの定義。

■ JES ルートカード。ルートカードは、「/*ROUTE XEQ ノード名」（JES2）、

「//*ROUTE XEQ ノード名」（JES3）、またはそれらと同様のものにな

ります。リモートの配布先でのジョブのルーティングおよび実行の詳

細については、JES システムプログラマにお問い合わせください。

CA Endevor SCM は、名前が #PSBDT1 で始まるメンバとして CSIQOPTN ライ

ブラリのモデル JCL を配布します。通常、これらのモデルを変更する必要

はありません。



大量データ転送プログラムバージョン 2 を使用する方法

CA Endevor SCM に BDT バージョン 2 の配布先を定義するには、配布先定義

パネルでリモートのノード名を指定する必要があります。ネットワーク

内のノードの名前については、BDT システムプログラマにお問い合わせく

ださい。

BDT は、リモートサイトにデータセットをコピーしてそこでジョブを実

行するバッチジョブを実行します。 BDT に関するサイト固有の情報を使

用してサンプル JCL を変更する必要があります。

転送する各データセットは、リモートコピー/削除ジョブに対して NETREL

を発行します。各 NETREL はその後、NETHOLD を減らして転送するデータ

セットの数と同じにします。すべてのデータセットが転送されると、

NETHOLD の処理が完了し、リモートコピー/削除ジョブが解放されます。

CA Endevor SCM は、名前が #PSBDT2 で始まるメンバとして CSIQOPTN ライ

ブラリのモデル BDT 制御ステートメントを配布します。通常、これらの

モデルを変更する必要はありません。

注： BDT の詳細については、IBM のドキュメントを参照してください。

ローカルファイル転送方法

ローカル配布では、ホストサイトとリモートサイトの間で共有される

DASD にホストステージングデータセットが割り当てられる必要があり

ます。リモート本番環境データセットは、非共有 DASD 上にある場合があ

ります。共有 DASD の割り当ては、配布先定義パネル上の［UNIT］および

（または）［VOLSER］フィールドを使用して制御できます。

NetView FTP を使用する方法

NetView FTP は、リモートサイトにデータセットをコピーするトランザク

ションをサブミットするバッチジョブを実行します。 CA Endevor SCM は、

名前が #PSNFTP で始まるメンバとして CSIQOPTN ライブラリの FTP コマン

ドを配布します。サイト固有の情報を使用してサンプル JCL を変更する必

要があります。通常、これらのコマンドを変更する必要はありません。

注： NetView FTP の詳細については、IBM のドキュメントを参照してくださ

い。



CONNECT:Direct を使用する方法

CONNECT:Direct （旧名 Network Data Mover： NDM）は、ホストサイトか

らリモートの配布先にデータセットをコピーしてそこでジョブを実行す

るバッチジョブを実行します。 CA Endevor SCM は、CONNECT:Direct に関

連するサンプル JCL を提供しています。 CONNECT:Direct に関するサイト固

有の情報を使用してこのサンプル JCL を変更する必要があります。

NDVRSHIP ジョブステップ（スケルトン C1BMXJOB 内の）は、各

CONNECT:Direct の配布先に対する単一のプロセスを含む CONNECT:Direct

プロセスファイルを作成します。各プロセスのメンバ名は「destid.P」で

す。メンバには、以下のコマンドが含まれます。

■ 各ファイルを転送するための COPY コマンド。

■ リモートコピー/削除ジョブを実行するための RUN JOB コマンド。

■ 配布先のホストステージングデータセットを削除するための RUN

JOB コマンド。

ステージングデータセット削除用の JCL および制御カードは、プロセス

ファイル内のメンバ「destid.D」です。単一メンバ「SUBMIT」には各プロ

セスメンバ用の CONNECT:Direct SUBMIT コマンドが含まれます。

C1BMXNDM と関連付けられたジョブステップは、「SUBMIT」メンバを使

用して配布を実行します。すべてのプロセスがサブミットされると、プ

ロセスファイルが削除されます。

CA Endevor SCM は、名前が #PSNWDM で始まるメンバとして CSIQOPTN ラ

イブラリのモデル CONNECT:Direct 制御ステートメントを配布します。通

常、これらのモデルを変更する必要はありません。

CONNECT:Direct の詳細については、製品の概要を参照してください。バッ

チインターフェースについては、CONNECT:Direct のユーザガイドを参照

してください。 CONNECT:Direct コマンドの構文については、

CONNECT:Direct のコマンドリファレンスを参照してください。



Ship Asis の有効化

Ship Asis 機能が有効な場合、パッケージのバックアウトステータスに従っ

て、出力およびバックアウトメンバ（および HFS ファイル、または両方）

を配布できます。パッケージのバックアウトおよびバックインアクショ

ン（エレメントアクションのバックアウトおよびバックインを含む）の

実行時に、パッケージログに警告メッセージが記録されます。これらの

メッセージには、バックアウト機能が実行される前にパッケージが配布さ

れた配布先がリストされます。 Ship Asis が有効でない場合、パッケージが

実行された時点からの出力は、パッケージのバックアウトステータスに

かかわらず配布されます。


1. ENCOPTBL を以下のように編集します。

a. SHIP_OUTPUTS_ASIS=ON オプションの隣の列のアスタリスクを削

除します。

b. （オプション） ENHOPT MSGSEVERITY_PKMR632= エントリの隣の列

のアスタリスクを削除し、メッセージの重大度レベルを C （注意）

または W （警告）に設定します。

2. ENCOPTBL をコンパイルおよびリンクします。

Ship Asis 機能が有効になります。効果は以下のとおりです。

a. ユーザがバックアウトまたはバックインアクションを実行すると、

パッケージがすでに配布されている配布先を示すメッセージが

パッケージログに書き込まれます。これは、パッケージを再配布

する必要があるかどうかを判断するようユーザに警告するための

ものです。

b. ユーザがバックアウトされたパッケージを配布すると、出力は

パッケージのバックアウトステータスに従って配布されます。



ホスト JCL の設定

サイトでのパッケージ配布ユーティリティのホスト実行の各ステップに

合わせて、スケルトン JCL を変更します。これらのスケルトンは、CSIQSENU

ライブラリのメンバです。

■ ジョブステートメント JCL の変更 - C1BMXHJC

■ ホストジョブステップ 1：配布ステージング（C1BMXJOB）

■ ホストジョブステップ 2：転送スケジュール

■ ホストジョブステップ 3：確認 JCL

■ ホストジョブステップ 4：ジョブの終了

ホストジョブステートメント JCL （C1BMXHJC）

ホストサイト用のジョブステートメントを作成するには、ホストジョブ

ステートメント JCL スケルトン（C1BMXHJC）を使用します。このジョブス

テートメントは、パッケージ配布ジョブ JCL （C1BMXJOB）、およびリモー

トステージングデータセットをリモートの本番稼働用ライブラリにコ

ピーするジョブの実行を確認するジョブステップ JCL （C1BMXRCN）に組

み込まれています。

CSIQSENU ライブラリの C1BMXHJC スケルトンを以下に示します。

)SEL &C1BJC1. &lnot.= &Z.

&C1BJC1.

)ENDSEL


&C1BJC2.

)ENDSEL


&C1BJC3.

)ENDSEL


&C1BJC4.

)ENDSEL

/*ROUTE XEQ hostname



ホストサイトに関するジョブステートメント情報を提供するために、ホ

ストジョブステートメント JCL スケルトン（C1BMXHJC）を以下のように

変更します。

■ &C1BJC.n ステートメントを、パッケージ配布パネル（パッケージオプ

ションメニューのオプション 6）に現在表示されているジョブステー

トメント情報に拡張します。また、これらのステートメントの )SEL お

よび )ENDSEL を使用して、ハードコードされたジョブステートメント

で置換することもできます。

■ ROUTE ステートメントの HOSTNAME を、サイト固有の JES ノード名の

値で置換します。これにより、いずれかのサイトでサブミットした

ジョブが、実行のためにホストへルーティングされます。この変更は、

ホストおよびリモートシステムの両方でこのジョブステートメント

をサブミットすることを可能にします。

■ 必要に応じて、JES 制御ステートメント、JCL、またはその両方を追加

します。

■ サイトの要件に応じて、ジョブステートメントに USERID および

PASSWORD キーワードを含めて、JCL がセキュリティチェックを通過

するようにします。これは、&C1BJC.n ステートメントのいずれかにこ

れらのキーワードを含めることで実行できます。以下に例を示します。

&C1BJC2.,USERID=ユーザ ID,PASSWORD=パスワード



ホストジョブステップ 1：配布ステージング（C1BMXJOB）

ステップ 1 では、パッケージ配布ステージングユーティリティを実行しま

す。これは、CSIQSENU ライブラリの C1BMXJOB メンバです。このスケル

トンを変更する場合は、以下の手順に従います。

■ 適用されない転送パッケージ DD ステートメントを削除します（たと

えば、BDT を使用しない場合は C1BMXBDC、C1BMXBDR、および

C1BMXBDM を削除します）。

■ サイト固有のプレフィックスおよび名前を使用して、残りのモデル制

御カードデータセットを変更します。 CA Endevor SCM ライブラリの

プレフィックス/修飾子は iprfx.iqual です。

注： C1BMXJOB ジョブの PARM には、システム変数 &ZPREFIX への参照が含

まれます。これは、ユーザの TSO プロファイルのプレフィックスに対応し

ます。サイトのユーザが通常、プロファイルを NOPREFIX （たとえば、「TSO

PROFILE NOPrefix」）に設定している場合、このパラメータを &ZUSER また

はその他の高レベル修飾子に変更する必要があります。一部の配布 JCL モ

デルは、このパラメータを、配布プロセス中に割り当てられた特定のデー

タセットの最初のノードとして使用します。

C1BMXLIB スケルトン

このスケルトンは、ホストサイトでパッケージ配布ジョブを実行するた

めに、STEPLIB および CONLIB の定義に SCMM@LIB を組み込みます。

■ C1BMXJOB - パッケージ配布ユーティリティを実行します。

■ C1BMXHCN - ステージングデータセットの転送を確認します。

■ C1BMXRCN - リモートの本番稼働用データセットへのリモートステー

ジングデータセットのリモート IEBCOPY を確認します。

これは、CSIQSENU ライブラリの C1BMXLIB メンバです。

このスケルトンを変更するには、サイト固有のプレフィックス、修飾子、

および名前を使用して、STEPLIB および CONLIB DD ステートメントを変更

します。 CA Endevor SCM ライブラリのプレフィックス/修飾子は iprfx.iqual

です。 AUTLIBS または CONLIBS がリンクリストにある場合は、これらの 2

つの DD ステートメントをコメントアウトできます。



C1BMXRCN スケルトン

このスケルトンを使用して、リモートサイトでの本番環境データセット

へのステージングデータセットのコピーを確認します。これは

C1BMXJOB スケルトンに含まれています。

配布ステージングユーティリティはこのスケルトンを読み取り、それを

使用して、ステージングデータセットをそれぞれの本番環境データセッ

トにコピーするリモートジョブの部分を作成します。 JCL を内部リーダに

書き込む 2 つの IEBGENER ステップがあります。これらのステップの 1 つ

のみが、条件コードに基づいて実行されます。内部リーダに入力された

ジョブストリームはホストで実行され、配布レコードを更新します。

このスケルトンには、変更は必要ありません。ただし、コピープロセス

の結果に関するより多くの具体的情報を提供するように、それを変更でき

ます。

ホストジョブステップ 2：転送スケジュール

使用する転送方法に応じて、ステップ 2 では転送ユーティリティ（XCOM、

BDT バージョン 2、および NDM）を直接実行し、転送ユーティリティ

（NJE/NJI 経由の BDT および Netview FTP）を実行するジョブをサブミット

するか、ホストステージングデータセットをリモート本番環境データ

セット（LOCAL）にコピーするジョブをサブミットします。ステップ 2 を

構成するスケルトンには、CA Endevor SCM および使用するデータ転送パッ

ケージ用のサイト固有のデータセット名が含まれる場合があります。



XCOM 用の C1BMXCOM JCL

この C1BMXCOM スケルトンには、4 つのステップが含まれます。パッケー

ジ配布ユーティリティによって作成された &&XXCC データセットには、

「転送方法に関する考慮事項」で説明されているように、

prfx.XCOMCMD.FILE を生成する 2 つの IEBUPDTE ステップで使用される

IEBUPDTE SYSIN が含まれます。 XCOM は 3 番目のステップで実行されます。

4 番目のステップでは、prfx.XCOMCMD.FILE データセットからメンバ

「CONTROL」を削除します。

このスケルトンをカスタマイズする方法

1. サイト固有のプレフィックス、修飾子、および名前を使用して、STEPLIB

と XCOMCNTL の dsname を変更します。

XCOM ライブラリのプレフィックス/修飾子は iprfx.XCOM です。この情

報については、社内の XCOM 管理者にお問い合わせください。

2. 必要に応じて、PARM を確認し、オプションの PARM を追加します。

NJE/NJI を使用した大量データ転送プログラム用 C1BMXBD1 JCL

NJE/NJI によって BDT に対して生成された JCL は転送するデータセットの

数に応じて変わるので、実際のジョブストリームは、このジョブステッ

プでパッケージ配布ユーティリティによって作成され、内部リーダに書き

込まれます。

注：このジョブストリーム（C1BMXBD1）の変更の詳細については、「モ

デル転送制御ステートメントの作成 (P. 136)」を参照してください。

大量データ転送プログラム用 C1BMXBD1 JCL、バージョン 2

C1BMXBDT スケルトンを使用してステージングデータセットを転送し、

大量データ転送プログラム、バージョン 2 を使用してジョブを実行します。

このスケルトンには、変更は必要ありません。



CONNECT:Direct 用の C1BMXNDM JCL

C1BMXNDM スケルトンには、4 つのステップが含まれます。パッケージ

配布ユーティリティによって作成された &&XNWC データセットには、

prefix.CONNCMD.FILE を生成する 2 つの IEBUPDTE ステップで使用される

IEBUPDTE SYSIN が含まれます。 CONNECT:Direct は 3 番目のステップで実行

されます。 4 番目のステップでは、prefix.CONNCMD.FILE データセットか

らメンバ「SUBMIT」を削除します。

このスケルトンをカスタマイズする方法

1. サイト固有の名前を使用して、LINKLIB、NETMAP、および MSG の dsname

を変更します。 CONNECT:Direct ライブラリのプレフィックス/修飾子は

iprfx.ndm です。

2. SIGNON ステートメントが必要な場合は、サイト固有のサインオン

データを使用して、&VNBXSTP ジョブステップの SIGNON ステートメ

ントを変更します。キーワード、および SIGNON 以外の CONNECT:Direct

制御ステートメントを追加できます。詳細については、「CONNECT:

Direct 制御ステートメント (P. 143)」を参照してください。

3. SIGNON ステートメントが必要ない場合は、CONNCMD.FILE DD ステート

メントの &VNBXSTP ジョブステップおよびコード //SYSIN 内の

SIGNON および //SYSIN DD * ステートメントを削除します。

注：ユーザのプロファイルのほとんどが NOPREFIX に設定されている

場合、C1BMXJOB ジョブの PARM には、システム変数 &VNBSHHLI への

参照が含まれます。これは、ユーザの TSO プロファイルのプレフィッ

クスに対応します。サイトのユーザが通常、プロファイルを NOPREFIX

（たとえば、「TSO PROFILE NOPrefix」）に設定している場合、このパ

ラメータを &ZUSER またはその他の高レベル修飾子に変更する必要が

あります。一部の配布 JCL モデルは、このパラメータを、配布

CONNCMD 中に割り当てられた特定のデータセットの最初のノードと

して使用します。

ローカル転送用の C1BMXLOC JCL

C1BMXLOC スケルトンを使用して、共有 DASD に存在するホストステージ

ングデータセットを、共有 DASD に存在しない可能性がある本番環境デー

タセットへ転送します。このジョブは、バッチ TSO を使用して、リモー

トコピー/削除ジョブ用のコマンドをサブミットします。

このスケルトンには、変更は必要ありません。



NetView ファイル転送プログラム用の C1BMXFTP JCL

Netview FTP JCL は転送するデータセットの数に応じて変わるので、実際の

ジョブストリームは、このジョブステップでパッケージ配布ユーティリ

ティによって作成され、内部リーダに書き込まれます。 C1BMXFTP ジョブ

ストリームのカスタマイズの説明は、「モデル転送制御ステートメントの

作成 (P. 136)」にあります。

ホストジョブステップ 3：確認 JCL

ステップ 2 で実際に実行される転送方法（XCOM、BDT バージョン 2、

CONNECT:Direct、および Local）については、ステップ 3 で前のファイル転

送ステップのホスト実行が確認されます。これは、転送ステップが実行

される場合は 1 つのステップで、転送ステップが異常終了する場合は別の

ステップで実行されます。

NJE/NJI および Netview FTP 経由の BDT では、3 番目のジョブステップはあ

りません。ただし、このスケルトンは最初のジョブステップ（DD 名

C1BMXHCN）によって読み取られ、2 番目のジョブステップで内部リーダ

に書き込まれる JCL ストリームの一部になります。

2 つスケルトン JCL モジュールがステップ 3 に関係します。

C1BMXHCN スケルトン

C1BMXHCN スケルトンを変更するには、CONFEXEC ステップの条件コード

が前のファイル転送ステップの条件コードと必ず一致するようにします。

このスケルトンは、ファイル転送ステップの結果に関するより詳細な情報

を提供するように変更できます。

ホストジョブステップ 4： JOB 完了

C1BMXEOJ スケルトンは、任意の "JOB 完了" 処理要件をサポートします。

これは、必要に応じてユーザが変更できる単一の JCL コメントカードです。

スケルトンは、すべての転送方法について、プライマリ JCL ストリームの

最後のジョブステップとして含まれています。これは、セカンダリ JCL ス

トリーム（NJE/NJI 経由の BDT または NetView FTP ）に含まれていません。



リモートパッケージ配布 JCL の変更

CA Endevor SCM は、スケルトン JCL、および配布のリモートコピー/削除

ジョブを生成するモデルメンバを提供します。配布ユーティリティを使

用する前に、サイトの規則に従うように、このスケルトン JCL を変更する

必要があります。

これらのスケルトンは、CSIQSENU ライブラリのメンバです。また、モデ

ルメンバは CSIQOPTN ライブラリに存在します



リモートジョブストリーム（C1DEFLTS）

リモートコピーおよび削除ジョブストリームの生成は、RJCLROOT キー

ワードの C1DEFLTS での指定によって制御されます。

RJCLROOT

パッケージ配布リモート JCL モデルのメンバのルートを指定します。

リモート JCL 生成の選択を制御します。以下の 3 つの選択肢がありま

す。

注：リモートコマンドストリームをカスタマイズするオプション、ま

たは配布後スクリプトの処理を実行するオプションは、RJCLROOT=ICPY

または RJCLROOT=FCPY のいずれかを使用してのみ有効にできます。

RJCLROOT が指定されていない（または省略されている）場合、これら

のオプションは利用できません。詳細については、「コマンドスト

リームをカスタマイズする方法」および「配布後スクリプトの実行を

有効にする方法」を参照してください。

RJCLROOT

指定されていません。ジョブストリームは、IEBCOPY および

IDXCAMS を使用して、文字列 #PSxxxx で始まるモデルメンバの標準

セットを通じて生成されます。ここで xxxx は、使用される転送方

法に固有の文字列です。

RJCLROOT=FCPY

リモートコピーおよび削除用の CA-PDSMAN FASTCOPY JCL を作成

するために、ジョブストリームが、#PSxxxx メンバに加えて、文字

列 #RJFCPY で始まるモデルメンバセットを通じて生成されること

を指定します。

RJCLROOT=ICPY

IEBCOPY および IDCAMS JCL ステートメントを作成するために、

ジョブストリームが、#PSxxxx メンバに加えて、文字列 #RJICPY で

始まるモデルメンバセットを通じて生成されることを指定しま

す。



リモートジョブ： RJCLROOT= 指定なし

RJCLROOT が指定されていない場合、IEBCOPY および IDCAMS と #PSxxxx モ

デル制御メンバを使用して、3 ステップのジョブストリームがプログラム

的に生成されます。ここで xxxx は、使用される転送方法に固有の文字列で

す。

リモートジョブステップ 1： IEBCOPY JCL

この JCL は、ステージングデータセットを対応する本番環境にコピーしま

す。このジョブステップメンバは、配布ステージングユーティリティに

よってホストサイトで読み取り/書き込みが行われ、リモートサイトで実

行されます。メンバは C1BMXCOP で、CSIQSENU ライブラリで配布されま

す。

注：これは ISPF スケルトンではありません。すべてのスケルトン制御ス

テートメント（カラム 1 内の閉じかっこ）が無視されます。

以下の点に注意してください。

■ ユーティリティで生成されたコピー制御カードは、IEBCOPY 形式です。

COPY および COPYMOD コマンドが使用されます。 SELECT MEMBER ス

テートメントは生成されません。

■ ユーティリティは //SYSIN * DD * ステートメントを生成します。

リモートジョブステップ 2： IDCAMS JCL

この JCL は、リモートサイトで本番環境メンバおよびリモートステージン

グデータセットを削除します。このメンバは、配布ステージングユー

ティリティによってホストサイトで読み取り/書き込みが行われ、リモー

トサイトで実行されます。メンバは C1BMXDEL で、CSIQSENU ライブラリ

で配布されます。

注：これは ISPF スケルトンではありません。すべてのスケルトン制御ス

テートメント（カラム 1 内の閉じかっこ）が無視されます。



//* *-----------------------* C1BMXRJC(C1BMXDEL) //* * REMOTE SITE JOBSTEP TO DELETE MEMBERS WHICH //* * WERE DELETED BY THE EXECUTION OF THE PACKAGE //* *---------------------------------* //DELETE EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD *

リモートジョブステップ 3：リモート確認

リモート確認ステップは、「ホストジョブステップ 1：配布ステージン

グ（C1BMXJOB）」の C1BMXRCN についてのサブセクションで説明されて

います。

リモートジョブ： RJCLROOT=FCPY

RJCLROOT が FCPY と等しい（=）場合、ジョブストリームは、文字列 #RJFCPY

で始まるモデルメンバセットを通じて生成されます。配布バージョンは

以下の 3 つのステップで構成されます。

リモートジョブステップ 1： IEBCOPY の実行（FASTCOPY の実行をイン

ターセプト）

リモートデータセットにメンバをコピーまたはリモートデータセット

からメンバを削除する方法。

リモートジョブステップ 2：ステージングデータセットを削除するため

の IDCAMS の実行


リモート確認ステップの詳細については、「ホストジョブステップ 1：配

布ステージング（C1BMXJOB）」を参照してください。



リモートジョブ： RJCLROOT=ICPY

RJCLROOT が ICPY と等しい（=）場合、ジョブストリームは、文字列 #RJICPY

で始まる CSIQOPTN ライブラリのモデルメンバセットを通じて生成され

ます。配布されたバージョンは、RJCLROOT が省略された場合に生成され

るものと同じジョブストリームを生成します。ジョブストリームは 3 つ

のステップで構成されます。

リモートジョブステップ 1：リモートデータセットにメンバをコピーす

るための IEBCOPY の実行

リモートジョブステップ 2：メンバおよびステージングデータセットを

削除するための IDCAMS の実行


リモート確認ステップの詳細については、「ホストジョブステップ 1：配

布ステージング（C1BMXJOB）」を参照してください。



USS オブジェクト用の BPXBATCH リモートジョブステップ

パッケージ配布に USS オブジェクトが含まれている場合、必要なアーカイ

ブ展開およびコピーコマンドを実行するために、追加のステップ（BPX）

がリモートコピージョブに挿入されます。配布されている状態では、リ

モートコマンドは以下を実行します。

trap 'exit 1;' ERR -

これ以降のエラーのトラッピングを有効にします。

注：エラーが発生した場合、リターンコード 256 が設定されます。こ

れは、確認ステップでテストできます。詳細については、「配布を作

成、追跡、確認する方法」を参照してください。

set -x

コマンドのエコーを有効にします。STDERR 出力 DD の前にプラス（+）

記号を付けることで、問題の診断が行いやすくなります。

mkdir -p '<remoteStaginPath>'

ターゲットステージングディレクトリが存在しない場合、これを作成

します。

pax -rvzk -f "//'<remoteDatasetPrefix>.ARPAX'"-s …

pax ファイルのアーカイブ展開を実行します。

rm -fv '<targetFile>'

コピーが実行される前に、各コピーに対して対応する削除要求を作成

します。このコマンドは、タイムスタンプ情報が以下のコピーコマ

ンドで保持されていることを確認します。

cp -Bm '<stagingFile>' '<targetFile>'

元のファイルの日付およびタイムスタンプを保持する各ファイルの

バイナリコピーを実行します。

注：リモートコピーおよび削除コマンドのペアは、管理対象の USS オブ

ジェクトの数だけ繰り返されます。



コマンドストリームをカスタマイズする方法

リモートロケーションでファイルをカスタマイズするステップを挿入す

ることにより、コマンドストリームをサイトの標準に合わせることがで

きます。たとえば、mkdir、chown、chgroup コマンドを挿入したり、また

は配布された un-pax コマンドスイッチを変更したりすることができます。

1. リモート JCL 用のモデルを選択します。デフォルトテーブル

（C1DEFLTS）内の RJCLROOT パラメータは、モデルのどのカスタムセッ

トがサイトで使用中かを判定します。

■ 値が FCPY または ICPY の場合は、値を記録し、次のステップに進み

ます。

■ RJCLROOT が省略されているか空白の場合は、C1DEFLTS を編集して

RJCLROOT=ICPY を指定し、テーブルを再アセンブルします。

RJCLROOT の詳細については、「C1DEFLTS でのリモートジョブスト

リームの指定 (P. 112)」を参照してください。

デフォルトテーブルの詳細については、「管理ガイド」の「デフォル

トテーブルの使用」の章を参照してください

2. コピーステップのモデル JCL を以下のように編集します。

a. CSIQOPTN ライブラリで適切なモデルを見つけます。

■ デフォルトテーブルで RJCLROOT=FCPY を指定している場合は、

モデルメンバ #RJFCPY1 を使用します。

■ デフォルトテーブルで RJCLROOT=ICPY を指定している場合は、

モデルメンバ #RJICPY1 を使用します。

b. モデルメンバの BPXBATCH ステップを見つけます。このステップ

はコマンドストリームを実行します。 #RJICPY1 の BPXBATCH ス

テップの例を以下に示します。

//*

//BPXBAT EXEC PGM=BPXBATCH ICPY

//STDOUT DD SYSOUT=*

//STDERR DD SYSOUT=*

//STDPARM DD DISP=SHR,

// DSN=&RUCD

DSN=&RUCD

リモートコマンドファイルの名前を解決します。

c. 必要に応じて、BPXBATCH ステップの前に、変更したコードを呼び

出すステップを挿入します。



例： REXX 用に編集されたリモートコマンドファイル

REXX プログラムを SYSUT1 から現在のコマンドストリームで読み

取り、次にカスタマイズしたストリームを SYSUT2 に書き込みたい

場合を考えてみます。これを実現するには、モデルメンバの

BPXBATCH ステップの前に以下のコードを挿入します。

//*********************************************************** //* SAMPLE TAILOR UCD COMMAND STREAM //*********************************************************** //UCDEDIT EXEC PGM=IRXJCL,PARM='UCDEDIT' //SYSEXEC DD DISP=SHR,DSN=BST.SUPPNDVR.ISRCLIB //SYSUT1 DD DISP=SHR,DSN=&RUCD //SYSUT2 DD DISP=SHR,DSN=&RUCD //SYSPRINT DD SYSOUT=* //SYSTSPRT DD SYSOUT=* //***********************************************************

以下の REXX exit（UCDEDIT）の例は、コマンドストリームのカスタマイズ

の主要な要件を示しています。プログラムは既存のコマンドストリーム

で読み取り、カスタマイズされたストリームに書き込む必要があります。

プログラムは SYSUT1 からの入力を読み取り、カスタマイズした出力を

SYSUT2 に書き込みます。この exit は単純な文字列検索を実行し、pax コマ

ンドに追加のスイッチを付加（挿入）します。

/* Rexx to read from Sysut1 and write to Sysut2 (like IEBGENER) However, this version is a bit special in that it also performs some string substitutions. It's intended to allow a customer to edit their USS Ship command stream at the remote location changing the pax command parms or saving some commands to be executed later. */ frmstr = 'pax -rvzk' /* This is what we're looking for */ tgtstr = 'pax -rvzk -p op' /* and we'll replace it with this */ /* Read input file (BPXBATCH commands) */

"EXECIO * DISKR SYSUT1(STEM DATA. FINIS" IF RC ¬= 0 THEN SIGNAL IOERROR

/* Main loop to search/replace the string */



do i = 1 to DATA.0 start = 1 do while start < length(DATA.i) found = pos(frmstr,DATA.i,start) if found = 0 then leave endstr = found + length(frmstr) newstr = Left(DATA.i,(found - 1)) || tgtstr DATA.i = newstr || substr(DATA.i,endstr) start = found + length(tgtstr) end end

/* Write the substituted file out */

"EXECIO * DISKW SYSUT2(STEM DATA. FINIS" IF RC ¬= 0 THEN SIGNAL IOERROR

/* That's it all done */ Exit 0

IOERROR: SAY 'PROBLEM DURING I/O, Return code:' || RC EXIT RC



配布先の作成

パッケージ出力を配布する各リモートサイトに、尐なくとも 1 つの配布先

を定義する必要があります。 CA Endevor SCM はパッケージデータセット

に配布先情報を格納します。配布先はデータセットまたは USS サポート

ファイルのタイプ（HFS、zFS、または NFS）に対して定義できます。


1. CA Endevor SCM メニューでオプション 4 - 環境を選択します。

環境オプションメニュー

2. 環境オプションメニューでオプション D - 配布先を選択します。 Enter

キーを押します。

配布先オプションメニューが表示されます。

3. 2 - ビルドを選択します。配布先フィールドに、完全に修飾された配布

先名を入力します。 Enter キーを押します。

配布先の作成/変更パネルが表示されます。

4. パネルに情報を入力します。 Enter キーを押します。このパネルには、

以下のフィールドがあります。

配布先

データセット名または USS でサポートされるパスおよびファイル

名を指定します。

■ データセット名の値には、最大 7 文字まで入力できます。初

めの文字は、英数字にする必要があります。残りの文字には、

英数字または各国文字を使用できます。

■ USS システムファイルの値には、最大 732 バイトまでのパス名

を入力できます。

DESCRIPTION

配布先の説明を最大 30 文字で指定します。これはコメントとして

扱われます。



補助データセットのシップ

補助データセットを配布するかどうかを指定します。パッケージ

出力が配布先に配布されている場合、ステージングデータセット

の 2 つ目のセットをリクエストできます。これらのデータセット

は補助データセットと呼ばれ、配布のバックアウトが含まれます。

たとえば、配布にパッケージ A の出力が含まれる場合、補助デー

タセットにはパッケージ A のバックアウトが含まれます。逆に、

配布にパッケージ B のバックアウトが含まれる場合、補助データ

セットにはパッケージ B の出力が含まれます。有効な値は以下の

とおりです。

■ N — デフォルト。補助データセットを配布しません。

■ Y — 補助データセットを配布します。

転送方法

この配布先用の転送ユーティリティを指定します。有効な値は以

下のとおりです。

■ XCOM — XCOM （CA）

■ B — 大量データ転送プログラム、バージョン 2 （IBM）

■ BDTN — 大量データ転送プログラム、NJE/NJI を使用（IBM）

■ L — ローカル

■ NVF — NetView File Transfer Program （IBM）

■ NWD — CONNECT:Direct

リモートノード名

パッケージ出力が配布されるノード名を 1 ～ 16 文字で指定します。

この名前は、選択されたデータ転送プログラムで有効かつ定義さ

れている必要があります。ノード名は、NJE/NJI を使用する BDT お

よびローカル転送では意味を持ちません。

リモート IP 名/IP ポート

パッケージ出力が配布されるターゲットサーバの XCOM

SERVPORT 仕様を指定します。 IP 名には 1 ～ 63 文字を使用できま

す。 IP ポートには、1 ～ 5 文字で 1 ～ 65535 の範囲を指定できます。

IP 名および IP ポートの指定は、XCOM 転送方法にのみ有効です。

注： XCOM については、IP 名/IP ポートまたはノード名のいずれかを

指定する必要があります。ただし、両方は指定できません。



データセットのステージング情報

ユーザは、CA Endevor SCM が配布ユーティリティの最初の手順で

作成するステージングデータセット用のプレフィックスを指定

する必要があります。このプレフィックスには 1 ～ 14 文字を使用

できます。また、ホストサイトとリモートサイトで異なるものを

指定できます。プレフィックスは DSN プレフィックスフィールド

に表示されます。デフォルトでは TSOuserid.NDVR になります。

以下に、その他のステージングデータセットフィールドで許可さ

れる値を示します。

ディスポジション

削除または維持します。ディスポジション=D （削除）の場合、

CA Endevor SCM には、ステージングデータセットを処理した

後、ホストまたはリモート JCL ストリーム、またはその両方で

それを削除するステップが含まれます。指定可能な値は以下の

とおりです。

D — デフォルト。ステージングデータセットを削除します

K — ステージングデータセットを保持します

ステージングデータセットは、すべて最初にカタログ化され

ます。保持と削除は、以下の最終ディスポジションを意味して

います。

- 転送後のホストステージングデータセット。

- 本番環境にコピーされた後のリモートステージングデータ

セット。

ユニット

ステージングデータセットの割り当て時に使用する単位を指

定します。デフォルトは SYSDA です。

ボリュームシリアル（オプション）

ステージングデータセットの割り当て時に使用する VOLSER

を指定します。デフォルト値はありません。



UNIX システムサービスファイル用のステージング情報

USS ファイルをこの配布先に配布する場合、ホストおよびリモート

パス名プレフィックスを指定する必要があります。

ホストパス名プレフィクス

ホストパス名に 1 ～ 732 バイトのプレフィックスを指定しま

す。ホストサイトとリモートサイトで異なるプレフィックス

を使用できます。指定しない場合、デフォルトは「/tmp/」に

なります。

リモートパス名プレフィクス

リモートパス名に 1 ～ 732 バイトのプレフィックスを指定し

ます。ホストサイトとリモートサイトで異なるプレフィックス

を使用できます。指定しない場合、デフォルトは「/tmp/」に

なります。

リモートジョブステートメント情報

これらのフィールドには、リモート JCL 実行用のジョブカードを

指定します。転送方法が NJE/NJI を使用する BDT またはローカルの

いずれかの場合には、ROUTE XEQ カードまたはそれに該当する内

容が含まれている必要があります。

配布先が作成されます。



配布先の変更

すでに作成されている配布先を変更できます。


1. 環境オプションメニューでオプション D （配布先）を選択します。

Enter キーを押します。


2. 2 - ビルドを選択します。［配布先］フィールドに、完全修飾配布先名

を入力します。 Enter キーを押します。

配布先の作成/変更パネルが表示されます。［作成済み］および［更

新済み］フィールドには、配布先の作成日時および前回更新日時、お

よび各アクティビティに関連付けられているユーザ ID が表示されま

す。

注：配布先名を空白のまま残すか、名前マスクを使用すると、選択リ

ストが表示されます。その後、変更する配布先をリストから選択でき

ます。

3. 必要に応じて、情報を変更します。 Enter キーを押します。

配布先に加えた変更内容が保存されます。

注：作成/変更/配布先パネル上のフィールドの詳細については、「配布

先の作成」を参照してください。

配布先の表示

すでに定義されている配布先の情報を表示できます。





2. 1 - 表示を選択します。配布先フィールドに、完全に修飾された配布先

名を入力します。 Enter キーを押します。

注：配布先フィールドを空白のまま残すか、または名前マスクを使用

すると、選択リストが表示されます。次に、選択リストから配布先を

選択する必要があります。

指定した配布先に対する配布先の表示パネルが表示されます。



配布先の削除

配布先、およびすでに作成され関連付けられているマッピングルールを

削除できます。





2. 配布先オプションパネルで 3 - 削除を選択します。配布先フィールド

に、完全に修飾された配布先名を入力します。 Enter キーを押します。

注：配布先フィールドを空白のまま残すか、または名前マスクを使用

すると、選択リストが表示されます。次に、選択リストから配布先を

選択する必要があります。

指定した配布先に対する配布先の削除パネルが表示されます。

3. オプションフィールドで［#］を選択し、Enter キーを押します。

配布先および関連付けられたマッピングルールが削除されます。

注：複数の配布先を削除するには、配布先の選択リストで削除する配布先

を選択します。 Enter キーを押すと、最初に選択した配布先に対する配布

先の削除パネルが表示されます。その配布先を削除した後、END キーを押

します。配布先の削除パネルの配布先 ID フィールドに、2 番目に選択し

た配布先の名前が引き続き表示されます。この配布先および続いて選択

した配布先に対して削除手順を繰り返します。



マッピングルール

各配布先の作成時に、その配布先への各配布リクエストに対して作成され

るステージングデータセットまたは USS ディレクトリを定義します。ま

た、各配布先に対して 1 つ以上のマッピングルールを作成する必要があり

ます。マッピングルールは、ホストの本番稼働用データセットまたは USS

ディレクトリを、リモートサイトの対応する本番稼働用データセットま

たは USS ディレクトリに以下のようにマップします。

■ データセットマッピングルールは、ホストデータセット名またはマ

スクと、リモートデータセット名またはマスクの関係です。ホスト

とリモートの両方のデータセット名またはマスクの長さは、1 ～ 44 文

字にすることができます。

■ USS マッピングルールは、ホストパス名またはマスクと、リモートパ

ス名またはマスクの関係です。ホストとリモートの両方のパス名また

はマスクの長さは、最大 768 文字にすることができます。

マッピングルールを作成する場合は、以下の要因を考慮します。

■ マッピングルールを照合するには、CA Endevor SCM は、修飾子または

サブディレクトリの数が一致することをまず確認します。これは、

マッピングルールのホストデータセット名が、入力された本番環境

名と同じ数の修飾子（「.」区切り）を持っている必要があることを意

味します。 USS パス名については、ホストパス名は、入力された本番

環境パス名と同じ数のサブディレクトリ（「/」区切り）を持つ必要が

あります。

■ マッピングルールのホスト名およびそれに対応するリモート名が同

じ数の修飾子を持つことを推奨します。この形式により、ルールの理

解と管理がより簡単になります。

– たとえば、以下のホストデータセット名は、以下のリモートデー

タセット名にマップする必要があります。

ホストデータセット名マスクリモートデータセット名マスク

HOST.*.LOADLIB REMOTE.*.LOADLIB

HOST.*.*.* REMOTE.*.*.*



– たとえば、以下のホストパス名マスクは、以下のリモート名にマッ

プする必要があります。

ホストパス名マスクリモートパス名マスク

/host/*/loadlib/ /remote/*/loadlib/

/host/*/*/*/ /remote/*/*/*/

■ マッピングルールのリモートデータセット名フィールドは、任意の

数の修飾子を持つことができます。修飾子の数が同じでない場合、通

常、両方のデータセット名は、新しいデータセット名を作成する前に

右寄せされます。

– たとえば、リモートデータセットにホストより多数の修飾子があ

る場合、以下のマッピングルールが想定されます。


TESTAP.*.* PROD.AP.*.*

このマッピングルールでは、以下のホストに対して、以下のリモー

トデータセットが作成されます。

ホストデータセットリモートデータセット

TESTAP.PROGRAM.LOADLIB PROD.AP.PROGRAM.LOADLIB

– たとえば、ホストデータセットにリモートより多数の修飾子があ



TESTAP.*.* PROD.*




TESTAP.PROGRAM.LOADLIB PROD.LOADLIB



■ ターゲットにホストより多くのノードがあり、ホストとターゲットが

明示的に定義された同じノードで始まる場合で、明示的に定義された

同じノードで終了しない場合、そのデータセット名は左寄せされます。

– たとえば、リモートデータセットにホストより多数の修飾子があ



PRODAP.*.* PRODAP.*.*.REMOTE1




PRODAP.A.B PRODAP.A.B.REMOTE1

– たとえば、リモート USS パスにホストより多数の修飾子がある場

合、以下のマッピングルールが想定されます。

ホストパス名マスクリモートパス名マスク

/prodap/*/*/ /prodap/*/*/remote1/



ホストパスリモートパス

/prodap/a/b/ /prodap/a/b/remote1/

■ ホストマスクとリモートマスクの両方にワイルドカードが含まれな

い場合、位置合わせルールに対する例外が発生します。この場合、リ

モートマスクは、リモートデータセット名またはパスになります。



■ 配布リクエストを実行する場合、各入力データセットは、最も近い一

致が見つかるまで、そのデータセットマッピングルールのリストと

比較されます。たとえば、入力データセット TESTAP.PROGRAM.LOADLIB

は、以下の 3 つのホストマスクに一致します。最初のマスク

TESTAP.*.LOADLIB が最も近いため、これが使用されます。

入力データセット一致するホストデータセット名マスク

TESTAP.PROGRAM.LOADLIB

TESTAP.*.LOADLIB

TESTAP.*.*

*.*.LOADLIB

■ リモートマスクが NULL の場合、ホストマスクに一致するデータセッ

トはパッケージ配布から除外されます。ロードモジュールのみが配布

される場合、この動作が役立ちます。この動作により、ソース、リス

ト、オブジェクトモジュールなどの配布を禁止するルールを設定でき

ます。

■ 一致するルールが存在しない場合、配布リクエストの実行時に、リモー

トデータセットは、デフォルトで入力データセットと同じ名前にな

ります。サイトで名前の変更が必要ない場合、単一のダミーマッピン

グルールの作成のみ必要になります。その場合、すべてのデータセッ

トがそれ自体にマップされます。ダミーマッピングルールは、リモー

トデータセットの定義が含まれないマッピングルールです。

重要：ダミーマッピングルールとローカル配布方法を使用する場合、

ターゲットファイルとソースファイルが同じ物理データセットまた

はパスになります。このデフォルト動作では、初期計画時に予期され

ていない結果が発生する可能性があります。たとえば、USS パス名を

持つ新しいファイルに、入力マスクより 1 つ多いノードがあれば、デー

タセットはそれ自身にマップされます。

注：実行時に作成される配布アクティビティレポートには、各ホストデー

タセットのリモートデータセット名と共に、生成に使用されたマッピン

グルールがリストされます。 DSN 相互参照データセットもリモートサイ

トに配布されます。



マッピングルールの作成

マッピングルールは、ホストの本番稼働用データセットまたは USS ディ

レクトリを、リモートサイトの対応する本番稼働用データセットまたは

USS ディレクトリにマップします。各配布先には、リモートサイトへの

出力の配布を可能にする 1 つ以上のマッピングルールが必要です。


1. CA Endevor SCM メニューでオプション 4 - 環境を選択します。

環境オプションメニュー




3. 配布先オプションパネルで 2 を選択します。配布先フィールドに、完

全に修飾された配布先名を入力します。 Enter キーを押します。


4. 以下のいずれかのオプションを選択し、Enter キーを押します。

C

DSN マッピングルールを作成します。

CU

USS マッピングルールを作成します。

選択したオプションに応じて、DSN マッピングルールの作成パネルま

たは USS マッピングルールの作成パネルが表示されます。

5. 必要に応じて以下のフィールドに入力します。

マッピングルール記述

このマッピングルールの説明を 40 文字以内で入力します。

DSN マッピングルールの作成パネルのフィールド

ホストデータセット名

このマッピングルール用のホストデータセット名またはマスク。

ホストデータセット名には、入力された本番環境名と同じ数の修

飾子が必要です。

配布後スクリプト機能として使用されるスクリプトデータセッ

トでは、ホストデータセット名にワイルドカードを使用すること

はできません。明示的に指定する必要があります。



リモートデータセット名

このマッピングルール用のリモートデータセット名またはマス

ク。データセットを転送から除外するには、このフィールドを空

白のままにします。

配布後スクリプト機能として使用されるスクリプトデータセッ

トでは、次に示すようにキーワードを正確に指定します：

(SCRIPT-FILES)。必須の丸かっこ、およびダッシュは、データセッ

ト名として有効な文字ではないため、この値がデータセット名と

間違えられることはありません。

APPROX ホストメンバ/CYL

このフィールドには、このルールにマップするデータセットに対

して、1 つのシリンダに含まれる可能性があるメンバの概数が含ま

れます。デフォルトは 16 です。

パッケージが配布用にステージングされた場合、CA Endevor SCM

は、この値をステージングされている実際のメンバ数で除算しま

す。その後、CA Endevor SCM は、ステージングデータセット用に

結果 + プライマリおよびセカンダリスペースの 1 シリンダを割り

当てます。

USS マッピングルール作成パネルのフィールド

ホストパス名

ホストサイトでパス名に 1 ～ 768 文字の名前またはマスクを指定

します。ホストパス名には、その入力された本番環境パス名と同

じ数のディレクトリが必要です。ルールの理解と管理を容易にす

るために、ホスト名とそれに対応するリモート名が同じ数の修飾

子を持つことを推奨します。マッピングルールテストユーティリ

ティを使用して、マッピングルールを確実にテストします。マッ

ピングルールのテストの詳細については、「マッピングルールの

テスト (P. 135)」を参照してください。



リモートパス名

リモートサイトでパスに 1 ～ 768 文字の名前またはマスクを指定

します。パス名には、すべてスラッシュ（/）が前に付けられます。

ホストパスの USS パッケージ出力を転送したくない場合は、リ

モートパス名を空白のまま残します。リモートパス名は、最大 128

のディレクトリを持つことができます。ルールの理解と管理を容

易にするために、ホスト名とそれに対応するリモート名が同じ数

の修飾子を持つことを推奨します。マッピングルールテストユー

ティリティを使用して、マッピングルールを確実にテストします。

マッピングルールのテストの詳細については、「マッピングルー

ルのテスト (P. 135)」を参照してください。

注：ホストおよびリモートロケーションのマッピングの詳細につ

いては、「マッピングルール (P. 126)」を参照してください。


マッピングルールが作成されます。

マッピングルールの表示

マッピングルールに関する特定の情報を表示するために、ルールを表示

できます。この情報には、ホストおよびホストのマップ先のリモートロ

ケーションが含まれます。ルールの作成者よび更新者、ルールの作成日

時および更新日時も表示されます。





2. 配布先オプションパネルで［1］を選択します。［配布先］フィール

ドに、完全修飾配布先名を入力します。 Enter キーを押します。

注：［配布先］フィールドを空白のまま残すか、または名前マスクを

使用すると、選択リストが表示されます。次に、選択リストから配布

先を選択する必要があります。

指定した配布先に対する配布先の表示パネルが表示されます。

注：配布先の削除パネルに戻るには、End キーを 2 回押します。



3. 配布先の表示パネルの［オプション］フィールドで、以下の表示オプ

ションのいずれかを選択します。選択するオプションは、このパネル

に表示されている配布先に配布されるファイルの種類によって異なり

ます。

D

配布先用の DSN マッピングルールを表示します。

DU

配布先用の USS マッピングルールを表示します。

指定したオプションに応じて、DSN マッピング選択リストパネルまた

は USS マッピング選択リストパネルが表示されます。パネルには、指

定した配布先用のマッピングルールがリスト表示されます。

4. 選択リストから、表示するマッピングルールを選択します。

選択リストから選択したマッピングルールに関する情報が表示され

た、DSN マッピングルールの表示パネルまたは USS マッピングルール

の表示パネルが表示されます。

■ DSN マッピングルールの表示パネルには、マップ先のホストデー

タセット名およびリモートデータセット名が表示されます。

■ USS マッピングルールの表示パネルには、マップ先のホストパス

名およびリモートパス名が表示されます。



マッピングルールの変更

マッピングルールの変更パネルが表示されるモード（作成、表示、また

は変更）は、配布先オプションパネルで選択するオプションに応じて異

なります。このパネル上に実際に表示されるフィールドは、パネルモー

ドに応じて異なります。





2. 配布先オプションパネルで［2］を選択します。［配布先］フィール

ドに、完全修飾配布先名を入力します。 Enter キーを押します。



D

更新する DSN マッピングルールを表示します。

DU

更新する USS マッピングルールを表示します。

指定したオプションに応じて、DSN マッピング選択リストパネルまた

は USS マッピング選択リストパネルが表示されます。パネルには、指

定した配布先用のマッピングルールがリスト表示されます。

4. 選択リストから、変更するマッピングルールを選択します。

選択リストから選択したマッピングルールに関する情報が表示され

た、DSN マッピングルールの表示パネルまたは USS マッピングルール

の表示パネルが表示されます。

■ DSN マッピングルールの表示パネルには、マップ先のホストデー

タセット名およびリモートデータセット名が表示されます。

■ USS マッピングルールの表示パネルには、マップ先のホストパス

名およびリモートパス名が表示されます。

5. 必要に応じてフィールドを変更し、Enter キーを押します。

マッピングルールが更新されます。

注：パネル上のフィールドの詳細については、「マッピングルールの

作成」を参照してください。



注：次のアクションを実行する必要があるパネルに到達するまで、End


注： DSN マッピング選択リストと USS マッピング選択リストは、もっ

とも特殊なルールからもっとも一般的なルールの順番で並べられてい

ます。ルール変更時にホストマスクを変更する場合、ルールは

「*RE-KEYED」とマークされます。これは、リスト内でそのルールの

相対的な位置が変わったことを意味する場合があります。ルールの変

更された位置を見つけるには、リストを再表示します。

マッピングルールのテスト

配布先とホスト名に関して、マッピングルールをテストできます。この

テストは、リモートロケーションが正しく生成されるかどうかを判定し

ます。このテストでは、リモートロケーションの生成に使用されたマッ

ピングルールが表示されます。





2. 配布先オプションパネルで［2］を選択します。配布先フィールドに、

完全に修飾された配布先名を入力します。 Enter キーを押します。



T

DSN マッピングルールをテストします。

TU

USS マッピングルールをテストします。

選択したオプションに応じて、配布先に対する DSN マッピングルール

のテストパネルまたは USS マッピングルールのテストパネルが表示

されます。

4. ホスト名を入力して Enter キーを押します。

この配布先に対するマッピングルールが検索され、指定されたホスト

に対応するリモート名が生成されて、このパネルに表示されます。ま

た、ホストとリモートロケーションの照合に使用されるマッピング

ルールも表示されます。



モデル通信制御ステートメントのカスタマイズ

さまざまな配布先にデータセットを転送する際に柔軟性の基準を提供す

るため、モデル通信制御ステートメントが含まれるモデルメンバをカス

タマイズできます。これらのモデルメンバの数と特徴は、使用する転送

パッケージに依存します。

XCOM 制御ステートメント

CA Endevor SCM は、名前が「#PSXCOM」で始まるメンバセットとして、

CSIQOPTN ライブラリの XCOM 制御ステートメントモデルを配布します。

数字で終わるものは、データセットの転送およびジョブの実行をスケ

ジュールする XCOM コマンドの作成を指示します。文字で終わるものに

は、XCOM コマンドモデルが含まれます。これらのコマンドモデルは、

サイト固有のデータまたは機能で変更する必要がある場合があります。

リモートサイトで別のコマンドセットが必要な場合、#PSXCOMx メンバを

コピーし、「destid.x」と名前を付けて、変更を行います。数字のサフィッ

クスを持つメンバではなく、英文字のサフィックスを持つメンバのみが、

ユーザ名のプレフィックスを持つことができます。メンバの検索順序は、

「destid.x」、#PSXCOMx、#PSNDVRx です。

注： XCOM コマンドの詳細については、「XCOM User's Manual」を参照して

ください。



以下に、CSIQOPTN ライブラリの XCOM 制御ステートメントモデルについ

て説明します。サイトに合わせて、これらのモデルを変更します。

#PSXCOME

リモートコピー/削除ジョブを実行し、ホストステージングデータ

セットを削除する XCOM コマンドが含まれます。すべてのリモートサ

イトで自動実行を禁止するには、このメンバの最初のステートメント

として @EOF を配置します。これを特定のサイトで禁止するには、最

初のステートメントとして @EOF を持つメンバ「destid.E」を作成しま

す。

#PSXCOMP

区分データセットを転送する XCOM コマンドが含まれます

#PSXCOMS

順次データセットを転送する XCOM コマンドが含まれます

#PSXCOMT

配布先がすべて処理された場合に prfx.XCOMCMD.FILE を削除するク

リーンアップ手順が含まれます。このメンバは、prfx.XCOMCMD.FILE

（destid.D）内の最後の 2 つのジョブステップになります。

NJE/NJI を使用する大量データ転送プログラム（BDT）

CA Endevor SCM は、名前が「#PSBDT1」で始まるメンバセットとして

CSIQOPTN ライブラリの NJE/NJI を使用する BDT 制御ステートメントを配

布します。数字で終わるメンバ、および「C」のサフィックスを持つメン

バは、以下を実行する BDT ジョブの作成を指示します。

1. 区分ステージングデータセットを一時順次データセットにアンロー

ドします。

2. BDTXMIT を実行して、リモートサイト BDTRECV ジョブを転送します。

3. 必要に応じて、JCL DISP パラメータを使用してホストステージング

データセットを削除します。

4. 転送確認ジョブステップを実行します。



リモートサイト BDTRECV ジョブは、以下を実行します。

1. BDTRECV を実行して、データセットを受信します。

2. 区分データセットにステージングデータセットを再ステージングし

ます。

3. 本番稼働用データセットにメンバをコピーするジョブをサブミット

します。

文字で終わる #PSBDT1 メンバには、サイト固有のデータで変更が必要な可

能性のある JCL セグメントが含まれます。また、NJE/NJI を使用する BDT は、

名前が #PSNDVR で始まるメンバセットを使用します。リモートサイトの

要件が異なる場合は、#PSBDT1x メンバまたは #PSNDVRx メンバをコピーし、

「destid.x」という名前を付けて、変更を行います。数字のサフィックス

を持つメンバではなく、英文字のサフィックスを持つメンバのみが、ユー

ザ名のプレフィックスを持つことができます。メンバの検索順序は、

「destid.x」、#PSBDT1x、#PSNDVRx です。

以下に、CSIQOPTN ライブラリの BDT 制御ステートメントモデルについて

説明します。サイトに合わせて、これらのモデルを変更します。

#PSBDT1E

このジョブステップは、リモートサイトに転送されます。次に、デー

タセットが（順次ファイルとして）受信された後、そこで実行され、

区分データセットに再ステージングされます。すべてのリモートサイ

トで自動実行を禁止するには、このメンバの最初のステートメントと

して @EOF を配置します。これを特定のサイトで禁止するには、最初

のステートメントとして @EOF を持つメンバ「destid.E」を作成します。

#PSBDT1J

このジョブステップは、区分ステージングデータセットが順次デー

タセットへアンロードされた後、ホストサイトで実行されます。

#PSBDT1W

このジョブステップは、リモートサイトで実行されます。

#PSNDVRH

このジョブステップは、ホストサイトで実行され、転送の前に区分ス

テージングデータセットを一時順次データセットにアンロードしま

す。

#PSNDVRR



このジョブステップは、リモートサイトで実行され、受信した順次

データセットを一時区分データセットに再ステージングします。こ

の制御ステートメントは、ホストで実行されるものと同じ JCL を使用

するように設定されます。別の JCL が必要な場合は、@INCLUDE=H ス

テートメントを適切な JCL で置き換えます。

大量データ転送プログラム（BDT）、バージョン 2、制御ステートメント

CA Endevor SCM は、名前が「#PSBDT2」で始まるメンバセットとして

CSIQOPTN ライブラリの BDT バージョン 2 制御ステートメントを配布しま

す。数字で終わるメンバは、データセットの転送およびジョブの実行を

スケジュールする BDT コマンドの作成を指示します。文字で終わるもの

には、BDT コマンドモデルが含まれます。これらのコマンドモデルは、

サイト固有のデータまたは機能で変更する必要がある場合があります。

リモートサイトで別のコマンドセットが必要な場合、#PSBDT2x メンバを

コピーし、「destid.x」と名前を付けて、変更を行います。数字のサフィッ



「destid.x」、#PSBDT2x、#PSNDVRx です。

注： BDT コマンドの詳細については、「BDT Version 2 File-to-File Transaction

Guide」を参照してください。

以下に、CSIQOPTN ライブラリの BDT バージョン 2 制御ステートメントモ

デルについて説明します。サイトに合わせて、このモデルを変更します。

#PSBDT2E

このメンバには、リモートコピー/削除ジョブを実行する BDT バー

ジョン 2 コマンドが含まれますすべてのリモートサイトで自動実行

を禁止するには、このメンバの最初のステートメントとして @EOF を

配置します。これを特定のサイトで禁止するには、最初のステートメ

ントとして @EOF を持つメンバ「destid.E」を作成します。



ローカルファイル転送

ローカルファイル転送は、リモートの本番稼働用データセットにホスト

ステージングデータセットを直接コピーする JCL をサブミットすること

により実行されます。

CA Endevor SCM は、名前が「#PSLOCL」で始まるメンバセットとして

CSIQOPTN ライブラリのローカル制御ステートメントを配布します。リ

モートサイトの要件が異なる場合は、#PSLOCLx メンバをコピーし、

「destid.x」と名前を付けて、変更を行います。数字のサフィックスを持

つメンバではなく、英文字のサフィックスを持つメンバのみが、ユーザ名

のプレフィックスを持つことができます。メンバの検索順序は、

「destid.x」、#PSLOCLx、#PSNDVRx です。

以下に、CSIQOPTN ライブラリのローカル制御ステートメントモデルにつ

いて説明します。サイトに合わせて、このモデルを変更します。

#PSLOCLE

このジョブステップは、TSO を使用して実行するコピー/削除ジョブを

サブミットします。自動的なサブミットを禁止するには、このメンバ

の最初のステートメントとして @EOF を配置します。これを特定のサ

イトで禁止するには、最初のステートメントとして @EOF を持つメン

バ「destid.E」を作成します。



NetView File Transfer Program

CA Endevor SCM は、名前が「#PSNFTP」で始まるメンバセットとして

CSIQOPTN ライブラリの NetView FTP 制御ステートメントを配布します。数

字で終わるものは、以下を実行する FTP ジョブの作成を指示します。

1. FTP を実行して、リモートサイト（複数のジョブステップ）にデータ

セットを転送します。

2. 本番稼働用データセットにメンバをコピーするジョブをサブミット

します。

3. ホストステージングデータセットを（必要に応じ、配布先定義に基

づいて）削除します。

文字で終わる #PSNFTP メンバには FTP JCL およびコマンドモデルが含まれ

ており、サイト固有のデータまたはユーザが希望する機能で変更する必要

がある場合があります。また、NetView FTP は、名前が #PSNDVR で始まる

メンバセットを使用します。リモートサイトの要件が異なる場合には、

#PSNFTPx メンバをコピーし、「destid.x」という名前を付けて、変更を行

います。数字のサフィックスを持つメンバではなく、英文字のサフィッ

クスを持つメンバのみが、ユーザ名のプレフィックスを持つことができま

す。メンバの検索順序は、「destid.x」、#PSNFTPx、#PSNDVRx です。

前述のジョブストリームでは、サブミットステップは、データセットを

実際に転送する前には実行できません。これを実行するには、以下の 2 つ

の方法のいずれかを使用します。送信コマンドでは WAIT=YES を指定でき

ます。または、2 番目のステップの SUBMIT コマンドで HOLD を指定し、手

動でリリースできます。

注： FTP コマンドの詳細については、適切な NetView FTP マニュアルを参照




以下に、CSIQOPTN ライブラリの NETVIEW FTP 制御ステートメントモデル

について説明します。サイトに合わせて、これらのモデルを変更します。

#PSNFTPE

このジョブステップは、TSO を使用して実行するコピー/削除ジョブを

サブミットします。自動的なサブミットを禁止するには、このメンバ

の最初のステートメントとして @EOF を配置します。これを特定のサ

イトで禁止するには、最初のステートメントとして @EOF を持つメン

バ「destid.E」を作成します。

#PSNFTPJ

このジョブステップは、データセットを転送するためにホストサイ

トで実行されます。

#PSNFTPP

このメンバには、区分データセットをリモートサイトに転送する FTP

コマンドが含まれます。 WAIT=YES は、#PSNFTPE によって生成された

「コピー/削除のサブミット」ステップが予定より早く実行されるのを

禁止するために必要です。

#PSNFTPS

このメンバには、順次データセットをリモートサイトに転送する FTP

コマンドが含まれます。転送されるデータセット名は、#PSNFTP6 メ

ンバに配置されます。 WAIT=YES は、#PSNFTPE によって生成された「コ

ピー/削除のサブミット」ステップが予定より早く実行されるのを禁止

するために必要です。

#PSNDVRD

このジョブステップは、ホストステージングデータセットのディス

ポジションに「削除」が指定された場合、ホストステージングデータ

セットを削除します。

注：配布先の設定の詳細については、「配布先の設定方法」を参照し

てください。



CONNECT:Direct 制御ステートメント

CA Endevor SCM は、名前が「#PSNWDM」で始まるメンバセットとして CA

Endevor SCM ソースライブラリの CONNECT:Direct 制御ステートメントモ

デルを配布します。数字で終わるメンバは、データセットの転送および

ジョブの実行をスケジュールする CONNECT:Direct コマンドの作成を指示

します。文字で終わるメンバには CONNECT:Direct コマンドモデルが含ま

れており、サイト固有のデータまたはユーザが希望する機能で変更する必

要がある場合があります。

リモートサイトで別のコマンドセットが必要な場合、#PSNWDMx メンバ

をコピーし、「destid.x」と名前を付けて、変更を行います。数字のサフィッ



「destid.x」、#PSNWDMx、#PSNDVRx です。

注： CONNECT:Direct コマンドの詳細については、「CONNECT:Direct

Command Reference」を参照してください。

以下に、CSIQOPTN ライブラリの CONNECT:Direct 制御ステートメントモデ

ルについて説明します。サイトに合わせて、これらのモデルを変更しま

す。

#PSNWDMB

CONNECT:Direct Submit ステートメントが含まれます。

#PSNWDMC

Process ステートメントが含まれます。

#PSNWDME

リモートコピー/削除ジョブを実行する CONNECT:Direct コマンドが含

まれますすべてのリモートサイトで自動実行を禁止するには、このメ

ンバの最初のステートメントとして @EOF を配置します。これを特定

のサイトで禁止するには、最初のステートメントとして @EOF を持つ

メンバ「destid.E」を作成します。

#PSNWDMP

区分データセットを転送するステートメントが含まれます。



#PSNWDMS

順次データセットを転送するステートメントが含まれます。

#PSNWDMT

配布先がすべて処理された場合に、prfx.CONNCMD.FILE を削除するク

リーンアップ手順が含まれます。これは、prfx.CONNCMD.FILE （destid.D）

内の最後の 2 つのジョブステップになります。

外部パッケージ配布ジョブストリームの作成方法

このプロセスに従って、パッケージ配布パネルが作成するパッケージ配布

JCL をキャプチャし、それを反復するデータ処理サイクルの一部としてサ

ブミットします。

1. パッケージ配布 JCL を展開します。

2. パッケージ配布 JCL をデータセットに移動します。

3. どのパッケージをどの配布先に配布するか指定するメソッドを作成し

ます。

注：いずれかのパッケージ配布スケルトンが変更されるか

（ISPSLIB(C1BMX*)）、使用する転送方法が変更される場合、外部ジョブス

トリームを再構築する必要があります。



パッケージ配布 JCL の展開

パッケージ配布 JCL の展開方法

1. 単一の配布先への単一のパッケージの配布リクエストを作成します。

2. パッケージ配布パネルの［ホストジョブステートメント情報］フィー

ルドで、TYPRUN=COPY をコーディングします。 MSGCLASS が必ず HELD

キューをポイントするようにします。

3. パッケージ配布パネルの［オプション］フィールドで「3」を入力して、

配布キューをサブミットします。 TSO は IKJ56250I メッセージを表示し

ます。メッセージが表示するジョブ名とジョブ番号をコピーします。

メッセージが表示されない場合は、SDSF を使用して、ジョブ名とジョ

ブ番号を取得します。

4. パッケージ配布パネルに戻り、［ホストジョブステートメント情報］

フィールドから「TYPRUN=COPY」を削除し、MSGCLASS をその元の状

態へリストアします。

すべてのインストリームデータが含まれるパッケージ配布 JCL スト

リームは、これで JES キューに格納されます。



パッケージ配布 JCL のデータセットへの移動

パッケージ配布 JCL のデータセットへの移動方法

1. JES キューを PDS のシーケンシャルデータセットまたはメンバに移動

します。 JCL ストリームが格納されるデータセットが存在しない場合

は、RECFM が "F" または "FB" で LRECL が 80 のデータセットを割り当

てます。

2. ステップ 1 で取得したジョブ名と番号を使用して、TSO READY プロン

プトまたは ISPF TSO コマンドパネルから以下のコマンドを発行しま

す。

OUTPUT jobname (jobnumber) PRINT ('data set')

TSO に、JCL ストリームが指定されたデータセットに格納されたことを

示す "OUTPUT" が表示されます。 End キーを押します。

3. 以下のように JCL を編集します。

a. JOB ステートメントから「TYPRUN=COPY」を削除します。

b. その他のジョブパラメータを適宜調整します。

c. JES 統計情報を削除します。

d. ファイル内の最初のステートメントが JOB ステートメントで、最

後のステートメントが ISPSLIB(C1BMXEOJ) スケルトンの拡張である


e. 必要に応じて、すべてのパラメータカードで日時コンポーネント

を変更して、意図した実行日時に一致するようにします。これら

の日時フィールドは一意のデータセット名を生成するために使用

され、適切な出荷に対して確認メッセージが必ず返されるように

なります。これらのフィールドは、スケジュールに関する制限に

は使用されません。たとえば、以下のコードで、YYYYMMDD は有

効な年月日の形式です。 HHMMSSTT は有効な時間（100 分の 1 秒

を含む）です。

PARM='C1BMX000,YYYYMMDD,HHMMSSTT,….

f. 前のステップのパラメータカードで使用された日時と一致するよ

うに、すべての一時データセット名

（<prefix>.D<yymmdd>.T<hhmmss>.* 形式）をカスタマイズします。

ノード長の制限により、日時のより短いバージョンが使用されま

す。世紀は日付から省略され、100 分の 1 秒は時間から省略されま

す。



実行時にパッケージおよび配布先情報を指定する方法

パッケージ配布ユーティリティへの実行時入力は、NDVRSHIP ジョブス

テップで C1BMXIN データセットを介して読み込まれます。入力は、パッ

ケージ配布 SCL です。

注：パッケージ配布 SCL の詳細については、「パッケージ配布 SCL の使用」

を参照してください。

以下の方法を使用して、C1BMXIN DD ステートメントを変更できます。

■ インストリームデータセットとして残し、各実行の前に、それに続く

SCL を変更します。

■ C1BMXIN DD ステートメントを、インストリームデータセットから順

次データセット、または各実行まで SCL を格納できる PDS メンバ

（RECFM=F または FB、LRECL=80）に変更します。

■ SCL ジェネレータを使用して、NDVRSHIP ステップに先行して、C1BMXIN

を介して渡される SCL と一時データセットを生成します。

これで、JCL ストリームをサブミットできます。

パッケージシップ用に USS サポートファイルを有効にする方法



変更マネージャ（CA Endevor SCM 管理者）は、パッケージ配布機能に対し

て USS サポートファイル（HFS、zOS、または NFS ファイル）を有効にで

きます。 USS サポートファイルを配布できるようにするには、これらの

ファイルのバックアウトファイルおよびレコードが存在する必要があり

ます。バックアウトファイルおよびレコードを作成するには、エレメン

トタイプ定義に関連付けられたプロセッサに ENUSSUTL ユーティリティ

を追加します。

以下の図は、パッケージ配布用に USS ファイルを有効にし、必要に応じて

USS ソース出力を有効にする方法を示しています。

パッケージ配布用に USS ファイルを有効にするには、以下の手順に従いま

す。

1. パッケージ配布用に USS ファイルを有効にします (P. 149)。

2. （オプション）パッケージ配布用に USS ソース出力ファイルを有効に

する方法 (P. 154) — このプロセスは、バックアウトまたは配布用に

USS ソース出力ファイルを所持している場合のみ必要です。

詳細情報

ENUSSUTL ユーティリティ (P. 156)



パッケージ配布用の USS サポートファイルの有効化

バックアウトファイルおよびレコードは、パッケージ配布機能を使用し

てパッケージ出力を配布にするのに必要です。 USS でサポートされるファ

イルについては、ENUSSUTL ユーティリティはバックアウトファイルおよ

びレコードを作成します。エレメントタイプに関連付けられるプロセッ

サには、バックアウトファイルを収集しエレメントに関連付けるために

ENUSSUTL ユーティリティを含める必要があります。


1. ENUSSUTL ユーティリティを適切な Copy および Select、または Delete

および Select ステートメントを持ったプロセッサへ追加します。

ENUSSUTL 構文は、Move、Generate または Delete プロセッサでそれが

使用されるかどうかに依存します。 Move および Generate プロセッサ

は Copy ステートメントを使用します。 Delete プロセッサは Delete ス

テートメントを使用します。

■ Generate および Move プロセッサ

COPY 構文 - Generate および Move プロセッサでは、Copy, Select グ

ループステートメントが使用されます。 Generate プロセッサで、

USS ファイルを CA Endevor SCM パスロケーションから一時パスに

コピーします。次に、このファイルを ENUSSUTL ユーティリティへ

の入力として使用します。

Indd dd-name Outdd dd-name をコピーします。

ファイル file-name [Newfile file-name] を選択します。

Indd dd-name Outdd dd-name のコピー

dd-name のコピーソースおよびターゲットパスのロケーショ

ンを識別します。

Indd dd-name

dd-name のソースロケーションを指定します。 CA Endevor

SCM およびユーザシンボリックは、JCL パス名指定で使用でき

ます。

Outdd dd-name

dd-name のターゲットロケーションを指定します。 CA Endevor

SCM およびユーザシンボリックは、JCL パス名指定で使用でき

ます。



ファイル file-name の選択

関連する Copy ステートメントのソースロケーションで、ファ

イルの名前を指定します。 Newfile 節が使用されない場合、こ

のファイル指定はターゲットロケーションで使用されます。

ファイル名には、255 文字まで指定できます。複数の 80 文字

の行にまたがる値を指定する方法の詳細については、「SCL

Reference Guide」を参照してください。 Copy ステートメントの

後に複数の Select ステートメントを指定できます。 Copy およ

び Select グループステートメントがサポートされています。

Select ステートメントは、それに先行する Copy ステートメント

とペアになります。ファイル名の指定に、CA Endevor SCM およ

びユーザシンボリックを使用できます。

Newfile file-name

（オプション）ターゲットロケーションでファイルに使用され

るコピーファイル名を指定します。この節が使用されない場

合、ファイル指定名が使用されます。ファイル名には、255 文

字まで指定できます。複数の 80 文字の行にまたがる値を指定

する方法の詳細については、「SCL Reference Guide」を参照して

ください。ファイル名の指定に、CA Endevor SCM およびユーザ

シンボリックを使用できます。

Move プロセッサのサンプル構文

//COPY1 EXEC PGM=ENUSSUTL

//INPUT DD PATH=’input-pathame’

//OUTPUT DD PATH=’output-pathname’,

// PATHMODE=(SIRWXU,SIRWXG,SIRWXO)

//ENUSSIN DD *

COPY INDD ‘INPUT’ OUTDD ‘OUTPUT’ .

SELECT FILE ‘fileone.ext’ .

SELECT FILE ‘filetwo.ext’ .



Generate プロセッサのサンプル構文

//BPXW1 EXEC PGM=BPXBATCH

//STDPARM DD *

//SH cp –B ‘pathname.&C1ELELMNT255.’ ‘temp-pathname.&C1ELELMNT255.’;



//COPY1 EXEC PGM=ENUSSUTL

//INPUT DD PATH=’temp-pathame’

//OUTPUT DD PATH=’pathname’,


//ENUSSIN DD *


SELECT FILE &C1ELELMNT255. .

Copy 構文のルールは、以下のようになっています。

■ COPY ステートメントの後に複数の SELECT ステートメントを

指定できます。

■ 複数の COPY SELECT グループを指定できます。 Select ステート

メントは、先行する Copy ステートメントに関連付けられます。

COPY INDD ‘INPT1’ OUTDD ‘OUTP1’ .



COPY INDD ‘INP2’ OUTDD ‘OUTP2’ .

SELECT FILE ‘filethree.ext’ .

■ Copy DD JCL ステートメントで使用される場合、JCL PATHOPTS パ

ラメータは無視されます。

■ PATHMODE パラメータは、OUTDD DD ステートメントで使用さ

れる必要があります。指定されない場合、デフォルトの

filemode は '000' に設定されます。

■ INDD DD ステートメントでは、パスの連結は許可されません。

ユーティリティは構文検証中にこれを確認し、これが検出され

た場合はエラーになります。

■ 同じパスおよびファイル名にコピーすることはできません。

■ デフォルトでは、ENUSSUTL は代替 ID の認証情報を使用して

USS ファイルをコピーするため、コピー後のファイルの所有者

およびグループは代替 ID です。コードではなくユーザの認証

情報を使用する場合、プロセッサステップで ALTID=N です。



■ Delete プロセッサ

DELETE 構文 - Delete プロセッサでユーティリティの Delete および

Select グループステートメントを使用します。

FRomDD dd-name を削除します。

ファイル file-name の選択を選択します。

FRomdd dd-name の削除

DELETE ターゲットパスのロケーションを識別します。

FRomdd dd-name

FROM dd-name を指定します。 CA Endevor SCM およびユーザシ

ンボリックは、JCL パス名指定で使用できます。

ファイル file-name を選択します。

Delete ステートメントに関連付けられている、削除されるファ

イルの名前を指定します。ファイル名には、255 文字まで指定

できます。複数の 80 文字の行にまたがる値を指定する方法の

詳細については、「SCL Reference Guide」を参照してください。

Delete ステートメントの後に複数の Select ステートメントを

指定できます。 Delete および Select グループステートメントが

サポートされています。 Select ステートメントは、それに先行

する Delete ステートメントとペアになります。ファイル名の

指定に、CA Endevor SCM およびユーザシンボリックを使用でき

ます。

Delete プロセッサのサンプル構文

//DEL1 EXEC PGM=ENUSSUTL

//FROM DD PATH=’pathname’,


//ENUSSIN DD *

DELETE FROMDD ‘FROM’





Delete 構文のルールは、以下のようになっています。

■ Delete ステートメントの後に複数の SELECT ステートメントを

指定できます。

■ 複数の DELETE SELECT グループを指定できます。 Select ステー

トメントは、先行する Delete ステートメントに関連付けられ

ます。

DELETE FROMDD ‘FROM1’ .



DELETE FROMDD ‘FROM2’ .

SELECT FILE ‘filethree.ext’ .

■ Delete DD JCL ステートメントで使用される場合、JCL PATHOPTS

パラメータは無視されます。

■ FROMDD DD ステートメントでは、パスの連結は許可されませ

ん。ユーティリティは構文検証中にこれを確認し、これが検出

された場合はエラーになります。

■ デフォルトでは、ENUSSUTL は代替 ID の認証情報を使用して

USS ファイルを削除するため、代替 ID 適には開始パスに対する

適切なアクセス権が必要です。コードではなくユーザの認証情

報を使用する場合、プロセッサステップで ALTID=N です。

2. （オプション）パーサによって作成された ENUSSUTL コマンドのエ

コーが C1MSGS1 出力に表示されるのを抑制したい場合は、NOECHO パ

ラメータを EXEC ステートメントに含めます。

NOECHO

SCL ステートメントが C1MSGS1 出力に表示されるのを抑制します。

たとえば、以下の EXEC ステートメントには NOECHO パラメータが

含まれて、ENUSSUTL コマンドが C1MSGS1 出力に表示されるのを抑

制します。

//STEPxx EXEC PGM=ENUSSUTL,PARM=’NOECHO’



USS ソース出力ファイルのバックアウトを有効にする方法

タイプ定義によって CA Endevor SCM で作成されたソース出力 USS ファイ

ルは、バックアウトまたは配布できません。この代替ファイルを作成し、

パッケージバックアウトおよび配布で利用可能にするには、タイプ定義

およびプロセッサを変更する必要があります。プロセッサを変更する方

法の 1 つは、プロセッサで CONWRITE および ENUSSUTL ユーティリティを

使用することです。この方法を使用するには、以下の手順を完了します。

1. CONWRITE ユーティリティをプロセッサに追加して、エレメントを一

時ファイルへ抽出します。 CONWRITE の詳細については、「Extended

Processors Guide」を参照してください。

2. ENUSSUTL ユーティリティをプロセッサで CONWRITE ユーティリティ

の後に追加します。 Copy および Select ステートメントを使用して、

ENUSSUTL ユーティリティが一時ファイルをターゲットの USS ファイ

ルにコピーするように指定します。ターゲットにされた USS ファイル

は、タイプ定義で定義されたソース出力ライブラリです。

このエレメントに対するパッケージ処理制御下でアクションが実行さ

れる場合、ENUSSUTL ユーティリティの使用によって、バックアウトレ

コードおよびバックアウトファイルが作成されます。 ENUSSUTL ユー

ティリティの使用の詳細については、「パッケージ配布用のサポート

ファイルの有効化」を参照してください。

3. SOURCE OUTPUT USS ライブラリ定義を削除するために、タイプ定義を

変更します。

注：ソース出力 USS ファイルをバックアウトも配布もしない場合は、プロ

セッサまたはタイプ定義を変更する必要はありません。



例： USS ソース出力ファイル用のプロセッサ内の CONWRITE および ENUSSUTL

この例では、プロセッサが CONWRITE および ENUSSUTL ユーティリティを

使用して、どのように USS ソース出力ファイル用のバックアウトファイ

ルおよび情報を作成できるかを示します。こうして、USS ファイルの配布

が可能になります。この部分的なプロセッサは、CONWRITE ユーティリ

ティを使用して CA Endevor SCM エレメントから USS 出力を作成し、それ

を一時 USS ファイルにコピーします。次に、ENUSSUTL ユーティリティは

USS ファイルをその実際の名前およびロケーションにコピーします。次に、

BPXBATCH ユーティリティは一時 USS ファイルを削除します。

//GUSS PROC USSDIR=’/u/users/endeavor/&C1EN(1,1)&C1S#/’

•

•

•

//***********************************************************

//* Create USS output from endevor element to a temporary USS

//* file and then use ENUSSUTL t0 copy it to its real name

//* and location.

//* Delete the temporary USS file

//* - CONWRITE element.tmp

//* - ENUSSUTL copy element.tmp to element

//* - BPXBATCH delete element.tmp

//***********************************************************

//CONW1 EXEC PGM=CONWRITE,MAXRC=0

//ELMOUT1 DD PATH=’&USSDIR’,

// PATHOPTS=(OWRONLY,OCREAT),


//CONWIN DD *

WRITE ELEMENT &C1ELMNT255

FROM ENV &C1EN SYSTEM &C1SY SUBSYSTEM &C1SU

TYPE &C1TY STAGE &C1SI

TO DDN ELMOUT1

HFSFILE &C1ELMNT255..TMP

.

//***********************************************************

//ENUSS1 EXEC PGM=ENUSSUTL,MAXRC=4

//INPUT DD PATH=’&USSDIR’

//OUTPUT DD PATH=’&USSDIR’,


//ENUSSIN DD *


S FILE ‘&C1ELMNT255..tmp

NEWF ‘&C1ELMNT255’

.

//***********************************************************

//BPXB1 EXEC PGM=BPXBATCH,MAXRC=0,COND=(4,LT)

//STDPARM DD *



SH rm –r ‘&USSDIR.&C1ELMNT255..tmp’ ;



//*

ENUSSUTL ユーティリティ

ENUSSUTL プロセッサユーティリティは、USS プロセッサ出力ファイル用

のパッケージバックアウト情報を収集します。このバックアウト情報は、

バックアウトレコードおよびバックアウトファイルで構成されます。

USS ファイルのパッケージ出力は、パッケージ配布ユーティリティを使用

して、他のサイトに転送できます。ただし、USS ファイルのパッケージ

バックアウト情報が使用可能でない場合、出力は配布できません。この

情報を収集するために、エレメントタイプに関連付けられたプロセッサ

に ENUSSUTL ユーティリティを含めて、バックアウトファイルを収集しエ

レメントに関連付ける必要があります。このユーティリティがパッケー

ジ処理で実行される場合、このユーティリティによって、これらのファイ

ルがパッケージバックアウトおよびパッケージ配布用に有効になります。

Generate および Move プロセッサ - Generate および Move プロセッサでの

ENUSSUTL ユーティリティプログラムの実行によって、ユーザが選択した

USS ファイルがユーザが指定した USS ディレクトリへコピーされます。

パッケージ下で実行されると、USS ファイル用のバックアウトファイルお

よびバックアウトレコードが作成されます。

■ バックアウトファイルはターゲットロケーションに格納されます。

■ バックアウトレコードは CA Endevor SCM パッケージデータセットに

格納されます。

Delete プロセッサ - Delete プロセッサでの ENUSSUTL ユーティリティの実

行によって、ユーザが選択した USS ファイルがユーザが指定した USS ディ

レクトリから削除されます。パッケージ下で実行されると、これらの USS

ファイル用のバックアウトファイルおよびバックアウトレコードが作成

されます。

■ バックアウトファイルは同じユーザ指定の USS ディレクトリに格納

されます。

■ バックアウトレコードは CA Endevor SCM パッケージデータセットに

格納されます。



Move プロセッサ内での ENUSSUTL の動作の仕組み

Move プロセッサ内で Copy コマンドおよび Select コマンドを持つ

ENUSSUTL ユーティリティは、パッケージバックアウトのレコードとファ

イルを以下のように作成します。

1. Select のソースファイルがターゲットロケーションに存在する場合、

8 文字のバックアウトファイル名が生成され、バックアウトとして保

存されるファイルの名前として使用されます。選択したファイルは、

ターゲットロケーションで、バックアウトで保存されたファイル名へ

名前が変更されます。

2. 選択された Indd パスおよびファイルは、Outdd パスおよびファイルに

コピーされます。

3. USS Backout レコードが、パッケージデータセットに書き込まれます。

Generate プロセッサ内での ENUSSUTL の動作の仕組み

Generate プロセッサ内に Copy および Select コマンドを持つ ENUSSUTL

ユーティリティは、Move プロセッサで記述されているようなバックアウ

トレコードおよびファイルを作成します。このユーティリティが

Generate プロセッサで呼び出される前に、USS ファイルを別の一時ディレ

クトリにコピーするステップが必要です。これらのファイルは、次に、

ENUSSUTL ユーティリティへの入力用に選択できます。

DELETE プロセッサ内での ENUSSUTL の動作方法

ENUSSUTL ユーティリティは、DELETE プロセッサ内の Delete コマンドおよ

び Select コマンドで、バックアウトレコードとファイルを以下のように作

成します。

■ Select のソースファイルがターゲットロケーションに存在しない場

合、バックアウト処理または名前の変更処理は実行されません。

■ Select のソースファイルがターゲットロケーションに存在する場合、

8 文字のバックアウトファイル名が生成され、バックアウトとして保

存されるファイルの名前として使用されます。既存のファイルは、同

じロケーションにあるバックアウト保存ファイル名に名前を変更され

ます。

■ 選択したファイルが削除されます。

■ USS Backout レコードが、パッケージデータセットに書き込まれます。

配布後スクリプトの実行を有効にする方法



CA Endevor SCM 管理者は、パッケージ配布プロセスの完了前または完了後

に、リモートの配布先でスクリプトと呼ばれるカスタムジョブステップ

を条件付きで実行する配布後スクリプト機能を有効にすることができま

す。

以下の図は、配布後スクリプト機能を有効にする方法を示しています。



配布後スクリプトの実行を有効にするには、以下の手順に従います。

1. C1DEFLTS テーブルを設定します (P. 159)。これには、C1DEFLTS テーブ

ルの確認、および必要に応じたテーブルの更新が含まれます。

2. GENERATE または MOVE プロセッサを更新 (P. 160)し、スクリプトを作

成するステップを追加します。

3. スクリプトファイルが含まれるデータセットのマッピングルールを

定義 (P. 161)します。スクリプトデータセットに対して、マッピング

ルールのリモートの配布先を (SCRIPT-FILE) として定義します。

4. （オプション）配布先設定メンバを作成 (P. 162)し、各パッケージ配

布先に対して一意のシンボル名および値を定義します。このメンバは、

スクリプトデータセットに追加されたメンバの配布先に一意のシン

ボルを使用する場合にのみ必要です。

5. モデルスクリプトステップを作成します (P. 164)。

配布後スクリプト用の C1DEFLTS の設定

配布後スクリプト機能を有効にするには、C1DEFLTS テーブルが特定の要件

を満たしている必要があります。


1. C1DEFLTS テーブルを確認し、RJCLROOT パラメータが ICPY または FCPY

のいずれかに設定されていることを確認します。このオプションが省

略されている場合は、値に RJCLROOT=ICPY を挿入します。 RJCLROOT パ

ラメータの詳細については、「リモートジョブストリーム

（C1DEFLTS）」を参照してください。

2. （オプション）配布先スクリプトのシンボルを使用する場合は、以下

のように C1DEFLTS テーブルを更新します。

a. DESTCFGMBR= パラメータを使用して、C1DEFLTS に対して配布先設

定メンバの名前を定義します。値を指定しない場合は、デフォル

トで NULL になります。

b. C1DEFLTS テーブルを確認し、有効な PARMLIB データセットが存在

することを確認します。

3. C1DEFLTS テーブルを再アセンブルします。



配布後スクリプト用のプロセッサの更新

配布後スクリプト機能を有効にするには、プロセッサを更新してスクリプ

ト出力データセットを作成するステップを追加する必要があります。


1. GENERATE または MOVE プロセッサを更新し、サイトの要件に基づい

て、必要なリモートスクリプト構文を作成するために必要な追加の手

順を挿入します。

2. パッケージ処理がバックアウトレコードを作成してスクリプトファ

イルを追跡できるようにするため、MONITOR キーワードおよび

BACKOUT キーワードがスクリプトデータセットで指定されているこ

とを確認します。

3. スクリプトデータセットの内容を容易に判断できるように、スクリプ

トデータセットに名前を付けます。スクリプトデータセットの最後

の修飾子は、モデル制御ステートメントを作成するときに使用されま

す。そのため、さまざまなタイプのスクリプト処理を判別できるよう

に、適切な名前を選択してください。たとえば、CICS フェーズインリ

クエストに CICSNEWC、または DB2 バインドリクエストに DB2BIND な

どの適切な名前を付けます。

例：配布後スクリプトを実行する CICS NEW COPY スクリプトの作成

以下に、パッケージでプロセッサが実行された場合に CICS フェーズイン

リクエストを作成するコードサンプルを示します。この例の &CICSREGN

シンボルは、配布時に置き換えられます。

//***************************************************************

//* CREATE CICS NEW COPY SCRIPT

//***************************************************************

//PKGCHK IF &C1PKGID NE "" THEN * ONLY IF PACKAGE EXEC

//SCRIPCP EXEC PGM=IEBGENER,MAXRC=0

//SYSPRINT DD SYSOUT=*

//SYSIN DD DUMMY

//SYSUT2 DD DISP=SHR,MONITOR=&MONITOR,FOOTPRNT=CREATE,

// DSN=&DSPREFIX.CICSNEWC(&C1ELEMENT)

//SYSUT1 DD DATA,DLM=##

/*VS,'F &CICSREGN,CEMT SET PRO(&C1ELEMENT),PHASEIN'

##

//PKGCHKX ENDIF



配布後スクリプトデータセットのマッピングルールの定義

スクリプトが含まれるプロセッサ出力ファイル用のデータセットマッピ

ングルールを定義します。


1. スクリプトデータセット名と一致するように、ホストデータセット

名フィールドのマスクを指定します。

2. 次に示されているキーワードを正確に使用して、リモートデータセッ

ト名フィールドの値を指定します： (SCRIPT-FILE)。

必須の丸かっこ、およびダッシュは、データセット名として有効な文

字ではないため、この値がデータセット名と間違えられることはあり

ません。

注：マッピングルールの定義の詳細については、「マッピングルールの作

成 (P. 130)」を参照してください。

例：スクリプトファイルのマッピングルール

最後の修飾子が CICSNEWC のスクリプトデータセットのマッピングルー

ルを作成するには、以下に示すようにホストデータセット名およびリ

モートデータセット名を定義します。

ホスト・データ・セット名 ===> *.*.*.CICSNEWC

マップ先

リモート・データ・セット名 ===> (SCRIPT-FILE)

注：この例は、「配布後スクリプト用のプロセッサの更新 (P. 160)」に示す

例で作成された CICS NEW COPY スクリプトのマッピングルールを作成し

ます。

注：スクリプトファイルがマッピングルールによって識別されると、DSN

マッピング選択リストのステータス列にスクリプトが表示されます。



配布先設定ファイルの作成

プロセッサによって作成されたスクリプトファイル内の配布先によって

一意のシンボルを使用する場合は、配布先設定ファイルを作成する必要が

あります。配布先設定メンバには、パッケージ配布の実行時に読み取り

および解析され、ターゲット配布先のシンボルを解決するためにスクリプ

トデータセットメンバで使用できる配布先に一意のシンボルを作成する

ステートメントが含まれます。


1. 配布先設定ファイルを作成し、各パッケージ配布先に一意のシンボル

名および値を定義します。

以下の構文を使用して、各配布先のシンボル名と値を定義します。

>>-- DESTination 'destid' --------------------------->

+<----<----<----<----<----<----<----<----<----<---+

--+--> SYMbol 'symbol-name' VALue 'symbol-value' --–->

---> . ---------------------------------------------><

このステートメントを各配布先に対して繰り返し、シンボルと値の組

み合わせを各ステートメント内で必要に応じて何度も定義できます。

シンボルをコード化する場合は（尐なくとも 1 つ必要）、値もコード

化する必要があります。シンボルに NULL 値をコード化するには、

VALUE キーワードの後に連続した 2 つの単一引用符を使用します。

2. 配布先設定メンバを PARMLIB に追加します。



3. 配布先によって異なる情報を表すシンボルを、必要に応じてスクリプ

トデータセットメンバに含めます。

重要：シンボルの置換によって、行がオーバーフローして、構文エラー

が発生する可能性があります。

シンボルの最大長を考慮するか、適切な構文を生成するシンボルの部

分文字列を使用します。シンボルの部分文字列の構文の詳細について

は、「Extended Processors Guide」を参照してください。または、パス

やファイル名など、長いシンボルを置換する必要がある場合は、可変

長ブロック（RECFM=VB）スクリプトファイルの使用を検討します。

注：配布先設定メンバの内容は、表示オプションメニューから表示できま

す。また、構文エラーもこのメニューで確認できます。配布先設定メン

バの名前は、C1DEFLTS のサイト情報パネルのパラメータライブラリ情報

セクションに表示されます。スクリプトファイルがマッピングルールに

よって識別されると、DSN マッピング選択リストのステータス列にスクリ

プトが表示されます。右側にスクロールすると、スクリプトの実行ステー

タスが返され、配布ステータスビューに表示されます。

例：配布後スクリプトの配布先設定ファイル

この配布先設定ファイルの例は、ターゲットの配布先に応じて、シンボル

CICSREGN にさまざまな値を定義します。

DESTINATION CA31XCM

SYMBOL 'CICSREGN' VALUE 'CICS31DN'

SYMBOL 'DB2SYS' VALUE 'DBS31DN' .

DESTINATION CA11LOC

SYMBOL 'CICSREGN' VALUE 'CICS11PR'

SYMBOL 'DB2SYS' VALUE 'DB2S11DN' .

注：この例は、「配布後スクリプト用のプロセッサの更新 (P. 160)」に示す

例で作成された CICS NEW COPY スクリプトの CICSREGN シンボルを作成し

ます。



モデルスクリプトステップの作成

独自のスクリプトを作成するか、サイトの要件に応じて配布 JCL モデル

（CSIQOPTN ライブラリの #RJNDVRA および #RJNDVRB）を編集することに

よって、モデルスクリプトジョブステップをカスタマイズできます。こ

れらのモデルには、リモートジョブのジョブステップが含まれています。

このジョブステップは、配布にスクリプトデータセットが含まれている

かどうかに基づいて、ジョブがパッケージ出力をターゲットデータセッ

トへコピーする前またはコピーした後に実行されます。

条件付き実行を有効にする場合、シンボルは各スクリプトデータセット

を表します。シンボルは、ホストデータセット名の最後の修飾子に基づ

いており、文字 ZZ が先頭に付けられます（たとえば、データセット

BST.USER12.CICSNEWC では &ZZCICSNEWC になります）。シンボルの値は、

スクリプトデータセットのリモートステージングデータセット名です。

シンボルは、@IF ステートメントおよび @IFNOT ステートメントを使用し

て、パッケージ配布モデル制御メンバ内で確認できます。したがって、

スクリプトジョブステップは、データセットのシンボルを解決してスク

リプトデータセットが配布に存在するかどうかを判定することで、条件

に応じてリモートジョブステップに生成することができます。

例： CICS NEW COPY の配布後スクリプトステップのモデル

このモデルコードは、CSIQOPTN ライブラリの #RJNDVRA として配布され

ます。このコードサンプルは、データセットがリモートターゲットにコ

ピーされた後に CICS NEW COPY を実行します。スクリプトファイルは、

PDS/ライブラリメンバとして、スクリプトを作成したメンバごとに 1 つ転

送され、多くのスクリプトファイルに転送される可能性があります。

@REM ************************************************************

@REM * THESE STEPS WILL EXECUTE AFTER THE COPY TO THE REMOTE TGT

@REM ************************************************************

//* START #RJNDVRA

@IF &ZZCICSNEWC

//* START SCRIPT CICS NEW COPY

//ASCRIPT1 EXEC PGM=<YourNewCopyUtil>

//SCRIPTIN DD DISP=SHR,

// DSN=&ZZCICSNEWC

...

<insert your site specific JCL here...>

...

//* END SCRIPT 1

@ENDIF



例： PDS をシーケンシャルファイルにフラット化する配布後スクリプトステップ

のモデル

このモデルは、CSIQOPTN ライブラリの #RJNDVRB として配布されます。こ

のコードサンプルは、PDS をシーケンシャルファイルにフラット化しま

す。（この例には変更された区切り線が含まれます。）処理のためにシー

ケンシャル入力が必要な場合は、独自のユーティリティまたは標準的な

IBM ユーティリティを使用して、この例に示すようにライブラリ構造をフラット化する必要がある場合があります。 @REM ************************************************************

@REM * THESE STEPS provide a sample FLATTEN process

@REM ************************************************************

@IF &ZZSCRIPTFB

//***************************************************************

//* THIS SCRIPT WILL TAKE A PDS & CREATE A FLAT (SEQUENTIAL) FILE

//* FROM ITS MEMBERS USING STANDARD IBM UTILITIES.

//*

//***************************************************************



//*

//SCR010 EXEC PGM=IDCAMS * FIRST CLEAN UP TEMP MEMBERS


//SYSIN DD *

DEL &ZZSCRIPTFB.P

DEL &ZZSCRIPTFB.S

SET MAXCC = 0

//*

//SCR020 EXEC PGM=IEBPTPCH * THEN PUNCH OUT ALL MEMBERS


//SYSUT1 DD DISP=SHR,

// DSN=&ZZSCRIPTFB

//SYSUT2 DD DISP=(,CATLG),

// DSN=&ZZSCRIPTFB.P,

// SPACE=(CYL,(1,1),RLSE),

// UNIT=SYSDA,

// DCB=(RECFM=FBA,LRECL=81)

//SYSIN DD *

PUNCH TYPORG=PO

//*

//SCR030 EXEC PGM=SORT * USE SORT TO STRIP OFF LEADING

//SYSOUT DD SYSOUT=* * PUNCH CONTROL CHARACTERS

//SYSPRINT DD SYSOUT=* * AND REPLACE MEMBER CARDS

//SYSUDUMP DD SYSOUT=*

//REPORT1 DD SYSOUT=*

//SORTIN DD DISP=SHR,

// DSN=&ZZSCRIPTFB.P

//SORTOUT DD DSN=&ZZSCRIPTFB.S,

// DISP=(,CATLG),

// UNIT=SYSDA,

// SPACE=(CYL,(1,1)),

// DCB=(RECFM=FB,LRECL=80)

//SORTWK01 DD UNIT=DISK,SPACE=(CYL,(5,5))



//SYSIN DD *

SORT FIELDS=COPY

INREC IFTHEN=(WHEN=(2,13,CH,EQ,C'MEMBER NAME '),

BUILD=(C'./ ADD NAME=',15,8)),

IFTHEN=(WHEN=NONE,BUILD=(1:2,80))

//*

//* END SCRIPT 1

@ENDIF

@IFNOT &ZZSCRIPTFB

//* START SCRIPT - THIS STEP WILL RUN IF THERE IS NO SCRIPT FILE

//BSCRIPT1 EXEC PGM=IEFBR14,COND=((0,LE),ONLY) NO SCRIPT STEP

//* END SCRIPT 1

@ENDIF

ホストパッケージ出荷ジョブステップ



配布キューをサブミットすると、CA Endevor SCM は、JCL ストリームを作

成およびサブミットし、パッケージを配布します。このセクションの残

りの部分では、この配布 JCL のステップについて説明します。

配布の作成およびステージング方法

以下に表示されているように、CA Endevor SCM は C1BMXJOB および

C1BMXLIB スケルトン JCL を使用してこのステップを構築します。



前の図に示されているように、このステップの実行時に、配布ユーティリ

ティは以下の内容で構成される配布を作成します。

■ パッケージ実行に関与する各ライブラリのステージングデータセッ

ト。

■ IEBCOPY ステップ、IDCAMS（削除）ステップおよび確認ステップで構

成される、リモートサイトで実行される JCL。

■ データセットを転送し、リモートコピー/削除ジョブを実行する、デー

タ転送ユーティリティコマンドおよび JCL (ローカル転送には適用で

きません)。

■ ホストおよびリモート本番環境とステージングデータセットの間の

対応関係のファイル。

■ 補足的なファイルおよび JCL（必要に応じて）。

配布ユーティリティは次にステージングデータセットにデータを取り込

み、配布を記録し、配布全体をステップ 2 へ渡します。

ステージングデータセット

ステージングデータセットのプレフィックスが、各配布先に対して定義

されます。これにより、ステージングデータセットをカタログ化できま

す。配布ユーティリティは、残りのデータセット名を生成します。形式

は以下のとおりです。

prefix.Dyymmdd.Thhmmss.destination.suffix

prefix

定義の作成/変更パネル上のホストまたはリモートサイトのユーザ定

義プレフィックス、またはデフォルト値の TSOuserid.NDVR。

Dyymmdd

配布キューがサブミットされた日付。

Thhmmss

配布キューがサブミットされた時刻。

destination

配布先名。



suffix

配布メンバの種類。有効なサフィックスは以下のとおりです。

AxJOB — ホスト（AHJOB）またはリモート（ARJOB）コピー/削除/確認

ジョブストリームを識別します。

CxJOB — 補助データセットのホスト（CHJOB）またはリモート（CRJOB）

コピー/削除/確認ジョブストリームを識別します。

.AxREF — ホスト（AHREF）またはリモート（ARREF）データセット名、

または USS パス相互参照ファイル、またはその両方を識別します。

AxPAX — 配布内に USS ファイルおよび補助（存在する場合）を含める

ために使用されるホスト（AHPAX）またはリモート（ARPAX）アーカイ

ブファイルを識別します。このファイルはオプションであり、配布リ

クエストに USS オブジェクトが含まれる場合にのみ存在します。

AxUCD — un-pax および copy コマンドを実行して、配布された USS オ

ブジェクトを最終ロケーションに移動するホスト（AHUCD）またはリ

モート（ARUCD）コマンドストリームを識別します。このファイルは

オプションであり、配布リクエストに USS オブジェクトが含まれる場

合にのみ存在します。

.AHnnn — ホスト配布データセットを識別します。ここで nnn は、001

から始まる連続番号です。

.CHnnn — ホスト補助データセットを識別します。ここで、nnn は、001

から始まる連続番号です。

.ARnnn — リモート配布データセットを識別します。ここで nnn は連

続番号であり、そのホスト側の AHnnn に対応します。

.CRnnn — リモート補助データセットを識別します。ここで nnn は連続

番号であり、そのホスト側の CHnnn に対応します。

.SHnnn — ホスト配布スクリプトデータセットを識別します。ここで

nnn は、001 から始まる連続番号です。

.THnnn — ホスト補助スクリプトデータセットを識別します。ここで

nnn は、001 から始まる連続番号です。

.SRnnn — リモート配布スクリプトデータセットを識別します。ここ

で nnn は連続番号であり、そのホスト側の SHnnn に対応します。

.TRnnn — リモート補助スクリプトデータセットを識別します。ここ

で nnn は連続番号であり、そのホスト側の THnnn に対応します。



以下に、ステージングデータセット名の例を示します。

■ userid.NDVR.D071130.T142532.BOSTON.AH0000034

■ userid.NDVR.D071130.T143515.CHICAGO.CRJOB

■ userid.NDVR.D071130.T145216.BOSTON.ARREF

リモート実行 JCL

リモート実行用の JCL のデータセット名にはサフィックス「.AHJOB」が付

いています。この JCL は最大 4 つのジョブステップで構成され、各ステッ

プは以下のように説明されます。

1. IEBCOPY を使用した、リモートステージングデータセットから本番稼

働データセットへのパッケージ出力のコピー。

2. すでにホストで削除された本番環境データセットからのメンバの削

除。

3. コピー/削除手順の確認。

4. 任意選択。ステージングデータセットの削除。

配布ユーティリティが補足的なデータセットも作成する場合、それら

のデータセットにデータ名サフィックス「.CHJOB」を付けて、それら

のデータセットの JCL も作成します。

リモート JCL 実行コマンド

リモート JCL は、自動的にまたはリモートサイトの判断で（手動で）実行

できます。選択は、"E" モデル転送制御メンバ（#PSXCOME、#PSBDT1E、

#PSLOCLE、#PSNFTPE、 #PSNWDME、または #PSBAT2E）をカスタマイズす

ることで行なわれます。補足的なデータセット JCL（.CHJOB）は手動での

み実行できます。

注：詳細については、「モデル転送制御ステートメントの作成 (P. 136)」を

参照してください。



データセット対応関係ファイル

以下のデータセット対応関係のデータセット名には、サフィックス

「.AHREF」が付いています。パッケージ実行に関係するすべてのデータ

セットについて、このファイルはホストおよびリモートサイトでの本番

環境名およびステージング名の両方を指定します。

以下に例を示します。

SHIPMENT DATASETS

HOST LIBRARY: BST.XDVRC1S1.LISTINGS

HOST STAGING: DA1ME10.D10322.T164235.BOSTON1.AH003

REMOTE STAGING: DA1ME10.D10322.T164235.BOSTON1.AR003

REMOTE LIBRARY: BST.XDVRC1S1.LISTINGS

*

SHIPMENT DATASETS

HOST LIBRARY: BST.XDVRC1S1.LKEDLIB



REMOTE LIBRARY: BST.XDVRC1S1.LKEDLIB

*

SHIPMENT DATASETS

HOST LIBRARY: BST.XDVRC1S1.LKEDLIST



REMOTE LIBRARY: BST.XDVRC1S1.LKEDLIST

*

SHIPMENT DATASETS

HOST LIBRARY: BST.XDVRC1S1.LOADLIB



REMOTE LIBRARY: BST.XDVRC1S1.LOADLIB

*

SHIPMENT DATASETS

HOST LIBRARY: BST.XDVRC1S1.OBJLIB



REMOTE LIBRARY: BST.XDVRC1S1.OBJLIB



配布コンテンツ

ステップ 1 の終了時点で、配布ユーティリティは、以下で構成される配布

を作成します。

■ パッケージ出力（.AHnnn）

■ リモート JCL（.AHJOB）

■ データセット相互参照ファイル（.AHREF）

配布に USS ファイルが含まれる場合は、以下も含まれます。

■ アーカイブファイル（.AHPAX）

■ アーカイブ展開およびコピー機能を実行する BPXBATCH コマンド。

配布にスクリプトファイルが含まれる場合は、以下も含まれます。

■ スクリプトファイル（.SHnnn）

補助データセットが要求されている場合、配布には、補助ファイル

（.CHJOB）のリモート JCL、および必要に応じて補助スクリプトファイル

が含まれます。



配布を転送する方法

以下に示すように、CA Endevor SCM は、C1BMXCOM、C1BMXBD1、C1BMXBDT、

C1BMXLOC、C1BMXFTP、または C1BMXNDM のいずれかのスケルトン JCL メ

ンバを使用して、このジョブステップを ISPF によって要求された配布に

対して作成するか、または SHIPBDT1、SHIPBDT2、SHIPCONN、SHIPLOCL、

SHIPNVFT、または SHIPXCOM のいずれかの JCL/Proclib メンバを使用して、

API によって要求された配布用に作成します。



前述のとおり、XCOM （C1BMXCOM）、BDT バージョン 2 （C1BMXBDT）、

および CONNECT:Direct （C1BMXNDM）がこのステップで実行されます。転

送プログラムは、以下のステップを実行します。

1. 制御カード（ステップ 1 で生成）を読み取ります。

2. スクリプトファイルがある場合、それらがステージングされ、「配布

先のシンボル」が解決されます。

3. ホストステージングデータセットを、リモートステージングデータ

セットを作成するリモートサイトに転送します。

4. スケルトン JCL （BDT および CONNECT:Direct）またはモデル転送制御メ

ンバ（XCOM）が自動的に実行されるように設定されている場合、リモー

トコピー/削除 JCL （.AxJOB）を実行します。

NJE/NJI を使用する BDT （C1BMXBD1）および NetView FTP （C1BMXFTP）は、

ステップ 1 で作成されたセカンダリジョブストリームで実行されます。

このステップは、ジョブストリームの内部読み取りプログラムへの書き

込みで構成されています。セカンダリジョブストリームの最初のステッ

プでは、前述の機能と同じ機能を実行します。

ローカル転送（C1BMXLOC）は、物理的な転送を実行しません。モデル転

送制御メンバが自動的に実行されるように設定されている場合は、実行の

ためにコピー/削除 JCL がサブミットされます。

転送を確認する方法

以下に示すように、CA Endevor SCM は、スケルトン JCL メンバ C1BMXHCN

および C1BMXLIB を使用して ISPF 転送用にこのジョブステップを作成す

るか、または JCL/Proclib メンバ SHIPHCN を使用して API 配布用に作成しま

す。

前述のとおり、このステップ中に、配布ユーティリティはリモートサイ

トへの転送の確認を記録します。

注：配布の完了をユーザに通知するために、通知ユーティリティと共に使

用できる確認後 EXIT があります。

リモートコピー/削除ジョブステップの動作


ステージングデータセットの削除方法

以下に示されているように、CA Endevor SCM は C1BMXEND スケルトン JCL

を使用してこのジョブステップを構築します。

前の図に示されているように、ホストステージングデータセット名の

［ディスポジション］フィールドに値「DELETE」がある場合、配布ユーティ

リティはホストステージングデータセットを削除します。


リモート JCL は、サフィックス .AHJOB 付きのデータセットで転送されま

す。配布に補助データセットが含まれている場合、これらのデータセッ

トのリモート JCL には、サフィックス .CHJOB が付いています。リモート

JCL は、以下のジョブステップで構成されています。

1. #RJNDVRB （存在する場合）からの配布「前」スクリプトファイルス

テップの実行。

2. IEBCOPY を使用した、ステージングデータセットから本番稼働用デー

タセットへのパッケージ出力のコピー。

3. パッケージに USS オブジェクトが含まれている場合は、追加のステッ

プ（BPXBATCH）によってコマンドストリーム（ARUCD）を起動し、ス

テージングディレクトリに USS オブジェクトをアーカイブ展開し、各

ファイルを最終ロケーションにコピーします。

注：作成された実際の構文は、各ファイルに対してコピー（cp）を実

行する前に、各出力に対して削除（rm）を実行します。これにより、

リモートファイルの日付およびタイムスタンプが、対応するホストシ

ステムの生成（移動）時間と一致することが保証されます。

4. パッケージの実行またはバックアウト中に、ホストでも削除されたメ

ンバの本番稼働用データセットまたはパスからの削除。

5. #RJNDVRA （存在する場合）からの配布「後」スクリプトファイルス

テップの実行。

6. コピー/削除手順の確認。



7. （オプション）ステージングおよび相互参照データセットの削除。こ

のステップは、配布に使用される配布先レコードで、ステージング

データセットのディスポジションが削除された場合にのみ含まれま

す。

例：リモート JCL の使用

以下に、リモート JCL のサンプルを示します。

//JOBNAME JOB (ACCOUNT),'NAME'

//*

//* *------------------------* ISPSLIB(C1BMXCOP)

//* * REMOTE SITE JOBSTEP TO COPY MEMBERS WHICH WERE

//* * MODIFIED BY THE EXECUTION OF THE PACKAGE

//* *---------------------------------*

//COPY EXEC PGM=IEBCOPY

//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(5,5))

//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(5,5))


//IAR001 DD DISP=SHR,DSN=TSOUSER.NDVR.D11119.T123747.DESTNDM.AR001

//OAR001 DD DISP=OLD,DSN=TEST.IMRENV1.SRCOUT1


//OAR002 DD DISP=OLD,DSN=TEST.IMRENV1.OBJLIB1


//OAR003 DD DISP=OLD,DSN=TEST.UTILS1.LISTINGS

//SYSIN DD *

COPY OUTDD=OAR002,INDD=((IAR002,R))



//* *------------------------* ISPSLIB(C1BMXDEL)

//* * REMOTE SITE JOBSTEP TO DELETE MEMBERS WHICH

//* * WERE DELETED BY THE EXECUTION OF THE PACKAGE

//* *---------------------------------*

//DELETE EXEC PGM=IDCAMS


//SYSIN DD *

DELETE 'TSOUSER.NDVR.D11119.T123747.DESTNDM.AR002' NONVSAM



DELETE 'TSOUSER.NDVR.D11119.T123747.DESTNDM.ARJOB' NONVSAM

DELETE 'TSOUSER.NDVR.D11119.T123747.DESTNDM.ARREF' NONVSAM

//CONFCOPY EXEC PGM=IEBGENER EXECUTED AT THE REMOTE SITE

//SYSUT1 DD DATA,DLM=$$ JOB SHIPPED BACK TO HOST



//TSOUSERP JOB (1111),'WESTBORO',CLASS=A,

// MSGCLASS=X,NOTIFY=TSOUSER

/*ROUTE PRINT U101

/*ROUTE XEQ HOSTNODE

//CONFCOPY EXEC PGM=NDVRC1,

// PARM='C1BMX000,19911119,12374712,CONF,RCPY,EX,****,DESTNDM '

//*

//* *----------------------* ISPSLIB(C1BMXLIB) *

//*

//* *================================================================*

//* * STEPLIB, CONLIB, MESSAGE LOG AND ABEND

DATASETS

//* *================================================================*

//*

//STEPLIB DD DISP=SHR,DSN=iprfx.iqual.CSIQAUTH

//CONLIB DD DSN=TEST.NDVR36B.ZAPLOAD,DISP=SHR

// DD DSN=TEST.C19109.CONLIB,DISP=SHR

//*

//SYSABEND DD SYSOUT=*

//C1BMXLOG DD SYSOUT=* *** MESSAGES, ERRORS, RETURN CODES ********

//* *----------------------* C1BMXRCN (CONT.) *

$$

//SYSUT2 DD SYSOUT=(A,INTRDR)


//SYSIN DD DUMMY

//*

//CONFABND EXEC PGM=IEBGENER,COND=ONLY EXECUTED AT THE REMOTE SITE


//TSOUSERP JOB (1111),'WESTBORO',CLASS=A,

// MSGCLASS=X,NOTIFY=TSOUSER

/*ROUTE PRINT U101

/*ROUTE XEQ HOSTNODE


// PARM='C1BMX000,19911119,12374712,CONF,RCPY,AB,****,DESTNDM '

//*

//* *----------------------* ISPSLIB(C1BMXLIB) *

//*

配布を作成、追跡、確認する方法


//* *================================================================*

//* * STEPLIB, CONLIB, MESSAGE LOG AND ABEND DATASETS

//* *================================================================*

//*

//STEPLIB DD DISP=SHR,DSN=iprfx.iqual.CSIQAUTH

//CONLIB DD DSN=TEST.NDVR36B.ZAPLOAD,DISP=SHR

// DD DSN=TEST.C19109.CONLIB,DISP=SHR

//*

//SYSABEND DD SYSOUT=*

//C1BMXLOG DD SYSOUT=* *** MESSAGES, ERRORS, RETURN CODES ********

//* *----------------------* C1BMXRCN (CONT.) *

$$

//SYSUT2 DD SYSOUT=(A,INTRDR)


//SYSIN DD DUMMY

//* **** END OF JCL STREAM ****


パッケージを配布する最初のステップは、配布リクエストを作成すること

です。前景またはバッチのいずれかで配布リクエストを作成できます。こ

のセクションでは、前景で配布を作成する方法について説明します。

注：バッチでパッケージ配布リクエストをコード化する方法の詳細につ

いては、「パッケージ配布 SCL」を参照してください。

配布を作成した後に ENTER キーを押すと、CA Endevor SCM はリクエスト

キューに配布を配置します。以下の操作を実行できます。

■ キューの表示、リセット（すべての配布リクエストの削除）、または

サブミット。

■ キューのサブミットによる、キュー内のパッケージの配布。



パッケージ配布パネルから前景で配布リクエストを作成します。パッ

ケージ配布パネルにアクセスするには、パッケージオプションメニュー

のオプションフィールドに 6 （配布）を入力し、ENTER キーを押します。

CA Endevor SCM に、パッケージ配布パネルが表示されます。パッケージ

配布パネルで適切な情報を入力して 1 （配布リクエストの作成）を入力し、

ENTER キーを押します。 CA Endevor SCM に、パッケージの選択リストおよ

び配布先の選択リスト、またはそのいずれかが表示され、次に配布確定パ

ネルが表示されます。配布確定パネルから配置キューに配布を配置しま

す。

後続の手順では、以下を配布するリクエストを作成する方法について説明

します。

■ 1 つの配布先に 1 つのパッケージ

■ 複数の配布先に 1 つのパッケージ

■ 1 つの配布先に複数のパッケージ

1 つのパッケージの 1 つの配布先への配布

1 つのパッケージの 1 つの配布先への配布方法

1. すべての必須情報および希望する任意のオプション情報に加えて、

パッケージ配布パネルの［オプション］フィールドに「1」と入力しま

す。 ENTER キーを押します。

2. 配布の確認パネルが表示されたら、ステップ 3 に進みます。それ以外

の場合は、表示される選択リストからパッケージおよび（または）配

布先を選択します。

最後の選択リストで ENTER キーを押すと、配布の確認パネルが表示さ

れます。

3. この配布の確認パネルで情報を確認し、次に以下の操作を行います。

■ END キーを押して、前のパネルに戻ります。または、

■ 「SH」と入力し、ENTER キーを押して、配布リクエストをリクエ

ストキューに格納します。

注：詳細については、「配布するパッケージの確認 (P. 185)」を参照し

てください。

4. 次のアクションを実行するために必要なパネルに戻るまで、END キー

を押します。



1 つのパッケージの複数の配布先への配布

1 つのパッケージの複数の配布先への配布方法

1. すべての必須情報および希望する任意の情報に加えて、パッケージ配

布パネルの［オプション］フィールドに「1」と入力し、ENTER キーを

押します。



布先を選択します。最後の選択リストで ENTER キーを押すと、配布の

確認パネルが表示されます。

3. 配布の確認パネルで情報を確認してから「SH」と入力し、ENTER キー

を押して配布リクエストをリクエストキューに格納します。 ENTER

キーを押すと、［配布先］フィールドに選択した次の配布先が表示さ

れます。


てください。

4. ENTER キーを押して、配布先選択リストが表示されるまで、ステップ 3

を繰り返します。これは、すべての選択された配布先用の配布を配布

キューに配置したことを示します。

5. これで、以下が可能になりました。

■ 別の配布先を選択してから、ENTER キーを押して、配布先の確認パ

ネルを表示します。ステップ 3 から次へ進みます。

■ 次のアクションを実行するために必要なパネルに戻るまで、END




複数のパッケージの 1 つの配布先への配布

複数のパッケージの 1 つの配布先への配布方法

1. すべての必須情報および希望する任意のオプション情報に加えて、

パッケージ配布パネルの［オプション］フィールドで「1」と入力し、

ENTER キーを押します。



布先を選択します。

最後の選択リストで ENTER キーを押すと、配布の確認パネルが表示さ

れます。

3. 配布の確認パネルで情報を確認してから「SH」と入力し、ENTER キー

を押して配布リクエストをリクエストキューに格納し、配布先選択リ

ストに戻ります。最初に選択されたパッケージの名前が、このパネル

の［WHICH］フィールドに表示されます。


てください。

4. 配布先選択リストで END キーを押して、2 番目の選択されたパッケー

ジを表示します。次に、このパッケージの配布先を選択し、ENTER キー

を押して、配布の確認パネルを表示します。ステップ 3 を繰り返しま

す。

5. パッケージ選択リストかパッケージ配布パネルのいずれかが表示され

るまで、END キーを押して、ステップ 3 および 4 を繰り返します。こ

れは、すべての選択されたパッケージ用の配布を配布キューに配置し

たことを示します。

6. これで、以下が可能になりました。

■ 配布の作成を続行します。

■ 次のアクションを実行するために必要なパネルに戻るまで、END




パッケージ配布パネル

パッケージ配布リクエストを作成する場合、以下の情報を提供できます。

パッケージ ID

必須。配布するパッケージの名前（1 ～ 16 文字）。

配布先

必須。パッケージ（またはバックアウト）を受信する配布先の 1 ～ 7 文

字の名前。

パッケージ/バックアウト

デフォルトは P、パッケージです。パッケージ出力またはバックアウ

トメンバを配布するかどうかを示します。指定可能な値は以下のとお

りです。

P - パッケージ出力を配布します。

B - バックアウトメンバを配布します。

ステータス日付範囲

任意選択。配布ステータスリストでカバーされる日付範囲を指定でき

ます。日付形式は mmddyy です。

ステータスソート順序（必須）

配布ステータスリストは、配布日、配布先 ID、およびパッケージ ID で

ソートできます。これらのソートが実行される順序を指定する必要が

あります。指定可能な値は以下のとおりです。

1 - このソートを最初に実行。

2 - このソートを 2 番目に実行。

3 - このソートを最後に実行。



パッケージ選択リスト

このパネルによって、配布（S）するパッケージの選択および選択前のパッ

ケージの表示（D）を行うことができます。各パッケージについて、パネ

ルに以下の情報が表示されます。

パッケージ

16 文字以内のパッケージ ID

ステータス

パッケージのステータス。パッケージを配布するために、このステー

タスを実行する必要があります。

記述

40 文字以内のパッケージの記述。



配布先選択リスト

このパネルによって、パッケージの配布先を選択（S）できます。配布さ

れるパッケージは、［S - SELECT DESTINATION TO RECEIVE:］フィールドに表

示されます。各配布先について、パネルに以下の情報が表示されます。

DEST-ID

配布先名を識別します。

MESSAGE

配布先に対して何らかのアクション（たとえば、*MODIFIED、*DELETED

など）が実行されたことを示すリテラルまたはメッセージ ID を識別し

ます。

TRAN-METHOD

この配布先に対して使用されるデータ転送ユーティリティを識別しま

す。

RMT-NODENAME

配布先のデータ転送ユーティリティノード名を識別します。

DESCRIPTION

配布先の記述です。

REMOTE-IPNAME

パッケージ出力の配布先のサイトを識別します。

IPPORT

ターゲットサーバの XCOM SERVPORT 指定を識別します。

注：配布先に対してリモート IPNAME が指定される場合、右側にスクロー

ルして、REMOTE IPNAME および IPPORT を表示できます。 ESORT は、すべ

ての列見出しに対してサポートされています。

このパネルから END キーを押して、以下のアクションを実行します。

■ 複数のパッケージが選択されていて、一部が配布キューにない場合は、

［S - SELECT DESTINATION TO RECEIVE:］フィールドに選択された次の

パッケージが表示されます。

■ 選択されているパッケージがもうない場合は、パッケージ選択リスト

またはパッケージ配布パネルに戻ります。



配布するパッケージの確認

配布キューにパッケージを配置するには、ユーザは、配布の確認パネルで

配布を確認する必要があります。このパネルは、パッケージと配布先の各

ペアに対して表示されます。このパネルによって、パッケージと配布先

のペアを配布キューに配置する前に、出力（パッケージまたはバックアウ

ト）の選択、および XCOM または CONNECT:DIRECT 転送法の配布コマンド

ファイルプレフィクスを確認し変更できます。

配布するパッケージの確認方法

1. 必要に応じて、配布の確認パネルで配布情報を確認し、以下のフィー

ルドで値を変更します。

注：パッケージをすぐに配布キューに配置しない場合は、END キーを

押して、直前のパネルに戻ります。

■ PKG/BACKOUT - このフィールドによって、配布を配布キューに配

置する前に、配布の内容を変更できます。有効な値は以下のとお

りです。

– PACKAGE - 配布にパッケージ出力が含まれます。

– BACKOUT - 配布にパッケージバックアウトメンバが含まれま

す。



■ SHIPMENT COMMAND FILE PREFIX - このフィールドは、XCOM また

は CONNECT:DIRECT 転送方法で使用されるデータセット名プレ

フィクスを指定します。選択された転送方法が XCOM でも

CONNECT:DIRECT でもない場合、このフィールドは無視されます。

C1DEFLTS テーブルで MODHLI パラメータ値がコーディングされて

いる場合、セッション中にこのパネルが初めて表示される際に、

その値がこのフィールドに表示されます。 MODHLI パラメータ値が

ブランクの場合、TSO ユーザ ID 値がこのフィールドに表示されま

す。このフィールドをクリアすると、MODHLI または TSO ユーザ ID

が、その順番で、データセット名プレフィクスとして使用されま

す。

［パッケージオプション］から他へ移動するまで、次回このパネ

ルが表示される際に、使用された値がこのフィールドに表示され

ます。次回［パッケージオプション］が選択されると、最初のデ

フォルト値が設定されます。

2. ［オプション］フィールドで「SH」と入力してから、Enter キーを押し

ます。

以下のいずれかが発生すると、パネルに表示された配布は配布キュー

に配置されます。

■ このパッケージに対して複数の配布先を選択し、パッケージと配

布先のペアの一部が配布キューに配置されていない場合、次に選

択された配布先が［配布先］フィールドに表示されます。

■ 複数のパッケージを選択し、パッケージの一部が配布キューに配

置されていない場合、配布先選択パネルが表示されます。

配布先の追跡および確認

配布ステージングユーティリティがすべてのホストステージングデータ

セットの作成を完了すると、配布のレコードが作成されます。その際に、

パッケージと配布先は、配布ステージングリターンコードと共に記録さ

れます。これらは、パッケージ配布パネルでオプション 5 ［配布ステータ

スの表示］を使用して表示できます。

配布プロセスの他の 2 つのポイントが追跡されます。これは、データ伝送

ユーティリティの実行およびリモート COPY/DELETE/CONFIRM ジョブの実

行です。これらのポイントは、データ伝送ユーティリティ（ホストサイ

トでの）の実行、および IEBCOPY/IDCAMS ジョブ（リモートサイトでの）

の実行の後に、条件付きジョブステップとして配布確認ユーティリティ

を実行することで追跡されます。



確認手順

ISPF によって開始された配布に対して、配布の確認を処理する 2 つの ISPF

スケルトン JCL メンバがあります。 C1BMXHCN は、ホストサイトで実行す

るデータ転送ジョブステップの確認を処理します。 C1BMXRCN は、リモー

トサイトで実行する IEBCOPY/IDCAMS ジョブの確認を処理します。また、

API 配布（SHIPHCN および SHIPRCN）の確認を実行するために呼び出され

る、JCL/PROCLIB メンバの対応するペアもあります。未変更のままにする

と、これらのステップでは、データ転送またはコピー/削除の汎用レコー

ドが残ります。配布のレコードは、パッケージ配布ステータスパネルの

「HOST TRANS」列または「REMOTE MOVE」列に EXEC'D または ABEND のい

ずれかでマークされます。

これらのイベントのより正確なレコードが必要な場合、条件付きの確認ス

テップの数を増やし、スクリプトファイル実行ステップのステータスを

返し、配布確認ユーティリティパラメータが別の項目をレポートするよ

うに変更できます。



確認パラメータは、シンボリックプレフィックス（ISPF 機能によって解決）、

ルート、およびシンボリックサフィックス（配布ステージングユーティ

リティによって解決）によって構成されています。

//STEPNAME EXEC PGM=NDVRC1,PARM='&VNBCPARM.,CONF,pppp,op,code,********',

// COND=(see_example)

各項目の説明を以下に示します。

■ pppp - 確認のポイント。これは、以下の値を持つことができる 4 文字

の文字列です

– HXMT - ホスト転送確認。

– RCPY - リモートコピー/削除確認。

– SCRP - リモートスクリプト確認

■ op - 確認中のステップのリターンコードに関連付けられている代数演

算子。有効な演算子は、以下のとおりです。

– EQ - 等しい。

– GE - 以上。

– LE - 以下。

– GT - より大きい。

– LT - より小さい。

また、2 つの汎用の非代数演算子があります。

– EX - 実行されたジョブ（リターンコードは使用不可）。

– AB - 異常終了したジョブ（異常終了コードは使用不可）。

■ code - レポートされるコード。通常、確認されるステップとの関係を

持つ 4 桁の数になります。



例： C1BMXHCN をレコード固有のコードに変更

次のリターンコードをレポートするように C1BMXHCN を変更する方法の

サンプルを以下に示します： RC=00、RC=04、RC=08、RC>=12、ABEND。

//CONFGE12 EXEC PGM=NDVRC1,REGION=4096K,COND=(12,GT,&VNBXSTP),

// PARM='&VNBCPARM,CONF,HXMT,GE,0012,********'

//C1BMXDTM DD DSN=&&&&XDTM,DISP=(MOD,PASS),SPACE=(TRK,(1,0)),

// DCB=(RECFM=F,LRECL=80,BLKSIZE=3120,DSORG=PS),

// UNIT=tdisk

//*

)IM C1BMXLIB OPT

//*

//*

//CONFEQ08 EXEC PGM=NDVRC1,REGION=4096K,COND=(08,NE,&VNBXSTP),

// PARM='&VNBCPARM,CONF,HXMT,EQ,0008,********'



// UNIT=tdisk

//*

)IM C1BMXLIB OPT

//*

//*





// UNIT=tdisk

//*

)IM C1BMXLIB OPT

//*

//*





// UNIT=tdisk

//*

)IM C1BMXLIB OPT

//*

//*

//CONFABND EXEC PGM=NDVRC1,REGION=4096K,COND=ONLY,

// PARM='&VNBCPARM,CONF,HXMT,AB,****,********'



// UNIT=tdisk

//*

)IM C1BMXLIB OPT

//*



例： C1BMXRCN をレコード固有のコードに変更

次のリターンコードをレポートするように C1BMXRCN を変更する方法の

サンプルを以下に示します： RC=00、RC=04、RC=08、RC>=12、ABEND。 COND=

パラメータは、NDVRC1 実行カードではなく、IEBGENER 実行カード上にあ

ることに注意してください。 $DEST_ID は、配布ステージングユーティリ

ティによって解決されます。

//CONFGT12 EXEC PGM=IEBGENER,COND=(12,GT)


)IM C1BMXHJC


// PARM='&VNBCPARM,CONF,RCPY,GE,0012,$DEST_ID'

)IM C1BMXLIB

$$

//SYSUT2 DD SYSOUT=(INTRDR,A)


//SYSIN DD DUMMY

//*

//* *--------------------------------*

//*

//CONFEQ08 EXEC PGM=IEBGENER,COND=(08,NE)


)IM C1BMXHJC


// PARM='&VNBCPARM,CONF,RCPY,EQ,0008,$DEST_ID'

)IM C1BMXLIB

$$



//SYSIN DD DUMMY

//*

//* *--------------------------------*

//*





)IM C1BMXHJC



)IM C1BMXLIB

$$



//SYSIN DD DUMMY

//*

//* *--------------------------------*

//*



)IM C1BMXHJC



)IM C1BMXLIB

$$



//SYSIN DD DUMMY

//*

//* *--------------------------------*

//*

//CONFABND EXEC PGM=IEBGENER,COND=ONLY EXECUTED AT THE REMOTE SITE


)IM C1BMXHJC


// PARM='&VNBCPARM,CONF,RCPY,AB,****,$DEST_ID'

)IM C1BMXLIB

$$



//SYSIN DD DUMMY

注： ISPF インターフェースおよび API インターフェースの両方を使用して

配布を実行する場合は、CSIQOPTN ライブラリのモデルと CSIQJCL ライブラ

リで提供される JCL/PROCLIB の両方を必ずカスタマイズしてください。



リクエストキュー

CA Endevor SCM ストアは、配布リクエストが実行されるまで、それらを

キューに格納します。このキューがアクティブになるのは、現在の CA

Endevor SCM セッションに対してのみです。

CA Endevor SCM は Queued Shipment List にキューを表示します。

以下のアクションを実行できます。

■ パッケージ配布パネルの［オプション］フィールドで「2」と入力し、

ENTER キーを押すことで、Queued Shipment List を表示します。


ENTER キーを押すことで、Queued Shipment List をリセットします。こ

れで、すべての配布がキューから削除されます。


ENTER キーを押すことで、リクエストキューをサブミットします。配

布リクエストをサブミットすると、CA Endevor SCM は自動的にキュー

をリセットします。

配布ステータスの表示

リクエストキューをサブミットした後、CA Endevor SCM は、パッケージ

配布ステータスパネルに配布のステータスを表示します。パッケージ配

布ステータスパネルにアクセスするには、パッケージ配布パネルのオプ

ションフィールドに 5 を入力して ENTER キーを押します。

左/右へのスクロール（PF10/PF11）を使用して利用可能なビューを切り替

え、ローカル（ホスト）配布ステータスまたはリモートコピーのいずれ

か、およびスクリプト実行ステータスを表示します。

注：表示される配布レコードは、配布パネルで指定されたパッケージと配

布先の値に従ってフィルタされます。フィルタを変更するには、PF3 キー

を押してレベルをバックアウトし、値またはマスクを入力します。または、

これらのフィールドを空白のままにして、すべての配布レコードを表示し

ます。



パッケージ配布 SCL

配布パッケージステートメントを使用して、パッケージをリモートサイ

トに配布します。パッケージ出力メンバまたはパッケージバックアウト

メンバを配布できます。 SHIP PACKAGE ステートメントでは、配布するパッ

ケージ、配布先、出力またはバックアウトメンバのどちらを配布するか、

および XCOM または CONNECT:DIRECT 転送方法で使用されるデータセッ

ト名プレフィックスを指定することができます。

このステートメントには以下の構文があります。

►►─ SHIP PACKage ─ package ─ name ─┬─────────────────────────────────────┬─► └─ TO DESTination ─ destination-name ─┘ ┌─ OUTput ──┐ ►─ OPTion ─┤───────────┤───────┬──────────────────┬─── . ────────────────►◄ └─ BACkout ─┘ └─ PREfix ─ prefix ┘

SHIP PACKAGE package-name

配布するパッケージの名前（1 ～ 16 文字）を指定します。

TO DESTINATION destination-name

指定したパッケージを配布するリモートサイトの名前（1 ～ 8 文字）

を指定します。配布先の名前は英数字で構成できますが、先頭の文字

は英文字で始まる必要があります。

この情報は必須です。ここに配布先を入力しない場合は、適切な情報

を指定した SET DESTINATION ステートメントを事前にコード化してお

く必要があります。



OPTION OUTPUT/BACKOUT

出力メンバまたはバックアウトメンバのどちらをリモートサイトに

配布するかを指定します。ここでオプションを指定しない場合、シス

テムは SET OPTION ステートメントを探します。 SET OPTION 句が見つ

からない場合は、デフォルトで OPTION OUTPUT が選択され、自動的に

出力メンバがリモートサイトに配布されます。

OUTPUT

パッケージの実行によって作成されたメンバを配布することを指

定します。

BACKOUT

パッケージのバックアウトに必要なメンバを配布することを指定

します。

PREfix prefix

XCOM または CONNECT:DIRECT 転送方法で使用される 1 ～ 8 文字の

データセット名プレフィックスを指定します。選択された転送方

法が XCOM または CONNECT:DIRECT でない場合、このオプションは

無視されます。ピリオドで区切られたノードが 8 文字以内に収ま

る限り、パッケージ配布出力プレフィックスに対して複数のノー

ドを指定できます。



パッケージ配布 SCL の例

パッケージ配布を実行する場合、指定された配布先に送られる指定された

パッケージに対して単一のオプションのみを指定できます。そのため、

以下のリクエストはエラーとして扱われます。

SHIP PACKAGE ABCD TO DESTINATION CHICAGO OPTION OUTPUT.

SHIP PACKAGE ABCD TO DESTINATION CHICAGO OPTION BACKOUT.

ただし、別のパッケージ/配布先の組み合わせには別のオプションを指定

できます。以下のリクエストは有効です。

SHIP PACKAGE ABCD TO DESTINATION CHICAGO OPTION OUTPUT.

SHIP PACKAGE ABCD TO DESTINATION BOSTON OPTION BACKOUT.

モジュールは、2 つの別のパッケージの実行によって影響を受ける場合が

あります。 1 つのパッケージから出力メンバを配布し、同じ配布先に別の

パッケージからバックアウトメンバを配布しようとすると、エラーメッ

セージが表示されます。たとえば、モジュールが PKG01 と PKG02 の実行

によって影響を受けたと仮定します。以下に示すようなリクエストは無

効です。

SHIP PACKAGE PKG01 TO DESTINATION BOSTON OPTION OUTPUT.

SHIP PACKAGE PKG02 TO DESTINATION BOSTON OPTION BACKOUT.

ただし、同じオプションを使用する場合は、同じ配布先に 2 つのパッケー

ジを配布できます。そのため、以下のリクエストはいずれも許可されま

す。



または



注：パッケージ配布ユーティリティのリクエストの順序は重要ではあり

ません。このユーティリティは、パッケージ実行の日付を参照します。



パッケージ配布 SCL の SET ステートメント

SET ステートメントはグローバルなデフォルトステートメントであり、後

続の SHIP ステートメントの値を設定します。パラメータが必要である（ま

たは使用されている）がコード化されてない場合、CA Endevor SCM は前の

SET ステートメントでその情報を探します。

注： SET ステートメントをコード化する場合で、SHIP 句に同様の情報を入

力する場合、SHIP 句の値によって SET ステートメントの値が上書きされま

す。

パッケージ配布ユーティリティでは、以下の 2 つの SET ステートメントを

使用できます。

SET DESTINATION destination-name

SET DESTINATION 句は、配布先を含まない後続の各 SHIP ステートメン

トに適用されます。配布先は必須であるため、TO DESTINATION 句を省

略する場合は、SET ステートメントを（あらかじめ）コード化する必

要があります。

ここで指定した配布先名は、別の SET DESTINATION ステートメントま

たは CLEAR DESTINATION ステートメントが出現するか、処理が終了す

るまで使用されます。

SET OPTION OUTPUT/BACKOUT

SET OPTION 句は、オプションを指定しない後続の各 SHIP ステートメン

トに適用されます。 SET 句に指定するオプションは、別の SET OPTION

ステートメントまたは CLEAR OPTIONS ステートメントが出現するか、

処理が終了するまで使用されます。

ただし、SHIP ステートメントはオプションを必要としないため、このス

テートメントをコード化する必要はありません。その場合、デフォルト

のオプション出力が適用されます。

パッケージ配布の管理


パッケージ配布 SCL の CLEAR ステートメント

CLEAR ステートメントは、SET ステートメントで指定された情報をクリア

します。 CLEAR ステートメントは、適用される SET ステートメントと同じ

構文である必要があり、その SET ステートメントの後に記述する必要があ

ります。 CLEAR ステートメントは、新しく関連する SET ステートメントが

出現するか、処理が終了するまで有効となります。

CLEAR ステートメントは、SET ステートメントにのみ適用されます。SHIP ス

テートメントに入力された同様の情報は、CLEAR ステートメントによる影


パッケージ配布ユーティリティでは、以下の 2 つの CLEAR ステートメント

を使用できます。

CLEAR DESTINATION

CLEAR DESTINATION ステートメントは、前の SET ステートメントで指定

された配布先をクリアします。

CLEAR OPTIONS

CLEAR OPTIONS ステートメントは、前の SET ステートメントで指定さ

れたオプションをクリアします。


CA Endevor SCM 管理者には、パッケージの配布を監視および確認するため

の以下のツールがあります。

■ パッケージ配布レポート

■ パッケージ配布アセンブラレポート

■ 配布ステータスの表示 — パッケージ配布先パネルからアクセスでき

る配布ステータスの表示オプションでは、ステージング、リモートコ

ピー、およびスクリプト実行ステータスを含む配布ステータスを表示

するスクロール可能なリストを表示できます。詳細については、「配

布ステータスの表示 (P. 192)」を参照してください。

■ 配布確認電子メール



パッケージ配布レポート

パッケージ配布ユーティリティは、以下のレポートを作成します。

■ パッケージ配布ログ -- パッケージ配布ログレポートには、配布ステー

ジングプロセスの進捗状況をレポートする、一連の番号付きメッセー

ジが含まれます。

■ パッケージ配布検証 -- パッケージ配布検証レポートは、ステージング

ユーティリティによって入力と解釈された "SHIP" トランザクション

をリスト表示します。構文エラーが検出される場合、トランザクショ

ンの後に番号付きメッセージが表示されます。最終アクション

（"FINISHED" とマークされた）は、処理済みアクションの数、エラー

になったアクションの数、配布予定数を集計します。

■ パッケージ配布アクティビティ -- パッケージ配布アクティビティレ

ポートは、配布用にステージングされたデータセット/メンバをリス

ト表示します。

■ パッケージ配布サマリ -- パッケージ配布サマリレポートは配布先別

に分類され、ステージングリターンコードおよび、各配布先に配布さ

れたパッケージを表示します。

パッケージ配布アクティビティレポート

パッケージ配布アクティビティレポートは、配布用にステージングされ

たデータセット/メンバをリスト表示します。このレポートは、HOST デー

タセット名別に分類されます。

ヘッダ行には、以下の 3 項目の情報が表示されます。

■ SHIPMENT OF MODULES または COMPLEMENTARY FILE。前者はリクエス

トされた配布で、後者は配布のバックアウトです。

■ ホストデータセット名。

■ 配布先。



ヘッダの後に詳細行が続きます。ホストデータセットからヘッダで言及

された配布先に配布される各パッケージで、各メンバにつき 1 つの詳細行

があります。メンバが複数のパッケージにある場合、そのメンバは複数

回リスト表示されます。詳細行にはそれぞれ、以下の情報が含まれます。

Action

配布ユーティリティによるメンバの処理方法を示します。使用できる

値は、COPY、DELETE、および BYPASS です。

COPY

メンバがホストステージングデータセットにコピーされ、配布さ

れることを示します。

DELETE

IDCAMS DELETE コマンドがリモートサイトに配布されることを示

します。

BYPASS

メンバが複数のパッケージにあり、このメンバは配布されないこ

とを示します。

Mbr-Name

HOST データセットメンバの名前。

Option

配布オプションを示します。設定可能な値は OUTPUT または BACKOUT

です。

OUTPUT

配布されているメンバがパッケージ出力の一部であることを示し

ます。

BACKOUT

配布されているメンバがパッケージメンバのバックアウトである

ことを示します。



Package Name

このメンバが参加者であるパッケージの名前。

関連付けられたバックアウトデータおよびパッケージ名

この列には、暗号化されたメンバ名およびそのメンバ名が関連付けら

れるパッケージを含めることができます。暗号化された名前は、実際

のバックアウトまたはバックインメンバを表し、CA Endevor SCM テク

ニカルサポートで使用されます。メンバが暗号化された名前で配布さ

れることはありませんが、MBR-NAME 列にある名前で配布されます。

Comments, Messages, Etc.

その詳細行の警告またはエラーメッセージが含まれています。プレ

フィクスとして、リターンコードが付きます。

RC=04 SUPERCEDED BY <pkg-id>

この詳細行に関連付けられたパッケージメンバは配布されません。

これは、そのメンバが別のパッケージのアプリケーションによっ

て取って代わられたためです。

RC=12 OPTION SWITCH

リクエストされたメンバは配布できません。これは、そのメンバ

がこの配布で 2 つ以上のパッケージに参加し、オプション

"OUTPUT" または "BACKOUT" が同じではないためです。この競合を

解消するには、この配布を複数の配布へ分解します。

RC=12 MEMBER NOT FOUND (ASSOCIATED MEMBER NOT FOUND)

パッケージメンバ（または関連するメンバ）は HOST データセッ

トで見つかりませんでした。恐らく手動で削除されました。パッ

ケージの整合性が失われます。

RC=12 UNEXPECTED FORMAT COMBO (###)

この状況が発生するのは、メンバが複数のパッケージに参加して

いて、階層内のパッケージの 1 つが削除、リセット、または再利

用された場合です。 ### は内部形式コードの 10 進数の表現です。

RC=12 MCF DATA NOT FOUND

このメンバのエレメントの MCF レコードが見つからないか、その

環境へのアクセス権限がユーザにありません。



RC=16 ERROR - FIND MEMBER ROUTINE (###)

配布されるメンバの存在の確認中に、I/O エラーが発生しました。

詳細については、配布ログファイルを確認してください。さらに、

機器またはファイルに問題があるか JES ログを確認してください。

### はリターンコードです。

RC=16 ERROR WRITING TO SYSIN FILE (###)

"SELECT MEMBER" カードの BSTCOPY SYSIN データセットへの書き

込み中に、I/O エラーが発生しました。詳細については、配布ログ

ファイルを確認してください。さらに、機器またはファイルに問

題があるか JES ログを確認してください。 ### はリターンコードで

す。

指定されたデータセットのすべての詳細行に続いて、8 つのトレーラー行

が表示され、これには以下の情報が含まれています。

■ 最初の 2 行には、コピーされたメンバの数および削除されるメンバの

数が表示されます。

■ 次の 4 行には、ホストおよびリモートサイトでの、出力データ間名と

ステージングデータセット名の対応関係が表示されます。このデー

タセットの転送を除外するために DSNAME マッピングルールがセッ

トアップされている場合、"HOST LIBRARY DSN:" 行は "* DATASET

EXCLUDED FROM TRANSMISSION *" とマークされます。

■ 最後の 2 行には、"REMOTE LIBRARY DSN" の生成に使用された DSNAME

マッピングルールが表示されます。空白の場合、ホストデータセッ

ト名がリモートデータセット名として使用されます。



パッケージ配布アセンブラレポート

配布レポートによって、パッケージ配布アクティビティをサマリ形式で確

認できます。 CA Endevor SCM アセンブラレポートを生成するには、

BC1JRPTS ジョブを実行する必要があります。レポートのリクエストの詳細

情報については、「Reports Guide」を参照してください。

注：配布レポートとフットプリントレポートは相互排他的です。両方のタ

イプのレポートが必要な場合は、同じジョブ内で、2 つの個別のジョブま

たは 2 つの個別のジョブステップをサブミットする必要があります。

以下の配布レポートをリクエストできます。

■ CONRPT73 -- 配布詳細レポート

■ CONRPT74 -- パッケージ ID 別パッケージ配布レポート

■ CONRPT75 -- 配布先別パッケージ配布レポート

■ CONRPT76 -- 配布別パッケージ配布レポート

配布確認電子メール通知

この配布確認電子メール通知機能によって、電子メールが作成され、配布

リクエストを開始したユーザへ送信されます。ホスト確認およびリモー

ト確認が発生する場合、配布プロセス中に電子メールが送信されます。配

布が複数の配布先に送信される場合、パッケージと配布先の各組み合わせ

に対して個別の電子メールが送信されます。電子メールに含まれる情報

は、パッケージ配布ステータスパネルを表示すると表示されるデータと

同じです。

起動されたのが CA CM Enterprise Workbench か API プログラムか CA

Endevor SCM オンライン配布アクションかに関わらず、配布確認電子メー

ル通知機能は任意の配布リクエストに対して有効です。

この機能は、既存の電子メール通知機能を使用して実装されます。電子

メール通知機能の通知機能テーブル（ESMTPTBL）は、オーバーライドサ

インアウト通知やパッケージ承認通知などの他の機能と共有されます。

ただし、オプション機能テーブル、ENCOPTBL で SUPPRESS_SHIPCONF_EMAIL

オプションを有効にすることで、配布確認機能を無効にできます。

注：電子メール通知機能の詳細については、「管理ガイド」の付録「電子

メール通知の使用」を参照してください。


第 6 章： Web サービス


Web サービスを有効にする方法 (P. 204)

Web サービス用に CA Endevor SCM を構成する方法 (P. 210)

Web サービス用に STC 定義を有効化する方法 (P. 222)

Web サービスへのセキュリティアクセスを有効にする方法 (P. 229)

Web サービスを構成および展開する方法 (P. 237)

Web サービスの既存の展開を更新する方法 (P. 251)

Tomcat の新しいリリースで Web サービスを実行する方法 (P. 252)

データソースへのアクセスの仕組み (P. 253)

設定ファイルを作成する方法 (P. 254)

データソース設定の内容を表示する方法 (P. 266)

STC プーリングを有効にする方法 (P. 267)

ユーザ作成のクライアントプログラム (P. 269)

Web サービスを有効にする方法



変更マネージャ（CA Endevor SCM 管理者）は、Web サービスコンポーネ

ントを有効にすることができます。このコンポーネントは、Eclipse ベー

スの UI の前提条件です。また、Web サービスを使用して、ユーザ作成の

プログラムを CA Endevor SCM API に接続できます。

Web サービスを有効にするプロセスは、ほかのロールのサポートを必要と

する複雑なプロセスです。以下の図は、Web サービスを有効にするため

のマスタシナリオにおける各ロールの責任（シナリオ）を示しています。



Web サービスを有効にするには、以下の各ロールでシナリオを実行します。

注：すべてのロールにおいて、それぞれのシナリオを試行する前に前提条

件のトピックを確認する必要があります。

1. CA Endevor SCM 管理者 - 「Web サービス用に CA Endevor SCM を構成す

る方法 (P. 210)」。

2. CA Common Services CAICCI 管理者 - 「Web サービス用に STC 定義を有効

化する方法 (P. 222)」。

3. セキュリティ管理者 - 「Web サービスへのセキュリティアクセスを有

効にする方法 (P. 230)」。

4. Web アプリケーション管理者 - 「Web サービスを構成および展開する

方法 (P. 237)」。

注：これらの手順を実行すると、Web サービスで Eclipse プラグインを使用

するための設定が完了します。クライアントスタブの詳細については、

「ユーザ作成のクライアントプログラム (P. 269)」を参照してください。


Web サービスを有効にする前に、Web サービスがどのように動作するか

について理解してください。また、Web サービスを展開する前に、必要

なソフトウェアおよびセットアップを確認してください。以下のトピッ

クを確認してください。

■ Web サービス (P. 206)

■ クライアントプログラムが API にアクセスする方法 (P. 206)

■ Web サービスのソフトウェア要件 (P. 209)



Web サービス

CA Endevor SCM Web サービスコンポーネントは、クライアントアプリ

ケーションが CA Endevor SCM API と通信できるようにします。 Web サービ

スアプリケーションは、z/OS USS 環境の HTTP アプリケーションサーバ

（Tomcat）で実行され、Axis2 を使用して SOAP メッセージを処理します。

Web サービスは、AXIS2 環境の HTTP Web サーバで展開される AXIS2 アーカ

イブファイル（EndevorServices.aar）としてパッケージ化されます。

Eclipse ベースの UI およびユーザ作成のプログラムは、Web サービスを使

用してソフトウェア制御言語（SCL）ステートメント（一部制限あり）を CA

Endevor SCM API に送信します。 Web サービスでは、エレメント、パッケー

ジ、タイプ、プロセッサなどの CA Endevor SCM の抽象概念に対してアク

ションまたはクエリを実行できます。 submitSCL 操作を使用して、アクショ

ンおよびクエリを実行できます。 get ログイン情報操作は、クエリを実行

するためにのみ使用できます。クエリは、カンマ区切り値（CSV）形式

（submitSCL 操作を使用）、または XML 形式（Get ログイン情報を使用）

で、Web サービスの呼び出し元に情報を返すことができます。

可能なクライアントアプリケーションには、ブラウザ、モバイル、匿名、

または RCP （Rich Client Platform）プログラムがあります。また、クライ

アントプログラムは、一連の新しい Web サービス操作を使用して Endevor

の抽象概念（タイプ、システム、サブシステムなど）にクエリを行い、オ

ブジェクト指向アプローチのためにそのオブジェクト表現を取得できま

す。

クライアントプログラムが API にアクセスする方法

Web サービスは、クライアントアプリケーションを有効にし、SOAP

（Simple Object Access Protocol）を使用して Web サービスと通信する Java2

および Apache AXIS2/JAVA コンポーネントによって構築されたマルチス

レッドアプリケーションです。クライアントと Web サービスは、SOAP

メッセージを使用して通信します。 SOAP メッセージ、要求、および応答

は、クライアントと HTTP Web サーバ間で TCP/IP を使用して送信されます。



以下の図は、クライアント、Web サービス、および CA Endevor SCM API 間

の情報の流れを示しています。

図に示すように、クライアントアプリケーションは、Web サービスを使

用して CA Endevor SCM API にアクセスします。以下に、この処理の詳細を

示します。

■ クライアントアプリケーションは、WSDL （Web Services Description

Language）ファイル内の定義に基づいて SOAP メッセージをフォーマッ

トして HTTP サーバに送信します。要求には、クライアントがアクセ

スする CA Endevor SCM データソースの名前が含まれます。

■ Web サービスは、クライアント呼び出しによって要求されたデータ

ソースの名前と設定ファイルを照合します。 1 つ以上の設定ファイル

が HTTP Web サーバに格納され、CA Endevor SCM API へのアクセスが有

効になります。設定ファイルは、要求を CA Endevor SCM に渡すことが

できる API STC（STC プール）の名前と数を指定します。 CA Common

Services CAICCI 生成機能は、指定された数の API STC を生成します。



Web サービスを有効にして要求を処理し、API と通信するには、CA

Endevor SCM がインストールされている z/OS 環境で、以下のような CA

Common Services コンポーネントが必要です。

– CAICCI は、Web サービスと API 間の通信を可能にする共通の通信ソ

フトウェア層を提供します。

– CAIENF を設定して、CAICCI 生成機能を有効にし、CA Endevor SCM が

Web サービス要求に対して STC プールをスケジュール、実行、お

よび監視できるようにする必要があります。

このプロセスは、以下の標準技術を使用します。

■ XML 言語 – Web サービスコンポーネントによって使用されるデータ

形式。 Web サービスアプリケーション間の通信は、XML 形式で書き

込まれます。

■ SOAP （Simple Object Access Protocol） – アプリケーション間通信のた

めの XML ベースのメッセージングプロトコルおよびエンコード形式。

SOAP メッセージは、アプリケーション間で送信される XML メッセー

ジです。 SOAP メッセージは、SOAP 構造で囲まれた標準の XML 形式で

記述されたテキストファイルです。 SOAP は、XML データを送信およ

び解釈する方法をアプリケーションが理解できるようにします。

■ WSDL （Web Services Description Language） - サービス記述プロトコル

の 1 つ。 Web サービスの WSDL ファイルは、クライアントプログラム

と Web サービス間のインターフェースとして機能する動的な XML

ファイルです。 Web サービスの WSDL ファイルには、クライアントプ

ログラムが利用可能な CA Endevor SCM の操作、およびクライアントと

Web サービスの対話に必要な SOAP プロトコルバインディングとメッ

セージ形式が記述されています。

ユーザ作成のクライアントアプリケーション用の Web サービスを使

用する場合、Web 開発者は、WSDL ファイルからクライアントスタブ

を作成する必要があります。クライアントスタブは、関数呼び出しで

使用されるパラメータの変換、および関数の実行後にサーバから渡さ

れる結果の再変換を行います。クライアントスタブは、Web サービ

ススタブと対話します。詳細については、「ユーザ作成のクライアン

トプログラム (P. 269)」を参照してください。



Web サービスのソフトウェア要件

以下のメインフレームソフトウェアが必要です。

■ CA Endevor SCM バージョン 16.0

■ CA Common Services

■ CA Common Services バージョン 14.0 を使用している場合は、以下

の PTF が適用されていることを確認します。

■ PTF RO50139。この PTF は、CAICCI に影響します。

■ PTF RO47492。この PTF は、VSAM 拡張アドレッシング機能を CA

L-Serv から使用できるようにするために必要です。（この PTF

は、CA Endevor SCM リリース 15.1 にも必要です。 VSAM EA の CA

L-Serv のサポートの詳細については、CA Endevor SCM リリース

15.1 の「リリースノート」を参照してください。）

■ CA Common Services リリース 14.1 を使用している場合は、以下の

PTF が適用されていることを確認します。

■ PTF RO52401。この PTF は、CAICCI に影響します。

■ HTTP およびアプリケーションサーバとして Apache Tomcat 6.0 または

7.0。

CA Common Services for z/OS から Apache Tomcat のサポートされてい

るバージョンをインストールできます。この処理の詳細については、

「CA Common Services for z/OS インストールガイド」を参照してくださ

い。

■ Web サービスエンジンとして Apache Axis2/Java 1.6。

「How to Configure and Deploy Web Services (P. 237)」の手順を実行する

ときに、Axis2/Java をインストールできます。

Web サービス用に CA Endevor SCM を構成する方法



変更マネージャ（CA Endevor SCM 管理者）は、Web サービスコンポーネ

ントをサポートするように CA Endevor SCM を構成できます。このコン

ポーネントは、Eclipse ベースの UI の前提条件です。また、Web サービス

を使用して、ユーザ作成のプログラムを CA Endevor SCM API に接続できま

す。



CA Endevor SCM を構成するには、以下の手順に従います。

1. Web サービス用のデフォルトテーブルを設定します (P. 212)。

2. MODHLI データセットの Web サービスセキュリティ要件を決定しま

す (P. 213)。

3. テキストファイルおよびバイナリファイルのタイプ定義を設定しま

す。「エレメントタイプのサポート (P. 214)」のトピックの情報を確

認します。次に、以下のトピックの説明に従って、サイトに応じて適

切なタイプ定義を定義します。

■ テキストファイル用のエレメントタイプを定義する方法 (P. 216)

■ バイナリファイル用のエレメントタイプを定義する方法

4. （オプション）マスタ制御ファイル（MCF）およびパッケージデータ

セットの使用を最適化するには、IBM VSAM レコードレベル共有（RLS）

のサポートを実装することを強くお勧めします。詳細については、該

当する IBM のドキュメントを参照してください。



Web サービス用のデフォルトテーブルの設定

Web サービスを使用するために CA Endevor SCM を有効にするには、

C1DEFLTS テーブル（デフォルトテーブル）の TYPE=MAIN セクションをカ

スタマイズする必要があります。


1. C1DEFLTS テーブルの TYPE=MAIN セクションで BATCHID パラメータを

1 に設定します。これは、JOBNAME の代わりに JOB ステートメントで

指定した USER パラメータによって、バッチジョブに関連付けられる

CA Endevor SCM ユーザ ID が決定されることを指定します。

2. サイトで RACF PROTECTALL が有効な RACF を使用する場合は、MODHLI

に値を指定します。 RACF PROTECTALL オプションがアクティブになっ

ている RACF で、Eclipse-Based UI、CA CMEW、またはその他のクライア

ントプログラムを使用している場合、MODHLI がコード化されていな

いと、セキュリティ違反が発行されます。これは、Web サービスに必

要な一時ファイルを割り当てるために使用された ID が、ファイルを開

くために使用された ID とは異なっているために発生します。具体的に

は、データセットは、STC プールを生成するための CA Common Services

Common Communications Interface （CAICCI）リクエストで提供されてい

るユーザ ID のコンテキストで割り当てられます。オープンおよび書き

込みリクエストは、Web サービスからリクエストを発行しているクラ

イアントプログラムにサインオンしたユーザ ID のコンテキストで発

行されます。

注： MODHLI はセキュリティに影響します。詳細については、「MODHLI

データセットの Web サービスセキュリティ要件の決定 (P. 213)」を参


3. テーブルをアセンブルおよびリンクエディットします。 C1DEFLTS が

カスタマイズされたら、SMP/E USERMOD を使用して ACCSTABL アセン

ブルおよびリンクエディットできます。また、サンプルの JCL

BC1JTABL を編集し、SMP/E の外部でソースモジュール C1DEFLTS をア

センブルおよびリンクすることもできます。 BC1JTABL は、インストー

ルライブラリ iprfx.iqual.CSIQJCL に提供されています。これによって、

デフォルトテーブルが uprfx.uqual.CSIQAUTU にメンバ C1DEFLTS とし

て保存されます。

注：デフォルトテーブルの編集の詳細については、「CA Endevor Software

Change Manager 管理ガイド」を参照してください。



MODHLI データセットの Web サービスセキュリティ要件の決定

クライアントプログラムから API にアクセスできるようにするには、セ

キュリティ管理者が MODHLI データセットへのユーザアクセスを有効に

しなければならない場合があります。 CA Endevor SCM 管理者は、MODHLI

データセットのセキュリティ要件を決定する必要があります。


1. C1DEFLTS テーブルを表示して、MODHLI 値がテーブルの TYPE=MAIN セ

クションでコード化されているかどうかを確認します。

– MODHLI 値がコード化されている場合は、セキュリティ管理者は、

すべてのユーザ ID に MODHLI 高レベル修飾子（HLQ）を持つすべて

のデータセットへのアクセス権を付与する必要があります。この

要件は、RACF、CA Top Secret、または CA ACF2 を含む、すべてのセ

キュリティ製品でのアクセスに適用されます。

この要件の理由は以下のとおりです。クライアントプログラムが

API にアクセスする場合、ユーザ ID が STC プールを生成するために

CAICCI に送信されます。Web サービスへのリクエストを発行する

ユーザ ID にはこれらのデータセットへの読み取り/書き込みアク

セスが必要です。これを有効にするために、MODHLI パラメータは

以下の形式でデータセット名を作成します。

modhli.Dyyddd.Thhmmss.STCnnnnn.ddname

STCnnnnn、ddname

API に関連する 9 つのファイル（APIMSGS、C1MSGS1 など）の

いずれかに対する一意の修飾子であるジョブ ID および

ddname。

– MODLHI 値がコード化されていない場合、セキュリティは影響を受

けません。これは、一時データセット名が、オペレーティングシ

ステムによって、SYSyyddd.Thhmmss.RA000.jobname.nnnnnn の形式

で標準の一時データセット HLQ で作成されているためです。

2. MODHLI 値が C1DEFLTS でコード化されている場合は、すべてのユーザ

ID に MODHLI 高レベル修飾子（HLQ）を持つすべてのデータセットへ

のアクセス権を付与するようセキュリティ管理者に伝えてください。



エレメントタイプのサポート

クライアントマシンからアクセス可能なファイルを CA Endevor SCM に追

加して、CA Endevor SCM からエレメントを取得できます。 Web サービス

は、SOAP Attachment を使用して、クライアントアプリケーションとの間

でファイルを送受信します。転送されたデータの変換を有効にするには、

管理するデータのタイプごとに CA Endevor SCM のタイプレコードを正し

く定義する必要があります。バイナリファイルとテキストファイルの特

性について、以下に説明します。

テキストファイル

CA Endevor SCM では、テキストファイルは、行区切り文字を持ち、文

字変換が必要なファイルとして定義されます。メインフレーム上にテ

キストファイルを格納し、CA Endevor SCM でそれらを参照できます。

テキストファイルの場合、詳細な変更履歴が保存されます。

CA Endevor SCM でエレメントを参照すると、CA Endevor SCM の

EBCDIC-to-ASCII 変換機能が呼び出されます。EBCDIC-to-local ファイルシ

ステムエンコーディングは使用されません。ただし、CA Endevor SCM

からテキストファイルを取得する際は、Web サービスサーバがメイ

ンフレームから取得した EBCDIC を変換します。



重要：テキストファイルのエレメントタイプを正しく定義するために、

CA Endevor SCM 管理者は Web サービス管理者と連携して作業する必要が

あります。

Web サービス設定ファイルの CodePage Web サービスパラメータは、

メインフレームと Web サービスの文字セットを定義します。設定

ファイルは、Web サービス管理者によってカスタマイズされます。こ

のパラメータの説明を以下に示します。

コードページ

メインフレームのオペレーティングシステムで定義され、CA

Endevor SCM が使用しているコードページを指定します。コード

ページは、メインフレーム上のテキストファイルのコーディング

方法を定義する EBCDIC （Extended Binary Coded Decimal Interchange

Code）の 1 つです。

CodePage パラメータと CharacterSet パラメータにより、Web サー

ビスはクライアントコンピュータと API の間で交換した平文テキ

スト情報を変換できます。平文テキスト情報には、API に送信され

た SCL コマンドおよび API から抽出したレポートと CSV ファイル

があります。

サポートされているエンコーディングについては、http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc

.html を参照してください。

デフォルト： cp01140

注：設定ファイルパラメータの詳細については、「ENDEVOR.cfg の

パラメータ (P. 257)」を参照してください。

バイナリファイル

CA Endevor SCM では、バイナリファイルは、行区切り文字を持たない、

または文字変換が必要ないファイルとして定義されます。バイナリ

ファイルの例として、Microsoft Word 文書や Excel スプレッドシートが

あります。バイナリファイルに名前を付ける場合、通常はロングネー

ムを使用します。 Web サービスを使用して、特定のバージョンのファ

イルを取得できます。 Web サービスを使用すると、ブラウザが認識す

るコンテンツタイプのバイナリファイルを参照できます。バイナリ

ファイルの場合、ログデルタ形式で定義したファイルタイプを除き、

詳細な変更履歴が保存されます。バイナリファイルの詳細については、

「バイナリファイル用のエレメントタイプを定義する方法」を参照し

てください。

http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc.html




テキストファイル用のエレメントタイプを定義する方法

Web サービスで添付ファイルを使用してテキストファイルを転送できる

ようにするには、テキストファイルのタイプ定義を CA Endevor SCM で正

しく設定する必要があります。 CA Endevor SCM では、テキストファイル

は、行区切り文字を持ち、文字変換が必要なファイルとして定義されます。

メインフレーム上にテキストファイルを格納し、CA Endevor SCM でそれ

らを参照できます。テキストタイプを定義するには、以下の手順に従い

ます。

1. CA Endevor SCM ルールを特定のファイルタイプに使用して、ベースお

よびデルタライブラリを定義します。詳細については、「CA Endevor

Software Change Manager 管理ガイド」を参照してください。

2. テキストデータ用の CA Endevor SCM タイプレコードを定義するため

に、タイプ定義パネルのフィールドを以下の値に設定します。

a. デルタストレージ形式を指定するために、FWD/REV/IMG DELTA

フィールドをフォワードの場合は「F」に、リバースの場合は「R」

に設定します。

b. 8 文字未満で大文字のエレメント名に対して COMPRESS

BASE/ENCRYPT NAME フィールドを「N」に設定します。その他の

エレメント名については、このフィールドを「Y」に設定します。

「Y」に設定した場合、ベースライブラリは HFS である必要があり

ます。

c. 比較 FROM フィールドをデータのタイプに適切な値に設定します。

たとえば、COBOL を 7 にすることができます。

d. SOURCE LENGTH および COMPARE TO フィールドをデータのタイプ

に適切な値に設定します。たとえば、COBOL の SOURCE LENGTH を

80 に、COMPARE TO を 72 にすることができます。

e. HFS RECFM フィールドを CRLF に設定します。これは Microsoft

Windows ファイル用の改行文字です。ローカルファイルシステム

サポートを使用してアクセスするテキストタイプに CRLF を指定

しない場合、Windows ベースのエディタで予期しない結果が発生

します。



f. DATA FORMAT フィールドを「T」（テキスト）に設定します。こ

れによって、EBCDIC からローカルファイルシステムエンコーディ

ングへの変換がトリガされます。

g. FILE EXT フィールドを、ファイルタイプをローカルマシン上で使

用するファイル名の拡張子（cob、jcl など）に設定するか、ブラン

クにしておきます。 FILE EXT は、Web サービスを使用してローカル

ディレクトリに対するファイルの追加や取得を行うときに使用し

ます。



バイナリファイル用のエレメントタイプを定義する方法

バイナリファイル（WAR、EAR、JAR DOC、PPT、XLS など）のエレメントタ

イプを定義するには、以下の手順に従います。

1. ベースライブラリの定義 - ベースライブラリは PDS、PDSE、ELIB、CA

Panvalet、または CA Librarian にすることができます。

2. デルタライブラリの定義 - デルタライブラリは PDS、PDSE、または ELIB

にすることができます。以下のようにデルタライブラリを定義します。

■ デルタ PDS、PDSE、または ELIB レコード形式は、可変長ブロック

であることが必要です。

■ デルタライブラリのレコード長およびタイプ定義ソース長には、

任意の値（259、6024、27984 など）を指定できます。ただし、ソー

ス長の約 2 倍に相当する最大デルタレコードを定義します。 LRECL

値として「27,984」をお勧めします。以下に例を示します。

DCB=(DSORG=PO,RECFM=VB,LRECL=27984,BLKSIZE=0)

3. タイプの定義 - タイプ定義を以下の値に設定して、バイナリエレメン

トデータの CA Endevor SCM タイプレコードを定義します。

■ FWD/REV/IMG/LOG DELTA フィールドを以下のいずれかの形式に設

定します。

– I - イメージデルタ形式。イメージデルタ形式は、ファイルの

フルイメージを格納します。この形式により、比較ロジック

が抑制されます。更新を行うたびに、ファイル全体が新しいレ

ベルとして追加されます。非常に大きなバイナリファイルに高い統合レベルを設定した場合、フルイメージデルタを使用すると、デルタファイルが原因で容量が不足する場合があります。

– L - ログデルタ形式。ログデルタ形式は、エレメントの最後の

レベルのみを格納し、エレメントの完全なイメージとしてそれ

を格納します。デルタファイルに含まれるのは、レベル別変

更アクティビティ情報のみです。レベル別ソース変更は維持されません。従って、前のソースレベルを表示できず、ソース変更または履歴を表示することもできません。



重要：どちらのデルタ形式を使用するかを決定する前に、両方の利

点および制限を考慮します。イメージデルタ形式は多くの容量を

使用することがありますが、前のレベルが維持されます。一方、

ログデルタ形式は現在のエレメントだけを維持し、前のレベルを

維持しません。デルタ形式の詳細については、「エレメントスト

レージ形式」を参照してください。

■ 比較 FROM フィールドを 1 に設定します。このオプションは、CA

Endevor SCM が変更されたステートメントを特定するために比較

を開始する各ステートメント内の位置を指定します（1 ～ 32,000

の 5 桁）。

■ SOURCE LENGTH フィールドを 13992 に設定します。このオプショ

ンは、ソースステートメントの論理レコード長を指定します。最

大許容値は 32000 ですが、この値はデルタライブラリ定義の最大

物理レコード長以下である必要があります。

■ 比較 TO フィールドを 13992 に設定します。このオプションは、CA

Endevor SCM が変更されたステートメントを特定するための比較

を終了する各ステートメント内の位置を指定します。

■ 固定長を指定するために HFS RECFM フィールドを F に設定します。

このオプションは、HFS ファイルで使用されるレコード区切り文字

を指定します。レコード区切り文字は HFS ファイルの性質上必要

です。 HFS ファイルには 1 つの大きなデータストリームが含まれ

ます。そのため、区切り文字はそのデータストリーム内の個々の

レコードを識別するために使用されます。これは、Data

Format=Text として定義されているタイプに関連付けられたエレメ

ントが、CA Endevor SCM と Web サービスの間で転送される場合に

も当てはまります。 Web サービスは、交換されたレコード用の区

切り文字を認識し追加します。

■ DATA FORMAT フィールドを B （バイナリ）に設定します。ブラン

クのままにすると、値はデフォルトで B に設定されます。このオ

プションは、圧縮を非アクティブにし、テキスト文字変換が実行

されないようにします。

■ FILE EXT フィールドを有効なファイル拡張子（doc、ppt、xls、jar、

ear など）に設定するか、ブランクのままにします。ファイル拡張

子には、CA CMEW、Eclipse ベースの UI、またはユーザ作成の Web

サービスクライアントプログラムを使用してローカルディレク

トリに対するファイルの追加や取得を行うときのファイルタイプ




■ COMPRESS BASE/ENCRYPT NAME フィールドを Y または N に設定し

ます。このオプションは、リバースデルタ形式で格納されている

エレメントのベースフォームを暗号化および圧縮するかどうかを

指定します。

zFS リニアデータセットのサイズを変更する方法

Web サービスは、リニアな VSAM ファイル（iprfx.iqual.CSIQUSSM）として

インストールされます。これには、Z/OS UNIX ファイルシステムのユーザ

定義のマウントポイントにマウントされるファイルシステムが含まれま

す。

ユーザに対してエラーメッセージ「EDC5133I No space left on device」が表

示される場合があります。これは z/OS UNIX ファイルシステムに空きス

ペースがないことを示しています。 Web サービス管理者は、ファイルシ

ステムに追加スペースを割り当てることができます。

サンプルバッチ JCL ジョブの WSZFSRSZ は、iprfx.iqual.CSIQJCL にあります。

このジョブで実行する内容を要約すると、以下のようになります。

1. ワークファイルを削除する

2. 元の zFS リニアデータセットの詳細をジョブ出力に出力する

3. 元の zFS リニアデータセットを z/OS UNIX ファイルシステムからマウ

ント解除する

4. 新しい zFS リニアデータセットに割り当て値を割り当てる

5. 元の zFS データセットのデータでバックアップデータセットを作成

する

6. 元の zFS リニアデータセットの名前を「zFSFile.OLD」に変更する

7. 新しい zFS リニアデータセットの名前を元の zFS リニアデータセッ

トの名前に変更する

8. バックアップデータセットからサイズを変更した zFS リニアデータ

セットにデータをリストアする



9. サイズを変更した zFS リニアデータセットの詳細をジョブ出力に出

力する

10. サイズを変更した zFS リニアデータセットを z/OS UNIX ファイルシス

テムにマウントする

バッチ JCL ジョブ（WSZFSRSZ）の実行が成功したら、ジョブ出力を表示す

るか、または VSAM 属性を表示して、データセットのサイズが正しく変更

されたことを確認できます。

Web サービス用に STC 定義を有効化する方法



CA Common Services 管理者は、CA Endevor SCM 用の Web サービスをサポー

トするように CA Common Services コンポーネントを構成することができ

ます。 Web サービスは、Eclipse ベースの UI やユーザ作成のプログラムか

ら CA Endevor SCM API に接続するための前提条件です。 CA Endevor SCM と

Web サービスの間の通信を有効にするには、特定の CA Common Services コ

ンポーネントをインストールし設定する必要があります。

以下の図は、Web サービス用の STC 定義を有効にする方法を示しています。



Web サービス用の STC 定義を有効にするには、以下の手順に従います。

1. 前提条件を確認 (P. 205)して、Web サービスがどのように動作するか

について理解します。

2. メインフレームに CA Common Services コンポーネントの CAIRIM、

CAIENF、および CAICCI がインストールされていて、実行中であること

を確認 (P. 223)します。ユーザのサイトが CAIENF r12 以降を実行して

いる場合、データベースは Web サービスに必要ではありません。

3. CAICCI 生成機能を変更して、Web サービス用のスターティッドタスク

を定義します。 (P. 224)

4. CA Endevor SCM がインストールされている場所の SYSID を検索します

(P. 227)。

5. 設定値を記録 (P. 228)し、Web サービス管理者にこの情報を伝えます。

6. 必要に応じて、ユーザのシステムに対して IPL を実行します。これが

CAICCI コンポーネントの最初のインストールである場合、インストー

ル後に、システムに対して IPL を実行する必要はありません。これが 2

回目以降のインストールである場合、システムに対して IPL を実行す

る必要がある場合があります。詳細については、「CA Common Services

for z/OS インストールガイド」を参照してください。

CA Common Services コンポーネントが実行中であることの確認

CCS コンポーネントの CAIRIM、CAIENF、CAICCI がメインフレームにインス

トールされていて、実行中である必要があります。それらのコンポーネ

ントがまだインストールおよび実行されていない場合は、「CA Common

Services for z/OS インストールガイド」に記載されている手順に従って、そ

れらのサービスをインストールする必要があります。

CAIENF と CAICCI がインストールされており実行されているかどうか確認する方

法

1. z/OS SDSF （System Display and Search Facility）ステータス表示に移動し、

プレフィクス「ENF*」を入力します。

■ システム上にアクティブな ENF* がない場合は、システムプログラ

マに連絡して、それを起動してもらってください。

■ ENF ジョブが実行されている場合は、手順 2 に進みます。



2. ENF ジョブを選択し、ジョブ内で CAICCI を検索（Find）します。

– CAICCI が見つかる場合、CAIENF と CAICCI は実行されています。 CCS

コンポーネントが実行されていることを確認しました。「Web サー

ビス用のスターティッドタスクを有効にする方法」の手順に進み

ます。

– CAICCI が見つからない場合は、手順 3 に進みます。

3. サイトの CAI.CAIPROC ライブラリを確認し、サイトで CAICCI を実行す

るために ENF メンバが変更されているかどうかを確認します。

■ ENF メンバが存在する場合は、ENF プロシージャのカスタマイ

ズタスクに進み、メンバを起動します。

■ ENF メンバが存在しない場合は、ローカルシステムのサポート

担当者に連絡してシステムの CAIRIM、CAIENF、および CAICCI の

ステータスを確認し、担当者のサポート下で次のセクションの

タスクを完了させます。

Web サービス用のスターティッドタスクの定義

Web サービスは、CAICCI 生成機能によって開始されるスターティッドタ

スクを使用して CA Endevor SCM API と通信します。生成パラメータの DD

ステートメント（ndvspawn）を CAICCI サービスの ENF プロシージャに追

加して、これらのタスクを生成機能に定義します。 ndvspawn DD ステー

トメントは、CA Endevor SCM API のスターティッドタスク JCL の名前

（CSIQJCL の WSEWSSTC に基づく）を指定します。 CA Endevor SCM データ

セットのハイレベルおよびセカンドレベル修飾子を指定するには、

WSEWSSTC プロシージャ JCL を編集する必要があります。 WSEWSSTC のコ

ピーはスターティッドタスクとして開始されます。




1. Web サービスの生成パラメータファイル名を ENF PROC JCL の

SPNPARMS DD に追加して、ENF プロシージャをカスタマイズします。

ENF プロシージャは、最初の CAI.CAIPROC ライブラリ内にあります。た

だし、システム管理者がプロシージャをシステム PROCLIB にコピーし

ている場合があります。以下の JCL は、JCL に追加する必要がある 2 つ

の行を示すために、例として表示されています。

//ENF PROC OPTLIB='SYS2.CA90S.PARMLIB',

// ENFDB='SYS2.CA31.ENFDB',

// ENFPARM=ENFPRM31,

// SPNPAR1=SPWNSNMP,

// SPNPARn=ndvspawn,

// CCIPARM=CCIPCA31,

// ENFCMDS=ENFCMD31,

//ENF EXEC PGM=CAS9MNGR,TIME=1440






//SPNPARMS DD DISP=SHR,DSN=&OPTLIB(&SPNPAR1)

// DD DISP=SHR,DSN=&OPTLIB(&SPNPARn)

//SPNPRINT DD SYSOUT=X

//SPNDEBUG DD SYSOUT=X

//SRVDEBUG DD SYSOUT=X

//ENFDB DD DISP=SHR,DSN=&ENFDB

//ENFPARMS DD DISP=SHR,DSN=&OPTLIB(&ENFPARM)

// DD DISP=SHR,DSN=&OPTLIB(&CCIPARM)

//ENFCMDS DD DISP=SHR,DSN=&OPTLIB(&ENFCMDS)

//SYSPRINT DD SYSOUT=X

SPNPARn

CAIENF パラメータメンバのシンボリックを指定します。 n をパラ

メータファイルリストで次に利用可能なシーケンス番号に変更

します。

ndvspawn

SPAWN パラメータファイルを指定します。このメンバには、

CAICCI SERVICE および PROCESS ステートメントが含まれます。

SERVICE ステートメントは、CA Endevor SCM API を識別します。

PROCESS ステートメントは、CA Endevor SCM API を実行する JCL プ

ロシージャを識別します。



2. ndvspawn ファイル内の CAICCI SERVICE および PROCESS ステートメン

トを編集して、SPAWN パラメータをカスタマイズします。次に、メン

バ NDVSPAWN としてサイト固有の CA90S.PARMLIB 内に適切なファイ

ルを保存します。

重要： Web サービス用のサンプル CCI 定義については、インストール

ソースライブラリ iprfx.iqual.CSIQOPTN で提供されるメンバ WSEWSCCI


SERVICE ステートメント

CA Endevor SCM API（ホストアプリケーション）を識別します。

PROCESS ステートメント

CA Endevor SCM API を実行する JCL プロシージャを識別します。

PROCNAME=WSEWSSTC

Web サービス処理中に CAICCI SPAWN サービスによって開始さ

れる CA Endevor SCM API ホストアプリケーションに関連付け

られているプロシージャの名前を指定します。 WSEWSSTC 値は、

SPAWN リクエストによって開始されるスターティッドタスク

プロシージャの名前です。

注：デフォルトでは、このスターティッドタスクに関連付けら

れているプロシージャの名前は WSEWSSTC です。ただし、この

名前は、たとえば、サイト固有の命名またはセキュリティ基準

に準拠するためにしばしば変更されます。サイトのプロシー

ジャ名が不明な場合は、デフォルト名が変更されていないかど

うか確認するか、システム管理者に問い合わせてください。

重要：ステートメントを提供されているフォーマットどおりに保持し

て、スペースおよび列の配列を維持します。 CAICCI ステートメントの

定義および使用の詳細については、CA Common Services のドキュメン

トを参照してください。

3. WSEWSSTC スターティッドタスクをカスタマイズします。ユーザのサ

イトに適するように、パラメータを変更します。

注：サンプル WSEWSSTC プロシージャは、CA Endevor SCM で配布され

ている CSIQJCL ライブラリ内にあります。

注： WSEWSSTC メンバ名を変更する場合は、SPNPARn ファイルの CCI

PROCESS ステートメントで PROCNAME 値を更新して、必ず新しいプロ

シージャ名が反映されるようにします。

注： wsewsstc 値は設定ファイルの JOBNAME パラメータで指定されま

す。



4. JES に定義されている PROCLIB へ WSEWSSTC をコピーします。

WSEWSSTC はスターティッドタスクとして開始されます。

5. これが CAICCI コンポーネントの最初のインストールである場合、イン

ストール後に、システムに対して IPL を実行する必要はありません。こ

れが 2 回目以降のインストールである場合、システムに対して IPL を

実行する必要がある場合があります。詳細については、CA Common

Services for z/OS のドキュメントを参照してください。

CA Endevor SCM SYSID の検索

CA Endevor SCM がインストールされているシステムの SYSID を知ってお

く必要があります。後で設定ファイルに SYSID を入力する必要があります。

詳細については、「設定ファイルを作成する方法 (P. 254)」を参照してく

ださい。

CA Endevor SCM SYSID を検索するには、ライブラリ &OPTLIB にある

CCIPARM ファイルメンバを開きます。 SYSID パラメータを検索して、記録

します。

例として、サンプルの CCIPARM ファイルの一部を以下に示します。この

サンプルでは、SYSID の名前は A31SENF です。

000001 *********************************************

000002 ** CA EVENT NOTIFICATION/CCI PARAMETER FILE *

000003 ** ---------------------- *

000004 ** CA-ENF/CCI VERSION 1.1 CONTROL OPTIONS *

000005 *********************************************

000006 SYSID(A31SENF)

000007 PROTOCOL(LU0,A31SENF,01,A31SENF)

000008 PROTOCOL(XES,CCIXES)

000009 PROTOCOL(TCPIP,1202)



設定値の記録

「Web サービス用に STC 定義を有効化する方法」と「CA Endevor SCM SYSID

の検索」の手順を実行する間に指定した値を記録します。 Web サービス

管理者は、これらの値の一部を使用して設定ファイルを作成します。記

録する値を以下に示します。

定義ソースデフォルト値使用する値

メインフレームログオンホスト名：

CCIPARM ファイルの SYSID パラメータの

名前を指定します。

この値は、HostName 設定パラメータに

も使用されます。

CCIPARM なし

CA Endevor SCM メインフレームスター

ティッドタスクプロシージャ：

Web サービスの開始時に CA Endevor

SCM サービスを開始するスターティッ

ドタスクに関連付けられているプロ

シージャを指定します。このプロシー

ジャのデフォルト名（WSEWSSTC）は、

サイト固有の基準に適合するように変

更されている可能性があります。

この値は、JobName 設定パラメータにも

使用されます。

NDVSPAWN ファ

イル

WSEWSSTC

SPNPARn:

CAIENF パラメータデータセットのシン

ボリックを指定します。

システム管理者 SPNPAR2

Web サービスへのセキュリティアクセスを有効にする方法



セキュリティ管理者は、CA Endevor SCM の Web サービスをサポートする

ようにサイトのセキュリティソフトウェアを設定することができます。

Web サービスは、Eclipse ベースの UI やユーザ作成のプログラムから CA

Endevor SCM API に接続するための前提条件です。

以下の図は、Web サービスへのセキュリティアクセスを有効にする方法

を示しています。



Web サービスへのセキュリティアクセスを有効にするには、以下の手順

に従ってサイトのセキュリティソフトウェアを設定します。

1. 許可されたユーザが WSEWSSTC をスターティッドタスクとして正し

く起動できるようにします (P. 230)。

2. MODHLI が CA Endevor SCM の C1DEFLTS テーブルで定義されている場

合は、許可されたユーザが MODHLI データセットにアクセスできるよ

うにします (P. 235)。

3. Tomcat サーバを起動する権限を有効にします (P. 236)。

Web サービス用のセキュリティソフトウェアのカスタマイズ

サイトのセキュリティソフトウェアを構成して、権限のあるすべての

ユーザが WSEWSSTC をスターティッドタスクとして正しく開始できるよ

うにする必要があります。

注： Web サービスは、CA Common Services CAICCI 生成機能によって開始さ

れるスターティッドタスクを使用して CA Endevor SCM API と通信します。

サイトの CA Common Services 管理者は、Web サービス用の生成機能を構成

する必要があります。管理者は、WSEWSSTC プロシージャを構成して、

CA Endevor SCM データセットのハイレベルおよびセカンドレベル修飾子

を指定します。 WSEWSSTC のコピーはスターティッドタスクとして開始

されます。

サイトで使用されるソフトウェアについて、以下のサンプル構成を確認し

ます。これらのサンプルは単なる例であり、サイトのセキュリティ基準

に準拠していない可能性があります。

■ CA Top Secret (P. 231)

■ CA ACF2 (P. 232)

■ IBM RACF (P. 234)

スターティッドタスクのセキュリティのセットアップの詳細については、

製品固有のマニュアルを参照するか、使用しているセキュリティソフト

ウェアのテクニカルサポートにお問い合わせください。

注：クライアントから Web サービスサーバにファイルが転送される際、

圧縮のみが行われ、暗号化は行われません。 CA Endevor SCM と Web サー

ビスの間のデータ通信では、パスワードを除いて、圧縮も暗号化も行われ

ません。



Configure CA Top Secret

サイトで CA Top Secret を使用している場合、このソフトウェアを構成して、

権限のあるすべてのユーザが WSEWSSTC をスターティッドタスクとして

正しく開始できるようにする必要があります。 CA Top Secret を構成するに

は、ENDEVOR という名前の新しい機能を定義し、新しい ACID を追加した

後、その ACID に MASTFAC 定義を指定します。次に、サイトの CA Common

Services 管理者によって定義された CAICCI 生成タスク WSEWSSTC に対し

て、この機能をデフォルトの ACID に指定します。最後に、Web サービス

のすべてのユーザを ENDEVOR 機能に追加します。

注：以下の手順の詳細については、CA Top Secret のマニュアルを参照する

か、または CA Top Secret のテクニカルサポートにお問い合わせください。

CA Top Secret を構成する方法

1. CA Top Secret のパラメータファイル（PARMFIELD DD ステートメントで

指定）に以下の定義を追加して、CA Endevor SCM に対して ENDEVOR と

いう名前の新しい機能を定義します。

* USERnn FACILITY FOR

*

FAC(USERnn=NAME=ENDEVOR)

2. 以下のコマンドを入力して、ENDEVOR という名前の新しい ACID を定

義します。

TSS CRE(ENDEVOR) NAME('endevor userid') TYPE(USER) FAC(STC,ENDEVOR) PAS(NOPW,0)

ENDEVOR ACID の NODSNCHK、NORESCHK、および NOSUBCHK バイパス

属性が必要な場合があります。不要な場合は、ACID に対して、必要と

するすべてのファイルとリソースへのアクセスが許可されていること

を確認します。

3. 以下のコマンドを入力して、ENDEVOR ACID に MASTFAC 定義を指定し

ます。

TSS ADD(ENDEVOR) MASTFAC(ENDEVOR)

4. 以下のコマンドを入力して、CAICCI 生成タスク WSEWSSTC のデフォル

トの ACID として ENDEVOR を割り当てます。

TSS ADD(STC) PROCNAME(WSEWSSTC) ACID(ENDEVOR)



5. 以下のコマンドを入力して、Web サービスの各ユーザに、ENDEVOR 機

能へのアクセス権を付与します。

TSS ADD(USERID) FAC(ENDEVOR)

注：新機能の定義の詳細については、「CA Top Secret Control Options Guide」

を参照してください。 CRE コマンドと ADD コマンドの詳細については、

「CA Top Secret Command Functions Guide」を参照してください。

CA ACF2 の環境設定

サイトで CA ACF2 を使用している場合、このソフトウェアを構成して、権

限のあるすべてのユーザが WSEWSSTC をスターティッドタスクとして正

しく開始できるようにする必要があります。 CA ACF2 を構成するには、STC

ログインを作成し、データセットアクセスが正しいことを確認し、リソー

スクラスを定義します。このセクションでは、サイトのセキュリティを

セットアップする方法のサンプルを提示するのみです。スターティッド

タスクのセキュリティのセットアップの詳細については、CA ACF2 のマ

ニュアルを参照するか、または CA ACF2 のテクニカルサポートにお問い合

わせください。

CA ACF2 を構成する方法

1. 以下のコマンドを入力して、WSEWSSTC スターティッドタスクに使用

する ENDEVOR という名前の STC ログイン ID を作成します。

ACF

INSERT ENDEVOR NAME(ENDEVOR) STC

2. ENDEVOR ログオン ID が UID 文字列の作成に使用されるフィールドな

どのサイト固有のログオン ID フィールドで定義されていることを確

認します。

注： CA ACF2 のログオン ID レコードの作成手順については、「CA ACF2

Administration Guide」を参照してください。

3. ENDEVOR ログオン ID に関する CA ACF2 ACCESS ルールを作成すること

により、ENDEVOR ログオン ID が必要なすべてのデータセットにアクセ

スできることを確認します。

注：このルールの作成手順については、「CA ACF2 Administration Guide」




4. FACILITY という名前のリソースクラスを定義し、リソースタイプコー

ド FAC を割り当てます。それには、以下の手順に従います。

a. 以下のコマンドを入力して、FACILITY リソースクラスの CLASMAP

レコードを作成します

。

ACF

SET CONTROL(GSO)

INSERT CLASMAP.FAC RESOURCE(FACILITY) RSRCTYP(FAC)

b. 以下のコマンドを入力して、FAC リソースタイプコードを

CA-ACF2 GSO INFODIR レコードに追加します。

SET CONTROL(GSO)

CHANGE INFODIR TYPES(R-RFAC)

c. 以下のいずれかを実行して、CLASMAP および INFODIR レコードの

変更を有効にします。

■ CA-ACF2 アドレス空間を再起動します。

■ 以下のコマンドを入力します。

F ACF2,REFRESH(CLASMAP)

F ACF2,REFRESH(INFODIR)

注： CA-ACF2 GSO レコードの保守の詳細については、「CA ACF2


5. ENDEVOR という名前の FACILITY リソースルールレコードを作成し、

以下のコマンドを発行して、ユーザにこのリソースへのアクセス権を

付与します。

ACF

SET RESOURCE(FAC)

COMPILE */pds.name

$KEY(ENDEVOR) TYPE(FAC)

UID(user1 uid string) ALLOW

UID(user2 uid string) ALLOW

.......

STORE

6. 以下のコマンドを入力して、FAC ディレクトリを再構築します。

F ACF2,REBUILD(FAC)

注： CA ACF2 リソースルールの作成手順については、「CA ACF2




IBM RACF の構成

このセクションでは、WSEWSSTC スターティッドタスクが正しく初期化で

きるように IBM RACF をカスタマイズする基本的な手順について説明しま

す。「RACF Security Administrator Guide」に従って以下のいずれかの方法

で、RACF にスターティッドタスクを定義できます。

■ STARTED クラスに対して新しいプロファイルを定義（IBM 推奨）

■ スターティッドプロシージャテーブル（ICHRIN03）に新しいエントリ

を追加

また、スターティッドタスク WSEWSSTC に RACF ユーザ ID を割り当て、

スターティッドプロシージャの開始を許可されている RACF グループに

ユーザ ID を割り当てる必要があります。

WSEWSSTC に RACF ユーザ ID を定義するには、ADDUSER コマンドを使用し

て、以下のように既存のスターティッドタスクの RACF グループに関連付

けます。

ADDUSER user_name DFLTGRP(default_group) OWNER(default_group) NOPASSWORD

user_name

新しい RACF ユーザ ID の名前を指定します。この名前は、Web サービ

スが使用する PROCLIB 内のスターティッドタスクメンバと同じ名前

にする必要があります。

default_group

システムのすべてのスターティッドタスクが含まれるデフォルトグ

ループを指定します（例： STCGROUP）。

注：デフォルトグループの名前が不明な場合は、RACF 管理者にお問い合

わせください。 RACF STARTED クラスの実装またはスターティッドタスク

テーブル（ICHRIN03）の変更の詳細については、RACF のマニュアルを参照


注：このコマンドは一例です。 ADDUSER コマンドの使用方法の詳細につい

ては、RACF 管理者にお問い合わせください。



MODHLI データセットへのユーザアクセスの有効化

クライアントプログラムから API にアクセスできるようにするには、セ

キュリティ管理者が MODHLI データセットへのユーザアクセスを有効に

しなければならない場合があります。 CA Endevor SCM 管理者は、MODHLI

データセットのセキュリティ要件を決定する必要があります。


1. MODHLI が CA Endevor SCM の C1DEFLTS テーブルでコード化されてい

ることを、CA Endevor SCM 管理者に問い合わせます。

– MODHLI 値がコード化されている場合は、すべてのユーザ ID に

MODHLI 高レベル修飾子（HLQ）を持つすべてのデータセットへの

アクセス権を付与する必要があります。この要件は、RACF、CA Top

Secret、または CA ACF2 を含む、すべてのセキュリティ製品でのア

クセスに適用されます。

この要件の理由は以下のとおりです。クライアントプログラムが

API にアクセスする場合、ユーザ ID が STC プールを生成するために

CAICCI に送信されます。Web サービスへのリクエストを発行する

ユーザ ID にはこれらのデータセットへの読み取り/書き込みアク

セスが必要です。これを有効にするために、MODHLI パラメータは

以下の形式でデータセット名を作成します。

modhli.Dyyddd.Thhmmss.STCnnnnn.ddname

STCnnnnn、ddname

API に関連する 9 つのファイル（APIMSGS、C1MSGS1 など）の

いずれかに対する一意の修飾子であるジョブ ID および

ddname。

– MODLHI 値がコード化されていない場合、セキュリティは影響を受

けません。これは、一時データセット名が、オペレーティングシ

ステムによって、SYSyyddd.Thhmmss.RA000.jobname.nnnnnn の形式

で標準の一時データセット HLQ で作成されているためです。

2. MODHLI 値が C1DEFLTS でコード化されている場合は、すべてのユーザ

ID に MODHLI 高レベル修飾子（HLQ）を持つすべてのデータセットへ

のアクセス権を付与するようセキュリティソフトウェアを設定しま

す。



Tomcat サーバを起動する権限の有効化

管理者が Tomcat サーバを起動できるようにするには、管理者のユーザ ID

に、Tomcat サーバによって使用される JVM 環境値へのアクセス権が必要

です。これらの値は Web サービス管理者が設定します。セキュリティ管

理者は、サイトのセキュリティソフトウェアでこれらのパスへのアクセ

ス権を付与します。


1. Web サービス管理者に、以下の JVM 環境値に設定されている値を問い

合わせます。 Web サービス管理者は WSTOMENV メンバでこれらの値

を設定します。

INSTALL_HOME - Tomcat がシステム上でインストールされている場所

を指定します。これは CCS_TOMCAT_DIR の値に基づいている必要があ

ります。

PRODUCT_HOME - Web サービスが実装される場所を指定します。これ

は TARGET_TOMCAT_DIR の値に基づいている必要があります。

2. セキュリティソフトウェアを更新して、適切なユーザが以下のパスに

アクセスできるようにします。

■ INSTALL_HOME で定義されているパスへの読み取りアクセス。

■ PRODUCT_HOME で定義されているパスへの書き込みアクセス。

Web サービスを構成および展開する方法



Web サービス管理者は、Web サービスコンポーネントを構成および展開

することができます。このコンポーネントは、Eclipse ベースの UI の前提

条件です。また、Web サービスを使用して、ユーザ作成のプログラムを CA

Endevor SCM API に接続できます。

z/OS システムに Web サービスを構成および展開するプロセスは、UNIX シ

ステムサービス（USS）環境で実行します。このプロセスの目的は以下の

とおりです。

■ Tomcat サーバに Web サービス専用の Tomcat インスタンスを作成す

る

■ この Tomcat インスタンスに Axis2/Java ソフトウェアを追加する

■ この Tomcat インスタンスに Web サービスを追加する

注： Web サービスでは、Web サービス用に設定された個別の Tomcat イン

スタンスが必要です。 Axis2/Java ソフトウェアは SOAP メッセージを有効

にするために必要です。

重要： Tomcat または Axis2 の新リリースを使用して Web サービスを実行

する場合は、新しい Tomcat ディレクトリツリーに新しい Web サービスを

展開することをお勧めします。詳細については、「Tomcat の新しいリリー

スで Web サービスを実行する方法 (P. 252)」を参照してください。



以下の図は、Web サービスを構成および展開する方法を示しています。



Web サービスを有効にするには、以下の手順を完了します。


2. メンバに記述されているとおりに WSTOMCCS メンバを編集し、Web

サービス用の Tomcat インスタンスを追加します。新しい Tomcat イン

スタンスに Web サービスファイルを追加して、Axis2/Java ソフトウェ

アを Tomcat サーバにインストールします。 Axis2/Java をインストール、

アップグレード、または現在のインストールを維持するかどうかに応

じて、WSTOMCCS で以下のオプションを設定します。

WSTOMCCS の詳細については、「Web サービスコンポーネント用の

Tomcat ディレクトリ構造の作成 (P. 241)」を参照してください。

3. Tomcat をシャットダウンして WSTOMCCS ジョブを実行します。

4. Apache Tomcat 設定ファイルを編集します。 (P. 245) server.xml ファイ

ルは Web サービス用の Tomcat インスタンスを作成するために使用し

ます。

5. （オプション） HTTPS を使用するように Web サービスを設定します

(P. 249)。

6. Tomcat サーバで使用する JVM 環境値を

注：環境値に定義したパス値をセキュリティ管理者に伝える必要があ

ります。セキュリティ管理者は、これらのパスへのアクセスを有効に

して、許可されたユーザが Web サービスを使用できるようにする必要

があります。

7. Web サービス用の Apache Tomcat サーバの JCL を編集します (P. 247)。

この JCL は Web サービス用のスターティッドタスクを有効にします。

8. Apache Tomcat サーバを起動します。



9. Tomcat のインストールと構成を確認します。 (P. 248) この手順では、

Tomcat インスタンスと Axis2/Java を確認します。

10. Web サービスがアクセスするデータソース（CA Endevor SCM のインス

タンス）用に、テンプレートとして ENDEVOR.cfg を使用して設定ファ

イルを作成します。次に、

/cai/CADeploy/ESCM/tpv/Tomcat/webapps/endevor に保存してファイル

を展開します。詳細については、「データソースへのアクセスの仕組

み (P. 253)」および「設定ファイルを作成する方法 (P. 254)」を参照し

てください。

注：サイトの各 CA Endevor SCM インスタンスに 1 つずつ、複数の設定

ファイルを作成できます。

注：これらの手順を実行すると、Web サービスで Eclipse プラグインを使用

するための設定が完了します。クライアントスタブの詳細については、

「ユーザ作成のクライアントプログラム (P. 269)」を参照してください。



Web サービスコンポーネント用の Tomcat ディレクトリ構造の作成

Web サービスでは、Web サービスをホストできる Tomcat インスタンスが

必要です。 Tomcat インスタンスを作成および設定するために、スクリプ

トファイルが提供されています。このファイルは、CSIQJCL にある

WSTOMCCS です。このジョブは、CA Common Services for z/OS で展開され

た Tomcat ディレクトリおよび CA Endevor SCM Web サービスインストー

ルディレクトリを入力として使用して、Web サービス用の Apache Tomcat

インスタンスの USS ディレクトリ構造を作成します。

このファイルは、インストールの要件に合わせてスクリプトをモデル化す

るために使用できます。スクリプトは、以下を実行する 3 つの論理ステッ

プで構成されています。

1. Tomcat インスタンスを作成します。

2. Axis2/Java を Tomcat インスタンスに追加します。

3. Web サービスを Tomcat インスタンスに追加します。


1. CSIQJCL にある WSTOMCCS を以下のように編集します。

a. WSTOMCCS の説明に従って、以下のパス値を編集します。

注： Web サービスをインストールおよび実行するための USS の手

順では、これらのパス値が必要です。これらの値は、このプロセ

スでいくつかのファイルで使用されます。これらの値が最初に必

要になるのは WSTOMCCS です。

JAVA_HOME - ランタイムのパスの場所を指定します。以下に例を

示します。

JAVA_HOME=/sysname/sys/java31bt/v6r0m0/usr/lpp/java/J6.0

CCS_TOMCAT_DIR - CA Common Services が Tomcat を展開したパス

の場所を指定します。このパスには、システムに読み取り専用で

マウントされるファイルシステム上のパスを指定できます。デ

フォルト値は以下のとおりです。

CCS_TOMCAT_DIR=/sysname/cai/CADeploy/CCS/tpv/tomcat.

製品で Tomcat の特定のリリースが必要な場合は、/tomcat を

/apache-tomcat-v.r.nn に変更できます。ここで v.r.nn には特定のリ

リースを指定します。



TARGET_TOMCAT_DIR - Web サービスの Tomcat インスタンスの

ターゲットディレクトリを指定します。このパスは、システムに

読み取り/書き込みとしてマウントされるファイルシステム上の

パスである必要があります。デフォルト値は以下のとおりです。

TARGET_TOMCAT_DIR=/sysname/cai/CADeploy/ESCM/tpv/tomcat

ENDEVOR_SOFTWARE_DIR - CA Endevor SCM のインストールパスを

指定します。デフォルト値を CA Endevor 製品がインストールされ

ているパスに変更します。このパスは /software で終了する必要が

あります。

デフォルト値は以下のとおりです。

ENDEVOR_SOFTWARE_DIR=/sysname/cai/CASoftware/ESCM/software

b. WSTOMCCS の説明に従って、以下のいずれかを実行します。

注：これが Web サービスの最初のインストールである場合は、最

初の項目を実行してください。

■ Tomcat インスタンスを作成し、Axis2/Java を Tomcat サーバに

インストールして、Tomcat インスタンスに Web サービスを展

開する場合 - 以下の値を設定します。

- TOMCAT の値を YES に設定します。

- Axis2 の値を YES に設定します。

- ENWS の値を DEPLOY に設定します。

■ Tomcat インスタンスを更新し、Axis2/Java を Tomcat サーバに

インストールして、Tomcat インスタンスに Web サービスを展

開する場合 - 以下の値を設定します。

- TOMCAT の値を NO に設定します。

- Axis2 の値を YES に設定します。




■ Tomcat インスタンスを更新し、現在 Tomcat サーバにインス

トールされている Axis2/Java ソフトウェアを維持し、Tomcat イ

ンスタンスに Web サービスを展開する場合 - 以下の値を設定

します。

- TOMCAT の値を NO に設定します。

- Axis2 の値を NO に設定します。


既存の展開を更新する場合、スクリプトによって Tomcat/Axis2 イ

ンスタンスから Web サービスのディレクトリツリーが削除され

ます。その後、新しいディレクトリツリーがターゲットの

Tomcat/Axis2 インスタンスに追加されます。

重要： - Web サービスがすでに展開されている場合は、カスタマイ

ズしたファイルをすべてバックアップしてからこのジョブを実行

する必要があります。対象のファイルは、endevor ディレクトリに

あるすべての cfg ファイル、または endevor ディレクトリツリーに

配置したその他のすべてのファイルです。

重要： Tomcat または Axis2 の新リリースを使用して Web サービス

を実行する場合は、新しい Tomcat ディレクトリパスを指定するこ

とを推奨します。スクリプトが正常に実行された後、新しい

Tomcat ツリーの server.xml ファイルを Web サービスに使用する

ポートで更新します。

2. ジョブを実行します。

このジョブによって、Tomcat サーバの構成と起動に必要なディレクト

リとファイルがすべて作成され、このディレクトリが Tomcat のインス

タンスにコピーされます。



3. Axis2 のインストールと WSTOMCCS の設定を以下のように確認します。

■ STDERR 出力がないことを確認します。

■ STDOUT で問題を示すメッセージがないかどうか確認します。

■ ユーザの CA Endevor SCM Web サービスインストールの

/tpv/tomcat/webapps/axis2 ディレクトリに以下のディレクトリが

あることを確認します。

– axis2-web

– org

– META-INF

– WEB-INF

モジュールが予期されたディレクトリに存在しない場合は、ジョブ出

力でエラーメッセージがないかどうか確認します。

ディレクトリが axis2 ディレクトリに存在する場合、ジョブは正常に実

行されています。



Tomcat 設定ファイルの編集

この Tomcat インスタンスが Web サービスと通信できるようにするには、

Tomcat 設定ファイルを編集する必要があります。

/cai/CADeploy/ESCM/tpv/tomcat/conf にある server.xml ファイルを編集し

ます。サイトに応じて、サーバ、コネクタ、リダイレクトポート番号を

変更します。通信に使用する Tomcat サーバのこのインスタンス用の一意

の TCP/IP ポート番号があることを確認します。通信に TCP/IP を使用する

LPAR 上のプログラムにはそれぞれ一意のポート番号が必要です。

server.xml ファイルは ASCII でエンコードされていて、エンコードをそのま

まにしておく必要があります。 server.xml ファイルを編集する方法の 1 つ

として、ISPF EDIT を使用する方法があります。この方法について、以下で

説明します。


1. ISPF パネル上で次のコマンドを入力します： TSO ISH

UNIX System Services ISPF シェルパネルが表示されます。

2. server.xml が置かれているパス名

「/cai/CADeploy/ESCM/tpv/tomcat/conf/」を入力し、Enter キーを押しま

す。

ディレクトリリストが表示されます。

3. server.xml の隣に「E」を入力し、Enter キーを押します。

server.xml ファイルが開きます。

4. ファイルに変更を加えて、ファイルを終了します。

ファイルはユーザのサイトに応じて更新され、ASCII でエンコードされ

たファイルのままです。

注： Tomcat に HTTPS の実装が必要な場合は、「Tomcat で HTTPS を設定す

る方法 (P. 249)」を参照してください。



Tomcat サーバによって使用される JVM 環境の値の編集

Apache Tomcat サーバの環境変数を設定するには、CSIQJCL のメンバ

WSTOMENV を編集して、サイトに適した値を指定します。

CSIQJCL のメンバ WSTOMENV の以下のパラメータを更新します。以下の変

数を更新する方法の詳細な手順については、メンバを参照してください。

■ INSTALL_HOME - Tomcat がシステム上でインストールされている場所

を指定します。これは CCS_TOMCAT_DIR の値に基づいている必要があ

ります。

■ PRODUCT_HOME - Web サービスが実装される場所を指定します。これ

は TARGET_TOMCAT_DIR の値に基づいている必要があります。

■ JAVA_HOME - Tomcat のこのインスタンスで使用される、Java ランタイ

ムディレクトリの場所を指定します。

重要： Tomcat サーバの起動に使用するユーザ ID には、INSTALL_HOME で定

義されているパスの読み取りアクセス権と、WSTOMENV の

PRODUCT_HOME で定義されているパスの書き込みアクセス権が必要であ

ることを、CA Endevor SCM 管理者とセキュリティ管理者に必ず伝えてくだ

さい。



Apache Tomcat サーバの起動

Web サービスへのアクセスを有効にするには、Apache Tomcat サーバを起

動する JCL をカスタマイズする必要があります。


1. メンバ内の説明に従って、CSIQJCL の WSTOMSTC メンバの JCL を編集し

ます。

■ JOBCARD を追加するか、または PEND ステートメントと EXEC ス

テートメントを削除します。

注： STEPLIB 値は、インストールされたデータセット CSIQPLD をポイン

トする必要があります。ポイントしていない場合は、Web サービスが

機能しません。 Web サービスを起動する前に、WSTOMENV を確認お

よび更新する必要があります。

WSTOMSTC メンバがカスタマイズされます。

2. WSTOMSTC JCL をサンプルライブラリ（CSIQJCL）からシステムプロ

シージャライブラリにコピーして、テスト後にスターティッドタスク

として実行できるようにします。

注： Tomcat サーバの起動に使用するユーザ ID には、INSTALL_HOME で

定義されているパスへの読み取りアクセス権、および WSTOMENV の

PRODUCT_HOME で定義されているパスへの書き込みアクセス権が必

要です。

3. システム管理者と連携して、IPL の後に開始される WSTOMSTC タスク

を確認します。

Apache Tomcat サーバが独自のアドレス空間で起動するように JCL が

カスタマイズされます。



Apache Tomcat のインストールおよび構成の確認

この手順を使用して、Apache Tomcat のインストールおよび構成の手順が

正常に完了したことを確認します。予想した結果が得られなかった場合

は、マニュアルの記述どおりに Web サービスの構成手順を実行したこと

を確認してください。問題を特定できない場合は、CA テクニカルサポー

トにお問い合わせください。

Apache Tomcat のインストールおよび構成を確認する方法

1. Web ブラウザを開き、URL に Apache Tomcat のホスト名、ポート、お

よび「/axis2」を続けて入力して、Enter キーを押します。

Apache Axis2 の Web ページの初期画面が表示されます。

2. ［Services］リンクをクリックします。

［Axis2 Available services］ページが表示されます。［EndevorService］

が表示され、［Available Operations］に［getDestination］、

［getConfigurations］、［submitSCL］などが表示されていることを確認

します。これで Web サービスのインストールは完了です。



Tomcat で HTTPS を設定する方法

オプションで、ユーザアクセスに HTTP ではなく HTTPS を使用することも

できます。このオプションを使用すると、ユーザ名とパスワードを指定

して、ネットワーク上に平文でデータが流出することに関する懸念を最小

限にすることができます。

HTTPS を使用するように Web サービスを構成するには、以下の手順に従い

ます。

1. 以下の手順に従って、キーストアを生成します。。

a. OMVS で、以下のコマンドを入力します。

$JAVA_HOME/bin/keytool –genkey -alias tomcat -keyalg RSA

プロンプトが表示されます。

b. パスワードを指定して Enter キーを押し、質問に答えます。

■ 証明書の受け入れを促すプロンプトが表示されたとき、それが

どのホストからの証明書なのかがわかるように、Tomcat が動作

するホスト名を CN 値に使用することをお勧めします。

■ オプションで、以下のコマンドの /path/to/my/keystore を置き

換えることによって、デフォルトキーストアとして別の場所

を指定できます。 $JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA -keystore /path/to/my/keystore

デフォルトのキーストアは、自己署名証明書が 1 つあるホーム

ディレクトリに作成されます。

2. tomcat_install_dir/conf ディレクトリにある server.xml ファイル内の

Apache Tomcat の構成パラメータを、以下の手順に従って更新します。

a. SSL コネクタ情報をコメント解除するか、または置き換えて、port

パラメータと keystoreFile パラメータにサイト固有の値を指定しま

す。

注： keystorePass 値が手順 1 で指定したパスワードと一致している

ことを確認してください。

サンプルの SSL コネクタデータを以下に示します。

<!-- Define a SSL HTTP/1.1 Connector on port 8443…

<Connector port="8040" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"

keystorePass="Y7ssl"

keystoreFile="/ca/.keystore"/>

b. 標準の HTTP コネクタ情報の redirectPort 値を編集して、SSL コネク

タデータで指定されている値と一致させます。

<Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000"

redirectPort="8040" />

3. tomcat_install_dir/conf にある web.xml ファイルの末尾の </web-app>

の前に、以下の行を追加します。

<security-constraint>

<web-resource-collection>

<web-resource-name>Tomcat</web-resource-name>

<url-pattern>*.html</url-pattern>

</web-resource-collection>

<user-data-constraint>

<transport-guarantee>CONFIDENTIAL</transport-guarantee>

</user-data-constraint>

</security-constraint>

Apache Tomcat サーバの起動後、定義されている証明書を信頼するかどう

かの指定を促すメッセージが表示されます。［Yes］をクリックして、そ

の証明書を信頼できる証明書にインポートします。

注：信頼できる証明書の詳細については、Web で Apache Tomcat 6.0 を参照

Web サービスの既存の展開を更新する方法


Web サービスの既存の展開を更新する方法

Web サービス管理者は、Web サービスコンポーネントの既存の展開を更

新することができます。たとえば、インストール済みの Endevor ディレク

トリに対して Web サービスのメンテナンスを適用する場合は、Tomcat イ

ンスタンスの Web サービスディレクトリにもメンテナンスを展開する必


Web サービスコンポーネントの既存の展開を更新するには、以下の手順

に従います。

1. 設定ファイルをバックアップします。このジョブを実行する前に、カ

スタマイズしたファイルをすべてバックアップする必要があります。

対象のファイルは、endevor ディレクトリにあるすべての cfg ファイル、

または Endevor ディレクトリツリーに配置したその他のすべてのファ

イルです。。

2. メンバに記述されているとおりに WSTOMCCS メンバを編集し、

WSTOMCCS に以下の値を設定して Web サービスファイルを更新しま

す。

■ TOMCAT の値を NO に設定します。

■ Axis2 の値を NO に設定します。

■ ENWS の値を UPDATE に設定します。

既存の展開を更新する場合、スクリプトによって Tomcat/Axis2 インス

タンスから Web サービスのディレクトリツリーが削除されます。そ

の後、新しいディレクトリツリーがターゲットの Tomcat/Axis2 インス

タンスに追加されます。

3. Tomcat サーバをシャットダウンして、WSTOMCCS ジョブを実行します。

4. 保存した設定ファイルを更新したディレクトリツリーにコピーしま

す。

5. Tomcat サーバを再起動します。

Tomcat の新しいリリースで Web サービスを実行する方法


Tomcat の新しいリリースで Web サービスを実行する方法

Tomcat または Axis2 の新リリースを使用して Web サービスを実行する場

合は、新しい Tomcat ディレクトリツリーに新しい Web サービスを展開す

ることをお勧めします。これを行うには、以下の手順に従います。

1. 設定ファイルのコピーを保存します。

2. 「Web サービスを構成および展開する方法 (P. 237)」および「Web サー

ビスコンポーネント用の Tomcat ディレクトリ構造の作成 (P. 241)」の

手順に従って、新しい TARGET_TOMCAT_DIR および

ENDEVOR_SOFTWARE_DIR パスを指定し、WSTOMCCS に値を以下のよう

に設定します。

■ TOMCAT の値を YES に設定します。

■ Axis2 の値を YES に設定します。

■ ENWS の値を DEPLOY に設定します。

3. Tomcat サーバをシャットダウンして、WSTOMCCS ジョブを実行します。

4. 保存した設定ファイルを更新したディレクトリツリーにコピーしま

す。

5. Tomcat サーバを再起動します。

データソースへのアクセスの仕組み


データソースへのアクセスの仕組み

Web サービスは、AXIS2 アーカイブファイル（EndevorService.aar）として

配布されます。 Tomcat は、自動または手動でこの .aar ファイルを展開し

ます。 EndevorService コンポーネント（Web サービスエンドポイント）に

は、開始してから終了するまでのライフサイクルがあります。

EndevorService コンポーネントは、初期化時に webapps/endevor フォルダ

をスキャンし、設定ファイル（*.cfg）を特定して検証します。検証で異常

が検出された設定ファイルは、破棄されます。 .cfg ファイルを追加、削除、

または変更するには、EndevorService.aar コンポーネントを停止し、再起動

する必要があります。

クライアントアプリケーションまたは Eclipse ベースの UI 接続ウィザー

ドは、検証済みのデータソースのリストにアクセスできます。このリス

トには、設定ファイルから抽出した説明、ステータス、およびメッセージ

が含まれます。 EndevorService.aar ファイルは、クライアントから SOAP エ

ンベロープを受信します。クライアントアプリケーションからの SOAP

メッセージには、LoginProperities オブジェクトに dataSource パラメータが

含まれています。このパラメータは、クライアントアプリケーションが

アクセスするデータソース（CA Endevor SCM インスタンス）を示します。

クライアントは、検証済みの複数のデータソースに同時にアクセスでき

ます。

■ webapps/endevor フォルダには、複数の有効な設定ファイルを複数配

置できます。たとえば、A1.cfg、A2.cfg、B1.cfg、B2.cfg が、データソー

ス A1、A2、B1、B2 にアクセスできます。

■ 異なる設定ファイルで、同じまたは別の CAICCI ホストに存在する同じ

スターティッドタスクを指定できます。 .cfg ファイルの名前は、.cfg

ファイル内の Name 値で指定されているデータソースの名前と一致

する必要があります。ただし、データソースの名前は、.cfg ファイル

でスターティッドタスクとして指定されている JobName 値と同じで

ある必要はありません。

たとえば、以下の表の各 *.cfg ファイルは、ホストコンピュータ上の

スターティッドタスクを使用して、データソースにアクセスします。

これら 3 つのデータソースは、すべて同時に使用できます。

*.cfg データソース名スターティッドタスクプロシージャ Host Name

A1.cfg A1 ENWSTST7 usilnj31

設定ファイルを作成する方法


*.cfg データソース名スターティッドタスクプロシージャ Host Name

A2.cfg A2 ENWSTST7 usilnj11

B1.cfg B1 ENWSTST7 usilcnj31


Web サービスのデータソース（CA Endevor SCM インスタンス）を定義す

るには、データソース設定（.cfg）ファイルを作成する必要があります。こ

のファイルには、この CA Endevor SCM インスタンスに関する設定情報お

よび接続情報が含まれています。複数の設定ファイルを定義して、同時

に使用できます。 Web サービス初期化プロセスは、webapps/endevor フォ

ルダにある .cfg ファイルをすべてスキャンします。有効な .cfg ファイルだ

けがアクティブ化されます。


1. 提供された .cfg ファイル（ENDEVOR.cfg）をテンプレートとして使用す

るか、またはエディタで独自の設定ファイルを手動で作成します。こ

のファイルは、XML ドキュメントとしてコーディングされます。ファ

イルにエラーがある場合、Web サービスはそれをアクティブにしませ

ん。詳細については、「V16 データソース設定ファイルテンプレート

(P. 256)」を参照してください。

重要: .cfg ファイルは ASCII でコーディングされています。詳細につい

ては、「ASCII エンコードファイルの編集 (P. 255)」を参照してくださ

い。

提供された ENDEVOR.cfg ファイルテンプレートを使用している場合、

HostName および JobName パラメータを変更する必要があります。ま

た、ユーザのインストールに固有のコメントパラメータを編集する必

要があります。他のパラメータを確認し、必要があれば、それらをユー

ザの基本設定に変更してください。詳細については、「ENDEVOR.cfg パ

ラメータ」を参照してください。他のパラメータは、すべて定義され

てるとおりで構いません。

2. 設定ファイルでコーディングされた Name= パラメータの値に一致す

るように、.cfg ファイルの名前を変更します。クライアント Web サー

ビスアプリケーションは、この名前を使用してデータソースリポジ

トリを参照します。

3. ユーザの Web サーバ上の以下の場所にファイルを展開します。/cai/CADeploy/ESCM/tpv/Tomcat/webapps/endevor



ASCII エンコードファイルの編集

ENDEVOR.cfg ファイルは ASCII コードで記述されているファイルであり、そ

の状態を維持する必要があります。 ASCII ファイルを編集する方法の 1 つ

として、ISPFEDIT を使用します。 ISPFEDIT を使用して ASCII ファイルを編

集するには、以下の手順に従います。

1. ［ISPF Primary Options Menu］から［Utilities］メニューにアクセスしま

す（オプション 3）

［Utilities Selection］パネルが表示されます

2. ［Utilities Selection］パネルで、オプション 17 （Udlist）にアクセスし

ます。

［z/OS UNIX Directory List Utility］が開きます。

3. 編集するファイルがある場所のパス名を入力し、Enter キーを押します。

たとえば、配布時の ENDEVOR.cfg は

/cai/CADeploy/ESCM/tomcat/webapps/endevor/ にあります。

ディレクトリリストが表示されます。

4. 編集するファイルの横に「EA」と入力し、Enter キーを押します。

［edit entry］ダイアログボックスが表示されます。

5. ASCII データオプションおよびその他の必要なオプションを選択し、


編集するファイルが開きます。

6. ファイルに変更を加えて、ファイルを終了します。

ファイルが編集され、ASCII ファイルのまま保存されます。



V16 データソース設定ファイルテンプレート

配布されるデータソース設定ファイル（.cfg）には、ENDEVOR.cfg という

名前が付けられています。このファイルはテンプレートであり、ASCII コー

ドで記述されています。このファイルを使用するには、サイトに合わせ

て編集および名前を変更する必要があります。テンプレートのコピー内

の XML 属性の値をコード化し、<mount-point>/ESCM/tpv/tomcat/webapps/

ディレクトリに保存します。テンプレートの内容を以下に示します。

<?xml version="1.0"?>

<DataSource xmlns="http://scm.ca.com/endevor/CFG"

xmlns:cfg="http://scm.ca.endevor"

Name="ENDEVOR"

Status="Available"

Message="Welcome to ENDEVOR"

Description="Endevor demo">

<STC HostName="CCIHOST"

JobName="CCISTC"

ProgramName="BC1PAPI0"

Comments="ENDEVOR STC"

PoolInitSize="0"

PoolIncrSize="1"

PoolMaxSize="0"

PoolreapTime="180">

UnusedTimeout=”600”

AgeTimeout=”1200”>

<wsParameters Lang="EN"

TimeZone="GMT-6.0"

CodePage="cp1040"

Encoding="cp1040"

CharacterSet="ISO8859-1"

LFSEncoding="ISO8859-1"

ContentType="Text"

Trace="1"

Traced="USERID"/>

</STC>

</DataSource



ENDEVOR.cfg のパラメータ

配布されるデータソース設定ファイル ENDEVOR.cfg には、Web サービス

を実行するための推奨パラメータが含まれています。以下のリストでは、

これらの各パラメータ、および追加のパラメータ、オプションのパラメー

タ、予約パラメータについて説明します。

■ DataSource パラメータ – データソースの名前およびデータソースに

関する情報を指定します。パラメータは以下のとおりです。

Name

この設定ファイルを適用する CA Endevor SCM データソースを示

す名前を、英数字 1 ～ 20 文字で指定します。

注：有効な設定ファイルであるためには、.cfg ファイルの名前と

ファイル内で Name= に指定されている値が一致する必要がありま

す。ユーザ作成のクライアントをデータソースに接続するには、

クライアント要求の DataSource パラメータに設定ファイルと同じ

名前を指定します。

Status

サービスがアクティブかどうかを指定します。有効な値は 1 ～ 15

文字のテキスト文字列です。推奨値は Available または Unavailable

です。このテキストは、クライアントアプリケーションが有効な

データソースのリストにこのデータソースを表示する際に表示

されます。

Message

このデータソースに設定する 1 ～ 100 文字のメッセージ（例：

「Welcome to CA Endevor SCM Web Services. Service is open.」）を指

定します。このテキストは、クライアントアプリケーションが有

効なデータソースのリストにこのデータソースを表示する際に

表示されます。

Description

このデータソースに設定する 1 ～ 100 文字の説明（例：「CA

Endevor SCM Web Service」）を指定します。このテキストは、クラ

イアントアプリケーションが有効なデータソースのリストにこ

のデータソースを表示する際に表示されます。



■ STC パラメータ – CA Endevor SCM が実行されている CCI ホスト、生成さ

れるスターティッドタスクプロシージャで定義されている CCI

PROCNAME、および指定したホスト z/OS メインフレーム上の CA

Endevor SCM のプログラム名を指定します。

Hostname

データソースに関連付けられている CAICCI ホスト名を 1 ～ 8 文字

で指定します。 CCIPARM ファイル内の SYSID の値を使用します。

この値は、CA Endevor SCM がインストールされているシステムの

SYSID です。

Jobname

CA Endevor SCM API サーバの起動に使用する CAICCI ホストアプリ

ケーションまたはプロセスの名前を 1 ～ 8 文字で指定します。

WSEWSCCI ファイルで指定されている CA Endevor SCM メインフ

レームスターティッドタスクプロシージャを使用します。

「WSEWSSTC」などのジョブ名を使用してください。



ProgramName

Jobname によって起動されるプログラムの名前を 1 ～ 8 文字で指

定します。ここでは、「BC1PAPI0」です。これは唯一の有効な値

です。

UserId（オプション）

STC プールの STC の生成に使用するユーザ ID を 1 ～ 8 文字で指定

します。ここで使用する ID は、「Web サービスへのセキュリティ

アクセスを有効にする方法」の手順に従って定義する必要があり

ます。この値は、STC の生成に使用されるユーザ ID を上書きしま

す。パスワード NOTREQED で Web サービスを開始するために使用

されるデフォルトユーザ ID。

Password（オプション）

1 ～ 8 文字の文字列を指定します。この値は、UserID で指定された

ID のパスワード、または ID にパスワードがない場合は NOTREQED

のいずれかです。 UserId がコード化される場合、この値または

EncryptedPassword をコード化する必要があります。

EncryptedPassword（オプション）

Password 値の 64 ビット暗号化文字列を指定します。 Password が

NOTREQED の場合、この値は「Tk9UUkVRRUQ=」です。 UserId がコー

ド化される場合、この値または Password をコード化する必要があ

ります。

Comments

ユーザがデータソースを識別しやすくするための 1 ～ 100 文字の

文字列を指定します。

PoolInitSize

STC プール内の初期（永続）STC の数を指定します。永続 STC は、

Web サービスの開始時または更新時に作成されます。プール内の

STC はそれぞれ、別のクライアントからメインフレーム上の CA

Endevor SCM に API リクエストを転送できます。 1 つの Web サービ

スコールは、API の実行中に STC の所有権を取得します。永続プー

ル内の STC がすべて開始した後、PoolIncrSize パラメータによって

指定された数によって制限される追加の STC を開始できます。パ

フォーマンスの向上については、増分プールから開始する STC 数が

過剰になるのを回避するために、オプションの方法として、

PoolInitSize の値を設定します。

有効な値は 0 から 20 です。



デフォルト： 5

PoolIncrSize

STC の不足が検出された場合に、永続プールに加えて、プールメン

テナンススレッドが作成できる増分 STC の数を指定します。

PoolInitSize を 0 に設定すると、すべての STC 接続が増分プールから

割り当てられます。ワークロードの減尐後、スレッドは増分プー

ルから余分な STC 接続を解放します。



PoolMaxSize

プール内の有効な永続 STC および増分 STC の最大数を指定します。

STC プールメンテナンススレッドは、プール内の STC をこの数ま

で維持します。 STC が最大数まですべて使用された場合、受信 Web

サービスコールは拒否されます。このパラメータの値は操作中に

増加できません。



PoolreapTime

STC プールメンテナンスモニタリングスレッドの実行間隔を秒単

位で指定します。たとえば、この値が 180（デフォルト）に設定

されると、モニタスレッドは 180 秒間隔で実行されます。

PoolreapTime 値を設定する場合、以下の条件を考慮してください。

■ この値は、Unused Timeout および Aged Timeout 設定の正確性に

影響します。間隔が小さいほど、設定はより正確になります。

この値を Unused Timeout および Aged Timeout パラメータに対

して設定された値より小さな値に設定します。スレッドの実行

時に、スレッドは Unused Timeout で指定された時間より長い間

使用されないままだった STC を解放し、PoolInitSize で指定され

た接続数に到達するまで、解放された各 STC を新しい STC に置

換します。モニタスレッドは、Aged Timeout パラメータに対

して指定された時間値より長い間アクティブなままな接続も

解放します。



■ この値はパフォーマンスにも影響します。間隔が小さくなるこ

とは、STC モニタリングスレッドの実行頻度が増し、パフォー

マンスが低下することを意味します。

■ プールメンテナンススレッドを無効にするには、PoolreapTime

を「0」に設定することをお勧めします。この場合、Unused

Timeout および Aged Timeout は無視されます。あるいは、

Unused Timeout と Aged Timeout の両方を「0」に設定して、プー

ルメンテナンスを無効にすることもできます。この場合、プー

ルメンテナンススレッドは実行されますが、ゼロ以外のタイ

ムアウトによってタイムアウトする物理接続のみが破棄され

ます。

有効な値は、秒単位で 0 から 600 です。

デフォルト: 180

Connection Timeout

モニタスレッドがリクエストをキャンセルする前に、STC スタート

アップリクエストがどれくらいの時間待機できるか指定します。

この値によって、STC の割り当てを無期限に待機するのを回避し、

通信エラーが繰り返し発生する場合は、STC を保留ステータスに設

定します。そのような場合は、setConfiguration() 操作による設定の

リフレッシュによって、保留ステータスをリセットします。


デフォルト: 30

Unused Timeout

モニタスレッドが接続を破棄する前に、STC 接続がどれくらいの時

間アイドル状態にあるかを指定します。このタイムアウトの正確

性およびパフォーマンスは、PoolreapTime 値による影響を受けます。

パフォーマンスを最適にするには、Unused Timeout 値を

PoolreapTime 値より高く設定します。たとえば、Unused Timeout 値

が 120 に設定され、STC モニタリングスレッドが PoolreapTime 60

で有効な場合、未使用の STC はシャットダウン前に最大 60 秒間ア

クティブなままになります。





Aged Timeout

モニタスレッドが接続を破棄する前に、STC 接続がどれくらいの時

間アイドル状態にあるかを指定します。このタイムアウトの正確

性およびパフォーマンスは、PoolreapTime 値による影響を受けます。

パフォーマンスを最適にするには、Aged Timeout 値を PoolreapTime

値より高く設定します。たとえば、Aged Timeout 値が 1200 に設定

され、PoolreapTime 値が 60 の場合、シャットダウンされる前に、

STC は最大 1140 秒（19 分）間存在します。

Aged Timeout を 0 に設定すると、シャットダウンが他のパラメータ

値を基準にしていない限り、STC は無期限にプール内に留まります。



ConnectionMaxWS

STC が受信可能な Web サービスコールの最大数を指定します。

コールの数がこの数を超えた後、モニタスレッドはコールをこの

STC にルーティングするのを停止し、次のリクエストをプール内の

別の STC にルーティングするか、追加の STC を開始します。この

パラメータは、JES 出力のサイズ、競合の可能性、その他の z/OS 環

境の問題などの潜在的な問題を防止します。



ConnectionMaxKBytes

STC が処理できるキロバイトの最大数を指定します。これによって、

1 つの STC によって実行されるすべての Web サービスコールに

よって交換可能なデータ量が制限されます。データ量の合計がこ

の値を超えた後、モニタスレッドはこの STC へのリクエストの

ルーティングを停止します。代わりに、リクエストはプール内の

別の STC にルーティングされるか、必要に応じて、追加の STC が開

始されます。このパラメータは、JES 出力のサイズ、競合の可能性、

その他の z/OS 環境の問題などの潜在的な問題を防止します。

有効な値は、KB 単位で 0 から 100,000 です。




ResponseTimeout

CA Endevor SCM からの応答の待機が中断されるまでの間隔を秒単

位で指定します。この値は、通信レイヤ（CAICCI）で定義される

ReceiveTimeout 値との関係で設定されます。この間隔に到達する

と、Web サービスクライアントは API が保留中であることを明示

的に通知されます。有効であるためには、この値は CAICCI 値より

小さな値にする必要があります。長期間実行されるジョブが Web

サービスからサブミットされる場合、CAICCI 設定に対する高い値が

予期されます。長期間実行されるジョブは中断されず、その STC 接

続はキャンセルされません。



KeepAlive

通信レイヤからの接続タイムアウトの発生を回避するために、モ

ニタスレッドによって永続プールからの使用可能な STC を再アク

ティブ化するために使用される時間間隔を指定します。 KeepAlive

パラメータによって SCL が CA Endevor SCM にサブミットされて、

通信またはバックエンドレイヤで時間値を更新します。スレッド

は、バックエンドの応答性を識別し、通信エラーをすべて処理し

ます。失敗の種類に応じて、スレッドは STC を解放し、新しいイ

ンスタンスに置換します。モニタリングスレッドは、コピーをリ

フレッシュする前に、受信 Web サービスコールの数、または STC

当たりのデータ転送の合計ボリュームのしきい値を確認します。



■ wsParameters パラメータ – サブミットを呼び出す際に追加されるデ

フォルト値を指定します。このパラメータで、CA Endevor SCM とイン

ターネットの間で送受信するデータの処理について詳細に指定します。

重要：これらの値は、submitSCL() 呼び出しで渡される際に置き換えら

れます。

Lang

CodePage に対応する 2 文字の言語コードを指定します。

デフォルト： EN



TimeZone

データソースが置かれているタイムゾーンを、GMT+0 からの正ま

たは負のオフセットで指定します（例： GMT-6.0）。 Web サービ

スはこの値を使用して、データソースが置かれている z/OS メイン

フレーム上の正しい時刻を決定し、メッセージで使用します。

CodePage

メインフレームのオペレーティングシステムで定義され、CA

Endevor SCM が使用しているコードページを指定します。コード

ページは、メインフレーム上のテキストファイルのコーディング

方法を定義する EBCDIC （Extended Binary Coded Decimal Interchange

Code）の 1 つです。

CodePage パラメータと CharacterSet パラメータにより、Web サー

ビスはクライアントコンピュータと API の間で交換した平文テキ

スト情報を変換できます。平文テキスト情報には、API に送信され

た SCL コマンドおよび API から抽出したレポートと CSV ファイル

があります。

サポートされているエンコーディングについては、http://download.oracle.com/javase/1.5.0/docs/guide/intl/encoding.doc

.html を参照してください。

デフォルト： cp01140

CharacterSet

クライアントアプリケーションが使用する文字セットを指定しま

す（例： latin1、iso8859-1）。 CharacterSet 値は、Web サービスが

メインフレームコードページとクライアントアプリケーション

で使用されるアルファベットの間で変換を行う方法を指定します。

この値は、平文テキスト情報の変換にのみ使用されます。詳細に

ついては、このトピックの CodePage パラメータの定義を参照して

ください。





LFS.Encoding

クライアントのローカルファイルシステムに格納されている CA

Endevor SCM エレメントのコード化スキームを指定します。この値

は、Web サービスで Java 仮想マシンがテキスト文字変換に使用す

る文字セットの名前を指定します。この値は、クライアントアプ

リケーションと API 間のファイルの交換に適用されます。 CA

Endevor SCM では、これらのファイルは、DATA FORMAT=Text で定

義されたエレメントタイプに関連付けられます。

■ ローカルファイルシステムから CA Endevor SCM にテキスト

ファイルを追加または更新する場合、テキストファイルのデー

タは、まず LFS.Encoding スキームから Unicode 文字セットに変

換されます。その後、Encoding パラメータで定義されている

ターゲット文字セットに変換されます。

■ テキストファイルを取得する場合、データはまず、CA Endevor

SCM のコード化スキームから Unicode 文字セットに変換され

ます。その後、LFS.Encoding パラメータで指定されているター

ゲット文字セットに変換されます。

デフォルト： ISO-8859-1

重要：エレメントを DATA FORMAT=Text として CA Endevor SCM で

定義されたファイルタイプに追加または更新する場合、Web サー

ビスは LFS.Encoding パラメータと CodePage パラメータで定義され

ている文字セットを使用して、このファイルをローカルワークス

テーションのコードページからメインフレームのコードページ

に変換しようとします。ローカルコードページのすべての文字を、

ホストコードページに適切にマッピングできるとは限りません。

テキストエレメントを取得する際も、同様の注意が必要です。文

字セットの変換を必要としないファイルの場合、タイプ定義には

DATA FORMAT=Binary を指定する必要があります。

Encoding

CA Endevor SCM エレメントのコード化スキームを指定します。通

常は CodePage と同じ値です。

ContentType

CA Endevor SCM のレポートとクエリを Web サービスクライアン

トコンピュータと交換する方法を指定します。デフォルトは、Text

です。

データソース設定の内容を表示する方法


Trace

トレース対象を指定します。トレースレベルまたは文字列値を、

有効な値として指定できます。デフォルトは 0 です。

Traced

トレースするユーザ名を指定します。有効は値は以下のとおりで

す。

user-name – ユーザ名を 1 ～ 8 文字で指定します。

ALL - すべてのユーザを指定します。

データソース設定の内容を表示する方法

以下のいずれかの方法を使用して、データソース設定ファイルの内容を

表示できます。

■ getConfiguration サービスでは、Web サービスが有効な場合に、データ

ソース設定ファイルのパラメータを要求できます。このサービスは、

設定のメモリイメージ内の設定パラメータを示す XML ドキュメント

を返します。 XML ドキュメントの内容にかかわらず、常に以下の方法

を使用してディスクイメージを表示できます。

■ ディスクイメージを表示するには、Web サービスをホストしている

z/OS USS 環境の /endevor フォルダ内の設定ファイルを開きます。

STC プーリングを有効にする方法



STC プーリングを有効にするには、PoolMaxSize を 0 より大きな値に設定す

る必要があります。これによって STC が有効のままになるため、Web サー

ビスが追加の STC を生成しなくても複数の要求を渡せるようになります。

Web サービスの起動時に webapps/endevor ディレクトリにあるすべての

設定ファイル（.cfg）が取得、解析、およびメモリへロードされると際に、

プーリングに使用する制御情報を初期化するために PoolMaxSize の値が使

用されます。 PooInitSize に 0 より大きい値が設定されている場合、その数

の STC が起動時に生成されます。デフォルトでは、Tomcat を起動したユー

ザ ID とパスワード NOTREQED が STC を生成するために使用されます。

注： .cfg ファイルが解析の検証に失敗すると、メモリにロードされず、使

用できなくなります。

注： CA Endevor SCM の Web サービス要求はすべて、アクションの実行時に

要求者の ID に切り替えられます。

バージョン 16 で提供される設定ファイルには STC プールパラメータが含

まれ、デフォルト値が設定されています。提供される値は、ほとんどの

インストールに使用できます。 CA Endevor SCM 管理者は、サイトカスタ

マイズに適切であれば、特定のパフォーマンスまたはサイズの要件に対処

するために値を変更できます。提供されている値に変更を加える前に、

パラメータがどのように処理に影響するか理解しているか確認するか、CA

サポートにご相談ください。

Web サービスがアクティブな場合、パラメータ値は変更できます。最新

の値は、STC プールの動作に影響を及ぼします。動的な設定では、リソー

スはオンデマンドでサイズ変更できます。動的な設定の詳細については、

「データソースの動的な設定方法」を参照してください。

注： enws.xsd schema ファイル（USS の ¥endevor フォルダにある）で、デフォ

ルト値および最大値も指定できます。 Web サービスサーバは、このスキー

マを使用して、setConfiguration() 操作によって渡されるファイルを検証し

ません。 STC プールパラメータが含まれないバージョン 15.0 またはリ

リース 15.1 の設定ファイルを使用している場合、バージョン 16 適用さ後

の Web サービスの最初のスタートアップ中に、不足しているパラメータ

がデフォルト値で追加されます。設定ファイルの設定方法については、

「STC プーリングを有効にする方法」を参照してください。



STC プールの管理方法

Tomcat の内部（監視）スレッドが、STC プールを管理します。 PoolreapTime

パラメータは、監視スレッドが実行される間隔（たとえば、60 秒ごと）

を設定します。監視スレッドは、実行されるたびにプール内の STC のス

テータスを確認します。

STC プールは、CA Endevor SCM API を実行するバックエンド z/OS 領域への

STC 接続のグループです。以下の STC パラメータによって、プールサイズ

が決定されます。

■ PoolinitSize - STC プール内の永続 STC の数を指定します。永続 STC は、

Web サービスの開始時に作成されます。永続 STC がすべて使用中の場

合、増分 STC を作成できます。

■ PoolIncrSize - STC の不足が検出された場合に、初期プールに加えて監視

スレッドが作成できる増分 STC の数を指定します。 PoolInitSize を 0 に

設定すると、すべての STC 接続が増分プールから割り当てられます。

新しいワークロードを予想するために、監視スレッドは追加の STC 接

続を作成します。 PoolIncrSize パラメータは、スレッドが作成できる追

加の接続の数を指定します。ワークロードの減尐後、スレッドは増分

プールから余分な STC 接続を解放します。

■ PoolMaxSize - プール内の有効な永続 STC および増分 STC の最大数を指

定します。

ユーザ作成のクライアントプログラム



Web サービスを使用するクライアントプログラムは、特定のオブジェク

トをインスタンス化および生成するオブジェクト指向プログラムです。

クライアントスタブは、クライアントと Web サービスの間で渡されるパ

ラメータを変換するために必要です。

プログラム開発者は、以下の情報を収集するためにクライアントプログ

ラムを作成します。

■ 指定した CA Endevor SCM リポジトリにアクセスするためのログイン

ユーザ ID とパスワード。

■ オプションの wsParameters を持つ SCL ステートメント。

■ これが submitSCL 要求である場合は、Web サービス間でデータを転送

するために SOAP Attachment のパラメータも必要です。

プログラム開発者は、Web サービスによって発行された WSDL からクライ

アントスタブを作成して、プログラムが Web サービスの要件を満たすよ

うにします。クライアントスタブは、クライアントアプリケーションと

Web サーバの間で渡されるパラメータを変換するために使用します。ス

タブを作成した後、開発者はクライアントプログラムにインポートパッ

ケージとしてスタブを組み込みます。開発者は、クライアントスタブの

上にクライアントアプリケーションのロジックを実装します。

■ C 言語で記述されたクライアントプログラムの場合、スタブは C 言語

でコンパイルされます。生成されたヘッダファイルは、アプリケー

ションプログラムをコード化するために必要です。アプリケーション

プログラムで、C++ include wobject.h 内に #include structure.h が必要で

す。

■ Java で記述されたクライアントプログラムの場合、スタブはパッケー

ジにグループ化された Java ソースのコレクションです。このソースは、

javac コンパイラによって JAR ファイルにコンパイルされます。この

JAR ファイルはサンプルコードで必要です。プログラムのコードには、

生成されたパッケージを参照する import ステートメントが含まれて

いる必要があります（これによって、java IDE でアプリケーションプ

ログラムで使用できる Loginproperties オブジェクトを作成できるよう

になります）。クライアントプログラムは、スタブをインスタンス化

して Web サービスを呼び出すことができます。クライアントがスタ

ブにアクセスするには、クライアントアプリケーションのクラスパス

にスタブクラスが存在する必要があります。



Java クライアントプログラムは、以下のオブジェクトをインスタンス

化し、特定の要求に対する正しい値を設定します。

■ LoginProperties

■ SCL

■ Attachment

Web サービスの WSDL から作成されたクライアントスタブは、これら

のオブジェクトのインスタンス化をサポートします。これらのオブ

ジェクト内のデータは、Web サービスで必要とされます。クライアン

トプログラムは、オブジェクトに必要なパラメータを設定します。

クライアントスタブを作成する方法

ユーザ作成のクライアントプログラムが Web サービスにアクセスできる

ようにするには、クライアントアプリケーション開発者は、Web サービ

スの WSDL ファイルを使用してクライアントスタブを作成する必要があ

ります。その後、クライアント側のスタブをクライアントプログラムに

インポートパッケージとして組み込む必要があります。スタブは、SOAP

メッセージを管理、送信、および受信して、Web サービスと通信します。

■ クライアントスタブは、手動で、またはユーティリティを使用して作

成できます。 Web サービスをインストールした後、Web ブラウザを使

用して WSDL ファイルにアクセスし、XML ファイルとして保存できま

す。たとえば、WSDL2Java などのサードパーティツールがあります。

このツールは WSDL に対してクエリを実行し、アプリケーションの生

成で使用されるスタブを生成するのに使用できます。

Web サービス用の WSDL ファイルは、http://<サーバ名>:<ポート番号

>/axis2/services/EndevorService?wsdl にあります。

<サーバ名>:<ポート番号> を、Web サービスをインストールした Web

サーバの名前とポート番号で置き換えます。

■ スタブを記述または生成した後、クライアントスタブをコンパイルし

て、クライアントアプリケーションのロジックをスタブ上に実装する

必要があります。クライアントプログラムは、スタブをインスタンス

化して Web サービスを呼び出す必要があります。クライアントがス

タブにアクセスするには、クライアントアプリケーションのクラスパ

スにスタブクラスが存在する必要があります。



Java クライアントプログラムオブジェクトおよびパラメータ

Java クライアントプログラムは、以下の必須パラメータを使用して、オブ

ジェクトを生成します。

■ LoginProperties オブジェクト – 以下のパラメータが含まれます。

DataSource

クライアントがアクセスするデータソースリポジトリ（CA

Endevor SCM）を指定します。この値は、Web サービスからアクセ

ス可能な有効な設定ファイルの名前と一致している必要がありま

す。詳細については、「設定ファイルを作成する方法 (P. 254)」お

よび「データソースへのアクセスの仕組み (P. 253)」を参照してく

ださい。

UserID

CA Endevor SCM API にアクセスするためのユーザ ID を指定します。

Password

CA Endevor SCM API にアクセスするためのパスワードを指定しま

す。

■ SCL オブジェクト – 以下のパラメータが含まれます。

Statement

クライアントアプリケーションのユーザが入力した SCL ステート

メントを指定します。

getObject サービス要求では、CSV （カンマ区切り値）ユーティリ

ティの List ステートメントが必要です。 List ステートメントの詳細

については、「Utility Guide」の「Using the Comma Separated Value

(CSV) Utility」の章を参照してください。

wsParameters

（オプション）設定ファイルで指定されている wsParameters を上

書きするパラメータと値を指定します。これらのパラメータには、

Lang、TimeZone、CodePage、LSF.Encoding、Encoding、CharacterSet、

ContentType、Trace、および Tracer があります。詳細については、

設定ファイルのパラメータを参照してください。



Category

SCL 要求のタイプを指定します。要求で指定されている SCL はすべて、同じタイプである必要があります。以下に有効な値を示しま

す。

A – 環境管理アクションを指定します。

C – CSV （カンマ区切り値）ユーティリティアクションを指定しま

す。すべての Object サービス要求に必須です。

E – エレメントアクションを指定します。

P – パッケージアクションを指定します。

S – パッケージ配布アクションを指定します。

X – バッチ ACM 照合ユーティリティアクションを指定します。

L – LSF （ローカルシステムファイル）のサポートを必要とする Add、

Update、または Retrieve の各要求を指定します。これらのアクショ

ンの SCL ステートメントは、データの転送先または転送元として

ローカルクライアント上の場所を指定する To | From Attachment

節を必要とします。

注： Add、Update、または Retrieve の各リクエストが、LFS 要求

（Attachment 節付き）ではなく、To | From DSName または To | From

Path HFSFile のどちらかを使用する場合は、Category として E を使

用してください。

Timezone

クライアントアプリケーションのタイムゾーンを指定します。

Web サービスはこの値を使用して、クライアント側で正しい時刻

を決定し、メッセージで使用します。

■ Attachments オブジェクト – 以下のパラメータが含まれます。

DD

交換するデータが格納されているクライアント側のデータセット


注： base64Binary タイプの場合、データは、64Binary 変換付きでコー

ディングしてデータハンドラによって操作するか、または変換な

しでコーディングして MTOM 添付ファイルとして追加します。ク

ライアントコードは、データハンドラを使用して（64binary 変換

の場合）、またはストリーミングを利用するために MTOM 添付ファ

イルとして、DD プロパティに書き込むことが想定されます。



DDName

交換対象を示す添付ファイル名を指定します。

contentType

交換するデータ型を指定します。クライアント呼び出しの

Attachment オブジェクトによって転送されるデータのコーディン

グ方法を指定します。この値により、Web サービスに、添付ファ

イルのデータ部分のフォーマット方法を通知します。 ContentType

は、HTTP が複雑なメッセージ（添付ファイル付きメッセージなど）

の場合に使用する MIME （多目的インターネットメール拡張、

Multipurpose Internet Mail Extensions）プロトコルの標準です。

例： SubmitSCL サービス用の Java クライアントプログラム

Java クライアントプログラムは、スタブ（WSDL から生成）とランタイム

（AXIS2/Java）を呼び出します。 submitSCL サービス用の以下のサンプルプ

ログラムでは、loginProperties オブジェクト、SCL オブジェクト、および

Attachments オブジェクトをインスタンス化しています。クライアントプ

ログラムは、それらのオブジェクトに、特定のクライアント要求に必要な

値を設定します。



要求には、指定した CA Endevor SCM リポジトリにアクセスするためのロ

グインプロパティが含まれています。また、SCL ステートメントとオプ

ションパラメータ、および SCL ステートメントとデータを Web サービス

にサブミットするための SOAP Attachment も含まれています。

ユーザ作成のクライアントプログラムの有効な操作

ユーザ作成のプログラムは、Web サービスを使用してソフトウェア制御言

語（SCL）ステートメント（一部制限あり）を CA Endevor SCM API に送信し

ます。また、情報はマスタ制御ファイル、パッケージファイル、および

リポジトリオブジェクトから取得できます。詳細については、

「SubmitSCL Operation (P. 275)」および「Get ログイン情報 Operation (P.




SubmitSCL 操作

Web サービスは、submitSCL 操作をサポートします。クライアント要求は、

CA Endevor SCM の SCL （ソフトウェア制御言語）を使用して CA Endevor

SCM API と通信できます。多尐の制限はありますが、有効な SCL ステート

メントを CA Endevor SCM API に送信でき、結果がクライアントに返されま

す。これによって、リポジトリへのフルアクセスが提供されます。

重要： SCL ステートメントが終了する期間の前に、SCL 構文に 1 つ以上の空

白スペースが必要です。

Web サービスの submitSCL 操作に有効な SCL ステートメントに対して、い

くつかの制限があります。

■ 以下のアクションは、無効です。

– &&アクション

– エレメントのアーカイブ

– エレメントのコピー

– アーカイブのメンバの一覧表示

– アーカイブのメンバの印刷

– エレメントのリストア

– アーカイブへの転送

– アーカイブからの転送

– パッケージのアーカイブ

– パッケージのエクスポート



■ パラメータ DDNAME は、通常 Web サービスでサポートされません。た

だし、DDNAME C1PRINT は、List アクションと Print アクションで有効です。

注： DSName dataset-name パラメータはサポートされています。

Add、Update、および Retrieve アクションでは、DDName パラメータの

代わりに SOAP Attachment を使用して、クライアントとメインフレー

ムの間でデータを転送します。詳細については、「SCL ステートメン

トの To | From Attachment 節 (P. 276)」を参照してください。

注： CA Endevor SCM から取得したファイルには、フットプリント情報は格

納されていません。 Web サービスサーバに書き込まれる一時ファイルは、

新しいローカルファイルシステムコマンドを実行するたびに、最初に

パージされます。

SCL ステートメントの To | From Attachment 節

クライアントアプリケーションからのすべての Web サービス呼び出し

（要求）には、要求をサブミットし、応答を受信するために、SOAP

Attachment オブジェクトが必要です。要求でクライアントと Web サービ

スの間でデータを転送する場合、SCL ステートメントに From Attachment

節または To Attachment 節を記述する必要があります。この節では、クラ

イアントが送受信するファイルのクライアント側での名前と位置を指定

します。

以下の SCL 要求には、From Attachment 節が必要です。

■ エレメントアクションの Add または Update。

■ パッケージ SCL ステートメントのアップロード。

以下の SCL 要求には、To Attachment 節が必要です。

■ エレメントアクションの Retrieve

■ レポートのフェッチ

■ CSV （カンマ区切り値）データの抽出



To | From Attachment の構文

Add、Update、または Retrieve アクションの SCL ステートメントでは、TO |

FROM DDNAME 節の代わりに以下の構文を使用します。

TO|FROM ATTachment attachment-name PATH mypath LFSFILE myfile

To Attachment attachment-name

CA Endevor SCM からクライアントに送信されるデータを保持する

SOAP Attachment オブジェクトの名前を指定します。

From Attachment attachment-name

クライアントから CA Endevor SCM に送信されるデータを保持する

SOAP Attachment オブジェクトの名前を指定します。

PATH mypath

クライアント側のディレクトリを指定します。 From Attachment 節の

場合、Path はソースファイルが存在する場所です。 To Attachment 節

の場合、Path はファイルの保存先です。

LFSFILE myfile

クライアント側のディレクトリにあるファイルの名前を指定します。

From Attachment 節の場合、Lfsfile はソースファイルの名前です。 To

Attachment 節の場合、Lfsfile は受信したファイルを保存する際に付け

られる名前です。

例： Attachment を使用する Add Element ステートメント

以下の Add Element ステートメントは、エレメント CCIDRPT2 を DEV 環

境、EABASE システム、UTILITY サブシステム、COBOL タイプライブラ

リのステージ 1 に追加します。 SOAP Attachment オブジェクト

UPLOADD には、クライアント側の myPath にある myfile の内容のコピーが格納されます。このステートメントは、SOAP Attachment の内

容を CA Endevor SCM に追加します。オプションの Options 節は、コメ

ント「Project myfile」をエレメントに関連付けます。

ADD ELEMENT CCIDRPT2

FROM ATTACHMENT UPLOADDD PATH myPath LFSFILE myFile

TO ENV DEV SYS EABASE SUB UTILITY TYPE COBOL STAGE NUMBER 1

OPTIONS UPD COMMENT 'Project myFile' .



例： Attachment を使用する Retrieve Element ステートメント

以下の Retrieve Element ステートメントは、エレメント CCIDRPT5 を

DEV 環境、EABASE システム、UTILITY サブシステム、COBOL タイプラ

イブラリのステージ 1 から取得します。エレメント CCIDRPT5 のコ

ピーが SOAP Attachment オブジェクト DNLOADD に追加されます。 Web

サービスは、クライアントに SOAP メッセージ応答を返信します。こ

の SOAP メッセージには Attachment が格納されています。クライアン

トは Attachment からデータを抽出し、クライアント側の myPath にあ

る myPath にコピーします。

RETRIEVE ELEMENT CCIDRPT5

FROM ENV DEV SYS EABASE SUB UTILITY TYPE COBOL STAGE NUMBER 1

TO ATTACHMENT DNLOADDD PATH myPath LFSFILE myFile .

getログイン情報操作

Web サービスは、情報をオブジェクトの形式で抽出するさまざまな get ロ

グイン情報サービスをサポートしています。情報は、マスタ制御ファイ

ル、パッケージファイル、またはリポジトリオブジェクトから取得でき

ます。 get ログイン情報サービスは、CSV LIST 要求をベースとしています。

SOAP のネイティブの機能を使用して、送信するオブジェクトを作成し、

返された CSV 出力をデコードします。

get ログイン情報サービスは、submitSCL サービスと同様に設計されてい

ます。各 get ログイン情報サービスは、特定のタイプの情報を取得しま

す。サービス名のログイン情報の部分は、サービスで取得できる情報の

タイプを示します。各 get ログイン情報サービスには、要求した情報を

抽出するよう適切にコード化した対応する SCL ステートメントが必要で

す。各 get ログイン情報サービスは、SCL ステートメントで指定された CSV

（カンマ区切り値）ユーティリティによって抽出された情報で設計された

オブジェクトを返します。抽出された情報は XML 形式に変換され、クラ

イアントに返されます。

オブジェクト指向プログラミングの観点から、get ログイン情報サービス

は Object[] で指定された配列を返します、この配列の各エントリには、取

得したオブジェクトが 1 つ含まれます。また、オブジェクトには要求され

た情報が含まれます。



各 get ログイン情報サービスで返されるプロパティ名については、WSDL

ファイルを参照してください。 List ステートメントおよび対応して返され

るプロパティ名と値の詳細については、「Utilities Guide」の「Using the

Comma Separated Values Utility」の章を参照してください。ログイン情報は

CSV 表現から作成されます。それらのプロパティは、CSV レイアウトでマッ

プされます。プロパティ名は、WSDL ファイルで記述されているように CSV

の列に 1 つずつ対応します。

返されるプロパティ名および値は、CSV ユーティリティによって返される

ものと同じです。ただし、オブジェクト（CSV 要求の出力ではなく）の場

合は、プロパティが文字列、整数、または日付として入力されます。 WSDL

は、各プロパティのタイプを定義します。日付およびタイムスタンプは、

z/OS のタイムゾーンを使用してコード化された CA Endevor SCM のスタン

プの外部表現です。

注： Web サービスコンポーネントの詳細については、「シナリオガイド」

の「Web サービス」の章を参照してください。これと同じ内容が、「Web

サービスを有効にする方法」というシナリオにも記載されています。これ

には、マニュアル選択メニューの「ナレッジベースの記事」セクション

からアクセスできます。

SCL ステートメントのための getログイン情報構文

各 get ログイン情報サービスには、特定のタイプの SCL ステートメントが

必要です。これらの SCL ステートメントは CSV ユーティリティで使用され

るものと同じです。サービス要求に正しくない SCL ステートメントまたは

get ログイン情報に対応しない SCL ステートメントが含まれていると、要

求は拒否されます。各サービスに使用できるオプションの詳細について

は、「Utilities Guide」の「Comma Separated Values」の章で、対応する List

ステートメントの構文を参照してください。たとえば、getElementBasic 操

作のための SCL ステートメントでコード化できるすべてのオプションの

節およびパラメータについては、「Utilities Guide」の「List Element Function」


重要： SCL ステートメントが終了する期間の前に、SCL 構文に 1 つ以上の空

白スペースが必要です。



以下の get ログイン情報サービスがサポートされています。最低限必要

な SCL 構文を各操作の次に示します。

getApproverGroup

LISt APProver GROup approver-group-name

getApproverGroupJunction

LISt APProve GROut JUNction FROm options

getConfiguration

LISt CONFIguration

getConfigurations

LISt CONFigurations

getDataSet

LISt DSName FROm options

getDestination

LISt DEStination destination-id

getElementBasic

LISt ELEment element-name FROm options DATa BASic

getElementDetail

LISt ELEment element-name FROm options DATa ALL

getElementSummary

LISt ELEment element-name FROm options DATa SUMmary

getEnvironment

LISt ENVironment environment-name

getPackage

LISt PACkage package-id

getPackageActionSummary

LISt PACkage ACTion FROm PACkage package-id

getPackageApproverGroup

LISt PACkage APProver GROup FROm PACkage package-id

getPackageSCL

LISt PACkage SCL FROm PACkage package-id



getPackageShip

LISt PACkage SHIp FROm PACkage package-id

getProcessorGroup

LISt PROcessor GROup processor-group-name

getSystem

LISt SYStem system-name

getSubSystem

LISt SUBsystem subsystem-name

getStage

LISt STAge stage-id

getType

LISt TYPe type-name

getログイン情報サービスが機能する仕組み

Web サービスでは、情報の配列を抽出するさまざまな get ログイン情報

サービスをサポートしています。情報は、SCL ステートメントの List によっ

て抽出された CSV の行のオブジェクト指向プログラミングオブジェクト

表現として返されます。この配列を取得するには、スタブ（WSDL から生

成）およびランタイム（AXIS2/Java）を呼び出す Java クライアントプログ

ラムを作成する必要があります。

get ログイン情報サービスのプログラムのロジックおよびコーディング

スタイルは、submitSCL() サービスに似ています。このプログラムには以

下の機能が含まれます。

■ loginProperties オブジェクトおよび SCL オブジェクトの初期化、一時的

な情報の入力

■ 名前による Web サービスの呼び出し

■ 特定のオブジェクトの配列および API レポートを含む添付ファイルと

して結果を取得



例： getType サービス用の Java クライアントプログラム

以下に、getType サービスの Java プログラムの例を示します。


第 7 章：ベストプラクティス実装

ここでは、CA Endevor SCM 管理者がベストプラクティス実装（BPI）方法

を使用して製品の完全な実装をセットアップする方法を説明します。 BPI

は、アクティブなソフトウェア開発のベストプラクティスライフサイク

ルを定義します。 BPI プロセスは、必要なファイルをすべて割り当てて、

製品を使用するために必要な定義をすべてセットアップします。これは、

構成および実行する入力テーブルとジョブのセットとして配布されます。

BPI を完了すると、ソフトウェア開発ライフサイクルをサポートする CA

Endevor SCM インベントリ構造にソースコードをロードすることができ

ます。


ベストプラクティス実装を実行する方法 (P. 284)

ベストプラクティス実装を実行する方法



変更マネージャ（CA Endevor SCM 管理者）は、ベストプラクティス実装

（BPI）を使用してベストプラクティスを組み込む CA Endevor SCM の完全

な実装をセットアップできます。この方法を使用すると、ソフトウェア

開発ライフサイクルをサポートするライブラリを、容易かつ迅速に割り当

ておよび生成できます。 BPI は、ユーザが設定および実行する入力テーブ

ルとジョブのセットとして配布されます。

以下の図は、ベストプラクティス実装プロセスの概要を示しています。



ベストプラクティス実装（BPI）には、以下のような手順があります。

1. 前提条件を確認します。 (P. 286)

2. 実装計画を作成します。 (P. 288)

3. BPISTART を実行します。 (P. 306) このジョブは、BPI ライブラリを割

り当てます。

4. BPI 入力テーブルをカスタマイズします。 (P. 307)

5. #JOBCARD を編集し、BPI ジョブカードを準備します。 (P. 319)

6. #OPTION を編集します。 (P. 320) このメンバは、BPI モデルおよび REXX

メンバで定義されている変数の解決に使用されるシンボルの値を定義

します。

7. BPI ジョブをサブミットします。 (P. 321) BPI プロセスを繰り返し実行

して、一度に 1 つのシステムまたはアプリケーションを実装すること

をお勧めします。

8. 実装を確認します。実装にアクセスし、正常に作成およびセットアッ

プされていることを確認します。

9. ソフトウェアインベントリをロードします。インベントリをロードす

る前に、BPI のセットアップを完了しておくことをお勧めします。

BPI プロセスを繰り返し実行することをお勧めします。最初に、1 つのシ

ステム（またはアプリケーション）を実装します。これにより、入力テー

ブルの編集方法、およびジョブの動作方法を理解することができます。次

に、BPI を実行してアプリケーション全体を実装できます。（アプリケー

ションは、複数のシステムおよびサブシステムで構成できます。）その後、

アプリケーションを追加するごとに繰り返し実行します。最初に、すべ

ての手順を実行します。その後の繰り返しで、BPI 入力テーブルを再編集

し、#5ALLOC から始まる一連のジョブを再実行します。手順を繰り返し実

行する詳細については、「BPI プロセスの繰り返し (P. 323)」を参照してく

ださい。




ベストプラクティス実装（BPI）を行う前に、以下の前提条件が満たされ

ていることを確認します。

CA Endevor SCM がサイトに正しくインストールされていることを確認し

ます。インストール手順の詳細については、「インストールガイド」の

「概要」の章にある「システムプログラマのインストールタスク」を参

照してください。インストールを正しく行うには、以下の要件がありま

す。

■ 製品のライセンスと許可のため、CA Common Services の CA LMP および

CAIRIM の各コンポーネントをインストールしてカスタマイズします。

注： CAIENF および CAICCI の各コンポーネントは、BPI には必要ありませ

ん。ただし、これらのコンポーネントは、CA Endevor SCM で並行アク

ション処理機能、Web サービスコンポーネント、または関連製品の CA

CMEW を使用する場合に必要です。 CAIENF および CAICCI は、BPI の終

了後に設定できます。

■ NDVRC1 を許可する必要があります。

■ BC1JJB03 が実行済みである必要があります。

■ iprfx.iqual.CSIQAUTH と iprfx.iqual.CSIQAUTU （およびオプションで

iprfx.iqual.CSIQLOAD）に含まれるロードモジュールは、システムによ

り許可されたライブラリ内に存在する必要があります。ロードモ

ジュールがシステムに許可されたライブラリ内にあることを確認する

には、以下のいずれかの方法を使用できます。

– iprfx.iqual.CSIQAUTH ライブラリと iprfx.iqual.CSIQAUTU ライブラリ

のメンバを既存の許可ライブラリにコピーします。

– iprfx.iqual.CSIQAUTH と iprfx.iqual.CSIQAUTU を許可します。

– iprfx.iqual.CSIQAUTH と iprfx.iqual.CSIQAUTU （およびオプションで

iprfx.iqual.CSIQLOAD）のメンバを既存の LINKLIST 許可ライブラリに

コピーします。


iprfx.iqual.CSIQLOAD）のメンバを既存の LPA ライブラリにコピーし

ます。


iprfx.iqual.CSIQLOAD）の各データセット自体を LINKLIST ライブラリ

または LPA ライブラリとして定義します。

■ CA Endevor SCM を ISPF 環境に定義します。



■ サイトに複数の CPU があり、DASD を共有している場合は、キュー名

を定義する必要があります。 Unicenter CA-MIM Resource Sharing または

IBM Global Resource Serialization （GRS）を使用している場合は、適切な

グローバルリソースキュー名テーブルにキュー名を含めます。

■ サイトで使用しているセキュリティソフトウェアが CA ACF2 である

場合は、TSO コマンド限定機能を変更して、ISPTLIB コマンド（ACMQ、

BC1PACMI、ESORT、EONLY、EM、QM など）を許可します。

以下の BPI のインストールに関する注意事項は、サイトでの CA Endevor

SCM の構成に応じて適用されます。

■ ベストプラクティス実装は、サイトで以下の製品オプションがライセ

ンスされていることを前提としています。

– CA Endevor Extended Processors

– CA Endevor Automated Configuration

■ 「インストールガイド」の「製品の設定」の章で説明されている手順

はすべて実行する必要があります。「製品の設定」の章の手順には、

以下の例外があります。

– LINKLIST ライブラリまたは LPA ライブラリを CSIQAUTH/CSIQAUTU

データセットに使用する場合は、BPI プロセスによって作成された

ジョブを調整してからサブミットする必要があります。ジョブを

サブミットする前に、BPILIB ライブラリで作成されたジョブメン

バから STEPLIB DD ステートメントを削除するかコメント化します。

– LINKLIST ライブラリまたは LPA ライブラリを CSIQLOAD データ

セットに使用する場合は、BPI プロセスによって作成されたジョブ

を調整してからサブミットする必要があります。ジョブをサブ

ミットする前に、BPILIB ライブラリで作成されたジョブメンバか

ら STEPLIB ステートメントと CONLIB DD ステートメントを削除す

るかコメント化します。



BPI を実行するには、以下のメインフレーム環境に関する一般知識と、CA

Endevor SCM の基本的な理解が必要です。

■ メインフレーム環境、z/OS メインフレームオペレーティングシステム、

TSO （タイムシェアリングオプション）機能、および ISPF （Interactive

System Productivity Facility）に関する実用的な知識。

■ CA Endevor SCM の基本的な概念を理解していること。詳細については、

「インストールガイド」および「実装ガイド」を参照してください。

■ ベストプラクティス実装の概念を理解していること。 BPI の概念の詳

細については、「BPI ソフトウェアインベントリのライフサイクル (P.


注：このガイドで使用されている用語の詳細については、「User Guide」の

「Glossary」を参照してください。

本番環境の実装計画

ベストプラクティス実装（BPI）プロセスを実行するには、CA Endevor SCM

をどのように構成するかを決定する必要があります。 BPI は「ベストプラ

クティス」や推奨する設定をプロセスに自動的に取り入れることにより、

それらの決定の一部を自動化します。 BPI プロセスを実行する場合には、

作成される実装の種類を理解することが重要です。このセクションでは、

これらの各ベストプラクティスについて詳しく説明します。



BPI ソフトウェアインベントリのライフサイクル

ベストプラクティス実装では、デフォルトで 7 つの環境マッピング構造を

設定します。この構造には、開発（DEV）、品質保証（QAS）、本番（PRD）、

緊急（EMER）、未使用（UNCLMED）、アーカイブ（ARCHIVE）、および管

理者（ADMIN）の各環境が含まれます。サイトでは 7 つの環境がすべて必

要になるとは限りません。また、8 つ以上の環境が必要になる場合もあり

ます。ただし、これはほとんどのサイトにとって適切とされる有効な開

発ライフサイクルを表しています。

ライフサイクルでは、一連のデータセットライブラリによってソフト

ウェアインベントリの状態の遷移を定義します。これらのライフサイク

ルは、デフォルトテーブル（C1DEFLTS）で定義されています。データセッ

トの命名規則はライフサイクル構造に対応しています。ベストプラク

ティス実装では、以下のライフサイクルまたはマップを設定します。

■ 標準マップ - 通常の開発アクティビティ用。ほとんどのアクティビ

ティが標準マップで実行されます。標準マップは、エントリステージ

であるステージ 1 の DEV 環境から始まります。ソースは、DEV ステー

ジ 1、DEV ステージ 2、QAS ステージ 2、PRD ステージ 2 の順にプロモー

トされます。品質保証環境および本番環境のステージ 1 はスキップさ

れます。 DEV ステージ 2 は QAS ステージ 2 にマップされ、QAS ステー

ジ 2 は PRD ステージ 2 にマップされます。

■ 緊急マップ - 緊急の修正用。緊急環境も PRD ステージ 2 にマップされ

ます。

■ 未使用マップ - 未使用または未分類のエレメント用。未使用環境のエ

ントリステージはステージ 2 です。この環境は、ほかの環境にマップ

されません。

■ アーカイブマップ - アーカイブ環境用。アーカイブ環境のエントリス

テージはステージ 2 です。この環境は、ほかの環境にマップされませ

ん。

■ 管理者マップ - CA Endevor SCM 管理者アクティビティ用。管理者環境

のエントリステージはステージ 1 です。この環境は、ほかの環境に

マップされません。

以下の図は、BPI 環境がどのようにマップされるかを示しています。



BPI 環境およびステージ

各ライフサイクルは、ソフトウェアインベントリの環境およびステージ

の状態の遷移をライフサイクルの終了まで定義します。各環境には 2 つの

ステージがあり、環境の各ステージはライブラリレベルを表します。こ

の構造をサポートするために、データセットの命名規則では、各環境お

よび各ステージを識別するために修飾子を使用します。各環境の詳細に

ついて説明します。

■ 開発（DEV）環境 - この環境には 2 つのステージがあり、これによって

2 つのバージョンのエレメントを保持することができます。ステージ

2 を完全と見なすエレメントの場所または確認済みの変更を一時的に

保持する場所として使用し、ステージ 1 ではエレメントを再編集する

ことができます。またステージ 2 は、変更を QAS または PRD にプロ

モートされた変更とマージする場所としても使用できます。開発ス

テージが 2 つあることのもう 1 つの利点は、ステージ 1 とステージ 2

で異なるコンパイラパラメータを使用してテストできることです。た

とえば、ステージ 1 にテスト用のコンパイルオプションを設定し、ス

テージ 2 に本番用のコンパイルオプションを設定することができま

す。ライフサイクルの次の段階に移る前のコンパイルは、必ず DEV ス

テージ 2 で実行します。



■ 品質保証（QAS）環境 - この環境は、さまざまなタイプのテストを実行

するために使用します。ステージ 1 は一般的な統合ステージです。こ

れは便利ですが、本番環境までにエレメントが通過しなければならな

いステージの数を減らすために、QAS 環境のステージ 1 は BPI で提供

されるライフサイクルでは使用しません。ステージ 2 はアプリケー

ションがシステムテスト済みであり、本番環境で使用する準備ができ

ていることを確認するために使用します。

■ 本番（PRD）環境 - この環境は本番コードを表します。 PRD 環境のス

テージ 1 は BPI で提供されるライフサイクルでは使用しません。ス

テージ 2 は本番ソースのストレージに使用します。 PRD 環境は保護さ

れているパッケージである必要があります。

■ 未使用（UNCLMED）環境 - この環境は、標準のインベントリ構造（シ

ステム、サブシステムなど）で分類できなかったエレメントを格納す

るために使用します。この環境では、ステージ 2 のみを使用します。

この環境は、使用法および用途が不明なエレメントを保持する領域と

して用意されています。これは、ほかのソース管理アプリケーション

から CA Endevor SCM に切り替える場合に、変換の際によく見られる状

況です。 UNCLMED 環境ではソースのみを格納し、システムおよびサ

ブシステムは 1 つだけです。これは、実装（または変換）プロセス中

にシステムで識別されないエレメントを一時的に保持する場所として

使用されます。 CA Endevor SCM の実装が完了した後にエレメントが見

つからない場合、エレメントがあるかどうかを確認するために

UNCLMED 環境内を検索できます。その後、そのエレメントを UNCLMED

から適切なシステムおよびサブシステムに移すことができます。

UNCLMED 内のエレメントが識別され、正しいシステムおよびサブシス

テムへ転送された後は、UNCLMED 内のバージョンを削除する必要があ

ります。最終的な目標は、UNCLMED 環境を使用しないことです。



■ 管理者（ADMIN）環境 - この環境は、DEV、QAS、PRD ライフサイクル

とは分離されており、CA Endevor SCM 管理者ロール用に予約されてい

ます。 CA Endevor SCM 管理者には、開発およびテストチームとは異な

るセキュリティ要件があります。管理者ロール用の個別のセキュリ

ティルールは、個別の ADMIN 環境で管理するほうが簡単です。 ADMIN

環境のデータセットは異なる高レベル修飾子から始まりますが、残り

の環境（DEV、QAS、PRD、EMER、UNCLMED、および ARCHIVE）はすべ

てアプリケーションの高レベル修飾子を使用します。 ADMIN 環境のス

テージ 2 では、サイトのインフラストラクチャおよびデフォルトオプ

ションを定義するために使用される CA Endevor SCM 構成テーブル、お

よび標準の DEV、QAS、PRD ライフサイクルで各システムのすべてのエ

レメントを処理するために使用される Endevor プロセッサをホストし

ます。 ADMIN 環境のステージ 1 では、ADMIN 環境で保持されている

テーブルまたはプロセッサを管理者が必要に応じて変更するための領

域が提供されます。ステージ 2 では、CA Endevor SCM 管理者に固有の

エレメントのみが格納されます。その後、サイトではパッケージを使

用してステージ 1 からステージ 2 にそれらの変更をプロモートでき、

必要に応じてバックアウトが可能になります。

■ 緊急（EMER）環境 - この環境も標準のライフサイクルからは分離され

ています。この環境は、すぐに対応する必要のあるコード修正に使用

されます。 EMER 環境のステージ 1 では、コードの変更を行います。

EMER のステージ 2 はパッケージで保護されており、本番 JCL の

STEPLIB 連結に含まれている必要があります。ステージ 1 からステージ

2 にエレメントをプロモートするには、緊急パッケージを作成する必

要があります。承認者グループで割り当てられた承認者によって承認

を行う必要があります。緊急承認者グループには、緊急パッケージを

承認する権限を与える必要があります。これは承認されていない変更

が、本番環境に反映されないようにするために必要です。 EMER は、

プログラムやコンポーネントに対する変更を容易にするために PRD

環境にマップされます。 EMER のステージ 2 にプロモートされた緊急

変更は、本番環境に永続的に移動される前に、（TRANSFER アクション

により） DEV 環境に転送され、通常のライフサイクルおよびテスト手

順によってプロモートされる可能性があります。 EMER 環境には、PRD

環境と同じタイプ、システム、およびサブシステムが含まれます。緊

急変更を反映するには、EMER のステージ 2 の loadlib を本番ステージ 2

の loadlib の前に連結する必要があります。



■ アーカイブ（ARCHIVE）環境 - この環境は PRD 環境から削除されるエレ

メントを格納するために使用されますが、サイトでは監査または履歴

目的でそのコピーを保持します。 ARCHIVE 環境では、2 番目のステー

ジ（ステージ 2）のみが使用されます。エレメントは、TRANSFER アク

ションまたは TRANSFER アクション SCL を使用した PACKAGE を介して

転送される必要があります。これはスタンドアロン環境です。 ARCHIVE

環境には、PRD 環境のすべてのタイプ、システム、およびサブシステ

ムが含まれます。

ステージ名、番号、ID

ステージ名、番号、および ID を定義する場合、単純なパターンを確立す

るのが最適です。環境にはそれぞれ 2 つのステージが含まれ（両方のス

テージを使用するかどうかにかかわらず）、そのステージ番号は 1 および

2 です。 BPI では、ステージ ID はステージ番号と同じで、ステージ名は記

憶しやすい命名規則を使用して作成されます。環境名が 8 文字未満である

限り、ステージ名は環境名とステージ ID （番号）の組み合わせにするこ

とができます。



データセットの命名規則

CA Endevor SCM の各種コンポーネント内に標準的な命名規則があること

は、製品のサポートをより容易にします。ベストプラクティス実装（BPI）

メソッドには、標準データセットの命名規則が含まれます。

以前は、CA Endevor SCM はデータセットの命名に高レベル修飾子と第 2 レ

ベルの修飾子の 2 つのセットを使用していました（iprfx.iqual および

uprfx.uqual）。最初のセットは、CA Endevor SCM インストールランタイム

データセット用に予約されています。これらのデータセットは、インス

トール処理（ジョブ BC1JJB03）中に入力を促されます。 2 番目のセットは、

作成されるすべての CA Endevor SCM データセット（エレメントカタログ、

MCF、パッケージファイル、ベースおよびデルタファイル、プロセッサ

出力ライブラリなど）のプレフィクスとして使用されました。

現在は、BPI を使用して CA Endevor SCM を設定する際に、CA Endevor SCM

データセットの 4 つの高レベル修飾子を指定する必要があります。イン

ストールランタイム修飾子（iprfx.iqual）は同じままです。残りの 3 つの

高レベル修飾子は、BPI Option メンバで指定されます。これらの複数の高

レベル修飾子があることで、セキュリティルールの確立および保守、デー

タセット間の相違の視覚的な提示などの管理者の作業がより簡単になり

ます。これらの 3 つのプレフィクスを以下に示します。

■ CA Endevor SCM のサイト全体に渡るすべてのデータセット用の

SiteHighLevelQual。これには、エレメントカタログおよびインデック

ス、ACM ルートおよび相互参照ファイル、およびマスタ制御ファイル

などが含まれます。

■ すべての CA Endevor SCM ADMIN 環境データセット用の

AdminHighLevelQual。これには、ADMIN 環境用のすべての割り当てな

どが含まれます。

■ すべての CA Endevor SCM アプリケーションデータセット用の

ApplHighLevelQual。これには、標準的なアプリケーションシステム、

サブシステムおよびタイプの組み合わせのそれぞれに対するベースお

よびデルタファイルが含まれます。



データセット名の最大サイズは 44 文字を超えることができません。した

がって、3 つの高レベル修飾子に許可されている最大サイズはシステムお

よびサブシステムの名前に依存します。各高レベル修飾子内で複数の

ノードを使用できます。ノードの数は重要ではありません。ただし、CA

Endevor SCM データセット名は以下のような標準形式を使用します。許可

される最大文字数はかっこ内に表示されます。システム（8）、サブシス

テム（8）、環境名のサブセット（8）、ステージ番号（1）およびタイプ

（8）。この標準形式を使用し、システム、サブシステムなどに対して文

字の最大数を使用する場合、高レベル修飾子用に 12 文字のみが残されま

す。可能であれば、プレフィクスノードを 12 文字以下にすることをお勧

めします。これは、将来、追加のシステム、サブシステムおよびタイプ

が作成される場合に、データセット長の問題が発生するのを回避するた

めです。

データセットルール

BPI 用のデータセットを割り当てる場合、以下のルールに従います。

■ 環境、システム、サブシステム、ステージ、タイプごとに 1 つのベー

スライブラリ。。

■ タイプ名はデータセット名の最後のノードで、言語を示します。

■ ベースライブラリは PDSE として定義します。

■ 環境、システム、サブシステムごとに 1 つのデルタライブラリ。

■ 高レベル修飾子のみを指定します。最後の修飾子は BPI によって提供

されます。プロセッサでもこの命名規則を使用します。

■ ほとんどのタイプに、リバースデルタ形式を使用します。タイプに

よっては、フルイメージデルタ形式またはログデルタ形式が適して

います。

一元化されたプロセッサ

ベストプラクティス実装では、各システムに独自またはカスタムのプロ

セッサを定義および格納するのではなく、プロセッサ用に単一のリポジト

リの場所を設定します。プロセッサをまとめて保持する方が簡単で、シ

ステム全体の整合性も確保されます。

BPI プロセスでは、すべてのプロセッサを管理者（ADMIN）環境に格納し

ます。



インベントリ構造

CA Endevor SCM のインベントリ構造では、以下を実行できます。

■ 物理的なロケーションやコンパイル方法を知ることなく、プログラム

モジュールを操作する。

■ タイプに関係なく、アプリケーションを構成するすべてのプログラム

コンポーネントをリストする。

■ 表示画面にエレメント名を入力するだけで、エレメントのロケーショ

ンを決定する。

■ プログラムインベントリを断面的に操作する。たとえば、CA Endevor

SCM では、1 つのコマンドでショップ内のすべての COBOL コードのリ

ストを作成したり、給与アプリケーションの新リリース全体をプロ

モートすることができます。

BPI には、事前定義済みのインベントリ構造が含まれています。構造（環

境、システム、サブシステム、タイプなど）の概要は、テーブルファイ

ルメンバ内で説明されています。

BPI は、インベントリ構造コンポーネントの以下のデフォルト定義を提供

します。

環境

デフォルトの環境名は、BPI 入力テーブル T#ENVMTS で配布されます。各

データ行は、環境名およびステージ情報で構成されます。

注： BPILIB にある BPI REXX メンバ O#ENVMTS は、T#ENVMTS と常に同期し

ている必要があります。

これらのテーブル内の行は、ソフトウェア変更ライフサイクル（C1DEFLTS

テーブルで設定）、CA Endevor SCM 構成テーブル、および SCL メンバを作

成するために使用されます。作成する環境、環境のステージ名、および

環境のエントリステージを指定しますまた、マップ方法（次にマップす

る環境および次にマップする環境のステージ）を指定します。



システム

デフォルトのシステム名は、T#ADMSYS および T#SYSTMS メンバで配布さ

れます。各データ行は、システム名および説明で構成されます。 T#ADMSYS

は ADMIN 環境のみに使用されます。配布される ADMIN 環境には、1 つの

システムおよびサブシステムが含まれます。管理者環境を維持する必要

があります。 BPI はデフォルトで、残りのアプリケーションシステムが使

用するすべての CA Endevor SCM プロセッサおよび構成テーブルのメイン

リポジトリとして、T#ADMSUB で指定された最初の ADMIN システムを作

成します。プロセッサアウトプットライブラリのシステム名は、デフォ

ルトで T#ADMSYS で指定された最初のシステムになります。 T#ADMSYS

テーブルに行を追加することにより、ADMIN 環境にシステムを追加できま

す。

T#SYSTMS テーブルは、管理者環境および未使用環境を除き、T#ENVMTS

テーブルで定義されたすべての環境によって使用されます。これには、

配布されたテーブル内の開発、品質保証、本番、緊急、およびアーカイブ

環境が含まれます。

T#SYSTMS テーブルは T#SUBSYS テーブルと関連しています。 T#SYSTMS

テーブルでシステム行を追加または削除する場合は、T#SUBSYS テーブル

の関連する行を追加または削除する必要があります。

BPI で配布されるシステム定義のデフォルトを以下に示します。

■ 次のシステム - デフォルトで現在のシステム

■ コメントは必須

■ CCID は必須

■ 重複エレメントチェックは非アクティブ

■ 重複プロセッサアウトプットチェックはアクティブ - 重大度レベル

は「E」

■ エレメントジャンプの確認は必須

■ サインアウトはアクティブ

■ サインアウトデータセット検証は非アクティブ



サブシステム

デフォルトのサブシステム名は、T#ADMSUB および T#SUBSYS メンバで配

布されます。各行は、システム名、サブシステム名、および説明で構成

されます。 T#SUBSYS で指定されたシステムは、T#SYSTMS で指定されたシ

ステムと一致する必要があります。 T#ADMSUB で指定されたシステムは、

T#ADMSYS で指定されたシステムと一致する必要があります。

配布されるサブシステム定義は、次のサブシステムがデフォルトで現在の

サブシステムになることを指定します。



タイプ

デフォルトのタイプ名は、T#ADMTYP および T#TYPES メンバで配布されま

す。 T#ADMTYP メンバは管理者環境のタイプを定義するために使用されま

す。また、T#TYPES メンバは、開発、品質保証、本番、緊急、未使用、お

よびアーカイブ環境のタイプを定義するために使用されます。これらの

メンバの各行のデータの長さは、200 文字です。各行は、タイプ名、プロ

セッサグループ名、GENERATE、MOVE、および DELETE プロセッサ名、前

景許可フラグ、言語、Panvalet および Librarian ソース言語、比較 FROM お

よび比較 TO 列、エレメントのデルタ形式、およびタイプおよびプロセッ

サグループの説明から構成されます。タイプが BPI プロセス中に定義され

ると、各タイプに対してリストされた最初のプロセッサグループがデ

フォルトのプロセッサグループになります。

注： BPI プロセスが実行され、サイトで拡張プロセッサオプションを購入

していない場合、DEFINE TYPE PROCESS アクションが実行された時点で実

装は失敗します CA Endevor SCM が C1DEFLTS 構成テーブルの PROC パラ

メータ値に対してチェックを行い、このオプションがアクティブでないと

判断した場合、このアクションを実行するとリターンコード 12 が返され

ます。

BPI で配布されるタイプ定義のデフォルトを以下に示します。

■ インクルードを拡張しない

■ エレメントのデルタ形式はリバース

■ ベースを圧縮しない

■ リグレッションのしきい値は 80

■ リグレッションの重大度は注意

■ エレメントレベルを統合しない

■ レベル 96 でエレメントを統合

■ 統合するエレメントレベルの数は 0

■ コンポーネントレベルを統合しない

■ レベル 96 でコンポーネントを統合

■ コンポーネントのデルタ形式はリバース

■ 統合するコンポーネントレベルの数は 0

■ HFS Recfm NL



注： REGRESSION% のしきい値は、0 に設定されるログデルタ形式またはイ

メージデルタ形式を除いて、80 に自動的に設定されます。

プロセッサグループ

プロセッサグループおよびプロセッサ名は、タイプ属性と共に T#ADMTYP

および T#TYPES メンバに含まれています。

タイプ PROCESS によって使用される特殊な Endevor プロセッサグループ

には、例外的な命名基準が適用されます。このプロセッサグループの名

前は PROCESS です。

BPI で配布されるプロセッサグループ定義のデフォルトを以下に示しま

す。

■ MOVE アクションは MOVE プロセッサを使用

– 環境のエントリステージがステージ 1 の場合、GENERATE プロセッ

サを使用します。本番環境は常に MOVE プロセッサを使用します。

■ TRANSFER アクションは MOVE プロセッサを使用

■ 前景の実行を許可または禁止

– 許可または禁止は、T#ADMTYP および T#TYPES テーブルで指定され

ます。未使用およびアーカイブ環境は許可をすべてのタイプに使

用します。

■ プロセッサアウトプットタイプ

■ GENERATE/MOVE/DELETE プロセッサ

– プロセッサ名は、常に Endevor プロセッサ名を使用するタイプ

PROCESS を除いて、T#TYPES テーブルから取得されます。未使用お

よびアーカイブ環境は、すべてのタイプに対してプロセッサ値を

すべて *NOPROC* に設定します。



プロセッサシンボル

プロセッサグループシンボルのオーバーライドは、CSIQSAMP で配布され

た BPI プロセッサと一致するように #3ADMIN および #9DEFGRP で作成さ

れます。 #3ADMIN JCL には、管理者環境に対して作成する必要があるシン

ボルを定義する 2 つのテーブルがあります。標準環境は T#SYMBLS テーブ

ルを使用します。プロセッサシンボルは長さ 8 文字です。また、オーバー

ライド値は最大 65 文字です。 1 つのプロセッサが複数のプロセッサグ

ループで共有されるため、配布時にはプロセッサシンボルのオーバーラ

イドが必要です。 #3ADMIN または T#SYMBLS を編集することにより、配

布されたプロセッサシンボル定義に対して変更または追加を行えます。

BPI で配布されるプロセッサシンボル定義のデフォルトを以下に示しま

す。

プロセッサシンボル定義のデフォルト

BPI で配布されるプロセッサシンボル定義のデフォルトを以下に示します。

記号オーバーライ

ド

ロケーションテーブル

HLQ &#HLQADM 管理者環境、すべてのシステムおよびプロセッサ

グループ（GEN および MOVE）

#3ADMIN

XSYSLIB1 &C1MACLIB 管理者環境、すべてのシステム、タイプ TABLE、

procgrp ASMTBL、ステージ 1 および 2 （GEN のみ）

#3ADMIN

LOADLIB &CSIQAUTU 管理者環境、すべてのシステム、タイプ TABLE、

procgrp ASMTBL、ステージ 2 （GEN のみ）

#3ADMIN

LOADLIB &CSIQAUTU 管理者環境、すべてのシステム、タイプ ASMPGM

および COBOL、procgrp USEREXIT、ステージ 2 （GEN

のみ）

#3ADMIN

LANGVER COBII 管理者環境、すべてのシステム、タイプ COBOL、

procgrp BATCHCII、ステージ 1 および 2 （GEN のみ）

#3ADMIN

LANGVER COBII 管理者、アーカイブ、および未使用以外のすべて

の環境、すべてのシステム、タイプ COBOL、procgrp

BATCHCII、CICSCII、DB2CII、および IDMSCII、ステー

ジ 1 および 2 （GEN のみ）

T#SYMBLS



IDMSDBN SYSTEM 管理者、アーカイブ、および未使用以外のすべて


IDMSCII および IDMSCLE、ステージ 1 および 2 （GEN

のみ）

T#SYMBLS

IDMSDICT SYSDICT 管理者、アーカイブ、および未使用以外のすべて



のみ）

T#SYMBLS

IDMSDMCL USERDB 管理者、アーカイブ、および未使用以外のすべて



のみ）

T#SYMBLS

DDLDML DBLOADLIB 管理者、アーカイブ、および未使用以外のすべて



のみ）

T#SYMBLS

DDLDCLOD DBLOADDSN 管理者、アーカイブ、および未使用以外のすべて



のみ）

T#SYMBLS

DDLDCMSG DBMSGDSN 管理者、アーカイブ、および未使用以外のすべて



のみ）

T#SYMBLS



構成テーブル

CA Endevor SCM 構成テーブルのソースは、iprfx.iqual.CSIQSRC 展開ライブラ

リで配布されます。新しい C1DEFLTS および ESYMBOLS 構成テーブルの

ソースは、BPIDATA データセットにあるテーブル入力メンバで指定された

情報および BPILIB データセットにある #OPTION メンバで指定された情報

に基づいて、BPI プロセスによって作成されます。他の構成テーブルソー

スは BPI プロセスによって変更されません。

■ BPI ジョブ #1TABLES は、2 つの新しいテーブルを作成し、C1DEFLTS、

ENCOPTBL、ENDICNFG、および ESYMBOLS テーブル用のロードモジュー

ルを作成します。

■ BPI ジョブ #3ADMIN は、テーブル（ADMIN/ADMIN/ENDEVOR/TABLE/2）

用のインベントリロケーションを作成し、そのロケーションに構成

テーブルをすべて追加し、プロモートします。

実装が完了した後、必要に応じてソースを変更できます。



グローバルタイプシーケンス

デフォルトでは、BPI はグローバルタイプシーケンスを有効にします。こ

の機能が有効な場合、API エレメントアクション（ワイルドカードまたは

マスクを使用する場合）および SCL エレメントアクションは、管理者に

よって作成されたタイプシーケンスメンバ内のサイトレベルで定義され

た単一のタイプシーケンスによって処理されます。

グローバルタイプシーケンスは以下の機能の前提条件です。

■ 並行アクション処理（CAP） -- 処理用にサブミットされたバッチジョ

ブまたはパッケージに対して CAP が指定された場合、特定のエレメン

トアクション要求が同時に実行されます。 CAP は、グローバルタイプ

シーケンスを使用して、どのアクションを同時に処理できるかを判断

します。

■ ADD、UPDATE、GENERATE アクションの AUTOGEN オプション — エレ

メントに対して AUTOGEN が指定された場合、このコンポーネントエ

レメントを使用するエレメントが自動的に生成されます。 AUTOGEN

にはグローバルタイプシーケンスが必要で、これにより、すべてのコ

ンポーネントの処理が完了した後、コンポーネントを使用するエレメ

ントが生成されます（たとえば、ソースの前にマクロ、ロードモジュー

ルの前にソース、など）。

BPI プロセス中にグローバルタイプシーケンスを有効にするには、

T#GLBSEQ テーブルでタイプシーケンス順を定義します。タイプおよびシ

ステム名は、T#TYPES および T#SYSTMS テーブルで指定するものに一致す

る必要があります。



ベストプラクティス実装のソースファイル

CA Endevor SCM のベストプラクティス実装（BPI）は、ベース製品の一部

として配布されます。すべての BPI コンポーネントは、その他の CA

Endevor SCM ベースメンバと共に以下の展開ライブラリに配置されます。

■ iprfx.iqual.CSIQSAMP - スケルトン、モデル、および BPI プロセッサメン

バ

■ iprfx.iqual.CSIQCLS0 - REXX プロシージャおよび REXX オプションステー

トメントメンバ

■ iprfx.iqual.CSIQJCL - ジョブ制御ステートメントメンバ

■ iprfx.iqual.CSIQDATA - BPI 入力テーブルメンバ

iprfx.iqual ライブラリのセットは、展開ライブラリまたはランタイムライ

ブラリと呼ばれます。これらは、実行される製品ソフトウェアが含まれ

るライブラリです。これらのメンバは、インストールプロセスの一部と

して BC1JJB03 インストールジョブによって編集されます。



BPISTART を実行します。

ベストプラクティス実装を開始するには、BPISTART ジョブを編集してサ

ブミットします。


1. iprfx.iqual.CSIQJCL ライブラリで BPISTART を探します。

2. （オプション） BPISTART の SET LBPRFX=uprfx.uqual ステートメントを

編集して、BC1JJB03 インストールジョブで指定した uprfx および uqual

の値をオーバーライドします。

3. 有効なジョブカードステートメントを追加し、BPISTART ジョブをサブ

ミットして実行します。

このジョブは、以下を実行します。

■ BPI ライブラリの uprfx.uqual.BPIDATA、uprfx.uqual.BPILIB、

uprfx.uqual.BPIPRCR、および uprfx.uqual.BPIWRK を割り当てます。

注：これらのライブラリは BPI プロセスで変更されます。配布され

たライブラリは変更されないため、何らかの理由で BPI プロセスを

再起動する必要がある場合のバックアップ用に使用できます。

■ 配布および調整したメンバを BPIDATA、BPILIB、および BPIPRCR ラ

イブラリにコピーします。

以下のライブラリが BPISTART ジョブで指定した uprfx.uqual の値で作

成されます。

■ uprfx.uqual.BPIDATA - デフォルトの入力テーブルのメンバがすべて

含まれます。これは iprfx.iqual.CSIQDATA ライブラリのコピーです。

これらのテーブルは、BPI プロセスジョブにインベントリ構造（環

境、システム、サブシステム、タイプ、プロセッサグループなど）

を定義するために使用されます。

■ uprfx.uqual.BPILIB - ほかのインストールライブラリからコピーされ

たメンバが含まれます。たとえば、#1TABLES から #9DEFTYP までの

ジョブなどの BPI プロセスによって作成された JCL メンバや、BPI

プロセスによって作成されたその他のファイル（C1DEFLTS および

ESYMBOLS 構成テーブルのソースなど）が含まれます。これは、BPI

プロセスジョブを実行するためにユーザが操作するライブラリで

す。

■ uprfx.uqual.BPIPRCR - 配布された BPI CA Endevor SCM プロセッサの

ソースが含まれます。これらは、BPI の #3ADMIN ジョブによって

管理者環境に追加されます。



■ uprfx.uqual.BPIWRK - BPI ジョブまたはステップのいずれかによっ

て作成され、プロセスで後続の別のジョブまたはステップに渡さ

れる一時メンバおよび中間メンバが含まれます。例には、DEFINE

SYSTEM や DEFINE SUBSYSTEM に対して、プロセスによって作成さ

れた SCL があります。何らかの問題が発生した場合のために、そ

の他のメンバはこのライブラリに入れられます。

BPI 入力テーブルのカスタマイズ

BPI テーブルのデフォルトセットは、BPIDATA ライブラリにコピーされま

す。これらのファイルにより、事前定義済みのベストプラクティス値を

使用して構成が決定されます。ただし、サイトに応じてこれらのテーブ

ルを編集する必要があります。

実装の構成をどのように決定するかに応じて、BPIDATA ライブラリの各メ

ンバを編集します。変換ユーティリティ、ISPF エディタ、Word ドキュメ

ントからのアップロードを使用できます。または、その他の方法を使用し

て、これらの必須テーブルを変更または作成できます。

重要：テーブルを編集する際は、すべての変更がテーブル形式のルールに

従っていることを確認します。

重要：入力テーブルをカスタマイズする方法は、BPI プロセスを何回実行

するかに応じて異なります。実装計画の詳細については、「BPI プロセス

の繰り返し (P. 323)」を参照してください。



入力テーブルの形式のルール

入力テーブルを編集する場合は、以下のルールに従ってください。

■ 見出し行

– 各テーブルには見出し行が 1 つ必要です（列 1 にアスタリスク 1

つ）。

– 見出し行は、その他のすべてのデータ行より先にコード化される

必要があります。

– 配布された見出し行の形式は、絶対に変更しないでください。

■ データ行

– 特に指定のない限り、データ行の値はすべて大文字で入力する必


– 特に指定のない限り、すべての値に必須です。

– データ行のデータは、見出し行のフィールドリテラルと同じ列に

入力する必要があります。

■ コメント行

– コメント行は、行の列 1～2 にアスタリスクを記述して、テーブル

ソースのどの場所にも追加できます。コメント行であることが検

出されると、その行は無視されます。



T#ADMALL -- ADMIN 環境の割り当て

T#ADMALL テーブルは、ADMIN 環境にデータセットを割り当てます。こ

のテーブルは、テーブルにリストされた各エレメントタイプに対して、

以下のデータセットの作成を有効にします。

■ ADMIN 環境の各エレメントタイプに対して 1 つの DELTA、LISTLIB、

LLISTLIB、LOADLIB、および OBJLIB ライブラリ。

■ 各システム、サブシステム、環境、ステージの各エレメントタイプに

対して 1 つのベースライブラリ。各ベースライブラリには、以下の

名前形式があります。

adminprfx. .&C1SY..&C1SU..&C1EN(1,3)&C1S#.typename

typename

言語バージョンを指定します。

このテーブルを以下のように編集します。

1. エレメントタイプの行を追加または削除し、サイトで使用する言語タ

イプを含めます。タイプ名がテーブルの Node 列に表示されます。

2. PROCESS、TABLE、DELTA、LISTLIB、LLISTLIB、LOADLIB、または OBJLIB の

タイプ名は CA Endevor SCM に対して特別な意味を持つため、変更しな

いでください。これらのタイプでは、DELTA、LISTLIB、または LLISTLIB

ライブラリの形式を変更した場合を除き、Sizeunit、Primary、Secondary、

および Directory への変更が制限されます。

3. （オプション）DELTA、LISTING、および LLISTING データセットに対し

て ELIB BDAM データセットを定義する場合は、以下の値を指定します。

注： #OPTION メンバの DELTA および LISTLIB データセット形式は、

T#ADMALL メンバで指定された形式と同じである必要があります。デ

フォルトでは、DELTA、LISTLIB、および LLISTLIB は、ELIB BDAM として

作成されます。これらは、そのまま使用するか、テーブルを編集する

ことによって PDS または PDSE に変更できます。

注： ELIB BDAM データセットの詳細については、「管理ガイド」を参


■ PrimPages - ELIB 初期化プログラム用に割り当てるプライマリペー

ジの数を指定します。このパラメータの値は、ALLOCATE PAGES パ

ラメータに設定されます。

ALLOCATE PAGES = (&PrimPages,&SecdryPages)



■ SecdryPages - ELIB 初期化プログラム用に割り当てるセカンダリ

ページの数を指定します。このパラメータの値は、ALLOCATE PAGES

パラメータに設定されます。


■ ResrvePages - ELIB 初期化プログラム用に予約するページの数を指

定します。このパラメータの値は、RESERVE PAGES パラメータに設

定されます。

RESERVE PAGES = &ResrvePages

■ DirPages - ELIB 初期化プログラム用に割り当てるディレクトリ

ページの数を指定します。このパラメータの値は、DIRECTORY

PAGES パラメータに設定されます。

DIRECTORY PAGES = &DirPages

重要： T#ADMALL テーブルと T#ADMTYP テーブルで、同じタイプをリスト

する必要があります。これらのテーブルのいずれかからのタイプ行を追

加または削除する場合、対応する変更を他のテーブルに対して加える必要

があります。

T#ADMSUB -- ADMIN 環境のサブシステム名

T#ADMSUB テーブルは、ADMIN 環境のサブシステムの名前を指定します。

配布されるテーブルにより、以下が指定されます。

■ システム： ADMIN

■ サブシステム： ENDEVOR

■ 説明： CA Endevor SCM テーブルおよびプロセッサ

通常、このテーブルの変更は不要です。

重要：システム名は、T#ADMSYS および T#ADMSUB の各テーブルと同じで

ある必要があります。 T#ADMSYS テーブルからシステム行を追加または削

除する場合、T#ADMSUB テーブル内の関連付けられている行を追加または

削除する必要があります。



T#ADMSYS--System Names for ADMIN Environment

このテーブルは、実装される ADMIN 環境システムを指定します。配布さ

れるテーブルにより、以下が指定されます。

■ システム： ADMIN

■ 説明： CA Endevor SCM の管理。

システム名は、以下のプロセッサアウトプットライブラリの作成で使用

されます。

重要：テーブルで最初に参照されるシステムは、プロセッサアウトプット

ライブラリ名を作成するために使用されます。

配布時に、以下のテーブルが作成されます。

adminprfx.ADMIN.PROCESS.ADM1.LOADLIB

adminprfx.ADMIN.PROCESS.ADM1.LISTLIB

adminprfx.ADMIN.PROCESS.ADM2.LOADLIB

adminprfx.ADMIN.PROCESS.ADM2.LISTLIB

system_name

ADMIN 環境のシステムの名前を指定します。

通常、このテーブルの変更は不要です。

重要：システム名は、T#ADMSYS テーブルおよび T#ADMSUB テーブルと同

じである必要があります。 T#ADMSYS テーブルからシステム行を追加また

は削除する場合、T#ADMSUB テーブル内の関連付けられている行を追加ま

たは削除する必要があります。



T#ADMTYP--Types for the ADMIN Environment

この T#ADMTYP テーブルは、ADMIN 環境で作成されるタイプ定義を指定し

ます。



イプを含めます。

2. CA Endevor SCM は、PROCESS または TABLE を使用して CA Endevor SCM

プロセッサおよび構成テーブルを保持し、これらに指定された値を設

定する必要があるため、PROCESS または TABLE のタイプ名を変更しな

いでください。

重要：各タイプに対してリストされた最初のプロセッサグループは、その

タイプのデフォルトプロセッサグループとして使用されます。

重要： T#ADMALL テーブルと T#ADMTYP テーブルで、同じタイプをリスト

する必要があります。これらのテーブルのいずれかからのタイプ行を追

加または削除する場合、対応する変更を他のテーブルに対して加える必要

があります。



T#ALLOC -- 非 ADMIN 環境の割り当て

T#ALLOC テーブルは、ADMIN 環境以外のすべての環境のデータセットを

割り当てます。 UNCLMED 環境および PRD 環境には、このテーブルで指定

された値に #OPTION で指定された割り当て係数が適用されます。

このテーブルは、T#TYPES テーブルで定義された各エレメントタイプに対

して、以下のデータセットの作成を有効にします。

■ アプリケーションまたは標準環境の各エレメントタイプに対して 1

つの DELTA、LISTLIB、LLISTLIB、LOADLIB、および OBJLIB ライブラリ。

■ 各システム、サブシステム、環境、ステージの各エレメントタイプに

対して 1 つのベースライブラリ。各ベースライブラリには、以下の

名前形式があります。

aprfx. .&C1SY..&C1SU..&C1EN(1,3)&C1S#.typename

typename

言語バージョンを指定します。



イプを含めます。タイプ名がテーブルの Node 列に表示されます。

2. PROCESS、TABLE、DELTA、LISTLIB、LLISTLIB、LOADLIB、または OBJLIB の

タイプ名は CA Endevor SCM に対して特別な意味を持つため、変更しな

いでください。これらのタイプでは、DELTA、LISTLIB、または LLISTLIB

ライブラリの形式を変更した場合を除き、Sizeunit、Primary、Secondary、

および Directory への変更が制限されます。

3. （オプション） DELTA、LISTING、および LLISTING データセットに対し

て ELIB BDAM データセットを定義する場合は、以下の値を指定します

（デフォルトは ELIB BDAM）。

■ PrimPages - ELIB 初期化プログラム用に割り当てるプライマリペー

ジの数を指定します。このパラメータの値は、ALLOCATE PAGES パ

ラメータに設定されます。


■ SecdryPages - ELIB 初期化プログラム用に割り当てるセカンダリ

ページの数を指定します。このパラメータの値は、ALLOCATE PAGES

パラメータに設定されます。




■ ResrvePages - ELIB 初期化プログラム用に予約するページの数を指

定します。このパラメータの値は、RESERVE PAGES パラメータに設

定されます。

RESERVE PAGES = &ResrvePages

■ DirPages - ELIB 初期化プログラム用に割り当てるディレクトリ

ページの数を指定します。このパラメータの値は、DIRECTORY

PAGES パラメータに設定されます。

DIRECTORY PAGES = &DirPages

注： #OPTION メンバは UNCLMED 環境および PRD 環境に以下のように影響

します。

■ 割り当てステートメントの作成時、uprfx.uqual.BPILIB ライブラリの

#OPTION メンバで指定された ProductionSizeFactor は、#5ALLOC ジョブ

によって本番環境の割り当てに適用されます。たとえば、ASMPGM

ベースライブラリに Primary 値として 50 を指定し、

ProductionSizeFactor 値に 3 を指定した場合、データセットには 150 の

プライマリシリンダが割り当てられます。本番環境の処理時には、こ

の係数が Secondary 列および Directory 列にも適用されます。 ELIB

DELTA または LISTING を割り当てる場合、ProductionSizeFactor はスキッ

プされます。

■ 割り当てステートメントの作成時、uprfx.uqual.BPILIB ライブラリの

#OPTION メンバで指定された UnclaimedSizeFactor は、#4UNCLM ジョブ

によって未使用環境の割り当てに適用されます。たとえば、ASMPGM

ベースライブラリに Primary 値として 40 を指定し、

UnclaimedSizeFactor 値に 3 を指定した場合、データセットには 120 の

プライマリシリンダが割り当てられます。未使用環境の処理時には、

この係数が Secondary 列および Directory 列にも適用されます。 ELIB

DELTA または LISTING を割り当てる場合、UnclaimedSizeFactor はスキッ

プされます。

T#ENVMTS -- 環境およびステージ名

T#ENVMTS テーブルは、作成する環境およびステージを指定します。

配布時には、実装によって以下の環境およびステージが作成されます。

Envname Stg1ID Stg1nme Stg2ID Stg2nme Entrystg# NextEnv NextStgID

ADMIN 1 ADMIN1 2 ADMIN2 1



Envname Stg1ID Stg1nme Stg2ID Stg2nme Entrystg# NextEnv NextStgID

DEV 1 DEV1 2 DEV2 1 QAS 2

QAS 1 QAS1 2 QAS2 1 PRD 2

PRD 1 PRD1 2 PRD2 1

UNCLMED 1 UNCLMED1 2 UNCLMED2 2

ARCHIVE 1 ARCHIVE1 2 ARCHIVE2 2

EMER 1 EMER1 2 EMER2 1 PRD 2


1. 環境の行を追加または削除して、サイトで使用する環境を含めます。

データ行の値はすべて大文字で入力する必要があります。環境名の最

初の 3 文字はデータセット名を作成するために使用されます。そのた

め、名前の最初の 3 文字は環境全体において一意である必要がありま

す。環境名が 3 文字未満の場合は、環境へのデータセットの割り当て

時に、埋め込み文字（$）が環境名に追加されます。

2. ADMIN、PRD、UNCLMED、ARCHIVE の環境名は、業務上の理由がない

限り、変更しないでください。これらを変更する場合は、

uprfx.uqual.BPILIB データセットにある O#ENVMTS REXX メンバ内の名

前も変更する必要があります。このメンバの目的は、環境が、管理者、

本番、未使用エレメント、およびアーカイブエレメント環境のどれに

該当するかを識別することです。

3. UNCLMED 環境が不要な場合は、#1TABLES ジョブを実行する前にこの

テーブル内の UNCLMED 行をコメント化してください。 #1TABLES ジョ

ブは C1DEFLTS テーブルを作成します。

注：また、#4UNCLM ジョブの実行をスキップします。



T#GLBSEQ -- グローバルタイプシーケンスメンバ

T#GLBSEQ テーブルには、グローバルタイプシーケンスメンバ

（uprfx.uqual.PARMLIB 内の GLBLTYPE）を作成するのに必要な情報が含まれ

ます。 CA Endevor SCM は、タイプ処理の順序を決定するためにこの

PARMLIB メンバを使用します。このテーブルは T#ADMTYP および T#TYPES

テーブルと一緒に使用されます。これらのテーブルに対してデータ行を

追加または削除した場合は、T#GLBSEQ についても変更が必要かどうかを

確認する必要があります。

このテーブルには、特定のシーケンスで実行される必要があるタイプのみ

を含めます。 JCL や PROCS などのタイプはこのテーブルに含めないように

します。このルールに従うと、並行アクション処理機能のスループット

が向上します。

T#LIBRYS -- サイト全体で使用するデータセットの割り当て

T#LIBRYS テーブルは、サイト全体で使用する CA Endevor SCM データセッ

トを割り当てます。このモデルの目的は、これらのデータセットの完全

修飾名を識別することです。 Node 列の値は、以下のような完全修飾デー

タセット名の最後の修飾子として使用されます。

■ ACMROOT - ACM ルートおよびデータセット。

■ ACMXREF - 相互参照データセット。

■ ELMCATL - エレメントカタログデータセット。

■ ELMCATL.EINDEX - エレメントカタログインデックスデータセット。

■ PACKAGE - パッケージファイル。

■ PARMLIB - パラメータライブラリ。

■ MCF - 環境とステージの各組み合わせのマスタ制御ファイル。

このテーブルに対する行の追加や削除は行わないでください。ただし、

MODEL 列で指定したデータセットのタイプおよびデータセットサイズ

属性を確認する必要があります。

このテーブルの Node、MODEL、TBLOUT の値は変更しないことを強くお勧

めします。 MCF 名は変更しないでください。業務上の理由でその他のノー

ド名のいずれかを変更する場合は、iprfx.iqual.CSIQCLS0 データセットにあ

る O#LIBRYS REXX モデル内の名前も変更する必要があります。



T#SUBSYS -- すべての標準環境またはアプリケーション環境を除くすべての環境のサブシステ

ム名

T#SUBSYS テーブルは、ADMIN 環境と UNCLMED 環境を除くすべての環境を

対象として、各システムのサブシステムの名前を指定し、各サブシステム

の説明を記述します。


1. ビジネスモデルに応じて、システムおよびサブシステムのデフォルト

を変更します。

2. 手順 1 で T#SUBSYS テーブルを変更した場合は、T#SYSTMS テーブルの

対応する行を追加または削除します。

注：デフォルトのサブシステム名は、サンプルアプリケーションと一致し

ています。



T#SYMBLS -- ADMIN および UNCLMED 以外のすべての環境のシンボル名

T#SYMBLS テーブルには、標準またはアプリケーション環境に対して定義

されるシンボルのオーバーライド値がすべて含まれます。

このテーブルには、標準環境に対して定義されるシンボルのオーバーライ

ド値が含まれます。テーブルの各行に、タイプ、プロセッサグループ、

環境、ステージ、プロセッサタイプ、シンボル、およびオーバーライド

値を指定する必要があります。プロセッサグループ、環境、およびステー

ジ番号列では、ワイルドカードを使用できます。ただし、部分的なワイ

ルドカードは、環境またはステージ列ではサポートされていません。

ステージ列にワイルドカードを使用すると、ステージ 1 およびステージ 2

用のシンボル定義が作成されます。

環境列にワイルドカードを使用すると、ADMIN、UNCLMED、および ARCHIVE

を除くすべての環境（DEV、QAS、PRD、EMER）用のシンボル定義が作成

されます。これらが除外されるのは、管理者環境では #3ADMIN にシンボ

ル作成のステップがあり、未使用およびアーカイブ環境ではプロセッサが

*NOPROC* に設定されるためです。ただし、テーブルにそのロケーショ

ン用の一意の行を作成し、Envname 列に環境名を直接入力することにより、

環境のシンボルを定義できます。言い換えれば、ワイルドカード機能で

は管理者環境が除外されますが、Envname 列に ADMIN を入力することに

より、このテーブルを使用してその環境のシンボルを作成できます。

ワイルドカードを使用する環境のすべてのシンボル定義が最初に作成さ

れ、次に特定のシンボル定義が作成されるため、シンボル行を作成する際

の柔軟性が向上します。配布時には、多くのプロセッサシンボリックの

オーバーライド値が作成されます。必要に応じて、シンボルテーブルに

対して行の削除または追加を実行できます。

T#SYSTMS -- 標準環境またはアプリケーション環境のシステム名

T#SYSTMS テーブルには、実装する環境システムがすべて含まれています。

このテーブルには、Endevor サンプルアプリケーションの値があらかじめ

設定されています。説明以外のデータ行の値は、すべて大文字で入力す

る必要があります。説明は大文字と小文字で入力できます。

このテーブルは T#SUBSYS テーブルと関連しています。 T#SYSTMS テーブル

でシステム行を追加または削除する場合は、T#SUBSYS テーブルの関連す

る行を追加または削除する必要があります。



T#TYPES -- 非 ADMIN 環境用のタイプ

T#TYPES テーブルには、DEV、QAS、PRD、EMER、ARCHIVE、および UNCLMED

環境で作成されるタイプが含まれます。

PROCESS 行の値は変更しないでください。このタイプは CA Endevor SCM

プロセッサを保持するために使用され、指定されている値に設定する必要

があります。

T#TYPES テーブルにタイプ定義の行を追加または削除する場合は、

T#ALLOC テーブルに対応する行を追加または削除する必要があります。

T#GLBSEQ テーブルも、行を追加または削除する必要がどうかを判断する

ために確認する必要があります。

BPI ジョブカードの準備

情報がサイトの標準に適合するように、uprfx.uqual.BPILIB ライブラリの

#JOBCARD メンバを編集します。タイトルは変更しないでください。

&TBLOUT シンボルはジョブ名に解決されます。

//BPI@ENDV JOB (#########),'BPI &TBLOUT ', // CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1), // NOTIFY=&SYSUID

ジョブカードは BPI ジョブで使用できるようになっています。

注： #0SETUP ジョブの実行時、このジョブカードはその他の各 BPI ジョブ

の先頭に自動的に配置されます。

注： BPISTART ジョブが実行された後、残りの BPI プロセスは BPILIB ライブ

ラリから実行されます。



BPI ジョブのシンボル値の定義

BPI プロセスで構成を実行するために使用する変数の値を定義するには、

#OPTION メンバを編集します。これらの値は BPI モデルおよび REXX メン

バで定義されている変数を解決するために使用されます。

uprfx.uqual.BPILIB(#OPTION) メンバを編集し、すべての質問に答えます。質

問は REXX コメント形式で、回答は REXX ステートメント形式です。これ

らのステートメントは、実装プロセスでシンボル値として使用されます。

たとえば、C1DEFLTS テーブルのサイトパラメータ値の多くは、このメン

バで指定された情報から派生します。等号の左側のリテラルは REXX 変数

で、大文字と小文字のままにする必要があります。等号の右側に入力す

る値はデータ値であり、特に指定のない限り大文字で入力する必要があり

ます。コメント、説明、注などは大文字と小文字で入力できます。



BPI ジョブのサブミット

入力テーブルおよび #OPTION メンバの情報を使用する一連のジョブとし

て BPI を実行します。サブミットする最初のジョブは #0SETUP ジョブです。

このジョブによって、サブミットする必要があるほかのジョブが構築され

ます。ジョブはすべて BPILIB ライブラリに配置し、指定された順番で実行

する必要があります。これらのジョブには追加ジョブを作成するものが

あります。 #OPTION メンバの SubmitJob パラメータが Y の場合、これらの

追加ジョブは自動的にサブミットされます。セットアップを実行するに

は、ジョブをサブミットします。


1. セットアップジョブ #0SETUP をサブミットします。

データセットが存在することを確認し、追加ジョブを作成および調整

します。このジョブは追加ジョブを 9 つ作成し、それらを

uprfx.uqual.BPILIB ライブラリに保存します。このジョブは、割り当て

ようとしている CA Endevor SCM サイト全体で使用するデータセット

が存在するかどうかを確認します。何らかのデータセットがすでに存

在する場合は、ジョブはリターンコード 12 で終了し、どのデータセッ

トが存在しているかを示すレポートが作成されます。この確認の目的

は、データセットを誤って削除しないようにするためです。

#0SETUP ジョブでも追加の BPI ジョブが作成されます。セットアップ

ジョブによって作成されるジョブも BPILIB ライブラリへ格納されます。

コード化した #JOBCARD は、これらの各ジョブの先頭にコピーされま

す。

2. #1TABLES ジョブをサブミットします。

このジョブは、C1DEFLTS テーブルおよび ESYMBOLS テーブルを作成、

アセンブル、およびリンクエディットします。このジョブでは追加

ジョブは作成されません。また、このジョブは ENCOPTBL および

ENDICNFG 構成テーブルもアセンブルおよびリンクエディットします。

3. #2LIBRYS ジョブをサブミットします。

サイト全体で使用する Endevor のデータセットを割り当てます。グ

ローバルタイプシーケンスメンバを作成し、PARMLIB に保存します。

このジョブは追加ジョブを 1 つ作成します。

4. #3ADMIN ジョブをサブミットします。

ADMIN 環境全体を作成します。プロセッサおよび構成テーブルを追加

します。このジョブは割り当て指定に応じて追加ジョブを 4 つまたは

5 つ作成します。



5. #4UNCLM ジョブをサブミットします。

UNCLMED 環境全体を作成します。このジョブは割り当て指定に応じ

て追加ジョブを 4 つまたは 5 つ作成します。

6. #5ALLOC ジョブをサブミットします。

すべての Endevor アプリケーションデータセットを割り当てます。こ

のジョブは、T#SUBSYS BPI テーブルで指定されたシステム/サブシステ

ムの組み合わせの数に応じて、追加ジョブを作成します。

7. #6DEFSYS ジョブをサブミットします。

DEV、QAS、PRD、EMER、および ARCHIVE 環境にシステムを定義します。

このジョブは追加ジョブを 1 つ作成します。

8. #7DEFSUB ジョブをサブミットします。

DEV、QAS、PRD、EMER、および ARCHIVE 環境にサブシステムを定義し

ます。このジョブは追加ジョブを 1 つ作成します。

9. #8DEFTYP ジョブをサブミットします。

DEV、QAS、PRD、EMER、および ARCHIVE 環境にタイプを定義します。

また、指定したすべての環境にプロセッサシンボルを定義します。こ

のジョブは追加ジョブを 1 つ作成します。

10. #9DEFGRP ジョブをサブミットします。

DEV、QAS、PRD、EMER、および ARCHIVE 環境にプロセッサグループ

を定義します。また、指定したすべての環境にプロセッサシンボルを

定義します。

11. BPI プロセスを繰り返すごとに、uprfx.uqual.BPIWRK ライブラリを手動

で削除します。実装が完了した後は、BPIWRK データセットから値は

提供されません。



BPI プロセスの繰り返し

BPI プロセスを繰り返し実行することをお勧めします。最初に、1 つのシ

ステム（またはアプリケーション）を実装します。これにより、入力テー

ブルの編集方法、およびジョブの動作方法を理解することができます。次

に、BPI を実行してアプリケーション全体を実装できます（アプリケーショ

ンは、複数のシステムおよびサブシステムで構成できます）。その後、

アプリケーションを追加するごとに繰り返し実行します。最初に、すべ

ての手順を実行します。その後の繰り返しで、BPI 入力テーブルを再編集

し、#5ALLOC から始まる一連のジョブを再実行します。

最初に、以下を実行します。

1. BPISTART をサブミットします。

2. すべての BPI 入力テーブルに入力します。

3. #JOBCARD を編集します。

4. #OPTION を編集して、シンボリックの置換を有効にします。

5. BPI ジョブの #0SETUP から #9DEFGRP までを実行し、作成された追加

ジョブをサブミットします。

2 回目およびその後の繰り返しでは、以下を実行します。

1. テーブルの値を編集します。

2. BPI ジョブの #5ALLOC から #9DEFGRP までを実行し、作成された追加

ジョブをサブミットします。

3. 必要に応じてこれらの手順を繰り返し、現時点で CA Endevor SCM の制

御下に置くシステムをすべて追加します。

ca endevor® software change manager - … endevor software...ca technologies...

Documents