Manage the Processors › Establish Network Connectivity › Copy the API DLL

Previous Topic: Establish Network Connectivity

Next Topic: Use the API Directly

Copy the API DLL

The SE/HMC API DLL is provided by IBM. This DLL must be copied into the CA OPS/MVS hlq.USSLOAD library.

To copy the SE/HMC API DLL to the USSLOAD Library

  1. From your workstation, retrieve a copy of the z/OS version of the HWMCAAPI DLL. Instructions for obtaining the DLL are provided in the IBM System z9 and e-server Application Programming Interfaces manual (SB10-7030-07).
  2. Transfer HWMCAAPI to an HFS or zFS in compatibility mode directory (hfsdir) on the z/OS machine using FTP or IND$FILE; be certain to use binary transfer.
  3. LINK-EDIT the DLL into hlq.USSLOAD using the following JCL, which is provided in hlq.CNTL(INSTHWMC). 
    //INSTHWMC JOB
// SET BASEDIR='/hfsdir'                     < HFS containing DLL
// SET PRODPRFX='hlq'                        < Product HLQ
// SET DLL='HWMCAAPI'                         < DLL name
// SET BP1='AMODE=31,RMODE=ANY'               < Binder options
// SET BP2=',MAP,LET,LIST,RENT,TERM'          < More binder options
// SET BP3=',DYNAM=DLL,CASE=MIXED'            < More binder options
//BIND   EXEC PGM=IEWL,PARM='&BP1&BP2&BP3'
//SYSPRINT DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//SYSTERM  DD  SYSOUT=*
//SYSLMOD  DD  DISP=SHR,DSN=&PRODPRFX..USSLOAD
//DLLDD    DD  PATH='&BASEDIR/&DLL'
//SYSDEFSD DD  DUMMY
//SYSLIN   DD  *
  INCLUDE DLLDD
  NAME HWMCAAPI(R)
/*