| DESCRIPTION OF ENHANCEMENTS |
VBEC*1*0 is being exported as part of the VBECS_BUNDLE_1.KID package
assigned as a Secondary Menu Option.
PROTOCOL:
=========
VBECS ADT-AO8 CLIENT - This protocol is used to deliver HL7 messages
from VistA to VBECS via the VBECSPTU logical link.
VBECS ADT-A08 ROUTER - This protocol is used to receive an HL7 message
from the VAFC ADT-A08 SERVER protocol and executes routing logic to
I. OVERVIEW
determine whether the message is to be forwarded to VBECS. VBECS
receives only messages that contain changes to various patient
demographic data.
VBECS ADT-AO8 SERVER - This event driver protocol is triggered by the
VBECS ADT-A40 CLIENT - This protocol is used to deliver the HL7
message from VistA to VBECS via the VBECSPTM logical link.
VBECS ADT-A40 SERVER - This event driver protocol is triggered by the
The VistA Blood Establishment Computer Software (VBECS) shall facilitate
VBECS OMG CLIENT - This is the subscriber protocol to the VBECS OMG
SERVER protocol that receives the HL7 message from VBECS providing
order updates to the original order message.
VBECS OMG SERVER - This protocol is triggered when an HL7 message from
VBECS is received by the HL7 package.
HL7 APPLICATION PARAMETER:
ongoing compliance with Food and Drug Administration (FDA) standards for
==========================
VBECS - This HL7 Application represents the VBECS side of the VBECS/CPRS
interface.
VBECS ADT - This HL7 Application represents the receiving application
of the Patient Update and Patient Merge router protocols.
VBECS TRIGGER - This HL7 Application represents the VBECS side of the
Patient Update and Patient Merge interfaces.
medical devices and enhance the Department of Veterans Affairs (VA)
HL LOGICAL LINK:
================
VBECS-OERR - Used to transmit HL7 messages from VBECS to CPRS.
VBECSPTM - Used to transmit HL7 messages from VistA to VBECS when a
patient merge event occurs.
VBECSPTU - Used to transmit HL7 messages from VistA to VBECS when a
patient update event occurs.
Veterans Health Administration's (VHA) ability to deliver quality
PARAMETER DEFINITION:
=====================
VBECS VISTALINK - Parameter definition used to identify all VBECS
Parameters.
PARAMETERS:
===========
LISTENER IP ADDRESS - Stores the value of the Blood Bank medical
device server where the VistALink listener is installed.
services to meet the needs of the user community. VBECS is considered an
LISTENER PORT NUMBER - Stores the value of the port number where Blood
Bank medical device VistALink listener is listening.
These Parameters are used by M APIs to build the XML messages used by
VistALink.
VBECS Blood Products
VBECS DSS Extract
VBECS Order Entry
VBECS Patient ABID
VBECS Patient ABO_RH
encapsulated medical device and therefore does not communicate directly
VBECS Patient Available Units
VBECS Patient Report
VBECS Patient TRRX
VBECS Patient Transfusion History
VBECS Update Workload Event
VBECS Workload
REMOTE PROCEDURE:
=================
VBECS ACCESSION AREA LOOKUP
with other VistA applications.
VBECS BLOOD BANK USER LOOKUP
VBECS DIVISION LOOKUP
VBECS DSS EXTRACT
VBECS HCPCS CODES LOOKUP
VBECS HOSPITAL LOCATION LOOKUP
VBECS LAB ACCESSION UID LOOKUP
VBECS LAB ORDER LOOKUP BY UID
VBECS LAB TEST RESULTS LOOKUP
VBECS LABORATORY TEST LOOKUP
VBECS MED PROFILE LOOKUP
VBECS PATIENT LOOKUP
VBECS PROVIDER LOOKUP
VBECS WORKLOAD CODES LOOKUP
GLOBALS - FILES:
===============
^VBEC(6002.01, - VBECS WORKLOAD CAPTURE File (#6002.01)
ICRs:
=====
release. The installation of this bundle will be controlled by phase
Two new namespaces are being introduced into the VistA enterprise with
The following ICRs were created to allow data transfer between the Blood
Bank medical device and the VBECS Application Interfacing Support
software.
4607, 4608, 4609, 4610, 4611, 4612, 4613, 4614, 4615, 4616, 4617,
4618, 4619, 4620, 4621, 4622, 4623, 4624, 4625, 4626, 4627, 4628, 4633
The following ICRs were created, or modified, to allow data transfer
between the VBECS Application Interfacing Support software and other
VistA applications.
1587, 1963, 2400, 2503, 2817, 3176, 3177, 3181, 3631, 3879, 4629,
the release of VBECS. The first, gov.va.med.vbecs, represents the Blood
4636, 4766, 4767, 4773, 4774, 4776, 4779,
ASSOCIATED REMEDY TICKETS
=========================
N/A
TEST SITES:
===========
HEARTLAND-EAST HCS
PHILADELPHIA, PA
Bank medical device software. The second, VBEC, represents the VBECS
SAN DIEGO, CA
SACC Exemptions:
================
XINDEX displays the following warning. The Standards And Conventions
Committee granted an exemption to allow the use of a star read on May 4th
2006.
VBECRL * * 114 Lines, 4099 Bytes, Checksum: B10917646
FOR READ VBECX#VBECREAD:VBECTO SET TOFLAG=$T DO:VBECFRST CHK
Application Interfacing Support software. The VBEC namespace, created in
DO:'VBECS
TOP QUIT:DONE
READ+6 I - Star or pound READ used.
Installation Sequence
======================
The files listed below represent the patches that will be part of the
controlled phased release. Follow the sequence listed below when your
phased installation occurs.
the VBEC 1.0 KIDS build, will be added to the Package file in VistA and
1. LR*5.2*335
2. LR*5.2*367
3. VBECS Bundle (consisting of VBEC*1*0 and LR*5.2*325)
4. VBEC*1.0*1
5. OR*3.0*212
Documentation Retrieval:
Documentation is available for the entire VBECS package on the
ANONYMOUS.SOFTWRE directory at one of the following Office of Information
is used to identify the M software and files that support interfacing
(OI) Field Offices. Sites may retrieve documentation in either ".PDF" or
"DOC" format in one of the following ways:
1. The preferred method is to FTP the files from :
Download.vista.domain.ext
2. Sites may also elect to retrieve documentation directly from a
specific server as follows:
Albany ftp.fo-albany.domain.ext
Hines ftp.fo-hines.domain.ext
other VistA applications with the Blood Bank medical device. This
Salt Lake City ftp.fo-slc.domain.ext
NOTE: The documentation files listed below will be listed in each of the
VBECS and LR patches that are part of the VBECS package and associate
patches, they only need to be downloaded once.
File Name Retrieval format: Binary
=========== ==========================
Blood Bank Pre-Implementation Data Validation, Mapping, and Conversion
ADPAC Guide.doc
software is not released as part of the Blood Bank medical device.
Blood Bank Pre-Implementation Data Validation, Mapping, and Conversion
ADPAC Guide.pdf
Blood Bank Pre-Implementation Data Validation, Mapping, and Conversion
Installation and User Guide.doc
Blood Bank Pre-Implementation Data Validation, Mapping, and Conversion
Installation and User Guide.pdf
Blood Bank Pre-Implementation Data Validation, Mapping, and Conversion
Technical Manual.doc
Blood Bank Pre-Implementation Data Validation, Mapping, and Conversion
Technical Manual.pdf
VBECS Data Conversion Recommended Validation Method.xls
VBECS Application Interfacing Support Software Installation and User
Configuration Guide.doc
VBECS Application Interfacing Support Software Installation and User
Configuration Guide.pdf
VBECS Implementation Process.xls
VistA Blood Establishment Computer Software (VBECS) 1.4.0.0 Installation
Guide.doc
VistA Blood Establishment Computer Software (VBECS) 1.4.0.0 Installation
Guide.pdf
II. FUNCTIONAL OVERVIEW
VistA Blood Establishment Computer Software (VBECS) 1.4.0.0 Technical
Manual-Security Guide.doc
VistA Blood Establishment Computer Software (VBECS) 1.4.0.0 Technical
Manual-Security Guide.pdf
VistA Blood Establishment Computer Software (VBECS) 1.4.0.0 User Guide.doc
VistA Blood Establishment Computer Software (VBECS) 1.4.0.0 User Guide.pdf
Known Defects and Anomalies.doc
Known Defects and Anomalies.pdf
INSTALLATION INSTRUCTIONS:
release. An Implementation Manager will be assigned to your site and
The reengineered Blood Bank system uses VistALink and Health Level Seven
==========================
Pre-Installation Items:
=======================
Environment Check:
------------------
Programmer access is required to install this patch. Prior to
installation, the installer must ensure the DUZ(0) node of the DUZ array
is set to the "@" symbol.
(HL7) messaging for data exchange with a client-server mode application
Users on the System:
--------------------
This patch may be installed with users on the system.
Software Installation Time:
---------------------------
The estimated installation time for this patch is less than
5 minutes during non-peak hours.
interfacing architecture through M Application Programmer Interfaces
Queuing:
---------
Note: Patch installation requires responses from the installer and
must not be queued.
Pre-requisites:
---------------
Patch installer must enter the collection sample types for new Lab
tests created during installation. Obtain sample types from the
Laboratory Information Manager
(APIs), VistA Remote Procedure Calls (RPCs), and HL7 interfaces released
Namespace:
----------
The namespace for the VBECS Application Interfacing Support package is:
Name: VBECS - Prefix: VBEC
Required Patches:
-----------------
Application Patch/Build
----------------------------- -----------
in the VBEC 1.0 KIDS build.
Laboratory Services LR*5.2*187
LR*5.2*288
LR*5.2*294
Toolkit XT*7.3*58
New File and Global Information:
--------------------------------
There is one new global, ^VBEC. The ^VBEC global contains the
following new file.
Journaling
File # File Name Global Root Recommended
------ ------------------------ ------------ -----------
6002.01 VBECS WORKLOAD CAPTURE ^VBEC(6002.01, YES
VBECS Configuration Checklists:
-------------------------------
a. Complete Appendix D: Configuration Checklist of the VistA Blood
Establishment Computer Software (VBECS) Installation Guide.
b. Complete Appendix B: Configuration Worksheet of the VBECS
Application Interfacing Support Software Installation and User
This software will provide a transparent database transition through the
Configuration Guide.
Installation Steps:
===================
The installation of VBECS and its related patches are being handled as a
controlled release. The implementation manager will contact you with the
location of the KIDS Host Files prior to your scheduled installation
date. The documentation files will be available for download in advance
of installation through the anonymous download site.
use of M APIs, RPCs, and HL7 interfaces. The APIs released in this build
1. Use the 'LOAD A DISTRIBUTION' option (#1) on the 'KIDS INSTALLATION'
menu, and enter: VBECS_BUNDLE_1.KID
2. From the 'Kernel Installation & Distribution System' menu, select
the Installation menu.
3. From this menu, you may now elect to use the following options (when
prompted for INSTALL NAME, enter VBECS BUNDLE 1.0)
will allow other VistA applications to continue the retrieval of Blood
a. Backup a Transport Global - This option will create a backup
message of any routines exported with the patch. It will NOT
backup any changes such as DDs or templates.
b. Compare Transport Global to Current System - This option will
allow you to view all changes that will be made when the patch
is installed. It compares all components of the patch
(routines, DDs, templates, etc.).
c. Verify Checksums in Transport Global - This option will allow you
Bank data stored in the Blood Bank system. The RPCs will allow the Blood
to ensure the integrity of the routines that are in the
transport global.
d. Print Transport Global - this option will allow you to view the
components of the KIDS build.
4. Use the Install Package(s) option and select package
VBECS_BUNDLE_1.KID. This will automatically install VBEC*1*0
and LR*5.2*325
will contact your POC for VBECS and will provide your site with the
Bank system to continue to retrieve data from other VistA applications.
5. When prompted "Enter the Coordinator for Mail Group 'VBECS INTERFACE
ADMIN':", please enter the name of the individual that will be
responsible for maintaining the new mail group. This mail group
receives notifications when an HL7 transmission, or a query through
the VBECS VistALink client, to the Blood Bank medical device has
failed. The users added to this group would be Lab/Blood Bank
supervisors and/or IRM staff responsible for managing the VBECS
package and interfaces.
6. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
The HL7 interfaces will allow the exchange of data between the Blood Bank
Install? NO//', respond Yes.
7. When prompted 'VBECS Server IP Address:', enter the Cluster
IP address from Appendix B: Configuration Worksheet, Hardware
Information, row 1.
8. When prompted 'VBECS VistALink Listener Service Port Number:',
enter the VistALink Listener Service port number from
Appendix B: Configuration Worksheet, Hardware Information, row 2
for installing in the TEST account, row 3 for installing in the
system and other VistA applications.
PRODUCTION account.
9. When prompted 'Want KIDS to INHIBIT LOGONs during the install?
No//', it is recommended you answer NO.
8. When prompted 'Want to DISABLE Scheduled Options, Menu Options,
and Protocols? No//', respond NO
11. When prompted by "Select COLLECTION SAMPLE for Lab Test
ABO/RH - LAB:," select the collection sample appropriate for the
ABO/Rh test.
12. When prompted by "Select COLLECTION SAMPLE for Lab Test ANTIBODY
SCREEN - LAB:," select the collection sample appropriate for the
Antibody Screen test.
13. When prompted by "Select COLLECTION SAMPLE for Lab Test DIRECT
ANTIGLOBULIN TEST - LAB:," select the collection sample appropriate
for the Direct Antiglobulin Test test.
III. TECHNICAL COMPONENTS
14. When prompted by "Select COLLECTION SAMPLE for Lab Test TRANSFUSION
REACTION WORKUP - LAB:," select the collection sample appropriate
for the Transfusion Reaction Workup test.
15. When prompted by "Select COLLECTION SAMPLE for Lab Test
TYPE & SCREEN - LAB:," select the collection sample appropriate for
the Type & Screen test.
16. The POST Installation routine VBECPOST will be deleted from
your system automatically after successful installation.
This section lists the components of the VBECS, and LAB SERVICES
installed in VistA by the VBEC BUNDLE 1.0 Multi Package KIDS build that
supports VBECS.
location of the KIDS Host Files prior to your scheduled installation date
MAIL GROUP:
===========
VBECS INTERFACE ADMIN - Receives alert mail messages when problems
arise with VBECS Application Interfacing. The users added to this group
would be Lab/Blood Bank supervisors and/or IRM responsible for managing
the VBECS package and interfaces.
ROUTINES:
=========
VBECA1
Installation Sequence. The VBECS BUNDLE is a host file that consists of
VBECA1A
VBECA1B
VBECA1B1
VBECA3
VBECA3A
VBECA3B
VBECA3C
VBECA4
VBECA5A
VBECA5B
both VBEC*1*0 and LR*5.2*325. Installation of the VBECS BUNDLE will
VBECA6
VBECA7
VBECA7A
VBECA7A1
VBECA7B
VBECENV
VBECHLRT
VBECLU
VBECLU0
VBECLU3
automatically install both VBEC*1*0 and LR*5.2*325
VBECPOST
VBECRL
VBECRPC
VBECRPC1
VBECRPCA
VBECRPCB
VBECRPCC
VBECRPCD
VBECRPCE
VBECRPCH
=====================
VBECRPCM
VBECRPCP
VBECRPCW
VBECVLC
OPTION:
=======
VBECS VISTALINK CONTEXT - (B)roker type option used by VistALink to
authenticate users. All Blood Bank users must have this option
|
