Update the host name of an instance

The updwashost script updates an instance if the host name of the server is changed.

Authority

To run this script, your user profile must have *ALLOBJ authority.

Usage

To create a new instance with the crtwasinst script, follow these steps:

On the CL command line, enter the STRQSH (Start Qshell) command.

Run the cd command to change to the directory that contains the script:

cd /QIBM/ProdData/WebASE51/ASE/bin

Run the updwashost script:>

updwashost -instance instance

where instance is the name of the instance that you want to update.

Syntax

The syntax of the script is:

updwashost -instance instance [ -newhost new_host ]
  [ -changenode -oldhost old_host ] [ -regenplugin ] [ -verbose ] [ -help ]

Parameters

The parameters of the script are:

-instance
This is a required parameter. The value instance specifies the name of the instance that you want to update. To update the host name for all instances, specify ALL.

-newhost
This is an optional parameter. The value new_host specifies the new host name to use for the instance. 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 instance. If you specify this parameter, the -oldhost parameter is required.

-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 instance(s). 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 script after updating the host for the instance(s) to regenerate the HTTP server plugin configuration.

-verbose
This optional parameter turns on verbose messages, which can be helpful if debug the script.

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