You can use properties files to create, modify, or delete
mapping module properties of container managed persistence (CMP) connection
factories.
Before you begin
Determine the changes that you want to make to your CMP
connection factory mapping module 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
a CMP connection factory mapping module object.
Run administrative
commands using wsadmin to apply a properties file for a mapping module
to your configuration, validate the properties, or delete them.
Table 1. Actions for CMP connection
factory mapping module properties files. You can create,
modify, and delete mapping module properties.Action |
Procedure |
create |
Set required properties and then run the applyConfigProperties
command. |
modify |
Edit required properties and then run the applyConfigProperties
command. |
delete |
To delete the entire CMPConnectorFactory MappingModule
object, uncomment #DELETE=true and then run the deleteConfigProperties
command. |
create Property |
Not applicable |
delete Property |
Not applicable |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create a properties file for a CMPConnectorFactory MappingModule
instance.
- Set CMPConnectorFactory MappingModule properties as
needed.
Open an editor on a CMPConnectorFactory MappingModule
properties file. Modify the Environment Variables section to match
your system and set any property value that needs to be changed. To
specify a custom property, edit the AttributeInfo value
and properties values. An example CMPConnectorFactory MappingModule
properties file follows:
#
# Header
#
ResourceType=MappingModule
ImplementingResourceType=J2CResourceAdapter
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:J2CResourceAdapter=myJ2CResourceAdapter:
CMPConnectorFactory=jndiName#myCFJNDI:MappingModule=
AttributeInfo=mapping
#DELETE=true
#
#Properties
#
authDataAlias=myADA
mappingConfigAlias=myMCA
#
EnvironmentVariablesSection
#Environment Variables
cellName=myCell
nodeName=myNode
serverName=myServer
- Run the applyConfigProperties command to create or change
a mapping module 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 an existing properties file.
- Obtain a properties file for the mapping module that
you want to change.
You can extract a properties file
for a CMPConnectorFactory MappingModule object using the extractConfigProperties
command.
- Open the properties file in an editor and change the
properties as needed.
Ensure that the environment variables
in the properties file match your system.
- Run the applyConfigProperties command.
- If you no longer need the mapping module, you can delete
the entire mapping module object.
Specify DELETE=true in
the header section of the properties file and 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 mapping module object and its properties.
What to do next
Save the changes to your configuration.