Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

    PCSI$SYSDEVICE:[SYSx.]

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:

>       PCSI$SYSDEVICE:[SYSx.]

> 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:

>       PCSI$SYSDEVICE:[SYSx.]

> 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:

>       PCSI$SYSDEVICE:[SYSx.]

> 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

    $ PRODUCT REMOVE FTAM

> 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:

>       PCSI$SYSDEVICE:[SYSx.]

> 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:

>       PCSI$SYSDEVICE:[SYSx.]

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

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_052.HTML