Previous Topic: Servicing Your ProductNext Topic: Step 2. Receive the Service


Step 1. Prepare to Receive Service

Follow these steps to prepare to receive service.

  1. Prepare the VMANAGER Administration User ID.
  2. Receive the Documentation.
  3. [Optional] Merge the Alternate APPLY disk.

Note: The ppfname used throughout these servicing instructions is ZVME031A, which assumes that you are using the PPF supplied for CA VM:Director. If you have created your own PPF override file for the product, you must use your override file name instead of ZVME031A. The ppfname must be used throughout the rest of this procedure, unless otherwise stated.

Step 1.1. Prepare the VMANAGER Administration User ID

Log on to VMANAGER.

The PROFILE EXEC establishes the correct search order for applying service.

It is a good practice to create a backup copy of the current CA VM:Director disks or SFS directories, which contain product materials. Save this backup until you have completed installing the service and you are confident that the service runs correctly.

Make the service envelope (SERVLINK) file available on the A-disk or any minidisk or SFS directory accessed as file mode C.

Setup the installed product materials access search order by issuing the VMFSETUP command as follows:

VMFSETUP ppfname component ( LINK
ppfname

Specifies the value of the PPF filename. In most cases, use the name of the supplied PPF file for this release, which is ZVME031A. If you have created a PPF Override file, use the file name of your PPF override file.

component

Specifies the name of the component. Use the name VMDIRECT for installing on minidisks. Use the name VMDIRECTSFS for installing on SFS.

Important! The steps in the service application procedure assume that the product search order has been established before you begin the procedure. The search order is lost if disks are released manually, if CMS is restarted by the IPL command, or if you logoff and logon again. If the search order is lost at any time, re-establish it by issuing the VMFSETUP command before proceeding to the next VMFREC, VMFMRDSK, VMFAPPLY, or VMFBLD command.

Step 1.2. Receive the Documentation

Load from an envelope file by issuing the following command:

VMFREC INFO ( ENV envfilename
INFO

Specifies that the documentation, including the product service memo, is loaded to the A-disk.

ENV

Indicates the value following this option keyword, which is the name of the envelope file for the service being applied. The CMS file type of this file is SERVLINK.

Check the receive message log ($VMFREC $MSGLOG) for warning and error messages. Use the PF5 key to show all status messages which identify the products with service.

VMFVIEW RECEIVE

Read the product memo file ZVME031A MEMO for the latest information about this service.

Step 1.3. [Optional] Merge the Alternate APPLY disk

This step is optional. The APPLY string contains the files that define service levels. Before receiving a new service, you may choose to consolidate service levels by merging previously processed service from the alternate APPLY disk to the production APPLY, where it is permanently stored. The merge operation provides a clean alternate APPLY disk for new service. Issue the VMFMRDSK command as follows:

VMFMRDSK ppfname component APPLY
ppfname

Specifies the value of the PPF filename. In most cases, use the name of the supplied PPF file for this release, which is ZVME031A. If you have created a PPF Override file, use the file name of your PPF override file.

component

Specifies the name of the component. Use the name VMDIRECT for installing on minidisks. Use the name VMDIRECTSFS for installing on SFS.

If you merged your APPLY disks, review the merge message log ($VMFMRD $MSGLOG). If necessary, correct any problems before proceeding.

VMFVIEW MRD

Note: For more information about handling specific error messages, see the appropriate VM Messages and Codes publication, or use online HELP.