You can use properties files to create, modify, or delete
object cache Java 2 Platform,
Enterprise Edition (J2EE) resource custom properties.
Before you begin
Determine the changes that you want to make to your object
cache J2EE resource configuration.
Start the wsadmin scripting
tool. To start wsadmin using the Jython language, run the wsadmin
-lang Jython command from the bin directory
of the server profile.
About this task
Using a properties file, you can create, modify, or delete
object cache J2EE resource custom properties.
Run administrative
commands using wsadmin to change a properties file for an object cache
J2EE resource, validate the properties, and apply them to your configuration.
Table 1. Actions for object cache
J2EE resource properties. You can create, modify, and
delete object cache J2EE resource custom properties.Action |
Procedure |
create |
Not applicable |
modify |
Edit properties and then run the applyConfigProperties
command to modify the value of an existing custom property. |
delete |
Not applicable |
create Property |
Set properties and then run the applyConfigProperties
command to create a custom property. |
delete Property |
Specify the properties to delete in the properties
file and then run the deleteConfigProperties command to delete an
existing custom property. The properties file must contain only the
properties to be deleted. |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create object cache J2EE resource properties.
- Specify ObjectCacheInstance J2EEResourcePropertySet
custom properties in a properties file.
Open an editor
and specify object cache J2EE resource properties in a properties
file. You can copy the following example properties into an editor
and modify the properties as needed for your situation. To specify
a custom property, edit the AttributeInfo value and
properties values.
#
# Header
#
ResourceType=J2EEResourcePropertySet
ImplementingResourceType=ObjectCacheInstance
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:CacheProvider=myCacheProvider:
ObjectCacheInstance=jndiName#myObjectCacheJndiName:J2EEResourcePropertySet=
AttributeInfo=resourceProperties(name,value)
#
#Properties
#
existingProp=newValue
newProp=newValue
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
serverName=odr
nodeName=myNode03
- Run the applyConfigProperties command to create or change
an object cache J2EE resource configuration.
Running
the applyConfigProperties command applies the properties file to the
configuration. In this Jython example, the optional -reportFileName parameter
produces a report named report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- Modify existing object cache J2EE resource properties.
- Obtain a properties file for the object cache J2EE resource
that you want to change.
You can extract a properties
file for an ObjectCacheInstance J2EEResourcePropertySet using the
extractConfigProperties command.
- Open the properties file in an editor and change the
custom properties as needed.
Ensure that the environment
variables in the properties file match your system.
- Run the applyConfigProperties command.
- If you no longer need an object cache J2EE resource custom
property, you can delete the custom property.
To
delete one or more custom properties, specify only the properties
to delete in the properties file and then run the deleteConfigProperties
command; for example:
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Results
You can use the properties file to configure and manage
the object cache J2EE resource properties.
What to do next
Save the changes to your configuration.