HP XP7 Command View Advanced Edition Mainframe Agent Installation and Configuration Guide (TK981-96005, May 2014)

HOSTNAME('host-identification-name') ~ <1 to 50 alphanumeric characters> <<value
specified for the &SYSNAME system symbol>>
Specify this parameter when Device Manager or Replication Manager needs to identify the XP7
mainframe agent. When the XP7 mainframe agent is running on more than one host, and a
HOSTNAME (host identification name) value is duplicated in these hosts, Device Manager or
Replication Manager cannot identify the host on which the target XP7 mainframe agent is running.
To ensure that Device Manager or Replication Manager can identify the host on which the XP7
mainframe agent is running, specify a unique HOSTNAME value for each host.
When this parameter is omitted, the value of the &SYSNAME system symbol is assumed. For details
about the &SYSNAME system symbol, refer to the MVS Initialization and Tuning Reference.
When the XP7 mainframe agent runs on more than one host and an &SYSNAME system symbol
value is duplicated in these hosts, Device Manager or Replication Manager cannot distinguish
between the hosts. When the &SYSNAME system symbol value is duplicated, make sure that
HOSTNAME values are unique among the hosts.
Notes about Specifying the HOSTNAME Parameter:
When you specify the host name for reporting to Device Manager, do not specify the name of a
host that is already being managed by Device Manager (including external connection ports that
are being managed by Device Manager as hosts). To ensure that you do not specify such a host
name, use one of the following methods:
• Ensure that DNS can resolve the host name you specify.
• If a host name that DNS can resolve is identical to a host name already managed by Device
Manager, set the host identification name of the mainframe host for the HOSTNAME parameter,
and then set the same host identification name in Device Manager.
• If neither of the above methods allows you to set a unique host name, change the host name
of the host managed by Device Manager.
• If none of the above three methods allows you to set a unique host name, you can specify
any host name.
PREFIX('prefix','local-site's-DAD-ID')
To collect XP7 mainframe agent information from Replication Manager, specify the prefix of the
configuration file created by the YKP2A command. For details about the YKP2A command, see
“YKP2A command” on page 61.
You can specify multiple PREFIX parameters. Specify multiple PREFIX parameters when the
storage information to be acquired is information registered in multiple configuration files that
have different prefixes, in an environment where Replication Manager and the XP7 mainframe
agent are one-to-one.
prefix ~ <PREFIX string consisting of 1 to 16 characters>
Specifies the file name prefix of the XP7 mainframe agent configuration files that are used by
Replication Manager. The disk configuration definition file with the prefix specified here, the
volume information defined in the copy group definition file, and the copy group are provided
to Replication Manager.
local-site's-DAD-ID ~ <DAD string consisting of 1 to 28 characters>
Specify the device address domain ID of the primary site specified for the DAD parameter of the
YKP2A command.
Notes about Specifying the PREFIX Parameter
• Do not specify a nonexistent prefix or device address domain ID in the PREFIX parameter.
Even though specifying a nonexistent prefix or device address domain ID does not result in
an error during XP7 mainframe agent startup, an error will occur during a Replication Manager
request.
Installation and Configuration Guide 35