Hitachi Command Suite Software
Mainframe Agent ユーザーズガイド

3020-3-W09-10

目次

前書き

はじめに

対象読者

マニュアルの構成

関連マニュアル

読書手順

このマニュアルでの表記

このマニュアルで使用している記号

図中で使用する記号

KB（キロバイト）などの単位表記について

1. 概要

1.1 導入の目的

1.2 前提条件

1.2.1 前提OS

1.2.2 前提プログラム

1.2.3 前提機器

1.3 システム構成例

1.3.1 Device Managerでストレージ情報を参照する

1.3.2 Replication ManagerでPPRCコピーペアを監視する

1.3.3 Device Managerでストレージ情報を参照し，Replication ManagerでPPRCコピーペアの監視をする

2. インストール

2.1 インストールの概要

2.2 インストール前の確認

2.2.1 提供されるデータセット

2.2.2 ライブラリデータセットのストレージ属性

2.2.3 メモリー所要量

2.3 インストール手順

2.3.1 Mainframe Agentのインストール

2.3.2 REXX代替ライブラリのインストール

2.3.3 YKALCSVCコマンドの利用設定

2.3.4 ユーザSVCの登録

2.3.5 YKP2Aコマンドの利用設定

2.4 バージョンアップ手順

2.4.1 バージョンアップ時の注意事項

2.4.2 バージョンアップ前の確認

2.4.3 データセットのバックアップ

2.4.4 バージョンアップ前の作業

2.4.5 Mainframe Agentのバージョンアップ

2.4.6 バージョンアップ後の確認

3. 環境設定

3.1 TCP/IPのポート番号の設定

3.2 セキュリティーの設定

3.2.1 データセットセキュリティーの設定

3.2.2 リソース・アクセス管理機能（RACF）の環境設定

3.3 IBM HTTP Serverの設定

3.3.1 IPv6接続するための設定

3.3.2 トレースログの採取

3.4 初期設定パラメーターの作成

3.4.1 SETINITコマンドの使用方法

3.4.2 初期設定パラメーターの詳細

3.4.3 初期設定パラメーターの指定例

3.4.4 初期設定パラメーターの解析結果例

3.5 起動用カタログドプロシジャの作成

3.5.1 標準の起動用カタログドプロシジャ

3.5.2 起動用カタログドプロシジャの変更

3.6 Device Managerの環境設定

3.6.1 メインフレームのストレージ情報の表示

3.6.2 メインフレームのストレージ情報の更新

3.6.3 Mainframe Agentの登録情報の取得

3.6.4 Mainframe Agentの登録情報の変更

3.6.5 Mainframe Agentの登録情報の削除

3.6.6 メインフレームホスト情報の取得

3.6.7 メインフレームホスト情報の変更

3.6.8 メインフレームホストの削除

3.7 Replication Managerの環境設定

3.7.1 情報取得元を登録する

3.7.2 構成情報を取得する周期を設定する

3.7.3 コピーペア状態の情報取得周期を設定する

4. 運用

4.1 Device Managerでメインフレーム系ストレージ情報を取得する運用

4.1.1 運用の概要

4.1.2 導入時の運用手順

4.1.3 構成変更時の運用手順

4.2 Replication ManagerでPPRCコピーペアを監視する運用

4.2.1 運用の概要

4.2.2 運用手順

4.2.3 コピーグループ定義生成機能の前提条件

4.2.4 YKP2Aコマンド

4.2.5 Configurationファイルの生成例

4.3 運用コマンド

4.3.1 Mainframe Agentの起動

4.3.2 Mainframe Agentの正常終了

4.3.3 Mainframe Agentの強制終了

4.3.4 ログの出力レベルの表示

4.3.5 ログの出力レベルの変更

5. メッセージ

5.1 メッセージの形式

5.1.1 メッセージの出力形式

5.1.2 メッセージの記載形式

5.2 メッセージの出力先

5.3 メッセージ一覧

5.4 ユーザー完了コード

6. トラブルシューティング

6.1 ログの採取

6.2 Mainframe Agentが起動できない場合の対策

6.3 Mainframe Agentからの情報が更新されない場合の対策

付録A. コマンドの記載形式

A.1 コマンドの文法説明で使用する記号

A.2 コマンドの構文要素

用語解説

索引

前書き

対象製品

Hitachi Device Manager Mainframe Agent 7.1

（適用OS：OS/390，z/OS）

輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。

なお，ご不明な場合は，弊社担当営業にお問い合わせください。

商標類

IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。

MVSは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。

OS/390は，米国およびその他の国におけるInternational Business Machines Corporationの商標です。

RACFは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。

UNIXは，The Open Groupの米国ならびに他の国における登録商標です。

WebSphereは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。

z/OSは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。

zSeriesは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。

発行

2011年4月（第2版）3020-3-W09-10

著作権

All Rights Reserved. Copyright (C) 2011, Hitachi, Ltd.

はじめに

このマニュアルは，Hitachi Device Manager Mainframe Agentの使い方について説明したものです。

以降，上記製品の略称としてMainframe Agentと表記します。

はじめにの構成

対象読者

マニュアルの構成

関連マニュアル

読書手順

このマニュアルでの表記

このマニュアルで使用している記号

図中で使用する記号

KB（キロバイト）などの単位表記について

対象読者

このマニュアルでは，Mainframe Agentのインストールから運用までを行うシステム管理者を対象としています。

また，対象読者には次の知識があることを前提としています。

基本的な通信関係の知識

Mainframe Agentの前提オペレーティングシステムであるOS/390，z/OSについての基本的な知識

Device Managerの知識

Replication Managerと連携する場合は，Replication Managerの知識

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　概要

Mainframe Agentを導入する目的，前提条件，およびシステム構成例について説明しています。

第2章　インストール

Mainframe Agentのインストールの概要，インストール前の確認事項，インストール手順，およびバージョンアップ手順について説明しています。

第3章　環境設定

Device ManagerおよびReplication Managerと連携して，Mainframe Agentを使用してストレージの情報を取得するための環境設定について説明しています。

第4章　運用

オープンシステムから，メインフレームで管理しているストレージ情報を取得したり，PPRCコピーペアを監視したりするための運用方法について説明します。

第5章　メッセージ

Mainframe Agentが出力するメッセージについて説明しています。

第6章　トラブルシューティング

Mainframe Agentのトラブルシューティングについて説明しています。

付録A　コマンドの記載形式

コマンドの文法説明で使用する記号および構文要素について説明しています。

用語解説

このマニュアルで使用する用語について説明しています。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

Hitachi Command Suite製品関連

Hitachi Command Suite Software CLIリファレンスガイド（3020-3-W03）

Hitachi Command Suite Replication Manager Software ユーザーズガイド（3020-3-W81）

OS/390

Communications Server: IP User's Guide and Commands（GC31-8514）

MVS システム・コード（GC88-6591）

MVS システム・コマンド（GC88-6592）

Program Directory for IBM Library for REXX on zSeries Alternate Library（GI10-3243）

eNetwork Communications Server: IP API Guide（SC31-8516）

Security Server RACF セキュリティー管理者のガイド（SC88-6551）

MVS 初期設定およびチューニング 解説書（SC88-6576）

TSO/E REXX 解説書（SC88-6685）

Communications Server IP 構成ガイド（SC88-8740）

Communications Server IP 構成解説書（SC88-8741）

z/OS

Program Directory for IBM Library for REXX on zSeries Alternate Library（GI10-3243）

MVS 初期設定およびチューニング 解説書（SA88-8564）

MVS システム・コード（SA88-8592）

MVS システム・コマンド（SA88-8593）

Security Server RACF セキュリティー管理者のガイド（SA88-8613）

Security Server RACROUTE マクロ解説書（SA88-8621）

TSO/E REXX 解説書（SA88-8635）

Communications Server IP 構成ガイド（SC88-8926）

Communications Server IP 構成解説書（SC88-8927）

Communications Server IP ユーザーズ・ガイドとコマンド（SC88-8931）

Communications Server IP アプリケーション・プログラミング・インターフェース・ガイド（SC88-8932）

読書手順

このマニュアルは，利用目的に合わせて章を選択してお読みいただけます。利用目的別に，次の表に従ってお読みいただくことをお勧めします。

マニュアルを読む目的 | 記述個所
Mainframe Agentの概要を知りたい。 | 1章，用語解説
Mainframe Agentをインストールし，環境を設定したい。 | 2章，3章
Mainframe Agentの運用手順を知りたい。 | 4章
Mainframe Agentを運用中に発生したトラブルの対処方法を知りたい。 | 5章，6章

このマニュアルでの表記

このマニュアルでは，製品の名称などを省略して表記しています。このマニュアルでの表記と，製品の正式名称または意味を次に示します。

表記
製品名称，または意味

BLKSIZE
BLocK SIZE

DASD
Direct Access Storage Device

Device Manager
Hitachi Device Manager Software

DKC
DisK Controller

DSORG
DataSet ORGanization

FMID
Function Modification IDentifier

GMT
Greenwich Mean Time

Hitachi USP
次の製品を区別する必要がない場合の表記です。

Hitachi Universal Storage Platform

Hitachi Network Storage Controller

HTTP
HyperText Transfer Protocol

IBM HTTP Server
IBM HTTP Server for z/OS

IPL
Initial Program Load

IPv4
Internet Protocol Version 4

IPv6
Internet Protocol Version 6

LRECL
Logical RECord Length

MCS
Modification Control Statements

OS
Operating System

PC
Personal Computer

PPRC
Peer to Peer Remote Copy

RACF
Resource Access Control Facility

RECFM
RECord ForMat

Replication Manager
Hitachi Replication Manager Software

REXX
REstructured eXtended eXecutor

SAF
System Authorization Facility

SI
ShadowImage for Mainframe

TC
TrueCopy for Mainframe

TCA

TCP/IP
Transmission Control Protocol/Internet Protocol

Universal Storage Platform V/VM
次の製品を区別する必要がない場合の表記です。

Hitachi Universal Storage Platform V

Hitachi Universal Storage Platform VM

Virtual Storage Platform
Hitachi Virtual Storage Platform

VM
Virtual Machine

VTOC
Volume Table Of Contents

XML
eXtensible Markup Language

このマニュアルで使用している記号

このマニュアルで使用している記号を次に示します。

記号 | 意味
斜体 | 利用環境や操作状況によって異なる値であることを示します。

図中で使用する記号

このマニュアルの図中で使用する記号を，次のように定義します。

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1. 概要

この章では，Mainframe Agentを導入する目的，前提条件，およびシステム構成例について説明します。

この章の構成

1.1 導入の目的

1.2 前提条件

1.3 システム構成例

1.1 導入の目的

Mainframe Agentは，メインフレーム系ストレージの情報をDevice ManagerまたはReplication ManagerのGUIに表示させるための製品です。Device ManagerまたはReplication Managerからの要求によって，メインフレーム系ストレージの情報を収集し，Device ManagerまたはReplication Managerに渡します。

Mainframe Agentを導入すると，オープン系とメインフレーム系のストレージをDevice Managerだけで管理できるようになるため，管理に掛かる手間とコストを削減できます。

また，Replication Managerと連携すると，Replication ManagerからPPRCコピーペアの監視ができます。

1.2 前提条件

Mainframe Agentを使用するための前提条件について説明します。

この節の構成

1.2.1 前提OS

1.2.2 前提プログラム

1.2.3 前提機器

1.2.1 前提OS

Mainframe Agentは，次のOSで使用できます。

OS/390 V2R10

z/OS V1R1～V1R12
Device ManagerまたはReplication ManagerがMainframe AgentとIPv6接続する場合のz/OSの適用バージョンはV1R9以降です。

注意

VM環境は対象外です。

代替サブチャネルセットのデバイスは使用できません。

1.2.2 前提プログラム

Mainframe Agentを使用するための前提プログラムを次の表に示します。

表1-1 前提プログラム

プログラム名
必須/任意
概要
説明

IBM Communications Server（OS標準搭載）
必須
通信プログラムです。
なし

Security Server（RACF）
必須
IBMのセキュリティ管理プロダクトです。
なし

TSO/E REXX（OS標準搭載）
必須
Mainframe Agentを実行するための前提プログラムです。
なし

TSO/E（OS標準搭載）
必須
なし

IBM Library for REXX on zSeries Release 4（FMID HWJ9140）または
IBM Library for REXX on zSeries Alternate Library（FMID HWJ9143）
必須
どちらのライブラリもない場合，REXX代替ライブラリ（FMID HWJ9143，JWJ9144）が必要です。
z/OS V1R9以降では，REXX代替ライブラリはOS標準提供です。

Device Manager
必須
Hitachi Command Suite製品の一つで，メインフレームホストが管理するストレージ情報を参照するために必要です。
適用バージョンは，7.1です。

Replication Manager
任意
Hitachi Command Suite製品の一つで，PPRCコピーペアの状態を監視する場合に必要です。
適用バージョンは，7.1です。

IBM HTTP Server for z/OS
任意
WebSphere Application Server for z/OSに同梱されているオプション製品で，Device ManagerまたはReplication ManagerとIPv6接続する場合に必要です。
適用バージョンは，6.1です。

1.2.3 前提機器

Mainframe Agentは，次の日立ストレージシステムを対象としています。

SANRISE9900Vシリーズ

Hitachi USP

Universal Storage Platform V/VM

Virtual Storage Platform

1.3 システム構成例

次のような構成があります。

Device Managerでメインフレームホストが管理するストレージ情報を参照する

Replication Managerでメインフレームホストが管理するPPRCコピーペアの状態を監視する

Device Managerでメインフレームホストが管理するストレージ情報を参照し，Replication Managerでメインフレームホストが管理するPPRCコピーペアの状態を監視する

この節の構成

1.3.1 Device Managerでストレージ情報を参照する

1.3.2 Replication ManagerでPPRCコピーペアを監視する

1.3.3 Device Managerでストレージ情報を参照し，Replication ManagerでPPRCコピーペアの監視をする

1.3.1 Device Managerでストレージ情報を参照する

Mainframe AgentとDevice Managerが連携して，GUI上にメインフレームホストが管理するストレージ情報を表示できます。

Device Managerでメインフレームホストが管理するストレージ情報を参照するための構成を次の図に示します。

図1-1 メインフレームホストが管理するストレージ情報を参照するための構成

1.3.2 Replication ManagerでPPRCコピーペアを監視する

Replication ManagerからPPRCコピーペアの状態を監視できます。Replication ManagerでPPRCコピーペアを監視するための構成を次の図に示します。

図1-2 Replication ManagerでPPRCコピーペアを監視するための構成

PPRCコピーペアの状態を監視するために，Mainframe AgentのConfigurationファイル（ディスク構成定義ファイルおよびコピーグループ定義ファイル）が必要です。詳細は，「4.2 Replication ManagerでPPRCコピーペアを監視する運用」を参照してください。

1.3.3 Device Managerでストレージ情報を参照し，Replication ManagerでPPRCコピーペアの監視をする

Device Managerでメインフレームホストが管理するストレージ情報を参照し，Replication Managerでメインフレームホストが管理するPPRCコピーペアの状態を監視するための構成を次の図に示します。

図1-3 Device Managerでメインフレームホストが管理するストレージ情報を参照し，Replication ManagerでPPRCコピーペアを監視するための構成

PPRCコピーペアの状態を監視するために，Mainframe AgentのConfigurationファイル（ディスク構成定義ファイルおよびコピーグループ定義ファイル）が必要です。詳細は，「4.2 Replication ManagerでPPRCコピーペアを監視する運用」を参照してください。

2. インストール

この章では，Mainframe Agentのインストールの概要，インストール前の確認事項，インストール手順，およびバージョンアップ手順について説明します。

この章の構成

2.1 インストールの概要

2.2 インストール前の確認

2.3 インストール手順

2.4 バージョンアップ手順

2.1 インストールの概要

Mainframe Agentのインストールの概要を次の図に示します。

図2-1 Mainframe Agentのインストールの概要

2.2 インストール前の確認

Mainframe Agentをインストールする前の確認事項について説明します。

この節の構成

2.2.1 提供されるデータセット

2.2.2 ライブラリデータセットのストレージ属性

2.2.3 メモリー所要量

2.2.1 提供されるデータセット

インストールCD-ROMに格納されているデータセットの一覧を次の表に示します。

表2-1 インストールCD-ROMに格納されているデータセット

インストールCD-ROM上のデータセット名 | ライブラリの種類 | 内容
MFAGENT.Vnnnn.SAMPLIB.XMIT | SAMPLIB | 標準提供するサンプル（Mainframe Agent用初期設定パラメーター，Mainframe Agent起動用カタログドプロシジャ）
MFAGENT.Vnnnn.LINKLIB.XMIT | LINKLIB | Mainframe Agentのロードモジュール
MFAGENT.Vnnnn.LPALIB.XMIT | LPALIB | SVCモジュール
MFAGENT.Vnnnn.PROCLIB.XMIT | PROCLIB | カタログドプロシジャ
MFAGENT.Vnnnn.EXECLIB.XMIT | EXECLIB | Mainframe AgentのREXX Exec
MFAGENT.Vnnnn.SMPMCS.XMIT※ | REXX代替ライブラリ | REXX代替ライブラリのSMP/E制御ステートメント
IBM.HWJ9143.F1.XMIT※ | REXX代替ライブラリリンケージパラメーター，組み込みのサンプルJCL
IBM.HWJ9143.F2.XMIT※ | REXX代替ライブラリのオブジェクトモジュール
IBM.HWJ9143.F3.XMIT※ | REXX代替ライブラリのメッセージライブラリ
IBM.JWJ9144.F1.XMIT※ | REXX代替ライブラリ日本語機能
YKAGALLO.JCL（非圧縮テキストファイル） | インストールJCL | Mainframe Agent用インストールJCL（転送用データセットの割り当て）
YKAGINST.JCL（非圧縮テキストファイル） | Mainframe Agent用インストールJCL（実行用データセットの割り当てと実行用データセットへの抽出）

注　表中の「Vnnnn」の「nnnn」部分は，バージョンによって異なります。

注※　z/OS V1R9以降を使用している場合は不要です。これらのデータセットは，z/OS V1R9より前のバージョンを使用していて，かつREXX代替ライブラリを使用する場合にだけ必要です。

2.2.2 ライブラリデータセットのストレージ属性

インストールJCLを実行すると，Mainframe Agentは次の表に示すストレージ属性を持つライブラリデータセットに登録されます。

表2-2 ライブラリデータセットのストレージ属性

ライブラリの種類
DSORG
RECFM
LRECL
（バイト）
BLKSIZE
（バイト）

SAMPLIB（サンプルライブラリ）
PO
FB
80
3,120

LINKLIB（ロードライブラリ）
PO
U
－
6,144

LPALIB（ロードライブラリ）
PO
U
－
6,144

PROCLIB（カタログドプロシジャライブラリ）
PO
FB
80
3,120

EXECLIB（REXX Execライブラリ）
PO
FB
80
3,120

（凡例）

PO：区分・データセット

FB：固定長ブロックレコード

U：不定長レコード

2.2.3 メモリー所要量

Mainframe Agentを実行するのに必要なメモリー所要量を次に示します。メモリー所要量の単位はKBです。また，計算式中の「↑」は，「↑」で挟まれている数値の小数点以下を切り上げることを示します。

Device Managerと連携する場合

16MB未満のユーザーリージョン：2,048

16MB以上の拡張ユーザーリージョン：
3,072＋D＋↑(64×指定したDEVNパラメーターの数)÷1,024↑
D：初期設定パラメーターDEVNに指定した中で最も多い装置数を入力します。

Replication Managerと連携する場合

16MB未満のユーザーリージョン：2,048

16MB以上の拡張ユーザーリージョン：
6000＋A＋↑（512×指定したPREFIXパラメーターの数)÷1024↑＋↑（64×指定したDEVNパラメーターの数）÷1024↑
A：(1.5×D)と(3×P)の大きい方の値を入力します。
D：初期設定パラメーターDEVNに指定した中で最も多い装置数を入力します。
P：Mainframe Agentが使用するコピーグループの中で，最も多いペア数を入力します。

2.3 インストール手順

Mainframe Agentをインストールする手順について説明します。

この節の構成

2.3.1 Mainframe Agentのインストール

2.3.2 REXX代替ライブラリのインストール

2.3.3 YKALCSVCコマンドの利用設定

2.3.4 ユーザSVCの登録

2.3.5 YKP2Aコマンドの利用設定

2.3.1 Mainframe Agentのインストール

Mainframe Agentのインストールの流れを次に示します。

図2-2 Mainframe Agentのインストールの流れ

Mainframe Agentのインストール手順を次に示します。操作手順は，「図2-2：Mainframe Agentのインストールの流れ」の数字と対応しています。

インストールCD-ROMをPCにセットする。

次のインストールJCLをPCからホストマシンにASCIIモードで転送する。

転送用データセットを割り当てるJCL（YKAGALLO）

実行用データセットを割り当て，実行用データセットに抽出するJCL（YKAGINST）

手順2で転送したJCLをインストールする環境に合わせて修正する。
詳細については，各JCLの先頭を参照してください。

転送用データセットを作成する（修正したYKAGALLOジョブを実行）。
YKAGALLOジョブは，ホストマシン上にMainframe AgentのオブジェクトアーカイブおよびREXX代替ライブラリアーカイブを転送するための順次・データセットを作成します。

Mainframe AgentのオブジェクトアーカイブおよびREXX代替ライブラリアーカイブを，PCからホストマシン上の転送用データセットにバイナリー転送する。
REXX代替ライブラリアーカイブの転送は，REXX代替ライブラリをインストールする場合に必要です。

オブジェクトおよびライブラリを実行用データセットに抽出する（修正したYKAGINSTジョブを実行）。
YKAGINSTジョブは，実行用データセットを割り当ててから，オブジェクトおよびライブラリを転送用データセットのアーカイブから実行用データセットに抽出します。

2.3.2 REXX代替ライブラリのインストール

次のどちらのREXXライブラリもない場合は，REXX代替ライブラリ（FMID：HWJ9143，JWJ9144）が必要です。なお，FMIDに対応するMCS（Modification Control Statements）は，「表2-1 インストールCD-ROMに格納されているデータセット」のMFAGENT.Vnnnn.SMPMCS.XMITデータセットに格納されています。

