Network Deployment (Distributed operating systems), v8.0 > Reference > Commands (wsadmin scripting)
Utility command group of the AdminTask object
Use the Jython or Jacl scripting languages to manage servers with wsadmin.sh. The commands and parameters in the Utility group can be used to change the host name of a node, to query for the name of the dmgr, and to determine if the system is a single server or network deployment.
The Utility command group includes the following commands:
changeHostName
Use the changeHostName command to change the host name of a node.
Target object
None
Parameters and return values
-hostName
The new host name. (String, required)
-nodeName
The name of the node whose host name will be changed. (String, required)
Optional parameters:
-systemName
The name of the z/OS system on which this node will run. This field is only required if a node is to be moved from one system to another, for example, form system SYSA to system SYSB. If you are not sure of the value you should specify for this parameter, issue the IPLINFO command on your z/OS system, and use the name that displays in the Sysname= field as the value for this parameter. When you run the changeHostName command interactively, the systemName parameter appears, but is only to be used for a z/OS system. The systemName parameter represents the z/OS system name that is defined in the server.xml file as a value for property, was.ConfiguredSystemName. When the systemName parameter is selected, this property is changed.
-regenDefaultCert
A request to regenerate default certificates. The only valid value for this parameter is "true" to regenerate default certificates. Any other value assumes to NOT regenerate default certificates. The string argument is processed as a boolean. The boolean returned represents the value true if the string argument is not null and is equal, ignoring case, to the string "true". The regenDefaultCert parameter operates like AdminTask.createChainedCertificate and has the following default values:
- -keyStoreName "NodeDefaultKeyStore"
- -keyStoreScope "(node):" + nodeName
- -certificateAlias" "default_" + hostName
- -certificateCommonName" nodeName
- -certificateOrganization" "IBM"
- -certificateOrganizationalUnit" nodeName
- -certificateCountry "US"
Examples
Batch example...:
### Jacl
$AdminTask changeHostName {-hostName host_name -nodeName node_name -systemName system_name}### Jython string
AdminTask.changeHostName('-hostName host_name -nodeName node_name -systemName system_name')
Jython list:
AdminTask.changeHostName(['-hostName', 'host_name', '-nodeName', 'node_name', '-systemName', 'system_name'])
Interactive example...
### Jacl
$AdminTask changeHostName {-interactive}### Jython string
AdminTask.changeHostName ('[-interactive]')
Jython list:
AdminTask.changeHostName (['-interactive'])
getDmgrProperties
Use the getDmgrProperties command to return the name of the dmgr.
Target object
None
Parameters and return values
- Parameters: None
- Returns: The name of the dmgr in a network deployment system. Returns an empty string if the system is a single server.
Examples
Batch example...:
### Jacl
$AdminTask getDmgrProperties {}### Jython
AdminTask.getDmgrProperties()
Interactive example...
### Jacl
$AdminTask getDmgrProperties {-interactive}### Jython string
AdminTask.getDmgrProperties ('[-interactive]')
Jython list:
AdminTask.getDmgrProperties (['-interactive'])
isFederated
Use the isFederated command to check if the system is a single server or network deployment.
Target object
None
Parameters and return values
- Parameters: None
- Returns: Boolean. true if the system is a network deployment system. Otherwise it returns false.
Examples
Batch example...:
### Jacl
$AdminTask isFederated {}
Jython string: AdminTask.isFederated ()
Interactive example...
### Jacl
$AdminTask isFederated {-interactive}### Jython string
AdminTask.isFederated ('[-interactive]')
Jython list:
AdminTask.isFederated (['-interactive'])
Use the wsadmin scripting AdminTask object for scripted administration
Related
Commands using wsadmin.sh
PersonalCertificateCommands command group