Updated: 11 December 1998

OpenVMS System Management Utilities Reference Manual

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.

Removes the specified software product or products from your system and the product database.

Format

PRODUCT REMOVE product-name[,...] [/qualifiers]

Parameter

product-name

Names the installed product, or list of products, to remove.

Qualifiers

/BASE_SYSTEM=base-system-name

Selects software products that are in the named base system. The 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. By default, the operation is performed for products with any base system designation.

/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. By default, selects all producers.

/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 the software product that has the specified version. By default, selects all versions.

/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 removes the product named FTAM from the system and the product database.

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, about which to show information. This is an optional parameter. If you omit it, all products will be shown.

Qualifiers

/BASE_SYSTEM=base-system-name

/BASE_SYSTEM=(base-system-name[,...])

Selects software products that are in the named base system. The 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. By default, the operation is performed for products with any base system designation.

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)

Controls how the available information is displayed. The /FULL qualifier displays all of the information in 132-column format. The /NOFULL qualifer displays a condensed version of the information.

/LOG

/NOLOG (default)

Displays messages as the POLYCENTER Software Installation utility performs the operation.

/OPERATION=keyword

/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

/PRODUCER=(producer-name[,...])

Selects software products that the specified manufacturer produces. By default, selects all producers. 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 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

/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

/VERSION=(version-number[,...])

Selects the software product or products that have the specified version. By default, selects all versions. 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-1998
 
      

The command in this example lists all the products that were installed before May 22, 1998.

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, about which to show information. This is an optional parameter. If you omit it, all objects will be shown.

Qualifiers

/BASE_SYSTEM=base-system-name

/BASE_SYSTEM=(base-system-name[,...])

Selects software products that are in the named base system. The 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. By default, the operation is performed for products with any base system designation.

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)

Controls how the available information is displayed. The /FULL qualifier displays all of the information in 132-column format. The /NOFULL qualifer displays a condensed version of the information.

/LOG

/NOLOG (default)

Displays messages as the POLYCENTER Software Installation utility performs the operation.

/PRODUCER=producer-name

/PRODUCER=(producer-name[,...])

Selects software products that the specified manufacturer produces. By default, selects all producers. Parentheses (()) are optional only when you specify a single producer name. They are required when you specify multiple producer names.

/PRODUCT=product-name

/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

/VERSION=(version-number[,...])

Selects the software product or products that have the specified version. By default, selects all versions. 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.

Displays a list of software products installed on your system. Use the /FULL qualifier to display additional information such as kit type, maintenance activity, and software dependencies.

Format

PRODUCT SHOW PRODUCT product-name[,...] [/qualifiers]

Parameter

product-name

Names the product, or list of products, about which to show information. This is an optional parameter. If you omit it, all products will be shown.

Qualifiers

/BASE_SYSTEM=base-system-name

/BASE_SYSTEM=(base-system-name[,...])

Selects software products that are in the named base system. The 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. By default, the operation is performed for products with any base system designation.

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)

Controls how the available information is displayed. The /FULL qualifier displays all of the information in 132-column format. The /NOFULL qualifer displays a condensed version of the information.

/LOG

/NOLOG (default)

Displays messages as the POLYCENTER Software Installation utility performs the operation.

/MAINTENANCE=product-name

/MAINTENANCE=(product-name[,...])

Displays the products to which the named maintenance products have been applied. A maintenance product is either a patch kit or a mandatory update kit. Parentheses (()) are optional only when you specify a single product name. They are required when you specify multiple product names.

To list all maintenance products that have been applied to a particular product, use the following command:

PRODUCT SHOW PRODUCT product-name /FULL

/PRODUCER=producer-name

/PRODUCER=(producer-name[,...])

Selects software products that the specified manufacturer produces. By default, selects all producers. Parentheses (()) are optional only when you specify a single producer name. They are required when you specify multiple producer names.

/REFERENCED_BY=product-name

/REFERENCED_BY=(product-name[,...])

Displays products that are referenced by the named product. Use this qualifier to show if the product, specified in the /REFERENCED_BY qualifier, has a software dependency on the product or products specified in the product-name parameter of the SHOW PRODUCT command. If you specify an asterisk (*) as the product name, all referenced products are listed for the product named in the /REFERENCED_BY qualifier.

Parentheses (()) are optional only when you specify a single product name. They are required when you specify multiple product names.

To list all products that require a specified product to be installed, use the command:

PRODUCT SHOW PRODUCT product-name /FULL /REFERENCED_BY=*

To list all products that are referenced by (that is, required by) a particular product, use the command:

PRODUCT SHOW PRODUCT * /REFERENCED_BY=product-name

To list all products that are referenced by (that is, required by) other products, use the command:

PRODUCT SHOW PRODUCT * /REFERENCED_BY=*

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

/SPAN_VERSIONS=keyword([,...])

Specifies a range of versions. 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

/VERSION=(version-number[,...])

Selects the software product or products that have the specified version. By default, selects all versions. Parentheses (()) are optional only when you specify one version number. They are required when you specify more than one version number.

Example

$ PRODUCT SHOW PRODUCT */REFERENCED_BY=DECNET_OSI
 
      

The command in this example lists all products on which the DECnet-Plus product is dependent.

Displays the version of the POLYCENTER Software Installation utility that you are using.

Format

PRODUCT SHOW UTILITY

Parameters

None.

Qualifiers

None.

Example

$ PRODUCT SHOW UTILITY
POLYCENTER Software Installation utility version: V7.1
      

The command in this example shows the version of the utility that is executing the command.

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

6048PRO_055.HTML