Register a Patient

       do LO^DGUTL
       set DGCLPR=""
       new DGDIV set DGDIV=$$PRIM^VASITE
 
       if DGDIV>0 set %ZIS("B")=$piece($get(^DG(40.8,+DGDIV,"DEV")),U,1)
 
       kill %ZIS("B")
       if '$data(DGIO),$piece(^DG(43,1,0),U,30) do
       . set %ZIS="N",IOP="HOME"
       . do ^%ZIS
 
A      do ENDREG^DGREG($get(DFN))
       do  if (Y<0) goto EditDone
       . W !!
       . if $get(AddOK)=1 do
       . . set DIC=2,DIC(0)="ALEQM"
       . . set DLAYGO=2
       . else  do
       . . set DIC=2,DIC(0)="AEQM"
       . . set DLAYGO=0
       . kill DIC("S")
       . do ^DIC
       . kill DLAYGO
       . if Y<0 quit
       . set (DFN,DA)=+Y
       . set DGNEW=$P(Y,"^",3)
       . new Y
       . do PAUSE^DG10
       . do BEGINREG^DGREG(DFN)
       . if DGNEW D NEW^DGRP
  
       if +$get(DGNEW) do
       . ;" query CMOR for Patient Record Flag Assignments if NEW patient and
       . ;" display results.
       . if $$PRFQRY^DGPFAPI(DFN) do DISPPRF^DGPFAPI(DFN)

       set (DGFC,CURR)=0
       set DA=DFN
       set DGFC="^1"
       set VET=$select($data(^DPT(DFN,"VET")):^("VET")'="Y",1:0)
 
       set %ZIS="N",IOP="HOME"
       do ^%ZIS
       set DGELVER=0
       ;"do EN^DGRPD
       ;"if $data(DGRPOUT) do  goto A
       ;". do ENDREG^DGREG($G(DFN))
       ;". do HL7A08^VAFCDD01
       ;". kill DFN,DGRPOUT
 
       ;"do HINQ^DG10
       if $D(^DIC(195.4,1,"UP")) if ^("UP") do ADM^RTQ3

       do REG^IVMCQ($G(DFN))  ;" send financial query

       set DGRPV=0
       do EN1^DGRP

EditDone

       quit

To use this function, you will need to put it into a file. In my system, I have it saved in /usr/local/OpenVistA_UserData/r/TMGMISC.m

To execute it, one could do this: do EDITPT^TMGMISC(1) but this must be done from a programmer's Prompt--not good for a final running system.

So the best way is to create a menu option that executes this.

I'll try to come back later and specify how this is done. But in short, create a menu that is an Action. And make the execution Action to be: DO EDITPT^TMGMISC(1)

Here is an e-mail that I wrote with more instructions: KT setting up Add-Edit Patient

Kevin Toppenberg 4-2-2005

Importing legacy data

[Back to Contents]

This actually applies to any file import, like referring doctors, cpt codes, etc. Helpful resources here are VPE http://www.hardhats.org/tools/vpe/vpe_db.html and the FileMan documentation from VDL http://www.va.gov/vdl/default.asp.

1. FileMan has "mandatory" fields for each file, so you either need to import these, or change the file attributes so that they are no longer "mandatory". The latter is actually easier. You can display a list of "required" fields for any file if you install VPE. Alternetively, using the Data Dictonary option in FileMan, display the fields, and make note of those, "mandatory" fields you don't want to import. Then, from FileMan’s main option, "MODify file attributes" to change "mandatory" to "no" for these fields.

2. FileMan can import external data directly from spreadsheets (Excel, 1-2-3) in various formats, or from user defined formats including comma or tab delimited and fixed length fields. In, theory you could use any delimiter. I have used CSV files with quoted text. You could write a routine to parse your data or export data from your old system to a spreadsheet, choose the fields you want to import and save those columns. Make note of the order of the fields and the data they contain.

3. Some formatting Issues here. You will probably have to do some editing of your data. FileMan likes names as: LAST,FIRST M, dates as: MMDDCCYY, phone numbers and SSN’s as numeric, unformatted. I haven’t tried to import “name components” directly to see if FileMan would fill the full name field directly. Watch out for programs which supress leading zeros in dates and SSN’s, they need to have the proper number of digits.

4. Enter FileMan and under "OTHer options", choose “IMport data”. You have 'external data', choose your saved format under 'foreign format' or just tell FileMan how you saved it: no to fixed length, comma delimited and yes to fields quoted. Enter the full path of the directory where you saved source file then the file name. Then enter "Patient" or the destination file in “Primary file”.

5. Choose 'field selection page'. You are then presented with the selection page where you specify the fields, in the order that they appear in the saved file. You can save this as a template to repeat the same import a second time.

6. When you have selected all the fields you wish to import, exit, save and run the import. If you didn't fill or remove the 'mandatory' for a required field you'll get an error which doesn't tell you which field. Format errors, like dates and SSN’s are identified.

Mike Schrom 10/31/05

Misc Configuration Scripts

(Registering a patient)

Contents

Notes Adding a Menu to Register a Patient Overview of Registering a Patient Installing CIRN and the MPI Infrastructure

Editor's Notes:

This was sent to me by Nancy Anthracite. I was searching for a way to register a patient--i.e. how to add a new patient to the system. She wrote "Kevin - I think this stuff may already be installed, but the second section will explain some of what you want to know. -Nancy".

These example scripts are run on a Cache' system. I assume that the steps will be applicable to GT.M

[Back to Contents]

 Assigning a Menu to Register a Patient

[Back to Contents]

In order to register a patient, you can use your powers as System Manager with all of the keys to do it, but instead, you can set up a Director of Admissions who has the ability to work with the MASTER PATIENT INDEX/PATIEND DEMOGRAPHICS (MPI/PD) system and register a patient. This Director of Admissions was give access to three menus as indicated below, the last of which allows registration of a patient. Throughout this document BOLD RED indicates user input.

VISTA>D ^ZU

Volume set: VISTA:CACHEWEB UCI: VISTA Device: |TRM|:|4052 (TRM:)

ACCESS CODE: *******

VERIFY CODE: ********

Good afternoon MANAGER,SYSTEM

You last signed on Jun 2,2003 at 00:0

Select TERMINAL TYPE NAME: C-VT100//

Digital Equipment Corporation VT-100 video
 
WARNING -- TASK MANAGER DOESN'T SEEM TO BE RUNNING!!!!

Select Systems Manager Menu Option: FM VA FileMan

VA FileMan Version 22.0

Select VA FileMan Option:

Select VA FileMan Option: ENTER or Edit File Entries

INPUT TO WHAT FILE: NEW PERSON//
 
EDIT WHICH FIELD: ALL// PRIMARY MENU OPTION

THEN EDIT FIELD: SECONDARY MENU OPTIONS (multiple)
 
EDIT WHICH SECONDARY MENU OPTIONS SUB-FIELD: ALL//

THEN EDIT FIELD:

Select NEW PERSON NAME: DA ADMISSIONS,DIRECTOR DA

PRIMARY MENU OPTION: MPI/PD MASTER MENU RGMGR MPI/PD Master Menu

Select SECONDARY MENU OPTIONS: RG ADMIN COORD MENU MPI/PD Patient Admin  Coordinator Menu

Are you adding 'RG ADMIN COORD MENU' as a new SECONDARY MENU OPTIONS (the 1ST for this NEW PERSON)? No// Y (Yes)

SYNONYM: CORD

Select SECONDARY MENU OPTIONS: RG ADMIN COORD MENU

// DG REGISTRATION MENU Registration Menu
 
Are you adding 'DG REGISTRATION MENU' as a new SECONDARY MENU OPTIONS (the 2ND for this NEW PERSON)? No// Y (Yes)

SYNONYM: REGM

Select SECONDARY MENU OPTIONS:

Overview of Registering a Patient

[Back to Contents]

When you actually register your test patient, it might be helpful to you to know some information and terminology. All test patients in the VistA system at the VA are given social security numbers beginning with 5 zeros. These are recognized as test patients and automatically excluded from any uploads to central patient directories. Patients may also be given pseudo social security numbers in some circumstances, for instance, when the SS number is not known.

Information about PSEUDO SOCIAL SECURITY NUMBERS can be found by typing ?? at the Prompt to enter the social security number when you are registering a patient. If you just enter a number followed by a P, that will also give you more information as the system will admonish you for not doing it right and tell you what to do. If you still don't do it correctly, the Pseudo SS number will be generated for you.

The most important fields used in keeping track of patients in the VA are the NAME, SS#, DOB (Date of Birth) and (DFN - file number of some sort??). If you follow this convention, it is likely to help you utilize the more advanced features for finding patients in other clinics, etc., if you ever utilize this system in a grand scale. It is also recommended that auditing be done AT LEAST of changes in these fields and SEX. (Auditing is discussed later on in this document.)

When registering a new patient, an attempt will be made to access the MPI (Master Patient Index) which, for the VA, is a centralized master patient file in Austin, Texas. You will also see mention of the CMOR (Coordinating Master of Record), which is the main site where a patient receives care and where the main Record] of the patient is maintained. There is also the ICN - the Integration Control Number - which is like a patient number that can be assigned locally or where the Master Patient Index is maintained (i.e., Austin for the VA).

