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

Registering the mainframe host in Device Manager
To use the AddHost command to register the mainframe host in Device Manager:
1. Execute the AddHost command to register the mainframe host in Device Manager.
When you execute the command, specify the following parameters:
• hostname: In this parameter, specify the host name of the mainframe host (the value you
specified for the parameter in “Parameters” on page 34).
• hostType: In this parameter, specify 2.
2. From the execution result of the AddHost command, make sure that specified information is
correctly output to the name and hostType parameters.
Notes on executing the AddHost command:
• If the host name specified during mainframe host environment setup and the host name specified
during Device Manager environment setup do not match, information registered in XP7 mainframe
agent cannot be acquired.
• Do not specify the wwnlist parameter when registering the mainframe host in Device Manager.
If you do, an error occurs.
• Record the objectID value output when the AddHost command is executed. You will need this
value for the subsequent procedures and operations.
• Although the IP address specified in the ipaddress parameter of a command is registered as
an attribute of the mainframe host, the IP address registered using the AddHost command is not
used for communication with XP7 mainframe agent. The information necessary for communication
with XP7 mainframe agent is specified in “Registering the XP7 mainframe agent running on the
mainframe host in Device Manager” on page 44.
Action to be taken if an error occurs during the execution of the AddHost command:
Use the GetHost command to check whether the mainframe host has been registered. If the
mainframe host has not been registered, register it by using the AddHost command. If the
mainframe host has been registered incorrectly, use the ModifyHost command to correct the
registered information. For details about how to correct the registered mainframe host information,
see “Changing mainframe host information” on page 49.
Command format:
hdvmcli AddHost "hostname=mainframe-host-name" "hostType=2"
Example of executing the command:
hdvmcli AddHost -o "D:\logs\AddHost.log" "hostname=toro2" "hostType=2"
Example of output from executing the command:
RESPONSE:
An instance of Host
objectID=*****
name=toro2
hostID=1
Installation and Configuration Guide 43