HELPLIB.HLB  —  PRODUCT  ANALYZE

1  –  PDB

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

1.2  –  Parameters

    None.

1.3  –  Qualifiers

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

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

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

1.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.
Close Help