IBM Library for REXX on zSeries Release 4（FMID HWJ9140）

IBM Library for REXX on zSeries Alternate Library（FMID HWJ9143）

REXX代替ライブラリのインストール方法については，マニュアル「Program Directory for IBM Library for REXX on zSeries Alternate Library（GI10-3243-01）」の6章を参照してください。

2.3.3 YKALCSVCコマンドの利用設定

YKALCSVCコマンドはユーザSVCを登録するコマンドで，STARTコマンド（OSコマンド）によって起動されます。

YKALCSVCコマンドを利用できるようにするには，次の手順を実行します。

LINKLIBライブラリ（Mainframe Agentのロードライブラリ）をPROGxx parmlibメンバに定義し，SETPROG APF,ADDコマンドを使用してAPF認可登録する。

LINKLIBライブラリ（Mainframe Agentのロードライブラリ）を，YKALCSVCコマンドのカタログドプロシジャにSTEPLIB DD文で指定する。

次のどちらかの手順を実行します。

MSTJCLxx parmlibメンバ内のdd名IEFPDSIに，Mainframe Agentのカタログドプロシジャライブラリを連結します。

YKALCSVCメンバを，Mainframe AgentのカタログドプロシジャライブラリからユーザーのPROCLIBにコピーします。

YKALCSVCコマンドをCOMMNDxx parmlibメンバに追加しておくと，再IPL時に自動的に実行できます。

YKALCSVCコマンドの形式を次に示します。コマンドの文法説明で使用する記号については「表A-1 コマンドの文法説明で使用する記号」，コマンドの構文要素については「表A-2 コマンドの構文要素」を参照してください。

形式

START YKALCSVC[，PARM='{SVC番号｜DELETE}']

機能

ユーザSVCを登録または削除します。

パラメーター

SVC番号～<数字> ((200～255))

ユーザSVCに割り当てるSVC番号を指定します。

DELETE

ユーザSVCを削除する場合に指定します。

PARM以降を省略した場合，使用していない200から255の間のSVC番号を割り当てます。

リターンコード

表2-3 YKALCSVCコマンドのリターンコード一覧

リターンコード | 意味
0 | 正常終了しました。
4 | SVC番号はすでに登録されています。
16 | SVC番号の登録または削除に失敗しました。
20 | エラー（指定値や実行環境の誤り）が発生したため，処理を中止しました。

2.3.4 ユーザSVCの登録

ユーザSVCを使用するためには，次のどちらかの方法でユーザSVCを登録する必要があります。

IEASVCxx parmlibメンバに定義して静的に登録する。

YKALCSVCコマンドを使用して動的に登録する。

IEASVCxx parmlibメンバで登録する場合はシステムの再IPLが必要です。システム稼働中で再IPLを実施できない場合は，YKALCSVCコマンドで登録してください。

注意

Hitachi Business Continuity Managerがインストールされている場合，ユーザSVCの登録は行わないでください。

この項の構成

(1) IEASVCxx parmlibメンバでの登録

(2) YKALCSVCコマンドでの登録

(1) IEASVCxx parmlibメンバでの登録

次の手順でユーザSVCを登録します。なお，手順2および手順4の詳細については，マニュアル「MVS 初期設定およびチューニング解説書」を参照してください。

ユーザSVCに割り当てるSVC番号を200から255の間で決める。

次のSYMDEF文（&YKSVCNOシステム・シンボル）をIEASYMxx parmlibメンバに定義する。

SYMDEF(&YKSVCNO='SVC番号')

注意

SVC番号には，200から255の間の10進数を指定します。

Mainframe AgentのLPALIBライブラリをLPALSTに連結するために，次のどちらかの手順を実行する。

LPALSTxx parmlibメンバにMainframe AgentのLPALIBライブラリを定義します。詳細については，マニュアル「MVS 初期設定およびチューニング解説書」を参照してください。

SETPROG LPAコマンドを使用して，Mainframe AgentのLPALIBライブラリをLPALSTに動的に連結します。詳細については，マニュアル「MVS システム・コマンド」を参照してください。

次のSVCPARM文をIEASVCxx parmlibメンバに定義する。

SVCPARM   SVC番号,REPLACE,TYPE(3),EPNAME(JYUASVC)

CLPAパラメーターを指定して再IPLを行う。

(2) YKALCSVCコマンドでの登録

YKALCSVCコマンドの実行方法を次に示します。YKALCSVCコマンドの形式については，「2.3.3 YKALCSVCコマンドの利用設定」を参照してください。

システム起動時，またはMainframe Agent使用前に，YKALCSVCコマンドを実行してユーザSVCを動的に登録します。

SVC番号を指定する場合，次のとおり実行します。

START YKALCSVC，PARM='SVC番号'

指定されたSVC番号にすでに別のユーザSVCが割り当てられている場合，エラーになります。

次のようにPARMパラメーターを省略すると，200から255の間で使用されていないSVC番号が割り当てられます。

START YKALCSVC

ユーザSVCを削除する場合，パラメーターにDELETEを指定してYKALCSVCコマンドを実行してください。

START YKALCSVC，PARM='DELETE'

注意

Mainframe Agent動作中にYKALCSVCコマンドでユーザSVCを削除した場合，Device Manager，またはReplication Managerにストレージ情報が正しく渡されないことがあります。

Mainframe Agent動作中にYKALCSVCコマンドでユーザSVCを登録した場合，実行中のCLIコマンドはIEASVCxx parmlibメンバで定義されたユーザSVCで実行されます。登録したユーザSVCは新たに実行されるDevice Manager，またはReplication Managerの要求から有効になります。

YKALCSVCコマンドで登録したユーザSVCは再IPLで無効になります。次回の再IPLに備えて，次のどちらかの設定をしておくことを推奨します。
・YKALCSVCコマンドをCOMMNDxx parmlibメンバに追加して，再IPL時に自動的にユーザSVCを再登録する。
・IEASVCxx parmlibメンバにユーザSVCを定義し，次回IPLから静的に登録されたユーザSVCを使用する。

古いバージョンのYKALCSVCコマンドで登録したユーザSVCルーチンは，古いバージョンのYKALCSVCコマンドを使用して削除してください。バージョンが混在している場合のバージョンアップ時にはご注意ください。

2.3.5 YKP2Aコマンドの利用設定

Mainframe Agentは，TSO/EコマンドであるYKP2Aコマンドを提供します。YKP2AコマンドをTSO/E環境で利用できるようにするために，次の手順を実行してください。

EXECLIB（REXX Execライブラリ）をdd名SYSEXECに連結する。

LINKLIB（ロードライブラリ）をdd名TSOLIBに連結する。

2.4 バージョンアップ手順

Mainframe Agentをバージョンアップする手順について説明します。

この節の構成

2.4.1 バージョンアップ時の注意事項

2.4.2 バージョンアップ前の確認

2.4.3 データセットのバックアップ

2.4.4 バージョンアップ前の作業

2.4.5 Mainframe Agentのバージョンアップ

2.4.6 バージョンアップ後の確認

2.4.1 バージョンアップ時の注意事項

Mainframe Agent 05-70以前から06-00以降にバージョンアップする場合，RACFのFACILITYクラスに次のどちらかのプロファイルを定義したあと，定義したプロファイルの参照権限を管理ユーザーIDに与えてください。

STGADMIN.YKA.BCM.YKQUERYプロファイル

STGADMIN.YKA.BCM.COMMANDSプロファイル

詳細は，「3.2.2 リソース・アクセス管理機能（RACF）の環境設定」を参照してください。

2.4.2 バージョンアップ前の確認

この項の構成

(1) Device Managerのバージョンアップ時期の確認

(2) ユーザSVC番号の確認

(1) Device Managerのバージョンアップ時期の確認

Mainframe AgentはDevice Managerと一緒に提供されるため，サーバホストとメインフレームホストを同時にバージョンアップするようにしてください。

(2) ユーザSVC番号の確認

新しいバージョンのインストール時に使用するため，ユーザSVC番号を確認しておきます。ユーザSVC番号の確認方法は，ユーザSVCを動的に登録しているか静的に登録しているかによって異なります。

ユーザSVCを動的に登録している場合
YKALCSVCコマンドのパラメーターに指定している値を確認しておきます。

ユーザSVCを静的に登録している場合
＆YKSVCNOシステム・シンボルの設定値を確認しておきます。

2.4.3 データセットのバックアップ

次のデータセットのバックアップを取得します。

起動用カタログドプロシジャ（標準提供メンバ名称：YKAGENTD）

初期設定パラメーター（標準提供メンバ名称：YKPRM00）

Mainframe Agentをインストールしたデータセット

2.4.4 バージョンアップ前の作業

この項の構成

(1) ユーザSVCの削除

(2) カタログドプロシジャライブラリの連結解除

(3) ロードライブラリの連結解除

(1) ユーザSVCの削除

バージョンアップする場合，必ず古いバージョンのユーザSVCを削除してから新しいバージョンをインストールしてください。

ユーザSVCをYKALCSVCコマンドで動的に登録している場合は，YKALCSVCコマンドを使用してユーザSVCを削除します。

ユーザSVCをIEASVCxx parmlibメンバで静的に登録している場合は，YKALCSVCコマンドでは削除できません。次の手順でユーザSVCを削除してください。なお，手順1および2の詳細については，マニュアル「MVS 初期設定およびチューニング解説書」を参照してください。

IEASYMxx parmlibメンバで，&YKSVCNOシステム・シンボルのSYMDEF文を次のとおり無効化（コメントアウト）する。

/* SYMDEF(&YKSVCNO='SVC番号') */

IEASVCxx parmlibメンバで，JYUASVCモジュールのSVCPARM文を次のとおり無効化（コメントアウト）する。

/* SVCPARM   SVC番号,REPLACE,TYPE(3),EPNAME(JYUASVC) */

CLPAパラメーターを指定して再IPLを行う。

(2) カタログドプロシジャライブラリの連結解除

次の表に示すライブラリのデータセット連結を解除してください。

表2-4 バージョンアップ前にデータセット連結を解除するライブラリ

dd名 | ライブラリ名
IEFPDSI | カタログドプロシジャライブラリPROCLIB

PROCLIBライブラリのメンバを，ユーザーのPROCLIBにコピーして使用している場合は，コピー先のメンバを削除してください。

(3) ロードライブラリの連結解除

LPALSTに連結したLPALIBロードライブラリを解除してください。

2.4.5 Mainframe Agentのバージョンアップ

「2.2 インストール前の確認」および「2.3 インストール手順」に従って，移行後のMainframe Agentをインストールします。

IBM Library for REXX on zSeries Release 4（FMID HWJ9140）またはIBM Library for REXX on zSeries Alternate Library（FMID HWJ9143）のインストールが完了している場合，「2.3.2 REXX代替ライブラリのインストール」の実施は不要です。

2.4.6 バージョンアップ後の確認

移行後のバージョンのMainframe Agentをインストールしたあとで，「2.4.2 バージョンアップ前の確認」で確認した内容と，バージョンアップ後の内容が一致していることを確認します。

3. 環境設定

この章では，Mainframe Agentを使用してストレージの情報を取得するための環境設定について説明します。

この章の構成

3.1 TCP/IPのポート番号の設定

3.2 セキュリティーの設定

3.3 IBM HTTP Serverの設定

3.4 初期設定パラメーターの作成

3.5 起動用カタログドプロシジャの作成

3.6 Device Managerの環境設定

3.7 Replication Managerの環境設定

3.1 TCP/IPのポート番号の設定

Device Manager，またはReplication Managerと通信するためのポート番号を事前にシステムに予約しておきます。

Mainframe Agentの起動ジョブに対してUNIXサービスの使用属性（受信用ポートの開設）を設定します。詳細は，マニュアル「Communications Server IP 構成解説書」を参照してください。

ポート番号は，TCP/IP環境設定ファイル(PROFILE.TCPIPプロファイル)に設定します。PROFILE.TCPIPプロファイルは，TCP/IP利用空間のサーバ機能に関する定義ファイルです。

PROFILE.TCPIPプロファイルのPORT定義には，Mainframe Agent起動ジョブのメンバ名，または識別名を指定します。識別名については，「4.3.1(2) オペランド」を参照してください。

YKAGENTDジョブのポート番号には，ほかのジョブが使用しているポート番号を指定できません。システム内で使用されていないポート番号を指定してください。

ポート番号の指定例

次のように指定すると，24042がポート番号として設定されます。

24042 TCP YKAGENTD ;YKAGENTD START NAME

注意

Mainframe Agentが必要とするIBM Communications Server（OS標準搭載）のソケット数は2個です。IBM Communications Serverが処理するほかのサービスのソケット数も考慮して，総ソケット数がIBM Communications Serverの上限値を超えないように注意してください。IBM Communications Serverのソケット数の上限値については，マニュアル「Communications Server IP 構成ガイド」を参照してください。

3.2 セキュリティーの設定

セキュリティーの設定方法について説明します。

この節の構成

3.2.1 データセットセキュリティーの設定

3.2.2 リソース・アクセス管理機能（RACF）の環境設定

3.2.1 データセットセキュリティーの設定

Mainframe AgentがReplication Managerと連携する場合，Mainframe AgentのジョブはMainframe AgentのConfigurationファイルを参照します。Mainframe Agentのジョブが使用するConfigurationファイルへのREAD権限を，Mainframe Agentのジョブに与えてください。

READ権限を与えるのは，YKP2Aコマンドで指定したプレフィックスを持つ次のデータセットです。

ディスク構成定義ファイル

コピーグループ定義ファイル

3.2.2 リソース・アクセス管理機能（RACF）の環境設定

Mainframe Agentが通信機能を利用するために，RACFの環境設定をします。

UNIXサービスが使用できるよう，TSO/EからRACFコマンドを使用して，Mainframe Agentの起動用カタログドプロシジャのRACF「STARTED」クラスへOMVSセグメントが保持する管理ユーザーID，および管理グループIDを定義します。

TSO/Eコマンドでの設定例

-＞SETROPTS GENERIC(STARTED)
-＞RDEFINE STARTED YKAGENTD.* STDATA(USER(ユーザーID) GROUP(グループID)
  TRUSTED(YES))
-＞SETROPTS RACLIST(STARTED) REFRESH

Mainframe Agentを起動できるよう，RACFのFACILITYクラスに次のどちらかのプロファイルを定義したあと，定義したプロファイルの参照権限を管理ユーザーIDに与えます。

また，YKP2Aコマンドを実行する前に，次のどちらかのプロファイルの参照権限を，YKP2Aコマンドを実行するユーザーのユーザーIDに与えます。

STGADMIN.YKA.BCM.YKQUERYプロファイル

STGADMIN.YKA.BCM.COMMANDSプロファイル

プロファイルの参照権限をユーザーIDに与える方法については，マニュアル「Security Server RACF セキュリティー管理者のガイド」を参照してください。YKP2Aコマンドについては，「4.2.4 YKP2Aコマンド」を参照してください。

TSO/Eコマンドでの設定例

-＞SETROPTS CLASSACT(FACILITY)
-＞RDEFINE FACILITY STGADMIN.YKA.BCM.YKQUERY UACC(NONE)
-＞PERMIT STGADMIN.YKA.BCM.YKQUERY CLASS(FACILITY) ID(ユーザーID) ACCESS(READ)

Mainframe Agentの実行性能を向上させるため，FACILITYクラスに対してRACLIST機能（ストレージ内プロファイル）を有効にすることを推奨します。

RACLIST機能を有効にするには，次のコマンドを実行してください。

FACILITYクラスがRACLISTされていない場合

SETROPTS RACLIST(FACILITY)

すでにFACILITYクラスがRACLISTされている場合

SETROPTS RACLIST(FACILITY) REFRESH

3.3 IBM HTTP Serverの設定

IPv6接続するためのIBM HTTP Serverの設定方法や，ログの採取方法について説明します。

この節の構成

3.3.1 IPv6接続するための設定

3.3.2 トレースログの採取

3.3.1 IPv6接続するための設定

Device ManagerまたはReplication ManagerとMainframe AgentがIPv6で通信するためには，リバースプロキシサーバとして動作するIBM HTTP Serverが必要です。リバースプロキシサーバは，Device ManagerまたはReplication ManagerからIPv6で受信した要求をIPv4に変換してから，オリジンサーバとしてのMainframe Agentに渡します。

Device ManagerまたはReplication Managerが，Mainframe AgentとIPv6接続する場合の構成例を次に示します。

図3-1 IPv6接続する場合の構成例

IBM HTTP Serverがリバースプロキシサーバとして動作するように設定するには，httpd.confファイルに次の表に示す設定をします。

表3-1 IPv6接続するときにhttpd.confファイルに設定する内容

設定するディレクティブ
設定する内容または値

CacheDisableディレクティブなど
Mainframe Agentに対する要求へのキャッシュ機能が無効になるように設定します。

KeepAliveディレクティブ
KeepAlive機能を無効に設定します。

Listenディレクティブ
IPv6での待機ポートを，次のとおり設定します。ポート番号は変更できます。

Listen [::]:80

LoadModuleディレクティブ
リバースプロキシ機能を有効にするため，次のモジュールをリストに追加します。

proxy_module modules/mod_proxy.so
proxy_http_module modules/mod_proxy_http.so

ProxyPassディレクティブおよびProxyPassReverseディレクティブ
Device ManagerまたはReplication Managerに対するオリジンサーバとしてMainframe Agentを設定するために，次の引数を指定します。

Mainframe Agentが実行されているホストのホスト名またはIPv4アドレス

Mainframe Agentの初期設定時にPORTパラメーターに指定したポート番号

ProxyPass / http://ホスト名またはIPv4アドレス:ポート番号/
ProxyPassReverse / http://ホスト名またはIPv4アドレス:ポート番号/

Timeoutディレクティブ
タイムアウトさせる時間を設定します。
Replication Managerの監視時間設定値（bcmif.socketTimeout）およびDevice Managerの監視時間設定値（host.mf.agent.connection.timeout）よりも大きな値を指定します。

3.3.2 トレースログの採取

Device ManagerまたはReplication ManagerとIBM HTTP Server間のエラーログやアクセスログは，IBM HTTP Serverのログ機能を使って採取します。

IBM HTTP Serverのログを採取するかどうかは，Web管理者の指示に従ってください。ログを採取しない場合，アクセスエラー時の解析が困難になることがあるので注意してください。

3.4 初期設定パラメーターの作成

この節では，Mainframe Agentの起動に必要な環境を設定する初期設定パラメーターの作成方法を説明します。インストール時にサンプルライブラリに登録される初期設定パラメーターのサンプルのメンバはYKPRM00です。環境に合わせて修正してください。

初期設定パラメーターを格納するためのデータセットは，次の属性で作成してください。

LRECL：80

BLKSIZE：80の倍数

RECFM：固定長レコードまたは固定長ブロックレコード

DSORG：順次・データセットまたは区分・データセット

この節の構成

3.4.1 SETINITコマンドの使用方法

3.4.2 初期設定パラメーターの詳細

3.4.3 初期設定パラメーターの指定例

3.4.4 初期設定パラメーターの解析結果例

3.4.1 SETINITコマンドの使用方法

初期設定パラメーターを設定するSETINITコマンドの形式について説明します。コマンドの文法説明で使用する記号については「表A-1 コマンドの文法説明で使用する記号」，コマンドの構文要素については「表A-2 コマンドの構文要素」を参照してください。

△₀SETINIT［△₁パラメーター］・・・

SETINITコマンドおよびパラメーターは第1カラムから第71カラムに記述してください。第72カラム以降の内容は，指定しても無視されます。

SETINITコマンドは複数指定できます。一つのSETINITコマンドに複数の異なるパラメーターを指定できますが，同一パラメーターを複数指定することはできません。一つのSETINITコマンドに同一パラメーターを複数指定した場合は，最後に指定したパラメーターが有効になります。

同一パラメーターを複数指定するには，別々のSETINITコマンドを使用してください。別々のSETINITコマンドを使用した複数指定ができないパラメーターを複数のSETINITコマンドで指定した場合，最後のSETINITコマンドで指定したパラメーターが有効になります。

指定できるパラメーター，および別々のSETINITコマンドを使用したパラメーターの複数指定の可否については，「3.4.2 初期設定パラメーターの詳細」を参照してください。

一つのSETINITコマンドに同一パラメーターを複数指定した例

一つのSETINITコマンドに同一パラメーターを複数指定すると，最後に指定したパラメーターだけが有効になるため，例に示すような指定はしないでください。

次の例では，DEVN(7500,750F)だけが有効となり，DEVN(7300,730F)およびDEVN(7400,740F)は無効になります。

SETINIT DEVN(7300,730F) DEVN(7400,740F) DEVN(7500,750F)

別々のSETINITコマンドを使用して同一パラメーターを複数指定した例

別々のSETINITコマンドを使用した複数指定ができるパラメーターの場合
指定したすべてのパラメーターが有効となります。
次のように指定すると，DEVN(7300,730F)，DEVN(7400,740F)，およびDEVN(7500,750F)が有効になります。

SETINIT DEVN(7300,730F)
SETINIT DEVN(7400,740F)
SETINIT DEVN(7500,750F)

別々のSETINITコマンドを使用した複数指定ができないパラメーターの場合
最後に指定したパラメーターが有効となります。
次のように指定すると，RECVWAITTIME(180)が有効になります。

SETINIT RECVWAITTIME(65535)
SETINIT RECVWAITTIME(180)

この項の構成

(1) 行の継続方法

(2) コメントの書き方

(3) 初期設定パラメーター作成時の注意事項

(1) 行の継続方法

パラメーターを次の行に継続するときは，行の最後に継続記号を付けます。継続記号の種類を次の表に示します。

表3-2 継続記号の種類

継続記号 | 継続方法
マイナス記号（-） | マイナス記号を取り除き，次の行の左端カラムから連続した空白を含んだまま継続します。
プラス記号（+） | プラス記号を取り除き，次の行の左端カラムから連続した空白を詰めて継続します。

空白を含んだまま継続する例

SETINIT-
△△DEVN(7300,730F)

上記のように継続記号としてマイナス記号（-）を使用すると，次のように解釈されます。

SETINIT△△DEVN(7300,730F)

空白を詰めて継続する例

