Product Information > JADE Object Manager Guide > Chapter 4 - JADE System Instrumentation and Diagnosis > ProcesssendCallStackInfo Method
Process::sendCallStackInfo Method
sendCallStackInfo();

The Process class sendCallStackInfo method requests a target process to send one or more notifications containing information about the call stack of the receiver process. (See also "Process::getCallStackInfo Method", in the previous section.)

The target process is indicated by the Process instance used as the method receiver. The target object for the notification is the Process instance of the process making the request.

You can specify any current process as the target, including the requesting process itself and processes executing on other nodes.

To retrieve the call stack information and send the notifications, the target process is temporarily activated or interrupted. After sending the notifications, the target process resumes from the point at which it was activated or interrupted.

This method is asynchronous; that is, the sendCallStackInfo method does not wait until the information has been received. The information is received as notifications some time after the sendCallStackInfo method has been called.

The information in the notification relating to the process call stack is listed in the following table.

Parameter Contains …
eventType Process_Call_Stack_Info_Event global constant in the JadeProcessEvents category
target Process instance of the process that made the request
userInfo Call stack information stored within a String value

The process making the request should register to receive type Process_Call_Stack_Info_Event notifications on its Process instance, using the beginNotification method defined in the Object class before executing the sendCallStackInfo method, as shown in the following code fragment.

self.beginNotification(process, Process_Call_Stack_Info_Event,
                       Response_Continuous, 0);

To determine whether a notification contains call stack information, the userNotification method receiving the notification should test whether the value of the eventType parameter is Process_Call_Stack_Info_Event.

The size of the call stack information collected can be greater than the maximum allowed for notifications. When this situation occurs, the information is broken into parts and sent via multiple notifications.

Each delivered notification records positional information at the end of the string, in the following the format.

[process-oid:current-notification:total-number-of-notifications]

The following is an example of the positional information.

[187.5:1:3]

If the target process (the method receiver) is not a valid current process, exception 1128 (The target process is not valid) is raised.