Installation Prerequisites

The following topics describe the preparation for installing CA ACF2 for z/VM.

This section contains the following topics:

Maintenance ID

PF Keys

Maintenance ID

You must designate a CA product maintenance virtual machine to install and maintain CA ACF2 for z/VM from. If you installed other CA‑Unicenter VM products, you defined a common CA‑Unicenter VM product maintenance ID (such as CAIMAINT).

If you are converting from a previous CA ACF2 for z/VM release and are installing r12 in NOAUTO mode, you must add your maintenance ID (CAIMAINT) to the FORCEID list in VMXAOPTS and regenerate your CP nucleus before installation. Define the CA‑ACTIVATOR product maintenance virtual machine with the following minidisks:

A 191 disk to hold the CA‑ACTIVATOR files and serve as a work area.
A 291 disk to act as the CA‑ACTIVATOR test staging disk. We recommend that you do not allow general users access to this disk.
A 391 disk to act as the CA‑CIS production disk.

See the chapter "System Requirements" for space requirements for CA‑ACTIVATOR and CA ACF2 for z/VM. As an additional safeguard, CA‑ACTIVATOR checks that enough disk space is available before installing a new product.

PF Keys

We display PF keys at the bottom of each panel. Use them to perform the indicated panel functions. The table below shows the PF keys as we define them. Generally, you use PF2 for the primary action on a panel. Other actions are usually assigned to PF5 or PF6.

PF Key	Function	Description
PF1	HELP	Displays online HELP and field descriptions.
PF2	SAVE	Saves the values displayed on the panel.
	ACTION	Performs the action detailed on the panel.
	EXECUTE	Performs the action detailed on the panel.
	CONFIRM	Confirms that the task has been performed.
	FORMAT	Formats the specified minidisks.
	PERFORM	Causes the task to perform.
	FILE	Saves the options you specified.
	MODIFY	Lets you modify the values.
	EDIT	Lets you edit the panel.
	XEDIT	Lets you change a file.
	COPY	Copies the files you specified.
	BUILDMAC	Builds the MACLIB.
	ASSEMBLE	Assembles the ACFFDR.
	PROCESS	Processes files.
PF3	END	Ends processing and exits a particular task. The cursor returnsto the CA‑ACTIVATOR Task Selection Menu.
	QUIT	Quits current processing and exits a particular task. No actionis taken. The cursor returns to the CA‑ACTIVATOR Task Selection Menu.
PF4	RETURN	Exits task without processing. The cursor returns to the Primary Menu.
PF5	ADD USER	Lets you define a user to the CP directory.
	BYPASS	Bypasses all processing. The cursor returns to the CA‑ACTIVATORTask Selection Menu.
PF6	XEDIT	Lets you change a file.
	VIEW	Displays a file.
	REPLACE	Replaces previously existing files with newly created ones.
PF7	BACKWARD	Scrolls backward three lines.
PF8	FORWARD	Scrolls forward three lines.
PF9	SCRHLPUP	Scrolls the help information towards the top.
PF10	SCRHLPDN	Scrolls the help information towards the bottom.

You tab forward to each field in a panel. Most fields on a panel display default values. To accept a default value, tab to the next field. To change a field entry, type over the existing entry. To delete an entry, use the space bar or the Erase EOF key to erase the entry.

CP or CMS Commands

To issue one or more CP or CMS commands while processing a task, you can respond CMS to most prompts. CA‑ACTIVATOR places you into a conversational mode where you can issue the necessary commands. Enter a null response to return to the original CA‑ACTIVATOR prompt.

Exiting CA-ACTIVATOR

To exit CA‑ACTIVATOR while processing a task, respond EXIT to most prompts. CA‑ACTIVATOR returns you to the Task Selection Menu and leaves the status of the processing task INCOMPLETE. You can select that task again at a later time.

Error Messages

See the CA‑ACTIVATOR Reference Guide for detailed explanations of error messages.

System Messages

System messages indicate the status of the installation tasks. Each task can consist of one or more required actions. When CA‑ACTIVATOR successfully completes or executes a task, the following message, indicating it completed all required prerequisites or actions, appears:

This task has completed successfully

You can proceed to the next task. If you did not perform a prerequisite task or some portion of the task did not successfully complete, CA‑ACTIVATOR marks the task as incomplete. You must reexecute the task after completing the failed or missing portion before you can proceed to next task.

Command Notation

This guide uses the following command notation. Enter the following exactly as they appear in command descriptions:

Type of Characters	Description
UPPERCASE	Identifies commands, keywords, and keyword values that you must code exactly as shown.
MIXed Cases	Identify command abbreviations. The uppercase letters are the minimum abbreviation; lowercase letters are optional
Symbols	You must code all symbols, such as commas, equal signs, and slashes exactly as shown.

The following clarify command syntax; do not type these as they appear:

Type of Characters	Description
lowercase	Indicates a variable that you must supply.
[ ]	Identify optional keywords or parameters.
{ }	Require that you choose one or more of the keywords or parameters listed.
underlining	Shows default values that you do not have to specify.
\|	Separates alternative keywords and parameters, choose one.
...	Means you can repeat the preceding items or group of items more than once.

Sample Command	Explanation
ACFNRULE{ruleid\|KEY(ruleid)}	ACFNRULE	Command abbreviation.
TYPE(rsrctype)]‑	TYPE	Optional value you can specify.
{[ADD(ruleentry)…]‑	ADD	Optional keyword.
[DELETE(ruleentry)…]}‑	DELETE	Optional keyword.
[LIST\|NOLIST] ‑	LIST	Default, you do not have to specify.
[VERIFY\|NOVERIFY]	VERIFY	Default, you do not have to specify.