Previous Topic: Configure Hardware Services (HWS)Next Topic: Configure Linux Connector Interface (LXC)


HWS Parameters

To activate HWS, set the INITHWS parameter to YES:

OPSPRM('SET','INITHWS','YES')

Setting INITHWS to YES activates the general CA OPS/MVS Hardware Services component. This component includes both the use of address HWS host command environment, and the processing of HWS hardware events. In order to activate hardware event notification, parameter HWSRULES must also be set to YES:

OPSPRM('SET','HWSRULES','YES')

When HWSRULES is set to YES, HWS provides hardware event notifications in the form of API events. These events can be automated through )API rules.

HWS can be activated and deactivated at anytime through the initialization parameters.

For detail information on hardware event types and associated variables that are available through HWS event notification, see "Hardware Event API Rules" in the CA OPS/MVS AOF Rules User Guide.

Note: For the address HWS environment, INITHWS is the only required parameter. We recommend that HWSRULES is set to YES as the response to actions taken through this address environment are returned as event notifications. For more information on the address HWS environment, see "Address HWS Commands" in the CA OPS/MVS Command and Function Reference.

Note: If you are changing the value of INITHWS from NO to YES after CA OPS/MVS initialization, you must issue the z/OS command: MODIFY OPSS,RESTART(HWS) for the new value to take effect (where OPSS is the CA OPS/MVS subsystem name).

For more information on the INITHWS and HWSRULES parameters, see "Hardware Services (HWS)" in the CA OPS/MVS Parameter Reference Guide.

Since hardware events are presented as OPS )API events, the OPS API interface must also be activated to receive the hardware events. To activate the OPS API interface, set the OPS APIACTIVE parameter to YES:

OPSPRM('SET','APIACTIVE','YES')

For more information on the APIACTIVE parameter, see "Application Programming Interface Parameters" in the CA OPS/MVS Parameter Reference Guide.

For general information on coding API rules and specific information for coding hardware event API rules, see "Generic Event Application Program Interface" in the CA OPS/MVS AOF Rules User Guide.

To have CA OPS/MVS generate HWS-related trace messages, set the DEBUGHWS parameter to ON:

OPSPRM('SET','DEBUGHWS','ON')

Setting up the Hardware Interface Service

HWS utilizes the Hardware Interface Service. The Hardware Interface Service provides CA Technologies products with a common interface/API for accessing hardware functions. CA OPS/MVS interfaces with the Hardware Interface Service to implement its HWS functions. Therefore, the Hardware Interface Service must be configured and started on the system where CA OPS/MVS is running in order for HWS to provide services such as hardware event notification.

Install and Configure the Hardware Interface Service

See the CA Common Services for Z/OS Installation Guide for information about installation, configuration, and operation of the Hardware Interface Service.