Page Comparison

...

Inbound SOAP Request UAC.xml (UNIX)

<?xml version="1.0" encoding="UTF-8"?

>
<sb:UAC xmlns:sb="http://com.stonebranch/UAC/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://com.stonebranch/UAC/ UAC.xsd"

>
  

<sb:SOAPConnection>
        

<sb:URI>/axis2/services/

UACInbound</sb:

URI>
        

<sb:Listeners>
            

<sb:SOAPListener>
                

<sb:Operation>process</sb:

Operation>
                

<sb:Actions>
                    

<sb:SOAPFileWriter>
                        

<sb:Directory>/export/home/control/indesca/soap_listener/

</sb:

Directory>
                        

<sb:FilenamePattern>process_%Seq%.

xml</sb:

FilenamePattern>
                        

<sb:StartSequenceNumber>1</sb:

StartSequenceNumber>
                        

<sb:WriteEnvelope>false</sb:

WriteEnvelope>
                    

</sb:

SOAPFileWriter>
                

</sb:

Actions>
            

</sb:

SOAPListener>
        

</sb:

Listeners>
    

</sb:

SOAPConnection>
</sb:

UAC>

...

Inbound SOAP Request UAC.xml (Windows)

<?xml version="1.0" encoding="UTF-8"?

>
<sb:UAC xmlns:sb="http://com.stonebranch/UAC/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://com.stonebranch/UAC/ UAC.xsd"

>
  

<sb:SOAPConnection>
        

<sb:URI>/axis2/services/

UACInbound</sb:

URI>
        

<sb:Listeners>
            

<sb:SOAPListener>
                

<sb:Operation>process</sb:

Operation>
                

<sb:Actions>
                    

<sb:SOAPFileWriter>
                        

<sb:Directory>c:\tmp\

</sb:

Directory>
                        

<sb:FilenamePattern>process_%Seq%.

xml</sb:

FilenamePattern>
                        

<sb:StartSequenceNumber>1</sb:

StartSequenceNumber>
                        

<sb:WriteEnvelope>false</sb:

WriteEnvelope>
                    

</sb:

SOAPFileWriter>
                

</sb:

Actions>
            

</sb:

SOAPListener>
        

</sb:

Listeners>
    

</sb:

SOAPConnection>
</sb:

UAC>

...

The following shows an example of the inbound message payload written to the process_%Seq%.xml file.

<?xml version='1.0' encoding='utf\-8'?

><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org2001/XMLSchema-instance" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"

>
<soapenv:Body>
<NS1:process xmlns:NS1="http://inbound.uac.stonebranch.com"

>
<NS1:identitySourceApplicationId>RBS</NS1:identitySourceApplicationId><NS1:identitySourceUserId /

>
<NS1:identitySourcePassword /

><NS1:identitySourceToken /

>
<NS1:activityRequestId>AUT4210021109265970293000</NS1:

activityRequestId>
<NS1:activityStatus>PROCESS CLOSE ACCOUNTING YYYY 

MM</NS1:

activityStatus>
<NS1:activityState>ACCOUNTING MONTH CLOSING 

INPROGRESS</NS1:

activityState>
<NS1:activityStateReason>INFO</NS1:

activityStateReason>
<NS1:activityAction>ODPT0001</NS1:

activityAction>
<NS1:activityStartDate>2010-02-

24</NS1:

activityStartDate>
<NS1:activityStartTime>08:35:42.

397382</NS1:

activityStartTime>
</NS1:

process>
</soapenv:

Body>
</soapenv:

Envelope>

...

The following figure illustrates the event definition that Universal Event Monitor uses to detect the file created by Universal Event Monitor for SOA.

