Installing the Agent for Databases

Installing the Agents

Installing the Agent for Java EE/JMX

---

Installing the Agent for GCOS8

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

Requirements

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

Supplied Files

The GCOS8 agent files 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 subcatalogs are required: 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 the system environment

• Host
• Adapt the INI file to the system environment.
  It is important to define an agent name (maximum of 32 characters) no special characters!) and to enter the system name. Also be sure to enter the address of the primary communication process in the section [TCP/IP] of the AE system to which the agent will connect. Use the following format: cp=DNS name:port number or  cp=TCP/IP address:port number.
• 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 transfer job reports to the Automation Engine. If it is not installed, it is important to configure the following settings in order to allow the job report file to be stored in the TMP subcatalog, because otherwise, job report transfer is not possible.  

• Host
• RSM8 must be installed in order to enable job report transfers to the Automation Engine. If it is not installed, the following settings must be configured, otherwise 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, that 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 is automatically 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