<function name="listDir" scope="local">
<function-prolog>This function lists entries of specified directory on the target
 machine</function-prolog>
<function-list-args>
<function-required-arg name="target">Hostname/IP address of the target machine
</function-required-arg>
<function-required-arg name="targetDirectory">Target directory </function-required-arg>
</function-list-args>
<sequence>
  <script>cmd = 'LIST DIRECTORY %s' % (targetDirectory) </script>
  <!-- Run the staf list directory command using the supplied arguments -->
  <stafcmd>
    <location>target</location>
    <service>'FS'</service>
    <request>cmd</request>
  </stafcmd>
  <return>STAFResult</return>
</sequence>
</function>

while [ ! -s "./builds.html" ] 
do
  sleep $sleeptime
  #将所有Build所在的目录存成一个文件待用
  wget $Remote_realese_url -O ./builds.html" >> $LOG_BASEDIR/`date +%Y-%m-%d-%H`.log
done
#从保存的文件中提取最新的Build版本信息，这里使用AWK在文件中来获得最新版本信息
latestversion=`cat builds.html | awk -F"STARTPattern" '{print $2}' | awk -F"EndPattern"
'{print $1}' | grep $VERSIONPATTERN | sort | tail -1`
if [ ! -d "$BUILDS_DIR/$ latestversion " ]; then
#在本地创建当前Build版本的目录
mkdir $BUILDS_DIR/$ latestversion 
fi

#Trigger STAX event
echo "start"
while [ "$parameterFileNumber" != "0" ] 
do
echo "start a STAX event..." 
echo "kick off STAX event, file number is $parameterFileNumber"
let "parameterFileNumber=$parameterFileNumber-1"
STAF STAXServer.cn.ibm.com SEM POST EVENT "$eventName"
sleep 600
echo "a STAX event was triggered successfully!" 
done
echo "Kick off UAT finished!" 

<stax>
<function name="InstallWebSpherePortal">
<function-prolog>InstallWebSpherePortal</function-prolog>
<function-list-args>
</function-list-args>
<sequence>
<!-- Step 1. Mount build server -->
<call function="'mountBuildServer'">target, mountServer, 
remoteMountPoint, localMountPoint</call>
<!-- Step 2. Copy image and create dir-->
<call function="'copyImage'">target,destinyDir,destinyFPDir,destinyFile, 
localMountPoint,buildPuiDir,buildPtfDir,buildPuiNum,buildPtfNum, 
buildZipFileName</call>
<if expr="STAXResult == 0">
<call function="'writeLog'">[target, 'Success copy image files .']</call>
</if>
<!-- Step 3. Stop all servers-->
<call function="'stopAllServers'">target,portalProfileRoot,
WPSUsername,WPSPasswd, WASUsername,WASPasswd</call>
<if expr="STAXResult == 0">
<call function="'writeLog'">[target, 'Stop all servers success !']</call>
</else>
</if>
<!-- Step 4. Start to install-->
<sequence>
<call function="'StartInstall'">target,portalServerDir,
setUpCmdLineDir,destinyDir, destinyFPDir,WPSPasswd,
WASPasswd,portalConfigDir</call>
<if expr="STAXResult == 0">
<call function="'writeLog'">[target, 'Fixpack install finish success !']</call>
</if>
</sequence>
<return>0</return>
</sequence>
</function>
</stax>

<stax>
<function name="enableSecurity" scope="local">
<function-prolog>'Enable security for the portal on the target machine'</function-prolog>
<function-list-args>
<!-- Define arguments-->
</function-list-args>
<sequence>
<!-- Step 1. Stop Portal. -->
<call function="'retrieveWasPortalStatus'">[target, portalProfileRoot, wasUserId, 
 wasPassword]</call>
<if expr="STAXResult == 0">
<sequence>
<call function="'writeLog'">[target, 'Portal is already started, begin to stop it...', 
'user1']</call>
<call function="'stopWasPortal'">[target, portalProfileRoot, wasUserId, 
wasPassword]</call>
<if expr="STAXResult == 0">
<call function="'writeLog'">[target, 'Stop Portal successfully.', 'user1']</call>
</if>
</sequence>
</if>
<!-- Step 2. Run task -->
<call function="'runConfigEngineTask'">[target, portalProfileRoot, 
'wp-modify-ldap-security']</call>
<if expr="STAXResult == 0">
<call function="'writeLog'">[target, 'Task wp-modify-ldap-security succeeded.', 
'info']</call>
</if>
<!-- Step 3. Start portal -->
<call function="'startWasPortal'">[target, portalProfileRoot]</call>
<if expr="STAXResult == 0">
<sequence>
<call function="'writeLog'">[target, 'Task EnableSecurity succeeded!', 'pass']</call>
<return>0</return>
</sequence>
</if>
</sequence>
</function>
</stax>

