DENTV MULT PARAM (1648)    REMOTE PROCEDURE (8994)

Name Value
NAME DENTV MULT PARAM
TAG MULT
ROUTINE DENTVRX1
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY AGREEMENT
WORD WRAP ON TRUE
DESCRIPTION
This will return all instances for a parameter.  The Parameter should be 
multi-instance.  The difference between this call and the national XPAR 
call is that this call will return a value for every parameter-instance 
combination regardless of entity.  It will return the value for the 
entity of highest precedence.
INPUT PARAMETER
  • PARAM
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the name of the parameter.
    
  • FLAG
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   4
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This flag contains characters that control the information returned.
    upon the sequence of the character in FLAG.
    Flag can consists of these four characters, I, i, V, v.  The default 
    value for flag is "iv".
      If flag [ "I" - return internal instance
                "i" - return external instance
                "V" - return internal value
                "v" - return external value
     
    In each array element retruned, the sequence of these values will depend 
    
  • OTHER
    PARAMETER TYPE:   LIST
    MAXIMUM DATA LENGTH:   40
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    This list array will allow you send in specific entities. There defaults
     
    This RPC uses the entities from the Parameter Definition file.  For SYS 
    and PKG there should only be one occurrence for each entity-param-instance
    combination.  But this is not so for other entity classes, like HOSPTIAL 
    LOCATION, DEVICE, DIVISION, etc.  Therefore for these entity classes you 
    must pass in the full entity syntax in this OTHER array.  The will only 
    be one occurrence of each param-instance combination for each entity 
    class.
    for specific entity types, USR, PKG, and SYS.  USR defaults to th current 
    DUZ.  These can be over-ridden by passing an explicit entity in this 
    OTHER array.  The format of OTHER():
      List[sub] := entity   where sub =0,1,2,3,4,...
      The entity must be the full explicit entity.  For example:
        USR.`12345 to get the defaults for NEW PERSON user whose DUZ is 12345
        In this case, USR.`duz will override the default of using the DUZ of
        the person who is signed on.
    
RETURN PARAMETER DESCRIPTION
On error return List[0] = -1^message
  p3 = internal instance
  p4 = internal value
Else return List[n] = entity^p2^p3^p4^p5  where n=0,1,2,3,4,...
     entity = three character code for the entity
     p2,p3,p4,p5 = Instances and Value values
 
How many p2,p3,p4,p5 are returned depends upon the number of characters 
and their sequence in the FLAG input parameter.
For example if FLAG = "vIV" then
  p2 = external value