WebSphere MQ Workflow 3.4 Generic C API Test / Prototyping Tool
[prev][next][parent][TOC]
Test Tool Methods
===SYNTAX FOR TEST TOOL METHODS=========================================
TestTool_Sleep
SleepTime_ms unsigned long | RANDOM
[ RandomUpperLimit unsigned long ]
[ UserText "value" ]
[ Beep TRUE | FALSE ]
End
Remark: The SleepTime_ms random range depends on the operating system platform.
On this platform the range is: 1000-32767000 ms
TestTool_WaitForUserInput
[ UserText "value" ]
[ Beep TRUE | FALSE ]
End
TestTool_CommentToOutput
Comment "value"
[ ToStandardError TRUE | FALSE ]
End
TestTool_SetReturnCode
UserDefinedReturnCode int | CurrentLoopCount
End
TestTool_Terminate
TestTool_ShowElapseTime
ElapseTimeOptions "Testcase, Section, Method, TimeStamp, PrintApiName"
End
Remark: Testcase: Time span indicated by "+++>"
Section: Time span indicated by "===>"
Method: Time span indicated by "--->"
PrintApiName: Output: "===> ElapseTime API-NAME",
but in conjunction with "Section"
TimeStamp: Only in conjunction with "Section"
and only at the beginning of a section
........................................................................
TestTool_LoopStart
NoOfLoops unsigned long
| LastRetrievedVectorSize
| LastRetrievedVectorSizeMinus1
[ ToStandardError TRUE | FALSE ]
End
TestTool_JumpToLoopStart
TestTool_LoopBreak
Remark: LastRetrievedVectorSize / ...Minus1 applies to all
Fmcj...VectorSize()-APIs, including Fmcj...Count() APIs.
...Minus1 will only be done if VectorSize > 0.
........................................................................
TestTool_If
ExpressionOperator AND
End
TestTool_Then
TestTool_Else
TestTool_EndIf
........................................................................
/* The following methods are for OS/2 only */
TestTool_DosExecPgm
ExecFlag EXEC_SYNC | EXEC_ASYNC | EXEC_BACKGROUND
Program value
Arguments "value"
[ IdxPID unsigned long ]
End
EXAMPLES:
TestTool_DosExecPgm or TestTool_DosExecPgm
ExecFlag EXEC_SYNC ExecFlag EXEC_SYNC
Program EXMPFEXP.EXE Program CMD.EXE
Arguments "D:\FdlName /nop" Arguments "/C D:\MyOwn.CMD"
End End
or
TestTool_DosExecPgm or TestTool_DosExecPgm
ExecFlag EXEC_ASYNC ExecFlag EXEC_BACKGROUND
Program C:\OS2\APPS\EPM.EXE Program EXMPISRV.EXE
Arguments "D:\TEST.TXT" IdxPID 1
End End
Remark:
Use ExecFlag EXEC_ASYNC in combination with ActionFlag DKP_PROCESSTREE.
Use ExecFlag EXEC_BACKGROUND in combination with ActionFlag DKP_PROCESS.
TestTool_DosKillProcess
ActionFlag DKP_PROCESSTREE | DKP_PROCESS
IdxPID unsigned long
End