PSO VCC REFILL

TITLEVALUE
NAMEPSO VCC REFILL
DESCRIPTIONThe RPC performs a refill on an outpatient pharmacy order request.

In addition, the RPC will provide the ability in Outpatient Pharmacy
to store the source of a refill request (eg. VCC, Computerized Patient
Record System (CPRS), Outpatient Pharmacy) as well as the person
making the request - if the name is known.
TAGAP1
ROUTINEPSOVCCA
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERDFN
DESCRIPTIONInternal Entry Number of the patient record for the PATIENT file (#2).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30

INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERRXN
DESCRIPTIONThe external representation of the Prescription number from the
PRESCRIPTION file (#52,.01).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30

INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERUSER
DESCRIPTIONUSER requesting the refill.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH30

INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERREFILL SOURCE
DESCRIPTIONThe system from which the REFILL request Originated (e.g., VCC, VSE).
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH30

INPUT PARAMETERSSEQUENCE NUMBER5
INPUT PARAMETERRETURN FLAG
DESCRIPTIONReturn Flag
an optional input parameter in which the value will be 1 or null.
if = 1 then the RPC will return the numeric code with the error text.
if = null then the RPC will only return the numeric code (-5, -4, -3, 0,
or 1 )
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH1

RETURN VALUE TYPEARRAY
RETURN PARAMETER DESCRIPTIONReturns an array. Depending on the value of the Return Flag input
parameter, either a single code is returned or a code and free text
description of the code.

When the Return Flag input parameter equals 1, then the code and text
description will be returned:

Exception condition when attempting to refill the prescription:
ARRAY(0)=0
ARRAY(1)=error text detail on why the prescription was not filled

The following is an example of one of many types of exceptions that could
be returned:
ARRAY(0)=0
ARRAY(1)=" Cannot refill Rx # 2769331 Rx is in SUSPENDED status"

Successful refill:
ARRAY(0)="1 - Prescription successfully refilled"

Data validation error which will be one of the following:
ARRAY(0)="-3 - Missing or Invalid Prescription Number"
ARRAY(0)="-4 - Missing or Invalid Patient ID"
ARRAY(0)="-5 - Prescription Number does not match to the Patient"
ARRAY(0)="-6 - Patient is not assigned an ICN"

When the Return Flag is equal null, then only the code will be sent:

Exception condition when attempting to refill the prescription:
ARRAY(0)=0

Successful refill:
ARRAY(0)=1

Data Validation error which will be one of the following:
ARRAY(0)=-3
ARRAY(0)=-4
ARRAY(0)=-5
AVAILABILITYAGREEMENT
INACTIVE
CLIENT MANAGER
WORD WRAP ON
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWEDYes