GMV MANAGER (1286)    REMOTE PROCEDURE (8994)

Name Value
NAME GMV MANAGER
TAG RPC
ROUTINE GMVRPCM
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY SUBSCRIPTION
INACTIVE ACTIVE
WORD WRAP ON TRUE
DESCRIPTION
Performs many functions for the Manager module.
 
This remote procedure call is documented in Integration Agreement 4360.
INPUT PARAMETER
  • OPTION
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   10
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    Routine tag line in GMVRPCM to call.
    
  • DATA
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   100
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    Other data as required for the call.
    
RETURN PARAMETER DESCRIPTION
This remote procedure call performs various actions such as building
that will be invoked to process the call.
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=1^PULSE OXIMETRY
                        1)=2^METHOD^AEROSOL/HUMIDIFIED MASK, CPAP, FACE 
   TENT, L ARM, MASK, NASAL CANNULA, NON RE-BREATHER, PARTIAL RE-BREATHER,
   ROOM AIR, T-PIECE, TRACHEOSTOMY COLLAR, VENTILATOR, VENTURI MASK
 
If an error is encountered, a "-1" followed by a caret and the error 
 
message text (i.e., -1^error message) is returned.
 
 
5) When the OPTION value is GETDATA, this RPC will return the value of 
the entry you specify.
  
The DATA value is a three part value. The first part is the file number. 
The second part is the IEN number of the entry. The third part is the
field number.
 
The DATA variable contains any additional values needed by the OPTION
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=external value of the field
 
Example:
 > S DATA="120.51^1^1"
 > D RPC(.RESULT,"GETDATA",DATA) ZW RESULT             
 > RESULT="^TMP("GMVMGR",539339804)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539339804,0)=BP
variable to process the call.
        
If a value cannot be found, then a null value is returned.
 
 
6) When the OPTION value is GETDEF, this RPC will return default template
names. 
  
The DATA value is a one part value. If it is null, then all default 
templates for that user will be returned. 
 
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=piece1
 ^TMP("GMVMGR",$J,n)=piece2^piece3
 
 where piece1 = number of templates found
       piece2 = an IEN value, a semi-colon, and a global reference
       piece3 = template name
            n = sequential number starting with 1
 
Example A: 
 
 > S DATA="" 
 > S OPTION="GETDEF"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=4
                           1)=125;SC(^WARD 10A
                           2)=334;DIC(4.2,^TEST
                           3)=4601;VA(200,^Height ONLY
1) When the OPTION value is ADDQUAL, this RPC will link a GMRV VITAL 
                           4)=547;VA(200,^All Vital Signs
 
If the DATA value is an entity value (see IA 2263 for a list of entity 
values), then the default template name for that entity will be returned.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=template name
 
Example B:
 > S DATA="USR"                                
QUALIFIER (#120.52) file entry to a GMRV VITAL TYPE (#120.51) file entry. 
 > S OPTION="GETDEF"                           
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=MY DEFAULT
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.  
 
  
  
7) When the OPTION value is GETHILO, this RPC will return the abnormal 
high or low value for a vital type.
 
The DATA value is a one part value which identifies a field number in 
the GMRV VITALS PARAMETERS (#120.57) field.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=field value
 
The DATA value is a three part value separated by semi-colons(;). The 
Example:
 > S DATA=5.2
 > S OPTION="GETHILO"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=94 
 
A zero is returned if there is no value in the field. 
selection lists and modifying package parameters. The entry point is
first value is the FILE 120.51 internal entry number (IEN). The second 
 
 
8) When the OPTION value is GETLIST, this RPC returns a list of entries
for the file number specified.
 
The DATA value is a one part value. It is a file number.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=piece1^piece2
 ^TMP("GMVMGR",$J,n)=piece3^piece4
value is the GMRV VITAL CATEGORY (#120.53) IEN. The third value is the 
 
 where piece1 = number of entries returned
       piece2 = file name [not returned in all cases] 
       piece3 = file number, a semi-colon and record IEN
       piece4 = the .01 value of the record
            n = sequential number starting with 1
 
Examples:
 Retrieve a list of wards.
 > S DATA=42
GMRV VITAL QUALIFIER (#120.52).
 > S OPTION="GETLIST"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539363784)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539363784,0)=26^WARD LOCATION
                           1)=42;14^10A
                           n)=42;15^10B 
                           26)=42;39^10Z
 
  
 Retrieve a list of clinics.
 > S DATA=44
 > S OPTION="GETLIST"              
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539363784)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539363784,0)=61
                           1)=44;6^HOUSE/A
                           n)=44;8^HOUSE/C
