$TXT by YAW,LINDA linda.yaw@vistaexpertise.net (KIDS) 2022-12-13t02:13z
Statistical Report Upgrade
SAMI (VAPALS-ELCAP) 18-17-t3
(SAMI*18.0*17 SEQ #17 T3)
George P. Lilly,
Domenic DiNatale,
Larry G. Carlson
& Frederick D. S. Marshall
2022-12-13
i. Front matter
App |
SAMI (VAPALS-ELCAP) |
Version |
18-17-t3 |
Vista ID |
SAMI*18.0*17 SEQ #17 T3: Version 18.0, Patch ID #17, Seq #17, Test 3 |
Priority |
High |
Categories |
Routine, File |
Status |
Test Release: SAMI-18-17-t3.zip |
Depends on |
SAMI 18-1 (SAMI*18.0*1 SEQ #1) |
ii. Contents
1. Description
SAMI 18-17-t3 adds one high-priority update to add name and last5 to a .csv report.
The definitive source for the VAPALS-ELCAP application—codebase, package distributions (including this one), and documentation—is a public GitHub repository.
These instructions are for your Vista environment’s sysadmin. As usual, please capture the complete dialog of your install and send it to your VAPALS-ELCAP support team.
The changes in this patch is:
-
Include saminame and last5 in every .csv file on every row: ??
1.1. Include saminame and last5 in every .csv file on every row
Unnumbered Issue (high priority): A report is available to be run by the system administrator that outputs all patient data for statistical analysis. Lines did not include patient ID.
Solution: Add saminame (full patient name) and last5 (First letter of last name and last four digits of SSN) in each line of report.
Reported: 2022-12-09 by Henschke and Yip.
3. Prepare for installation
This involves creating a directory to work in, running a script to back up certain datafiles and web-application files, and then going through steps to back up M routines that will be replaced by the patch.
3.1. Assume the identity of your osehra Unix user
This step assumes you use a dzdo or sudo command to do this; here, the symbol $DEMAND will stand for whichever command you use. (Also, in all the command-line examples below, $ simply means your command-line prompt.) If your configuration is different, please adjust this step to match your configuration:
$ $DEMAND su - osehra $ _
3.2. Prepare install directory
If this is your first time installling this, execute the following commands. They create a shell variable, and then creates the work directory and sets it as your current directory.
$ INDIR=~/run/in/sami/18-17/t3 $ mkdir -p $INDIR $ cd $INDIR
If you’ve already tried installing this before, you can use the following commands instead:
$ INDIR=~/run/in/sami/18-17/t3
$ cd $INDIR
$ rm -rf ./sami*.{txt,kid} ./auxfiles
3.3. Download and prepare the archive file
You may safely download the archive file (sami-18-17-t3.zip) in advance of the actual install.
Then unzip the archive file with the following command.
3.4. Install web-application files
At this point, the web-application files must be installed. This is done with a script that backs up the affected directories before installing anything, then upgrades the web-application files. The output looks like this (where [x] represents a number).
$ ./upgrade-auxfiles Backing up files to ./.aux-backup: [... lists of files backed up ...] Compressing the backup: [... list of files being compressed ...] Cleaning up. Done with backup of auxiliary files. Updating from ./auxfiles [... list of files being updated ...] Done with install. You may now proceed with the KIDS installation. $ _
Outside the VA firewall, VAPALS-ELCAP systems maintain up-to-date clones of the official GitHub repository, and this script will have different output.
$ ./upgrade-auxfiles Backing up files to ./.aux-backup [... lists of files backed up ...] Compressing the backup: [... list of files being compressed ...] Cleaning up. Done with backup of auxiliary files. Found a valid Git repository; pulling updates ... [... output varies ...] Done with install. $ _
3.5. Back up M routines
Before the installation, we also need to back up existing VAPALS-ELCAP routines that will be overwritten by this install. To do this, you will have to start a Caché or YottaDB session (depending on your particular installation), sign in to Vista, and then call the direct-mode interface ^%RO (“routine out”).
We have made efforts to display accurate instructions, but there are likely to be minor differences between implementations. Be sure to follow the correct dialog for your implementation.
3.5.1. Enter M
At the Unix prompt, enter the M environment in direct mode, using the csession command on Caché or the mumps command on YottaDB/GT.M:
On Caché
$ csession vapals Node: vapalscache, Instance: VAPALS >_
On YottaDB/GT.M
$ mumps -dir >_
3.5.2. Sign into Vista
At the M prompt, call Vista’s direct-mode interface, enter your access code, and then just press return at the OPTION NAME prompt to return to direct mode. This sets up your authentication variables. Here’s a sample capture of this step:
>do ^XUP Setting up programmer environment This is a TEST account. Access Code: ******* Terminal Type set to: C-VT100 Select OPTION NAME: >_
3.5.3. List of routines
The routine names to save are listed below; you may copy the list and paste it at the appropriate Routine prompt. At the final Routine prompt, press return to indicate the list of routines is done.
3.5.4. Run the backup
Creating the routine backup file differs by implementation.
On Caché
Note that routines that don’t currently exist will result in a warning message (specifically, the routine name will have [???] after it, and the line [does not exist] after that). These messages can be safely disregarded.
In addition to naming the routines and routine-out file, we also provide a Description and press return at the Parameters and Printer Format prompts to accept the defaults of WNS and No, respectively:
On YottaDB/GT.M
Note that routines that don’t currently exist will result in the routine name not appearing under the input line, and won’t count towards the number of routines. These can be safely disregarded.
In addition to naming the routines and routine-out file, we also provide a Header Label and press return at the Strip comments prompt to accept the default of no:
You’ll remain in the M environment for the next section.
4. Main install instructions
This consists of loading and installing the KIDS package, and activating the new web-application files.
4.1. Installing the KIDS package
This installs the various M assets required by the application.
4.1.1. Enter the KIDS Installation menu
At the OPTION NAME prompt select XPD MAIN to enter the Kernel Installation & Distribution System main menu, and at the Select ... Option prompt select Installation:
>do ^XUP
Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System
Edits and Distribution ...
Utilities ...
Installation ...
Patch Monitor Main Menu ...
Select Kernel Installation & Distribution System <TEST ACCOUNT> Option: installation
1 Load a Distribution
2 Verify Checksums in Transport Global
3 Print Transport Global
4 Compare Transport Global to Current System
5 Backup a Transport Global
6 Install Package(s)
Restart Install of Package(s)
Unload a Distribution
Select Installation <TEST ACCOUNT> Option:_
You now have VAPALS-ELCAP 18-17-t3 (SAMI*18.0*17 SEQ #17 T3) installed in your M environment. The install is now complete. We recommend running tests of your VAPALS-ELCAP application to confirm the environment is operational and bug-free, before notifying users that VAPALS-ELCAP is ready for their use.
5. Optional backout instructions
Should errors or other problems result from installing this package, contact the VAPALS-ELCAP development team for package-backout instructions.
6. Routines
Lines 2 and 3 of each of these routines now look like:
The checksums below are Vista Type B checksums (do CHECK1^XTSUMBLD).
7. Authors
| Dates | By | |
|---|---|---|
Developed |
2022-12-11 |
George P. Lilly (VEN) |
Tested |
2022-12-15 |
George P. Lilly (VEN) |
Released |
2022-12-16 |
Frederick D. S. Marshall (VEN) |
$END TXT