|
VMS Help PRODUCT, REGISTER *Conan The Librarian |
Either records product information in the product database
(REGISTER PRODUCT) or records a volume label change of the volume
containing the installed products (REGISTER VOLUME).
| 1 - 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 kit 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]
1.1 - Parameter
product-name
Names the product, or list of products, to register.
1.2 - Qualifiers
1. 2.1 - /BASE_SYSTEM
/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.
1. 2.2 - /DESTINATION
/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.
1. 2.3 - /KIT_ATTRIBUTES
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT= Designates the format of the product kit as follows:
format-type
COMPRESSED Compressed format in which a data
compression technique has been applied
to a sequential kit. A compressed kit
has a .PCSI$COMPRESSED file type.
REFERENCE Reference format in which product
files exist in a directory tree. A
.PCSI$DESCRIPTION file in the top
level of the directory tree denotes a
reference kit.
SEQUENTIAL Sequential format in which product files
are placed in a container file. A file
type of .PCSI indicates a sequential
kit.
TYPE= Specifies the type of product kit as follows:
kit-type
FULL Layered product (application) software.
OPERATING_ Operating system software.
SYSTEM
MANDATORY_ A required correction to currently
UPDATE 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.
1. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays the file specifications of the product database files
that are created or modified.
1. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
1. 2.6 - /REMARK
/REMARK=string
Records a comment in the product database about the task you
are performing. The PRODUCT 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.
1. 2.7 - /REMOTE
/REMOTE
/NOREMOTE (default)
Selects the product database located on a privately mounted
system disk. By default, this utility searches the currently
booted system disk for the product database.
This qualifier is primarily for use in command procedures that
HP supplies. Incorrect use of this qualifier can create an
inconsistency in the product database or cause subsequent PRODUCT
commands to fail.
When you use /REMOTE, the following logical names must be
defined:
o 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.
o 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:
PCSI$SYSDEVICE:[SYSx.]
1. 2.8 - /SOURCE
/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.
1. 2.9 - /SPAN_VERSIONS
/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.
1. 2.10 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
1.3 - 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.
| 2 - 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.
Note that if you use the SET VOLUME command to change the volume
label of a device that has installed products, you must also
use the PRODUCT REGISTER VOLUME command to update the product
database with this information.
Format
PRODUCT REGISTER VOLUME old-volume-label device-name
[/qualifiers]
2.1 - 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.
2.2 - Qualifiers
2. 2.1 - /LOG
/LOG
/NOLOG (default)
Displays the file specifications of the product database files
that are created or modified.
2. 2.2 - /REMOTE
/REMOTE
/NOREMOTE (default)
Selects the product database located on a privately mounted
system disk. By default, this utility searches the currently
booted system disk for the product database.
This qualifier is primarily for use in command procedures that
HP supplies. Incorrect use of this qualifier can create an
inconsistency in the product database or cause subsequent PRODUCT
commands to fail.
When you use /REMOTE, the following logical names must be
defined:
o 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.
o 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:
PCSI$SYSDEVICE:[SYSx.]
2.3 - 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.
|
|