GMV MANAGER

TITLEVALUE
NAMEGMV MANAGER
DESCRIPTIONPerforms many functions for the Manager module.

This remote procedure call is documented in Integration Agreement 4360.
TAGRPC
ROUTINEGMVRPCM
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETEROPTION
DESCRIPTIONRoutine tag line in GMVRPCM to call.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH10
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERDATA
DESCRIPTIONOther data as required for the call.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH100
RETURN VALUE TYPEGLOBAL ARRAY
RETURN PARAMETER DESCRIPTIONThis remote procedure call performs various actions such as building
selection lists and modifying package parameters. The entry point is
RPC^GMVRPCM. It has input parameters of RESULTS, OPTION and DATA (ex:
RPC^GMVRPCM(.RESULTS,OPTION,DATA).

The RESULTS variable will contain the ^TMP("GMVMGR",$J) global array
reference. The ^TMP("GMVMGR",$J) global array contains the results.

The OPTION variable identifies a line label in the GMVRPCM routine
that will be invoked to process the call.

The DATA variable contains any additional values needed by the OPTION
variable to process the call.


1) When the OPTION value is ADDQUAL, this RPC will link a GMRV VITAL
QUALIFIER (#120.52) file entry to a GMRV VITAL TYPE (#120.51) file entry.

The DATA value is a three part value separated by semi-colons(;). The
first value is the FILE 120.51 internal entry number (IEN). The second
value is the GMRV VITAL CATEGORY (#120.53) IEN. The third value is the
GMRV VITAL QUALIFIER (#120.52).

Example:

> S DATA="1;1;1"
> S OPTION="ADDQUAL"
> D RPC^GMVRPCM(.RESULT,OPTION,DATA) ZW RESULT
> RESULT="^TMP("GMVMGR",539356158)"
> D ^%G
> Global ^TMP("GMVMGR",$J
> ^TMP("GMVMGR",539356158,0)=1^Qualifier Assigned

If an error is encountered, a "-1" followed by a caret and the error
message text (i.e., -1^error message) is returned.


2) When the OPTION value is DELQUAL, this RPC will unlink a qualifier to
a GMRV VITAL TYPE (#120.51) file entry.

The DATA value is a three part value separated by semi-colons. The first
value is the FILE 120.51 internal entry number (IEN). The second value is
the GMRV VITAL CATEGORY (#120.53) IEN. The third value is the GMRV VITAL
QUALIFIER (#120.52) IEN.

Example:
> S DATA="1;1;1"
> 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^Qualifier removed.

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

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

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.


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

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

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.

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

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
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
^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
(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

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


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

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),
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)"
> 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"
> 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.


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

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


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.

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
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
> ^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
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.
AVAILABILITYSUBSCRIPTION
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED