ROR LIST LABORATORY TESTS (1781)    REMOTE PROCEDURE (8994)

Name Value
NAME ROR LIST LABORATORY TESTS
TAG LABTLIST
ROUTINE RORRP018
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
VERSION 1
DESCRIPTION
The ROR LIST LABORATORY TESTS remote procedure returns a list of 
laboratory tests (defined in the LABORATORY TEST file), which conform the 
criteria.
INPUT PARAMETER
  • SUBSCR
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    List of test subscripts separated by commas (internal values of the 
      SP  Surgical Pathology
      WK  Workload
      
    Only tests of the types defined by this parameter are selected by the
    remote procedure. By default ($G(SUBSCR)=""), all tests are selected.
    SUBSCRIPT field of the LABORATORY TEST file):
     
      AU  Autopsy
      BB  Blood Bank
      CH  CHEM, HEM, TOX, SER, RIA, ETC.
      CY  Cytology
      EM  Electronic Microscopy
      MI  Microbiology
    
  • PART
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The partial match restriction.
    
  • FLAGS
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    Flags that control the execution (can be combined):
     
      B  Backwards. Traverses the index in the opposite
         direction of normal traversal.
     
      P  Include panels (by default, the panels are
         excluded from the list)
    
  • NUMBER
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    Maximum number of entries to return. A value of "*" or no value in this 
    parameter designates all entries.
    
  • FROM
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    The index entry(s) from which to begin the list
          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 "BI" would list entries following BI. 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 laboratory tests and the value of the FROM parameter
for the next procedure call are returned in the Results[0] and the
subsequent nodes of the global array contain the tests.
  
  Results[0]          Result Descriptor
an error occurred during the execution of the remote procedure. In this 
                        ^01: Number of tests
                        ^02: FromName
                        ^03: FromIEN
 
  Results[i]          Laboratory Test
                        ^01: IEN
                        ^02: Test Name
                        ^03: Subscript (internal)
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