.\"Generated by nroff_template.wdt (12-Sep-06). Do NOT edit this output file. Instead, edit the source FM+SGML file.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH ovconfchg "" "" ""
.ds )H Hewlett-Packard Company
.ds ]L
.ds ]W June 2007
.SH NAME
ovconfchg - manipulates settings files, updates the configuration database, and triggers notification scripts
.SH "SYNOPSIS"

.PP
ovconfchg -h | -help 

.PP
ovconfchg -version 

.PP
ovconfchg [-ovrg <\fIOVRG\fR>] [-edit | -job {-ns \fInamespace\fR {-set <\fIattr\fR> <\fIvalue\fR> | -clear <\fIattr\fR> | -clear -all} ... } ... ] 

.SH "DESCRIPTION"

.LP
Installed OpenView components have associated configuration settings files that contain one or more namespaces. A namespace is a group of configuration settings that belong to a component.

.LP
ovconfchg manipulates the settings in either the system-wide configuration file or the configuration file for the specified OV Resource Group, local_settings.ini, updates the configuration database, settings.dat, and triggers notification scripts. If ovconfchg is called without options, or only with -ovrg, no settings are changed but an update is triggered anyway. This is to allow updating after default settings files have been added, removed, or updated.

.LP
When ovconfchg runs, all configuration settings are read and merged in memory. Default definitions are used to make corresponding checks, as well as to emit and log warnings in the event of a violation. During this process, file locks are used to prevent parallel updates. A new configuration database is then created containing the merged data.

.Sh "Parameters"

.LP
ovconfchg recognizes the following options:

.TP
-h | -help

Displays all the options for the ovconfchg command.

.TP
-version

Displays the version of the ovconfchg command.

.TP
-ovrg \fI <OVRG\fR>

If the parameter you want to change belongs to an OpenView resource group, use -ovrg to specify the name of the resource group. Otherwise, system-wide settings files are opened.

.TP
-edit

Starts a text editor to edit the settings file, local_settings.ini. The text editor used is determined by the $EDITOR environment variable. If $EDITOR is not set, vi starts on UNIX and Notepad starts on Windows.

A temporary copy of the file is created for editing. After the changes are made, the file is validated for syntax errors. The syntax rule for validation is that the namespace and attribute names should contain only letters (a-z, A-Z), digits (0-9), period(.) and underscore(_) characters.

If the validation fails, the line number of the error is reported and the user will be prompted to correct the file. If Yes, the file will be reopened for making the necessary changes. If No, the original settings file remains unchanged. If the validation is successful, the changes are saved into the original settings file.

Do not configure binary values using this option. This can corrupt the file. It is also recommended to restrict the data entered using this option to US-ASCII (7-bit only) subset.

Do not open the settings file directly in a text editor and change it. This can corrupt the file.

.TP
-job

Create an update job file only and do not synchronize.

.TP
-ns | -namespace\fI <namespace\fR>

Sets a namespace for the -set and -clear options.

.TP
-set \fI<attr\fR> <\fIvalue\fR>

Sets an attribute value in the namespace specified by the -namespace option. The local or OV resource settings file is updated accordingly.

.TP
-clear <\fIattr\fR>

Clears the local setting for the attribute \fIattr\fR in the namespace specified by the -namespace option. The local settings file is updated accordingly.

.TP
-clear -all

Clears all local settings. The local settings file is updated accordingly.

.SH "AUTHOR"

.LP
ovconfchg was developed by Hewlett-Packard Company.

.SH "FILES"

.LP
The ovconfchg command uses the following files to store local settings:

.TP 3
\(bu 
<\fIDataDir\fR>/conf/xpl/config/local_settings.ini

.TP
\(bu 
<\fIShareDir\fR>/<\fIOVRG\fR>/conf/xpl/config/local_settings.ini
.LP

.LP
The ovconfchg command uses the following files to store database configuration settings:

.TP 3
\(bu 
<\fIDataDir\fR>/datafiles/xpl/config/settings.dat

.TP
\(bu 
<\fIShareDir\fR>/<\fIOVRG\fR>/datafiles/xpl/settings.dat
.LP

.SH "EXAMPLES"

.LP
The following examples show how to use the ovconfchg command:

.TP 3
\(bu 
To assign the value 12 to the attribute COUNT, and assign the value "red blue white" to the attribute COLORS in the namespace, tst.lib:

ovconfchg -ns tst.lib -set COUNT 12 -set COLORS "red blue white"

.TP
\(bu 
To clear the attribute COUNT in the namespace tst.lib:

ovconfchg -ns tst.lib -clear COUNT

.TP
\(bu 
To remove all locally configured attributes from the namespace tst.lib:

ovconfchg -ns tst.lib -clear '*'

.TP
\(bu 
For the OpenView resource group server, assign the value 50 to the attribute COUNT in the namespace tst.lib:

ovconfchg -ovrg server -ns tst.lib -set COUNT 50
.LP

.SH "SEE ALSO"

.LP
ovconfget