![Content starts here](http://welcome.hp-ww.com/img/s.gif) |
OpenVMS System Management Utilities Reference Manual
Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC specify
only where the utility will find or place its database.
/SOURCE=device-name:[directory-name]
Specifies the disk and directory where the utility searches for the
software product kit or kits. If /SOURCE is not specified, the utility
searches in the location defined by the logical name PCSI$SOURCE. If
PCSI$SOURCE is not defined, and the /SOURCE qualifier is not specified,
the POLYCENTER Software Installation utility searches the current default directory.
/SPAN_VERSIONS=keyword([,...])
Selects software products whose versions match the specified version
criteria. The keywords are:
ABOVE=version
|
Selects versions greater than the version specified
|
|
|
BELOW=version
|
Selects versions less than the version specified
|
|
|
MINIMUM=version
|
Selects versions greater than or equal to the version specified
|
|
|
MAXIMUM=version
|
Selects versions less than or equal to the version specified
|
The ABOVE, BELOW, MINIMUM, and MAXIMUM keywords can be used alone or in
combination. For example,
/SPAN_VERSIONS=(MINIMUM=V2.1,BELOW=V3.0)
selects versions greater than or equal to V2.1 and less than (but not
including) V3.0. Using the MAXIMUM keyword instead of BELOW would
select versions that include V3.0.
/TRACE
/NOTRACE (default)
Displays all DCL commands that the POLYCENTER Software Installation
utility may execute while performing the operation. Any output
generated by these commands is also displayed. This qualifier is a
debugging aid to trace the execution of DCL commands and command
procedures executed in a subprocess.
/VERSION=version-number
Selects software products that have the specified version.
/WORK=device:[directory]
Specifies the name of the device and directory acting as a temporary
work area. By default, temporary files are created in subdirectories of
the user's login directory.
Example
|
$ DEFINE PCSI$SOURCE DKA500:[DWMOTIF.KIT]
$ PRODUCT RECONFIGURE DWMOTIF /VERSION=V1.2-3
|
The command in this example enters into a dialog with the user to
change the configuration options for the product DECwindows Motif
Version 1.2-3.
REGISTER PRODUCT
Records information in the product database about one or more installed
products that are not yet registered in the database.
You can use this command to add information to the product database
about products that have been installed by a mechanism other than the
POLYCENTER Software Installation utility, such as VMSINSTAL. Either a
special transition or a full product kit must be in the source
directory to supply details about the product being registered. The
PRODUCT REGISTER PRODUCT command only updates the product database; it
does not copy any files to your system.
If you do not have a kit available to provide detailed information
about a product, you can use the command procedure
SYS$UPDATE:PCSI$REGISTER_PRODUCT.COM to register the name of the
product and its version, producer, and base system in the product
database. After you register a product using the command procedure,
other products can reference it, and the PRODUCT SHOW PRODUCT command
displays it as an installed product.
Format
PRODUCT REGISTER PRODUCT product-name[,...] [/qualifiers]
Parameter
product-name
Names the product, or list of products, to register.
Qualifiers
/BASE_SYSTEM=base-system-name
Selects software products whose base system matches the one specified.
The base system name identifies both a hardware platform and an
operating system. The base system name AXPVMS denotes an OpenVMS Alpha
product, VAXVMS denotes an OpenVMS VAX product, and VMS denotes a
product applicable to either OpenVMS Alpha or VAX.
/DESTINATION=device-name:[directory-name]
Specifies the location where the installed product resides. If you omit
the device name, the utility uses your current default device. If you
omit the directory name, the utility uses the [VMS$COMMON] directory as
the default directory.
If you do not use this qualifier to specify a destination, the utility
uses the location defined by logical name PCSI$DESTINATION. If this
logical name is not defined, the utility uses the location
SYS$SYSDEVICE:[VMS$COMMON], the top-level directory.
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT=
format-type
|
Designates the format of the product kit as follows:
|
|
REFERENCE
|
Reference format in which product files exist in a directory tree.
|
|
|
SEQUENTIAL
|
Sequential format in which product files are placed in
<full-product-name>.PCSI, a container file.
|
|
|
|
TYPE=
kit-type
|
Specifies the type of product kit as follows:
|
|
FULL
|
Layered product (application) software.
|
|
|
OPERATING_SYSTEM
|
Operating system software.
|
|
|
MANDATORY_UPDATE
|
A required correction to currently installed software. Functionally,
this type of kit is the same as a patch kit.
|
|
|
PARTIAL
|
An upgrade to currently installed software. Installation of this kit
changes the version of the product.
|
|
|
PATCH
|
A correction to currently installed software. Installation of this kit
does not change the version of the product.
|
|
|
PLATFORM
|
An integrated set of software products (also called a product suite).
|
|
|
TRANSITION
|
Used to register information about a product that is installed but not
recorded in the product database (for example, a product installed by
VMSINSTAL). This kit does not provide product material.
|
|
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility performs the operation.
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces.
/REMARK=string
Records a comment in the product database about the task you are
performing. The SHOW HISTORY command displays the recorded comments.
For each product, the POLYCENTER Software Installation utility stores a chronological list of
tasks you perform and the associated remarks. The default behavior is
that no remark is recorded.
/REMOTE
/NOREMOTE (default)
Uses the product database on a system other than the currently running
system. This qualifier is primarily for use in command procedures that
Compaq supplies. Incorrect use of this qualifier can corrupt the
POLYCENTER Software Installation utility database, corrupt installed products, or cause other
problems. In some cases, /REMOTE can be useful with the CONFIGURE and
SHOW commands.
When you use /REMOTE, the following logical names must be defined:
- PCSI$SYSDEVICE must specify the physical disk name of the target
system disk. This disk must be mounted and allocated to the process
executing the PRODUCT command.
- PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE. It
must be defined in the following form, where x is a valid
system root:
Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC specify
only where the utility will find or place its database. These logical
names do not affect the /DESTINATION qualifier.
/SOURCE=device-name:[directory-name]
Specifies the disk and directory where the utility searches for the
software product kit or kits. If /SOURCE is not specified, the utility
searches in the location defined by the logical name PCSI$SOURCE. If
PCSI$SOURCE is not defined, and the /SOURCE qualifier is not specified,
the POLYCENTER Software Installation utility searches the current default directory.
/SPAN_VERSIONS=keyword([,...])
Selects software products whose versions match the specified version
criteria. The keywords are:
ABOVE=version
|
Selects versions greater than the version specified
|
|
|
BELOW=version
|
Selects versions less than the version specified
|
|
|
MINIMUM=version
|
Selects versions greater than or equal to the version specified
|
|
|
MAXIMUM=version
|
Selects versions less than or equal to the version specified
|
The ABOVE, BELOW, MINIMUM, and MAXIMUM keywords can be used alone or in
combination. For example,
/SPAN_VERSIONS=(MINIMUM=V2.1,BELOW=V3.0)
selects versions greater than or equal to V2.1 and less than (but not
including) V3.0. Using the MAXIMUM keyword instead of BELOW would
select versions that include V3.0.
/VERSION=version-number
Selects software products that have the specified version.
Example
|
$ PRODUCT REGISTER PRODUCT TOOLCHEST /SOURCE=DKB500:[TOOLCHEST.KIT]
|
The command in this example registers the product TOOLCHEST in the
product database. TOOLCHEST was installed by VMSINSTAL, and a special
transition kit is in the source directory to supply details about the
product.
REGISTER VOLUME
For a volume containing installed products, records a change in volume
label in the product database. This command also records a change in
the physical or logical device name.
Format
PRODUCT REGISTER VOLUME old-volume-label device-name [/qualifiers]
Parameters
old-volume-label
Names the old (existing) volume label.
device-name
Names the device for which the volume label is to be changed in the
product database.
Qualifiers
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility performs the operation.
/REMOTE
/NOREMOTE (default)
Uses the product database on a system other than the currently running
system. This qualifier is primarily for use in command procedures that
Compaq supplies. Incorrect use of this qualifier can corrupt the
POLYCENTER Software Installation utility database, corrupt installed products, or cause other
problems. In some cases, /REMOTE can be useful with the CONFIGURE and
SHOW commands.
When you use /REMOTE, the following logical names must be defined:
- PCSI$SYSDEVICE must specify the physical disk name of the target
system disk. This disk must be mounted and allocated to the process
executing the PRODUCT command.
- PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE. It
must be defined in the following form, where x is a valid
system root:
Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC specify
only where the utility will find or place its database.
Example
|
$ PRODUCT REGISTER VOLUME AXPVMSV62 DKA0:
|
The command in this example replaces all occurrences of the old volume
label in the POLYCENTER Software Installation utility database with the current volume label of
the specified disk.
REMOVE
Uninstalls one or more software products from your system and updates
the product database.
Format
PRODUCT REMOVE product-name[,...] [/qualifiers]
Parameter
product-name
Names the installed product or list of installed products to remove.
Qualifiers
/BASE_SYSTEM=base-system-name
Selects software products whose base system matches the one specified.
The base system name identifies both a hardware platform and an
operating system. The base system name AXPVMS denotes an OpenVMS Alpha
product, VAXVMS denotes an OpenVMS VAX product, and VMS denotes a
product applicable to either OpenVMS Alpha or VAX.
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility performs the operation.
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces.
/REMARK=string
Records a comment in the product database about the task you are
performing. The SHOW HISTORY command displays the recorded comments.
For each product, the POLYCENTER Software Installation utility stores a chronological list of
tasks you perform and the associated remarks. The default behavior is
that no remark is recorded.
/REMOTE
/NOREMOTE (default)
Uses the product database on a system other than the currently running
system. This qualifier is primarily for use in command procedures that
Compaq supplies. Incorrect use of this qualifier can corrupt the
POLYCENTER Software Installation utility database, corrupt installed products, or cause other
problems. In some cases, /REMOTE can be useful with the CONFIGURE and
SHOW commands.
When you use /REMOTE, the following logical names must be defined:
- PCSI$SYSDEVICE must specify the physical disk name of the target
system disk. This disk must be mounted and allocated to the process
executing the PRODUCT command.
- PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE. It
must be defined in the following form, where x is a valid
system root:
Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC specify
only where the utility will find or place its database.
/TRACE
/NOTRACE (default)
Displays all DCL commands that the POLYCENTER Software Installation
utility may execute while performing the operation. Any output
generated by these commands is also displayed. This qualifier is a
debugging aid to trace the execution of DCL commands and command
procedures executed in a subprocess.
/VERSION=version-number
Selects software products that have the specified version.
/WORK=device:[directory]
Specifies the name of the device and directory acting as a temporary
work area. By default, temporary files are created in subdirectories of
the the user's login directory.
Example
The command in this example uninstalls the product named FTAM and
updates the product database to remove all information about the
product.
SHOW HISTORY
Displays a chronological log of operations performed on the specified
products.
Format
PRODUCT SHOW HISTORY product-name[,...] [/qualifiers]
Parameter
product-name
Names the product or list of products to include in the display. This
is an optional parameter. If you omit it, operations performed on all
products will be shown.
Qualifiers
/BASE_SYSTEM=(base-system-name[,...])
Selects software products whose base system matches the one specified.
The base system name identifies both a hardware platform and an
operating system. The base system name AXPVMS denotes an OpenVMS Alpha
product, VAXVMS denotes an OpenVMS VAX product, and VMS denotes a
product applicable to either OpenVMS Alpha or VAX.
Parentheses (()) are optional only when you specify a single base
system name. They are required when you specify multiple base system
names.
/BEFORE=time
Selects entries that were created before the specified date and time.
You can specify time as an absolute time, as a combination of absolute
and delta times, or as one of the following keywords:
TODAY (default)
TOMORROW
YESTERDAY
Refer to the OpenVMS User's Manual for information about specifying time values.
/FULL
/NOFULL (default)
Displays information in 132-column format. The /NOFULL qualifier
displays a subset of available information in 80-column format.
/OPERATION=(keyword[,...])
Specifies one or more of the following operations as the value for
keyword:
INSTALL
RECONFIGURE
REGISTER_PRODUCT
REGISTER_VOLUME
REMOVE
Parentheses (()) are optional only when you specify a single keyword.
They are required when you specify multiple keywords.
/PRODUCER=(producer-name[,...])
Selects software products that the specified manufacturer produces.
Parentheses (()) are optional only when you specify a single producer
name. They are required when you specify multiple producer names.
/REMOTE
/NOREMOTE (default)
Uses the product database on a system other than the currently running
system. This qualifier is primarily for use in command procedures that
Compaq supplies. Incorrect use of this qualifier can corrupt the
POLYCENTER Software Installation utility database, corrupt installed products, or cause other
problems. In some cases, /REMOTE can be useful with the CONFIGURE and
SHOW commands.
When you use /REMOTE, the following logical names must be defined:
- PCSI$SYSDEVICE must specify the physical disk name of the target
system disk. This disk must be mounted and allocated to the process
executing the PRODUCT command.
- PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE. It
must be defined in the following form, where x is a valid
system root:
Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC specify
only where the utility will find or place its database. These logical
names do not affect the /DESTINATION.
/SINCE=time
Selects records that were created on or after the specified date and
time. You can specify time as an absolute time, as a combination of
absolute and delta times, or as one of the following keywords:
TODAY (default)
YESTERDAY
Refer to the OpenVMS User's Manual for information about specifying time values.
/USER=(username[,...])
Displays information about the products installed, configured, or
removed by the specified user.
Parentheses (()) are optional only when you specify a single user name.
They are required when you specify multiple user names.
/VERSION=(version-number[,...])
Selects software products that have the specified version.
Parentheses (()) are optional only when you specify one version number.
They are required when you specify more than one version number.
Example
|
$ PRODUCT SHOW HISTORY * /OPERATION=INSTALL /BEFORE=22-MAY-2000
|
The command in this example lists all the products that were installed
before May 22, 2000.
SHOW OBJECT
Displays information about objects created during a software product
installation. Examples of software objects are files and directories.
Format
PRODUCT SHOW OBJECT object-name [/qualifiers]
Parameter
object-name
Names the object or list of objects to include in the display. This is
an optional parameter. If you omit it, all objects for the selected
products will be shown.
Qualifiers
/BASE_SYSTEM=(base-system-name[,...])
Selects software products whose base system matches the one specified.
The base system name identifies both a hardware platform and an
operating system. The base system name AXPVMS denotes an OpenVMS Alpha
product, VAXVMS denotes an OpenVMS VAX product, and VMS denotes a
product applicable to either OpenVMS Alpha or VAX.
Parentheses (()) are optional only when you specify a single base
system name. They are required when you specify multiple base system
names.
/FULL
/NOFULL (default)
Displays information in 132-column format. The /NOFULL qualifier
displays a subset of available information in 80-column format.
/PRODUCER=(producer-name[,...])
Selects software products that the specified manufacturer produces.
Parentheses (()) are optional only when you specify a single producer
name. They are required when you specify multiple producer names.
/PRODUCT=(product-name[,...])
Selects products with the specified product name.
Parentheses (()) are optional only when you specify a single product
name. They are required when you specify multiple product names.
/REMOTE
/NOREMOTE (default)
Uses the product database on a system other than the currently running
system. This qualifier is primarily for use in command procedures that
Compaq supplies. Incorrect use of this qualifier can corrupt the
POLYCENTER Software Installation utility database, corrupt installed products, or cause other
problems. In some cases, /REMOTE can be useful with the CONFIGURE and
SHOW commands.
When you use /REMOTE, the following logical names must be defined:
- PCSI$SYSDEVICE must specify the physical disk name of the target
system disk. This disk must be mounted and allocated to the process
executing the PRODUCT command.
- PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE. It
must be defined in the following form, where x is a valid
system root:
Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC specify
only where the utility will find or place its database. These logical
names do not affect the /DESTINATION.
/VERSION=(version-number[,...])
Selects software products that have the specified version.
Parentheses (()) are optional only when you specify one version number.
They are required when you specify more than one version number.
Example
|
$ PRODUCT SHOW OBJECT * /PRODUCT=ABC /FULL
|
The command in this example lists all objects such as files,
directories, library modules, and other objects that were created when
the product ABC was installed.
|