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.
The job limit must be specified with a number higher than zero in order to enable AE jobs to be performed in batch mode.
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.
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.
1. | Transferring the command file to the host |
---|
2. | Determining directories and authorizations |
---|
$ @UC$CRDIR
$DELETE UC$CRDIR.COM;*
The command file UC UC$CRDIR.COM creates all required 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 |
---|
$SET DEF [.BIN]
$SET DEF [-.CMD]
The name of the AE system and the agent name must be adjusted so that the logical name of the agent can be found.
You can also modify both files on the Admin computer before you transfer them.
$ rel_dir = ""
If the command file remains unchanged, the HOME directory is by default used to start the agent.
5. | Starting the Agent |
---|
$ @UC$START
Information about the task can be obtained in two ways:
By default, the process name is UC4_UC4.
$ SHOW PROC UC4_UC4
$ SHOW PROC/ID=Process ID
6. | Shutting down the Agent |
---|
$ @UC$STOP
$
STOP UC4_UC4
or
$ STOP PROC/ID=Process-ID
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