Allocate a pause element token using IEAVAPE

To aid in synchronization between the remote check task and IBM® Health Checker for z/OS®, you must allocate a pause element token (PET). The PET is used as follows:
  • You provide the PET to the system when the check routine issues an HZSADDCK service. When the routine issues an HZSCHECK service, the system returns the PET that the check routine needs to use when it pauses.
  • IBM Health Checker for z/OS uses the PET to tell the check to start running (using the IEAVRLS service)
Use the IEAVAPE service in your remote check routine to allocate a PET. Note that you can only use a PET in one pause/release cycle. Once a task is paused and released, you'll need the updated PET returned by IEAVPSE to pause the check routine next time.

You must always specify a value of IEA_UNAUTHORIZED for the auth_level parameter when your remote check issues the IEAVAPE service, even if the calling program is authorized.

See z/OS MVS Programming: Assembler Services Reference IAR-XCT for the IEAVAPE and IEAVPSE services and Synchronizing tasks in the z/OS MVS Programming: Assembler Services Guide.