PRODUCT, EXTRACT
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help PRODUCT, EXTRACT *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
Retrieves a specified file or files.
| 1 - FILE |
Retrieves a user-specified file or files from a sequentially
formatted software product kit. A file type of .PCSI denotes a
sequential kit. The original name of the file is preserved when
it is extracted.
Format
PRODUCT EXTRACT FILE product-name[,...] [/qualifiers]
1.1 - Parameter
product-name
Names the product, or list of products, from whose kits the
selected file or files are to be retrieved. This parameter is
required.
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 utility is to place all the
files that the user indicates are to be retrieved. If the device
name is not provided, the default is the user's default device.
If the directory name is omitted, or the /DESTINATION= qualifier
is not specified, the default is the user's default directory.
The EXTRACT FILE operation ignores the PCSI$DESTINATION logical
name whether or not you use the /DESTINATION qualifier.
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
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= 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 messages as the POLYCENTER Software Installation utility
performs an operation.
1. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
1. 2.6 - /SELECT
/SELECT=filename[,...]
Specifies the name of a file, or a list of files, to be extracted
from the specified sequential kit. You can use the asterisk
(*) and the percent sign (%) wildcard characters for all or
part of the file name. The file name can contain a directory
specification that includes an ellipsis (...). If you omit this
qualifier, all files will be extracted from the specified kit or
kits.
1. 2.7 - /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 that the logical name
PCSI$SOURCE defines. 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.8 - /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.9 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
1.3 - Example
$ PRODUCT EXTRACT FILE TEST /SELECT=TEST.EXE /SOURCE=[AL]
In this example, the POLYCENTER Software Installation utility
extracts the file TEST.EXE from the sequential kit of the
product TEST that is in the [AL] directory on the user's
default disk. The extracted file TEST.EXE is placed in the
user's current default directory.
| 2 - PDF |
Retrieves the product description file (PDF) from a sequentially
formatted software product kit. A file type of .PCSI denotes
a sequential kit. The file type of the extracted PDF file is
.PCSI$DESCRIPTION.
Format
PRODUCT EXTRACT PDF product-name[,...] [/qualifiers]
2.1 - Parameter
product-name
Names the product, or list of products, whose PDF file is to be
retrieved from the kit.
2.2 - Qualifiers
2. 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.
2. 2.2 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies the location where the utility is to place the
extracted product description file (PDF). If the device name
is not provided, the default is the user's default device. If
the directory name is omitted, or the /DESTINATION= qualifier is
not specified, the default is the user's default directory. The
EXTRACT PDF operation ignores the PCSI$DESTINATION logical name
whether or not you use the /DESTINATION qualifier.
2. 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
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= 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.
2. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs an operation.
2. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
2. 2.6 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
2. 2.7 - /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.
2. 2.8 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
2.3 - Example
$ PRODUCT EXTRACT PDF TEST /SOURCE=[AL]
In this example, the POLYCENTER Software Installation utility
extracts the product description file (PDF) from the sequential
kit of the product TEST that is in the [AL] directory on the
user's default disk and places it in the user's current default
directory.
| 3 - PTF |
Retrieves the product text file (PTF) from a sequentially
formatted software product kit. A file type of .PCSI denotes a
sequential kit. The PTF file is stored in a product kit as a text
library file. The file type of the extracted PTF is .PCSI$TLB.
In addition, a text file version of this text library file is
created with a file type of .PCSI$TEXT.
Format
PRODUCT EXTRACT PTF product-name[,...] [/qualifiers]
3.1 - Parameter
product-name
Names the product, or list of products, whose PTF file is to be
retrieved from the kit.
3.2 - Qualifiers
3. 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.
3. 2.2 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies the location where the utility is to place the
extracted product text file (PTF). If the device name is not
provided, the default is the user's default device. If the
directory name is omitted, or the /DESTINATION= qualifier is
not specified, the default is the user's default directory. The
EXTRACT PTF operation ignores the PCSI$DESTINATION logical name
whether or not you use the /DESTINATION qualifier.
3. 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
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= 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.
3. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs an operation.
3. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
3. 2.6 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
3. 2.7 - /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.
3. 2.8 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
3.3 - Example
$ PRODUCT EXTRACT PTF TEST /SOURCE=[AL]
In this example, the POLYCENTER Software Installation utility
extracts the product text file (PTF) from the sequential kit
of the product TEST that is in the [AL] directory on the user's
default disk and places two files in the user's current default
directory: the extracted text library file (.PCSI$TLB) and a
text file (.PCSI$TEXT) created from the library.
| 4 - RELEASE_NOTES |
Retrieves the release notes for the selected product or group of
products. If no output file name is given, the release notes are
written to a file named DEFAULT.PCSI$RELEASE_NOTES in the user's
default directory.
Format
PRODUCT EXTRACT RELEASE_NOTES product-name[,...] [/qualifiers]
4.1 - Parameter
product-name
Names the product, or list of products, from which to extract
release notes.
4.2 - Qualifiers
4. 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.
4. 2.2 - /FILE
/FILE=filespec
Specifies the name of the output file that will contain the
release notes. If no file name is given, the release notes are
written to a file named DEFAULT.PCSI$RELEASE_NOTES in the current
directory.
4. 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
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= 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.
4. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
4. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
4. 2.6 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
4. 2.7 - /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.
4. 2.8 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
4. 2.9 - /WORK
/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.
4.3 - Example
$ PRODUCT EXTRACT RELEASE_NOTES XYZ /VERSION=2.3/FILE=[RN]XYZ.TXT
The command in this example places the release notes for
Version 2.3 of the product XYZ in a file named [RN]XYZ.TXT
on your current default device.
|
|
