pversions (UNIX)

UNIX version of the command. Displays the version information for IBM Spectrum LSF installed on UNIX hosts.

Synopsis

pversions [-f env_file]
pversions -p [-f env_file] product_name
pversions -b [-f env_file] build_number
pversions -q [-f env_file] file_name
pversions -c package_name
pversions -h

Description

By default, displays the version and patch level of IBM Spectrum LSF.

The cluster location is normally determined by your environment setting, so ensure that your environment is set before you run this command (for example, you sourced either the cshrc.lsf or the profile.lsf file).

For each binary type, displays basic version information (package build date, build number, package installed date) and lists patches installed (package type, build number, date that is installed, fixes).

Optionally, the command can also be used to make the following checks:

  • Check the contents of a package before it is installed.
  • Show information about a specific LSF installation.
  • Show information about installed packages from specific build.
  • Find current versions of a specific file and see information for each file.

Options

-f env_file

Use this option only if you cannot set your environment (for example, you cannot source the cshrc.lsf or profile.lsf file).

Specify the full path and file name of a file (such as your LSF install.config file) that defines the parameter LSF_TOP.

If you use this option, the command gets the cluster location from this file, not from the settings in your environment.

-b build_number

Specify the build number of an installed patch. You can specify the most recent full installation or patches installed after the most recent full installation.

Displays information and the contents of the build (binary type and install date, notes, fixes, and files in the package).

-c package_name

Specify the full path and file name of an uninstalled package. For this option, you do not need to set your environment because a cluster is not required.

Displays package contents (notes, fixes, and files in the patch).

-p product_name

Specify one LSF product to see information for that product only. Specify LSF to see information about LSF.

-q file_name

Specify the file name of one installed file.

For each binary type, displays basic version information and file location. If the binary was updated after the most recent full installation, displays additional information about the most recent patch that updated the file (build number, fixes, notes, date installed).

-h

Outputs command usage and exits.

Output

Information is displayed in your command console.

Product version information (Default)

By default, displays product information for entire cluster.

For each product, displays product name and version followed by specific information about each binary type.

For each binary type, displays basic version information (package build date, build number, package installed date) and lists any patches that are installed (package type, build number or fix number, date installed).

binary type
Binary type, build number of binary, and build date of the binary for the most recent full installation. A full installation is installation of any distribution that contains a complete set of new binary files. A full installation can be a new cluster, an upgrade, or patching with an enhancement pack.
installed
Date the binary was installed for the most recent full installation.
patched
For each patch after the most recent full installation, displays fix number, build number, and date patch was installed. If the patch was a fix pack, multiple fixes are listed.

File version information (-q)

The -q option displays information for specified file only.

For each product that contains the specified file, displays product name and version followed by specific information about each binary type.

For each binary type that contains the specified file, displays basic version information and file location. If the binary was updated after the most recent full installation, displays additional information about the most recent patch that updated the file (build number, fixes, notes, date installed).

binary type
Binary type, build number of binary, and build date of the binary for the most recent full installation. A full installation is any distribution that contains a complete set of new binary files. A full installation can be a new cluster installation, a version upgrade, or patching with an enhancement pack.
installed
Date the binary was installed for the most recent full installation.
file
Full path to the version of the file that is used for this binary type.
last patched
For the last patch to update the file after the most recent full installation, displays build number and date patch was installed.
last patch notes
Optional. Some information that is provided for the last patch that updated the file.
last patch fixes
Fixes that are included in the last patch that updated the file.

Build version information (-b)

The -b option displays information for patches with the specified build number only.

For each product, if the product is using binary files from the specified build, displays product name and version followed by specific information about each binary type.

For each binary type, displays the following information:
binary type
Binary type, build number and build date of the patch.
installed
Date the patch was installed.
notes
Optional. Some information that is provided for the build.
fixes
Fixes that are included in the patch.
files
Files that are included in the patch. Not shown for a full distribution such as enhancement pack. Full path to the file installed by this patch.

Package version information (-c)

The -c option displays version information for a specified uninstalled package.
product
Displays product name and version.
binary type
Binary type, build number and build date of the patch.
notes
Optional. Some information that is provided for the build.
fixes
Fixes that are included in the patch.
files
Files that are included in the patch (not shown for a full distribution such as enhancement pack). Relative path to the file.