Install VistA/RPMS Clients

FOIA VistA & OSEHRA VistA

Accessing VistA Using the CPRS, Vitals, and BCMA Demo Client Applications

VistA CPRS, Vitals, and BCMA are Windows client applications. Please use the following steps to install the CPRS, Vitals, and BCMA.

  1. Download OSEHRA CPRS Demo and install to the Windows machine.
  2. If you would like to access the OSEHRA CPRS Demo Server and not your local instance of VistA, skip to step 4.
  3. From the Windows desktop, right click on the CPRS Demo shortcut.
    Select Properties menu.
    From the Target: field under the Shortcut tab, change the string S=demo.osehra.org to S=127.0.0.1.
    Click on OK to close the Properties dialog.
    Perform the same steps for the Vitals and BCMA Demos.
  4. To run CPRS Demo: From Windows desktop, click on OSEHRA CPRS Demo.
    Enter Access/Verify code for user “Doctor” from the Introduction Text.
    You should see dialog containing a list of patients. To learn how to use CPRS, please consult the CPRS User Guide: GUI Version or for a more in depth training, see the free, online interactive CPRS training course available from VA eHealth University.
  5. To run Vitals Demo: From Windows desktop, click on OSEHRA Vitals Demo.
    Enter Access/Verify code for user "Doctor" from the Introduction Text.
    To learn how to use the Vitals including the Vitals Manager, please consult the Vitals/Measurements User Manual.
  6. To run BCMA Demo: BCMA Demo requires some initial setup to run properly.
    a) From Windows desktop, click on OSEHRA BCMA Parameters Demo.
    After login as the "Doctor", enter "6100" for the Division when prompted.
    Click on the menu item "File->Open", check the "BCMA On-line" box.
    Close the BCMA Parameters Demo.
    b) Then double-click on the OSEHRA BCMA Demo icon.
    To learn how to use the BCMA including the BCMA Parameters, please consult the Bar Code Medication Administration (BCMA) GUI User Manual Part I and BCMA GUI User Manual Part II

Accessing VistA Using the Roll-and-Scroll UI

Using Putty ssh client, connect to the OSEHRA VistA using IP address: 127.0.0.1 and Port: 2222. The following instruction only provides the steps to login to the OSEHRA VistA instance. To use the Roll-and-Scroll features, please consult FileMan 22.0 Getting Start Manual.

  • To login as a doctors, nurse, or clerk, use “osehratied” user account:

Then type the password “tied”at the password prompt.

The “osehratied” account is designed for regular VistA users to access roll-and-scroll applications. This user is tied to the ^ZU routine.

  • To login as the system manager, use “osehraprog” user account:

Type the password “prog” at the password prompt.

The osehraprog is designed for programmer users to access the M prompt. This is the equivalent of typing mumps -dir at the command line.

  • To login as a Linux root user:

If you are using Vagrant, you need to "vagrant ssh" into the machine then "sudo su -" to become root.

If you are using Docker, ssh using the root user. The password is "docker".

If you are logged in as the "root” system account, you can use the system like any other Linux box. If you need to access the VistA environment, perform the following command: ~$ mumps -dir, which will give you a programmer prompt. To get to the normal VistA login screen at the OSEHRA> prompt, type the following: D ^ZU.

NOTE: the prompt OSEHRA> is based on the $instance variable as referenced above.

vxVistATM

After you have installed the vxVistATM server, you can download the clients onto a Windows machine and run them. Clients are available here: http://code.osehra.org/files/clients/vxVistA/. To get all of them at once, rather than download them one by one, download the zip file.

Once downloaded, you can unzip the file anywhere. Then, for each client exe, right click and, under the 'Send to' menu, find 'Desktop (create shortcut)'.
Right click on the newly created icon on the desktop and click on properties. The next window you see should be the "Shortcut Properties".
Edit the Target field by adding 's=127.0.0.1 p=9430' to the end of the target text already there, then press "okay."

These are exes you will need to make shortcuts for:

  • vxBCMA.exe in the vxBCMA folder
  • vxBCMAPar.exe in the vxBCMA folder
  • vxCPRSChart.exe in the vxCPRS folder
  • vxGroupNotes.exe in the vxGroupNotes folder
  • vxPatientPicture.exe in the vxPatientPicture folder
  • vxVitals.exe in the vxVistals folder
  • vxVitalsManager.exe in the vxVitals folder

