Name | Value |
---|---|
NAME | PSB TRANSACTION |
TAG | RPC |
ROUTINE | PSBML |
RETURN VALUE TYPE | ARRAY |
AVAILABILITY | PUBLIC |
VERSION | 3 |
DESCRIPTION | This is the filing RPC for all data returning from the client sequence 1). If a '+1^MEDPASS' is encountered it is a complete new med ------------------------------------------------------------------------- TRANSACTION = PRN EFFECTIVENESS [0] = Effective Comment Note: will be filed as entered now by current user ------------------------------------------------------------------------- TRANSACTION = STATUS UPDATE pass and is validated as such. Transaction type MEDPASS is the only type [0] = New Status Note: If status is Given, Date/Time administered D/T will be set to NOW If status is Held/Refused administered D/T will be set to null Status on med log must be <> null to execute. New status must NOT match current status or G will overwrite administration DT. [1] = Comment Note: Comment *IS* Required that requires a +1 in the first piece of the header, all other [2] = Injection Site [3] = [4] = RecordType^IEN^Units Ordered^Units Given^Units Type^^HR code^MRR code 1) Record Type = DD: Dispense Drug SOL: Solution ADD: Additive transactions MUST supply a valid medication log entry in the IENS. 2) IEN = Internal Entry Number of the following if Record Type = DD: DRUG (FILE #50) SOL: IV SOLUTIONS (FILE #??) ADD: IV ADDITIVES (FILE #??) 3) Units Ordered = Number of units in the Inpt Meds Order 4) Units Given = Number of units scanned/entered by the user 5) Units Type = Type of administration unit (i.e. TAB, CAP,ML) 6) n/a 7) Orderable Item High Risk/High Alert code value (HR = 1, 2, or 3) 8) Orderable Item Prompt For Removal In BCMA code value (MRR = 0, 1, or 3) The data for filing is passed in as a list in Param[1] as shown below. ------------------------------------------------------------------------- TRANSACTION = EDIT (This is the MEDLOG Edit an existing transaction) [0] = Action Status [1] = Patient DFN [2] = Inf/Inj Site [3] = IV Unique ID [4] = Admin Date/Time (fileman format) [5] = Prn Reason [6] = Prn Effectiveness [7] = Comment Note: comment data is required! [8] = "DD/ADD/SOL^ Drug IEN ^ Dose Ordered ^ Dose Given ^ Unit of Administration" ^ High Risk High Alert code ^ Prompt For Removal In BCMA code [n] = "additional data per DD/ADD/SOL associated with order." Example Delphi Call with RPCBroker1 do regarding the medication log. Filing is handled by business rules on begin RemoteProcedure := 'PSB TRANSACTION'; Param[0].Value := '88484^COMMENT'; Param[0].PType := Literal; Param[1].Mult['0'] := 'Comment for the med pass'; Param[1].Ptype := List; Call; end; BUSINESS LOGIC controlled by Param[0]: the server and this RPC will return either '1^Data Filed' or Param[0] = MEDLOG IEN ^ TRANSACTION ^ INSTRUCTOR DUZ ^ WITNESS DUZ ^ WITNESS COMMENT ^ WITNESS HR ORDER LEVEL CODE ------------------------------------------------------------------------- TRANSACTION = MEDPASS (this is the MEDLOG ADD a new transaction) Note: Entries 1-6 are required, 7,8,9 are required depending on item [2] order type... [0] = Patient IEN '-1^reason for not filing data' to the client. Results of the [1] = IV/Unit Dose Order Number ^ Clinic Name (if a clinic order) Note: will be passed in as I;#### for IV and U;#### for Unit Dose future release will allow P;#### for pending [2] = Schedule Note: C:Continuous P:PRN 1:One Time O:On Call [3] = Status processed transaction is communicated via the RESULTS array. The Note: G:Given H:Held R:Refused [4] = Orderable Item Note: IEN to 'PHARMACY ORDERABLE ITEM' (#50.7) [5] = Scheduled Administration Date/Time Note: This is when the med is scheduled, med is entered as GIVEN NOW! [6] = Reason Given PRN^PRN Reason Flag Note: Required if given PRN must be null if not PRN number of RESULTS subscripts used (n) will be presented in RESULTS[0]. [7] = Comment Note: 1-200 characters [8] = Injection Site [9] = Tab^Unique ID # [10] = Schedule Removal Date/Time Note:This is when the med is scheduled to be removed and not the actual removal transaction date/time. RESULTS [1..n] will contain the RESULTS message. [11..n] = RecordType^IEN^Units Ordered^Units Given^Units Type^^HR code^MRR code 1) Record Type = DD: Dispense Drug SOL: Solution ADD: Additive 2) IEN = Internal Entry Number of the following if Record Type = DD: DRUG (FILE #50) SOL: IV SOLUTIONS (FILE #??) ADD: IV ADDITIVES (FILE #??) 3) Units Ordered = Number of units in the Inpt Meds Order 4) Units Given = Number of units scanned/entered by the user 5) Units Type = Type of administration unit (i.e. TAB, CAP,ML) 6) n/a Business rules are conducted via the [0] node data (Input parameter 7) Orderable Item High Risk/High Alert code value (HR = 1, 2, or 3) 8) Orderable Item Prompt For Removal In BCMA code value (MRR = 0, 1, or 3) ------------------------------------------------------------------------- TRANSACTION = COMMENT [0] = Comment to append to the log entry Note: Will be appended to the log with user ien and NOW as a date |
INPUT PARAMETER |
|
RETURN PARAMETER DESCRIPTION | See description. |