[z/OS]

zpmt command

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.

Running the shell script

The zpmt.sh shell script is located in the smpe_install_root/bin or was_home/bin directory.

Definition of shell script syntax

These three attributes need a dataset or path following to be complete.
-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.

-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 data sets
  • 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.

Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jun 11, 2013 12:23:29 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v700cea&product=was-nd-mp&topic=rins_zpmtsh_cmdl
File name: rins_zpmtsh_cmdl.html