You can use properties files to change work area service
configuration objects and custom properties.
Before you begin
Determine the changes that you want to make to your work
area service configuration objects or custom properties.
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 modify or delete a work
area service object. You can also create, modify, or delete work area
service custom properties.
Run administrative commands using
wsadmin to change a properties file for a work area service, validate
the properties, and apply them to your configuration.
Table 1. Actions for work area service
configuration objects. You can modify and delete work
area service objects.
Action |
Procedure |
create |
Not applicable |
modify |
Edit properties and then run the applyConfigProperties command. |
delete |
Run the deleteConfigProperties command.
Deleting a property sets the default value, if there is a default
value for the property |
create Property |
Not applicable |
delete Property |
Not applicable |
Table 2. Actions for
work area service custom properties. You can create,
modify, and delete work area service 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
- Edit a work area service properties file.
- Set WorkAreaService object properties as needed.
Open an editor on a WorkAreaService properties file. Modify
the Environment Variables section to match your system and set any
property value that needs to be changed. An example WorkAreaService
properties file follows:
#
# Header
#
ResourceType=WorkAreaService
ImplementingResourceType=PMEServerExtension
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:PMEServerExtension=:WorkAreaService=
AttributeInfo=workAreaService
#
#
#Properties
#
maxReceiveSize=10000 #integer,required,default(32768)
enable=false #boolean,default(false)
context=null
maxSendSize=10000 #integer,required,default(32768)
enableWebServicePropagation=false #boolean,default(false)
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
serverName=server1
nodeName=myNode05
- Set WorkAreaService custom properties as needed.
To specify a custom property, edit the AttributeInfo value
and properties values; for example:
#
# Header
#
ResourceType=WorkAreaService
ImplementingResourceType=PMEServerExtension
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:PMEServerExtension=:WorkAreaService=
AttributeInfo=properties(name,value)
#
#
#Properties
#
existingProp=value
newProp=newValue
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
serverName=server1
nodeName=myNode05
- Run the applyConfigProperties command
to change a work area service 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'])
- If you no longer need the work area service or an existing
custom property, you can delete the entire work area service object
or the custom property.
Results
You can use the properties file to manage the work area
service object and its properties.
What to do next
Save the changes to your configuration.