Contents

The VMDEPLOY command copies product materials from minidisks owned by a product user ID to public minidisks, or minidisks defined for a product Server Virtual Machine.

The VMDEPLOY command has the following syntax:

VMDEPLOY name "Type" [( "Options"]
 
Type:
  INIT [PRIMARY | ALTERNATE | ONLY]
| PRIMARY
| ALTERNATE
| PREVIOUS
| RUNTIME
| PUBLIC
| ADMIN
| CPUPDTS
| HELP
| ALTRUNTIME
| ALTPUBLIC
| ALTADMIN
| ALTCTLDISK | ALTCPUPDTS   Options:
[PPF ppfname compname]
[NODE nodename]
[SETUP | NOSETUP]
[LINK | NOLINK]
[NOLIST | LIST]
 

Definitions

  • name
    Specifies the user ID of the server machine.
  • INIT PRIMARY
    Specifies that a new server is being deployed. A set of default configuration files and startup PROFILE EXEC is placed on the disk defined by the LOCAL tag in the VMSERVER NAMES file. Product code is copied from the product user ID to the minidisks defined as values of tags in the VMSERVER NAMES file whose names are listed as the value of the DEPLOY tag.
  • INIT ALTERNATE
    This form usually specifies that an existing server is being converted from an Automated Installation and Maintenance (AIM) configuration to CA Mainframe VM Product Manager management.
    • Changes the minidisk defined by the LOCAL tag in the VMSERVER NAMES File in the following ways:
      1. VMDEPLOY checks all minidisks before any changes are made. Each disk is checked for correct size and block size. Minidisks in error will be flagged with a message. Fix any problems reported with the minidisk and then rerun the VMDEPLOY command above
      2. VMDEPLOY creates a backup copy of the original PROFILE EXEC on the target minidisk as PROFILE EXECOLD. The new PROFILE EXEC will contain the EXEC PROFRUN.
    • Loads code to the minidisks defined by the following tags in the VMSERVER NAMES File:
      • ALTRUNTIME
      • ALTADMIN
      • ALTPUBLIC
  • INIT ONLY
    • Specifies that a product server is being initialized, but that no deployment of product code is required. This is useful when more than one product server shares a copy of the deployed product code.
    • Changes the minidisk defined by the LOCAL tag in the VMSERVER NAMES File in the following ways:
      1. VMDEPLOY checks all minidisks before any changes are made. Each disk is checked for correct size and block size. Minidisks in error will be flagged with a message. Fix any problems reported with the minidisk and then rerun the VMDEPLOY command above.
      2. VMDEPLOY creates a backup copy of the original PROFILE EXEC on the target minidisk as PROFILE EXECOLD. The new PROFILE EXEC will contain the EXEC PROFRUN.
  • PRIMARY
    Specifies that product code is copied from the product user ID to the minidisks defined as values of tags in the VMSERVER NAMES file whose names are listed as the value of the DEPLOY tag.
  • ALTERNATE
    Specifies that product code is copied from the product user ID to the minidisks defined by prefixing the names listed on the DEPLOY tag with the string 'ALT'.
    For example, if the value of the DEPLOY tag was 'RUNTIME ADMIN PUBLIC', then an ALTERNATE deploy copies files to the disks defined on the following tags in the VMSERVER NAMES File for the server:
    • ALTRUNTIME
    • ALTADMIN
    • ALTPUBLIC
  • PREVIOUS
    Specifies that product code is copied from the product user ID to the minidisks defined by prefixing the names listed on the DEPLOY tag with the string 'PREV'.
    For example, if the value of the DEPLOY tag was 'RUNTIME ADMIN PUBLIC', then a PREVIOUS deployment copies files to the disks defined on the following tags in the VMSERVER NAMES File for the server:
    • PREVRUNTIME
    • PREVADMIN
    • PREVPUBLIC
  • RUNTIME
    Specifies that product code is copied from the product user ID BUILDSRV minidisk to the minidisk defined by the RUNTIME tag in the VMSERVER NAMES file.
  • PUBLIC
    Specifies that product code is copied from the product user ID BUILDPUB minidisk to the minidisk defined by the PUBLIC tag in the VMSERVER NAMES file.
  • ADMIN
    Specifies that product code is copied from the product user ID BUILDADM minidisk to the minidisk defined by the ADMIN tag in the VMSERVER NAMES file.
  • CPUPDTS
    Specifies that CP programming interface files for the CA VM:Spool V/Seg Plus Feature are copied from the product user ID BUILDCPF minidisk to the minidisk defined by the CPUPDTS tag in the VMSERVER NAMES file.
  • HELP
    Specifies that product code is copied from the product user ID BUILDHLP minidisk to the minidisk defined by the HELP tag in the VMSERVER NAMES file.
  • ALTRUNTIME
    Specifies that product code is copied from the product user ID BUILDSRV minidisk to the minidisk defined by the ALTRUNTIME tag in the VMSERVER NAMES file.
  • ALTPUBLIC
    Specifies that product code is copied from the product user ID BUILDPUB minidisk to the minidisk defined by the ALTPUBLIC tag in the VMSERVER NAMES file.
  • ALTADMIN
    Specifies that product code is copied from the product user ID BUILDADM minidisk to the minidisk defined by the ALTADMIN tag in the VMSERVER NAMES file.
  • ALTCPUPDTS
    Specifies that CP programming interface files for the CA VM:Spool V/Seg Plus Feature are copied from the product user ID BUILDCPF minidisk to the minidisk defined by the ALTCPUPDTS tag in the VMSERVER NAMES file.
  • PREVRUNTIME
    Specifies that product code is copied from the product user ID BUILDSRV minidisk to the minidisk defined by the PREVRUNTIME tag in the VMSERVER NAMES file.
  • PREVPUBLIC
    Specifies that product code is copied from the product user ID BUILDPUB minidisk to the minidisk defined by the PREVPUBLIC tag in the VMSERVER NAMES file.
  • PREVADMIN
    Specifies that product code is copied from the product user ID BUILDADM minidisk to the minidisk defined by the PREVADMIN tag in the VMSERVER NAMES file.
  • PREVCPUPDTS
    Specifies that CP programming interface files for the CA VM:Spool V/Seg Plus Feature are copied from the product user ID BUILDCPF minidisk to the minidisk defined by the PREVCPUPDTS tag in the VMSERVER NAMES file.
  • PPF ppfname component
    Specifies the product parameter file name and component name. The default values are obtained from the :ppfname tag in the VMSERVER NAMES file. Use this option in an environment where different product release levels are deployed for use on the same product server virtual machine. Use the following steps to move to a new release of a product:
    1. Deploy the new release to the ALTERNATE disks by specifying the new release PPF filename and component as options to VMDEPLOY.
    2. Switch the environment name to ALTERNATE and restart the product server during testing.
    3. Commit to the new release by updating the PPF file name and component in the VMSERVER NAMES file to the new release names, deploy the new release to the PRIMARY area, and update the environment name to PRIMARY. The product server will run on the new release when it is next started.
  • NODE nodename
    Specifies the node name to be associated with the deployment in the SRVBLDS file for use by the VMPTFS command. The default value is the node name of the system where the command is executed. The node name is only used in the records created for display by the VMPTFS command. There is no support for deploying product code to IDs on other systems.
  • SETUP | NOSETUP
    Specifies that a minidisk/directory access order for the deploy function is setup according to entries in the :MDA section of the product parameter file. SETUP is the default.
  • LINK | NOLINK
    Specifies that CP LINK commands are issued as defined in the :DCL section of the product parameter file. LINK is the default.
  • NOLIST | LIST
    Specifies whether VMDEPLOY lists all files that were added, deleted, or modified. If NOLIST is specified, or is in effect by default, then only a summary indicating the number of files deleted, added, or updated is displayed.

Description

This tool copies files from the installed product materials minidisks or Shared File System directories to minidisks defined in the VMSERVER NAMES file entry for a specific deployment. The target area name specifies a single minidisk or a set of minidisks.

VMDEPLOY records a deployment event in a file for use by the VMPTFS command. The filename is extracted from the :APPID tag in the product parameter file. The filetype is SRVDPLY. Each deployment event records the following information is recorded:

  • A timestamp when the deployment occurred.
  • The nodename where the command is issued.
  • The identifier specified on the name parameter.
  • The name of the deployment.
Icon
Note: For an expanded explanation of the actions of this tool refer to the section VMDEPLOY Command Tool.