Print Page as PDF
PSSUTLA1 ICR (3373)

PSSUTLA1    ICR (3373)

Name Value
NUMBER 3373
IA # 3373
DATE CREATED 2001/05/10
CUSTODIAL PACKAGE PHARMACY DATA MANAGEMENT
CUSTODIAL ISC Birmingham
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE PSSUTLA1
NAME PSSUTLA1
GENERAL DESCRIPTION
Pharmacy Data Management returns a DEA Special Handling
code for a Pharmacy Orderable Item, based on the Dispense Drugs that are
matched to that Pharmacy Orderable Item.

Pharmacy Data Management also returns the Computerized Patient Record System
(CPRS) Order Number when a Pharmacy Order Number is passed into the PLACER
component.

Pharmacy Data Management also returns the most appropriate Order Location when
a Pharmacy Order Number is passed into the LOC component.
STATUS Active
DURATION Till Otherwise Agreed
ID PSSUTLA1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
OIDEA(PSSXOI,PSSXOIP)
This entry point will return a DEA Special Handling
code for a Pharmacy Orderable Item.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSXOI Input
This variable is the internal entry number from the
Pharmacy Orderable Item (#50.7) file.
PSSXOIP Input
This variable can be one of three values. "O"
indicates that this call is being made for an Outpatient Pharmacy order.
Either an "I" or a "U" indicates that this call is being made for an Inpatient
Medications order.
$$OIDEA Output
This output variable indicates the DEA Special
Handling code at the Pharmacy Orderable Item level, based on dispense drugs
matched to the Item. This variable can be one of four values, a "1", a "2", a
"0", or null. If a "1" is returned, that indicates that there is at least one
active dispense drug matched to that Pharmacy Orderable Item for the specified
package, that has a DEA Special Handling Code that contains a "1", or contains
a "2". This means that a wet signature is required. If a "2" is returned, that
indicates that the first condition wasn't met, and that there is at least one
active dispense drug matched to that Pharmacy Orderable Item for the specified
package, that has a DEA Special Handling Code that contains a "3", or contains
a "4", or contains a "5". This means a wet signature is not required, but it
does indicate a Controlled Substance. A "0" is returned if neither of the
first two conditions are met, but there are active drugs matched to the
Pharmacy orderable Item for the specified package. If there are no active
drugs for the specified package matched to the Pharmacy Orderable Item, then a
null is returned.
$$PLACER(PSOPDFN,PSOPIEN)
This component returns the CPRS Order Number when a
Pharmacy Order Number is passed in.
VARIABLES TYPE VARIABLES DESCRIPTION
PSOPDFN Input
This represents the Internal Entry Number from the
PATIENT File (#2).
PSOPIEN Input
This represents the Pharmacy Order number, in the
form of order number followed by the one character uppercase file indicator,
as follows:

###P - NON-VERIFIED ORDERS File (#53.1), ###U - UNIT DOSE Subfile (#55.06) of
PHARMACY PATIENT File (#55), ###I - IV Subfile (#55.01) of the PHARMACY
PATIENT File (#55), ###N - NON-VA MEDS Subfile (#55.05) of the PHARMACY
PATIENT File (#55), ###S - PENDING OUTPATIENT ORDERS File (#52.41), ###R -
PRESCRIPTION File (#52)

For the 'U', 'I' and 'N' entries above, the number represents the Internal
Entry Number from the subfile.
$$PLACER Output
This represents the Internal Entry Number from the
ORDER File (#100). (CPRS Order Number). For the Inpatient files (P,U and I),
the return value may contain a semicolon followed by another number. In those
cases, the CPRS Order Number is the first piece, with ";" as the delimiter.

If for any reason a return value cannot be found, a null value is returned.
$$LOC(PSSPDFN,PSSPIEN)
This component returns the order location when a
Pharmacy Order Number is passed in.
VARIABLES TYPE VARIABLES DESCRIPTION
PSSPDFN Input
This represents the Internal Entry Number from the
PATIENT File (#2).
PSSPIEN Input
This represents the Pharmacy Order number, in the
form of order number followed by the one character uppercase file indicator,
as follows:

###P - NON-VERIFIED ORDERS File (#53.1), ###U - UNIT DOSE Subfile (#55.06) of
PHARMACY PATIENT File (#55), ###I - IV Subfile (#55.01) of the PHARMACY
PATIENT File (#55), ###N - NON-VA MEDS Subfile (#55.05) of the PHARMACY
PATIENT File (#55), ###S - PENDING OUTPATIENT ORDERS File (#52.41), ###R -
PRESCRIPTION File (#52)

For the 'U', 'I' and 'N' entries above, the number represents the Internal
Entry Number from the subfile.
$$LOC Output
This represents the most appropriate order location
of the pharmacy order. It is a 3 piece return with a '^' delimiter, as
follows:

Piece 1 = Internal Entry Number for the entry being returned.  Piece 2 = The
.01 field of the entry being returned.  Piece 3 = The file number that the
entry being returned belongs to. It
can be one of 4 values:

4  (INSTITUTION)
40.8  (MEDICAL CENTER DIVISION)
42  (WARD LOCATION)
44  (HOSPITAL LOCATION)

If for any reason a value cannot be determined for the order, the default
institution from the INSTITUTION File (#4) is returned.
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC SUBSCRIBING DETAILS
ORDER ENTRY/RESULTS REPORTING Salt Lake City
VA POINT OF SERVICE (KIOSKS)
VISTA INTEGRATION ADAPTOR
VIABDX SAVE RPC references PSSUTLA1 routine.
VIRTUAL PATIENT RECORD
Virtual Patient Record can invoke the PLACER component
to retrieve the CPRS Order Number, and the LOC component to retrieve the most
appropriate location for a pharmacy order.
OUTPATIENT PHARMACY
Added 8/16/23, effective with sustainment patch
PSO*7*671 (addresses SNOW INC20722800 - Error Running Option Complete Orders
from OERR), where a need was identified to document subscription for
historical PSO routines calling the extrinsic function $$OIDEA^PSSUTLA1 in
order to obtain the DEA for an PHARMACY ORDERABLE ITEM.
DATE ACTIVATED 2019/10/02