BEGIN_EVENT
  EVENT_ID          "ABC SOA EVENT"                                                
  EVENT_TYPE        FILE                                                           
  COMP_NAME         UEMS                                                           
  STATE             ENABLE                                                         
  TRACKING_INT      10                                                             
  TRIGGERED_ID      "ABC SOA HANDLER"                                                                                              
  FILESPEC          "/export/home/ control/indesca/soap_listener/*.*"       
  MIN_FILE_SIZE     0                                                              
  RENAME_FILE       YES                                                            
  RENAME_FILESPEC   "/export/home/ control/indesca/soap_listener/$(origname).$(origext)"                                                
END_EVENT

Anchor
1136015 1136015

Event Definition Options

...

...

...

...

...

Loading the Event Definition

...

<pre>
/opt/universal/bin/uemload -add -deffile event_definition.txt
</pre>

...

...

...

...

Changing the Event Definition

Alternatively, changes to the event definition can be effected using the following command:

<pre>
/opt/universal/bin/uemload -update -deffile event_definition.txt
</pre>

...

...

...

...

Inbound SOAP Request - Universal Event Monitor Handler Definition

...

<pre>
BEGIN_HANDLER
  HANDLER_ID      "ABC SOA HANDLER"                                                     
  ACTION_TYPE     CMD                                                            
  MAXRC           0                                                              
  USERID          "control"                                                          
  PWD             "UACL"                                                   
  BEGIN_SCRIPT                                                           
    STMT "#!/usr/bin/ksh"                                                 
   STMT "exec > /export/home/control/indesca/abc.log 2>&1"                                      
   STMT "set -xv"                                                                                                              
    STMT "/opt/universal/bin/ucmd -script /export/home/control/indesca/abc.rexx \"   
    STMT "< $UEMRENAMEDFILE \"
    STMT "-HOST mvstcp5 -USERID CTLMNT -PWD UACL "
    STMT ">> /export/home/control/indesca/abc.log \"
    STMT "2>&1"
    STMT "if [ $? -gt 0 ]"
    STMT " then"
    STMT "  mv $UEMRENAMEDFILE $UEMORIGFILE"
    STMT " else"
    STMT "  rm $UEMRENAMEDFILE"
    STMT "fi"
    STMT "exit $rc"                                                            
  END_SCRIPT 
END_HANDLER   
</pre>

...

• uem_handler control,allow,noauth

...

1. Connect to the z/OS mainframe.
2. Execute a REXX script to parse the required information from the process_%Seq%.xml file.
3. Execute the Universal Write-to-Operator utility to write the required console message.

...

Outbound SOAP Request - abc.rexx

...

<pre>
/* REXX */                            
TRACE R                       
  ABC.XML = LINEIN()               

parse value ABC.XML with "&lt;NS1:activityAction&gt;" ABC.ACTN "&lt;/NS1:activityAction&gt;"                   
  
parse value ABC.XML with "&lt;NS1:identitySourceApplicationId&gt;" ABC.APID "&lt;/NS1:identitySourceApplicationId&gt;"                        

parse value ABC.XML with "&lt;NS1:activityRequestId&gt;" ABC.RQID "&lt;/NS1:activityRequestId&gt;"            

ABC.UWTO = "EIEOSRAT "ABC.ACTN ABC.APID ABC.RQID       

'/usr/lpp/universal/bin/uwto -msg "'ABC.UWTO'"'   
ABC.RC = RC

EXIT ABC.RC
</pre>

...

• ucmd_access ALL,*,CTLMNT,allow,noauth

...

Outbound SOAP Request - Event and Handler to purge abc.log

...

<pre>
BEGIN_EVENT
  EVENT_ID        "ABC LOG FILE CLEANUP"                                                
  EVENT_TYPE      FILE                                                           
  COMP_NAME       UEMS                                                           
  STATE           ENABLE                                                         
  TRACKING_INT    10       
  TRIGGERED_ID    "ABC LOG FILE CLEANUP"                                                      
  FILESPEC        "/export/home/control/indesca/abc.log"       
  MIN_FILE_SIZE   10M                                                              
END_EVENT                    

