REGISTRY/REG User Commands
NAME
reg - Configuration Utility
ALIASES
REGISTRY, REG
SYNOPSIS
reg [KEY] [= VALUE]
reg [KEY]
reg [OPTIONS] [SEARCH]
reg [OPTIONS]
DESCRIPTION
Configuration settings are maintained using a database of Name-Value pairs.
This is referred to as the Registry. Registry Keys can be created for just
about any purpose. There is a set of built-in Registry Keys that have
specific roles in the configuration of the JNIOR.
Querying a Registry Key or Keys
reg KEY
The command REG KEY displays the current VALUE of the key if any has been
assigned. The KEY parameter may use the '*' and '?' wildcards. Therefore
the command REG * dumps all assigned Registry Keys.
Setting a Registry Key
reg KEY = VALUE
The REG KEY = VALUE command sets the Registry Key to the VALUE. Registry
entries contain string values even when numeric settings are required.
If VALUE contains a space it must be enclosed in double-quotes. When
entering a KEY striking the TAB key immediately after the equals '='
will pre-fill the line with the existing VALUE. This may be useful when
an entry simply needs to be edited.
Deleting a Registry KEY
reg KEY =
Assigning a blank VALUE to a Registry Key removes it from the system. The
operating system or an application may then choose to use a default VALUE
for the setting.
Options
-D KEY
The KEY parameter may specify a single KEY or use wildcard characters
such as '*' and '?' to select a group of keys. Each deletion must be
confirmed.
-A
This option overrides the deletion confirmation. This is the same as
confirming a deletion with [A]ll and all operations will complete
without prompting.
-E
The SEARCH parameter contains Regular Expression (REGEX) syntax.
-M
Displays the last modification timestamp for each Key. This is in the
form [YYMMDDHHMM] and can be useful in determining when a setting may
have been made.
-X
When listing Keys using a wildcard this option will include unassigned
known system keys also matching the SEARCH. The command REG -X *
not only displays all assigned keys but also those system keys that
are defaulted.
-B
Displays keys formatted as another command. This output may be
redirected to a BAT batch file and later executed to restore
settings.
-F FILE
Exports keys matching SEARCH to the specified file in INI format.
If SEARCH is omitted the entire Registry is exported with the
exception of the IpConfig section. This allows the file to be
moved to another JNIOR and when ingested not damage that unit's
network configuration.
-I FILE
Import (or ingest) the FILE. This file must be in INI format. If the
FILE is a JAR file then any included AppInfo.INI file is ingested.
This is the same as Registering the application. Note that this
creates the keys defined in FILE but does not remove those that are
not.
-U FILE
Uninstall the FILE. This file must be in INI format. All keys referenced
in the INI file are removed (deleted) from the Registry. If a JAR file
is specified then the keys referenced by the included AppInfo.INI file
are removed. This is equivalent to de-registering the application. Use
the option VERY carefully.
-S
Generate Registry Snapshot. The saves the entire Registry to a file
located in the /flash/registry folder. The file name is in the format
jnior_YYYYMMDDHHMM.ini and this contains all entries including the
IpConfig section. This creates a backup save point for the Registry.
NOTES
Registry Keys are not case-sensitive although when they are defined
character case is retained to improve readability.
The TAB key has a specific utility on the Command Line. It is of particular
use in working with the Registry.
The /flash/jnior.ini file should not be edited or overwritten. This is
a backup for the Registry and is not referenced unless the Registry has
been damaged. Use -I to import Registry content and -F to export content
for updating other JNIORs.
Registry changes are logged to the jniorsys.log file.
SEE ALSO
HELP Topics:
TAB,
BATCH,
INI
[/flash/manpages/manpages.hlp:2698]