Using the CONFCHG macro

You must code the following parameters on CONFCHG to request notification of dynamic I/O configuration changes in your installation:
  • The NOTIFY parameter to indicate that you want to be notified of I/O configuration changes
  • The CHGREQ parameter or the CHGCOMPL parameter:
    • Code the CHGREQ parameter if you want to be notified of requested or rejected I/O configuration changes that involve deleting a device or deleting a path to a device.
    • Code the CHGCOMPL parameter if you want to be notified of I/O configuration changes that completed successfully.
  • The EXIT parameter to identify the configuration change user exit routine that is to receive control
  • The TOKEN parameter to cancel the notification request

If you no longer want to be notified of changes, you must cancel any notification requests by issuing CONFCHG CANCEL. If you plan to cancel notification requests, you must code the TOKEN parameter when you issue CONFCHG NOTIFY. The system then returns a token that you use when you code CONFCHG CANCEL. If your program terminates, you must cancel the notification request. If recovery is done through percolation, you must cancel each notification request separately.

See z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN for information on how to code the CONFCHG macro.

Parent topic: Requesting notification of I/O configuration changes