modifySCAExportJMSBinding command
Use the modifySCAExportJMSBinding command to change the attributes of a JMS export binding. This command applies to JMS bindings, WebSphere® MQ JMS bindings, and Generic JMS bindings.
The modifySCAExportJMSBinding command changes the JNDI name of one or more of the resources associated with a JMS export binding.
The following circumstances cause an SCACommandException to
be thrown:
- The module has no binding of the type specified.
- A resource of an invalid type is specified.
- A resource is specified that does not exist.
After using the command, save your changes to the
master configuration using one of the following commands:
- For Jython:
AdminConfig.save()
- For Jacl:
$AdminConfig save
Prerequisites
The following conditions must be met:
Location
Start the wsadmin scripting client from the install_root/profiles/deployment_manager_profile/bin directory.
Syntax
Required parameters
- -moduleName moduleName
- The name of the SCA module associated with the export.
- -export export
- The name of the export.
- -type jmsType
- The type of binding. Valid values are JMS, MQJMS, or generic.
Optional parameters
- -applicationName applicationName
- The name of the application.
- -connectionFactory connectionFactoryName
- The JNDI name of the connection factory.Note: This parameter is valid only in the following circumstances:
- The type parameter is set to generic
- The type parameter is set to MQJMS and a Version 6 application has been deployed to the runtime environment.
- -connectionFactoryResponse connectionFactoryName
- The JNDI name of the response connection factory.
- -connectionFactoryFailedEventReplay connectionFactoryName
- The JNDI name of the failed event replay connection factory.Note: This parameter is valid only if the type parameter is set to JMS or MQJMS and a Version 7 application has been deployed to the runtime environment.
- -sendDestination sendDestinationName
- The JNDI name of the send destination.
- -activationSpec activationSpecName
- The JNDI name of the activation specification. Note: This parameter is valid only in the following circumstances:
- The type parameter is set to JMS
- The type parameter is set to MQJMS and a Version 7 application has been deployed to the runtime environment.
- -listenerPort listenerPortName
- The JNDI name of the listener port. Note: This parameter is valid only in the following circumstances:
- The type parameter is set to generic
- The type parameter is set to MQJMS and a Version 6 application has been deployed to the runtime environment.
Example
To change the send destination of a JMS export binding called Export1 in a module called MyMod to MyDest:
- Jython example:
AdminTask.modifySCAExportJMSBinding('[-moduleName MyMod -export Export1 -type JMS -sendDestination MyDest]')
- Jacl example:
$AdminTask modifySCAExportJMSBinding {-moduleName MyMod -export Export1 -type JMS -sendDestination MyDest}