PSO VCC REFILL (4624)    REMOTE PROCEDURE (8994)

Name Value
NAME PSO VCC REFILL
TAG AP1
ROUTINE PSOVCCA
RETURN VALUE TYPE ARRAY
AVAILABILITY AGREEMENT
APP PROXY ALLOWED Yes
DESCRIPTION
The 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.
INPUT PARAMETER
  • DFN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    Internal Entry Number of the patient record for the PATIENT file (#2).
    
  • RXN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The external representation of the Prescription number from the
    PRESCRIPTION file (#52,.01).
    
  • USER
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    USER requesting the refill.
    
  • REFILL SOURCE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    The system from which the REFILL request Originated (e.g., VCC, VSE).
    
  • RETURN FLAG
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   NO
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    Return 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 )
    
RETURN PARAMETER DESCRIPTION
Returns an array. Depending on the value of the Return Flag input
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"
 
parameter, either a single code is returned or a code and free text 
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
description of the code.
 
Successful refill:
ARRAY(0)=1
 
Data Validation error which will be one of the following:
ARRAY(0)=-3
ARRAY(0)=-4
ARRAY(0)=-5
 
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