hcitpstest

This command tests user-created Tcl scripts in various contexts.

hcitpstest [-a] [-x encoding] [-c caller] 
[-C script] [-C tclscript] [-e "proc args"] 
[-f format] [-w search expression] [-i interval] [-L] 
[-m count] [-p dbgport] [-P portNumber] [-r runmode] [-S] 
[-s savebase] [file] ["proc1 [args1]" 
[..."procN [argsN"]  
  • -a processes all records in the file.
  • -x encoding is the encoding name for the data file.
  • -c caller specifies the caller context name.
  • -C script is the flag that starts the debugger on this script.
  • -C tclscript is a user-specified script that is evaluated before running the UPoC. This is only supported for Tcl UPoC.

    You can use the script to do configurations. For example, to load external Tcl files using the source command:

    -C 'source myproc.tcl'
  • -e proc args specifies to end processing configuration.
  • -f format specifies the format type:
    • -f len10 specifies 10-byte length-encoded.
    • -f nl specifies newline terminated. This is the default. search expression
    • -f eof specifies end-of-file terminated.
  • -w string specifies the search string or regular expression for which to search.
  • -i interval specifies the delay interval. This is time mode.
  • -L specifies Tcl handle leak detection.
  • -m count specifies the maximum message count. This is time mode.
  • [-P dbgport] is the TCP listening port number of the debugger server. If this is not given, then a free port is allocated by the operating system.

    Example:

    hcitpstest -P 6688 -C "source C:/cloverleaf/cis6.2/integrator/tclprocs/tpsTestHL7Parse.tcl"
    -r run -x ASCII -f nl -c sms_ib_data -e "hcitpstestshowbydisp" C:/cloverleaf/cis6.3/integrator/test/
    data/hl7_patient.dat "tpsTestHL7Parse"
  • [-p portNumbersearch indicates the listening port for debugging.
  • -r runmode specifies the run mode:
    • -r run specifies normal run mode.
    • -r start specifies startup mode.
    • -r time specifies time-based mode.
    • -r shutdown specifies shutdown mode.
  • -S specifies to run message-less startup.
  • -s savebase specifies Save File basename.
  • file specifies the data file with which to test. This is run mode.
  • procN argsN specifies TPS module procs and args.
Note:  To specify a file location for test output, you can use "/" as the file delimiter. This applies to all platforms. In Windows, you can also begin the file path with "\\".

Global variable support

Global variable support is available for the hcitpstest command line tool. The global variable indicator $$ has a confict with the shell special variable, which has meaning as the current PID on Linux/AIX platforms. To use a global variable in the Testing Tool on Linux/AIX platforms, escape the $$ using one of these forms. For example:

  • hcitpstest -a '$$variablename'
  • hcitpstest -a \$\$variablename

On Windows, use hcitpstest -a $$variablename.