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 will call 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.