Previous Topic: Return CodesNext Topic: Entry Environment


XCMPGMXT Exit

The XCMPGMXT exit routine is called when a resource requester has made a conditional request for resource ownership for which control cannot be immediately granted. These are conditional ENQ/ISGENQ requests for which resource control is not immediately granted and the requester is not queued for resource control. For information on processing conflicts generated by unconditional ENQ/ISGENQ requests, see the discussion of the XCMCNFXT exit routine.

The processing in the XCMPGMXT exit routine takes place in the victim's address space and is based on the job name or TSO user ID of the 'victim' in the failed conditional resource request and not the job name or TSO user holding the target resource. The XCMPGMXT exit routine can influence the conflict processing for a specific resource requester by setting the appropriate flags in XCMPGMXP parameter list (field PGMX_FLG1). The XCMPGMXT exit routine should pass a return code value of 4 back to its caller when altering the conflict actions. If the goal of the installation user exit is to customize conflict message processing, you may want to use the XCMMSGXT or the XCMNFYXT exit points instead.