AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、AWS 「 Mainframe Modernization の可用性の変更」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
BAC の使用
BAC はセキュリティで保護されており、機能を使用するためのアクセス許可がユーザーロールに基づいて付与されるため、アプリケーションにアクセスする際に、まず認証を行う必要があります。認証ステップが完了すると、ホームページにリダイレクトされます。ホームページには、Blusamストレージにあるデータセットのページ分割されたリストが表示されます。
データセットのリストを含むホームページに戻るには、アプリケーションの任意のページの左上隅にあるAWS Transform for mainframeロゴを選択します。次の画像はそのロゴです。
「設定Blusam」というラベルが付いた折りたたみ可能なヘッダーには、使用されているBlusamストレージ設定に関する情報が含まれています。
-
Persistence: 永続ストレージエンジン (PostgreSQL) -
Cache Enabled: ストレージキャッシュが有効かどうか
ヘッダーの右に 2 つのドロップダウンリストがあり、それぞれにデータセットの操作が一覧表示されます:
-
一括アクション
-
作成アクション
これらのリストの詳細については、「既存のデータセットの操作」を参照してください。
データセットが選択されていない場合、[一括アクション] ボタンは無効になります。
検索フィールドを使用し、データセット名を指定してリストをフィルター処理できます。
その下にあるページ分割されたリストに各データセットが 1 行で示されます。この表の列について以下で説明します。
-
選択チェックボックス: 現在のデータセットを選択するチェックボックス。
-
データセットの名前。
-
タイプ: データセットのタイプ。次のいずれかになります。
-
KSDS
-
ESDS
-
RRDS
-
-
キー: キーの詳細 (存在する場合) の表示/非表示を選択するリンク。例えば、必須のプライマリキーと 1 つの代替キーを持つ KSDS であれば次のように表示されます。
キーごとに 1 つの行を、次の列で表示します。いずれのフィールドも編集できません。
-
キーの性質: プライマリキーまたは代替キー
-
名前: キーの名前
-
一意: キーが重複エントリを許可するかどうか
-
オフセット: レコード内のキー開始のオフセット
-
長さ: レコード内のキー部分の長さ (バイト単位)
-
-
レコード: データセット内のレコードの合計数。
-
レコード最大サイズ: レコードの最大サイズ (バイト単位)。
-
固定レコード長: レコードが固定長か (オン) 可変長か (オフ) を示すチェックボックス。
-
圧縮: インデックスを保存する際に圧縮を適用するか (オン) しないか (オフ) を示すチェックボックス。
-
作成日: データセットがBlusamストレージに作成された日付。
-
最終変更日: データセットがBlusamストレージで最後に更新された日付。
-
キャッシュ: このデータセットに適用するキャッシュ方法の情報の表示/非表示を選択するリンク。
-
起動時にキャッシュを有効にする: このデータセットの起動時のキャッシュ方法を指定するチェックボックス。オンにすると、データセットは起動時にキャッシュに読み込まれます。
-
キャッシュをウォームアップする: 指定したデータセットをキャッシュに読み込むボタン。すぐに開始されます (ただし、データセットのサイズとキーの数によっては、キャッシュをハイドレートするために時間がかかる場合があります)。データセットがキャッシュに読み込まれると、次のような通知が表示されます。
-
-
アクション: データセット操作のドロップダウンリスト。詳細については、「既存のデータセットの操作」を参照してください。
ページの一番下にページ移動のウィジェットが表示され、データセットのリストのページをブラウズできます。
既存のデータセットの操作
ページ分割されたリストの各データセットに、[アクション] ドロップダウンリストが表示されます。
その各項目を選択し、データセットに対して指定したアクションを実行することができます。
-
読み取り: データセットからレコードを参照する
-
読み込み: レガシーデータセットファイルからレコードをインポートする
-
エクスポート: フラットファイル (レガシーシステムと互換性のあるファイル) にレコードをエクスポートする
-
消去: データセットからすべてのレコードを削除する
-
削除: ストレージからデータセットを削除する
各アクションについて、以下のセクションで説明します。
データセットからレコードを参照する
データセットの [読み取り] アクションを選択すると、次のページが表示されます。
このページは以下で構成されます:
-
ヘッダー:
-
データセット: データセット名
-
レコードサイズ: 固定レコード長 (バイト単位)
-
レコード合計数: このデータセットに保存されたレコードの合計数
-
[設定を表示] ボタン (右側): データセット設定の表示/非表示を切り替えるボタン。最初は設定が表示されません。ボタンを使用すると、次の画像のように設定が表示されます。
設定を表示すると、[保存] と [リセット] の次の操作を行う 2 つのボタンが表示されます:
-
データセットの設定と現在の作業を保存する
-
設定をすべてのフィールドでデフォルト値にリセットする。
-
-
データセットの参照体験をカスタマイズするための設定可能なプロパティのリスト。
-
設定可能なプロパティについては、BAC 専用設定ファイル の説明を参照してください。このセクションで、各列の意味と指定可能な値を理解できます。この画面から値をデータセットごとに変更し、作業を保存できます ([保存] ボタンを使用します)。設定を保存すると、次の画像のようなバナーが表示されます。
バナーには、このページを離れると操作のセッションが終了することが説明されています。
このセクションで説明されていない設定可能なプロパティが 1 つあります。それはレコードサイズです。データセットに適用するマスクをフィルター処理するためのレコードサイズ (バイト単位) を指定します。指定したレコードサイズと合計サイズが一致するマスクのみが、[データマスク] ドロップダウンリストに表示されます。
データセットからのレコードの取得は、[検索] ボタンによってトリガーされ、この画面のすべてのオプションとフィルターを使用して実行されます。
最初の行のオプション:
-
[データマスク] ドロップダウンリストには、(レコードサイズを基準に) 適用可能なマスクが表示されます。ただし、レコードサイズが一致するだけでは適用可能なマスクになりません。マスク定義とレコードの内容が一致していることも必要です。ここで選択されるデータマスクには
-
結果の最大件数: 検索して取得するレコードの数を制限します。0 に設定すると、データセットから無制限に (ページ分割されて) 結果が取得されます。
-
[検索] ボタン: フィルターとオプションを使用してレコードの取得を開始します
-
[マスクの消去] ボタン: 使用したマスクがある場合はそれを消去し、結果ページを未加工のキー/データ表示に切り替えます。
-
[フィルターの消去] ボタン: 使用したフィルターがある場合はそれを消去し、結果ページを更新します。
-
[すべてのフィールド] トグル: オンにすると、
skip = trueで定義されたマスク項目が表示されます。オフにすると、skip = trueのマスク項目が非表示になります。
次の行のフィルター: 次の画像に示すように、マスクのフィールド (列) に適用するフィルター条件を指定して、フィルターリストを定義できます。
-
マスクフィルター: フィルター処理する列を選択するマスクの名前。選択すると、適用可能なマスクのリストが表示され、そのリストからマスクを選択できます。
-
列フィルター: レコードのフィルター処理に使用するマスクのフィールド (列) の名前。フィールドを選択すると、マスクの列のリストが表示されます。[列フィルター] フィールドに入力するには、セルを選択します。
-
フィルター演算子: 選択した列に適用する演算子。以下のオプションを選択できます。
-
に等しい: レコードの列値がフィルター値と等しい
-
で始まる: レコードの列値がフィルター値で始まる
-
で終わる: レコードの列値がフィルター値で終わる
-
含む: レコードの列値にフィルター値が含まれる
-
-
フィルターオプション:
-
逆条件: フィルター演算子に逆条件を適用します。例えば、「に等しい」は「に等しくない」に置き換えられます。
-
大文字と小文字の区別を無視: フィルター演算子の英数字を、大文字と小文字を無視して比較します
-
-
値フィルター: フィルター演算子とフィルター列の比較に使用する値。
フィルター項目が最小限設定されると (マスクフィルター、列フィルター、演算子フィルター、値フィルターは少なくとも設定する必要があります)、[フィルターの追加] ボタンが有効になり、クリックすると、取得するレコードに対する新しいフィルター条件が作成されます。最上部には空のフィルター条件の行が 1 つ追加されます。また、追加したフィルター条件には [削除] ボタンが表示され、これを使用してフィルター条件を抑制できます。
検索を起動すると、フィルター処理された結果がページ分割されたテーブルに表示されます。
メモ
-
フィルターを連結するには [かつ] または [または] を選択します。フィルター定義を新しく追加する各行の先頭に、次の画像に示すような連結演算子が表示されます。
-
指定したフィルター条件に一致するレコードがない場合があります。
一致する場合は、次の画像のような結果テーブルが表示されます。
ヘッダーには、フィルター条件に一致するレコードの合計数が表示されます。ヘッダーの後に、以下が表示されます。
-
使用されたデータマスク (存在する場合) とフィルター条件。
-
Blusam ストレージから最新の値を含む結果テーブル全体の更新をトリガーするために使用できる更新ボタン (たとえば、別のユーザーによって更新された可能性があるため）。
テーブルには、データマスクを適用して取得された結果レコードが (1 レコード 1 行で) 表示されます。各列は、タイプに応じて (および選択したエンコーディングを使用して) 変換されます。各行の左側には、次の 3 つのボタンがあります。
-
拡大鏡ボタン: レコードの詳細な内容を表示する専用ページに移動します。
-
ペンボタン: レコードの内容を編集するための専用ページに移動します。
-
ごみ箱ボタン: レコードを指定して blusam ストレージから削除します。
レコードの詳細な内容の表示画面:
-
列の非表示/表示を切り替えるための 3 つのボタン:
-
タイプの非表示/表示
-
表示フラグの非表示/表示
-
範囲の非表示/表示
-
-
この専用ページから結果テーブルに戻るには、[閉じる] を選択します。
-
各行はデータマスクの列を表します。次の列があります:
-
名前: 列の名前
-
タイプ: 列のタイプ
-
表示: 表示インジケータ。一致するマスク項目が
skip = falseに定義されている場合は緑色のチェックが表示され、定義されていない場合は赤色の十字が表示されます。 -
開始と終了: レコードのサブ部分の範囲 (0 ベース)
-
値: レコードサブ部分をタイプとエンコーディングを使用して変換した値
-
レコードの内容を編集する:
編集ページは、マスク項目の値を編集できる点を除いて、先述の参照ページに似ています。次の 3 つのボタンがあります。
-
リセット: 編集された値を初期値 (編集前の値) にリセットします。
-
検証: マスク項目のタイプに合わせて入力を検証します。各マスク項目の検証結果がラベルで表示されます (検証が成功した場合は
OKとチェックボックス、失敗した場合はERROR、赤の十字マーク、および失敗に関するヒントを示すエラーメッセージ)。検証が成功すると、2 つのボタンが表示されます。-
保存: 既存のレコードをBlusamストレージに更新しようとする
-
コピーを保存する: Blusamストレージに新しいレコードを作成しようとする
-
ストレージへのレコードの保存が成功すると、メッセージが表示され、ページが読み取り専用モードに切り替わります (マスク項目の値を編集できなくなります)。
-
何らかの理由でストレージへのレコードの永続化が失敗すると、エラーの理由を示すエラーメッセージが赤で表示されます。エラーの理由として最も一般的なのは、レコードの保存によりキーが破損する (キーが無効になるか重複する) ことです。これについて、下記のメモで説明しています。
-
終了するには、[閉じる] ボタンを選択します。
-
-
キャンセル: 編集セッションを終了し、ページを閉じて、レコードリストページに戻ります。
メモ:
-
この検証メカニズムでチェックされるのは、マスク項目の値がマスク項目のタイプと正式に一致しているかどうかのみです。例えば、数値マスク項目でこの検証が失敗したとします:
-
検証メカニズムによって無効な入力の自動修正が行われ、値がタイプに合わせて自動的に修正されたことを示す青のメッセージが表示されます。例えば、数値
fd_trncat_cdマスク項目に 7XX0 を数値として入力した場合:
検証を呼び出すと、次のようになります。
-
検証メカニズムは、キーの整合性の観点からは値が有効かどうかをチェックしません (データセットに一意のキーが含まれている場合)。例えば、検証が成功した場合でも、入力した値によってキーが無効になるか重複が発生した場合は永続化が失敗し、エラーメッセージが表示されます。
レコードの削除
レコードを削除するには、ごみ箱ボタンを選択します。
データセットにレコードを読み込む
データセットにレコードを読み込むには、[アクション] を選択し、[読み込み] を選択します。
読み込みのオプションがウィンドウに表示されます。
[サーバーに読み込む] と[Blusam に読み込む] のボタンは、この時点では無効です。
読み取りパラメータ:
-
レコード長の種類:
-
固定長または可変長: レガシーデータセットのエクスポートで固定長と可変長のどちらを使用するかを、ラジオボタンで指定します (レコードは RDW バイトで始まります)。固定長を選択した場合、レコード長 (バイト単位) を入力フィールドに正の整数値で指定する必要があります。値は、データセットの情報から事前入力されます。可変長を選択した場合、この入力フィールドは表示されません。
-
ファイルの選択:
-
ローカル: 下に表示されるファイルセレクタを使用して、ローカルコンピュータからデータセットファイルを選択します (注: ファイルセレクタはブラウザのロケールを使用してメッセージを表示します。この画面ではフランス語ですが、ロケールに応じて表示が変わります)。ファイルを選択すると、そのファイル名がウィンドウに表示され、[サーバーに読み込む] ボタンが有効になります。
[サーバーに読み込む] を選択します。進捗バーが末尾に達すると、[Blusam に読み込む] ボタンが有効になります。
Blusam ストレージへのロードプロセスを完了するには、Blusam でのロードを選択します。または、[キャンセル] を選択します。読み込みのプロセスを選択した場合は、読み込みが完了すると右下隅に通知が表示されます:
-
サーバー: このオプションを選択すると、入力フィールドが表示され、[サーバーに読み込む] ボタンが消えます。入力フィールドは、Blusamサーバー上のデータセットファイルへのパスを指定する必要がある場所です (これは、指定されたファイルを最初にBlusamサーバーに転送したことを前提としています）。パスを指定すると、[Blusam に読み込む] が有効になります。
読み込みプロセスを実行了するには、[Blusam に読み込む] を選択します。または、[キャンセル] を選択します。読み込みのプロセスを選択した場合は、読み込みの完了時に通知が表示されます。この通知はブラウザから読み込む場合の通知とは異なり、データファイルサーバーのパスと、サーバーから読み込んだことを示す文字列が表示されます。
-
-
データセットからレコードをエクスポートする
データセットのレコードをエクスポートするには、データセット行にある [アクション] を選択し、[エクスポート] を選択します。
次のポップアップウィンドウが表示されます。
オプション:
送信先: エクスポート先をラジオボタンで選択します。ブラウザでダウンロードするか ([ローカル (ブラウザ)])、BAC アプリケーションをホストする [サーバー] 上のフォルダを指定するかを選択します。[サーバー] を選択すると、新しい入力フィールドが表示されます。
入力フィールドの右側に赤いアスタリスクが表示されるように、サーバー上のフォルダを正しく指定する必要があります (フォルダが指定されない間は [ダンプ] ボタンが無効になります)。
サーバーにエクスポートする場合、そのデータセットファイルをエクスポート後に操作するのであれば、サーバーファイルシステムに対する十分なアクセス権が必要になります。
Zip ダンプ: 未加工のファイルではなく zip されたアーカイブを生成するためのチェックボックス。
オプション: 可変長レコードのデータセットをエクスポートする場合、各レコードの先頭にレコード記述子ワード (RDW) を含めるには、[RDW フィールドを含める] を選択します。
データセットのエクスポートプロセスを起動するには、[ダンプ] を選択します。ブラウザにエクスポートする場合は、データセットファイルをダウンロードするフォルダを確認してください。ファイルの名前はデータセットと同じになります:
メモ:
-
KSDS の場合、レコードはプライマリキーの順序に従ってエクスポートされます。
-
ESDS および RRDS の場合、レコードは RBA (相対バイトアドレス) の順序に従ってエクスポートされます。
-
すべてのデータセットタイプで、レコードはレガシープラットフォームとの互換性を保つために、未加工バイナリ配列でエクスポートされます。
データセットからレコードをクリアする
データセットからすべてのレコードをクリアするには、[アクション] を選択し、[クリア] を選択します。
すべてのレコードがデータセットから削除されると、次の通知が表示されます。
データセットを削除する
データセットを削除するには、[アクション] を選択し、[削除] を選択します。
データセットを削除すると、次の通知が表示されます。
一括操作
次の 3 つの一括操作をデータセットに対して使用できます。
-
エクスポート
-
クリア
-
Delete
一括操作は、データセットのセレクションにのみ使用できます (データセットを 1 つ以上選択する必要があります)。データセットを選択するには、データセットリストの各行の左側にあるチェックボックスをオンにします。データセットを 1 つ以上選択すると、[一括アクション] ドロップダウンリストが有効になります。
選択したアクションが 1 つのデータセットではなく、そのセレクションに適用されることを除けば、前述のものと同じアクションが実行されるため、詳細についてはアクションのドキュメントを参照してください。ポップアップウィンドウに表示されるテキストは、一括アクション向けに多少異なり、例えば、複数のデータセットを削除する場合は、次のようなポップアップウィンドウが表示されます。
作成操作
1 つのデータセットを作成する
[アクション] を選択し、[1 つのデータセットを作成] を選択します。
データセット作成フォームがポップアップウィンドウに表示されます。
データセット定義には、次の属性を指定できます。
-
命名ルールの有効化と無効化: [命名規約の無効化]/[命名規約の有効化] トグルウィジェットを使用して、データセット命名規則を無効化および有効化します。データセットの命名規約のトグルは、デフォルト値である有効化にしておくことをお勧めします (トグルウィジェットには [命名ルールの無効化] と表示されます)。
-
データセット名: データセットの名前。既に使用されている名前を指定すると、次のエラーメッセージが表示されます。
命名規約を有効にしている場合は、規則に従う必要があります。
-
最大レコードサイズ: レコードが固定長である場合に、データセットのレコードサイズを正の整数で指定します。レコードが可変長である場合は空白のままにします。
-
固定長レコード: レコードが固定長か可変長かを指定するチェックボックス。オンにするとデータセットのレコードは固定長になり、オフにすると可変長になります。
レガシーデータを可変長レコードのデータセットにインポートする場合、入力されるレガシーレコードに、各レコードの長さを示すレコード記述子ワード (RDW) を含めることができます。
-
データセットタイプ: 現在のデータセットのタイプを指定するドロップダウンリスト。次のタイプがサポートされます。
-
ESDS
-
LargeESDS
-
KSDS
KSDS の場合は、プライマリキーを指定する必要があります。
[プライマリキー] では、以下を指定します。
-
名前: このフィールドはオプションです。デフォルトは
PKです。 -
オフセット: レコード内のプライマリキーの 0 ベースのオフセット。オフセットは正の整数である必要があります。このフィールドは必須です。
-
長さ: プライマリキーの長さ。長さは正の整数である必要があります。このフィールドは必須です。
KSDS と ESDS の場合はオプションで代替キーのコレクションを定義できます。代替キーのラベルの前にあるプラスボタンを選択して定義します。プラスボタンを選択するたびに、新しい代替キー定義セクションがデータセット作成フォームに表示されます。
代替キーごとに、以下を指定する必要があります。
-
名前: このフィールドはオプションです。デフォルト値は
ALTK_#です (# は 0 で始まる自動増分カウンターです)。 -
オフセット: レコード内の代替キーの 0 ベースのオフセット。厳密な正の整数である必要があります。このフィールドは必須です。
-
長さ: 代替キーの長さ。長さは正の整数である必要があります。このフィールドは必須です。
-
一意: 代替キーに重複エントリが許可されるかどうかを示すチェックボックス。オンにすると、代替キーは一意で定義されます (キーエントリの重複は許可されません)。このフィールドは必須です。
代替キー定義を削除するには、左側のごみ箱ボタンを使用します。
-
-
圧縮: データセットの保存時に圧縮を使用するかどうかを指定するチェックボックス。
-
起動時にキャッシュを有効にする: アプリケーションの起動時にデータセットをキャッシュに読み込むかどうかを指定するチェックボックス。
属性を定義したら、[作成] を選択して続行します。
作成ウィンドウが閉じて、データセットのリストを示すホームページが表示されます。新しく作成されたデータセットの情報を確認できます。
マルチスキーマモードで単一のデータセットを作成する
データセットは、データセット名の前にスキーマ名を付加し、その後にパイプ (|) 記号 (例: ) を付けることで、マルチスキーマモードで作成できますschema1|AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS。
注記
データセットの作成に使用されるスキーマは、application-main.yml設定で指定する必要があります。詳細については、「マルチスキーマ設定プロパティ」を参照してください。
スキーマプレフィックスが指定されていない場合、データセットはデータソースBlusam設定のBlusamデータソース URL で指定されたデフォルトのスキーマに作成されます。Blusam データソース URL にスキーマが指定されていない場合、デフォルトで「パブリック」スキーマが使用されます。
注記
マルチスキーマモードでは、BAC コンソールはデータセットのスキーマ情報を最初の列に表示します。
LISTCAT からデータセットを作成する
この機能を使用すると、レガシープラットフォームからの LISTCAT エクスポートを解析した結果、AWS Transform for mainframe refactor Transformation Center を使用して AWS Transform for mainframe transformation プロセス中に作成された LISTCAT JSON ファイルを活用できます。LISTCAT エクスポートは解析され、データセット定義 (名前、データセットタイプ、キー定義、レコードの長さが固定か可変か) を保持する JSON ファイルに変換されます。
LISTCAT JSON ファイルを使用すると、データセットに必要なすべての情報を手動で入力することなく簡単に作成できます。また、データセットを 1 つずつ作成するのではなく、コレクションを簡単に作成することもできます。
プロジェクトに LISTCAT JON ファイルがない場合は (変換時に LISTCAT エクスポートファイルがなかった場合など)、付録に記載されている LISTCAT JSON の形式に従っていつでも手動で作成できます。
[アクションの作成] ドロップダウンリストから、[LISTCAT からデータセットを作成する] を選択します。
次のページが表示されます。
この段階では、[読み込み] ボタンは無効になっています。
ラジオボタンを使用して、LISTCAT JSON ファイルの選択方法を指定します。2 つのオプションがあります。
-
ブラウザを使用して JSON ファイルをアップロードします。
-
サーバー上のフォルダの場所から JSON ファイルを選択します。このオプションを選択する場合には、まず JSON ファイルを、サーバー上の指定されたフォルダパス (アクセス許可が必要です) にコピーする必要があります。
サーバーにある JSON ファイルを使用するには
-
サーバー上の LISTCAT JSON ファイルを含むフォルダのパスを指定します。
-
[読み込み] ボタンを選択します。認識されたすべてのデータセット定義がテーブルに一覧表示されます。
各行はデータセット定義を表します。ごみ箱ボタンを使用して、リストからデータセット定義を削除できます。
重要
警告メッセージなしで、リストからすぐに削除されます。
-
左側の名前にはリンクが貼られており、選択すると、データセット定義の情報 (編集可能) を表示または非表示にできます。定義は、解析後の JSON ファイルをベースに自由に変更できます。
-
すべてのデータセットを作成するには、[作成] を選択します。すべてのデータセットが作成され、データセットの結果ページに表示されます。新しく作成されたデータセットでは、レコード数はすべて 0 になります。
サーバーにファイルをアップロードするには
-
このオプションは、サーバーのフォルダパスにあるファイルを使用する操作に似ていますが、最初にファイルセレクタを使用してファイルをアップロードする必要があります。ローカルマシンからアップロードするすべてのファイルを選択し、[サーバーに読み込む] を選択します。
-
進行状況バーが末尾に到達すると、すべてのファイルがサーバーに正常にアップロードされ、[読み込み] ボタンが有効になります。[読み込み] ボタンを選択し、前述のように検出されたデータセット定義を使用します。