Installing CIRN and the MPI Infrastructure

Checking the Patch Level
 Checking for RG* Globals
 Unmapping routines
 Journaling
 Find the Value of a Field in a File
 Be sure DUZ(0)=@ and U="^"
 Proceed with the KIDS installation

[Back to Contents]

You may simply register a patient using this assigned menu, but because it may not be desirable to use social security numbers for patient identifiers within a medical care system, documentation of how to install the Master Patient Index system short of actually having it contact Austin , Texas follows. This will allow for the generation of ICNs that have the first 3 numbers as identifiers of the location where the patient was registered. This would be useful with a medical care system with multiple clinics, etc., as it might help to keep track of patients from various clinics if they are gathered in one central database. This is the equivalent of installing the test account for the Clinical Information Resource Network - Patient Demographics (CIRN-PD) and the Master Patient Index (MPI).

Installing the test account is the same as installing the full system except that the patch HL*1.6*39 is not installed. That is the patch that actually allows the system to contact Austin, Texas where the central VA Master Patient index is maintained. HL*1.6*39 must not be installed or your system will sending unwanted information to the VA MPI in Austin.

The installation of this system is documented in the Clinical Information Resource Network Patient Demographiscs (CIRN-PD) and Master Patient Indes (MPI) Installation and Implementation Guide, Version 2, Package Version 1.0, August 2000, Draft which can be found at : http://www.va.gov/vdl/documents/Infrastructure/Master_Patient_Index_(MPI)/rg1_0_ig2.doc