<stax>
<function name="DBTransfer" scope="local">
<function-prolog>'Transfer DB'</function-prolog>
<function-list-args>
<!-- Define arguments-->
</function-list-args>
<sequence>
<!-- Step 1. Modify property files -->
<call function="'MergeProperyFilesTool'">
 [target, targetDirectory, targetFileName1, sourceFileName1, MergePropertyScript, 
 domains1, append] 
</call>
<call function="'MergeProperyFilesTool'">
[target, targetDirectory, targetFileName2, sourceFileName2, MergePropertyScript, 
domains2, append] 
</call>
<!-- Step 2. Run task -->
<call function="'runConfigEngineTask'">[target, portalProfileRoot, 
'database-transfer']</call>
<if expr="STAXResult == 0">
<call function="'writeLog'">[target, 'Task database-transfer succeed.', 'user1']</call>
</if>
<!-- Step 3. Start portal -->
<call function="'startWasPortal'">[target, portalProfileRoot]</call>
<if expr="STAXResult == 0">
<sequence>
<call function="'writeLog'">[target, 'Task DBTranfer succeeded!', 'user1']</call>
<return>0</return>
</sequence>
</if>
</sequence>
</function>
</stax>

<stax>
<function name="runExampleRFTTest" scope="local">
<function-prolog>Runs a RFT testcase using LA</function-prolog>
<function-list-args>
<!-- Define arguments-->
</function-list-args>
<sequence>
<!-- Run the RFT test on the RFT server -->
<call function="'cafRunRFTTest'">
{
'rftServer' : target, 
'properties' : mySuite, 
'rftProjectArchive' : 'LWPServerGUI.zip', 
'rftScript' : rftScript, 
'rftScriptArgs' : rftArgs, 
'maxExecutionTime': maxTime, 
'browserName': browserType, 
'browserPath': browserLocation, 
'browserCommand': browserCmd, 
'rftExecutionMode' : 'standalone'
}
</call>
<script>(rftRunTestRC,rftRunTestCallResult) = STAXResult</script>
<return>rftRunTestRC</return>
</sequence>
</function>
</stax>

<function name="writeLog" scope="local">
<function-list-args>
<function-required-arg name="content"></function-required-arg>
<function-optional-arg name="level" default="'info'"></function-optional-arg>
<function-optional-arg name="type" default="'detail'"></function-optional-arg>
<function-optional-arg name="state" default="'start'"></function-optional-arg>
</function-list-args>
<sequence>
<script>
displayLogName = 'Automation Runtime Text Output Log'
#the actual name of the text log file. 
logFileName = '%s.txt' % STAXJobID
#if content contains multiply lines, separate it
from string import *
lines = split(content, '\n') 
</script>
<iterate in="lines" var="line">
  <sequence>
    <if expr="type == 'testcase'">
     <sequence>
        <script>line = '*TESTCASE %s:%s' % (state, line)</script>
     </sequence>
    <elseif expr="type == 'step'">
        <script>line = '*STEP %s:%s' % (state, line)</script>
    </elseif>
    </if>
    <call function="'cafAppendJobOutputLog'">[target, 'local', line
   displayLogName, logFileName]</call>
  </sequence>
</iterate>
</sequence>
</function>

*TESTCASE	 STATE	TestcaseName
*STEP STATE StepName

def parseLog(self, logTxtFile): 
"""
Parse the txt log file, information of testcases and steps will be assigned to
the data field of this class.Translate the common txt lines to html and assign
it to the htmlContent field. 
"""
    try: 
        self._txtLogFileName = logTxtFile
        fp = open(self._txtLogFileName, 'r') 
    except IOError, e: 
        return (1, 'Open file %s failed' % logTxtFile) 
    #use stacks to contain the parsed entries
    testcases = []
    steps = []
    for line in fp.readlines():
        #remove the timestamp
        logInfo = line.strip().split('\t', 1)[-1] 
        if logInfo.startswith('*TESTCASE') or logInfo.startswith('*STEP'): 
        #it is a tag
            type,name = logInfo.split(':', 1) 
            type,state = type.split(' ', 1) 
            if type == '*TESTCASE': 
                if state == 'start': 
                    testcases.append(name) 
                    self.addTestcase(name) 
                else: 
                    testcases.pop()
                    try: 
                        self.closeTestcase(name, state) 
                    except EntryNotFoundException, e: 
                        return (1, e.msg) 
            else: 
                if state == 'start': 
                    steps.append(name) 
                        try: 
                            self.addTestcaseStep(name, testcases[-1]) 
                        except EntryNotFoundException, e: 
                            return (1, e.msg) 
                else: 
                    steps.pop()
                    try: 
                        self.closeTestcaseStep(name, testcases[-1], state) 
                    except EntryNotFoundException, e: 
                        return (1, e.msg) 
    fp.close()
    return (0, '')