The updwashost script updates a profile
if the host name of the server is changed.
To run this script, your user profile must have *ALLOBJ authority.
Syntax
The command syntax is as follows:
updwashost -profileName profile [-newhost new_host]
[-changenode -oldhost old_host] [-regenplugin] [-verbose] [-help]
Parameters
The following options are available
for the updwashost command:
- -profileName
- This is a required parameter. The value profile specifies
the name of the profile that you want to update. To update the host
name for all profiles, specify ALL.
- -newhost
- This is an optional parameter. The value new_host specifies
the new host name to use for the profile. The default value is the
current host name of the server.
- -changenode
- This is an optional parameter. If you specify this parameter,
the script changes the node name in the profile. If you specify this
parameter, the -oldhost parameter is required.
If the node of the
profile node is federated into a deployment manager, it is recommended
that you not include this parameter, as it might break references
to the node name.
- -oldhost
- This parameter is required if the -changenode parameter is specified,
and not valid otherwise. The value specifies the old host name to
use when changing the node name for the profile. The value specified
will be replaced in the node name with the value specified in the
-newhost parameter.
- -regenplugin
- This optional parameter calls the GenPluginCfg command
after updating the host for the profile to regenerate the HTTP server
plug-in configuration.
- -verbose
- This optional parameter turns on verbose messages, which can be
helpful if you need to debug the script.
- -help
- This optional parameter displays the help message. If you specify
this parameter, the script ignores all other parameters.