To learn how to use CPRS, please consult the CPRS User Guide: GUI Version or for a more in depth training, see the free, online interactive CPRS training course available from VA eHealth University.

To learn how to use the Vitals, including the Vitals Manager, please consult the Vitals/Measurements User Manual.

To learn how to use the BCMA, including the BCMA Parameters, please consult the Bar Code Medication Administration (BCMA) GUI User Manual Part I and BCMA GUI User Manual Part II.

To learn how to use Group Notes, please consult the Group Notes User Manual.

Accessing VistA Using the Roll-and-Scroll UI

Using Putty ssh client, connect to vxVistATM using IP address: 127.0.0.1 and Port: 2222.To use the Roll-and-Scroll features, please consult FileMan 22.0 Getting Start Manual.

  • To login as a doctors, nurse, or clerk, use “vxvistatied” user account:

Then type the password “tied”at the password prompt.

The “vxvistatied” account is designed for regular VistA users to access roll-and-scroll applications. This user is tied to the ^ZU routine.

  • To login as the system manager, use “vxvistaprog” user account:

Type the password “prog” at the password prompt.

The vxvistaprog is designed for programmer users to access the M prompt. This is the equivalent of typing mumps -dir at the command line.

  • To login as a Linux root user:

If you are using Vagrant, you need to "vagrant ssh" into the machine then "sudo su -" to become root.

If you are using Docker, ssh using the root user. The password is "docker".

If you are logged in as the "root” system account. You can now use the system like any other Linux box. If you need to access the VistA environment you can perform the following command: ~$ mumps -dir, which will give you a programmer prompt.
To get to the normal VistA login screen type the following at the VXVISTA> prompt: D ^ZU.

RPMS

There are many clients for RPMS. They are all Microsoft Windows applications. At this point in time, OSEHRA has no plans to test all of them. We packaged four clients that are commonly used: Patient Registration, Scheduling, iCare, and VueCentric (a.k.a. RPMS-EHR). They are found here: https://code.osehra.org/files/clients/RPMS/. The port for the CIA broker is 9100. For iCare, Scheduling, and Registration, you will be prompted for the host and port. The port is 9101 for BMX-based applications.

If you installed RPMS on a Mac or Linux, you will need to point the IP address to the Mac or Linux machine. If you installed on Windows, your IP address will be `localhost`.

The rest of the RPMS clients can be found at https://code.osehra.org/journal/journal/view/?revisionId=1087 for the current release.

VueCentric Setup

VueCentric needs some Windows-specific set-up before you start using it for the first time:

  1. First, you need to install .Net 3.5.
    Type WIN+R to open the run box, type "appwiz.cpl",
    Click on "Turn Windows Features on or off" on the left hand side bar,
    Choose ".Net Framework 3.5 (includes .Net 2.0 and 3.0)" and then press "okay".
  2. Second, open a command prompt as an administrator. Follow this guide: https://technet.microsoft.com/en-us/library/cc947813(v=ws.10).aspx.
    Once you are there, cd to where you unzipped VueCentric to the utl folder. For example, if you unzipped it on your desktop, you can type:
    cd %USERPROFILE%\Desktop\vuecentric\utl\
    Then invoke ComReg.exe to register all the objects in lib and bin.
    COMReg.exe -r ..\bin\
    COMReg.exe -r ..\lib\
  3. Once you have done that, edit the vcBroker.ini files in both utl and bin so that you have the correct RPMS server IP address. The CIA Broker port is 9100.
  4. At this point, you are ready to use VueCentric.
    Double click on the VueCentric.exe in the bin folder.
    You MUST ALWAYS invoke it from the bin folder, since the object repository is configured (by default) to be in ..\lib, which can only be found if you invoke it from the bin folder.

Happy browsing. Remember that if you want to add more patients, you can use the registration GUI.

Other clients set-up (Registration, Scheduling, iCare)

These are all just installable programs. Run the installer .msi file that is in the zip and the program will be installed. Then find it in the start menu to run it. When prompted for the server, put the host, port, and leave the namespace blank. When prompted for the access/verify code, put it on the access/verify codes that are supplied with the RPMS instance. ADAM.01/USER.001 works.