SETINIT DEVN(7300,+
△△730F)

上記のように継続記号としてプラス記号（+）を使用すると，次のように解釈されます。

SETINIT DEVN(7300,730F)

(2) コメントの書き方

コメントとしたい文字列を「/*」と「*/」で囲みます。ただし，パラメーターを継続している間はコメントを記述できません。

コメントになる例

/* COMMENT */
SETINIT PORT(24042)     /* COMMENT */

コメントにならない例

次のように指定すると，/* ERROR COMMENT */はコメントではなく，パラメーターの一部と解釈されてしまいます。

SETINIT DEVN（7300, + /* ERROR COMMENT */
              730F)

(3) 初期設定パラメーター作成時の注意事項

Mainframe Agentの起動時，初期設定パラメーターとして空のメンバを指定しないでください。空のメンバを指定してもエラーにはなりませんが，Mainframe AgentはDevice ManagerまたはReplication Managerに対して情報を返すことができなくなります。

3.4.2 初期設定パラメーターの詳細

初期設定パラメーターの詳細について説明します。

この項の構成

(1) 形式

(2) パラメーター

(3) パラメーターの複数指定

(1) 形式

SETINIT
［△₁PORT(ポート番号)］
［△₁RECVWAITTIME(受信待ち時間)］
［△₁HOSTNAME('ホスト識別名')］
［△₁PREFIX('プレフィックス','ローカルサイトのDADID')]
［△₁DEVN(開始デバイス番号，終了デバイス番号)］
［△₁LOGLEVEL(出力レベル)］

(2) パラメーター

PORT (ポート番号) ～ ＜数字＞ ((1～65535)) <<24042>>

Device ManagerまたはReplication ManagerとのTCP/IP通信に使用するMainframe Agent側のポート番号を指定します。ほかのジョブが使用しているポート番号は指定できません。システム内で使用されていないポート番号を指定してください。

RECVWAITTIME (受信待ち時間) ～ ＜数字＞ ((0～65535)) <<180>>

Device ManagerまたはReplication ManagerとTCP/IP通信する場合，受信要求開始からデータを受信するまでの待ち時間を秒単位で指定します。ゼロを指定すると，Mainframe Agentはデータを無限に待つようになります。

HOSTNAME ('ホスト識別名') ～ ＜50文字以内の英数字＞ <<&SYSNAMEシステム・シンボルの指定値>>

Device ManagerまたはReplication ManagerがMainframe Agentを区別する必要がある場合に指定します。

Mainframe Agentが複数のホストで動作するとき，それらホストのHOSTNAME（ホスト識別名）が重複していると，Device ManagerまたはReplication ManagerはMainframe Agentが動作しているホストを識別できません。Mainframe Agentが動作しているホストをDevice ManagerまたはReplication Managerが区別できるように，ホスト間で重複しないHOSTNAMEを指定してください。

このパラメーターを省略した場合，&SYSNAMEシステム・シンボルの指定値が仮定されます。&SYSNAMEシステム・シンボルについては，マニュアル「MVS 初期設定およびチューニング 解説書」を参照してください。

Mainframe Agentが複数のホストで動作し，&SYSNAMEシステム・シンボルの指定値がそれらのホスト間で重複している場合，Device ManagerまたはReplication Managerがホストを区別できなくなります。&SYSNAMEシステム・シンボルの値が重複している場合は，HOSTNAMEパラメーターの値がホスト間で重複しないようにしてください。

HOSTNAMEパラメーター指定時の注意

Device Managerに通知するホスト名が，すでにDevice Managerが管理しているホスト（Device Manager上でホストとして管理されている外部接続用のExternalポートも含む）の名称と重複しないように，次のどれかの方法で設定してください。

DNSで解決可能なホスト名を指定してください。

DNSで解決可能なホスト名がすでにDevice Managerで管理しているホスト名と重複する場合，メインフレームホストのホスト識別名をHOSTNAMEパラメーターに設定し，そのホスト識別名をDevice Managerに設定してください。

上記のどちらの方法でもホスト名が重複してしまう場合，Device Managerが管理している既存のホストのホスト名を変更してください。

上記の三つの方法で，ホスト名を一意に設定できない場合，任意のホスト名を指定してください。

PREFIX ('プレフィックス','ローカルサイトのDADID')

Replication ManagerからMainframe Agentの情報を取得する場合に，YKP2Aコマンドで生成したConfigurationファイルのプレフィックスを指定します。YKP2Aコマンドについては，「4.2.4 YKP2Aコマンド」を参照してください。

PREFIXパラメーターは複数指定できます。Replication ManagerとMainframe Agentが1対1の環境で，プレフィックスが異なる複数のConfigurationファイルに登録されたストレージ情報を取得する場合に，複数のPREFIXパラメーターを指定します。

プレフィックス ～ ＜16文字以内のPREFIX文字列＞

Replication Managerが使用するMainframe AgentのConfigurationファイル名のプレフィックスを指定します。ここで指定したプレフィックスを持つディスク構成定義ファイル，コピーグループ定義ファイルに定義されたボリューム情報，およびコピーグループがReplication Managerに提供されます。

ローカルサイトのDADID ～ ＜28文字以内のDAD文字列＞

YKP2AコマンドでDADパラメーターに指定したプライマリサイトのDADIDを指定します。

PREFIXパラメーター指定時の注意

PREFIXパラメーターに存在しないプレフィックスやDADIDを指定しないでください。指定した場合，Mainframe Agentの起動時にはエラーになりませんが，Replication Managerからの要求時にエラーとなります。

PREFIXパラメーターにConfigurationファイルのプレフィックス以外を指定しないでください。指定されたプレフィックスに該当するデータセットが多数あった場合，Mainframe Agentの処理が遅くなることがあります（例えば「SYS1」などのプレフィックス）。

同じプレフィックスを指定した複数のPREFIXパラメーターを定義しないでください。Device ManagerまたはReplication Managerの監視処理が遅くなることがあります。

PREFIXパラメーターを複数指定すると，Replication Managerからの要求時に異なるプレフィックスごとにConfigurationファイルを切り替える時間が必要となります。そのためConfigurationファイルが多数ある場合には，Replication Managerからの要求・回答のアクセス時間を短くするために，Configurationファイルのプレフィックスを集約して，PREFIXパラメーターの指定を一つにすることを推奨します。

PREFIXパラメーターに指定したプレフィックスのConfigurationファイルを修正しないでください。Replication ManagerにMainframe AgentのConfigurationファイルの情報が表示されなかったり，エラーになったりすることがあります。

Replication Managerからの要求・回答のアクセス時間は，指定したプレフィックスを持つコピーグループ定義ファイルに定義されているコピーペア数に応じて大きくなります。このため，環境（コピーペア数に応じたホスト処理能力）に合わせてReplication Managerの監視時間を設定してください。

DEVN (開始デバイス番号，終了デバイス番号) ～ ＜4けたの16進数＞

Device ManagerまたはReplication Managerに渡すホストボリュームの情報を絞り込みたいとき，情報収集の対象とするデバイス番号の範囲を指定します。開始デバイス番号と終了デバイス番号は16進数の昇順に指定します。DEVNパラメーターを一度も指定しなかった場合は，DEVN(0000,FFFF)が仮定されます。

DEVNパラメーター指定時の注意

Device ManagerまたはReplication Managerからの要求・回答のアクセス時間を短くするために情報収集の対象とするデバイスの範囲を指定した使用を推奨します。

DEVNパラメーターを複数指定する場合，重複するデバイスについては重複排除されません。重複がないように指定してください。

LOGLEVEL (出力レベル) ～ ＜数字＞ ((0～2)) <<2>>

ログの出力レベルを指定します。

0

ログが出力されません。0を指定すると，通信障害やMainframe Agentのコマンド実行時のエラー原因の特定が困難になります。

1

通信関連のメッセージ（YKY300I，YKY301I，YKY304I，YKY307I）が出力されます。

2

LOGLEVEL(1)指定で出力されるメッセージに加え，Mainframe Agentのコマンド実行時にYKY680Iエラーメッセージが出力されます。

LOGLEVELと出力されるメッセージを次の表に示します。

表3-3 LOGLEVELと出力されるメッセージ

LOGLEVEL | 出力されるメッセージ
0 | 出力されない
1 | YKY300I，YKY301I，YKY304I，YKY307I
2 | YKY300I，YKY301I，YKY304I，YKY307I，YKY680I

(3) パラメーターの複数指定

各初期設定パラメーターを指定する際に，複数のSETINITコマンドが使用された場合の結果を次の表に示します。

表3-4 初期設定パラメーターの複数指定の可否

パラメーター名 | 複数指定の結果
PORT | 複数指定した場合，最後に指定したパラメーターが有効になる。
RECVWAITTIME
HOSTNAME
PREFIX | 複数指定できる。
DEVN
LOGLEVEL | 複数指定した場合，最後に指定したパラメーターが有効になる。

3.4.3 初期設定パラメーターの指定例

Device Manager，またはReplication Managerと接続する際の初期設定パラメーターの指定例を示します。

この項の構成

(1) Device Managerと接続する場合

(2) Replication Managerと接続する場合

(1) Device Managerと接続する場合

Mainframe AgentがDevice Managerと接続する場合の，初期設定パラメーターの指定方法について説明します。

次の構成例を使用して，指定方法を説明します。

図3-2 Device Managerと接続する場合の構成例

「図3-2 Device Managerと接続する場合の構成例」の構成で，Mainframe AgentがDevice Managerと接続するためには，次の表に示す値を指定します。

表3-5 Device Managerと接続する場合の指定内容

ローカルサイト | リモートサイト
出力するログのレベル | ポート番号 | デバイス番号
2 | 24042 | 7300～730F | 指定なし
7400～740F

「表3-5 Device Managerと接続する場合の指定内容」の内容を初期設定パラメーターで指定すると，次のようになります。

SETINIT LOGLEVEL(2)
SETINIT PORT(24042)
/* DEVN */
SETINIT DEVN(7300,730F)
SETINIT DEVN(7400,740F)

(2) Replication Managerと接続する場合

Mainframe AgentがReplication Managerと接続する場合の，初期設定パラメーターの指定方法について説明します。

次の構成例を使用して，指定方法を説明します。

図3-3 Replication Managerと接続する場合の構成例

「図3-3 Replication Managerと接続する場合の構成例」の構成で，Mainframe AgentがReplication Managerと接続するためには，次の表に示す値を指定します。

表3-6 Replication Managerと接続する場合の指定内容

プレフィックス | ローカルサイト | リモートサイト
出力するログのレベル | ポート番号 | DADID | デバイス番号
ACCOUNT | 2 | 24042 | NY | 7300～730F | 指定なし
INFO | 7400～740F

「表3-6 Replication Managerと接続する場合の指定内容」の内容を初期設定パラメーターで指定すると，次のようになります。

SETINIT LOGLEVEL(2)
SETINIT PORT(24042)
/* PREFIX */
SETINIT PREFIX('ACCOUNT','NY')
SETINIT PREFIX('INFO','NY')
/* DEVN */
SETINIT DEVN(7300,730F)
SETINIT DEVN(7400,740F)

3.4.4 初期設定パラメーターの解析結果例

Mainframe Agentの起動時，初期設定パラメーターの解析結果がYKLIST DD文に指定されたデータセットに出力されます。

結果リストの例を次に示します。結果リスト中のnn-nnの部分は，Mainframe Agentのバージョンによって異なります。

エラーのない結果リスト

*** AGENT nn-nn LISTING INFORMATION *** DATE=2009-10-15 TIME=13:34:35 PAGE=0001

SETINIT PORT(24042)                                                     00010001
/* DEVN */                                                              00020001
SETINIT DEVN(7300,730F)                                                 00030001
SETINIT DEVN(7400,740F)                                                 00040001

エラーのある結果リスト

最初のDEVNパラメーターの必須オペランドである終了デバイス番号が指定されていないためにエラーになっている状態です。YKY002Iメッセージが表示されています。

*** AGENT nn-nn LISTING INFORMATION *** DATE=2009-10-15 TIME=16:09:53 PAGE=0001

SETINIT PORT(24042)                                                     00010001
/* DEVN */                                                              00020001
SETINIT DEVN(7300)                                                      00030003
YKY002I INVALID INITIALIZATION PARAMETER: DEVN
SETINIT DEVN(7400,740F)                                                 00040001

3.5 起動用カタログドプロシジャの作成

Mainframe Agentの起動用カタログドプロシジャの作成，および変更方法について説明します。

この節の構成

3.5.1 標準の起動用カタログドプロシジャ

3.5.2 起動用カタログドプロシジャの変更

3.5.1 標準の起動用カタログドプロシジャ

インストール時にサンプルライブラリに登録される標準の起動用カタログドプロシジャを次に示します。JES（Job Entry Subsystem）起動プロシジャのPROCLIBデータセットにコピーして，環境に合わせて修正してください。

この項の構成

(1) 標準の起動用カタログドプロシジャの展開形

(2) 説明

(3) 注意事項

(1) 標準の起動用カタログドプロシジャの展開形

●メンバ名： YKAGENTD

//YKAGENTD PROC MEMBER=YKPRM00                                          
//****************************************************************
//*                                                                    
//*  ALL RIGHTS RESERVED. COPYRIGHT (C) 2006, 2011, HITACHI, LTD.      
//*                                                                    
//****************************************************************
//IEFPROC EXEC PGM=IKJEFT01,PARM=YKAGENTD,                              
//           TIME=1440,REGION=4096K                                    
//YKPARM   DD DSN=MFAGENT.Vnnnn.SAMPLIB(&MEMBER),DISP=SHR              
//YKLIST   DD DDNAME=IEFRDER                                            
//SYSTSPRT DD DUMMY                                                    
//SYSTSIN  DD DUMMY                                                    
//SYSABEND DD SYSOUT=*                                                  
//SYSEXEC  DD DSN=MFAGENT.Vnnnn.EXECLIB,DISP=SHR                        
//STEPLIB  DD DSN=MFAGENT.Vnnnn.LINKLIB,DISP=SHR                        

サンプルJCL中の「Vnnnn」の「nnnn」部分は，バージョンによって異なります。

(2) 説明

PROC文
Mainframe Agentの起動時に使用する初期設定パラメーターのメンバ名を指定します。ここで指定したメンバが標準値となります。標準メンバ以外を使用するときは，起動時にSTARTコマンドで変更できます。

EXEC文
次のオペランドを指定します。

TIME（CPU打ち切り時間）には1440を指定します。

REGION（リージョンサイズ）を指定します。「2.2.3 メモリー所要量」を参照して計算してください。

YKPARM DD文
初期設定パラメーターを格納したデータセット名と区分・データセットの場合は，メンバ名を指定します。

YKLIST DD文
初期設定パラメーターの解析結果を出力するデータセットを指定します。次の属性のデータセットを指定してください。

LRECL：121

BLKSIZE：121の倍数

RECFM：FBA

DSORG：順次・データセット（区分・データセットの場合，メンバ名も指定します）。

SYSTSPRT DD文
DUMMYを指定します。

SYSTSIN DD文
DUMMYを指定します。

SYSABEND DD文
Mainframe Agentが異常終了した場合のダンプ出力先を指定します。標準の起動用カタログドプロシジャには「SYSOUT=*」が指定されています。STARTコマンドで起動するジョブのシステムメッセージの出力先クラスにDUMMY出力クラスを割り当てている場合，「SYSOUT=*」のままではダンプが出力されないので，「SYSOUT=出力できるSYSOUTクラス」を指定することを推奨します。

SYSEXEC DD文
REXX execライブラリが組み込まれているデータセットを指定します。

STEPLIB DD文 (任意)
Mainframe Agentのロードライブラリが組み込まれているデータセットを指定します。Mainframe AgentのLINKLIBデータセットをシステムのLINKLIBに連結する場合，STEPLIB DD文は不要です。

(3) 注意事項

Mainframe Agentはクライアントからの要求を待つ常駐プログラムであるため，タイム打ち切り対象にならないように，EXEC文にTIME=1440を指定してください。また，その間に出力されるメッセージでスプールスペースを圧迫しないように，ジョブ・ログやシステム・メッセージの出力クラスにPurgeクラスを指定してください。

z/OS V1R3以降の場合，STARTコマンドのJOBステートメント・キーワードでJESLOGデータセットをSUPPRESS出力するように指定してください。

3.5.2 起動用カタログドプロシジャの変更

システムの環境に合わせて標準の起動用カタログドプロシジャの内容を変更したり，別の起動用カタログドプロシジャを作成したりすると，Mainframe Agentを起動できます。カタログドプロシジャ名（メンバ名）は任意です。

起動用カタログドプロシジャにSYSTCPD DD文を追加すると，Mainframe Agentで使用するTCP/IPクライアント・プログラム環境を設定できます。例えば，標準のTCPスタック環境を使用しない場合，SYSTCPD DD文を追加してTCP/IP環境設定ファイルを指定できます。

SYSTCPD DD文以外によるTCP/IP環境設定ファイルの指定方法，およびSYSTCPD DD文で指定するTCP/IP環境設定ファイルの定義については，マニュアル「Communications Server IP 構成ガイド」の基本TCP/IPシステムについての説明を参照してください。

3.6 Device Managerの環境設定

ここでは，Device Managerで行う環境設定について説明します。

この節の構成

3.6.1 メインフレームのストレージ情報の表示

3.6.2 メインフレームのストレージ情報の更新

3.6.3 Mainframe Agentの登録情報の取得

3.6.4 Mainframe Agentの登録情報の変更

3.6.5 Mainframe Agentの登録情報の削除

3.6.6 メインフレームホスト情報の取得

3.6.7 メインフレームホスト情報の変更

3.6.8 メインフレームホストの削除

3.6.1 メインフレームのストレージ情報の表示

以下の設定が完了すると，GUI上にメインフレームのストレージ情報が表示されるようになります。

この項の構成

(1) メインフレームホストをDevice Managerに登録する

(2) メインフレームホスト上で稼働するMainframe AgentをDevice Managerに登録する

(3) メインフレームのストレージ情報を取得する

(1) メインフレームホストをDevice Managerに登録する

AddHostコマンドでメインフレームホストをDevice Managerへ登録する手順を次に示します。

AddHostコマンドを実行し，メインフレームホストをDevice Managerに登録します。
次のパラメーターを指定してください。

hostname：メインフレームホストのホスト名（「3.4.2(2) パラメーター」のHOSTNAMEパラメーターで指定した値）を指定します。

hosttype：2を指定します。

AddHostコマンドの実行結果で，パラメーターnameおよびパラメーターhosttypeに指定内容が正しく出力されているかを確認します。

AddHostコマンド実行時の注意事項

メインフレームホストの環境設定で指定したホスト名と，Device Managerの環境設定で指定したホスト名が一致しない場合，Mainframe Agentの登録情報を取得できません。

メインフレームホストをDevice Mangerに登録する際，パラメーターwwnlistは指定しないでください。指定するとエラーが発生します。

AddHostコマンドの実行によって出力されるobjectIDの値は，以降の手順や運用時に必要になるため，記録しておいてください。

パラメーターipaddressを指定した場合，メインフレームホストの属性として登録されますが，AddHostコマンドで登録したIPアドレスは，Mainframe Agentとの通信には使用されません。Mainframe Agentとの通信に必要な情報は，「3.6.1(2) メインフレームホスト上で稼働するMainframe AgentをDevice Managerに登録する」で設定します。

AddHostコマンド実行時に発生するエラーの対処

GetHostコマンドで，メインフレームホストが登録されているかを確認してください。メインフレームホストが登録されていない場合，AddHostコマンドでメインフレームホストを登録してください。登録内容が正しくない場合，ModifyHostコマンドで登録内容を修正してださい。メインフレームホストの登録内容の修正については「3.6.7 メインフレームホスト情報の変更」を参照してください。

コマンド書式：

HiCommandCLI AddHost "hostname=メインフレームホスト名" "hosttype=2"

コマンド実行例：

HiCommandCLI AddHost -o "D:¥logs¥AddHost.log" "hostname=toro2" "hosttype=2”

(2) メインフレームホスト上で稼働するMainframe AgentをDevice Managerに登録する

AddURLLinkコマンドでMainframe AgentをDevice Managerへ登録する手順を次に示します。

AddURLLinkコマンドを実行し，メインフレームホストをDevice Managerに登録します。
次のパラメーターを指定してください。

url：IPアドレスおよびポート番号を指定します。
メインフレームホストがIPv4環境の場合：Mainframe AgentがインストールされたメインフレームホストのIPアドレス，およびMainframe Agentが利用するポート番号を指定します。
メインフレームホストがIPv6環境の場合：IBM HTTP ServerのIPアドレス（角括弧[ ]で囲む）およびポート番号を指定します。

name：Mainframe Agentを示す文字列を指定します。MainframeAgentと指定してください。大文字小文字は区別されます。

linkedid：AddHostコマンドでメインフレームホストを登録した際に出力される，メインフレームホストのオブジェクトIDを指定します。

AddURLLinkコマンドの実行結果で，パラメーターurl，パラメーターnameおよびパラメーターlinkedidに指定内容が正しく出力されているかを確認します。

AddURLLinkコマンド実行時の注意事項

パラメーターnameを誤って指定すると，Mainframe Agentの情報として登録されないため，メインフレームのストレージ情報は取得できません。パラメーターnameの指定を誤った場合，一度，DeleteURLLinkコマンドでMainframe Agent情報を削除したあと，AddURLLinkコマンドで再度登録してください。Mainframe Agent情報の削除については「3.6.5 Mainframe Agentの登録情報の削除」を参照してください。

AddURLLinkコマンド実行時に発生するエラーの対処

GetURLLinkコマンドでMainframe Agentが登録されているかを確認してください。Mainframe Agentが登録されていない場合，AddURLLinkコマンドでMainframe Agentを登録してください。登録内容が正しくない場合，AddURLLinkコマンドで登録内容を修正してください。Mainframe Agentの登録内容の修正については「3.6.4 Mainframe Agentの登録情報の変更」を参照してください。

コマンド書式（IPv4環境の場合）：

HiCommandCLI AddURLLink "url=http://メインフレームホストのIPアドレス:ポート番号" "name=MainframeAgent" "linkedid=メインフレームホストのオブジェクトID"

