The zpmt command uses the values that
you specify for the variables defined in a response file to create
customization data and instructions for configuring the WebSphere® Application Server for z/OS® product.
Location of the shell script
The zpmt.sh shell
script is located in the smpe_install_root/bin or was_home/bin directory.
Description of the shell script syntax
- -responseFile
- Specifies the path to your response file
- -profilePath
- Specifies a fully qualified path name to an existing set of generated
jobs
This parameter cannot be used in combination with the -responsefile
option.
- -workspace
- Specifies the Eclipse workspace directory
- -transfer
- Copies generated jobs from a UNIX System
Services (USS) file system to a pair of partitioned datasets
The zpmt command
first writes the customization jobs to a USS file system.
- -replace
- Specifies that if a set of jobs for the specified profilePath
already exist, they are to be overwritten
This parameter cannot
be used without both the -workspace and -responseFile arguments.
- -allocate
- Attempts to allocate the target datasets
This parameter cannot
be used without the -transfer option.
- -installExtension
- Installs a feature-pack or stacked-product extension
This must
include the absolute path name of the SMP/E installation root for
a stacked product or feature pack. Using this parameter extracts
the contents of the WebSphere Configuration
Tool archive file contained within the specified installation file
system and installs its contents into the Eclipse workspace directory
- -listExtensions
- Lists the extensions that are currently installed in the specified
Eclipse workspace directory
- -uninstallExtension
- Removes the specified extension from the specified Eclipse workspace
directory
- -version
- Version number of the extension to uninstall
Use this parameter
to uninstall a specific version of an extension.
Datasets are determined by appending the values
.CNTL and .DATA to the zTargetHLQ value for the profile containing
the jobs that are being copied. This operation overwrites existing
files of the same name in those datasets.
Sample syntax
The following examples describe
typical command lines with attributes for the
zpmt command.
In these examples,
/xxx can be
any directory to which the user invoking
zpmt.sh has
read and write access.
- zpmt.sh -workspace /xxx -transfer -allocate
-responseFile /xxx/ZCellcmd.responseFile
This
does the following:
- Generates the customization jobs to the location specified by
profilePath in the response file
- Allocates the target CNTL and DATA datasets using the high-level
qualifier specified by targetHLQ in the response file
- Transfers the jobs from the file system to the CNTL and DATA datasets
- zpmt.sh -workspace /xxx -responseFile
/xxx/ZAppSrvcmd.responseFile
This generates
the customization jobs to the location specified by profilePath in
the response file.
- zpmt.sh -workspace /xxx -allocate -transfer
-profilePath /xxx/ZAppSrvcmd
This
does the following:
- Allocates the target CNTL and DATA datasets using the high-level
qualifier specified by targetHLQ in the response file
- Transfers the generated jobs at the location specified by -profilePath
to those datasets
Note: This usage assumes the jobs have already been generated
with a previous invocation of zpmt.sh.
- zpmt.sh -workspace /xxx -transfer
-responseFile /xxx/ZDmgrcmd.responseFile
This
transfers the generated jobs from location profilePath in the response
file to the generated CNTL and DATA datasets.
Note: This usage
assumes that the jobs have already been generated with a previous
invocation of zpmt.sh and that the target CNTL and
DATA datasets have already been allocated
- zpmt.sh -workspace eclipse_workspace_dir -responseFile response_file -allocate
-transfer -replace -installExtension stacked_product_or_feature_pack_install_root
This
does the following:
- Installs the extension from the specified stack-product or feature-pack
installation image
- Generates the customization jobs to the location specified by
profilePath in the response file (any existing customization jobs
at this location are replaced)
- Allocates the target CNTL and DATA datasets using the high-level
qualifier specified by targetHLQ in the response file
- Transfers the generated jobs from the file system to the CNTL
and DATA datasets
- zpmt.sh -workspace eclipse_workspace_dir -listExtensions
This
generates a list of the extensions that are currently installed in
the specified Eclipse workspace directory.
- zpmt.sh -workspace eclipse_workspace_dir -uninstallExtension extension_name -version extension_version
This
removes the specified version of the specified extension from the
specified Eclipse workspace directory.