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