コマンド書式（IPv6環境の場合）：

HiCommandCLI AddURLLink "url=http://IBM HTTP ServerのIPアドレス※:ポート番号" "name=MainframeAgent" "linkedid=メインフレームホストのオブジェクトID"

注※　IPアドレスを角括弧[ ]で囲みます。

コマンド実行例（IPv4環境の場合）：

HiCommandCLI AddURLLink -o "D:¥logs¥AddURLLink.log" "url=http://192.168.99.114:24042" "name=MainframeAgent" "linkedid=HOST.1"

(3) メインフレームのストレージ情報を取得する

AddHostRefreshコマンドでメインフレームのストレージ情報を取得します。取得した情報は，コマンド実行結果には出力されません。GUI上で確認してください。

次のパラメーターを指定してください。

objectid：AddHostコマンドでメインフレームホストを登録した際に出力される，メインフレームホストのオブジェクトIDを指定します。

AddHostRefreshコマンド実行時に発生するエラーの対処

Mainframe Agentが正常に稼働しているかを確認してください。
稼働していない場合，Mainframe Agentの設定内容を確認し，再び起動してださい。

メインフレームホストおよびMainframe Agentが正しく登録されているかを確認してください。
正しく登録されている場合，AddHostRefreshコマンドで，再度メインフレームのストレージ情報を取得してください。正しく登録されていない場合，「3.6.1 メインフレームのストレージ情報の表示」の「(1) メインフレームホストをDevice Managerに登録する」または「(2) メインフレームホスト上で稼働するMainframe AgentをDevice Managerに登録する」の手順に従って，正しく登録し直してください。

コマンド書式：

HiCommandCLI AddHostRefresh "objectid=メインフレームホストのオブジェクトID"

コマンド実行例：

HiCommandCLI AddHostRefresh -o "D:¥logs¥AddHostRefresh.log" "objectid=HOST.1"

3.6.2 メインフレームのストレージ情報の更新

GUI上に表示されるメインフレームのストレージ情報を更新するには，AddHostRefreshコマンドを実行します。AddHostRefreshコマンド以外の方法で，メインフレームのストレージ情報を更新することはできません。

次のパラメーターを指定してください。

objectid：AddHostコマンドでメインフレームホストを登録した際に出力される，メインフレームホストのオブジェクトIDを指定します。

AddHostRefreshコマンド実行時に発生するエラーの対処

Mainframe Agentが正常に稼働しているかを確認してください。
稼働していない場合，Mainframe Agentの設定内容を確認し，再び起動してください。

メインフレームホストおよびMainframe Agentが正しく登録されているかを確認してください。
正しく登録されている場合，AddHostRefreshコマンドで，再度メインフレームのストレージ情報を取得してください。正しく登録されていない場合，「3.6.1(1) メインフレームホストをDevice Managerに登録する」または「3.6.1(2) メインフレームホスト上で稼働するMainframe AgentをDevice Managerに登録する」の手順に従って，正しく登録し直してください。

コマンド書式：

HiCommandCLI AddHostRefresh "objectid=メインフレームホストのオブジェクトID"

コマンド実行例：

HiCommandCLI AddHostRefresh -o "D:¥logs¥AddHostRefresh.log" "objectid=HOST.1"

3.6.3 Mainframe Agentの登録情報の取得

Device Managerサーバに登録済みのMainframe Agentの登録情報を取得するには，GetURLLinkコマンドを実行します。このコマンドを実行すると，実行結果の出力項目urlからメインフレームホストのIPアドレスおよびポート番号を取得できます。

コマンド実行例：

HiCommandCLI GetURLLink -o "D:¥logs¥GetURLLink.log" "objectid=URLLINK.HOST.1.1"

3.6.4 Mainframe Agentの登録情報の変更

Device Managerサーバに登録済みのMainframe Agentの登録情報を変更するには，AddURLLinkコマンドを実行します。パラメーターurlに新しいIPアドレスまたはポート番号をURL形式で指定することで，メインフレームホストのIPアドレスまたはポート番号を変更できます。

注：nameパラメーターには，MainframeAgentを指定します。パラメーターnameを誤って指定すると，Mainframe Agentの情報として登録されないため，メインフレームのストレージ情報は取得できません。誤って指定した場合，DeleteURLLinkコマンドでMainframe Agentの登録情報を削除してから，再度AddURLLinkコマンドで，登録済みのMainframe Agentの登録情報を変更してください。

コマンド実行例：

HiCommandCLI AddURLLink -o "D:¥logs¥AddURLLink.log"
"url=http://192.168.99.100:24042" "name=MainframeAgent" "linkedid=HOST.1"

3.6.5 Mainframe Agentの登録情報の削除

Device Managerサーバに登録済みのMainframe Agentの登録情報を削除するには，DeleteURLLinkコマンドを実行します。

参考：nameパラメーターの指定を誤った場合など，Mainframe Agentの登録情報だけを削除する場合に使用します。

コマンド実行例：

HiCommandCLI DeleteURLLink -o "D:¥logs¥DeleteURLLink.log" "objectid=URLLINK.HOST.1.1"

3.6.6 メインフレームホスト情報の取得

Device Managerサーバに登録済みのメインフレームホストの情報を取得するには，GetHostコマンドを実行します。このコマンドを実行すると，メインフレームホストのホスト名を取得できます。

注：メインフレームホストのオブジェクトIDが不明な場合，次の手順でオブジェクトIDを取得してください。

オブジェクトIDを指定しないで，GetHostコマンドを実行します。Device Managerに登録済みのすべてのホストを取得します。

取得したホスト情報の中から，該当するメインフレームホスト名を検索します。

手順2で検索したメインフレームホストの情報からオブジェクトIDを取得します。

コマンド実行例：

HiCommandCLI GetHost -o "D:¥logs¥GetHost.log" "objectid=HOST.1"

3.6.7 メインフレームホスト情報の変更

Device Managerサーバに登録済みのメインフレームホストの情報を変更するには，ModifyHostコマンドを実行します。パラメーターhostnameに新しいホスト名を指定することで，メインフレームホスト名を変更できます。

注：ホスト名を変更する場合，Mainframe Agentの初期設定パラメーターで設定したメインフレームホスト名と一致するホスト名を指定してください。一致しない場合，Mainframe Agentからの情報を取得できません。

注：ModifyHostコマンドではパラメーターhosttypeの情報を変更することはできません。パラメーターhosttypeの情報を変更したい場合は，DeleteHostコマンドで，対象のメインフレームホストを削除してから，メインフレームホストを登録し直してください。

コマンド実行例：

HiCommandCLI ModifyHost -o "D:¥logs¥ModifyHost.log" "objectid=HOST.1" "hostname=snow"

3.6.8 メインフレームホストの削除

Device Managerサーバに登録済みのメインフレームホストを削除するには，DeleteHostコマンドを実行します。

注：メインフレームホストを削除すると，Device Managerに登録されているMainframe Agentの登録情報が削除され，GUI上に表示されているメインフレームのストレージ情報が表示されなくなります。

コマンド実行例：

HiCommandCLI DeleteHost -o "D:¥logs¥ DeleteHost.log" "objectid=HOST.1"

3.7 Replication Managerの環境設定

Replication Managerで行う環境設定について説明します。各設定方法については，マニュアル「Hitachi Command Suite Replication Manager Software ユーザーズガイド」を参照してください。

この節の構成

3.7.1 情報取得元を登録する

3.7.2 構成情報を取得する周期を設定する

3.7.3 コピーペア状態の情報取得周期を設定する

3.7.1 情報取得元を登録する

Mainframe Agentを情報取得元として登録します。次の情報の設定が必要です。

Mainframe Agentの名称（ニックネーム）

Mainframe AgentのIPアドレスまたはホスト名

ポート番号

3.7.2 構成情報を取得する周期を設定する

コピーペア構成情報を取得する間隔と取得開始時刻を設定します。

3.7.3 コピーペア状態の情報取得周期を設定する

コピーペア状態を取得する間隔を分で指定します。コピーペア状態を自動的に取得したくない場合は，定期更新を無効にする設定をします。

4. 運用

この章では，Device ManagerおよびReplication Managerと連携して，オープンシステムから，メインフレームで管理しているストレージ情報を取得したり，PPRCコピーペアを監視したりするための運用方法について説明します。

この章の構成

4.1 Device Managerでメインフレーム系ストレージ情報を取得する運用

4.2 Replication ManagerでPPRCコピーペアを監視する運用

4.3 運用コマンド

4.1 Device Managerでメインフレーム系ストレージ情報を取得する運用

Device Managerでメインフレーム系ストレージ情報を取得する運用について説明します。

この節の構成

4.1.1 運用の概要

4.1.2 導入時の運用手順

4.1.3 構成変更時の運用手順

4.1.1 運用の概要

Device Managerが情報取得を実行すると，Mainframe Agentはメインフレームホストが管理するストレージ情報を取得し，Device Managerに情報を提供します。

Device Managerでメインフレーム系ストレージ情報を取得する運用の概要を次の図に示します。

図4-1 Device Managerでメインフレーム系ストレージ情報を取得する運用の概要

4.1.2 導入時の運用手順

Mainframe Agent導入時の運用手順を次の図に示します。

図4-2 Mainframe Agent導入時の運用手順

次の節を参照して，Mainframe Agentの環境設定を行う。

「3.1 TCP/IPのポート番号の設定」

「3.2 セキュリティーの設定」

「3.4 初期設定パラメーターの作成」

「3.5 起動用カタログドプロシジャの作成」

Mainframe Agentを起動する。
「4.3.1 Mainframe Agentの起動」を参照してください。

Device ManagerとIPv6で接続する場合，IBM HTTP Serverの設定を行う。
「3.3 IBM HTTP Serverの設定」を参照してください。

Device ManagerとIPv6で接続する場合，IBM HTTP Serverを起動する。

Device Managerの環境設定を行う。
「3.6 Device Managerの環境設定」を参照してください。

Device Managerでの情報収集を開始する。

4.1.3 構成変更時の運用手順

Mainframe Agent構成変更時の運用手順を次の図に示します。

図4-3 Mainframe Agent構成変更時の運用手順

Device Managerでの情報収集を停止する。

Mainframe Agentを停止する。
「4.3.2 Mainframe Agentの正常終了」を参照してください。

初期設定パラメーターを修正する。
「3.4 初期設定パラメーターの作成」を参照してください。

Mainframe Agentを起動する。
「4.3.1 Mainframe Agentの起動」を参照してください。

Device Managerでの情報収集を再開する。

4.2 Replication ManagerでPPRCコピーペアを監視する運用

Replication ManagerでPPRCコピーペアを監視する運用について説明します。

この節の構成

4.2.1 運用の概要

4.2.2 運用手順

4.2.3 コピーグループ定義生成機能の前提条件

4.2.4 YKP2Aコマンド

4.2.5 Configurationファイルの生成例

4.2.1 運用の概要

Replication Managerから情報取得要求があると，Mainframe Agentによって，PPRCコピーペアについての次の情報がReplication Managerに提供されます。

ホストボリューム情報

コピーグループ定義情報

コピーグループに定義されたコピーペアの状態

Replication ManagerでPPRCコピーペアを監視する運用の概要を次の図に示します。

図4-4 Replication ManagerでPPRCコピーペアを監視する運用の概要

注意

PPRCコピーペアのS-VOLのデバイス番号はYKP2Aコマンドが自動的に割り当てるため，ホストで定義されているデバイス番号とは異なるデバイス番号が表示されます。

4.2.2 運用手順

PPRCコピーペアを監視するためには，Mainframe Agent用のConfigurationファイルが必要です。Mainframe Agent用のConfigurationファイルは，YKP2Aコマンドで生成します。YKP2AコマンドによってMainframe Agent用のConfigurationファイルを生成する機能を，PPRCコピーペアのコピーグループ定義生成機能と呼びます。

事前準備として，次のConfigurationファイルを格納するためのデータセットを確保してください。ただし，デバイス容量やVTOCに余裕がある場合は省略できます。

ディスク構成定義ファイル

コピーグループ定義ファイル

Replication ManagerでPPRCコピーペアを監視するための運用手順を次の図に示します。

図4-5 Replication ManagerでPPRCコピーペアを監視するための運用手順

PPRCでコピーペアを運用状態にしておく。

セキュリティーを設定する。
「3.2.2 リソース・アクセス管理機能（RACF）の環境設定」を参照してください。

YKP2AコマンドでPPRCコピーペアのP-VOLがあるストレージシステムをスキャンして，ディスク構成定義ファイルおよびコピーグループ定義ファイルを生成する。

次の節を参照して，Mainframe Agentの環境設定を行う。

「3.1 TCP/IPのポート番号の設定」

「3.4 初期設定パラメーターの作成」

「3.5 起動用カタログドプロシジャの作成」

Mainframe Agentを起動する。
「4.3.1 Mainframe Agentの起動」を参照してください。

Replication ManagerとIPv6で接続する場合，IBM HTTP Serverの設定を行う。
「3.3 IBM HTTP Serverの設定」を参照してください。

Replication ManagerとIPv6で接続する場合，IBM HTTP Serverを起動する。

Replication Managerの環境設定を行う。
「3.7 Replication Managerの環境設定」を参照してください。

Replication ManagerでのPPRCコピーペアの状態監視を開始する。

4.2.3 コピーグループ定義生成機能の前提条件

PPRCコピーペアのコピーグループ定義生成機能を使用するための前提条件を次に示します。

この項の構成

(1) 前提ハードウェア

(2) ソフトウェアの設定項目

(3) Configurationファイルを生成できるコピー種別と生成単位

(4) サポートするPPRCコマンド

(1) 前提ハードウェア

PPRCコピーペアのコピーグループ定義生成機能を使用するための前提ハードウェアを次の表に示します。

表4-1 前提ハードウェア

項目 | 内容
ホスト | 1台。
ストレージシステム | PPRCコピーペアを運用しているHitachi USP，Universal Storage Platform V/VM，またはVirtual Storage Platform。

(2) ソフトウェアの設定項目

PPRCコピーペアのコピーグループ定義生成機能を使用するためのソフトウェアの設定項目を次の表に示します。

表4-2 ソフトウェアの設定項目

項目 | 内容 | 注意事項
コピーペア | PPRCでSI，TC，およびTCAコピーペアを運用中の状態（DUPLEXまたはSUSPOP状態）にしておく。 | PPRCコピーペアがSIMPLEX状態の場合，コピーペアが認識されないため，コピーグループ定義ファイルは生成できません。

(3) Configurationファイルを生成できるコピー種別と生成単位

Configurationファイルを生成できるコピー種別，およびConfigurationファイルが生成される単位を次の表に示します。

表4-3 Configurationファイルを生成できるコピー種別と生成単位

コピー種別 | 生成単位 | 説明
SI | 検出されたすべてのコピーペアが一つのConfigurationファイルに定義されます。 | ストレージシステム単位にコピーグループを定義したい場合は，スキャンするPPRCコピーペアのP-VOLのデバイス番号の指定範囲をストレージシステムごとに分けてください。
TC
TCA | 一つのC/Tグループが一つのConfigurationファイルに定義されます。 | C/Tグループは，ストレージシステムが提供する「ボリュームの更新順序の整合性を保つための機能」に基づくグループです。C/Tグループでは，C/Tグループに含まれるボリュームの更新順序の整合性を保つことができます。

(4) サポートするPPRCコマンド

PPRCコピーペアのコピーグループ定義生成機能がサポートするPPRCコマンドを，「表4-4 サポートするペア形成コマンド（CESTPAIR）のパラメーター値」，「表4-5 サポートするペアサスペンドコマンド（CSUSPEND）のパラメーター値」，および「表4-6 サポートするペア再同期コマンド（CESTPAIR）のパラメーター値」に示します。各表のサポート状況欄に○が付いているパラメーター値のPPRCコマンドで定義および操作した，PPRCコピーペアのConfigurationファイルを生成できます。

表中の凡例を次に示します。

○：このパラメーター値のPPRCコマンドで定義および操作したPPRCコピーペアのConfigurationファイルを生成できます。

×：このパラメーター値のPPRCコマンドで定義および操作したPPRCコピーペアのConfigurationファイルを生成できません。

表4-4 サポートするペア形成コマンド（CESTPAIR）のパラメーター値

PPRCのコピー種別 | パラメーター | 値 | サポート状況
SIおよびTC | MODE | COPY | ○
NOCOPY | ×
PACE | pace | ×
省略 | ○
CRIT | YES | ×
NO（デフォルト） | ○
MSGREQ | YES | ×
NO（デフォルト） | ○
TCA | cmd_parm | AGnnX | ○
AVnnX | ×
MODE | COPY | ○
NOCOPY | ×
PACE | pace | ×
省略 | ○
CRIT | YES | ×
NO（デフォルト） | ○
MSGREQ | YES | ×
NO（デフォルト） | ○

表4-5 サポートするペアサスペンドコマンド（CSUSPEND）のパラメーター値

PPRCのコピー種別 | パラメーター | 値 | サポート状況
SIおよびTC | PRIMARY | 指定 | ×
省略（デフォルト） | ○
QUIESCE | 指定 | ×
省略（デフォルト） | ○
TCA | cmd_parm | AGD00 | ○
AGP00 | ×
AVD00 | ×
AVP00 | ×

表4-6 サポートするペア再同期コマンド（CESTPAIR）のパラメーター値

PPRCのコピー種別 | パラメーター | 値 | サポート状況
SIおよびTC | MODE | RESYNC | ○
PACE | pace | ×
省略 | ○
CRIT | YES | ×
NO（デフォルト） | ○
MSGREQ | YES | ×
NO（デフォルト） | ○
TCA | MODE | RESYNC | ○
PACE | pace | ×
省略 | ○
CRIT | YES | ×
NO（デフォルト） | ○
MSGREQ | YES | ×
NO（デフォルト） | ○

4.2.4 YKP2Aコマンド

YKP2Aコマンドは，PPRCコピーペアのConfigurationファイルを生成するTSO/Eコマンドです。

YKP2Aコマンドの形式と機能について説明します。コマンドの文法説明で使用する記号および構文要素については，「付録A. コマンドの記載形式」を参照してください。

この項の構成

(1) 形式

(2) 機能

(3) パラメーター

(4) 注意

(5) リターンコード

(1) 形式

YKP2A
△₁PREFIX(プレフィックス)
△₁DEVN(デバイス番号1,デバイス番号2)
△₁DAD(DADID1{,DADID2,[DADID3]}|{,,DADID3})
[△₁CGNAME1(TCコピーグループ名)]
[△₁CGNAME2(TCAコピーグループ名)]
[△₁CGNAME3(SIコピーグループ名)]

(2) 機能

指定した範囲のSI，TC，およびTCAのP-VOLをスキャンし，検出されたP-VOLとペアを組むS-VOLとのPPRCコピーペアをMainframe Agentのコピーグループとして定義して，Configurationファイル（ディスク構成定義ファイルおよびコピーグループ定義ファイル）を生成します。コピーグループ定義ファイルは，コピー種別ごとに生成されます。

コピーグループ定義ファイルは次の単位で生成されます。

SIおよびTC：検出されたすべてのPPRCコピーペアで一つ

TCA：C/Tグループ単位

生成されるディスク構成定義ファイル，およびコピーグループ定義ファイルの名称を次に示します。

ディスク構成定義ファイルの名称：プレフィックス.DSK.SNnnnnn.DADID

（凡例）

nnnnn：ストレージシステムのシリアル番号

コピーグループ定義ファイルの名称：プレフィックス.GRP.コピーグループ名xx

（凡例）

xx：00から始まる2けたの通し番号

(3) パラメーター

PREFIX (プレフィックス) ～ <16文字以内のPREFIX文字列>

生成するディスク構成定義ファイル，およびコピーグループ定義ファイルの名称に使用するプレフィックスを指定します。

DEVN (デバイス番号1，デバイス番号2) ～ <4けたの16進数>

スキャンするPPRCコピーペアのP-VOLの範囲をデバイス番号で指定します。デバイス番号1にはスキャンする範囲の最初のDEVN，デバイス番号2には終端のDEVNを指定してください。例えば，DEVN(7000,7300)と指定した場合，デバイス番号が7000から7300の範囲でPPRCコピーペアのP-VOLがスキャンされます。

デバイス番号1がデバイス番号2より大きい場合は，デバイス番号2をスキャンする範囲の最初のDEVN，デバイス番号１を終端のDEVNとみなします。

YKP2Aコマンドを実行すると，PPRC以外のコピーペアも検出されます。一つの環境にPPRCコピーペアとPPRC以外のコピーペアが両方存在する場合は，それぞれで運用しているコピーペアが同時に検出されないように，次の両方の項目に異なる値を指定してそれぞれのコピーペアをスキャンしてください。

スキャンするP-VOLのデバイス番号の範囲

Configurationファイルのプレフィックス

DAD (DADID1{,DADID2,[DADID3]}|{,,DADID3})～<28文字以内のDAD文字列>

DADは，ホストからアクセスできるボリュームの集合です。Mainframe Agentは，DADIDによってアクセスできるボリュームを認識します。PPRCコピーグループのConfigurationファイルを生成する場合，P-VOL，S-VOLにそれぞれ異なるDADIDを指定してください。

DADID1，DADID2，およびDADID3にはそれぞれ次の値を指定します。

DADID1：スキャンするPPRC TC/TCA/SIコピーペアのP-VOLが属するDADID

DADID2：スキャンするPPRC TC/TCAコピーペアのS-VOLが属するDADID

DADID3：スキャンするPPRC SIコピーペアのS-VOLが属するDADID

DADID3を省略すると，PPRC SI コピーグループのConfiguration ファイルは生成されません。

PPRC SIコピーグループのConfigurationファイルだけを生成する場合は，DADID1およびDADID3を指定し，DADID2の値を省略してください。

DADパラメーターの指定例を次に示します。

PPRC TCおよびTCAコピーグループのConfigurationファイルを生成する場合
DAD(DADID1,DADID2)

PPRC TC，TCA，およびSIコピーグループのConfigurationファイルを生成する場合
DAD(DADID1,DADID2,DADID3)

PPRC SIコピーグループのConfigurationファイルだけを生成する場合
DAD(DADID1,,DADID3)

重要