Example:
                           61)=44;39^HOUSE/ZZ
 
 Retrieve a list vital types.
 > S DATA=120.51
 > S OPTION="GETLIST"              
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539363784)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539363784,0)=10^GMRV VITAL TYPE
 
                           1)=120.51;1^BLOOD PRESSURE
                           N)=120.51;19^CENTRAL VENOUS PRESSURE
                           10)=120.51;9^WEIGHT
 
 Retrieve a list of qualifiers.
 > S DATA=120.52
 > S OPTION="GETLIST"              
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539363784)"
 > D ^%G
 > S DATA="1;1;1"
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539363784,0)=80^GMRV VITAL QUALIFIER
                           1)=120.52;74^ABDOMINAL
                           n)=120.52;42^ACTUAL
                           80)=120.52;99^WRIST
 
 Retrieve a list of CPRS teams.
 > S DATA=100.21
 > S OPTION="GETLIST"              
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > S OPTION="ADDQUAL"
 > RESULT="^TMP("GMVMGR",539363784)"
 > D ^%G                                       
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539363784,0)=103
                           1)=100.21;28^1AS
                           n)=100.21;60^1ASO
                           103)=100.21;96^consult team
 
 Retrieve a list of nursing units.
 > S DATA=211.4
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > S OPTION="GETLIST"               
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539363784)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539363784,0)=21
                           1)=211.4;7^10E
                           n)=211.4;17^10W
                           21)=211.4;9^SICU
 
 > RESULT="^TMP("GMVMGR",539356158)"
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.
 
 
9) When the OPTION value is GETQUAL, this RPC returns a list of 
qualifiers associated with this vital type.
 
The DATA value is a two part value separated by a semi-colon. The first 
part is vital type (FILE 120.51) IEN. The second part is a category (FILE
120.53) IEN.
RPC^GMVRPCM. It has input parameters of RESULTS, OPTION and DATA (ex:
 > D ^%G
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=piece1^piece2
 ^TMP("GMVMGR",$J,n)=piece3^piece4
 
  where piece1 = number of entries found
        piece2 = category name (FILE 120.53, Field .01)
        piece3 = qualifier IEN
        piece4 = qualifier name (FILE 120.52, Field .01)
             n = sequential number starting with 1
 > Global ^TMP("GMVMGR",$J
 
Example:
 > S DATA="1;1",OPTION="GETQUAL"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=6^LOCATION
                           1)=139^Test Qualifier
                           2)=53^FEMORAL
 > ^TMP("GMVMGR",539356158,0)=1^Qualifier Assigned
                           3)=2^L ARM
                           4)=4^L LEG
                           5)=24^PERIPHERAL
                           6)=1^R ARM 
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.
 
 
10) When the OPTION value is GETTEMP, this RPC will return a list data 
 
input templates definitions.
 
The DATA value is a two part value separated by a caret. The first part 
is an entity value. See IA 2263 for a list of entities. The second part is
a data input template name. 
 
When DATA is null, all data input template definitions are returned.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=piece1
If an error is encountered, a "-1" followed by a caret and the error 
 ^TMP("GMVMGR",$J,n)=piece2^piece3^piece4^piece5^piece6
 
  where piece1 = number of entries returned
        piece2 = 1, 2, 3, or 4. (1 = Domain, 2 = Institution, 3 = Hospital
                 location and 4 = New Person)
        piece3 = file IEN, a semi-colon and global reference
        piece4 = Field .01 value of the file specified in piece3
        piece5 = template name
        piece6 = template description text, a bar, vital type IEN (FILE 
120.51), a colon, a metric flag (0=U.S. and 1=metric), category IEN
message text (i.e., -1^error message) is returned. 
(FILE 120.53), a coma, and a qualifier IEN (FILE 120.52), a tilde
indicates additional category and qualifier combinations for the vital
type. A semi-colon indicates the start of the next vital type.
             n = sequential number starting with 1
 
