Installing the Agent for Database Variables

Installing the Agents

Installing the Agent for Java EE/JMX (Standalone)

---

Installing the Agent for GCOS8

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

The following guide describes how to install an agent in an AE system in which authentication is not used. Additional installation steps are required before the agent can be started and used if you intend to use one of the available authentication methods. For more information, see Advanced Security.

Requirements

RSM8 is required if the job's output will be transferred to AE.

Supplied Files

The files of the GCOS8 agent are available in binary and ASCII format. They are stored in the directory IMAGE:AGENTS\GCOS8.

Procedure

	1.	Creating the required catalogs

• Host
• Create a catalog for the installation (UC4/version).
• The following sub-catalogs are required in it: DATA, EXEC, INSTALL, JCL, OUT and TMP.

	2.	Transferring the files to the host

• Admin computer
• Transfer the files with FTP or Glink FTP to the corresponding sub-catalogs of the GCOS8 computer.

	3.	Setting up the system environment

• Host
• Adapt the INI file to the system environment.
• Important: Do not remove trace flags.
• Automic recommends setting the parameter TRCOPENCLOSE to "0" in order to ensure consistent agent performance.

• Host
• Adjust the files UC4EX and UC4TM to the system environment.

• Admin computer or user computer
• Adjust HEADER.GCOS8 and TRAILER.GCOS8 as needed.
  See: Job - Execution.

	4.	Transferring the job report

• Host
•  RSM8 must be installed in order to enable job report transfers to AE. If it has not been installed, the following settings must be configured or jobs will remain stuck.  
   

• Set the parameter RSM= in the INI file to either "N" or "X."
• The section [VARIABLES] of the INI file must contain the parameter UC_EX_PATH_JCL. Enter the JCL catalog name in that parameter.
• Adjust the file UC4SIM in the JCL catalog so that it contains the catalog in which the agent has been installed.

•  Note that files with the same name as the job report are created when RSM8 is not used. These files contain basic information, such as the job name or sequence number, which can be used to view the report in GCOS.
•  Important: Do not set the parameter RSM= when RSM8 is used.

	5.	Starting the Agent

• Host
• Start the agent with the JCL from the file UC4EX.

$      ident   <site-ident>
$      select  &system/profile.prod/uc4
$      select  &uc4cat/jcl/uc4exec.spn
$      endjob

• An Agent object will automatically be created in the system client 0000 and stored in the folder HOST.

• Admin computer or Server computer
• Verify that the agent has logged on.
• Start the UserInterface for client 0000. Call the agent information from the System Overview. Because a newly logged-on agent has not yet been assigned a client, it can only be viewed in the system client 0000. The newly installed agent can now be assigned to clients through the Agent object with all the required rights.

	6.	Shutting down the Agent

• Host
• Use the JCL from the file UC4TM to close the agent.

$      ident   <site-ident>
$      select  &system/profile.prod/uc4
$      select  &uc4cat/jcl/uc4term.spn
$      endjob