Java Development Kit (JDK) バージョン 1.5 以降を使用している場合、 WebSphere® eXtreme Scale インスツルメンテーション・エージェントを使用可能にすることで、 フィールド・アクセス・エンティティーのパフォーマンスを向上させることができます。
-javaagent:jarpath[=options]
jarpath 値は、eXtreme Scale エージェント・クラスおよびサポート・クラスが入っている eXtreme Scale ランタイムの Java アーカイブ (JAR) ファイル (objectgrid.jar、wsobjectgrid.jar、ogclient.jar、wsogclient.jar、および ogagent.jar ファイルなど) へのパスです。通常、スタンドアロン Java プログラム、または WebSphere Application Server を稼働していない Java Platform,
Enterprise Edition 環境では、objectgrid.jar ファイルまたは ogclient.jar ファイルを使用します。
WebSphere Application Server または複数クラス・ローダー環境では、Java コマンド行エージェント・オプションで ogagent.jar ファイルを使用する必要があります。
追加情報を指定するには、クラスパスに ogagent.config ファイルを指定するか、エージェント・オプションを使用します。-javaagent:objectgridRoot/lib/objectgrid.jar=config=myConfigFile;
include=includedPackage;exclude=excludedPackage;
fieldAccessEntity=package1,package2
-javaagent:objectgridRoot/lib/objectgrid.jar=config=myOverrideConfigFile
################################
# The # indicates comment line
################################
# This is an ObjectGrid agent config file (the designated file name is ogagent.config) that can be found and parsed by the ObjectGrid agent
# if it is in classpath.
# If the file name is "ogagent.config" and in classpath, Java program runs with -javaagent:objectgridRoot/ogagent.jar will have
# ObjectGrid agent enabled.
# If the file name is not "ogagent.config" but in classpath, you can specify the file name in config option of ObjectGrid agent
# -javaagent:objectgridRoot/lib/objectgrid.jar=config=myOverrideConfigFile
# See comments below for more info regarding instrumentation setting override.
# The first part of the configuration is the list of packages and classes that should be included in transformation domain.
# The includes (packages/classes, construct the instrumentation doamin) should be in the beginning of the file.
com.testpackage
com.testClass
# Transformation domain: The above lines are packages/classes that construct the transformation domain.
# The system will process classes with name starting with above packages/classes for transformation.
#
# @Exclude token : Exclude from transformation domain.
# The @Exclude token indicates packages/classes after that line should be excluded from transformation domain.
# It is used when user want to exclude some packages/classes from above specified included packages
#
# @FieldAccessEntity token: Field-access Entity domain.
# The @FieldAccessEntity token indicates packages/classes after that line are field-access Entity packages/classes.
# If there is no lilne after the @FieldAccessEntity token, it is equivalent to "No @FieldAccessEntity specified".
# The runtime will consider the user does not specify any field-access Entity packages/classes.
# The "field-acces Entity domain" is a sub-domain of transformation domain.
#
# Packages/classes listed in the "field-access Entity domain" will always be part of transformation domain,
# even they are not listed in transformation domain.
# The @Exclude, which lists packages/classes excluded from transformation, has no impact on the "field-acces Entity domain".
# Note: When @FieldAccessEntity is specified, all field-access entities must be in this field-acces Entity domain,
# otherwise, FieldAccessEntityNotInstrumentedException may occur.
#
# The default ObjectGrid agent config file name is ogagent.config
# The runtime will look for this file as a resource in classpath and process it.
# Users can override this designated ObjectGrid agent config file name via config option of agent.
#
# e.g.
# javaagent:objectgridRoot/lib/objectgrid.jar=config=myOverrideConfigFile
#
# The instrumentation definition, including transformation domain, @Exclude, and @FieldAccessEntity can be overriden individually
# by corresponding designated agent options.
# Designated agent options include:
# include -> used to override instrumentation domain definition that is the first part of the config file
# exclude -> used to override @Exclude definition
# fieldAccessEntity -> used to override @FieldAccessEntity definition
#
# Each agent option should be separated by ";"
# Within the agent option, the package or class should be seperated by ","
#
# The following is an example that does not override the config file name:
# -javaagent:objectgridRoot/lib/objectgrid.jar=include=includedPackage;exclude=excludedPackage;fieldAccessEntity=package1,package2
#
################################
@Exclude
com.excludedPackage
com.excludedClass
@FieldAccessEntity