| TITLE | VALUE | |
|---|---|---|
| NAME | GMV LOCATION SELECT | |
| DESCRIPTION | Select a hospital location by name, from a patient appointment or from a patient admission. Can also generate a list of active clinics. This remote procedure is documented in Integration Agreement 4461. | |
| TAG | RPC | |
| ROUTINE | GMVRPCHL | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 1 |
| INPUT PARAMETER | OPTION | |
| DESCRIPTION | Routine tag line in GMVRPCHL to call. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | 10 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 2 |
| INPUT PARAMETER | DATA | |
| DESCRIPTION | Other data as required for the call. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | 100 | |
| RETURN VALUE TYPE | GLOBAL ARRAY | |
| RETURN PARAMETER DESCRIPTION | This remote procedure call allows the user to select a hospital location. The entry point is RPC^GMVRPCHL. It has input parameters of RESULTS, OPTION and DATA (ex. RPC^GMVRPCHL(.RESULTS,OPTION,DATA). The RESULTS variable will contain the ^TMP("GMVHLOC",$J) global array reference. The ^TMP("GMVHLOC",$J) global array contains the results. The OPTION variable identifies a line label in the GMVRPCHL 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 NAME, this RPC will do a file lookup. The DATA value is a three part value separated by carets(^). 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("GMVHLOC",$J,0)=piece1 ^TMP("GMVHLOC",$J,n)=piece2^piece3 where piece1 = number of entries found piece2 = file number, a semi-colon and record IEN piece3 = field value Example: >S OPTION="NAME",DATA="44^OUTPATIENT^.01" >D RPC^GMVRPCHL(.RESULT,OPTION,DATA) ZW RESULT >RESULT="^TMP("GMVHLOC",539052767)" >D ^%G >Global ^TMP("GMVHLOC",$J >^TMP("GMVHLOC",539052767,0)=3 1)=44;75^OUTPATIENT NUC MED 2)=44;74^OUTPATIENT RADIOLOGY 3)=44;80^OUTPATIENT ULTRASOUND 2) When the OPTION value is APPT, this RPC will return a list of clinic appointments for the patient. The DATA value is a four part value separated by carets(^). The first piece is DFN. The second piece is the start date of the search. If not defined, this value defaults to 365 days prior to today. The third piece is the end date of the search. If not defined, the value defaults to today. Both dates are in FileMan internal format. The fourth piece is a string of numbers to indicate what types of appointments to return. If not defined, the value defaults to "123456789" (i.e., all appointment types) where: 1 - Active/Kept 2 - Inpatient appts. only 3 - No-shows 4 - No-shows, auto-rebook 5 - Cancelled by clinic 6 - Cancelled by clinic, auto rebook 7 - Cancelled by patient 8 - Cancelled by patient, auto rebook 9 - No action taken The TMP global contains: ^TMP("GMVHLOC",$J,0)=piece1 ^TMP("GMVHLOC",$J,n)=piece2^piece3^piece4^piece5^piece6^piece7 ^piece8^piece9^ where piece1 = number of entries found piece2 = date/time of appt (FM internal) piece3 = date/time of appt (external) piece4 = hospital location IEN (FILE 44) piece5 = hospital location name (FILE 44, Field .01) piece6 = appt status (internal) piece7 = appt status (external) piece8 = appt type (internal) piece9 = appt type (external) Example: > S OPTION="APPT",DATA="78^3051201^3051206^" > D RPC^GMVRPCHL(.RESULT,OPTION,DATA) ZW RESULT > RESULT="^TMP("GMVHLOC",539052767)" > D ^%G > Global ^TMP("GMVHLOC",$J > ^TMP("GMVHLOC",539052767,0)=1 1)=3051206.1^DEC 6,2005@10:00^88^WEIGHT CLINIC^^^9^REGULAR 3) When the OPTION value is ADMIT, this RPC will return a list of hospital admissions for the patient specified. The DATA value is the patient's DFN. The TMP global contains: ^TMP("GMVHLOC",$J,0)=piece1 ^TMP("GMVHLOC",$J,n)=piece2^piece3^piece4^piece5^piece6 where piece1 = number of entries found piece2 = date/time of admission (external) piece3 = hospital location IEN (FILE 44) piece4 = hospital location name (FILE 44, Field .01) piece5 = type of movement (FILE 405.1, Field .01) piece6 = movement IEN (FILE 405) Example: > S OPTION="ADMIT",DATA=134 > D RPC^GMVRPCHL(.RESULT,OPTION,DATA) ZW RESULT > RESULT="^TMP("GMVHLOC",539052767)" > D ^%G > Global ^TMP("GMVHLOC",$J > ^TMP("GMVHLOC",539052767,0)=1 1)=Apr 09, 2001 1:48:43 pm^67^ 2-ASM^DIRECT^1712 4) When the OPTION value is CLINIC, this RPC will return a list of active clinics. The DATA value is FROM^MAXIMUM^DIRECTION. Where: FROM = Value to begin the search (optional). Default is null (i.e., start with the first entry in the B x-ref). MAXIMUM = Maximum number of entries to return. (optional) Default is 100. DIRECTION = Direction of search (optional). 1 means forward and -1 means backwards. Default is 1. The TMP global contains: ^TMP("GMVHLOC",$J,0)=piece1 ^TMP("GMVHLOC",$J,n)=piece2^piece3 where piece1 = number of entries found piece2 = 44;ien (44, a semi-colon and the entry number) piece3 = location name (FILE 44, Field .01) n is a sequential number starting with zero Example: > S OPTION="CLINIC",DATA="A^5^1" > K RESULTS D RPC^GMVRPCHL(.RESULTS,OPTION,DATA) ZW RESULTS > RESULTS="^TMP("GMVHLOC",540221719)" > D ^%G > Global ^TMP("GMVHLOC",$J > ^TMP("GMVHLOC",540221719,0)=5 1)=44;140^ANDY'S AUDIO NON-COUNT CLINIC 2)=44;139^ANDY'S AUDIOLOGY COUNT CLINIC 3)=44;76^AUDIOLOGY AND SPEECH PATHOLOGY 4)=44;87^BARB'S CLINIC 5)=44;217^BOISE OUTPATIENT If an error is encountered for NAME, ADMIT, APPT or CLINIC, a "-1" followed by a caret and the error message text (i.e., -1^error message) is returned in RESULT(0). | |
| AVAILABILITY | SUBSCRIPTION | |
| INACTIVE | ACTIVE | |
| CLIENT MANAGER | ||
| WORD WRAP ON | TRUE | |
| VERSION | ||
| SUPPRESS RDV USER SETUP | ||
| APP PROXY ALLOWED | ||