If the CALLRTM macro specifies TYPE=SRBTERM, system processing
is directed toward a specific preemptable SRB, identified by the SRBIDTOKEN
provided via IEAMSCHD. The following locking and work area requirements
apply to this form of CALLRTM:
- The caller may hold a lock, but none are required.
- TYPE=SRBTERM requires a 144-byte workarea that is not used as
a standard savearea (like the 72-byte workarea required by TYPE=ABTERM).
- An ASID should not be specified with TYPE=SRBTERM. The SRBIDTOKEN
provides the necessary information for the system to find the SRB.
- The target SRB is processed asynchronously and may terminate after
control has returned to the invoking program.
- RETRY specifies whether the caller's recovery routines can retry.
Specifying RETRY=NO will turn on the SDWACLUP bit and force all recovery
routines to percolate rather than retry.
- Preemptable SRBs can be protected from CALLRTM TYPE=SRBTERM,SRBIDTOKEN=token
addr by holding a lock or using the process-must-complete mode.
For TYPE=SRBTERM, set the high-order bit of the reason
code to 1 when you want to indicate that an SVCDUMP is not necessary
for the abend being issued. The system does not do anything special
with this bit, but recovery routines can use the information when
determining if they should request an SVCDUMP of the abend.