Administration Guide > Installation > New Installation > Installing the Agent for VMS

Installing the Agent for VMS

This document guides you through the new installation of a VMS agent.

A two-character code is assigned to each supported VMS version. This code then appears in all agent file names and is described in the terminology. In this document, the characters "??" are used to represent this code.

In VMS, text strings that call and identify items such as commands and files are not case-sensitive. Any combination of uppercase or lowercase letters is acceptable. In this document, capital letters are used with only one exception: Commands of the program FTP.EXE can only be entered in lowercase.

Tip:
The VMS agent can be started automatically when booting the operating system. Refer to the configurationA set of constituent components that make up a system. This includes information on how the components are connected including the settings applied. details that are described at the end of this document. The required command files UC4$STARTUP.COM and UC4$STARTUP_BAT.COM must be transferred to the directory SYS$STARTUP. Their names meet the requirements of the 8.3 conventions of the AE CD and are freely definable. Note that names that have been changed must also be modified in the command files. 

Requirements

Supplied Installation Files

The files are found in the subdirectory of IMAGE:AGENTS\VMS that corresponds with the particular VMS variant.

The CallAPI files and their implementation are described separately.

Special Feature: Logical Name for Agent

VMS often uses global variables, also called logical names, to transfer information.

AE's VMS agent also uses this kind of global variable.
By default, its name is structured as follows: UC4_AE system name_Agent_name_AGENT. The names that have been defined in the INI file are used. You can, however, also define a different logical name, using the parameter uc4_logical= in the INI file.

The global variable is automatically created when the agent starts and deleted when it ends. The value of the variable is "OK" by default. The agent can be ended by changing the variable content to "TERM" using the command file UC$STOP.COM. Within 20 seconds the agent reacts and ends normally.


Procedure

1. Transferring the command file to the host
2. Determining 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 more files to the host
4. Setting up the system environment
5. Starting the Agent
6. Shutting down the Agent

Automatic Agent Start when Booting the Operating System

The command file SYS$MANAGER:SYSTARTUP_VMS.COM is executed when the operating system boots. In order to start the VMS agent automatically with VMS, the agent's startup script is appended to the end of this command file. The command file (1) UC4$STARTUP.COM (if it exists) is called in the startup script.

Example startup script

$!

$ FILE = F$SEARCH("SYS$STARTUP:UC4$STARTUP.COM")

$ IF FILE .NES. ""

$ THEN

$    @SYS$STARTUP:UC4$STARTUP.COM

$ ENDIF

$!

The following parameters must be adjusted to the system environment in the supplied command file (1) UC4$STARTUP.COM:

The command file (1) UC4$STARTUP.COM calls the command file (2) UC4$STARTUP_BAT.COM. With the help of the command file UC$START.COM, the VMS agent will then start. Adjust the parameter UC4_COM if the name or directory of this supplied command file has been changed.

Comments