CEE3SRP—Set resume point

The CEE3SRP service sets the resume point at the next instruction in the calling routine. CEE3SRP works only in conjunction with the CEEMRCE service.


Syntax

>>-CEE3SRP--(--resume_token--,--fc--)--------------------------><

resume_token (output)

An INT4 data type that, upon completion of this service, contains a token that represents a machine state block, which Language Environment allocates from heap storage. Language Environment automatically frees the heap storage for the machine state block when the routine associated with the stack frame to which it points returns to its caller.

fc (output / optional)

A 12-byte feedback code, optional in some languages, that indicates the result of this service. If you choose to omit this parameter, refer to Invoking callable services for the appropriate syntax to indicate that the feedback code was omitted.

The following symbolic conditions can result from this service:

Code	Severity	Message number	Message text
CEE000	0	—	The service completed successfully.
CEE390	3	3360	The stack frame was not found on the call chain.

Usage notes

An example for Service Label under COBOL follows:

   SET-RECOVERY-POINT-PARAGRAPH.
      CALL 'CEE3SRP' USING RECOVERY-POINT FC.
      SERVICE LABEL.
   ERROR-PARAGRAPH.
* code to do post-error processing

Use the CEE3SRP service only with the CEEMRCE service from within a user condition handler. The token returned by this service is used as input to the CEEMRCE service.
Language Environment automatically frees the heap storage for the machine state block when the routine associated with the stack frame to which it points returns to its caller. Attempts to use the machine state block after it is freed result in unpredictable behavior.
COBOL considerations
- A Service Label compiler directive must be specified immediately after the call to CEE3SRP.
- When a resume occurs and control resumes to the next instruction following the call to CEE3SRP, the COBOL RETURN-CODE special register contains an unpredictable value.

Examples

For examples of how to use CEE3SRP in combination with CEEMRCE and CEEHDLR, see CEEMRCE—Move resume cursor explicit.