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

Acquiring mainframe host information
To acquire information about a mainframe host registered in the Device Manager server (such as the
host name), use the GetHost command.
Note: If you do not know the object ID of a mainframe host, use the following procedure to acquire
the object ID.
1. Execute the GetHost command with no object ID specified to acquire a list of hosts registered
in Device Manager.
2. In the displayed host information, find the name of the mainframe host you are looking for.
3. Acquire the object ID based on the information related to the mainframe host you found in step
2.
Example of executing the command:
hdvmcli GetHost -o "D:\logs\GetHost.log" "objectid=*****"
*****: The value is encoded by the CLI.
Example of output from executing the command:
RESPONSE:
An instance of Host
objectID=*****
name=toro2
hostID=1
capacityInKB=0
hostType=2
managedBy=2
sysplexID=RSDPLEX
statusOfDBUpdating=-1
*****: The value is encoded by the CLI.
Changing mainframe host information
To change the information of a mainframe host registered in the Device Manager server, use the
ModifyHost command. You can change the name of a mainframe host by specifying the new host
name in the hostname parameter.
Note: When you change the host name, specify the host name that was set in the initialization
parameter for XP7 mainframe agent. If you specify a host name that differs from the host name set
during XP7 mainframe agent environment setup, you cannot acquire information from XP7 mainframe
agent.
Note: The ModifyHost command cannot be used to modify the hostType parameter information.
To modify the hostType parameter information, use the DeleteHost command to delete the target
mainframe host, and then re-register the mainframe host.
Example of executing the command:
Installation and Configuration Guide 49