Refreshing policy files for z/OS address spaces

Edit online

You can refresh the policy files for the address spaces of the System Data Engine and Data Streamer on z/OS® without restarting, which minimizes the data loss during the time the address space is stopped and restarted. You can dynamically add, modify, and delete data streams and subscribers.

About this task

If you have updated the policy files in the Configuration Tool, you can issue the MVS MODIFY command to the address spaces of the System Data Engine, and Data Streamer on z/OS to load the updated policy files dynamically.
Important:
  • It is recommended to back up the current policy files before making changes in the Configuration Tool, which allows you to fall back to the old policy if the updated policy cannot be refreshed because of unexpected errors. You can back up the old policy files by clicking the Duplicate icon Duplicate icon on the box for the policy in the Configuration Tool or running the cp shell command under z/OS Unix System Services.
  • The code that is used by the running of IBM Z® Common Data Provider address spaces cannot be refreshed. To refresh the code, restart the address spaces.
  • Only the content in the policy files can be refreshed. The policy files must be the same as what are specified in the started tasks. If a started task has been changed, you must restart the started tasks.
  • Be sure to refresh the policy files for all the address spaces on z/OS. If part of the address spaces are refreshed, data might not be collected and streamed correctly.

Procedure

To load the updated policy files for the address spaces of the System Data Engine, and Data Streamer, complete the following steps:

  1. If the address spaces are not reading the policy files from the Configuration Tool working directory, copy the policy files to the target directory where the policy files reside.
  2. Refresh the policy files for the Data Streamer address space.
    1. Issue the following MVS MODIFY command to the Data Streamer started task. 
      MODIFY procname,APPL=REFRESH
      For more information about running the Data Streamer, see Running the Data Streamer.
    2. If the policy file is refreshed successfully, you can see the HBO6213I and HBO6214I messages on the MVS console, Data Streamer JESMSGLG and STDOUT data sets. 
      HBO6213I The Data Streamer starts to receive and process data streams for the new policy.
HBO6214I The Data Streamer has modified the subscribers successfully.
  3. If the System Data Engine is running, refresh the policy files for the address space.
    1. Issue the following MVS MODIFY command to the System Data Engine started task. 
      MODIFY procname,REFRESH POLICY
      For more information about running the System Data Engine, see Running the System Data Engine.
    2. If the policy file is refreshed successfully, you can see the HBO0196I message on the MVS console, System Data Engine JESMSGLG and HBOOUT data sets. 
      HBO0196I The policy file for the System Data Engine is refreshed successfully.