DADID1に指定した値と同じ値を初期設定パラメーターのPREFIXパラメーターに指定してください。

CGNAME1 (TCコピーグループ名)～<6文字以内のコピーグループ名文字列>

TCのコピーグループ名を指定します。

コピーグループ名は，ピリオドで結合される一つまたは複数の部分で構成されるコピーグループ名文字列で指定してください。

このパラメーターで指定したコピーグループ名に対し，00から始まる2けたの通し番号が昇順に与えられ，最大8文字のコピーグループ名となります。例えば，PREFIX(MFA.MIGRATE)とCGNAME1(MFATCS)を指定した場合でTCコピーグループが三つ生成されるとき，次の名称のConfigurationファイルが生成されます。

MFA.MIGRATE.GRP.MFATCS00
MFA.MIGRATE.GRP.MFATCS01
MFA.MIGRATE.GRP.MFATCS02

CGNAME1パラメーターを省略した場合，または名称を指定しなかった場合は，MYTCSが仮定されます。

CGNAME2 (TCAコピーグループ名)～<6文字以内のコピーグループ名文字列>

TCAのコピーグループ名を指定します。

コピーグループ名は，ピリオドで結合される一つまたは複数の部分で構成されるコピーグループ名文字列で指定してください。

このパラメーターで指定したコピーグループ名に対し，00から始まる2けたの通し番号が昇順に与えられ，最大8文字のコピーグループ名となります。例えば，PREFIX(MFA.MIGRATE)とCGNAME2(MFATCA)を指定した場合でTCAコピーグループが三つ生成されるとき，次の名称のConfigurationファイルが生成されます。

MFA.MIGRATE.GRP.MFATCA00
MFA.MIGRATE.GRP.MFATCA01
MFA.MIGRATE.GRP.MFATCA02

CGNAME2パラメーターを省略した場合，または名称を指定しなかった場合は，MYTCAが仮定されます。

CGNAME3 (SIコピーグループ名)～<6文字以内のコピーグループ名文字列>

SIのコピーグループ名を指定します。

コピーグループ名は，ピリオドで結合される一つまたは複数の部分で構成されるコピーグループ名文字列で指定してください。

このパラメーターで指定したコピーグループ名に対し，00から始まる2けたの通し番号が昇順に与えられ，最大8文字のコピーグループ名となります。例えば，PREFIX(MFA.MIGRATE)とCGNAME3(MFASI)を指定した場合でSIコピーグループが三つ生成されるとき，次の名称のConfigurationファイルが生成されます。

MFA.MIGRATE.GRP.MFASI00
MFA.MIGRATE.GRP.MFASI01
MFA.MIGRATE.GRP.MFASI02

CGNAME3パラメーターを省略した場合，または名称を指定しなかった場合は，MYSIが仮定されます。

(4) 注意

YKP2Aコマンドを実行することで生成されるディスク構成定義ファイル，およびコピーグループ定義ファイルと同じ名称のファイルがすでに存在する場合，すでに存在するファイルに上書きされます。
既存のファイルを保持したい場合は，PREFIXパラメーター，CGNAME1パラメーター，CGNAME2パラメーター，およびCGNAME3パラメーターに，既存のファイルとは異なる名称を指定してください。

Mainframe Agentの起動中に，YKP2Aコマンドを実行しないでください。必ず，Mainframe Agentを停止してからYKP2Aコマンドを実行してください。

Replication Managerと連携している場合，YKP2Aコマンドを実行すると，Configurationファイルの割り当てエラーになることがあります。この場合は，Replication Managerでストレージ情報の取得を停止したあとにMainframe Agentを停止してから，YKP2Aコマンドを再実行してください。

YKP2Aコマンドを実行するときに，Replication Managerから情報取得要求があると，エラーとなり情報を取得できない場合があります。この場合，次の要求（Replication Managerで設定した一定インタバル間隔）で情報取得されます。

(5) リターンコード

YKP2Aコマンド終了時のリターンコード一覧を次の表に示します。

表4-7 YKP2Aコマンドのリターンコード一覧

リターンコード | 意味
0 | 正常終了しました。ディスク構成定義ファイルおよびコピーグループ定義ファイルが生成されました。
4 | 正常終了しました。指定されたデバイス番号の範囲からは，PPRCコピーペアが検出されませんでした。
8 | スキャンする範囲中のボリュームでI/Oエラーが発生しました。検出に成功したボリュームのディスク構成定義ファイルおよびコピーグループ定義ファイルが生成されました。
44 | エラーが発生したため，処理を中断しました。ディスク構成定義ファイルおよびコピーグループ定義ファイルは生成されませんでした。
48 | 無効なパラメーターによって終了しました。
64 | REXX処理中にエラーが発生しました。

4.2.5 Configurationファイルの生成例

Configurationファイルがどのように生成されるかを次の三つの構成例を使用して説明します。

PPRC TCおよびTCAコピーペアを監視する構成例

PPRC SIコピーペアだけを監視する構成例

PPRC TCおよびSIコピーペアを監視する構成例

コピーペアの監視に使用するConfigurationファイルを生成するためには，YKP2Aコマンドを実行します。YKP2Aコマンドは，バッチジョブ，TSO/Eコマンドのどちらでも実行できます。

図4-6 PPRC TCおよびTCAコピーペアを監視する構成例から図4-8 PPRC TCおよびSIコピーペアを監視する構成例に共通する条件を次に示します。YKP2Aコマンドの実行に必要なDADIDおよびコピーグループ名は，それぞれの図に示します。

Configurationファイルのプレフィックス：MFA.MIGRATE

スキャンするP-VOLのデバイス番号の範囲：7300～730F

重要

生成されるコピーグループ定義ファイルの末尾に付けられる2けたの番号は，コピー種別ごとに自動的に付けられる通し番号です。

この項の構成

(1) PPRC TCおよびTCAコピーペアを監視する構成例

(2) PPRC SIコピーペアだけを監視する構成例

(3) PPRC TCおよびSIコピーペアを監視する構成例

(1) PPRC TCおよびTCAコピーペアを監視する構成例

PPRC TCおよびTCAコピーペアを組み合わせて運用している構成例を次の図に示します。

図4-6 PPRC TCおよびTCAコピーペアを監視する構成例

図4-6 PPRC TCおよびTCAコピーペアを監視する構成例の構成で次のYKP2Aコマンドを実行すると，MFATCSおよびMFATCAを監視するためのConfigurationファイルが生成されます。

YKP2A PREFIX(MFA.MIGRATE) DEVN(7300,730F) DAD(DAD1,DAD2) CGNAME1(MFATCS) CGNAME2(MFATCA)

生成されるConfigurationファイルは次のとおりです。

ディスク構成定義ファイル

MFA.MIGRATE.DSK.SN14001.DAD1
MFA.MIGRATE.DSK.SN14002.DAD1
MFA.MIGRATE.DSK.SN15001.DAD2
MFA.MIGRATE.DSK.SN15002.DAD2

コピーグループ定義ファイル

MFA.MIGRATE.GRP.MFATCS00
MFA.MIGRATE.GRP.MFATCA00

(2) PPRC SIコピーペアだけを監視する構成例

PPRC SIコピーペアだけで運用している構成例を次の図に示します。

図4-7 PPRC SIコピーペアだけを監視する構成例

図4-7 PPRC SIコピーペアだけを監視する構成例の構成で次のYKP2Aコマンドを実行すると，MFASIを監視するためのConfigurationファイルが生成されます。

YKP2A PREFIX(MFA.MIGRATE) DEVN(7300,730F) DAD(DAD1,,DAD3) CGNAME3(MFASI)

生成されるConfigurationファイルは次のとおりです。

ディスク構成定義ファイル

MFA.MIGRATE.DSK.SN14001.DAD1
MFA.MIGRATE.DSK.SN14001.DAD3

コピーグループ定義ファイル

MFA.MIGRATE.GRP.MFASI00

(3) PPRC TCおよびSIコピーペアを監視する構成例

PPRC TCおよびSIコピーペアを組み合わせて運用している構成例を次の図に示します。

図4-8 PPRC TCおよびSIコピーペアを監視する構成例

図4-8 PPRC TCおよびSIコピーペアを監視する構成例の構成で次のYKP2Aコマンドを実行すると，MFATCSおよびMFASIを監視するためのConfigurationファイルが生成されます。

YKP2A PREFIX(MFA.MIGRATE) DEVN(7300,730F) DAD(DAD1,DAD2,DAD3) CGNAME1(MFATCS) CGNAME3(MFASI)

生成されるConfigurationファイルは次のとおりです。

ディスク構成定義ファイル

MFA.MIGRATE.DSK.SN14001.DAD1
MFA.MIGRATE.DSK.SN15001.DAD2
MFA.MIGRATE.DSK.SN14001.DAD3

コピーグループ定義ファイル

MFA.MIGRATE.GRP.MFATCS00
MFA.MIGRATE.GRP.MFASI00

4.3 運用コマンド

Mainframe Agentを運用する際に使用するコマンドについて説明します。コマンドの文法説明で使用する記号については「表A-1 コマンドの文法説明で使用する記号」，コマンドの構文要素については「表A-2 コマンドの構文要素」を参照してください。

この節の構成

4.3.1 Mainframe Agentの起動

4.3.2 Mainframe Agentの正常終了

4.3.3 Mainframe Agentの強制終了

4.3.4 ログの出力レベルの表示

4.3.5 ログの出力レベルの変更

4.3.1 Mainframe Agentの起動

Mainframe Agentを起動するには， STARTコマンドを使用します。

Mainframe Agentはシステムに常駐し，初期設定パラメーターYKPRMxxの定義に従って動作します。Mainframe Agentは複数起動できます。

Mainframe AgentはHitachi Command Suite製品とTCP/IP通信を行うため，IBM Communications Serverを先に起動してください。Mainframe Agent起動時にIBM Communications Serverが起動されていない場合，YKY315Iメッセージが出力され，Mainframe Agentの起動に失敗します。

この項の構成

(1) 形式

(2) オペランド

(3) 使用例

(1) 形式

START
△₁起動用カタログドプロシジャ名［.識別名］
［，MEMBER=メンバ名］
［，SYSOUT=出力クラス］

(2) オペランド

起動用カタログドプロシジャ名

起動するMainframe Agentの起動用カタログドプロシジャ名を指定します。

識別名

起動用カタログドプロシジャの識別名を指定します。同じ起動用カタログドプロシジャ名で複数のジョブを起動する場合にジョブを識別するために指定します。

MEMBER=メンバ名

初期設定パラメーターのメンバ名を指定します。

省略した場合は，起動用カタログドプロシジャで指定した標準のメンバ名になります。

SYSOUT=出力クラス

出力リストの出力クラスを指定します。省略した場合は，システムの指定に従います。

(3) 使用例

次の条件でMainframe Agentを起動する場合の使用例を次に示します。

カタログドプロシジャ名：YKAGENTD

識別子：YK

初期設定パラメーター：YKPRM10

出力クラス：X

START YKAGENTD.YK,MEMBER=YKPRM10,SYSOUT=X

4.3.2 Mainframe Agentの正常終了

Mainframe Agentを正常終了させるには， STOPコマンドを使用します。

STOPコマンドを実行する前にHitachi Command Suite製品からの要求を受け付けている場合は，その処理を完了するまで停止処理は保留され，処理が完了した時点で終了します。

この項の構成

(1) 形式

(2) オペランド

(3) 使用例

(4) リターンコード

(1) 形式

STARTコマンドで起動用カタログドプロシジャ名と識別名の両方を指定した場合

STOP
△₁［起動用カタログドプロシジャ名.］識別名

STARTコマンドで起動用カタログドプロシジャ名だけを指定した場合

STOP
△₁起動用カタログドプロシジャ名

(2) オペランド

起動用カタログドプロシジャ名

Mainframe Agentを起動したときにSTARTコマンドで指定した起動用カタログドプロシジャ名を指定します。

識別名

Mainframe Agentを起動したときにSTARTコマンドで指定した識別名を指定します。

(3) 使用例

識別名YKで起動したMainframe Agentを正常終了させる場合の使用例を次に示します。

STOP YK

(4) リターンコード

Mainframe Agent終了時のリターンコード一覧を次の表に示します。

表4-8 Mainframe Agent終了時のリターンコード一覧

リターンコード（10進数）
意味

0
正常終了しました（STOPコマンドによる停止）。

4
即時停止しました（子タスクが0以外のリターンコードで終了または異常終了）。

8

初期設定パラメーターの解析でエラーが発生しました。

YKLIST DDのオープンに失敗しました。

12

ジョブステップタスクが使用するテーブルのGETMAIN処理に失敗しました。

そのほかの初期設定エラー（初期設定パラメーター解析以外）が発生しました。

RACFのFACILITYクラスにプロファイルが定義されていません。

Mainframe AgentがIKJEFT01経由で起動していません。

4.3.3 Mainframe Agentの強制終了

Mainframe Agentを強制終了させるには， CANCELコマンドを使用します。このとき，すべての要求が中断されてMainframe Agentは終了します。

この項の構成

(1) 形式

(2) オペランド

(3) 使用例

(1) 形式

STARTコマンドで起動用カタログドプロシジャ名と識別名の両方を指定した場合

CANCEL
△₁［起動用カタログドプロシジャ名.］識別名

STARTコマンドで起動用カタログドプロシジャ名だけを指定した場合

CANCEL
△₁起動用カタログドプロシジャ名

(2) オペランド

起動用カタログドプロシジャ名

Mainframe Agentを起動したときにSTARTコマンドで指定した起動用カタログドプロシジャ名を指定します。

識別名

Mainframe Agentを起動したときにSTARTコマンドで指定した識別名を指定します。

(3) 使用例

識別名YKで起動したMainframe Agentを強制終了させる場合の使用例を次に示します。

CANCEL YK

4.3.4 ログの出力レベルの表示

Mainframe Agentの現在のログ出力レベルを表示するには，DISPLAY LOGLEVELを指定したMODIFYコマンドを使用します。

この項の構成

(1) 形式

(2) オペランド

(3) 使用例

(1) 形式

STARTコマンドで起動用カタログドプロシジャ名と識別名の両方を指定した場合

MODIFY
△₁［起動用カタログドプロシジャ名.］識別名
,DISPLAY LOGLEVEL

STARTコマンドで起動用カタログドプロシジャ名だけを指定した場合

MODIFY
△₁起動用カタログドプロシジャ名
,DISPLAY LOGLEVEL

(2) オペランド

起動用カタログドプロシジャ名

Mainframe Agentを起動したときにSTARTコマンドで指定した起動用カタログドプロシジャ名を指定します。

識別名

Mainframe Agentを起動したときにSTARTコマンドで指定した識別名を指定します。

DISPLAY LOGLEVEL

現在のログの出力レベルを表示します。

(3) 使用例

識別名YKで起動したMainframe Agentの現在のログ出力レベルを表示する場合の使用例を次に示します。

MODIFY YK,DISPLAY LOGLEVEL
YKY114I LOGLEVEL=2

4.3.5 ログの出力レベルの変更

Mainframe Agentのログの出力レベルを変更するには，SETINIT LOGLEVELを指定したMODIFYコマンドを使用します。

この項の構成

(1) 形式

(2) オペランド

(3) 使用例

(1) 形式

STARTコマンドで起動用カタログドプロシジャ名と識別名の両方を指定した場合

MODIFY
△₁［起動用カタログドプロシジャ名.］識別名
,SETINIT LOGLEVEL(出力レベル)

STARTコマンドで起動用カタログドプロシジャ名だけを指定した場合

MODIFY
△₁起動用カタログドプロシジャ名
,SETINIT LOGLEVEL(出力レベル)

(2) オペランド

起動用カタログドプロシジャ名

Mainframe Agentを起動したときにSTARTコマンドで指定した起動用カタログドプロシジャ名を指定します。

識別名

Mainframe Agentを起動したときにSTARTコマンドで指定した識別名を指定します。

SETINIT LOGLEVEL(出力レベル) ～ <数字> ((0～2))

変更後の出力レベルを指定します。

出力レベルの詳細については，「3.4.2(2) パラメーター」を参照してください。

(3) 使用例

識別名YKで起動したMainframe Agentのログの出力レベルを2に変更する場合の使用例を次に示します。

MODIFY YK,SETINIT LOGLEVEL(2)
YKY111I LOGLEVEL WAS CHANGED
YKY114I LOGLEVEL=2

5. メッセージ

この章では，Mainframe Agentが出力するメッセージについて説明します。

この章の構成

5.1 メッセージの形式

5.2 メッセージの出力先

5.3 メッセージ一覧

5.4 ユーザー完了コード

5.1 メッセージの形式

Mainframe Agentが出力するメッセージの形式と，マニュアルでの記載形式を示します。

この節の構成

5.1.1 メッセージの出力形式

5.1.2 メッセージの記載形式

5.1.1 メッセージの出力形式

Mainframe Agentが出力するメッセージの形式を示します。メッセージは，メッセージIDとそれに続くメッセージテキストで構成されます。形式を次に示します。

YYYnnnZ メッセージテキスト

メッセージIDは，次の内容を示しています。

YYY

メッセージの出力元を示します。

YKS：YKSTORE（YKP2Aの内部プログラム）

YKT：YKALCSVC

YKY：Mainframe Agent，YKP2A

YKZ：すべてのコマンド

nnn

メッセージの通し番号を示します。

Z

メッセージの重要度を示します。

E：エラーであることを示します。

W：警告であることを示します。

I：情報の通知であることを示します。

5.1.2 メッセージの記載形式

このマニュアルでのメッセージの記載形式を示します。メッセージは，メッセージID順に記載しています。記載形式を次に示します。

メッセージID メッセージの出力先 SC=xx※1 RC=xx※2(付加情報)※3，4
メッセージテキスト※4，5
メッセージの説明※4

注※1

Severity Codeのことで，重要度を表す値です。

注※2

Return Codeのことで，メッセージを出力する際に設定される値です。コマンドのリターンコードには，コマンド処理中に出力されたメッセージのリターンコードのうち，最も大きな値が設定されます。

注※3

エラーの個所，コピーペア番号などの，特定の事柄を確認するための詳細情報です。

注※4

< >で囲まれている文字列は，可変であることを示します。

注※5

［］で囲まれている文字列は，省略される場合があることを示します。

5.2 メッセージの出力先

Mainframe Agentが出力するメッセージの出力先を次に示します。

TSO
TSO/E端末に出力されます。

CON
コンソールに出力されます。

SYS
SYSLOGに出力されます。

PRT
SYSPRINTに出力されます。

XML
Hitachi Command Suite製品側のログや画面に出力されます。

5.3 メッセージ一覧

Mainframe Agentが出力するメッセージと対処方法について説明します。

メッセージID
メッセージテキスト
メッセージの説明

YKS085E TSO SC=44
Error reported during file output. EXECIO RC =<n>
EXECIO TSO/E REXXコマンドでの失敗（リターンコード=<n>）によって，ディスク構成定義ファイルまたはコピーグループ定義ファイルの作成または更新処理に失敗しました。詳細は，マニュアル「TSO/E REXX解説書」を参照してください。

YKS086E TSO SC=44 (<file>)
File status is:<DSSTATE>
<file>に示された入力Configurationファイルは利用できない状態です。

<DSSTATE>

入力Configurationファイルの状態

入力Configurationファイルの属性が異常な場合，次のメッセージが出力されます。

DSORG = <XX>. DSORG must be <YY>
DSORG属性値が異常のため利用できません。現在のConfigurationファイルを削除して，正しいファイル属性値でConfigurationファイルを作成してください。

RECFM = <XX>. RECFM must be <YY>
RECFM属性値が異常のため利用できません。現在のConfigurationファイルを削除して，正しいファイル属性値でConfigurationファイルを作成してください。

LRECL = <XX>. LRECL must be <YY>
LRECL属性値が異常のため利用できません。現在のConfigurationファイルを削除して，正しいファイル属性値でConfigurationファイルを作成してください。

BLKSIZE = <XX>. BLKSIZE must be <YY>
BLKSIZE属性値が異常のため利用できません。現在のConfigurationファイルを削除して，正しいファイル属性値でConfigurationファイルを作成してください。

ALLOCATION FAILED
Configurationファイルの作成に失敗しました。デバイスの空き容量，およびVTOCの空きを確認してください。UNAVAILABLE DATASET
Configurationファイルが使用されています。Configurationファイルの使用状況を確認してください。
<XX>にはエラーとなったファイル属性値，<YY>には正しいファイル属性値が表示されます。

<file>

エラーが発生したConfigurationファイルの名称

YKS099I TSO SC=<max-severity>
YKSTORE Processing Complete.
YKSTORE（YKP2Aの内部プログラム）の処理が完了しました。
このメッセージは必ず表示されます。

<max-severity>

出力されたSCの中での最大値

YKS270E TSO SC=44
Failed to <operation> configuration file. (name =<dataset-name>, <dsstate>)
Configurationファイルの作成時にエラーが発生したため，Configurationファイルの作成を中止します。メッセージに出力された情報を参考に環境を見直したあとで，再度Configurationファイルを作成してください。

<operation>

Configurationファイルに対して行った操作

CREATE
Configurationファイルを作成する際に，エラーが発生しました。

UPDATE
既存のConfigurationファイルを更新する際に，エラーが発生しました。

<dataset-name>

作成するConfigurationファイルの名称

<dsstate>

Configurationファイルの状態

EXTENT=<extent>
現在割り当てられているデータセットのエクステント数
<extent>は，<dataset-name>で示されるデータセットに割り当てられているエクステント数です。

DSORG=VSAM
データセット形式がVSAMです。VSAM形式のデータセットはConfigurationファイルとして使用できません。Configurationファイルのデータセット形式はPSにしてください。

CANNOT GET DSSTATE, reason code=<nnnn>
データセット情報を取得できません。または，Configurationファイルが割り当てられていません。
<nnnn>(10進数)は，理由コード（保守情報）です。

YKS298E TSO SC=44 (<detailed-info>)
YKSTORE encountered an unexpected error.
予期しないエラーが発生しました。このエラーはほかのエラーに伴って発生したおそれがあります。
このエラーメッセージと同時にほかのエラーメッセージが出力されている場合は，ほかのエラーメッセージで示されている問題を先に解決してください。
ほかのエラーメッセージが出力されていない場合は，次の資料を採取した上で保守員に連絡してください。

