ROR LIST STATES (1792)    REMOTE PROCEDURE (8994)

Name Value
NAME ROR LIST STATES
TAG STATELST
ROUTINE RORRP029
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
VERSION 1
DESCRIPTION
The ROR LIST STATES remote procedure returns a list of states that conform
the search criteria.
INPUT PARAMETER
  • PART
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The PART parameter defines the search pattern. If it contains 2 character
    abbreviation of the state and the FLAGS parameter contains "A" then the
    corresponding state is returned (see the FLAGS parameter for more
    details). Otherwise, the regular search among state names is performed.
    
  • FLAGS
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    Flags that control the execution (can be combined):
         direction of normal traversal.
     
      A  Enable abbreviation search. If PART contains 2
         character abbreviation, the corresponding state
         is returned. If the length of PART parameter is
         not equal 2 or it does not contain a valid state
         abbreviation then the regular search is performed.
     
      B  Backwards. Traverses the index in the opposite
    
  • NUMBER
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    Maximum number of entries to return. A value of "*" or no value in this 
    parameter designates all entries that conform the criteria.
    
  • FROM
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    The index entry(s) from which to begin the list. Use the pieces of the
    Results[0] (starting from the second one) to continue the listing in the
    subsequent procedure calls.
      
    NOTE: The FROM value itself is not included in the
          resulting list.
      
    See description of the LIST^DIC for more details about the PART, NUMBER
    and FROM parameters.
    
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 states 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 states.
 
  Results[0]            Result Descriptor
an error occurred during the execution of the remote procedure. In this 
                          ^01: Number of states
                          ^02: Values that comprise the FROM
                          ^nn: parameter for the subsequent call
                                                                     
  Results[i]            State
                          ^01: IEN
                          ^02: Name
                          ^03: Abbreviation
                          ^04: VA State Code
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