ovconfchg man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

ovconfchg()							   ovconfchg()

NAME
       ovconfchg - manipulates settings files, updates the configuration data‐
       base, and triggers notification scripts

SYNOPSIS
       ovconfchg -h | -help

       ovconfchg -version

       ovconfchg [-ovrg <OVRG>] [-edit |  -job	{-ns  namespace	 {-set	<attr>
       <value> | -clear <attr> | -clear -all} ... } ... ]

DESCRIPTION
       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.

       ovconfchg manipulates the settings in either the system-wide configura‐
       tion file or the configuration  file  for  the  specified  OV  Resource
       Group,  local_settings.ini,  updates  the  configuration database, set‐
       tings.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.

       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.

       Parameters

       ovconfchg recognizes the following options:

       -h | -help

	      Displays all the options for the ovconfchg command.

       -version

	      Displays the version of the ovconfchg command.

       -ovrg  <OVRG>

	      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.

       -edit

	      Starts  a	 text  editor  to  edit	 the settings file, local_set‐
	      tings.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 val‐
	      idation is successful, the changes are saved into	 the  original
	      settings file.

	      Do  not configure binary values using this option. This can cor‐
	      rupt 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.

       -job

	      Create an update job file only and do not synchronize.

       -ns | -namespace <namespace>

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

       -set <attr> <value>

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

       -clear <attr>

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

       -clear -all

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

AUTHOR
       ovconfchg was developed by Hewlett-Packard Company.

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

       ·  <DataDir>/conf/xpl/config/local_settings.ini

       ·  <ShareDir>/<OVRG>/conf/xpl/config/local_settings.ini

       The  ovconfchg  command uses the following files to store database con‐
       figuration settings:

       ·  <DataDir>/datafiles/xpl/config/settings.dat

       ·  <ShareDir>/<OVRG>/datafiles/xpl/settings.dat

EXAMPLES
       The following examples show how to use the ovconfchg command:

       ·  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"

       ·  To clear the attribute COUNT in the namespace tst.lib:

	  ovconfchg -ns tst.lib -clear COUNT

       ·  To  remove  all  locally  configured	attributes  from the namespace
	  tst.lib:

	  ovconfchg -ns tst.lib -clear '*'

       ·  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

SEE ALSO
       ovconfget

								   ovconfchg()
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net