How to adapt the SA z/OS *SAPSRV add-on policy

Edit online

Read the described instructions and hints on what to observe when you need to adapt the *SAPSRV add-on policy to your environment.

To adapt the *SAPSRV add-on policy that is shipped with SA z/OS, it is recommended that you use the SAP High Availability wizard (SAP HA wizard). This wizard can generate an SA z/OS policy for a new SAP system. It also automates the bulk of the renaming and adaptation. For details about how to use the SAP HA wizard, see SAPHAwizard.pdf, which is included inside the ING_sap.tar file in the SA z/OS UNIX System Services directory /usr/lpp/ing/SAP.

ABAP and Java™ SCS are started by the start_cs script. It uses the sapcontrol executable, which is delivered by SAP to start the resources of the ABAP and Java SCS instances: enqueue server (ES), message server (MS), enqueue replication server (ERS), and gateway server (GW). With the *SAPSRV add-on policy, the central services components (EN, MS, GW, ERS) are no longer started directly as with the *SAP add-on policy. The sapcontrol executable issues a start request to the sapstartsrv service. The sapstartsrv service starts a sapstart process, which in turn finally starts the previously mentioned processes.

The sapstartsrv service that is associated with the ABAP and Java SCS is started by the start_sapsrv script. It also uses the sapcontrol executable that is delivered by SAP to start the sapstartsrv service of the associated ABAP and Java SCS instance. Both scripts are contained in the HA wizard tar-file and you must copy them to the home directory of the <sid>adm user.

If you implemented a network setup that is not based on dynamic routing as described in Alternative network setup, you must replace the dependencies to the OMPROUTE resource:

  • Replace the HasParent relationship of the SAP and NFS server resources to the OMPROUTE application by a HasParent to TCPIP
  • Change the ForceDown relationship of the SAP and NFS server resources to the OMPROUTE application to a ForceDown/WhenObservedAssumedDownOrStopping dependency to the TCPIP application