You will need to obtain these instructions as this document is made to supplement that document to allow "newbies" to use the official instructions.

Checking the Patch Level [back]

Beginning right on page 1 of the manual, you will need to check the patch level of various packages listed to be sure they are patched as they should be. Vista Platinum is patched to the current level in almost all packages, so this is unlikely to be a problem, but you will need to check. This is done by assigning yourself the XPD PRINT PACKAGE PATCHES, or Display Patches for a Package as a Secondary Menu. Assuming you have followed the prior documentation and are now the SM or "Manager, System" with all of the keys assigned, you will assign this menu to yourself in the New Person file, secondary menu field as follows (except the KIDS synonym may already be entered for you):

VISTA>D Q^DI

VA FileMan 22.0

Select OPTION: ENTER OR EDIT FILE ENTRIES

INPUT TO WHAT FILE: HL LOGICAL LINK// 200 NEW PERSON (8 entries)

EDIT WHICH FIELD: ALL// SECONDARY MENU OPTIONS (multiple)

EDIT WHICH SECONDARY MENU OPTIONS SUB-FIELD: ALL// SYNONYM

THEN EDIT SECONDARY MENU OPTIONS SUB-FIELD: (Hit enter here)

THEN EDIT FIELD:(Hit enter here)

Select NEW PERSON NAME: SM MANAGER,SYSTEM SM Clinical Coordinator