このコマンドを実行したスクリプト

スクリプトから操作したConfigurationファイル（コピーグループ定義ファイル，ディスク構成定義ファイル）

<detailed-info>

エラー解析を助けるための詳細情報（保守員用）

YKT001E CON
Can't find SVCTABLE
NUCLKUPマクロで"SVCTABLE"の検索に失敗しました。プログラムは，ユーザー完了コード996で異常終了します。
保守員に連絡してください。

YKT002E CON
Can't find IGCERROR
NUCLKUPマクロで"IGCERROR"の検索に失敗しました。プログラムは，ユーザー完了コード996で異常終了します。
保守員に連絡してください。

YKT003E CON
No SVC #'s available
使用できるSVC番号がありません。プログラムは，ユーザー完了コード996で異常終了します。

YKT004E CON
Couldn't add SVC entry
SVCUPDTEマクロでSVC番号の追加に失敗しました。プログラムは，ユーザー完了コード996で異常終了します。
保守員に連絡してください。

YKT005E CON
Couldn't create name/token
Name/Tokenの登録に失敗しました。プログラムは，ユーザー完了コード996で異常終了します。
保守員に連絡してください。

YKT006W CON RC=16
Couldn't delete name/token
Name/Tokenの削除に失敗しました。
保守員に連絡してください。

YKT007W CON RC=16
Couldn't delete SVC entry
SVCUPDTEマクロでSVC番号の削除に失敗しました。
保守員に連絡してください。

YKT008E CON RC=20
System task started from TSO.
YKALCSVCコマンドがTSO/E環境から実行されました。
STARTコマンド，またはバッチJOBでYKALCSVCコマンドを実行してください。

YKT012E CON RC=16
Name/token error
Name/Tokenサービスでエラーが発生しました。
保守員に連絡してください。

YKT021E CON RC=20
Invalid parameter
PARMパラメーターに指定された値に誤りがあります。
PARMパラメーター指定値を見直してください。

YKT022E CON RC=4
SVC routine is already inserted
ユーザSVCルーチンはすでに登録されています。

YKT023E CON RC=16
Couldn't delete SVC routine
ユーザSVCルーチンの削除に失敗しました。
保守員に連絡してください。

YKT024E CON
Couldn't copy load module
ロードモジュールのコピーに失敗しました。プログラムは，ユーザー完了コード996で異常終了します。
保守員に連絡してください。

YKT025E CON RC=4
SVC routine is already deleted
ユーザSVCルーチンが登録されていないか，またはすでに削除されています。

YKT026E CON
SVC # is already used
指定されたSVC番号はすでに使用されています。プログラムは，ユーザー完了コード996で異常終了します。
YKALCSVCコマンドのPARMパラメーターに割り当てられていないSVC番号を指定するか，PARMパラメーターを指定しないで再実行してください。

YKT032E CON RC=20
The task is not APF-authorized.
Mainframe Agentのロードライブラリのデータセット名がSYS1.PARMLIBに登録されていません。または，ロードライブラリのDD文を連結した際に認可／非認可のデータセットが混在していたことが原因で，非認可データセットとして扱われたため，コマンドを実行できません。

YKT098I CON RC=0
SVC routine is deleted
ユーザSVCルーチンの削除に成功しました。

YKT099I CON RC=0
SVC routine is inserted
ユーザSVCルーチンの登録に成功しました。

YKT299I CON
<command> command return code=<nnnn>.
<command>で示されるコマンドは，リターンコード=<nnnn>で終了しました。

YKY001I CON
AGENT STARTED (<vv>-<rr>[-<zz>])
Mainframe Agentが起動されました。

<vv>

バージョン番号

<rr>

リビジョン番号

<zz>

特例

YKY002I CON
INVALID INITIALIZATION PARAMETER: <parameter-name>
初期設定パラメーターに定義されていないパラメーターが指定されました。または，<parameter-name>で示される初期設定パラメーターが不正です。Mainframe Agentは終了します。
初期設定パラメーターを訂正してから，Mainframe Agentを再起動してください。

YKY003I CON
INVALID CONTINUATION LINE FOUND. PARAMETER SCAN TERMINATED
初期設定パラメーターに継続行ありの指定がありますが，継続するパラメーターの指定がありません。Mainframe Agentは終了します。
初期設定パラメーターを訂正してから，Mainframe Agentを再起動してください。

YKY005I CON
AGENT INITIALIZATION FAILED P=<termination-code>
Mainframe Agentは，このメッセージより前に出力されたメッセージに示された理由で起動できません。
センター管理者に連絡してください。センター管理者は，このメッセージよりも前に出力されているメッセージを処置してから，Mainframe Agentを再起動してください。
<termination-code>(10進数)

04：IKJEFT01を使用しないで起動しようとしました。

08：初期設定パラメーターの解析処理に失敗しました。

48：処理モジュールのローディングでエラーが発生しました。

52：NAME/TOKENの書き込みエラーが発生しました。

56：RACFのFACILITYクラスにプロファイルが定義されていません。

60：サブタスクの初期化処理に失敗しました。

YKY008I CON
INSUFFICIENT SPACE AVAILABLE FOR INITIALIZATION
初期設定パラメーターの解析処理中に作業領域が不足したため，初期設定パラメーターの解析ができませんでした。Mainframe Agentは終了します。
Mainframe Agent起動用カタログドプロシジャのジョブステップのユーザーリージョン指定を見直してから，正しいメモリー所要量に修正しMainframe Agentを再起動してください。

YKY016I CON
TASK(<task-ID>) ABENDED,CODE=<completion-code>
Mainframe Agentの起動処理中に，タスクが異常終了しました。Mainframe Agentは終了します。

<task-ID>

タスクを識別する名称

<completion-code>

システムの完了コード

YKY018I CON
MODULE(<load-module-name>) NOT FOUND
<load-module-name>で示されるロードモジュールが見つかりません。Mainframe Agentは終了します。
ロードモジュールが正しくインストールされているか確認してください。

YKY019I CON
<dd-name> DD STATEMENT NOT FOUND
<dd-name>で示されるDD文が指定されていません。Mainframe Agentは終了します。
Mainframe Agent起動用カタログドプロシジャにDD文を指定してからMainframe Agentを再起動してください。

YKY020I CON
THE PROFILE IS NOT DEFINED IN THE FACILITY CLASS OF RACF: <xxxxxxxx>
RACFのFACILITYクラスにSTGADMIN.YKA.BCM.YKQUERYプロファイルまたはSTGADMIN.YKA.BCM.COMMANDSプロファイルが定義されていません。
RACFの設定を見直してからMainframe Agentを再起動してください。

<xxxxxxxx>

保守情報

YKY021I CON
A NAME/TOKEN WRITE ERROR OCCURRED,RC=<return-code>,NAME=<name>
NAME/TOKENの書き込みエラーが発生したため，実行できません。Mainframe Agentは終了します。

<return-code>

NAME/TOKEN登録ルーチン(IEANTCR)が設定するリターンコード

<name>

NAME/TOKENサービスに登録する名称

YKY022I CON
THE SPECIFIED PREFIX IS BEING USED BY ANOTHER PROGRAM
指定したプレフィックスはほかのプログラムで使用中です。
初期設定パラメーターを見直してください。

YKY051I CON
AGENT ENDED
Mainframe Agentが終了しました。

YKY052I CON
AGENT IN SCHEDULED SHUTDOWN
Mainframe Agentの終了処理が開始されました。

YKY053I CON
AGENT ABENDED
Mainframe Agentが異常終了しました。
原因が不明な場合は，SYSABENDダンプ形式のABENDダンプを採取してから，顧客問い合わせ窓口に調査を依頼してください。

YKY100I CON
MODIFY COMMAND ACCEPTED
MODIFYコマンドが受け付けられました。

YKY101I CON
STOP COMMAND ACCEPTED
STOPコマンドが受け付けられました。

YKY102I CON
INVALID <error-type>: <text>
MODIFYコマンド入力後，<text>で示されるコマンドまたはオペランドに誤りがあります。
入力したコマンドを見直してください。
<error-type>

COMMAND：コマンドに誤りがあることを示します。

OPERAND：オペランドに誤りがあることを示します。

YKY103I CON
COMMAND SYNTAX ERROR
入力されたコマンドの構文に誤りがあります。
入力したコマンドを見直してください。

YKY104I CON
OPERAND IS INCORRECT
オペランドの内容に誤りがあります。
誤りを訂正してから再度入力してください。

YKY111I CON
<parameter-name> WAS CHANGED
<parameter-name>で示される初期設定パラメーターの値を変更しました。

YKY114I CON
<parameter-name>=<parameter-value>
初期設定パラメーターの現在の値が表示されます。

<parameter-name>

初期設定パラメーター名

<parameter-value>

初期設定パラメーター値

YKY130I CON
SESSION NO.=<session-number>
TCP/IPセッションの番号が表示されます。このメッセージの次に，TCP/IPセッション情報が表示されます。

<session-number>

セッションを区別するための番号

YKY131I CON
<host-type> PORT=<port-number> HOST=<IP-address>
自ホストまたは相手ホストのポート番号とIPアドレスが表示されます。このメッセージの次に，TCP/IPセッション情報が表示されます。

<host-type>

TCP/IPセッション情報が表示されるホスト種別

LOCAL：自ホスト

REMOTE：相手ホスト

<port-number>

<host-type>にLOCALが表示されている場合

自ホストのポート番号

<host-type>にREMOTEが表示されている場合

相手ホストのポート番号

<IP-address>

<host-type>にLOCALが表示されている場合
自ホストのIPアドレス

<host-type>にREMOTEが表示されている場合
相手ホストのIPアドレス

YKY132I CON
CONNECTING START TIME=<YYYY/MM/DD hh:mm:ss>
該当するTCP/IPセッションが確立した時刻が表示されます。このメッセージの次に，TCP/IPセッション情報が出力されます。

<YYYY/MM/DD hh:mm:ss>

時刻（ローカル時刻）

YKY133I CON
LAST <data-direction-type> TIME=<YYYY/MM/DD hh:mm:ss>
該当するTCP/IPセッションで，最後に送信または受信した時刻が表示されます。

<data-direction-type>

<YYYY/MM/DD hh:mm:ss>に出力されている時刻に送られたデータの方向

SEND：送信

RECV：受信

<YYYY/MM/DD hh:mm:ss>

時刻（ローカル時刻）

YKY300I SYS
<hh:mm:ss> <task-ID>,TCP CONNECTION ACCEPTED
TCPコネクションの確立要求が受け付けられました。リモートホストとの通信情報がYKY307Iメッセージに出力されます。

<hh:mm:ss>

メッセージの出力時刻（ローカル時刻）

<task-ID>

メッセージを出力した処理タスクを識別するための番号

YKY301I SYS
<hh:mm:ss> <task-ID>,TCP CONNECTION ENDED NORMALLY
TCPコネクションが正常に解放されました。

<hh:mm:ss>

メッセージの出力時刻（ローカル時刻）

<task-ID>

メッセージを出力した処理タスクを識別するための番号

YKY304I SYS
<hh:mm:ss> <task-ID>,REQUEST DENIED,REASON=(<reason-for-denial>)
要求は受信されましたが，破棄されました。

<hh:mm:ss>

メッセージの出力時刻（ローカル時刻）

<task-ID>

メッセージを出力した処理タスクを識別するための番号

<reason-for-denial>

INVALID FORMAT：形式が不正です。

VERSION MISMATCH：バージョンが一致しません。

YKY305I CON
<task-ID>,TCP CONNECTION LOST DURING EVENT PROCESSING,TCP-STATUS=(<reason-for-disconnection>)
TCP/IP処理中に，<reason-for-disconnection>に示される理由でTCPコネクションが不当に切断されました。
相手ホストからコネクションを切断された理由を調査してください。

<task-ID>

メッセージを出力した処理タスクを識別するための番号

<reason-for-disconnection>

FIN ACCEPT：相手ホストから切断要求（TCP-FIN）を受け取りました。

RST ACCEPT：相手ホストから切断要求（TCP-RST）を受け取りました。

YKY307I SYS
<hh:mm:ss> <task-ID>,TCP CONNECTION INFORMATION,REMOTE-HOST=<IP-address>,REMOTE-PORT=<remote-port-number>,LOCAL-PORT=<local-port-number>
TCPコネクションの確立要求が受け付けられました。
このメッセージより前に出力されているメッセージの対処方法に従ってください。

<hh:mm:ss>

メッセージの出力時刻（ローカル時刻）

<task-ID>

メッセージを出力した処理タスクを識別するための番号

<IP-address>

リモートホストのIPアドレス

<remote-port-number>

リモートホストのポート番号

<local-port-number>

自ホストのポート番号

YKY315I CON
<task-ID>,COMMUNICATION ERROR,@API[,<request-name>[,RC=<response-code>]][,EC=<event-code>][,SRC=<local-IP-address>:<local-port-number>][,DST=<connection-target-IP-address>:<connection-target-port-number>]
通信処理中にエラーが検出されました。要求名，自IPアドレス:自ポート番号（10進数），および接続先IPアドレス:接続先ポート番号（10進数）が表示されます。実行中の処理は中断されます。
必要があれば，このメッセージの直前に出力されているYKY330Iメッセージを参照し，エラーの原因を調査してください。

<task-ID>

メッセージを出力した処理タスクを識別するための番号

<request-name>

@OPNSAP：前処理

@OPEN：コネクション確立処理

@SEND：送信処理

@RECV：受信処理

@CLOSE：コネクション解放処理

@QUERY：相手アドレス検索処理

@ABORT：コネクション強制解放処理

@QUIT：後処理

<response-code>

<request-name>で示される要求を実行中に発生したコード

<event-code>

TCP/IPセッション処理中に発生した事柄

<local-IP-address>

自ホストのIPアドレス

<local-port-number>

自ホストのポート番号

<connection-target-IP-address>

相手ホストのIPアドレス

<connection-target-port-number>

相手ホストのポート番号

YKY321I CON
<task-ID>,COMMUNICATION TIMED OUT
応答待ち時間を過ぎても応答がありません。コネクションは切断されます。
応答がない理由を調査してください。

<task-ID>

メッセージを出力した処理タスクを識別するための番号

YKY330I CON
SOCKET API FAILURE (<maintenance-information>,<request-type>,<return-code>,<error-number>)
IBM TCP/IP for MVSのソケットインタフェースで，<request-type>で示される要求でエラーが発生しました。<return-code>および<error-number>は，そのときのエラー情報です。
エラーの原因を調査し対処してください。TCP/IPが障害で停止した場合，Mainframe Agentも停止し障害回復後，TCP/IPプログラムを起動してからMainframe Agentを起動してください。

<maintenance-information>

エラー解析を助けるための詳細情報

<request-type>

要求種別を示す次のうちのどれかが表示されます。

"ACCEPT "

"BIND "

"CLOSE "

"INITAPI "

"IOCTL "

"LISTEN "

"RECV "

"SETSOCKOPT "

"SOCKET "

要求種別に対するリターンコード（RETCODE），およびエラー番号（ERRNO）については，マニュアル「Communications Server IP アプリケーション・プログラミング・インターフェース・ガイド」を参照してください。

YKY362I CON
RECEIVED DATA SIZE INVALID,DST=<connection-target-IP-address>:<connection-target-port-number>
Mainframe Agentが<connection-target-IP-address>:<connection-target-port-number>から受信したデータのサイズが不正です。該当する受信処理を中止します。
受信できるサイズは4,096バイトです。受信サイズを見直してから再実行してください。

YKY600I CON
INSUFFICIENT SPACE AVAILABLE. <maintenance-information>
Mainframe Agentでの領域の確保に失敗しました。Mainframe Agentは終了します。
リージョンサイズを大きくしてからMainframe Agentを再起動してください。

<maintenance-information>

エラー解析を助けるための詳細情報

YKY604I CON
IRXJCL MODULE ERROR,CODE=<return-code>
IRXJCLルーチンが，<return-code>で示されるリターンコードでエラーリターンしました。Mainframe Agentは処理を終了します。
リターンコードを調査してください。リターンコードが20の場合，Mainframe Agent起動用カタログドプロシジャのSYSEXEC DD文が誤っているおそれがあります。JCLを見直してから再実行してください。
<return-code>

20：処理が失敗しました。EXEC処理は処理されませんでした。

20021：IRXJCLに渡したパラメーターリストが誤っていました。

YKY605I CON
IRXINIT MODULE ERROR,CODE=<return-code>,R0=<abnormal-termination-code-and-reason-code-for-abnormal-termination>,PARM7=<reason-code>
IRXINITルーチンが，<return-code>で示されるリターンコードでエラーリターンしました。Mainframe Agentは処理を終了します。
リターンコードを調査してください。
<return-code>

20：エラーが発生したため，処理が失敗しました。IRXINITがPARM7に返す理由コードを調査してください。

100：IRXINITが環境の検出中にシステム異常終了が発生したため，処理が失敗しました。システムは，異常終了を記述するメッセージを複数出力することがあります。さらに，R0は異常終了コードおよび異常終了理由コードを含みます。

<abnormal-termination-code-and-reason-code-for-abnormal-termination>

IRXINITは，異常終了コードをR0の下位2バイトに入れて返します。IRXINITは，異常終了理由コードをR0の高位2バイトに入れて返します。異常終了理由コードが2バイトより大きい場合，IRXINITは異常終了理由コードの下位2バイトだけを返します。異常終了コードと理由コードについては，マニュアル「MVS システム・コード」を参照してください。

<reason-code>

理由コードについては，マニュアル「TSO/E REXX 解説書」を参照してください。

YKY606I CON
IRXTERM MODULE ERROR,CODE=<return-code>,R0=<abnormal-termination-code-and-reason-code-for-abnormal-termination>
IRXTERMルーチンが<return-code>で示されるリターンコードでエラーリターンしました。Mainframe Agentは処理を終了します。
リターンコードを調査してください。

<return-code>

リターンコードについては，マニュアル「TSO/E REXX 解説書」を参照してください。

<abnormal-termination-code-and-reason-code-for-abnormal-termination>

R0は異常終了コードおよび異常終了理由コードを含みます。IRXTERMは，異常終了コードをR0の下位2バイトに入れて返します。IRXTERMは，異常終了理由コードをR0の高位2バイトに入れて返します。異常終了理由コードが2バイトより大きい場合，IRXTERMは異常終了理由コードの下位2バイトだけを戻します。異常終了コードと理由コードについては，マニュアル「MVS システム・コード」を参照してください。

YKY680I SYS
<hh:mm:ss> <task-ID>,<command>,RC=<return-code>[,<text>]
Mainframe Agentが実行したコマンドは，<return-code>で終了しました。エラーが検出された場合，<text>にメッセージが出力されます。
メッセージ長が126文字を超えた場合，複数行に出力されます。一つのコマンドで出力されるメッセージ行数の上限は10行です。

<hh:mm:ss>

メッセージの出力時刻（ローカル時刻）

<task-ID>

メッセージを出力した処理タスクを識別するための番号

<command>

Mainframe Agentが実行したコマンド名

<return-code>

Mainframe Agentが実行したコマンドのリターンコード

<text>

Mainframe Agentが実行したコマンドによって出力されたメッセージテキスト（保守情報）

YKY699I CON
AGENT FUNCTION ABEND CODE=<Sxxx> <Uxxxx> DATE=<yy-mm-dd> TIME=<hh:mm:nn>
ABENDED-MODULE=<module-name> C-DATE=<module-creation-date> BASE=<bbbbbbbb> DISP=<dddd>
[CALLING-MODULE=<module-name> C-DATE=<y'y'.m'm'.d'd'> BASE=<bbbbbbbb> DISP=<dddd>]
PSW=<pppppppp pppppppp> ILC=<ll> INTC=<xx>
REGISTERS AT TIME OF FAILURE
GR 00-03 <contents-of-register-0 contents-of-register-1 contents-of-register-2 contents-of-register-3>
GR 04-07 <contents-of-register-4 contents-of-register-5 contents-of-register-6 contents-of-register-7>
GR 08-11 <contents-of-register-8 contents-of-register-9 contents-of-register-10 contents-of-register-11>
GR 12-15 <contents-of-register-12 contents-of-register-13 contents-of-register-14 contents-of-register-15>
Mainframe Agent処理中に，メインタスクまたはサブタスクが異常終了しました。回復できなかった場合，Mainframe Agentは終了します。
センター管理者に連絡してください。

<Sxxx>(16進数)

タスク異常終了時のシステム完了コード

<Uxxxx>(10進数)

タスク異常終了時のユーザー完了コード

<yy-mm-dd>

タスク異常終了時の日付

<hh:mm:nn>

タスク異常終了時の時刻

<module-name>

Mainframe Agentモジュールのセクション名またはロードモジュール名

モジュールを特定できない場合，UNKNOWNが表示されます。UNKNOWNが表示された場合，<y'y'.m'm'.d'd'>, <bbbbbbbb>の値は正しくありません。

<module-creation-date>

次のどちらかの形式で表示されます。

<y'y'.m'm'.d'd'>：<module-name>で示されたモジュールの作成日付

<y'y'/m'm'/d'd'>：<module-name>で示されたモジュールの作成日付

<bbbbbbbb>

ベースレジスターの内容

<dddd>

ABENDED-MODULEの場合：ABENDED-MODULEを呼び出した場所のモジュールの先頭からの相対位置

CALLING-MODULEの場合：CALLING-MODULEを呼び出した場所のモジュールの先頭からの相対位置

<pppppppp pppppppp>

異常終了したときのPSW

<ll>

異常終了したときの命令の長さ

<xx>

異常終了時の割り込みコード

YKY703E XML
XML translation error: The sent entity is not XML.
XMLエラーです。送信されたエンティティはXMLではありません。
リクエスト記述を見直してください。

YKY704E XML
End of request was detected in the comment.
コメントの途中で，XMLリクエストの終わりを検出しました。
コメントの記述を見直してください。

YKY705E XML
End of request was detected in an element.
要素の途中で，XMLリクエストの終わりを検出しました。
XMLリクエストの最後の要素の記述を見直してください。

YKY706E XML
The number of elements exceeded the allowed limit.
要素の階層が指定できる範囲（最大16）を超えました。
リクエスト記述を見直してください。

