| 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"
|