BEGIN_HANDLER
  HANDLER_ID      "ABC LOG FILE CLEANUP"                                                     
  HANDLER_TYPE     CMD                                                            
  MAXRC           0                                                              
  USERID          "control"                                                          
  PWD             "UACL"                                                   
  CMD             "rm /export/home/control/indesca/abc.log"
END_HANDLER  
</pre>

...

...

...

...

...

...

Loading the Event Definition

/opt/universal/bin/uemload -add -deffile event_definition.txt

Anchor
1136015 1136015

Command Line Options

Changing the Event Definition

Alternatively, changes to the event definition can be effected using the following command:

/opt/universal/bin/uemload -update -deffile event_definition.txt

Anchor
1136015 1136015

Command Line Options

Inbound SOAP Request - Universal Event Monitor Handler Definition

BEGIN_HANDLER
  HANDLER_ID      "ABC SOA HANDLER"                                                     
  ACTION_TYPE     CMD                                                            
  MAXRC           0                                                              
  USERID          "control"                                                          
  PWD             "UACL"                                                   
  BEGIN_SCRIPT                                                           
    STMT "#!/usr/bin/ksh"                                                 
   STMT "exec > /export/home/control/indesca/abc.log 2>&1"                                      
   STMT "set -xv"                                                                                                              
    STMT "/opt/universal/bin/ucmd -script /export/home/control/indesca/abc.rexx \"   
    STMT "< $UEMRENAMEDFILE \"
    STMT "-HOST mvstcp5 -USERID CTLMNT -PWD UACL "
    STMT ">> /export/home/control/indesca/abc.log \"
    STMT "2>&1"
    STMT "if [ $? -gt 0 ]"
    STMT " then"
    STMT "  mv $UEMRENAMEDFILE $UEMORIGFILE"
    STMT " else"
    STMT "  rm $UEMRENAMEDFILE"
    STMT "fi"
    STMT "exit $rc"                                                            
  END_SCRIPT 
END_HANDLER   

• uem_handler control,allow,noauth

1. Connect to the z/OS mainframe.
2. Execute a REXX script to parse the required information from the process_%Seq%.xml file.
3. Execute the Universal Write-to-Operator utility to write the required console message.

Outbound SOAP Request - abc.rexx

/* REXX */                            
TRACE R                       
  ABC.XML = LINEIN()               

parse value ABC.XML with "<NS1:activityAction>" ABC.ACTN "</NS1:activityAction>"                   
  
parse value ABC.XML with "<NS1:identitySourceApplicationId>" ABC.APID "</NS1:identitySourceApplicationId>"                        

parse value ABC.XML with "<NS1:activityRequestId>" ABC.RQID "</NS1:activityRequestId>"            

ABC.UWTO = "EIEOSRAT "ABC.ACTN ABC.APID ABC.RQID       

'/usr/lpp/universal/bin/uwto -msg "'ABC.UWTO'"'   
ABC.RC = RC

EXIT ABC.RC

• ucmd_access ALL,*,CTLMNT,allow,noauth

Outbound SOAP Request - Event and Handler to purge abc.log

BEGIN_EVENT
  EVENT_ID        "ABC LOG FILE CLEANUP"                                                
  EVENT_TYPE      FILE                                                           
  COMP_NAME       UEMS                                                           
  STATE           ENABLE                                                         
  TRACKING_INT    10       
  TRIGGERED_ID    "ABC LOG FILE CLEANUP"                                                      
  FILESPEC        "/export/home/control/indesca/abc.log"       
  MIN_FILE_SIZE   10M                                                              
END_EVENT                    

BEGIN_HANDLER
  HANDLER_ID      "ABC LOG FILE CLEANUP"                                                     
  HANDLER_TYPE     CMD                                                            
  MAXRC           0                                                              
  USERID          "control"                                                          
  PWD             "UACL"                                                   
  CMD             "rm /export/home/control/indesca/abc.log"
END_HANDLER  

Anchor
1136015 1136015

Event Options

Anchor
1042218 1042218

Components

...