MD TMDPARAMETER (1830)    REMOTE PROCEDURE (8994)

Name Value
NAME MD TMDPARAMETER
TAG RPC
ROUTINE MDRPCOV
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
DESCRIPTION
Used to set/retrieve/modify parameters in the Kernel ToolKit PARAMETERS
Param[4] := Value
(XPAR) files.
 
RPC is called as follows:
 
Param[0] := OPTION
Param[1] := Entity
Param[2] := Parameter name
Param[3] := Instance
INPUT PARAMETER
  • OPTION
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   10
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    Contains the option for the RPC.  RPC is called as shown:
    SETLST    ENT,PAR,,.VAL  (Uses instance 0-n)
    SETWP     ENT,PAR,INST,.VAL
    DELPAR    ENT,PAR,INST
    DELLST    ENT,PAR
     
    Options and other required parameters include:
     
    ENTVAL    ENT
    GETPAR    ENT,PAR,INST
    GETLST    ENT,PAR
    GETWP     ENT,PAR,INST
    SETPAR    ENT,PAR,INST,VAL
    
  • ENTITY
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    An entity is a level at which you can define a parameter.  The entities
    LOC     Location      Hospital Location (44) 
    TEA     Team          Team (404.51) 
    CLS     Class         Usr Class (8930) 
    USR     User          New Person (200) 
    BED     Room-Bed      Room-Bed (405.4) 
    OTL     Team (OE/RR)  OE/RR List (101.21) 
        
    The entity may be referenced as follows: 
    1) The internal variable pointer (nnn;GLO(123,) 
    2) The external format of the variable pointer using the 3 character
    allowed are stored in the Parameter Entity file (#8989.518).  The list of
       prefix (prefix.entryname)
    3) The prefix alone to set the parameter based on current entity selected.
       (prefix)
     
    Method 3 uses the following values for the following entities: 
    USR     Current value of DUZ 
    DIV     Current value of DUZ(2) 
    SYS     System (domain) 
    PKG     Package to which the parameter belongs 
    allowable entities at the time this utility was released were: 
        
    Prefix  Message       Points to File 
    PKG     Package       Package (9.4) 
    SYS     System        Domain (4.2) 
    DIV     Division      Institution (4) 
    SRV     Service       Service/Section (49) 
    
  • PAR
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    A parameter is the actual name which values are stored under.  The name of
    NOTE: This utility restricts the parameter name to those in the Clinical
    Procedures namespace (MD*).
    the parameter must be namespaced and it must be unique.  Parameters can be
    defined to store the typical package parameter data (e.g. the default add
    order screen), but they can also be used to store GUI application screen
    settings a user has selected (e.g. font or window width).  When a
    parameter is defined, the entities, which may set that parameter, are also
    defined.  The definition of parameters is stored in the PARAMETER
    DEFINITION file (#8989.51). 
     
    
  • INST
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    Most parameters will set instance to 1.  Instances are used when more than
    one value may be assigned to a given entity/parameter combination.  An
    example of this would be lab collection times at a division.  A single
    division may have multiple collection times.  Each collection time would
    be assigned a unique instance.
    
  • VAL
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   80
    REQUIRED:   NO
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    A value may be assigned to every parameter for the entities allowed in the
    parameter definition.  Values are stored in the PARAMETERS file (#8989.5).
    VAL may be passed in external or internal format.  If using internal
    format for a pointer type parameter, VAL must be preceded with the grave
    (`) character.  If VAL is being assigned to a word processing parameter,
    the text is passed in the subordinate nodes of VAL (e.g. VAL(0-n)=Text).
    
RETURN PARAMETER DESCRIPTION
Returns requested data from the specified option.