Using Universal Agent to Publish to a SOA Workload - Windows and UNIX

Using Universal Agent to Publish to a SOA Workload - Windows and UNIX

Basic Structure of Using Universal Agent to Publish to a SOA Workload

The following figure illustrates the basic structure of using Universal Agent to publish to a SOA workload.

ucmd -script options.txt -script_type SERVICE -host [hostname or IP Address]  -userid username -pwd password -stdin 
     -localfile payload_file.txt

Command Line Options

The command line options used in this example are:

Option

Description

-script

File containing the options that instruct the container what type of workload publish

-script_type

Type of script specified by -script.

-host

hostname or IP Address of the UAC Container.

-userid

Valid username.

-pwd

Valid password for userid.

-stdin

Start of stdin options.

-localfile

Redirect the standard file from or to <filename>

The contents of the file options.txt define the type of workload being published to (see Example Workloads).

Components

/wiki/spaces/UA73/pages/3770270

/wiki/spaces/UA73/pages/3770241

Example Workloads

The following examples illustrate various workloads.

JMS ActiveMQ Workload

-jmsdestination dynamicQueues/Soatest2TestQueue1
-jmsconnectionfactoryname ConnectionFactory
-protocol JMS
-serviceurl tcp://soatest2:61616
-timeoutsec 120
-jmscontextfactoryname org.apache.activemq.jndi.ActiveMQInitialContextFactory
-mep Publish

Command Options

The command options used in this example are:

Option

Description

-jmsdestination

Name of the target JMS destination queue or topic for the JMS message.

-jmsconnectionfactoryname

Connection factory to be used to establish a connection to a JMS provider.

-protocol

Message protocol to be used for the current operation.

-serviceurl

URL (internet, network, or file-based) of the target workload.

-timeoutsec

Length of time to wait for the request to complete.

-jmscontextfactoryname

Java class name of the JMS providers initial context factory.

-mep

Message exchange pattern to be used for the current operation.

JMS Websphere Workload

-jmsdestination jms/Soatest2TestQueue1
-jmsconnectionfactoryname jms/SBSConnectionFactory
-protocol JMS
-serviceurl iiop://soatest2:2809
-timeoutsec 120
-jmscontextfactoryname com.ibm.websphere.naming.WsnInitialContextFactory
-jmspropertiesfile websphere_only.properties.xml
-mep Publish

Command Options

The command options used in this example are:

Option

Description

-jmsdestination

Name of the target JMS destination queue or topic for the JMS message.

-jmsconnectionfactoryname

Connection factory to be used to establish a connection to a JMS provider.

-protocol

Message protocol to be used for the current operation.

-serviceurl

URL (internet, network, or file-based) of the target workload.

-timeoutsec

Length of time to wait for the request to complete.

-jmscontextfactoryname

Java class name of the JMS providers initial context factory.

-jmspropertiesfile

Name and location of an XML document containing the JMS properties to be included in the JMS message.

-mep

Message exchange pattern to be used for the current operation.


Note

The preceding example utilizes a properties file that is located on the UAC server. The following illustrates the contents of the listed properties file:


<?xml version="1.0" encoding="UTF-8"?>
<sb:JMSProperties xmlns:sb="http://com.stonebranch/UAI/JMSProperties" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://com.stonebranch/UAC/JMSProperties 
JMSProperties.xsd ">
                        <sb:Property>
<sb:Name>jms.initialcontext.com.ibm.CORBA.ORBInit</sb:Name>
                                <sb:Value>com.ibm.ws.sib.client.ORB</sb:Value>
                        </sb:Property>
</sb:JMSProperties>

XD Workload

-xdcmd SUBMIT
-xdcmdid XDJOB1
-servicepassword xdservicepass
-protocol XDSOAP
-serviceurl http://soatest2:9080/LongRunningJobSchedulerWebSvcRouter/services/JobScheduler
-serviceusername xdusername
-timeoutsec 120
-mep REQUEST

Command Options

The command options used in this example are:

Option

Description

-xdcmd

Operation to submit to the WebSphere XD environment.

-xdcmdid

Used to correlate jobs.

-servicepassword

Password to be passed to the target workload for authentication.

-protocol

Message protocol to be used for the current operation.

-serviceurl

URL (internet, network, or file-based) of the target workload.

-serviceusername

User name to be passed to the target workload for authentication.

-timeoutsec

Length of time to wait for the request to complete.

-mep

Message exchange pattern to be used for the current operation.

MQ Series Workload

-mqqueuemanagername MyQueueManager
-mqqueuename UpsQaQueue
-mqhost soatest2
-mqchannel UpsQaChannel
-protocol mq
-timeoutsec 120
-mep publish

Command Options

The command options used in this example are:

Option

Description

-mqqueuemanagername

Name of the MQ QUEUE Manager.

-mqqueuename

Name of the MQ Queue to use.

-mqhost

Name of the server running MQSeries.

-mqchannel

Name of the MQ Queue to use.

-protocol

Message protocol to be used for the current operation.

-timeoutsec

Length of time to wait for the request to complete.

-mep

Message exchange pattern to be used for the current operation.