RxKinetics Interface Specifications

The following information is published here for other health care information system vendors, in order to facilitate interfacing with RxKinetics software. Vendors are required to notify us of their intent to interface with RxKinetics software.


General information

Information is passed to RxKinetics software via the command line. The calling program supplies a string of data as it calls the RxKinetics program.

Fields are separated by the caret symbol (^). Each field must end with the caret symbol, including the last field in the string. Any preceding optional data must be represented by a "placeholder" caret.


Pharmacokinetic software

The same interface specification is followed by all three of our Windows based pharmacokinetics programs: APK©, Antibiotic Kinetics©, and Kinetics©.

IMPORTANT NOTE the parameter string for APK© and Antibiotic Kinetics© must be enclosed in double quotes.

Fields 1 through 11 are required. Field 12 (drug model name) is optional.

  1. User Login Name
  2. Patient name (required format is Lastname, Firstname)
  3. Medical Record number
  4. Attending physician name
  5. Location (ie, room number)
  6. Date of birth (required format is MM/DD/YYYY)
  7. Height in cm
  8. Weight in Kg
  9. Gender (M or F)
  10. Date of lab draw (required format is MM/DD/YYYY)
  11. Serum Creatinine in mg/dL

    (the following field is optional)

  12. Drug model name

Kinetics© Example

     [path to executable]\kinwin32.exe Joe Pharm^Lastname, First^5895746^King^S3245^01/17/1947^182.9^75^M^01/17/2006^0.9^Vancomycin CL^
  

APK© Example (enclose in double quotes)

     [path to executable]\apk.exe "Joe Pharm^Lastname, First^5895746^King^S3245^01/17/1947^182.9^75^M^01/17/2006^0.9^Vancomycin CL^"
  

Antibiotic Kinetics© Example (enclose in double quotes)

     [path to executable]\abpk.exe "Joe Pharm^Lastname, First^5895746^King^S3245^01/17/1947^182.9^75^M^01/17/2006^0.9^Vancomycin CL^"
  


TPNassist© software

Fields 1 through 11 are the same as the Pharmacokinetic software interface described above. Fields 1 through 9 are required. The lab date and creatinine (10 and 11) are optional. In addition to these 11 fields, the following optional lab fields may be passed.

IMPORTANT : if no lab data is available for a preceding field, there must still be a "placeholder" caret for that field.

  1. User Login Name
  2. Patient name (required format is Lastname, Firstname)
  3. Medical Record number
  4. Attending physician name
  5. Location (ie, room number)
  6. Date of birth (required format is MM/DD/YYYY)
  7. Height in cm
  8. Weight in Kg
  9. Gender (M or F)

    (the following fields are optional)

  10. Date of lab draw (required format is MM/DD/YYYY)
  11. Serum Creatinine in mg/dL
  12. PreAlbumin (mg/dL)
  13. Albumin (g/dL)
  14. Transferrin (mg/dL)
  15. WBC (k/ul)
  16. Lymphocytes (%)
  17. Sodium (mEq/L)
  18. Potassium (mEq/L)
  19. Bicarbonate (mEq/L)
  20. Chloride (mEq/L)
  21. BUN (mg/dL)
  22. Glucose (mg/dL)
  23. Magnesium (mEq/dL)
  24. Phosphate (mg/dL)
  25. Calcium (mg/dL)
  26. Triglycerides (mg/dL)
  27. Prothrombin Time (seconds)

TPNassist© Example

     [path to executable]\tpnasist.exe Joe Pharm^Lastname, First^5895746^King^S3245^01/17/1947^182.9^75^M^01/17/2006^0.9^20^3.5^200^1800^9^40^140^2.9^22^100^10^80^1.5^2.5^10^160^12^
  


DripCharts© software

Fields 1 through 9 are the same as the Pharmacokinetic software interface described above. All nine fields are required.

IMPORTANT NOTE the parameter string for DripCharts© must be enclosed in double quotes.

DripCharts© Example (enclose in double quotes)

     [path to executable]\dripcharts.exe "Joe Pharm^Lastname, First^5895746^King^S3245^01/17/1947^182.9^75^M^"
  


Implementation

The interface was implemented in the following program versions:


Programming the Interface

The simplest way to call an RxKinetics program from within another program is to invoke the Windows API function ShellExecute.

The following definition is excerpted from the Win32 Programmer's Reference:

ShellExecute(
  HWND hwnd, // handle to parent window
  LPCTSTR lpOperation, // pointer to string that specifies operation to perform
  LPCTSTR lpFile, // pointer to filename or folder name string
  LPCTSTR lpParameters, // pointer to string that specifies executable-file parameters
  LPCTSTR lpDirectory, // pointer to string that specifies default directory
  INT nShowCmd // whether file is shown when opened
  );

For example, below is a code snippet showing how to call Kinetics from another program:

ShellExecute(
  Me.hwnd,
  'open',
  'kinwin32.exe',
  'Joe Pharm^Lastname, First^5895746^King^S3245^01/17/1947^182.9^75^M^01/17/2006^0.9^Vancomycin CL^',
  'c:\clinical',
  SW_SHOWNORMAL
  );

Another example, below is a code snippet showing how to call APK from another program, note the parameter string is enclosed in double quotes:

ShellExecute(
  Me.hwnd,
  'open',
  'apk.exe',
  ' "Joe Pharm^Lastname, First^5895746^King^S3245^01/17/1947^182.9^75^M^01/17/2006^0.9^Vancomycin CL^" ',
  'c:\program files\apk',
  SW_SHOWNORMAL
  );


Click here to return to previous page