(iseries)

updwashost command

The updwashost script updates a profile if the host name of the server is changed.

To run this script, the 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 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 we specify this parameter, the script changes the node name in the profile. If we specify this parameter, the -oldhost parameter is required.

If the node of the profile node is federated into a deployment manager, IBM recommends that you not include this parameter, as it might break references to the node name.

-oldhost

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 we need to debug the script.

-help

This optional parameter displays the help message. If we specify this parameter, the script ignores all other parameters.

Related tasks

Use command-line tools