Installing the Agent for UNIX

Installing the Agents

Installing the Agent for Windows

---

Installing the Agent for VMS

This document describes the hotfix installation procedure for the VMS agent.

Each supported VMS version is assigned a two-character code. This code appears in all file names of the agent and is described in the Terminology. Throughout this document the specific code will be represented by "??."

In VMS, text strings that are used to enter commands and call files, for example, are case-insensitive. Any combination of uppercase or lowercase letters is acceptable. In this document, uppercase letters are used, except when describing commands of the program FTP.EXE, which can only be entered in lower case.

Close the agent before you start the update installation.

Requirements

• The user AE has been given the privileges CMKRNL, BYPASS, SYSNAM, SYSPRV and WORLD.
• The batch queue SYS$BATCH must be initialized and started. As an alternative, you can use a specially customized and prioritized batch queue for AE jobs. This must be defined in the INI file of the VMS agent as a parameter of the VMS command for starting jobs in batch mode. Working with an individual batch queue requires that is it initialized and started beforehand.

  In order to ensure that AE jobs are performed in batch mode, the job limit must be set with a number greater than zero.

Supplied Installation Files

The files that match each VMS version are found in the respective subdirectory of IMAGE:AGENTS\VMS .

The CallAPI files and CallAPI implementation are described in a separate document.

Procedure

	1.	Transferring the command file to the host

• Admin computer
• Transfer the file UC$CRDIR.COM via FTP (ascii).

	2.	Setting up the directories and authorizations

• Host
• Log on using user ID "AE".
• Call command file:

  $  @UC$CRDIR

• Delete command file:

  $DELETE UC$CRDIR.COM;*

  The command file UC UC$CRDIR.COM creates all the necessary directories and authorizations.

Directory	Authorization
BIN	SYSTEM: RE, OWNER: RWED, GROUP: E, WORLD: E
CMD	SYSTEM: RWE, OWNER: RWED, GROUP: R, WORLD: -
TEMP	SYSTEM: RE, OWNER: RWED, GROUP: WE, WORLD: WE
OUT	SYSTEM: RW, OWNER: RWD, GROUP: RW, WORLD: RWE

	3.	Transferring other files to the host

• Admin computer
• The files of the VMS agent (UCXJV??.EXE), for file event (UCXE???F.EXE) and the messenger program (UCXJV??M.EXE) must be transferred in binary mode. All others are text files.

	4.	Setting up the system environment

• Host
• Change from the login directory to the BIN directory:

  $SET DEF [.BIN]

• If recommended in the current Release Notes, adjust the INI file. Refer to the INI file UCXJV??.INI, which is supplied with the update installation.
• Change to the CMD directory:

  $SET DEF [-.CMD]

• Use an editor to adjust the command file for shutting down the agent UC$STOP.COM.

  The name of the AE system and the agent name must be adjusted in order to find the logical name of the agent.

You can also modify both files on the Admin computer before you transfer them.

• Admin computer or user computer
• Adjust HEADER.VMS, TRAILER.VMS and RESTART.VMS if needed. See: Job - Execution.