Verifies the structural integrity of the product database and,
in some circumstances, performs minor repairs on the files in the
database.
Format
PRODUCT ANALYZE PDB [/qualifiers]
1 – Description
The product database refers to an interrelated set of files named
*.PCSI$DATABASE. These files ordinarily reside in SYS$SYSTEM.
When you use this command, PCSI does the following:
o Reads *.PCSI$DATABASE files referenced by the root database
file PCSI$ROOT.PCSI$DATABASE and checks all fields for correct
syntax.
o Automatically performs minor repairs when a known corruption
pattern can be identified and if a repair is feasible.
o Provides instructions for rebuilding the database if an
unrecoverable corruption is found.
The PRODUCT ANALYZE PDB command always reads the
PCSI$ROOT.PCSI$DATABASE file, even if you also select a subset
of the database files for analysis.
2 – Parameters
None.
3 – Qualifiers
3.1 /LOCATION
/LOCATION=device-name:[directory-name]
Specifies the location of the product database files to be
analyzed. Include only a device and directory name. This
qualifier is useful if you copy the product database to a
temporary directory to perform verification and repair on the
copy rather than on the original files.
If you do not use this qualifier, the default location of the
product database files is SYS$SYSDEVICE:[VMS$COMMON.SYSEXE]. If
you omit the device name, PCSI uses your current default device.
If you omit the directory name, PCSI uses your current default
directory.
3.2 /PDB_TYPE
/PDB_TYPE=keyword
Specifies that a subset of the product database files is to be
analyzed. By default, all database files referenced by the root
database file PCSI$ROOT.PCSI$DATABASE are analyzed.
Keywords are as follows:
FILE_SYSTEM Selects the PCSI$FILE_SYSTEM.PCSI$DATABASE
file for analysis.
PROCESSOR Selects the PCSI$PROCESSOR.PCSI$DATABASE file
for analysis.
PRODUCT=(product- Selects the product specific database files
name[,...]) for the named products for analysis. Wildcard
characters are permitted in the product name.
ROOT Selects the PCSI$ROOT.PCSI$DATABASE file for
analysis.
3.3 /REMOTE
/REMOTE
/NOREMOTE (default)
Selects the product database located on a privately mounted
system disk. By default, PCSI searches the currently booted
system disk for the product database.
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.]
4 – Examples
1.$ PRODUCT ANALYZE PDB
Analyzing product database files in DISK$V83SYS:[VMS$COMMON.][SYSEXE]
...scanned PCSI$ROOT.PCSI$DATABASE;1
...scanned PCSI$FILE_SYSTEM.PCSI$DATABASE;1
...scanned PCSI$PROCESSOR.PCSI$DATABASE;1
...scanned DEC-AXPVMS-DECNET_OSI-V0703-2.PCSI$DATABASE;1
...
...scanned DEC-AXPVMS-VMS-V0803-2.PCSI$DATABASE;1
Completed product database analysis with no errors detected
The command in this example verifies the active product
database files in their usual location on the system disk in
SYS$SYSTEM.
2.$ PRODUCT ANALYZE PDB /LOCATION=DKA300:[TEST] /PDB_TYPE=PRODUCT=TCPIP*)
Analyzing product database files in DKA300:[TEST]
...scanned DEC-AXPVMS-TCPIP-V0504-15.PCSI$DATABASE;1
...scanned DEC-AXPVMS-TCPIP_ECO-V0504-155.PCSI$DATABASE;1
...scanned DEC-AXPVMS-TCPIP_ECO-V0504-154.PCSI$DATABASE;1
...scanned DEC-AXPVMS-TCPIP_ECO-V0504-152.PCSI$DATABASE;1
Completed product database analysis with no errors detected
The command in this example analyzes the database files in
the DKA300:[TEST] directory for the TCP/IP product and all the
patch kits that have been applied to it. The root database file
PCSI$ROOT.PCSI$DATABASE must also be in this directory.