Create a directory (or select an existing directory) in which to save the package file.

Save the package file into that directory.

Uncompress and extract the installation files in the current working directory. The command to extract the files is:
 

zcat sb-soa-6.4.1.0-aix-5.3.tar.Z | tar xvf -

 
If your operating system does not support the zcat command, use the following command:
 

gunzip sb-soa-6.4.1.0-aix-5.3.tar.Z

 
The output of the gunzip command provides the following tar file:
tar -xvf sb-soa-6.4.1.0-aix-5.3.tar

After the extraction is complete, run the installation script, upsinst, which executes the installp command:
 

./upsinst

 
An installation log is written to file install.log in the current directory. upsinst automatically restarts the Universal Broker daemon, ubrokerd, at the end of the install.

From the license file that was sent to you by Stonebranch, Inc., add the license information to the following file:
/etc/universal/uacs.conf

Recycle Universal Broker using the following commands (cd to /opt/universal/ubroker)
 
First:
 

./ubrokerd stop

 
Then:
 

./ubrokerd start

Use Universal Query (cd to /opt/universal/bin) to validate that the Universal Application Container Server component of Universal Command Agent for SOA 6.4.x is running:
 
uquery -host localhost (or the name of your server)
 
The output should have the following format:
 

Component ID..............: 1360109684
 Component Name............: uac (Server)
 Component Description.....: Universal Application Container Server
 Component Version.........: 6.4.x Level 1 Release Build 101
 Component Type............: uac
 Component Process ID......: 23331000
 Component Start Time......: 18:14:42
 Component Start Date......: 02/05/15
 Component Command ID......: uac
 Component State...........: REGISTERED
 Component MGR UID.........:
 Component MGR Work ID.....:
 Component MGR Host Name...:
 Component MGR IP Address..:
 Component MGR Port........:
 Component Comm State......: ESTABLISHED
 Component Comm State Time.: 18:14:44
 Component Comm State Date.: 02/05/15
 Component MGR Restartable.: NO
 Component Comment.........:

Create the UCMD Manager JCL. This provides the UCMD Manager options, references to the MQ Connector options, and the payload. It has the following format:
 

//XXXXXXXX JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
000002 //*
000003 //***********************************************************
000004 //*MQ queue test for Publish
000005 //*UCMD is the proc that calls UC Manager
000006 //*LOGON is the DD with userid and passwd (can use encrypted)
000007 //*SCR is the script that contains the MQConnector information
000008 //* to connect to an MQ Broker*
000009 //*UNVIN provides the payload for the SCRIPT in SCR*
000010 //***********************************************************
000011 //*
000012 //*       JCLLIB ORDER=LIB.V3207.UNV.UNVCONF
000013 //*
000014 //UCMD     EXEC UCMDPRC
000015 //LOGON    DD DISP=SHR,DSN=USER123.UAC.LOGON(USER)
000016 //SCR      DD DISP=SHR,DSN=USER123.UAC.SCR(MQPUB)
000017 //UNVIN    DD DISP=SHR,DSN=USER123.UAC.PYL(MQPYL)
000018 //UNVOUT   DD SYSOUT=*
000019 //UNVERR   DD SYSOUT=*
000020 //SYSIN    DD  *
000021 -s scr
000022 -script_type SERVICE*
000023 -i ucaserver -f logon

Create the MQ Connector Command Options Data Set Member.
 
This member contains the UCA for SOA command options for the MQ Connector that specifies the required information to submit a job to the MQ environment. It is referenced with the SCR ddname and has the following format:
 

-protocol mq
-mep Publish
-mqhost MQHOST
-mqqueuemanagername MyQueueManager
-mqqueuename UpsQaQueue
-mqchannel UpsQaChannel
-timeoutsec 120

Create the Payload Data Set Member. This member contains the MQ message and is read in via STDIN.
 

 
Example:

000001 

000002 

Hello...this is a payload in an MQ message.

Create the UCMD script file (Mqopt) to contain the the UCA for SOA command options for the MQ Connector that specifies the required information to submit a job to the MQ environment.
 

Mqopt contains:
-protocol mq
-mep Publish
-mqhost MQHOST
-mqqueuemanagername MyQueueManager
-mqqueuename UpsQaQueue
-mqchannel UpsQaChannel
-timeoutsec 120

 
MQPayload.xml

Hello...this is a payload in an MQ message.

*

From a command prompt, execute the following command to send a message to an MQ Queue:
 

ucmd -script  Mqopt -script_type SERVICE -i ucaserver -u user -w user < MQPayload.xml

 
You can also execute the command using the Universal Command options for STDIN (-I for input and -F for file):

ucmd -script  Mqopt -script_type SERVICE -i ucaserver -u user -w user -I -F MQPayload.xml

 
Example output:
MQ message published successfully on destination UpsQaQueue.