Example:
 > S DATA="USR",OPTION="GETTEMP"               
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=1
                           1)=4^547;VA(200,^VITUSER,ONE^MY DEFAULT^ALL
                              VITALS|1:0:1,2~2,59~3,50;20:1
 
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.
 
 
 
11) When the OPTION value is LOOKUP, this RPC will do a file lookup
 
The DATA value is a three part value separated by a caret. The first part 
is a file number. The second part is a value to look up. The third part is
the field or fields to do the look up on. If the third piece is not 
defined, the lookup is done on the .01 field of the file.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=piece1
 ^TMP("GMVMGR",$J,n)=piece2^piece3
2) When the OPTION value is DELQUAL, this RPC will unlink a qualifier to 
 
  where piece1 = number of entries found
        piece2 = file number, a semi-colon and record IEN
        piece3 = field value
 
Example:
 > S DATA="44^OUTPAT^.01",OPTION="LOOKUP"      
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539359648)"
 > D ^%G
a GMRV VITAL TYPE (#120.51) file entry. 
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539359648,0)=3
                           1)=44;75^OUTPATIENT NUC MED
                           2)=44;74^OUTPATIENT RADIOLOGY
                           3)=44;80^OUTPATIENT ULTRASOUND
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.
 
 
RPC^GMVRPCM(.RESULTS,OPTION,DATA). 
  
12) When the OPTION value is NEWQUAL, this RPC will always return an 
error message instructing the user to use the New Term Rapid Turnaround 
process.
 
The DATA value is always null.
 
Example:
 > S DATA=""
 > S OPTION="NEWQUAL"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
The DATA value is a three part value separated by semi-colons. The first 
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=-1^Use the New Term Rapid Turnaround (NTRT) 
   process to add qualifiers
 
  
13) When the OPTION value is NEWTEMP, this RPC will file a new data 
input template.
 
value is the FILE 120.51 internal entry number (IEN). The second value is 
The DATA value is a three part value separated by a caret. The first part 
is an entity. See IA 2263 for a list of entities. The second part is 
the name of the data input template. The third part is the description
text. If the third part is null, the template description will default to
"No Description".
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=piece1^piece2^piece3^piece4
 
  where piece1 = 1, 2, 3, or 4 (1 = DOMAIN (#4.2), 2 = INSTITUTION (#4), 
the GMRV VITAL CATEGORY (#120.53) IEN. The third value is the GMRV VITAL 
                 3 = HOSPITAL LOCATION, and 4 = NEW PERSON)
        piece2 = IEN, a semi-colon, and global reference (e.g., 3;DIC(4.2)
        piece3 = the .01 field value for the record in piece2
        piece4 = data input name
 
Example:
 > S DATA="USR^1 EAST^All Vital Types"
 > S OPTION="NEWTEMP"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539343036)"
QUALIFIER (#120.52) IEN.
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539343036,0)=4^547;VA(200,^VITUSER,ONE^1 EAST
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.          
  
 
14) When the OPTION value is RENTEMP, this RPC will rename a data input 
template. 
  
 
The DATA value is a three part value separated by a caret. The first part 
is an entity. See IA 2263 for a list of entities. The second part is the
current template name. The third part is the new name of the template.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=1^Renamed
         
Example:
 > S DATA="USR^FRANK'S DEFAULT^MY DEFAULT"
Example:
 > S OPTION="RENTEMP"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=1^Renamed
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned. 
  
 > S DATA="1;1;1"         
 
15) When the OPTION value is SETDATA, this RPC always returns an error
message that instructs the user to use the New Term Rapid Turnaround
process.
  
The DATA value is null.
  
Example:
 > S DATA=""
 > S OPTION="SETDATA"                  
 > S OPTION="DELQUAL"                        
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=-1^Use the New Term Rapid Turnaround (NTRT) 
   process to add qualifiers
 
  
16) When the OPTION value is SETDEF, this RPC will set that data input 
template as a default.
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
  
