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

The Process class sendTransientFileAnalysis method requests a target process to send one or more notifications containing detailed analysis of the transient database file, including counts of objects by class number and other useful information. (For details, see the Process class analyzeTransientFileUsage method.)

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 analyze the transient database file 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 sendTransientFileAnalysis method does not wait until the information has been received. The information is received as notifications some time after the sendTransientFileAnalysis method has been called.

The information in the notification relating to the analysis of the transient database file of the process is listed in the following table.

Parameter Contains …
eventType Process_TDB_Analysis_Event global constant in the JadeProcessEvents category
target Process instance of the process that made the request
userInfo Detailed analysis of the transient database file of the process

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

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

To determine whether a notification contains transient database file analysis, the userNotification receiving the notification should test whether the value of the eventType parameter is Process_TDB_Analysis_Event.

The size of the analyzed data 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.