Remove 'Patch Description SD*5.3*704' from 'Clinical/Telehealth Management Platform (TMP)/'

This commit is contained in:
US DVA 2019-08-09 02:39:50 -04:00 committed by OSEHRA Agent
parent 78c584d4fe
commit 125230188b
1 changed files with 0 additions and 745 deletions

View File

@ -1,745 +0,0 @@
DEVICE: HOME// ;;100000 SSH VIRTUAL TERMINAL
$TXT Created by BURKHALTER,WILLIAM P at CHY0035D.FO-BAYPINES.MED.VA.GOV (KIDS)
on Thursday, 08/01/19 at 10:13
=============================================================================
Run Date: AUG 01, 2019 Designation: SD*5.3*704
Package : SD - SCHEDULING Priority: EMERGENCY
Version : 5.3 Status: Under Development
=============================================================================
Associated patches: (v)SD*5.3*650 <<= must be installed BEFORE `SD*5.3*704'
Subject: Tele Health Scheduling Enhancements
Category:
- Routine
- Data Dictionary
Description:
============
*** IMPORTANT NOTE ***
**************************************************************************
* Emergency Patches SD*5.3*704 and OR*3.0*496 will be released *
* mm/dd/yyyy. Production testing of these patches along with the *
* Tele Health Management Platform (TMP) application will be conducted *
* on mm/dd/yyyy by the following test sites: Fargo, Minneapolis and *
* Boise. *
* *
* A Go/No Go decision will be made on mm/dd/yyyy by the project *
* management team and communicated to the Regional Patch install teams *
* no later than mm/dd/yyyy via the Forum Patch Messaging system via the *
* G.Patch Mail Group. *
* *
* Do not install these patches until notified to do so. *
* *
**************************************************************************
Tele Health Management Platform (TMP) is implementing processes that will
keep Veterans Health Information Systems and Technology Architecture
(VistA) clinic and appointment data for tele health clinics and
appointments in sync with the TMP application. These real time updates
are triggered when appointments are made or cancelled in a clinic
that has a stop code or credit stop code that is associated with tele
health.
Real-time clinic updates are triggered when a new tele health clinic is
added at a medical center or if the stop code, credit stop code, clinic
name, treating specialty, service, or overbooks allowed fields are
edited. A real-time clinic update is also triggered if a tele health
clinic is inactivated or if an inactive tele health clinic is
reactivated. Tele health clinics are identified by stop code or credit
stop codes.
The current Get Consults (ORQQCN LIST) Remote Procedure Call (RPC)
doesn't return the Clinically Indicated Date (CID) when the consults are
returned to the calling application. TMP is replacing the call to the RPC
with an HL7 query/response message. The new process returns a list of the
patient's consults over the last two years and includes the CID field with
the data if it is available. Displaying the CID with the consult in TMP
provides the scheduler with the information needed to schedule an
appointment for the consults within the 30 day window after the CID.
Patch Components:
-----------------
Bulletins:
---------
N/A
Files & Fields Associated:
--------------------------
TMP is adding two new indices to the PATIENT File (#2), the APPOINTMENT
Multiple field (#2.98). These new indices will trigger an update to be
sent to TMP when an appointment is made or cancelled.
TMP is adding one new index on the HOSPITAL LOCATION File (#44) on the
fields list below. This new index triggers an update to TMP when one or
more of these fields are edited.
These new indices are installed with a post install routine.
File Name(#),
Sub-File Name (#) Field Numbers New/Modified/Deleted
------------------ ------------------- --------------------
PATIENT (#2),
APPOINTMENT (#2.98) .01 New Index: AX298
3 New Index: AY298
SD TELE HEALTH STOP
CODE FILE (#40.6) New File
HOSPITAL LOCATION (#44) .01,8,2503,9.5,9,16,
1918,2505,2506 New Index: ATMP1
Forms Associated:
Form Name File # New/Modified/Deleted
--------- ------ --------------------
N/A
Mail Groups Associated:
Mail Group Name New/Modified/Deleted
--------------- --------------------
N/A
Options Associated:
Option Name Type New/Modified/Deleted
----------- ---- --------------------
EDIT TELE HEALTH STOP CODES run routine NEW
[SD EDIT TELE HEALTH STOP CODES]
Protocols Associated:
Protocol Name New/Modified/Deleted
------------- --------------------
SD IFS EVENT DRIVER NEW
SD IFS SUBSCRIBER NEW
SD TMP RECEIVE CANCEL INTRA NEW
SD TMP RECEIVE INTRAFACILITY NEW
SD TMP S12 CLIENT SUBSCRIBER NEW
SD TMP S12 SERVER EVENT DRIVER NEW
SD TMP S15 CLIENT SUBSCRIBER NEW
SD TMP S15 SERVER EVENT DRIVER NEW
SD TMP SEND CANCEL INTRA NEW
SD TMP SEND INTRAFACILITY NEW
SD TMP SIU-12 SERVER NEW
SD TMP SIU-S12 CLIENT NEW
TMP QBP-Q13 Event Driver NEW
TMP QBP-Q13 Subscriber NEW
TMP RTB-K13 Event Driver NEW
TMP RTB-K13 Subscriber NEW
HL7 Application Parameters:
Parameter Name:
---------------
SD TMP APPT RECEIVE
SD TMP APPT SEND
SD TMP IFS RECEIVE
SD TMP IFS SEND
SD TMP RECEIVE CANCEL INTRA
SD TMP RECEIVE INTRAFACILITY
SD TMP SEND CANCEL INTRA
SD TMP SEND INTRAFACILITY
SD-TMP-IN
SD-TMP-OUT
TMP GET CONSULTS
TMP SEND CONSULTS
TMP VIMT
TMP_OUT
HLO APPLICATION REGISTRY:
Registry Name:
--------------
TMP_VIMT
TMP_OUT
HL LOGICAL LINKS:
TMP adds a new link to connect to the TMP HealthShare server.
HL LOGICAL LINK:
----------------
TMP_SEND
Security Keys Associated:
Security Key Name
-----------------
N/A
Templates Associated:
Template Name Type File Name (Number) New/Modified/Deleted
------------- ---- ------------------ --------------------
N/A
Additional Information:
N/A
New Service Requests (NSRs):
----------------------------
N/A
Patient Safety Issues (PSIs):
-----------------------------
N/A
Defect Tracking System Ticket(s) & Overview:
--------------------------------------------
N/A
Problem:
--------
N/A
Resolution:
-----------
N/A
Test Sites:
----------
Fargo, ND
Minneapolis, MN
Boise, ID
Software and Documentation Retrieval Instructions:
----------------------------------------------------
Software is distributed by PackMan. The following technical
Documentation can be retrieved from the VA Software Document
Library (VDL): "Telehealth Management Platform (TMP) VistA
Technical Manual", "TMP 4.6 Deployment Installation Roll-back
Backout Guide", and "TMP 4.6 User Guide". The TMP Technical
Manual describes the HL7 messages/messaging and the database
Changes. The VDL is accessed at:
https://www.va.gov/vdl/
Patch Installation:
------------------
Installation Instructions:
---------------------------------
These steps can be completed with users on the system. Installing
this patch should take less than 15 minutes to install and configure.
1. Choose the PackMan message containing this patch.
2. Choose the INSTALL/CHECK MESSAGE PackMan option.
3. From the KIDS Menu, select the Installation Menu. From this menu,
you may elect to use the following options. When prompted for the
INSTALL NAME, SD*5.3*704.
a. Backup a Transport Global - This option will create a backup
message of any routines exported with this patch. It will not
backup any other changes such as Data Dictionaries (DDs) or
templates. IN ORDER TO BACK OUT THIS PATCH, THIS OPTION MUST BE
USED TO CREATE A BACKUP OF THE ROUTINES.
b. Compare Transport Global to Current System - This option will
allow you to view all changes that will be made when this patch
is installed. It compares all components of this patch
(routines, DDs, templates, etc.).
c. Verify Checksums in Transport Global - This option will allow
you to ensure the integrity of the routines that are in the
transport global.
4. From the Installation Menu, select the Install Package(s) option and
when prompted for the INSTALL NAME, enter SD*5.3*704.
5. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
Install? NO//' respond NO.
6. When prompted "Want KIDS to INHIBIT LOGONs during the install?
NO//" respond NO.
7. If prompted "Want to DISABLE Scheduled Options, Menu Options,
and Protocols? NO//" respond NO.
8. If prompted "Delay Install (Minutes): (0 - 60): 0//" respond 0.
Sample Install:
---------------
Select Installation <TEST ACCOUNT> Option: INstall Package(s)
Select INSTALL NAME: SD*5.3*704 8/16/18@08:59:32
=> TMP HL7 ;Created on Aug 15, 2018@08:05:45
This Distribution was loaded on Aug 16, 2018@08:59:32 with header of
TMP HL7 ;Created on Aug 15, 2018@08:05:45
It consisted of the following Install(s):
SD*5.3*704
Checking Install for Package SD*5.3*704
Install Questions for SD*5.3*704
Incoming Files:
2 PATIENT (Partial Definition)
Note: You already have the 'PATIENT' File.
40.6 SD TELE HEALTH STOP CODE FILE (including data)
Note: You already have the 'SD TELE HEALTH STOP CODE FILE' File.
I will OVERWRITE your data with mine.
44 HOSPITAL LOCATION (Partial Definition)
Note: You already have the 'HOSPITAL LOCATION' File.
Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO// NO
Want KIDS to INHIBIT LOGONs during the install? NO//
Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//
Enter the Device you want to print the Install messages.
You can queue the install by enter a 'Q' at the device prompt.
Enter a '^' to abort the install.
DEVICE: HOME// HOME
SD*5.3*704
Installing PROTOCOL
Installing HLO APPLICATION REGISTRY
Mar 19, 2019@12:01:44
Running Post-Install Routine: EN^SDTMP704
TMP_Send Link has been updated.
Updating Routine file...
Updating KIDS files...
SD*5.3*704 Installed.
Mar 19, 2019@12:01:45
Not a production UCI
Install Message sent
100% ? 25 50 75 ?
Complete
Install Completed
Post-Installation Instructions:
-------------------------------
Post Install Tasks:
1. After the patch has been installed, verify the TMP_Send HL logical link
was installed, configured and started:
***Note: The screen capture below shows the INSTITUTION file as the TMP
Development VistA system. INSTITUTION should be the local VistA site
Institution Name where the patch was installed.
Using FileMan:
VA FileMan 22.2
Select OPTION: INQUIRE TO FILE ENTRIES
Output from what File: PATIENT// HL LOGICAL LINK (322 entries)
Select HL LOGICAL LINK NODE: TMP_SEND
Another one:
Standard Captioned Output? Yes// (Yes)
Include COMPUTED fields: (N/Y/R/B): NO// - No record number (IEN), no
Computed
Fields
Display Audit Trail? No// NO
NODE: TMP_SEND INSTITUTION: TEST CHEYENNE VAMC
LLP TYPE: TCP STATE: Enabled
AUTOSTART: Enabled TIME STOPPED: JUL 18,
2019@13:46:53
SHUTDOWN LLP ?: YES QUEUE SIZE: 10
TCP/IP ADDRESS: vaauscluhshhl7rtr401.aac.va.gov
TCP/IP PORT: 6950 TCP/IP SERVICE TYPE: CLIENT
(SENDER)
TCP/IP PORT (OPTIMIZED): 6950 IN QUEUE BACK POINTER: 8
IN QUEUE FRONT POINTER: 7
2. Using Fileman, check to be sure the new style cross references were
installed in the PATIENT FILE (#2).
Checking the PATIENT FILE (#2):
Select OPTION: DATA DICTIONARY UTILITIES
Select DATA DICTIONARY UTILITY OPTION: LIST FILE ATTRIBUTES
START WITH What File: PATIENT// (1625 entries)
GO TO What File: PATIENT// (1625 entries)
Select SUB-FILE: APPOINTMENT
Select LISTING FORMAT: STANDARD// INDEXES ONLY
What type of cross-reference (Traditional or New)? Both// NEW
Which field: ALL//
DEVICE: ;;1000 TELNET PORT Right Margin: 80//
NEW-STYLE INDEX LIST -- FILE #2INDEX AND CROSS-REFERENCE LIST -- FILE
#27/24/19 PAGE 1
--------------------------------------------------------------------------
Subfile #2.98
New-Style Indexes:
AX (#1602) RECORD MUMPS IR ACTION WHOLE FILE (#2)
Short Descr: Action cross reference to send HL7 notification to
TMP when a new appt is made.
Description: The Tele Health Management Platform (TMP) application
allows users to schedule and cancel tele health
appointments in VistA. TMP needs to be kept up to
date with appointments scheduled by other applications
in order to be able to accurately display open
appointment slots. This index will trigger an HL7
message sent to TMP that will update the clinic's and
patient's appointments in the TMP database system.
Set Logic: D EN^SDTMPHLA(DA(1),DA)
Set Cond: S X=X1(1)=""
Kill Logic: Q
X(1): CLINIC (2.98,.01)
NO RE-INDEXING ALLOWED!
AY (#1603) RECORD MUMPS IR ACTION WHOLE FILE (#2)
Short Descr: Action cross reference to send an HL7 notification
when an appt is cancelled.
Description: The Tele Health Management Platform (TMP) application
allows users to schedule and cancel tele health
appointments in VistA. TMP needs to be kept up to
date with appointments are cancelled by other
applications in order to be able to accurately display
open appointment slots. This index will trigger an HL7
message sent to TMP that will update the clinic's and
patient's appointments in the TMP database system to
reflect the cancellation.
Set Logic: D EN^SDTMPHLA(DA(1),DA)
Set Cond: S X=X1(1)=""
Kill Logic: Q
X(1): STATUS (2.98,3)
NO RE-INDEXING ALLOWED!
3. Using FileMan check the HOSPITAL LOCATION FILE (#44) for the new cross
references:
Select OPTION: DATA DICTIONARY UTILITIES
Select DATA DICTIONARY UTILITY OPTION: LIST FILE ATTRIBUTES
START WITH What File: HOSPITAL LOCATION// (424 entries)
GO TO What File: HOSPITAL LOCATION// (424 entries)
Select SUB-FILE:
Select LISTING FORMAT: STANDARD// INDEXES ONLY
What type of cross-reference (Traditional or New)? Both// NEW
Which field: ALL// .01 NAME
DEVICE: ;;1000 TELNET PORT Right Margin: 80//
NEW-STYLE INDEX LIST -- FILE #44, FIELD #.01INDEX AND CROSS-REFERENCE
LIST -- FILE #44 7/24/19
PAGE 1
--------------------------------------------------------------------------
AG (#1386) RECORD REGULAR IR SORTING ONLY
Short Descr: Index by TYPE and NAME.
Description: This cross reference is used to sort by TYPE and
NAME.
Set Logic: S ^SC("AG",X(1),X(2),DA)=""
Kill Logic: K ^SC("AG",X(1),X(2),DA)
Whole Kill: K ^SC("AG")
X(1): TYPE (44,2) (Subscr 1) (forwards)
X(2): NAME (44,.01) (Subscr 2) (forwards)
ATMP1 (#1601) FIELD MUMPS IR ACTION
Short Descr: TMP HL7
Description: The Tele Health Management Platform (TMP) application
allows users to schedule and cancel appointments in
VistA. TMP needs to be kept up to date with specific
clinic information in order to accurately display
clinic information.
This index will trigger an update to be sent to the
TMP platform via HL7 when one of the fields below is
edited for a tele health clinic or if a new tele
health clinic is added. Tele health clinics are
identified by either the Stop Code Number (primary
stop code) or the Credit Stop Code (secondary stop
code). Name (#.01) Stop Code Number (#8) Credit Stop
Code (#2504) Service (#9) Treating Specialty (#9.5)
Overbooks/Day Maximum (#1918) Inactivate Date (#2505)
Reactivate Date (#2506).
Set Logic: D EN^SDTMPHLB(DA)
Set Cond: S X=X1(1)'=""!X1(2)'=""!X1(3)'=""!X1(4)'=""!
X1(5)'=""!X1(6) '=""!X1(7)'=""!X1(8)'=""!X1(9)'=""
Kill Logic: Q
X(1): NAME (44,.01)
X(2): STOP CODE NUMBER (44,8)
X(3): CREDIT STOP CODE (44,2503)
X(4): TREATING SPECIALTY (44,9.5)
X(5): SERVICE (44,9)
X(6): DEFAULT PROVIDER (44,16)
X(7): OVERBOOKS/DAY MAXIMUM (44,1918)
X(8): INACTIVATE DATE (44,2505)
X(9): REACTIVATE DATE (44,2506)
NO RE-INDEXING ALLOWED!
4. Using FileMan check to be sure the new SD TELE HEALTH STOP CODE FILE
(#40.6) was installed. This file is distributed with the current stop
list of tele health stops at the time this patch was released.
Select OPTION: INQUIRE TO FILE ENTRIES
Output from what File: PATIENT// 40.6 SD TELE HEALTH STOP CODE FILE
(34 entries)
Select SD TELE HEALTH STOP CODE FILE STOP CODE NUMBER: ??
Choose from:
111
118
136
160
179
184
185
186
189
323
348
371
490
491
502
534
648
674
683
684
685
690
692
693
694
695
696
697
698
699
708
719
901
674685
5. Using FileMan verify the new VETERAN VIDEO CALL URL field has been
created in the HOSPITAL LOCATION FILE (#44) in the APPOINTMENT Sub File
(#44.03). The capture below only shows the new field, not all field in
the sub file.
Select OPTION: DATA DICTIONARY UTILITIES
Select DATA DICTIONARY UTILITY OPTION: LIST FILE ATTRIBUTES
START WITH What File: HOSPITAL LOCATION// (4840 entries)
GO TO What File: HOSPITAL LOCATION// (4840 entries)
Select SUB-FILE: APPOINTMENT
Select SUB-FILE:
Select LISTING FORMAT: STANDARD//
Start with field: FIRST// .01 APPOINTMENT DATE/TIME
Go to field:
DEVICE: ;;10000 HOME (CRT) Right Margin: 80//
STANDARD DATA DICTIONARY #44.001 -- APPOINTMENT SUB-FILE 7/24/19
PAGE 1
STORED IN ^SC(D0,"S", SITE: TEST.CHYLAB.FO-BAYPINES.MED.VA.GOV UCI:
CHY0035D ,ROU
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
--------------------------------------------------------------------------
44.001,.01 APPOINTMENT DATE/TIME 0;1 DATE (Multiply asked)
INPUT TRANSFORM: I X K X W !,"This node may not be set
through fileman!!" I $D(X) S %DT="ETX" D
^%DT S M=Y K:DT+20000<X!(DT>X) X,DINUM
LAST EDITED: AUG 01, 1986
HELP-PROMPT: TYPE A DATE BETWEEN DT AND DT+2000
DESCRIPTION: Date/time of a veteran's appointment to an
outpatient clinic.
NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY
PROGRAMMER
...
44.003,400 VETERAN VIDEO CALL URL URL;1 FREE TEXT
INPUT TRANSFORM:K:$L(X)>200!($L(X)<3) X
MAXIMUM LENGTH: 200
LAST EDITED: OCT 30, 2018
HELP-PROMPT: Answer must be 3-200 characters in length.
Patch Back out Instructions:
---------------------------
In the event of a catastrophic failure, the Facility CIO may make the
decision to back-out the patch.
It is imperative that you have performed a backup of the routines included
in this patch prior to installation.
The back-out plan is to restore the routines from the backup created. No
data was modified by this patch installation and, therefore, no rollback
strategy is required.
Prior to installing an updated KIDS package, the site/region should have
saved a backup of the routines in a mail message using the Backup a
Transport Global [XPD BACKUP] menu option (this is done at time of
install). The message containing the backed-up routines can be loaded with
the "Xtract PackMan" function at the Message Action prompt. The Packman
function "INSTALL/CHECK MESSAGE" is then used to install the backed up
routines onto the VistA System.
After installing the backed-up routines, the site will need to use the
HL7/HLO options to edit the HL Logical Links and either delete these
entries or delete the IP and Port information.
The site will need to use FileMan to delete the new indices on the
Patient File (#2), Appointment Multiple field (#2.98) and to delete the
new index on the Hospital Location File (#44). These new indices are
triggers that cause HL7 messages to be sent out of VistA to the TMP
application. If this patch is backed out, these new indices need to be
deleted to prevent the triggers from firing and creating the HL7
messages.
The other database changes do not need to be deleted as they do not
impact any code or other functionality.
VA FileMan 22.2
Select OPTION: UTILITY FUNCTIONS
Select UTILITY OPTION: CROSS-REFERENCE A FIELD OR FILE
What type of cross-reference (Traditional or New)? Traditional// NEW
Modify what File: HL7 APPLICATION PARAMETER// 44 HOSPITAL LOCATION
(930 entries)
Select Subfile:
Current Indexes on file #44:
445 'ACST' index
446 'AST' index
1346 'AG' index
1478 'ATMP1' index
Choose E (Edit)/D (Delete)/C (Create): DELETE
Which Index do you wish to delete? 1478 ATMP1
Are you sure you want to delete the index definition? NO// YES
Index definition deleted.
Do you want to execute the old kill logic now? NO
Compiling SDB Input Template of File
44.........................................
..
'SDBT' ROUTINE FILED...
'SDBT1' ROUTINE FILED...
'SDBT2' ROUTINE FILED..
'SDBT3' ROUTINE FILED..
'SDBT4' ROUTINE FILED.
'SDBT5' ROUTINE FILED.
Current Indexes on file #44:
445 'ACST' index
446 'AST' index
1346 'AG' index
Choose E (Edit)/D (Delete)/C (Create):
Select UTILITY OPTION: CROSS-REFERENCE A FIELD OR FILE
What type of cross-reference (Traditional or New)? Traditional// new NEW
Modify what File: HOSPITAL LOCATION// 2 PATIENT (1755 entries)
Select Subfile: APPOINTMENT (Subfile #2.98)
Current Indexes on subfile #2.98:
1333 'AX' whole file index (resides on file #2)
1477 'AY' whole file index (resides on file #2)
Choose E (Edit)/D (Delete)/C (Create): DELETE
Which Index do you wish to delete? 1333 AX
Are you sure you want to delete the index definition? NO// YES
Index definition deleted.
Do you want to execute the old kill logic now? NO
Current Indexes on subfile #2.98:
1477 'AY' whole file index (resides on file #2)
Choose E (Edit)/D (Delete)/C (Create): DELETE
Which Index do you wish to delete? 1477// AY
Are you sure you want to delete the index definition? NO// YES
Index definition deleted.
Do you want to execute the old kill logic now? NO
There are no INDEX file cross-references defined on subfile #2.98.
Want to create a new index for this file? No// NO
Select UTILITY OPTION:
Routine Information:
====================
The second line of each of these routines now looks like:
;;5.3;Scheduling;**[Patch List]**;AUG 17, 2018;Build 60
The checksums below are new checksums, and
can be checked with CHECK1^XTSUMBLD.
Routine Name: SDHL7APT
Before: n/a After:B250644500 **704**
Routine Name: SDHL7APU
Before: n/a After:B268564203 **704**
Routine Name: SDHL7CON
Before: n/a After:B108890103 **704**
Routine Name: SDHL7UL
Before: n/a After: B60504057 **704**
Routine Name: SDHLAPT1
Before: n/a After:B192619176 **704**
Routine Name: SDHLAPT2
Before: n/a After: B22091553 **704**
Routine Name: SDM1A
Before:B131891737 After:B133660852 **26,94,155,206,168,223,241,
263,327,478,446,544,621,622,
627,658,665,650,704**
Routine Name: SDTMBUS
Before: n/a After: B30769228 **704**
Routine Name: SDTMP08
Before: n/a After:B208934197 **704**
Routine Name: SDTMP704
Before: n/a After: B46515436 **704**
Routine Name: SDTMPHLA
Before: n/a After:B119559967 **704**
Routine Name: SDTMPHLB
Before: n/a After: B46065382 **704**
Routine list of preceding patches: 650
=============================================================================
User Information:
Entered By : BURKHALTER,WILLIAM Date Entered : JUL 02, 2018
Completed By: Date Completed:
Released By : Date Released :
=============================================================================
Packman Mail Message:
=====================