Maintenance Commands regconfig(1m)
NAME
regconfig - adds, sets, deletes or queries Registry key
information.
SYNOPSIS
regconfig [ -I instance ] [ -v | -d ] keyname
regconfig [ -I instance ] [ -b | -s | -v | -d ] keyname valuename
regconfig [ -I instance ] [ -a ] keyname [ classname | valuename
type value ]
regconfig [ -I instance ] keyname valuename type value
regconfig [ -I instance ] keyname valuename REG_MULTI_SZ
string1 [ string2 ... ]
DESCRIPTION
This command is used to add, query or set the value and/or
the type of data item stored as a value entry in a key, or
to obtain detailed information about a Registry key. With
the option "-d", keys and value entries can be deleted.
OPTIONS
-I instance
Specifies the PCNL instance name or number. In a multi-
instance environment instance may be specified either on the
command line or by the environment variable PCNL_INSTANCE.
If there is only one instance configured, it is not neces-
sary to specify this argument.
-b
Displays a data item in binary format.
-s
Displays a data item in string format.
-v
Displays key information in detail.
-a
adds the key or value entry. It can be also used to modify
existing value.
"regconfig -a " adds the key which
belongs to the class .
"regconfig -a adds or
modifies the value entry for of the type
under the key .
-d
Deletes the key or value entry.
"regconfig -d " deletes the key ,
"regconfig -d " deletes the value entry for
under the key .
Identifies the key by name on the local machine.
The name of a class to be assigned to a key being added.
The name of the data item being stored as a value entry.
Identifies the type of value. Valid options are REG_SZ
(string), REG_DWORD (32-bit numeric value), REG_EXPAND_SZ
(string), and REG_MULTI_SZ (multiple strings) and must be
specified in uppercase.
The value to be assigned to the data item stored as a value
entry.
Do not set value entries of type REG_BINARY with this com-
mand.
"/" or "\" can be used as seperators, but if "/" is in the
key, "\" has to be used as seperator. Keys cannot contain
"\".
"regconfig -a "
must have a valid existing key .
"regconfig -a " only adds one key at a
time. This means must consist of a path of an
existing parent key and its immedate subkey to be added. The
command will report an error if the parent key does not
exist.
"regconfig -d " can only delete empty keys. The
command will report an error if still contains
subkeys, so you first have to delete the subkeys.
EXAMPLES
To obtain information about a key, type the following com-
mand:
regconfig -v
To display the value of a data item stored as a value entry
in a key, type the following command:
regconfig [ -b | -s | -v ]
To store a data item as a value entry in a key, type the
following command:
regconfig
To display information about the
System/CurrentControlSet/Services/Replicator/Parameters key,
type the following command:
regconfig
System/CurrentControlSet/Services/Replicator/Parameters
or
regconfig System\\CurrentControlSet\\Services\\Replicator\\Parameters
NOTES
Some values changed by this command will not take effect
immediately. PC NetLink should be restarted after changing a
value with this command. For lookup purposes, the keynames
are case-insensitive.