YKY707E XML
The request version is mismatch.
XMLリクエストのAPIバージョンが，対応できるバージョンではありません。
Mainframe Agentがサポートしているバージョンかどうか確認してください。

YKY713E XML
An invalid element '<element-name>' was specified in the XML request.
XMLリクエスト中に，不正な要素が指定されています。
リクエスト記述を見直してください。

<element-name>

要素名

YKY714E XML
An invalid parameter '<parameter-name>' was specified in the XML request element '<element-name>'.
XMLリクエスト中の要素に不正な属性が指定されています。
リクエスト記述を見直してください。

<element-name>

要素名

<parameter-name>

属性名

YKY715E XML
An invalid value was specified for the parameter '<parameter-name>' in the XML request element '<element-name>'.
XMLリクエスト中の要素の属性に不正な値が指定されています。
リクエスト記述を見直してください。

<element-name>

要素名

<parameter-name>

属性名

YKY716E XML
An invalid child element '<child-element-name>' was specified in the XML request element '<parent-element-name>'.
XMLリクエスト中の親要素に不正な子要素が指定されています。親要素名が取得できなかった場合，親要素名はnullになります。
リクエスト記述を見直してください。

<parent-element-name>

親要素名

<child-element-name>

子要素名

YKY717E XML
A required element is missing from the request. '<element>'
リクエスト中の要素が不足しています。
リクエスト中の要素の指定を見直してください。

<element>

不足している要素名

YKY718E XML
A required parameter is missing from the element '<element-name>' of the request. '<parameter-name>'
必須パラメーターが要素中にありません。
リクエストの該当要素の記述を見直してください。

<element-name>

要素名

<parameter-name>

必要なパラメーター名

YKY719E XML
There is a conflict with element '<element-name>'.
<element-name>で示される要素の終了タグに対応する開始タグが指定されていないか，終了タグと開始タグの対応関係が正しくありません。
リクエストの該当要素の記述を見直してください。

<element-name>

要素名

YKY720E XML
The request failed because the prefix '<prefix>' was not found in the Mainframe Agent initialization parameter.
要求されたプレフィックスがMainframe Agentの初期設定パラメーターにありません。
リクエスト記述を見直してください。

<prefix>

要求されたプレフィックス

YKY726E XML
Configuration file error CGname '<cgname>' <error-type>.
Configurationファイルで<error-type>に示すエラーが発生したため，コピーグループ定義情報を取得できませんでした。

<cgname>

コピーグループ名

<error-type>

ALLOCATE：アロケートエラー
<cgname>で示すコピーグループのConfigurationファイルが存在するか確認してください。

EXECIO：入力エラー
<cgname>で示すコピーグループのConfigurationファイルが破壊されていないか確認してください。

format：XML形式エラー
XMLの記述に誤りがないか確認してください。

version：バージョンエラー
定義情報のバージョンに誤りがないか確認してください。

YKY901I TSO
YKP2A completed. RC=<return-code>
YKP2Aコマンドが終了しました。

<return-code>

YKP2Aコマンドのリターンコード

YKY902I TSO
No copy pair was discovered.
指定された範囲内にコピーペアを検知しませんでした。
取得したいコピーペアが動作する範囲および状態を確認し，再度YKP2Aコマンドを実行してください。コピーペア状態がSimplexの場合，YKP2Aコマンドはコピーペアを検知できません。

YKY910E TSO
Missing or invalid parameter: <Parameter name>
パラメーターの指定が不正，または不足しています。
次の点を見直してから，再実行してください。

<Parameter name>で示される，指定必須のパラメーターを指定したかどうか

<Parameter name>で示される，指定必須のパラメーターに指定した値が正しいかどうか

DADパラメーターに指定したプライマリサイトのDADIDとセカンダリサイトのDADIDが同じになっていないかどうか

<Parameter name>

不正，または不足しているパラメーターの名称

YKY912E TSO
Error occurred during execution. Cmd=<info>
msg=<message text>:<message value>:<message severity>
YKP2Aコマンド実行中にエラーが発生しました。
<message text>で示されるエラーメッセージのメッセージIDに対応する説明文を参照して対処してください。また，<message value>および<message severity>で示される付加情報を参照して対処してください。問題が解決しない場合は，保守員に連絡してください。

<info>

保守情報

<message text>

エラーメッセージ

<message value>

エラーメッセージの付加情報

付加情報がない場合は空白が表示されます。

<message severity>

エラーメッセージの付加情報

付加情報がない場合は空白が表示されます。

<message text>，<message value>，および<message severity>はTSO/E端末上に表示されます。エラーメッセージの長さによっては，複数行にわたって表示されます。

YKY920W TSO
No information was acquired for DEVN=<Devn>
<Devn>で示すデバイス番号のボリュームからコピーペア情報を取得できませんでした。
指定したデバイス番号にボリュームが存在しないおそれがあります。ボリュームが存在する場合，チャネルの設定を確認してください。

<Devn>

コピーペア情報を取得できなかったボリュームのデバイス番号

YKY921W TSO
No I/O paths are available for the specified devices. DEVN=<Devn>
<Devn>で示すデバイス番号のボリュームは，使用できる入出力パスがないためコピーペア情報を取得できませんでした。
入出力パスの設定を確認してください。

<Devn>

情報取得をスキップしたボリュームのデバイス番号

YKY999E TSO CON
MFAgent cannot use this REXX exec library.
Mainframe Agentでは使用できないREXXスクリプトが実行されました。
dd名SYSEXECで連結しているREXX Execライブラリを確認してください。

YKZ201E CON PRT SC=44
A GETMAIN error occurred. (return code=<nnn>, size=<mmm>, area=<area>, cmd=<xxx>, pos=<yyy>)
GETMAINエラーが発生したため，実行できません。
ジョブ実行領域を拡張してから再実行してください。

<nnn>(10進数)

GETMAINマクロのリターンコード

<mmm>(10進数)

領域のサイズ

<area>(文字列)

「HIGH」は16MB以上，「LOW」は16MB未満

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

0：YKLOAD，または任意のコマンド(YKP2Aの内部プログラム)

