Managing CMOS Processors › Communicating with CMOS Processors › Establishing Runtime Environment for HMC Console API

Establishing Runtime Environment for HMC Console API

CA Automation Point's Hardware Access Facility (HAF) and the APCMOSI Rexx program are remote console applications that interact with the HMC/SE from the Automation Point Desktop environment. As a remote HMC console application, CA Automation Point must have runtime access to the file named, hwmcawin.dll, an IBM provided Dynamic Link Library (DLL) that provides underlying support for the HMC console API. hwmcawin.dll is a 32-bit Windows dynamic link library containing the C language Data Exchange APIs and Commands API.

To prepare the runtime environment on the CA Automation Point server

1. Download the most current copy of the DLL file, hwmcawin.dll, from the IBM Resource website, www.ibm.com/servers/resourcelink onto the CA Automation Point server. The HMC/SE is also expected to run with a compatible version of the DLL files.
2. The DLL file must be accessible by the APCMOSI Rexx program at runtime. Copy the hwmcawin.dll file into a directory that is part of the search path. Note the directory where the hwmcawin.dll file is copied. The directory and file name are required for configuring HAF using Configuring Manager.
3. Whenever you upgrade the code level of your HMC/SE, also upgrade the copy of the DLL file residing on the CA Automation Point server.

For information on how to configure the HMC to use the console API, see the IBM System z Application Programming Interfaces manual (SB10-7030-11).

The following illustration shows how CA Automation Point supports the HMC Console API.