hcixlttest

This command tests a translation configuration against an actual data message.

hcixlttest [-a] -C [tclscript] [-e encoding] [-d n] [-i] [-l] [-f format] 
[-F format] [-c drivercontrol] -P [dbgport] [-R preprocessList] 
[-o postprocessList] [-w search expression] [-p sepChars] [-P portNumber]
[-L] [-n] xlt infile outfile 
  • -a processes all records in the file.
  • -C [tclscript]

    This is the flag to start the debugger on this script. Specify a script to evaluate 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 encoding encodes from enc to UTF-8.
  • -d shows data at detail level n. The detail range is 0-4, where 0 is raw, unparsed data and 4 is the most detailed.
  • -i displays field addresses using index notation.
  • -l prints unreadable chars without changing to hex. This is more readable print.
  • -f format specifies the input file format:
    • -f len10 specifies 10-byte length-encoded.
    • -f nl specifies newline terminated. This is the default.
    • -f eof specifies end-of-file terminated.
  • -F format specifies the output file format:
    • -F len10 specifies 10-byte length-encoded.
    • -F nl specifies newline terminated. This is the default.
    • -F eof specifies end-of-file terminated.
  • -c drivercontrol is used to set the content to message metadata DRIVERCONTROL. You can input any content to set to drivercontrol

    For xlate files using DICOM as the Source/Destination format, using this option. -c drivercontrol is required, where drivercontrol is {TransferSyntax***}.

    See DICOM transfer syntax values.

    using thisExample:
    hcixlttest –a –e UTF-8 –d 1 –f eof –c "{TransferSyntax 1.2.840.10008.1.2}" 
    BulkCopy.xlt c_store.dat    
  • -P [dbgport]

    This 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.

  • -R preprocessList is the list of pre-xlate procs.
  • -O postprocessList is the list of post-xlate procs.
    To use in -R preprocessList and -O postprocessList in a shell window, the proc list should be:
    procname1 {argument} procname2 {argument} 
    Example:
    -R "test_single {{WORD |pretest}} test_single {{WORD |pre2}}" -O "test_single 
    {{WORD |posttest} {SEG PV2}} test_single {{WORD |post2}}" 
  • -w search expression specifies the search string or wildcard for which to search. Only the lines of output that match the search expression are printed out. The search is case-sensitive.
  • -p sepChars are the separator characters used for parsing or encoding. This must be in a keyed list format.
  • -L specifies Tcl handle leak detection.
  • -n shows the field names.
  • xlt specifies the name of the .xlt file to test.
  • infile specifies the data file with which to test.
  • outfile specifies the len10 file for raw CONTINUE messages.