Managing High Availability › How to Implement HA Automatic Restart Management › Modify the Started Task JCL for the ARM Wrapper

Modify the Started Task JCL for the ARM Wrapper

The CHRARMW utility is used for registering and deregistering the CA Chorus started tasks with the Automatic Restart Manager (ARM).

Members of chorus_runtime_hlq.CETJJCL contain commented steps to complete the following tasks:

• Register the started task with ARM before the main step execution (ARMREG).
• Deregister the started task with ARM after the main step has successfully terminated (ARMDEREG).

ARM uses the following process to determine whether to restart a started task:

• If the main step terminates with a non-zero condition code or abends, the ARMDEREG step does not execute.
• If either option occurs, ARM automatically restarts the started task after address space termination.
• The registration step specifies an element name. The default is the job name. Ensure that the element name corresponds to an element name in the ARM policy that was created in the previous step.

Note: If ARM is not enabled, you can rerun Automatic Configuration or can edit the jobs manually, as noted in this procedure. For Automatic Configuration details, see the Installation Guide.

Follow these steps:

1. Edit the ARM parameters in the CHORJBOS, CHORTSF, and CHORTSFR members in chorus_runtime_hlq.CETJJCL as described in the member and save your changes.

   The started task JCL is updated.

2. Copy the CHORJBOS and CHORTSF PROC into a specific PROCLIB for each eligible system. Edit both copies of CHORJBOS to match the configuration of the system.

   Note: If a TSF Engine (CHORTSF) is copied to an LPAR where a TSF relay (CHORTSFR) runs, stop the TSF relay to let the engine run.

3. If the failover system has different system values for the values in the ENV* members that are located in CETJOPTN, copy the ENV* members and reference them from the PROCLIB of each system.
4. If you have TSF relays on other LPARs, update their CETJOPTN(TSFRPRMS) member to point to the new TTSFHOST.
5. Restart the CHORTSF started task by entering the following console command:

   S CHORTSF
   

   When TSF is available, the following message appears on the z/OS console:

   N00503 *** TSF INITIALIZATION COMPLETE TSF ***

6. Restart the CHORTSFR started task on your remote LPARs, if applicable:

   S CHORTSFR
   

   A message indicating that TSFR initialized is logged.

7. Restart the CHORJBOS started task:

   S CHORJBOS
   

   The following message appears when JBoss startup is complete:

   ETJTC001I CA Chorus Startup Complete
   

You have successfully configured High Availability for CA Chorus using z/OS Automatic Restart Management.