Select SECONDARY MENU OPTIONS: // XPD PRINT PACKAGE PATCHES Display Patches for a Package

...OK? Yes// (Hit enter here) (Yes)

//
 
SYNONYM: // KIDS

Select SECONDARY MENU OPTIONS: ^

On page 1 and 2 is a table with a list of the packages and patches. You will need to go into the programmers Prompt, select the secondary menu and list the patches for the patches. The tricky part is how you ask for the packages. In the order that they appear, I have listed what you type in to get the package you want at the Prompt "Select PACKAGE NAME." There doesn't seem to be any rhyme or reason to whether you need to enter the package namespace like XT or whether you enter a name like Clinical Info Resource Network. The table below has the VA Application name on the left and what you need to type at the Prompt on the right. The way to figure out what to try is to look at the file custody document and the namespaces document in the software directory on ftp://ftp.va.gov/vista/software .

 Application Name in pg. 1 & 2
 
 What to enter at Select PACKAGE NAME:

 CIRN

 CLINICAL INFO RESOURCE NETWORK

 Scheduling

 SCHEDULING

 PIMS

 DG REGISTRATION

 Hl7
 
 HL
 
 MailMan
 
 MAILMAN
 
 Kernel

 (note: Kevin T gave up trying to format at this point.  
        I can't figure out what I am formatting.  I think it was
        formatted HTML that was cut-n-pasted here.)

XU KERNEL

Kernel Toolkit

XT

VA Fileman

VA FILEMAN

Extensible Editor

RGED - Not included in Platinum Release 4/2003*

Run Time Library

RGUT

Pharmacy

PHARMACY

Inpatient Medications

PSJ

Outpatient Pharmacy

PSO

It was removed with patch RGED*2.6*1 in Aug. 2001 because it contained a global with control characters. See the below for more information. Thanks to Fil Beza for providing this information.

PATCH NUMBER: RGED*2.6*01 PACKAGE NAME: EXTENSIBLE EDITOR

SUBJECT: EXTENSIBLE EDITOR - ELIMINATION OF PACKAGE

DATE APPLIED TO PRODUCTION: AUG 21, 2001@20:18:16

DATE ENTERED: AUG 13, 2001 DATE VERIFIED: OCT 02, 2001

PACKAGE NAMESPACE: RGED SEQUENCE NUMBER: 1

PRIORITY: MANDATORY

TEXT OF PATCH:

Run Date: OCT 02, 2001 Designation: RGED*2.6*1

Package : RGED - EXTENSIBLE EDITOR Priority: Mandatory

Version : 2.6 SEQ #1 Status: Released

Subject: EXTENSIBLE EDITOR - ELIMINATION OF PACKAGE

Category:

- Routine

- Other

Description:

Installation of patch RGED*2.6*1 is OPTIONAL.

Extensible Editor 2.6 was initially released to support

functionality within Master Patient Index/Patient Demographics

(MPI/PD) 1.0. The dependencies by MPI/PD on the Extensible Editor

product have been eliminated. All formal integration agreements

have been retired. Extensible Editor 2.6 is no longer supported

nationally, making it Class II software. If you choose to do so,

you can install patch RGED*2.6*1 to remove the Extensible Editor

package from VistA. This is a local decision, and the installation

of this patch is OPTIONAL.

It is STRONGLY recommended that all facilities install this patch.

The Extensible Editor Application contains a global that has embedded

control characters. This violates the VA Standards and Conventions

(SAC) and it is also in violation of the current ANSI MDC X11.1

Portability Standards.

The following demonstrates starting the job described above:

VISTA>D ^XUP

Setting up programmer environment

Terminal Type set to: C-VT100

Select OPTION NAME: EVE

