Some VM host names (or VM host Cluster names) are generated by the Orchestrate system and can therefore receive generic, arbitrary names such as host2_demoAdapter, host3_demoAdapter, and so on. VM hosts you name at creation time might also change later in their purpose or facilities.
As the quantity of these VM host objects grows in your grid, you might find it helpful or necessary to rename them, assigning more meaningful, intuitive names to suit the purpose of the object. The object’s “display name” is visible in the Development Client interface, the VM Client interface, the Server Portal, and in optional zos and zosadmin commands.
NOTE:Resource object groups (that is, the folders that contain these VM host objects) can also be renamed. Objects such as jobs, events, and users cannot be renamed.
A VM host object’s name is stored in the ${objectType}.displayname fact, which exists on every Grid object type, even those objects that cannot be renamed.
You can rename a VM host object (or a VM host Cluster object) in the Orchestrate Development Client using one of three methods:
Right-click the VM host object in the Explorer tree, then select Rename to allow editing of the display name.
Triple-click the VM host object in the Explorer tree to allow editing of the display name.
In the page, where you can select the VM host object .displayname fact and then open the Fact Editor to enter a new value for that fact.
As you begin to rename using one of these methods, you will notice that the fact value is pre-populated with the ${objectType}.id fact. This functions as the name value for the object name until you decide to change it.
NOTE:Even after being renamed, the VM host object retains its associated resource ID in the .id fact. This is not editable.
For more information about making the Resource object display names visible from the zos or zosadmin command line, see the PlateSpin Orchestrate 2.5 Command Line Reference.