configSCAJMSForServer command

You can use the configSCAJMSForServer instead of the administrative console to configure a specific server to run Service Component Architecture (SCA) applications that use JMS resources. You can specify a number of commands in a file to batch a large number of configurations without having to navigate the administrative console panels.

The configSCAJMSForServer command is run using the AdminTask object of the wsadmin scripting client.

Use the following command to list all the SCA administrative commands.

Jython example:
```
AdminTask.help('[SCAAdminCommands]')
```
Jacl example:
```
$AdminTask help SCAAdminCommands
```

Use the following command to get detailed help on a particular command.

wsadmin> $AdminTask help command_name

Jython example:
```
AdminTask.help('[command_name]')
```
Jacl example:
```
$AdminTask help command_name
```

Use the configSCAJMSForServer command to prepare a server to support SCA applications that use JMS resources. This wsadmin command is an alternative to using the administrative console to perform the configuration.

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
```

Required Parameters

-nodeName nameofnode: A required parameter that identifies the node to which the server belongs.
-serverName nameofserver: A required parameter that identifies the server you are configuring

Optional Parameters

-appBusDataSource SCAApplicationBusSource

An existing data source that you are using for the SCA.APPLICATION bus.

-appBusSchemaName appMEBusSchema

The schema name for the SCA.APPLICATION bus messaging engine. The default for this parameter is IBMWSSIB.

-createTables true | false

An optional parameter that specifies whether to create tables for the messaging engine data store. The default value for this parameter is true.

-meAuthAlias userid

An existing authentication alias used to access the messaging engine.

-remoteMELocation remoteMELocation

The location of a remote messaging engine. Specify this parameter if the SCA modules deployed on this server are to use their queue destinations hosted on a messaging engine in another server or cluster.

Specify remoteMELocation in one of the following ways:

WebSphere:cluster=clustername
WebSphere:node=nodeName,server=serverName

Examples

The following example illustrates how to configure the server mySCAAppServer on node NYServerFarm for SCA JMS using the remote messaging engine NJMECluster:

Jython example:

AdminTask.configSCAJMSForServer('[-serverName mySCAAppServer 
   -nodeName NYServerFarm -remoteMELocation WebSphere:cluster=NJMECluster 
   -meAuthAlias mySCAAlias -appBusSchemaName NYSysSchema]')

Jacl example:

$AdminTask configSCAJMSForServer {-serverName mySCAAppServer 
   -nodeName NYServerFarm -remoteMELocation WebSphere:cluster=NJMECluster 
   -meAuthAlias mySCAAlias -appBusSchemaName NYSysSchema}

The following example illustrates how to configure the server newSCAAppServer on node bgmServerFarm for SCA JMS using a local messaging engine.

Jython example:

AdminTask.configSCAJMSForServer('[-serverName newSCAAppServer 
   -nodeName bgmServerFarm 
   -appBusDataSource jdbc/com.ibm.ws.sib/SCA.APPLICATION.bgmServerFarm.Cell.Bus
   -appBusSchemaName BGMSysSchema]')

Jacl example:

$AdminTask configSCAJMSForServer {-serverName newSCAAppServer 
   -nodeName bgmServerFarm 
   -appBusDataSource jdbc/com.ibm.ws.sib/SCA.APPLICATION.bgmServerFarm.Cell.Bus
   -appBusSchemaName BGMSysSchema}