ALTERNAT Record

Reference Guide › Configuration File Reference › ALTERNAT Record

ALTERNAT Record

Use the ALTERNAT record to specify commands to be used by various CA VM:Director macros in place of the CMS DDR, COPYFILE and FORMAT commands.

ALTERNAT command altcmd

Configuration File

ALTERNAT is defined in the PRODUCT CONFIG file.

Definitions

command

Specifies one of the CMS commands, COPYFILE, DDR, or FORMAT, for which an alternate command is to be used.

altcmd

Specifies alternate command module to be used by CA VM:Director instead of COPYFILE, DDR, or FORMAT.

Note: The altcmd specified must have the exact command syntax as the COPYFILE, DDR, or FORMAT command being replaced; if not, you must also implement the DISKCOPY or FORMAT user exit.

Description

Some of the directory manager functions use the CMS COPYFILE, DDR and FORMAT commands. Therefore, any alternate commands should reside on minidisks common to directory managers and the CA VM:Director service virtual machine, for example, the S‑ or Y‑disk.

If you are using the Servant Facility, please note the following:

To add a FORMAT command to the ALTERNAT record, you must first END CA VM:Director and XEDIT the PRODUCT CONFIG file. You cannot use the CONFIG command.
The alternate command modules are automatically copied to the CA VM:Director COMMON minidisk.
The COMMON DISK is re-initialized during product initialization and when the PRODUCT CONFIG file is updated.
New copies of the programs defined on the ALTERNAT record are copied to the COMMON disk when the product initialization occurs and when the PRODUCT CONFIG file changes.

Example

To specify that you want to use the CA VM:Backup HiDRO fast minidisk formatting capabilities, add the following ALTERNAT records to the PRODUCT CONFIG file:

ALTERNAT FORMAT HIDRO
LTERNAT COPYFILE HIDRO
ALTERNAT DDR HIDRO

Implement the DISKCOPY and FORMAT user exits, then copy the HIDRO MODULE to a minidisk accessible by CA VM:Director. The prototype exits provided on the CA VM:Director system administrator minidisk (which is typically the VMDIRECT 176 minidisk) illustrate the use of CA VM:Backup HiDRO.