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

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.



Terms and conditions for information centers | Feedback

Last updated: April 20, 2014 09:59 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-zos&topic=rins_zpmtsh_cmdl
File name: rins_zpmtsh_cmdl.html