iicvtwintcp Command--Convert wintcp to tcp_ip Protocol Setting
The iicvtwintcp command converts vnode definitions and GCx server protocol settings in config.dat from the deprecated wintcp network protocol to the newer tcp_ip protocol. This utility runs automatically during an upgrade, but can also be run standalone.
A backup file is created (or appended to) that can be used in subsequent iicvtwintcp commands to restore converted protocol entries to their previous settings.
Note: Dynamic vnodes are not affected by this utility.
The iicvtwintcp command has the following format:
iicvtwintcp [-help] [-verbose] [-noupdate] [-force]
[-action convert_wintcp | convert_tcp_ip | restore]
[-bf filename] [-nf filename]
[-scope all | vnodes | config]
-help
Displays command usage information.
-verbose
Displays each record affected. If not specified, only totals are displayed.
-noupdate
Reports what the impact of running the utility will be, but does not update Name Server or backup files.
If the Name Server is running, the –force parameter must also be used.
When used with the -verbose parameter, produces a report from which the vnode updates can be done manually from one of the Actian X network configuration utilities.
-force
Runs iicvtwintcp even if the Name Server or another instance of the program is currently running. A warning message is issued. This parameter is useful with the -noupdate parameter or when running against a copy of the Name Server node file.
Note: Use this parameter with caution.
-action
Specifies the action to be performed:
convert_wintcp
Converts wintcp to tcp_ip.
convert_tcp_ip
Converts tcp_ip to wintcp.
restore
Restores converted protocol entries back to prior values.
Note: If no action is specified, displays usage, which prevents unintentional conversion if command with no parameters is entered.
-bf
Specifies the name of the restore (back off) file. If not specified, the default is:
%II_SYSTEM%\ingres\files\name\IINODE_hostname.BK
Can be specified with or without path name. If no path is specified, defaults to %II_SYSTEM%\ingres\files\name.
Note: Written to as output if -action is convert_wintcp or convert_tcp_ip. Read from as input if -action is restore, and is required for a successful restore operation.
-nf
Specifies the name of the Name Server connection (NODE) file that contains the vnode definitions that will be updated. If not specified, the default is:
%II_SYSTEM%\ingres\files\name\IINODE_hostname
Can be specified with or without path name. If no path is specified, defaults to %II_SYSTEM%\ingres\files\name.
-scope
Converts or restores the following entities:
all
(Default) Vnode definitions and config.dat file
vnodes
Vnode definitions only
config
Config.dat file only
Return codes:
>=0
Indicates the program succeeded, where return code is the number of records modified.
-1
Indicates the program failed.
iicvtwintcp Examples
In these examples of the iicvtwintcp command, the command should be run while the Name Server (iigcn) is stopped.
1. Convert wintcp to tcp_ip in current installation:
iicvtwintcp -action convert_wintcp
2. Restore records converted to tcp_ip back to wintcp:
iicvtwintcp -action restore
3. Convert tcp_ip to wintcp in current installation.
This example is similar to Example 2 except that all tcp_ip records will be set to wintcp, not just the ones that were originally converted by -action convert_wintcp. Such a command is likely to be used if a restore is wanted but the backup file is lost.
iicvtwintcp -action convert_tcp_ip
4. List connection (NODE) information for all vnodes:
iicvtwintcp -action convert_wintcp -noupdate –verbose