You can use properties files to change transaction service
properties under a server.
Before you begin
Determine the changes that you want to make to your transaction
service 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
transaction service configuration properties.
Run administrative
commands using wsadmin to change a properties file for a transaction
service, validate the properties, and apply them to your configuration.
Table 1. Actions for transaction service
properties files. You can create, modify, and delete
transaction service properties.Action |
Procedure |
create |
Not available |
modify |
Edit properties and then run the applyConfigProperties command. |
delete |
Not available |
create Property |
Set properties and then run the applyConfigProperties command. |
delete Property |
Specify the properties to delete in the properties
file and then run the deleteConfigProperties command. |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create transaction service properties.
- Specify TransationService properties in a properties
file.
Open an editor and specify transaction service
properties under a server in a properties file. You can copy the following
example properties into an editor and modify the properties as needed
for your situation. The example shows a property under TransationService
with name myName and value myVal.
#
# SubSection 1.0 # TransactionService
#
ResourceType=TransactionService
ImplementingResourceType=TransactionService
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:TransactionService=
AttributeInfo=services
#
#
#Properties
#
httpProxyPrefix=
transactionLogDirectory=null
propogatedOrBMTTranLifetimeTimeout=300 #integer,required,default(0)
context=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer= #ObjectName(ApplicationServer),readonly
asyncResponseTimeout=30 #integer,required,default(30)
maximumTransactionTimeout=0 #integer,required,default(0)
acceptHeuristicHazard=false #boolean,default(false)
wstxURLPrefixSpecified=false #default(false)
waitForCommitOutcome=false #boolean,default(false)
totalTranLifetimeTimeout=120 #integer,required,default(0)
heuristicRetryLimit=0 #integer,required,default(0)
enable=true #boolean,default(false)
enableFileLocking=true #boolean,default(true)
secureWSTXTransportChain=null
enableLoggingForHeuristicReporting=false #boolean,default(false)
WSTransactionSpecificationLevel=WSTX_10 #ENUM(WSTX_11|WSTX_10),default(WSTX_10)
heuristicRetryWait=0 #integer,required,default(0)
httpsProxyPrefix=
LPSHeuristicCompletion=ROLLBACK #ENUM(MANUAL|COMMIT|ROLLBACK),default(ROLLBACK)
clientInactivityTimeout=60 #integer,required,default(0)
enableProtocolSecurity=true #boolean,default(true)
#
# SubSection 1.0.1 # TransactionService properties
#
ResourceType=TransactionService
ImplementingResourceType=TransactionService
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:TransactionService=
AttributeInfo=properties(name,value)
#
#
#Properties
#
myName=myVal
#
EnvironmentVariablesSection
#
#Environment Variables
cellName=WASCell06
serverName=myServer
nodeName=WASNode04
- Run the applyConfigProperties command
to create a TransationService 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 transaction service properties.
- Obtain a properties file for the transaction service
that you want to change.
You can extract a properties
file for a TransationService 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.
- Delete the transaction service properties.
To
delete one or more properties, specify only those properties to delete
in the properties file and run deleteConfigProperties.
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Results
You can use the properties file to configure and manage
the transaction service object.
What to do next
Save the changes to your configuration.