Editing JMS bindings on references and services of SCA composites using scripting (deprecated)

You can update a Java™ Message Service (JMS) binding on references and services for a Service Component Architecture (SCA) composite. Use scripts that edit composition units in business-level applications. The scripts edit resource and response resource settings of a binding.jms element.

Before you begin

An SCA composite that uses an existing JMS resource must be a composition unit in a business-level application. To edit settings for a JMS binding on references, the composite must have defined a reference in the JMS binding. Similarly, to edit settings for a JMS binding on services, the composite must have defined a service in the JMS binding.

About this task

After deployment of an SCA composite that uses JMS bindings, you can edit JMS binding resource or response resource settings that specify Java Naming and Directory Interface (JNDI) names.

Table 1. Editable settings of editCompUnit optional parameters . Run the editCompUnit command with a parameter that enables you to edit JMS binding resources.
editCompUnit parameter	Editable settings
-ReferenceJMSBindingResources	`destinationJNDIName` `connectionFactoryJNDIName`
-ServiceJMSBindingResources	`destinationJNDIName` `activationSpecJNDIName`
-ReferenceJMSBindingResponseResources	`responseDestinationJNDIName` `responseConnectionFactoryJNDIName`
-ServiceJMSBindingResponseResources	`responseDestinationJNDIName` `responseConnectionFactoryJNDIName`

The JMS resource that is used by the editCompUnit command must exist. The product does not dynamically create JMS resources when you edit a composition unit.

Procedure

Start the wsadmin scripting tool.

Edit the JMS binding on reference resources of an SCA composite composition unit.

Use the editCompUnit command with the -ReferenceJMSBindingResources optional parameter to edit settings of the Resource element that are defined in the JMS binding. The command has three parameters, -blaID, -cuID, and -ReferenceJMSBindingResources, all type String.

Using Jython:

AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResources 
[[componentName/referenceName destinationJNDIName connectionFactoryJNDIName
 .* .* .* .* .* .* .*]]]')

Using Jacl:

$AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResources 
componentName/referenceName destinationJNDIName connectionFactoryJNDIName
 .* .* .* .* .* .* .*}

Table 2. editCompUnit with -ReferenceJMSBindingResources command elements . Run the editCompUnit command with -ReferenceJMSBindingResources to edit JMS binding reference resources.
Variable	Description
`$`	is a Jacl operator for substituting a variable name with its value
`AdminTask`	is an object to run administrative commands with the wsadmin tool
`editCompUnit`	is an AdminTask command
`myBLA`	is the configuration ID of the SCA business-level application
`myCompUnit`	is the configuration ID of the SCA composite composition unit
`-ReferenceJMSBindingResources`	is an editCompUnit optional command parameter to update reference resources that are defined in the JMS binding
`componentName/referenceName`	is the name of the reference defined in the JMS binding Use the format component name, forward slash (/), and then reference name.
`destinationJNDIName`	is the JNDI name of a destination to which the JMS binding is connected
`connectionFactoryJNDIName`	is the JNDI name of a connection factory that the JMS binding uses to process request messages
`.*`	is a wildcard string for the default value of a binding setting. Specify `.*` for a setting that you cannot edit.

Edit the JMS binding on service resources of an SCA composite composition unit.

Use the editCompUnit command with the -ServiceJMSBindingResources optional parameter to edit settings of the Resource element that are defined in the JMS binding. The command has three parameters, -blaID, -cuID, and -ServiceJMSBindingResources, all type String.

Using Jython:

AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResources 
[[componentName/serviceName destinationJNDIName activationSpecJNDIName
 .* .* .* .* .* .* .*]]]')

Using Jacl:

$AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResources 
componentName/serviceName destinationJNDIName activationSpecJNDIName
 .* .* .* .* .* .* .*}

Table 3. editCompUnit with -ServiceJMSBindingResources command elements . Run the editCompUnit command with -ServiceJMSBindingResources to edit JMS binding service resources.
Variable	Description
`$`	is a Jacl operator for substituting a variable name with its value
`AdminTask`	is an object to run administrative commands with the wsadmin tool
`editCompUnit`	is an AdminTask command
`myBLA`	is the configuration ID of the SCA business-level application
`myCompUnit`	is the configuration ID of the SCA composite composition unit
`-ServiceJMSBindingResources`	is an editCompUnit optional command parameter to update service resources that are defined in the JMS binding
`componentName/serviceName`	is the name of the service defined in the JMS binding Use the format component name, forward slash (/), and then service name.
`destinationJNDIName`	is the JNDI name of a destination to which the JMS binding is connected
`activationSpecJNDIName`	is the JNDI name of an activation specification that the JMS binding uses to connect to a JMS destination to process request messages
`.*`	is a wildcard string for the default value of a binding setting. Specify `.*` for a setting that you cannot edit.

