Previous Topic: Establish Network ConnectivityNext Topic: Hardware Services (HWS)

Manage the Processors › Establish Network Connectivity › Use the API Directly

Use the API Directly

The OPSHMC program provides a high-level set of functions for the most common operations needed for managing processors. For more advanced automation, you might desire to write your own REXX programs, utilizing the underlying SE/HMC API.

WARNING! Be extremely cautious, because misuse of the API could cause an outage of an entire CPC.

CA OPS/MVS provides a set of external functions which makes this possible. However, each of the provided external functions corresponds to a function in the IBM DLL, and takes the same arguments as the corresponding IBM function.

Note: The functions and arguments are documented in the IBM System z9 and e-server Application Programming Interfaces manual (SB10-7030-07).

IBM Function

CA OPS/MVS Function

RxHwmcaLoadFuncs

OphmLoad

Note: Usage and arguments differ. OphmLoad accepts one parameter, which controls debugging output. Any value other than NO results in extensive debugging output.

RxHwmcsDefineVars

OphmVars

RxHwmcaInitialize

OphmInit

Note: Only one session may be initialized.

RxHwmcaGet

OphmGet

RxHwmcaGetNext

OphmNext

RxHwmcaSet

OphmSet

RxHwmcaWaitEvent

OphmWait

RxhwmcaTerminate

OphmTerm

RxHwmcaBuildId

OphmBldI

RxHwmcaBuiltAttributeId

OphmBldA

Examine the OPSHMC program for examples of using the API functions. If possible, make a copy of OPSHMC and adapt it to your needs.