The DATA value is a two part value separated by a caret. The first part is
an entity. See IA 2263 for a list of entities. The second part is the 
name of the template that will become the default template.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=1^Set As Default
 
Example:
 > S DATA="USR^FRANK'S LIST"
 
 > RESULT="^TMP("GMVMGR",539356158)"
 > S OPTION="SETDEF"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=1^Set As Default.
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.  
  
 > D ^%G
 
17) When the OPTION value is SETHILO, this RPC will set the high and low 
abnormal values for a vital type.
  
The DATA value is a two part value separated by a caret. The first part 
is a field number in the GMRV VITALS PARAMETERS (#120.57) file. The 
second part is the value that field should be set to.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=1^Update Complete.  
 > Global ^TMP("GMVMGR",$J
 
Example:
 > S DATA="5.1^102",OPTION="SETHILO"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=1^Update Complete.
 
If an error is encountered, a "-1" followed by a caret and the error 
 > ^TMP("GMVMGR",539356158,0)=1^Qualifier removed.
message text (i.e., -1^error message) is returned.
  
 
18) When the OPTION value is SETTEMP, this RPC will save the input 
template definition.
  
DATA is a three part value separated by a caret. The first part is 
an entity. See IA 2263 for a list of entities. The second part is the
template name. The third part is the template definition.
 
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=1^Template Saved.
  
Example:
 > S DATA="USR^ONE VITAL TYPE ONLY^CONTAINS ONLY ONE VITAL TYPE|2:0:1,102"
 > S OPTION="SETTEMP"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
If an error is encountered, a "-1" followed by a caret and the error 
 > ^TMP("GMVMGR",539356158,0)=1^Template Saved.
 
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.  
 
  
19) When the OPTION value is VALID, this RPC will validate data.
 
DATA is a four part value separated by a caret. The first part is the 
message text (i.e., -1^error message) is returned.
a file number. The second part is a record number. The third part is a
field number. The fourth part is the value to validate.
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=1^Valid Data
 
Example:
 > S DATA="120.5^8864^.01^3051012.1034",OPTION="VALID"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
 > RESULT="^TMP("GMVMGR",539343036)"
 
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539343036,0)=1^Valid Data 
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.
  
3) When the OPTION value is DELTEMP, this RPC will delete a data input
The RESULTS variable will contain the ^TMP("GMVMGR",$J) global array 
template definition.
  
The DATA value is a two part value separated by a caret (^). The first 
value is the ENTITY value. See IA #2263 for a list of entity values.
The second value is the name of the data input template.
  
Example:
 > S DATA="USR^PAIN ONLY"
 > S OPTION="DELTEMP"
 > D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
reference. The ^TMP("GMVMGR",$J) global array contains the results.
 > RESULT="^TMP("GMVMGR",539356158)"
 > D ^%G
 > Global ^TMP("GMVMGR",$J
 > ^TMP("GMVMGR",539356158,0)=1^Template Removed. 
 
If an error is encountered, a "-1" followed by a caret and the error 
message text (i.e., -1^error message) is returned.
 
 
4) When the OPTION value is GETCATS, this RPC will return a list of 
 
qualifiers (FILE 120.52) associated with a vital type (FILE 120.51). 
  
The DATA value is a one part value. It is a pointer value to FILE 120.51
 
The TMP global contains:
 ^TMP("GMVMGR",$J,0)=piece1^piece2
 ^TMP("GMVMGR",$J,n)=piece3^piece4^piece5
   
 where piece1 = number of categories (FILE 120.53) associated with this 
                vital type
The OPTION variable identifies a line label in the GMVRPCM routine 
       piece2 = vital type name
       piece3 = category IEN (FILE 120.53)
       piece4 = category name (FILE 120.53, Field .01)
       piece5 = qualifier names (FILE 120.52, Field .01) separated by a 
                comma and space
            n = sequential number starting with 1 
 
Example:
 > S DATA="21" 
 > S OPTION="GETCATS"