Edit JMS binding on reference response resources of an SCA composite composition unit.

Use the editCompUnit command with the -ReferenceJMSBindingResponseResources optional parameter to edit settings of the Resource element that are defined in the JMS binding. The command has three parameters, -blaID, -cuID, and -ReferenceJMSBindingResponseResources, all type String.

Using Jython:

AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResponseResources 
[[componentName/referenceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*]]]')

Using Jacl:

$AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResponseResources 
componentName/referenceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*}

Table 4. editCompUnit with -ReferenceJMSBindingResponseResources command elements . Run the editCompUnit command with -ReferenceJMSBindingResponseResources to edit JMS binding reference response resources.
Variable	Description
`$`	is a Jacl operator for substituting a variable name with its value
`AdminTask`	is an object to run administrative commands with the wsadmin tool
`editCompUnit`	is an AdminTask command
`myBLA`	is the configuration ID of the SCA business-level application
`myCompUnit`	is the configuration ID of the SCA composite composition unit
`-ReferenceJMSBindingResponseResources`	is an editCompUnit optional command parameter to update reference response resources that are defined in the JMS binding
`componentName/referenceName`	is the name of the reference defined in the JMS binding Use the format component name, forward slash (/), and then reference name.
`responseDestinationJNDIName`	is the JNDI name of a destination to which the JMS binding is connected
`responseConnectionFactoryJNDIName`	is the JNDI name of a connection factory that the JMS binding uses to process request messages
`.*`	is a wildcard string for the default value of a binding setting. Specify `.*` for a setting that you cannot edit.

Edit JMS binding on service response resources of an SCA composite composition unit.

Use the editCompUnit command with the -ServiceJMSBindingResponseResources optional parameter to edit settings of the Resource element that are defined in the JMS binding. The command has three parameters, -blaID, -cuID, and -ServiceJMSBindingResponseResources, all type String.

Using Jython:

AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResponseResources 
[[componentName/serviceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*]]]')

Using Jacl:

$AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResponseResources 
componentName/serviceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*}

Table 5. editCompUnit with -ServiceJMSBindingResponseResources command elements . Run the editCompUnit command with -ServiceJMSBindingResponseResources to edit JMS binding service response resources.
Variable	Description
`$`	is a Jacl operator for substituting a variable name with its value
`AdminTask`	is an object to run administrative commands with the wsadmin tool
`editCompUnit`	is an AdminTask command
`myBLA`	is the configuration ID of the SCA business-level application
`myCompUnit`	is the configuration ID of the SCA composite composition unit
`-ServiceJMSBindingResponseResources`	is an editCompUnit optional command parameter to update service response resources that are defined in the JMS binding
`serviceName`	is the name of the service defined in the JMS binding Use the format component name, forward slash (/), and then service name.
`responseDestinationJNDIName`	is the JNDI name of a destination to which the JMS binding is connected
`responseConnectionFactoryJNDIName`	is the JNDI name of a connection factory that the JMS binding uses to process request messages
`.*`	is a wildcard string for the default value of a binding setting. Specify `.*` for a setting that you cannot edit.

Results

After the editCompUnit command runs, information about references or services that are defined in the JMS binding of the SCA composite is displayed.

Examples

Suppose the MyJMSComposite composition unit is installed in the myBLA business-level application. Run the editCompUnit command to update JMS binding resources or response resources.

To specify the default value of a setting, use .*. Include a .* for each attribute in the step as a place holder. A step is, for example, -ReferenceJMSBindingResources[[...]]. The first attribute of the step is the componentName/service-referenceName that identifies the data row. The second attribute of the step is the editable destination JNDI name. The third attribute of the step is the editable connection factory JNDI name or activation specification JNDI name. The remaining seven attributes are .* values unless you want to specify a value.

Update reference resources using Jython:

AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ReferenceJMSBindingResources [[MyJMSBinding/myJMSService myDest myCF .* .* .* .* .* .* .*]]]')

Update service resources using Jython:

AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ServiceJMSBindingResources [[MyJMSBinding/myJMSService myDest myAS .* .* .* .* .* .* .*]]]')

Update reference response resources using Jython:

AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ReferenceJMSBindingResponseResources [[MyJMSBinding/myJMSService .* myCF .* .* .* .* .* .* .*]]]')

Update service response resources using Jython:

AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ServiceJMSBindingResponseResources [[MyJMSBinding/myJMSService .* myCF .* .* .* .* .* .* .*]]]')

Running the editCompUnit command updates settings for the element and returns the configuration ID of the composition unit; for example, WebSphere:cuname=MyJMSComposite.

What to do next

View the JMS binding references and services to ensure that the binding settings are as expected.