Return the Relative Invocation Number (CEE4RIN) API


  Required Parameter Group:

1 rel_inv Output INT4
2 inv Input INVPTR

  Omissible Parameter:

3 fc Output FEEDBACK

  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

The Return the Relative Invocation Number (CEE4RIN) API retrieves the relative invocation number of an invocation pointer, and returns it in rel_inv.


Authorities and Locks

None.


Required Parameter Group

rel_inv (output)
The relative invocation number. This is a positive number indicating the number of invocations back from the caller that inv occurs.

inv (input)
An invocation pointer.


Omissible Parameter

fc (output)
A 12-byte feedback code.

Feedback Codes and Conditions

CEE0000 The API completed successfully
Severity: 00  
CEE3104 The pointer type in &1 is not valid
Severity: 30  
CEE3105 The call stack entry given to &1 no longer exists
Severity: 30  
CEE9902 Unexpected user error occurred in &1
Severity: 30  

Usage Notes

The invocation specified by inv must appear in the call stack for the job issuing the CEE4RIN API.


API introduced: V2R3
Top | ILE CEE APIs | APIs by category