1 EVE Systems Manager Menu

2 EVENT CAPTURE (ECS) EXTRACT AU ECX ECS SOURCE AUDIT Event Capture

(ECS) Extract Audit

3 EVENT CAPTURE DATA ENTRY ECENTER Event Capture Data Entry

4 EVENT CAPTURE EXTRACT ECXEC Event Capture Extract

5 EVENT CAPTURE MANAGEMENT MENU ECMGR Event Capture Management Menu

Press <RETURN> to see more, '^' to exit this list, OR

CHOOSE 1-5: 1 EVE Systems Manager Menu

WARNING -- TASK MANAGER DOESN'T SEEM TO BE RUNNING!!!!

Select Systems Manager Menu Option: KIDS Display Patches for a Package

Select PACKAGE NAME: CLINICAL INFO RESOURCE NETWORK RG

Select VERSION: 1.0// (Hit enter here) 04-28-99

Do you want to see the Descriptions? NO// (Hit enter here)

DEVICE: // HOME CONSOLE

PACKAGE: CLINICAL INFO RESOURCE NETWORK Jun 19, 2003 4:54 pm PAGE 1

PATCH # INSTALLED INSTALLED BY

VERSION: 1.0 JUN 28, 1999 MANAGER,SYSTEM

2 SEQ #1 OCT 19, 1999 MANAGER,SYSTEM

1 SEQ #2 JAN 25, 2000 MANAGER,SYSTEM

3 SEQ #3 MAY 25, 2000 MANAGER,SYSTEM

4 SEQ #4 JUL 24, 2000 MANAGER,SYSTEM

7 SEQ #5 AUG 24, 2000 MANAGER,SYSTEM

5 SEQ #6 SEP 05, 2000 MANAGER,SYSTEM

8 SEQ #7 OCT 04, 2000 MANAGER,SYSTEM

6 SEQ #8 OCT 27, 2000 MANAGER,SYSTEM

9 SEQ #9 NOV 27, 2000 MANAGER,SYSTEM

11 SEQ #10 NOV 27, 2000 MANAGER,SYSTEM

10 SEQ #11 JAN 03, 2001 MANAGER,SYSTEM

14 SEQ #12 FEB 28, 2001 MANAGER,SYSTEM

15 SEQ #13 FEB 28, 2001 MANAGER,SYSTEM

12 SEQ #14 APR 05, 2001 MANAGER,SYSTEM

16 SEQ #15 APR 05, 2001 MANAGER,SYSTEM

Enter RETURN to continue or '^' to exit:

///

Checking for RG* Globals [back]

The next job is to see if you need to place the RG* globals in the system. For this, check in Cache explorer to see if they are there. The following screen captures show how that is done.

Go to the Cache Cube, Click on Cache explorer, choose namespace VISTA and then Globals.

Now expand the list of globals by clicking on it and look for the RG* globals (^RGSITE, ^RGHL7, ^RGEQASN, RGEQEXC, ^RGSTAT, and ^RGEQ). You will see that in this version of VistA Platinum, they are present, but they are not mapped to a namespace because they are already in the vista namespace where they need to be. I have selected them in the screen capture below to make it easier to see.

Unmapping routines [back]

Next you are asked to find out if any of the routines listed on page 5 of the manual are mapped. This is not necessary to do that for Cache on Windows.

Journaling [back]

On page 5 you are asked to turn off journaling for ^RG* during the installation and then re-enabled. You are also advised to read patch HL*1.6*52 recommendations about global journaling. This is how that is done in Cache.

Locate the Namespace where ^RG* is translated. This will display whether journaling is enabled or not. Note Jrn column for Journaling. This will show listings for 300+ globals. Excerpts are shown below.

D ^%GD

Device: Right margin: 80=>

Show detail? No => YES

Global Directory Display of VISTA

4:26 PM Jun 20 2003

Global Vacant Own Grp Wld Net Growth 1st PB Jrn Keep

^%Z RWD R R RWD 2300 1120 N N