sendTransientFileInfo

sendTransientFileInfo();

The sendTransientFileInfo method of the Process class requests a target process (the method receiver) to send a notification containing information regarding its transient database file.

The target process can be any current process, including the requesting process itself or a process executing on another node.

The target process is activated temporarily or interrupted in order to retrieve the transient database file information and send the notifications, after which it resumes whatever it was doing.

This sendTransientFileInfo method is asynchronous; that is, the method does not wait until the information is received. The information is received as a notification some time after the method is called.

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

Parameter Contains…
eventType Process_TDB_Info_Event
target Process instance of the process that made the request
userInfo A colon delimited string containing the process oid, transient database file name, and the transient database file length

Register to receive notifications of events of type Process_TDB_Info_Event (a global constant in the JadeProcessEvents category) on the process making the request using the beginNotification method defined in the Object class before executing the sendTransientFileInfo method, as shown in the following code fragment.

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

To test whether a notification contains transient database file information, the userNotification method should test whether the value of the eventType parameter is Process_TDB_Info_Event.

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