2：YKSCAN(YKP2Aの内部プログラム）

19：YKQRYDEV(YKP2Aの内部プログラム)

<yyy>(文字列)

保守情報

YKZ206E TSO
An I/O error occurred. (detail=<message-text>, cmd=<xxx>, pos=<yyy>)
I/Oエラーが発生したため，実行できません。

<message-text>(文字列)

メッセージテキスト

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ207E TSO CON SC=52
A Core process error occurred. (detail=<message-text>, cmd=<xxx>, pos=<yyy>)
Coreの処理エラーが発生したため，実行できません。

<message-text>(文字列)

メッセージテキスト：メッセージテキストには，次の内容が設定されます。

OSマクロエラーが発生したとき
<xxxxxxxx> macro error, return code = <rr>,devn = <dddd>
<xxxxxxxx>：OSのマクロ名
<rr>：マクロのリターンコード
<dddd>：デバイス番号

システム名が取得できなかったとき
ASASYMBM macro error, rc = <rr>
<rr>：ASASYMBMマクロのリターンコード

ログストリームの定義がDASD専用でないとき
Not DASD-only Logger definition

ログストリームの定義のMAXBUFSIZEが64000でないとき
MAXBUFSIZE of Logger definition invalid

保守情報のとき（1）
ENTRYID( <eeeee> ) for MSGID( <nnn> ) is invalid
<eeeee>, <nnn>：保守情報

保守情報のとき（2）
ENTRYID( <eeeee> ) for TYPE( <ttt> ), LEVEL( <lll> ) is invalid
<eeeee>, <ttt>, <lll>：保守情報

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ208I TSO PRT
The Core processing( <process> ) started. (DATE=<yyyy/mm/dd>, TIME=<hh:mm:ss.th>, TOD=<ttt>, cmd=<xxx>, pos=<yyy>)
YKP2Aの内部プログラム処理を開始します。

<process>(文字列)

処理名

<yyyy/mm/dd>(文字列)

GMTの日付

<hh:mm:ss.th>(文字列)

GMTの時刻

<ttt>(文字列)

GMTの時刻形式

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ209I TSO PRT
The Core processing( <process> ) ended. (DATE=<yyyy/mm/dd>, TIME=<hh:mm:ss.th>, TOD=<ttt>, cmd=<xxx>, pos=<yyy>)
YKP2Aの内部プログラム処理を終了します。

<process>(文字列)

処理名

<yyyy/mm/dd>(文字列)

GMTの日付

<hh:mm:ss.th>(文字列)

GMTの時刻

<ttt>(文字列)

GMTの時刻形式

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ211E CON SC=40
A NAME/TOKEN write error occurred. (return code=<nnn>, name= <name>, cmd=<xxx>, pos=<yyy>)
NAME/TOKENの書き込みエラーが発生したため，実行できません。

<nnn>(10進数)

NAME/TOKEN登録ルーチン（IEANTCR）が設定するリターンコード

<name>(文字列)

NAME/TOKENサービスに登録する名称

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ212W CON※
A FREEMAIN error occurred. (return code=<nnn>, cmd=<xxx>, pos=<yyy>)
FREEMAINエラーが発生しました。

<nnn>(10進数)

FREEMAINマクロのリターンコード

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

注※　ログ，トレース取得時以外にこのメッセージが出力された場合は，YKZ212Wメッセージはコンソールに出力されません。LOG，TRACEに記録して処理を続行します。

YKZ219W CON
A LOAD error occurred. (return code=<nnn>, reason code=<mmm>, name=<name>, cmd=<xxx>, pos=<yyy>)
LOADマクロのエラーが発生しました。

<nnn>(10進数)

LOADマクロのリターンコード

<mmm>(10進数)

LOADマクロの理由コード（保守情報）

<name>(文字列)

ロードモジュール名

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ250E TSO SC=40
A NAME/TOKEN delete error occurred. (return code=<nnn>, name= <name>, cmd=<xxx>, pos=<yyy>)
NAME/TOKENのdeleteエラーが発生したため，実行できません。

<nnn>(10進数)

NAME/TOKEN登録ルーチン（IEANTCR）のリターンコード

<name>(文字列)

NAME/TOKENサービスに登録する名称

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ251E TSO SC=32 (<pair-index>)
DASD device <device-number-1>(<device-number-2>) management error, <message-text>. (<code1> <code2>, cmd=<xxx>, pos=<yyy>)
要求された処理を実行できませんでした。このデバイスをスキップして処理を続行します。
エラーとなったデバイスの状態を確認し，構成や実行条件に誤りがある場合は訂正して，再実行してください。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

操作対象デバイスのデバイス番号が見つからない場合，****が表示されます。

<message-text>(文字列)

メッセージテキスト

<code1>(16進数)

サブコマンドコード

<code2>(16進数)

エラーコード（保守情報）

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

<pair-index>

コピーグループ番号，コピーペア番号

YKZ252E TSO SC=8
DASD device <device-number-1>(<device-number-2>) management error, <message-text>. (<code1> <code2>, cmd=<xxx>, pos=<yyy>)
要求された処理を実行できませんでした。このデバイスをスキップして処理を続行します。
エラーとなったデバイスの状態を確認して，構成や実行条件に誤りがある場合は訂正して，再実行してください。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

<message-text>(文字列)

メッセージテキスト

<code1>(16進数)

サブコマンドコード

<code2>(16進数)

エラーコード（保守情報）

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ253E TSO SC=32 (<pair-index>)
DASD device <device-number-1>(<device-number-2>) I/O error. (CC=<code1> CSW=<code2> <code3> <code4> <code5>, cmd=<xxx>, pos=<yyy>).
I/Oエラーが発生しました。このデバイスをスキップして処理を続行します。
センスバイトが設定されている場合は，YKZ255Eメッセージにセンスバイトが表示されます。

CC=3の場合

該当する装置が実装されていないか，または接続されていないおそれがあります。

CC=0でCSW=<xxxxxx>0000<xxxx> (DSB=00，CSB=00)の場合

該当する装置が実装されていないか，または接続されていないおそれがあります。

CC=0でCSW=00000000060000の場合

MIHが発生，または論理パスが接続されていないおそれがあります。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

操作対象デバイスのデバイス番号が見つからない場合，****が表示されます。

<code1>(10進数)

CC情報

<code2>(16進数)

CSW情報

<code3>(16進数)

サブコマンドコード

<code4>(16進数)

完了コード

<code5>(16進数)

詳細コード

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

<pair-index>

コピーグループ番号，コピーペア番号

YKZ254E TSO SC=8
DASD device <device-number-1>(<device-number-2>) I/O error. (CC=<code1> CSW=<code2> <code3> <code4> <code5>, cmd=<xxx>, pos=<yyy>).
I/Oエラーが発生しました。このデバイスをサポートしていないおそれがあります。このデバイスをスキップして処理を続行します。
センスバイトが設定されている場合は，YKZ256Eメッセージにセンスバイトが表示されます。

CC=3の場合

該当する装置が実装されていないか，または接続されていないおそれがあります。

CC=0でCSW=<xxxxxx>0000<xxxx> (DSB=00，CSB=00)の場合

該当する装置が実装されていないか，または接続されていないおそれがあります。

CC=0でCSW=00000000060000の場合

MIHが発生，または論理パスが接続されていないおそれがあります。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

<code1>(10進数)

CC情報

<code2>(16進数)

CSW情報

<code3>(16進数)

サブコマンドコード

<code4>(16進数)

完了コード

<code5>(16進数)

詳細コード

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ255E TSO SC=32 (<pair-index>)
DASD device <device-number-1>(<device-number-2>) sense: <diagnostic-information> (cmd=<xxx>, pos=<yyy>)
I/Oエラーの詳細情報が表示されます。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

操作対象デバイスのデバイス番号が見つからない場合，****が表示されます。

<diagnostic-information>(16進数)

センスバイト情報（保守情報）

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

<pair-index>

コピーグループ番号，コピーペア番号

YKZ256E TSO SC=8
DASD device <device-number-1>(<device-number-2>) sense: <diagnostic-information> (cmd=<xxx>, pos=<yyy>)
I/Oエラーの詳細情報が表示されます。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

<diagnostic-information>(16進数)

センスバイト情報（保守情報）

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ257E TSO SC=32 (<pair-index>)
DASD device <device-number-1>(<device-number-2>) management error. (Message type: <code1> Reason code: <code2> Error code: <code3> <code4>, cmd=<xxx>, pos=<yyy>)
要求された処理を実行できませんでした。このデバイスをスキップして処理を続行します。
エラーとなったデバイスの状態を確認して，構成や実行条件に誤りがある場合は訂正してから再実行してください。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

操作対象デバイスのデバイス番号が見つからない場合，****が表示されます。

<code1>(16進数)

メッセージタイプ

<code2>(16進数)

理由コード

<code3>(16進数)

エラーコード（保守情報）

<code4>(16進数)

サブコマンドコード

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

<pair-index>

コピーグループ番号，コピーペア番号

YKZ258E TSO SC=8
DASD device <device-number-1>(<device-number-2>) management error. (Message type: <code1> Reason code: <code2> Error code: <code3> <code4>, cmd=<xxx>, pos=<yyy>)
要求された処理を実行できませんでした。このデバイスをサポートしていないおそれがあります。このデバイスをスキップして処理を続行します。
エラーとなったデバイスの状態を確認して，構成や実行条件に誤りがある場合は訂正して再実行してください。

<device-number-1>(文字列)

I/O発行デバイス

<device-number-2>(文字列)

操作対象デバイス

<code1>(16進数)

メッセージタイプ

<code2>(16進数)

理由コード

<code3>(16進数)

エラーコード（保守情報）

<code4>(16進数)

サブコマンドコード

<xxx>(10進数)

エラーが発生した時に実行していたコマンドのコマンドコード

YKZ201Eメッセージのコマンドコードの説明を参照してください。

<yyy>(文字列)

保守情報

YKZ300E TSO SC=44 RC=44
SVC # is null or invalid.
ユーザSVCが登録されていません。または，IEASYM<xx> parmlibメンバの&YKSVCNOシステム・シンボルの指定値に誤りがあります。

ユーザSVCをSVCPARMに定義している場合

IEASYM<xx> parmlibメンバの&YKSVCNOシステム・シンボルの指定値を見直してください。

ユーザSVCをSVCPARMに定義していない場合

YKALCSVCコマンドを使用してユーザSVCを登録してください。

ユーザSVCの登録については，「2.3.4 ユーザSVCの登録」を参照してください。

YKZ301E CON RC=128
The task is not authorized to execute the request.
Mainframe Agent，またはYKP2Aコマンドを実行する権限がありません。このメッセージが出力された場合，Mainframe AgentはHitachi Command Suite製品側にストレージ情報を送りません。このメッセージが出力されたあと，SYSLOGにYKY680Iメッセージが出力された場合，YKY680IメッセージにMainframe Agentが実行したYKP2Aコマンド以外のコマンドのエラー情報が表示されます。
Mainframe Agent，またはYKP2Aコマンドの実行権限を設定する方法の詳細は，「3.2.2 リソース・アクセス管理機能（RACF）の環境設定」を参照してください。

YKZ330E TSO RC=64
<command> detected the <rexx-service> service error. (return code=<r>[, reason code=<n>])
REXXサービスでエラーを検出しました。

<command>

発行されたCLIコマンド名

<rexx-service>

エラーを検出したREXXサービス名

<r> (10進数)

REXXサービスのリターンコード

詳細は，マニュアル「TSO/E REXX解説書」を参照してください。

<n> (10進数)

REXXサービスの理由コード

詳細は，マニュアル「TSO/E REXX解説書」を参照してください。

YKZ331E TSO RC=64
<command> terminated with an invalid return code. (<r>)
CLIコマンドは不当なリターンコードで終了しました。

<command>

発行されたCLIコマンド名

<r>

CLIコマンドが生成したリターンコード

YKZ332E TSO RC=64
<command> detected the system abend during <rexx-service> processing. (<info>)
REXXサービス処理中にシステム異常終了を検出しました。

<command>

発行されたCLIコマンド名

<rexx-service>

システム異常終了を検出したREXXサービス名

<info>

保守情報

YKZ333E TSO RC=64
<command> detected the user abend during <rexx-service> processing. (<info>)
REXXサービス処理中にユーザー異常終了を検出しました。

<command>

発行されたCLIコマンド名

<rexx-service>

ユーザー異常終了を検出したREXXサービス名

<info>

保守情報

YKZ340T TSO RC=48
Supplied parameters invalid.
無効なパラメーターが指定されました。

YKZ341E TSO RC=48
No DEVN() supplied.
DEVNパラメーターが指定されていません。

YKZ343E TSO RC=48
DEVN() value invalid.
DEVNパラメーターに指定された値に誤りがあります。

YKZ370E TSO SC=32 RC=32
A dynamic configuration change was detected during specified command processing. DEVN <device#>
コマンド処理中に動的I/O構成定義変更を検知しました。
コマンドが対象とするデバイスの状態を確認し，構成や実行条件に誤りがある場合は訂正して，再実行してください。

<device#>

動的I/O構成定義変更を検知した時点での処理対象のデバイス番号

5.4 ユーザー完了コード

ユーザー完了コードの詳細を次の表に示します。

表5-1 ユーザー完了コード

完了コード
説明

U0128
Mainframe Agentを実行する権限がありません。
理由コードがある場合，次に示す形式で表示されます。
XXYYZZZZ

XX：RACROUTEマクロのSAF RCの下位1バイト

YY：RACROUTEマクロのRACF RCの下位1バイト

ZZZZ：RACROUTEマクロのRACF Reason Codeの下位2バイト

理由コードの内容
RACROUTE REQUEST=AUTHマクロのリターン情報が表示されます。詳細は，マニュアル「Security Server RACROUTE マクロ解説書」を参照してください。

U1008
Mainframe Agentでは実行できないモジュールを呼び出そうとしました。LINKLIBライブラリの設定に誤りがあるおそれがあります。
LINKLIBライブラリには，Mainframe Agentのインストール先データセットを設定してください。

6. トラブルシューティング

この章では，Mainframe Agentのトラブルシューティングについて説明します。

この章の構成

6.1 ログの採取

6.2 Mainframe Agentが起動できない場合の対策

6.3 Mainframe Agentからの情報が更新されない場合の対策

6.1 ログの採取

Mainframe Agentは，TCP/IP経由でDevice Managerと接続し，ストレージ情報の受け渡しをします。

Mainframe Agentの動作時に回線エラーやMainframe Agentの障害が発生した場合，エラー情報がDevice Managerのログに出力されます。しかし，Device Managerから要求が出された時点でエラーが検出されるため，障害発生と同時にエラー情報が出力されるとは限りません。

また，Mainframe Agentがストレージ情報を取得する際にエラーが発生した場合，取得しようとしたストレージ情報およびエラー情報のどちらもDevice Managerの画面に表示されません。このような場合は，採取しているログの内容を確認してください。

Mainframe Agentがログに出力する情報を次の表に示します。

表6-1 ログに出力される情報

ログ出力の契機
出力される情報
出力先

TCPコネクションの確立要求の受信時
YKY300I，YKY307Iメッセージに次の情報が出力されます。

コネクション受信時のメッセージ出力時刻

リモートホストのIPアドレス

リモートホストのポート番号

自ホストのポート番号

SYSLOG

TCPコネクションの正常解放時
YKY301Iメッセージに次の情報が出力されます。

コネクション切断時のメッセージ出力時刻

受付要求の破棄時
YKY304Iメッセージに次の情報が出力されます。

要求を破棄した時のメッセージ出力時刻

破棄理由

情報取得時のエラー検出時
YKY680Iメッセージに次の情報が出力されます。

コマンド実行時のメッセージ出力時刻

コマンド名

コマンドのリターンコード

TCPコネクションの強制解放時
YKY305Iメッセージに次の情報が出力されます。

切断理由

コンソール

通信処理中のエラー検出時
YKY315Iメッセージに次の情報が出力されます。

TCP/IP通信時の要求名

応答コードと事象コード

自IPアドレス：自ポート番号

接続先IPアドレス：接続先ポート番号

応答待ち時間を過ぎても応答がない時
YKY321Iメッセージが出力されます。

IBM Communications Serverのソケットインターフェース要求でのエラー検出時
YKY330Iメッセージに次の情報が出力されます。

要求種別

要求種別に対するリターンコードとエラー番号

マニュアル「Communications Server IP アプリケーション・プログラミング・インターフェース・ガイド」を参照してください。

Mainframe Agentが受信したデータのサイズ不正時
YKY362Iメッセージに次の情報が出力されます。

接続先IPアドレスと接続先ポート番号

Mainframe Agent処理中のタスクの異常終了時
YKY699Iメッセージに次の情報が出力されます。

タスク異常終了時のシステム完了コード

タスク異常終了時のユーザー完了コード
0007：サブタスクのATTACH失敗
0007以外：Mainframe Agentの内部処理要因

タスク異常終了時の日付と時刻

異常終了時の情報（レジスターの内容，モジュール情報，PSW，命令の長さ，割り込みコード）

Mainframe Agentの起動用カタログドプロシジャJCLのSYSABEND DD文（標準はSYSOUT=*指定）にメモリーダンプが出力されます。
SYSABENDデータセット

相手Hitachi Command Suite製品からの要求データの不正時
YKY703E～YKY719Eメッセージが出力されます。
Hitachi Command Suite製品の画面，またはエラーログファイル

6.2 Mainframe Agentが起動できない場合の対策

Mainframe Agentが起動できない場合の現象と対策を次の表に示します。表の上から順に，発生している現象が当てはまるかどうか判断し，最初に当てはまった現象に対する対策を実施してください。

表6-2 Mainframe Agentが起動できない場合の現象と対策

現象 | 対策
Mainframe Agentがシステム完了コード(878)で異常終了する。 | Mainframe Agentのリージョンサイズを見直してからMainframe Agentを再実行してください。
IEC130Iメッセージが出力される。 | メッセージ中に出力されるDD文が正しく指定されているか見直してからMainframe Agentを再実行してください。
起動直後にIKJEFT01がリターンコード12で終了する。 | STEPLIB DD文が正しく指定されているか見直してからMainframe Agentを再実行してください。
YKY019I YKPARM DD STATEMENT NOT FOUNDメッセージが出力される。 | YKPARM DD文が正しく定義されているか見直してからMainframe Agentを再実行してください。
Mainframe Agentがシステム完了コード(013)で異常終了する。 | IEC141Iメッセージが出力される。 | DD文が正しく定義されているか見直してからMainframe Agentを再実行してください。
IEC141Iメッセージが出力されない。 | 出力されているメッセージに対応した処理をしてください。
Mainframe Agentがシステム完了コード(001)で異常終了する。 | IEC020Iメッセージが出力される。 | DD文が正しく定義されているか見直してからMainframe Agentを再実行してください。
IEC020Iメッセージが出力されない。 | 出力されているメッセージに対応した処理をしてください。
YKY604I IRXJCL MODULE ERROR,CODE=20メッセージが出力される。 | SYSEXEC DD文がない。 | SYSEXEC DD文を正しく指定してからMainframe Agentを再実行してください。
SYSEXEC DD文がある。 | REXX実行環境またはREXX代替ライブラリ環境の設定が正しく設定されているかシステム管理者に確認してください。
Mainframe Agentを起動するとリターンコード(00)で即時終了する。 | EXEC文のPARMオペランドにYKAGENTDが指定されているか確認してからMainframe Agentを再実行してください。
初期設定パラメーターの解析でエラーが表示される。 | 表示されているエラーメッセージに対応した処理をしてください。
TCP/IPの設定でエラーが表示される。 | 表示されているメッセージに対応した処理をしてください。
上記以外のメッセージが表示される。 | 表示されているメッセージに対応した処理をしてください。
Mainframe Agentがリターンコード(00)以外で終了する。 | リターンコードに対応した処理をしてください。

6.3 Mainframe Agentからの情報が更新されない場合の対策

Hitachi Command Suite製品側で情報を取得しても，Mainframe Agentからの情報が更新されない場合の現象と対策を次の表に示します。表の上から順に，発生している現象が当てはまるかどうか判断し，最初に当てはまった現象に対する対策を実施してください。

表6-3 Mainframe Agentからの情報が更新されない場合の現象と対策

現象 | 対策
YKY330I SOCKET API FAILURE (OPEN,BIND,-0000001,0000048)メッセージが出力される。 | 指定したポート番号が使用中です。そのポート番号を使用中のプログラムを停止するか，初期設定パラメーターのポート番号を修正してからMainframe Agentを再実行してください。
YKY330I SOCKET API FAILURE (INIT,INITAPI,-0000001,0000156)メッセージが出力される。 | RACFで保護されています。RACFの設定を見直してからMainframe Agentを再実行してください。
YKY330I SOCKET API FAILURE (OPEN,BIND,-0000001,0000013)メッセージが出力される。 | RACFで保護されています。RACFの設定を見直してからMainframe Agentを再実行してください。
Mainframe Agentがシステム完了コード(Fnn)で異常終了している。(Fnn：SVC番号） | ユーザSVCが登録されているか確認してからMainframe Agentを再実行してください。
コンソール，またはSYSLOGにエラーメッセージが表示される。 | 表示されるメッセージに対応した処理をしてください。

付録A. コマンドの記載形式

コマンドの文法説明で使用する記号および構文要素について説明します。

この付録の構成

A.1 コマンドの文法説明で使用する記号

A.2 コマンドの構文要素

A.1 コマンドの文法説明で使用する記号

コマンドの文法説明で使用する記号を表A-1に示します。

表A-1 コマンドの文法説明で使用する記号

フォントの例または記号
意味

｜（ストローク）
複数の項目に対し，項目間の区切りを示し，「または」の意味を示します。
例
「A｜B｜C」は，「A，B，またはC」を示します。

［　］
この記号で囲まれている項目は任意に指定できます(省略してもよい)。
複数の項目が記述されている場合には，すべてを省略するか，どれか一つを選択します。
例
［A］は「何も指定しない」か「Aを指定する」ことを示します。

斜体
斜体で表記している項目は，値を任意に指定する項目を示します。

<<　>>
項目を省略したときにシステムがとる仮定値を示します。

((　))
指定できる値の範囲を示します。

△
一つの空白があることを示します。

△ｎ
n個以上の空白が必要であることを示します。

～
この記号の直前に示されている項目を，この記号に続く< >中の文法規則に従って記述しなければならないことを示します。

＜ ＞
各項目を記述するときに従わなくてはならない構文要素を示します。

A.2 コマンドの構文要素

コマンドの構文要素を表A-2に示します。

表A-2 コマンドの構文要素

構文要素 | 指定できる文字の内容 | 例
数字 | 0｜1｜2｜3｜4｜5｜6｜7｜8｜9 | －
英大文字 | A｜B｜C｜D｜E｜F｜G｜H｜I｜J｜K｜L｜M｜N｜O｜P｜Q｜R｜S｜T｜U｜V｜W｜X｜Y｜Z｜$｜#｜@ | －
英字 | A｜B｜C｜D｜E｜F｜G｜H｜I｜J｜K｜L｜M｜N｜O｜P｜Q｜R｜S｜T｜U｜V｜W｜X｜Y｜Z｜a｜b｜c｜d｜e｜f｜g｜h｜i｜j｜k｜l｜m｜n｜o｜p｜q｜r｜s｜t｜u｜v｜w｜x｜y｜z｜$｜#｜@ | －
英数字 | 英字，数字，または英字と数字の集合 | A123
16進数 | 0｜1｜2｜3｜4｜5｜6｜7｜8｜9｜A｜B｜C｜D｜E｜F | －
PREFIX文字列 | ピリオドで結合される一つまたは複数の部分で構成される文字列。各部分の文字列は，英大文字，数字から成ります。ただし，各部分の先頭文字は英大文字です。各部分の長さは，1文字から8文字です。 | ABC.D12
DAD文字列 | ピリオドで結合される一つまたは複数の部分で構成される文字列。各部分の文字列は，英大文字，数字，または特殊文字（$，#，@）から成ります。ただし，各部分の先頭文字は，英大文字または特殊文字です。各部分の長さは，1文字から8文字です。 | A1234.$B
コピーグループ名文字列 | ピリオドで結合される一つまたは複数の部分で構成される文字列。各部分の文字列は，英大文字，数字，または特殊文字（$，#，@）から成ります。ただし，各部分の先頭文字は，英大文字または特殊文字です。 | @A123

用語解説

このマニュアルで使用する用語について説明します。

（英字）

AddHostRefreshコマンド

Device ManagerのGUI上に表示されるメインフレームストレージ情報を更新する，Device Managerのコマンドです。

AddHostコマンド

メインフレームホストをDevice Managerに登録する，Device Managerのコマンドです。

AddURLLinkコマンド

Mainframe AgentをDevice Managerに登録する，Device Managerのコマンドです。

C/Tグループ

グループ内のボリュームへの更新順序の整合性が保たれるグループです。

CANCELコマンド

Mainframe Agentを強制停止させるオペレーターコマンドです。

Configurationファイル

コピーグループ定義ファイル，およびディスク構成定義ファイルの総称です。

DAD

デバイス番号が同じ体系のサイトを表します。同一サイトで複数ホストの場合，デバイス番号体系が同じなら同じ名称となります。

DADID

Mainframe AgentがDADを識別するためのIDです。

DeleteHostコマンド

Device Managerに登録されているメインフレームホストを削除する，Device Managerのコマンドです。

DeleteURLLinkコマンド

Device Managerに登録されているMainframe Agentの登録情報を削除する，Device Managerのコマンドです。

Device Manager

ストレージ管理の基盤となるプログラムです。ストレージの運用および管理機能を統合できます。

DEVN

メインフレームでストレージボリュームを管理するために使用されるデバイス番号です。

GetURLLinkコマンド

Device Managerに登録されているMainframe Agentの登録情報を取得する，Device Managerのコマンドです。

Hitachi Business Continuity Manager

複数のデータセンターが連携する，信頼性の高いバックアップシステムを構築するためのプログラムです。ストレージシステムのコピー機能を使用して，災害時にも業務を継続できるようにします。また，災害時の復旧時間およびデータ損失を最小限に抑えることができます。

Hitachi Command Suite製品

ストレージシステムの構築・運用・監視を支援するプログラム群です。

JES起動プロシジャ

JES（Job Entry Subsystem）を起動するカタログドプロシジャです。

ModifyHostコマンド

Device Managerに登録されているメインフレームホストの情報を変更する，Device Managerのコマンドです。

PPRC

IBMのバックアッププロダクトです。ホストを経由しないで同期コピーを行います。

RACF

IBMのセキュリティー管理プロダクトです。

REXX

IBMが開発した構造化プログラミング言語の一種です。主にIBMのメインフレームOS上で用いられており，アプリケーションやOSの機能を呼び出すマクロ言語として使用されます。

REXX代替ライブラリ

IBM Library for REXX on zSeries Release 4（FMID HWJ9140）またはIBM Library for REXX on zSeries Alternate Library（FMID HWJ9143）のどちらのライブラリもない場合に使用する代替ライブラリです。

SETINITコマンド

Mainframe Agentの初期設定パラメーターを設定するコマンドです。MODIFYコマンドで指定すると，ログの出力レベルを動的に変更できます。

SI

ストレージシステム内でボリュームを複製し複製状態を維持する機能です。

STARTコマンド

Mainframe Agentを起動するオペレーターコマンドです。

STOPコマンド

Mainframe Agentを正常終了させるオペレーターコマンドです。

TC

ストレージシステム間でボリュームのリモートコピーを作成・管理する機能です。コピーペアのS-VOLへの書き込みはP-VOLと同期して実行されます。

TCA

ストレージシステム間でボリュームのリモートコピーを作成・管理する機能です。コピーペアのS-VOLへの書き込みはP-VOLと非同期に実行されます。

VOLSER

メインフレームでストレージボリュームを管理するために使用されるボリューム通し番号です。

YKAGALLOジョブ

Mainframe Agentの組み込み前に必要なデータセットを割り当てるジョブです。

YKAGENTD

Mainframe Agentの実行プログラムです。標準提供される，Mainframe Agentの起動用カタログドプロシジャの名称でもあります。

YKAGINSTジョブ

Mainframe Agentをインストールするジョブです。

YKALCSVCコマンド

Mainframe Agentの実行に必要なユーザSVCを動的に登録するコマンドです。OSのSTARTコマンドによって起動されます。

YKP2Aコマンド

PPRCコピーペアを監視するために使用するConfigurationファイルを生成するコマンドです。

YKPRM00

Mainframe Agentの実行に必要な初期設定パラメーターを登録するメンバです。

（カ行）

起動用カタログドプロシジャ

Mainframe Agentの起動時に使用されるカタログドプロシジャです。SAMPLIBデータセットで標準提供されます。

コピーグループ

ユーザーが同一操作で扱う複数のペアボリューム群です。

コピーペア状態

コピーペアとなっているP-VOLとS-VOLの状態のことです。

（例）SIMPLEX，DUPLEX，SUSPOP，PENDING

（サ行）

サスペンド状態

操作サスペンド状態（SUSPOP），CU動作によるサスペンド状態（SUSPCU），または障害サスペンド状態（SUSPER）のことです。

初期設定パラメーター

Mainframe Agentの起動時に，Mainframe Agentの環境を設定するためのパラメーターです。ポート番号，受信待ち時間，ホスト識別名，状態を監視するPPRCコピーグループの情報（Configurationファイルのプレフィックス，およびプライマリサイトのDADID），情報収集の対象とするデバイス番号の範囲，およびログの出力レベルを設定できます。

ストレージシステムのシリアル番号

SANRISE9900VシリーズおよびHitachi USPでは，ストレージシステムごとに割り当てられた番号（物理DKC製番）のことです。Universal Storage Platform V/VMおよびVirtual Storage Platformでは，論理DKCごとに割り当てられた番号（論理DKC製番）のことです。

セカンダリサイト

2DC構成時のリカバリ用ホストとストレージシステムを含むサイトで，バックアップ時のコピー先となります。災害時にプライマリホストと同時に停止してしまうことを防ぐためには，プライマリホストと数百～数千km離すことが必要です。

（ハ行）

プライマリサイト

プライマリホストとプライマリストレージシステムの総称，またはこれらが属する場所のことです。通常業務を運用しているサイトで，バックアップ時のコピー元となります。

ホスト識別名

複数のメインフレームホストのボリューム情報を取得する場合にメインフレームを識別するために指定する名称です。Mainframe AgentのHOSTNAME初期設定パラメーターで指定します。

（ラ行）

ログレベル

Mainframe Agent動作時にシステムログ（SYSLOG）に出力される通信実行経過メッセージ，およびストレージ情報取得時のエラーメッセージの出力を制御するレベルです。Mainframe AgentのLOGLEVEL初期設定パラメーターで指定します。

索引

[A][C][D][E][G][H][I][J][K][L][M][P][R][S][T][V][Y]
[い][う][か][き][こ][さ][し][す][せ][そ][て][と][は][ひ][ふ][ほ][め][ゆ][よ][ら][り][ろ]

(A)

AddHostRefreshコマンド

AddHostコマンド

AddHostコマンド実行時の注意事項

AddURLLinkコマンド

AddURLLinkコマンド実行時の注意事項

(C)

C/Tグループ

CacheDisableディレクティブ

CANCELコマンド〔形式〕

CANCELコマンド〔用語解説〕

CGNAME1（YKP2Aコマンド）

CGNAME2（YKP2Aコマンド）

CGNAME3（YKP2Aコマンド）

Configurationファイル

Configurationファイルの生成例

Configurationファイルを生成できるコピー種別と生成単位

(D)

DAD

DAD（YKP2Aコマンド）

DADID

DeleteHostコマンド

DeleteURLLinkコマンド

Device Manager

Device Managerでメインフレーム系ストレージ情報を取得する運用

Device Managerでメインフレーム系ストレージ情報を取得する運用の概要

Device Managerと接続する場合〔初期設定パラメーター〕

Device Managerと接続する場合の構成例

Device Managerの環境設定

Device Managerのバージョンアップ時期の確認〔バージョンアップ〕

DEVN（YKP2Aコマンド）

DEVN〔形式〕

DEVN〔用語解説〕

DEVNパラメーター指定時の注意

(E)

EXEC文〔YKAGENTD〕

(G)

GetURLLinkコマンド

(H)

Hitachi Business Continuity Manager

Hitachi Command Suite製品

HOSTNAME

HOSTNAMEパラメーター指定時の注意

(I)

IBM HTTP Serverの設定

IEASVCxx parmlibメンバでの登録

IPv6接続するための設定〔IBM HTTP Server〕

IPv6接続するときにhttpd.confファイルに設定する内容

IPv6接続する場合の構成例

(J)

JES起動プロシジャ

JES起動プロシジャ〔用語解説〕

(K)

KeepAliveディレクティブ

(L)

Listenディレクティブ

LoadModuleディレクティブ

LOGLEVEL

(M)

Mainframe Agentが起動できない場合の対策

Mainframe Agentからの情報が更新されない場合の対策

Mainframe Agent導入時の運用手順

Mainframe Agentの起動

Mainframe Agentの強制終了

Mainframe Agentの正常終了

Mainframe Agentのバージョンアップ

Mainframe Agent構成変更時の運用手順

Mainframe Agentの登録情報の削除〔Device Manager〕

Mainframe Agentの登録情報の取得〔Device Manager〕

Mainframe Agentの登録情報の変更〔Device Manager〕

Mainframe AgentをDevice Managerに登録する

ModifyHostコマンド

(P)

PORT

PPRC

PPRC SIコピーペアだけを監視する構成例

PPRC TCおよびSIコピーペアを監視する構成例

PPRC TCおよびTCAコピーペアを監視する構成例

PREFIX

PREFIX（YKP2Aコマンド）

PREFIXパラメーター指定時の注意

PROC文〔YKAGENTD〕

PROFILE.TCPIPプロファイル

ProxyPassReverseディレクティブ

ProxyPassディレクティブ

(R)

RACF

RECVWAITTIME

Replication ManagerでPPRCコピーペアを監視する運用

Replication ManagerでPPRCコピーペアを監視する運用の概要

Replication ManagerでPPRCコピーペアを監視するための運用手順

Replication Managerと接続する場合〔初期設定パラメーター〕

Replication Managerと接続する場合の構成例

Replication Managerの環境設定

REXX

REXX代替ライブラリ

REXX代替ライブラリのインストール

(S)

SETINITコマンド〔形式〕

SETINITコマンド〔用語解説〕

SETINITコマンドの使用方法

SI

STARTコマンド〔形式〕

STARTコマンド〔用語解説〕

STEPLIB DD文〔YKAGENTD〕

STOPコマンド〔形式〕

STOPコマンド〔用語解説〕

SYSABEND DD文〔YKAGENTD〕

SYSEXEC DD文〔YKAGENTD〕

SYSTSIN DD文〔YKAGENTD〕

SYSTSPRT DD文〔YKAGENTD〕

(T)

TC

TCA

TCP/IPのポート番号の設定

Timeoutディレクティブ

(V)

VOLSER

(Y)

YKAGALLOジョブ

YKAGENTD〔展開形〕

YKAGENTD〔用語解説〕

YKAGINSTジョブ

YKALCSVCコマンド

YKALCSVCコマンドでの登録

YKALCSVCコマンドの形式

YKALCSVCコマンドの利用設定

YKLIST DD文〔YKAGENTD〕

YKP2Aコマンド

YKP2Aコマンド〔用語解説〕

YKP2Aコマンドの利用設定

YKPARM DD文〔YKAGENTD〕

YKPRM00

(い)

インストール

インストールCD-ROMに格納されているデータセットの一覧

インストール手順

インストールの概要

インストールの流れ

インストール前の確認

(う)

運用

運用コマンド

(か)

カタログドプロシジャライブラリの連結解除〔バージョンアップ〕

環境設定

(き)

起動用カタログドプロシジャ

起動用カタログドプロシジャの作成

起動用カタログドプロシジャの変更

行の継続方法

(こ)

構成変更時の運用手順

コピーグループ

コピーグループ定義生成機能の前提条件

コピーペア状態

コマンドの記載形式

コマンドの構文要素

コマンドの文法説明で使用する記号

コメントの書き方

(さ)

サスペンド状態

サポートするPPRCコマンド

(し)

システム構成例

受信待ち時間

使用例〔CANCELコマンド〕

使用例〔STARTコマンド〕

使用例〔STOPコマンド〕

初期設定パラメーター

初期設定パラメーター作成時の注意事項

初期設定パラメーターの解析結果例

初期設定パラメーターの作成

初期設定パラメーターの指定例

初期設定パラメーターの詳細

(す)

ストレージシステムのシリアル番号

(せ)

セカンダリサイト

セキュリティーの設定

前提OS

前提機器

前提条件

前提ハードウェア

前提プログラム

(そ)

ソフトウェアの設定項目

(て)

提供されるデータセット

データセットセキュリティーの設定

データセットのバックアップ〔バージョンアップ〕

(と)

導入時の運用手順

導入の目的

トラブルシューティング

トレースログの採取

(は)

バージョンアップ後の確認

バージョンアップ時の注意事項

バージョンアップ手順

バージョンアップ前の確認

バージョンアップ前の作業

パラメーターの複数指定

(ひ)

標準の起動用カタログドプロシジャ

標準の起動用カタログドプロシジャの展開形

(ふ)

プライマリサイト

(ほ)

ポート番号

ホスト識別名

ホスト識別名〔用語解説〕

(め)

メインフレームのストレージ情報の更新〔Device Manager〕

メインフレームのストレージ情報を取得する〔Device Manager〕

メインフレームホスト情報の取得〔Device Manager〕

メインフレームホスト情報の変更〔Device Manager〕

メインフレームホストの削除〔Device Manager〕

メインフレームホストをDevice Managerに登録する

メモリー所要量

(ゆ)

ユーザSVCの確認〔バージョンアップ〕

ユーザSVCの削除〔バージョンアップ〕

ユーザSVCの登録

(よ)

用語解説

(ら)

ライブラリデータセットのストレージ属性

(り)

リソース・アクセス管理機能（RACF）の環境設定

リターンコード〔STOPコマンド〕

(ろ)

ロードライブラリの連結解除〔バージョンアップ〕

ログに出力される情報

ログの採取

ログの出力レベルの表示

ログの出力レベルの変更

ログレベル