ROR LIST DRUGS (1802)    REMOTE PROCEDURE (8994)

Name Value
NAME ROR LIST DRUGS
TAG DRUGLIST
ROUTINE RORRP017
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
VERSION 1
DESCRIPTION
The ROR LIST DRUGS remote procedure returns a list of drugs (defined in
the DRUG file), which conform the criteria.
INPUT PARAMETER
  • PART
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The partial match restriction.
    
  • FLAGS
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    Flags that control the execution (can be combined):
     
      B  Backwards. Traverses the index in the opposite
         direction of normal traversal
     
      G  Retrive generic drugs (from file #50.6).
         Otherwise, list of dispensed drugs (from
         file #50) is retrived.
    
  • NUMBER
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    Deprecated.
    parameter designates all entries.
    
  • FROM
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    Deprecated.
          resulting list.
       
    See description of the LIST^DIC for more details about the PART, NUMBER 
    and FROM parameters.
       ^01: FromName
       ^02: FromIEN
       
    For example, a FROM value of "XA" would list entries following XA. You can
    use the 2-nd and 3-rd "^"- pieces of the Results[0] to continue the
    listing in the subsequent procedure calls.
       
    NOTE: The FROM value itself is not included in the
    
RETURN PARAMETER DESCRIPTION
A negative value of the first "^"-piece of the Results[0] indicates that 
  Results[i]            Error Descriptor
                          ^01: Error code
                          ^02: Message
                          ^03: Place of the error
  
Otherwise, number of drugs is returned in the Results[0] and the
subsequent nodes of the global array contain the drugs.
   
  Results[0]          Number of drugs
 
an error occurred during the execution of the remote procedure. In this 
  Results[i]          Drug
                        ^01: IEN in the DRUG file (#50)
                        ^02: Generic Name
                        ^03: VA Drug Class
  Results[i]          Drug
                        ^01: IEN in the DRUG file (#50)
                        ^02: Generic Name
                        ^03: VA Drug Class
case, the second piece of the Results[0] will contain number of the error
descriptors returned in the subsequent nodes of the Results array:
   
  Results[0]            Result Descriptor
                          ^01: The last error code
                          ^02: Number of the error descriptors