Module openj9.dtfj

Package com.ibm.dtfj.javacore.builder.javacore

Class ImageProcessBuilder

java.lang.Object

com.ibm.dtfj.javacore.builder.javacore.AbstractBuilderComponent

com.ibm.dtfj.javacore.builder.javacore.ImageProcessBuilder

All Implemented Interfaces:

IImageProcessBuilder

public class ImageProcessBuilder
extends AbstractBuilderComponent
implements IImageProcessBuilder

Constructor Summary

Constructors

Constructor	Description
ImageProcessBuilder(JCImageAddressSpace imageAddressSpace, String id)

Method Summary

Modifier and Type	Method	Description
void	addEnvironmentVariable(String name, String value)	Add environment variables
ImageSection	addImageStackSection(ImageThread thread, ImageSection section)	Add a stack section to an existing image thread
ImageThread	addImageThread(long nativeThreadID, long systemThreadID, Properties properties)	Adds a com.ibm.dtfj.image.ImageThread to the Image process being built.
IJavaRuntimeBuilder	generateJavaRuntimeBuilder(String id)	Generates a new java runtime factory.
void	setCommandLine(String cmdLine)	Set command line
void	setPointerSize(int size)	Valid values: 64, 32, or 31 (s390) bits.
void	setRegisters(Map regs)	Set registers if available in javacore.
void	setSignal(int signal)	Set signal

Methods declared in class com.ibm.dtfj.javacore.builder.javacore.AbstractBuilderComponent

getBuilderContainer, getID

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods declared in interface com.ibm.dtfj.javacore.builder.IImageProcessBuilder

addImageStackFrame, addLibrary, addProperty, addRoutine, getCurrentJavaRuntimeBuilder, getJavaRuntimeBuilder, setCurrentThreadID, setExecutable, setID

Constructor Detail

ImageProcessBuilder

public ImageProcessBuilder(JCImageAddressSpace imageAddressSpace,
                           String id)
                    throws JCInvalidArgumentsException

Throws:

JCInvalidArgumentsException

Method Detail

generateJavaRuntimeBuilder

public IJavaRuntimeBuilder generateJavaRuntimeBuilder(String id)
                                               throws BuilderFailureException

Description copied from interface: IImageProcessBuilder

Generates a new java runtime factory. If generation fails, an exception is thrown. If the java runtime factory already exists, it returns the latter.

Specified by:

generateJavaRuntimeBuilder in interface IImageProcessBuilder

Parameters:

id -

Returns:

generated java runtime factory.

Throws:

BuilderFailureException - if java runtime factory is not created.

setPointerSize

public void setPointerSize(int size)

Description copied from interface: IImageProcessBuilder

Valid values: 64, 32, or 31 (s390) bits.

Specified by:

setPointerSize in interface IImageProcessBuilder

Parameters:

size -

addImageThread

public ImageThread addImageThread(long nativeThreadID,
                                  long systemThreadID,
                                  Properties properties)
                           throws BuilderFailureException

Description copied from interface: IImageProcessBuilder

Adds a com.ibm.dtfj.image.ImageThread to the Image process being built. If the arguments are invalid and a valid ImageThread cannot be constructed, error occurs.

If the thread already exists, it will populate any missing data into the image thread, and return the latter.

If the thread does not exist, it will create a new ImageThread and register it with the image process being built.

Specified by:

addImageThread in interface IImageProcessBuilder

Parameters:

Properties - with String key and String value

Returns:

generated ImageThread. Must not be null. If a valid image thread cannot be created or found, throw exception.

Throws:

BuilderFailureException - if valid image thread was not created or found/updated.

setSignal

public void setSignal(int signal)

Set signal

Specified by:

setSignal in interface IImageProcessBuilder

Parameters:

signal - number

setCommandLine

public void setCommandLine(String cmdLine)

Set command line

Specified by:

setCommandLine in interface IImageProcessBuilder

Parameters:

command - line string

addImageStackSection

public ImageSection addImageStackSection(ImageThread thread,
                                         ImageSection section)

Add a stack section to an existing image thread

Specified by:

addImageStackSection in interface IImageProcessBuilder

Parameters:

thread - The native thread

section - The section we want to add

Returns:

setRegisters

public void setRegisters(Map regs)

Set registers if available in javacore.

Specified by:

setRegisters in interface IImageProcessBuilder

Parameters:

regs - Map of registers

addEnvironmentVariable

public void addEnvironmentVariable(String name,
                                   String value)

Add environment variables

Specified by:

addEnvironmentVariable in interface IImageProcessBuilder

Parameters:

name -

value -