Module openj9.dtfjview

Package com.ibm.jvm.dtfjview.spi

Interface ICombinedContext

All Superinterfaces:

IContext, IDTFJContext

All Known Implementing Classes:

CombinedContext

public interface ICombinedContext
extends IDTFJContext

A combined context is an extended DTFJ context which also contains a DDR context. This is to allow commands to be passed down the stack starting with DTFJ and then moving to DDR if necessary.

Method Summary

Modifier and Type	Method	Description
void	displayContext(IOutputManager out, boolean shortFormat)	Display the contexts which are present in the core file currently being analysed.
Object	getDDRIObject()	A handle to the underlying DDR interactive session
Throwable	getDDRStartupException()	Get the exception which was thrown when trying to start a DDR interactive session.
int	getID()	Contexts have a unique positive numeric identifier within a session.
boolean	isDDRAvailable()	Flag to indicate if an associated DDR context is available as well as the DTFJ one.
void	setAsCurrent()	Called when this context becomes the current context to allow any initialisation to take place.
void	setID(int id)	Sets the numeric ID for this context.

Methods declared in interface com.ibm.java.diagnostics.utils.IContext

execute, execute, execute, getCommands, getLastCommandException, getLastExecutedCommand, getPluginClassloader, getProperties, isCommandRecognised, refresh

Methods declared in interface com.ibm.java.diagnostics.utils.IDTFJContext

getAddressSpace, getImage, getMajorVersion, getMinorVersion, getProcess, getRuntime, hasPropertyBeenSet

Method Detail

getID

int getID()

Contexts have a unique positive numeric identifier within a session. This number always increases if new contexts are created via the open command rather than attempting to re-use any already used IDs.

Returns:

the ID for this context

setID

void setID(int id)

Sets the numeric ID for this context. This setter is provided so as to allow context creation before assigning the ID. However once set it should not be changed. Later implementations may enforce this.

Parameters:

id - the context ID

getDDRIObject

Object getDDRIObject()

A handle to the underlying DDR interactive session

Returns:

a valid session or null if the core file is not DDR enabled

getDDRStartupException

Throwable getDDRStartupException()

Get the exception which was thrown when trying to start a DDR interactive session.

Returns:

the exception or null if the session started without error.

displayContext

void displayContext(IOutputManager out,
                    boolean shortFormat)

Display the contexts which are present in the core file currently being analysed.

Parameters:

shortFormat - true for short format which just displays the first line of the java -version string

setAsCurrent

void setAsCurrent()

Called when this context becomes the current context to allow any initialisation to take place.

isDDRAvailable

boolean isDDRAvailable()

Flag to indicate if an associated DDR context is available as well as the DTFJ one.

Returns:

true if DDR is available