User-Driven Development
Custom Implementation
Responsive Support

A non-profit network of experts helping
the medical community use Vista

SAMI 1.18.0.10-i10

$TXT by MARSHALL,RICK DS@vapalsyotta.fiscientific.org (KIDS) 2021-03-23T19:45Z

Form Fixes: CT Evaluation + Misc

VAPALS-ELCAP 1.18.0.10-i10
(SAMI*18.0*10 SEQ #10)

George P. Lilly & Frederick D. S. Marshall
2021-03-23

‍i. Front matter

App

SAMI - VAPALS-ELCAP

Revision

SAMI*18.0*10 SEQ #10: Version 18.0, Patch ID #10, Seq #10

Priority

regular

Categories

Routine, File

Status

released: sami-1.18.0.10-i10.zip

Depends on

SAMI 1.18.0.1-i1 (SAMI*18.0*1 SEQ #1)
SAMI 1.18.0.3-i3 (SAMI*18.0*3 SEQ #3)
SAMI 1.18.0.4-i4 (SAMI*18.0*4 SEQ #4)
SAMI 1.18.0.5-i5 (SAMI*18.0*5 SEQ #5)
SAMI 1.18.0.6-i6 (SAMI*18.0*6 SEQ #6)
SAMI 1.18.0.8-i8 (SAMI*18.0*8 SEQ #8)
SAMI 1.18.0.9-i9 (SAMI*18.0*9 SEQ #9)

‍ii. Contents

1. Description

SAMI*18.0*10 SEQ #10 fixes the following bugs in the CT Eval report. This patch includes nine bug fixes and enhancements:

1.1. VAP-464: Coronary artery calcification report issues

  • Problem: Presume a patient has no coronary artery calcifications (CAC). If you leave all the fields blank in the section CAC section (which perhaps should not be possible on the form), the report text looks like: Coronary Artery Calcifications: in left main, in left anterior descending, in circumflex, and in right coronary. The Visual Coronary Artery Calcium (CAC) Score is 0.

    Again, presume a patient has no CAC. If you put none for all the individual arteries, the text is blank: Coronary Artery calcifications: Cardiac Findings:. It should list none for all of the individual arteries and say the score is 0.

  • Solution: CT Report fixed.

1.2. VAP-468: Individual CAC score not required, even though labeled as required

  • Problem: Individual CAC scores have a red asterisk, but the form does not require them. In turn, this causes the CT report to print out incorrectly. Should be required for IELCAP.

  • Solution: CT Report fixed.

1.3. Typos in CT report

  • Problem: Sentences should have a space after period.

  • Solution: CT Report fixed.

1.4. Cardiac findings in CT report

  • Problem: Cardiac findings section header is always printed, even if there are no cardiac findings.

  • Solution: CT Report fixed.

1.5. CT report should include average diameter

  • Problem: Nodule size should list average diameter in addition to length and width.

  • Solution: CT Report fixed.

1.6. CT report header has weird date and age “−1”

  • Problem: HL7 date format was not being recognized, so the header had a weird date, and age was −1.

  • Solution: CT Report header fixed at the top of the report page, and the header everywhere it appears throughout VAPALS-ELCAP.

1.7. Enrollment report needs to be able to be sorted alphabetically

  • Problem: Need to be able to be sorted by name and (ideally) also by date.

  • Solution: Reports list fixed.

1.8. Provide total number of records in User Reports

  • Problem: Enhancement desired.

  • Solution: Fixed.

1.9. Pre-enrollment existing

  • Problem: Logic bug in detecting pre-enrollment existing.

  • Solution: Fixed.

2. Package elements

File Change

sami-1.18.0.10-i10-recipe.txt

new

sami-1.18.0.10-i10.txt

new

sami-1.18.0.10-i10.kid

new

sami-1.18.0.10-i10.zip

new

Routine Change

SAMICTT0

modified

SAMICTT1

modified

SAMICTT2

modified

SAMICTT3

modified

SAMICTT4

modified

SAMICTT9

modified

SAMICTTA

modified

SAMICTUL

new

SAMIFLD

modified

SAMIFUL

modified

SAMINOT1

modified

SAMINUL

modified

SAMIUR

modified

3. Package-retrieval instructions

The software for this patch is being released as KIDS package sami-1.18.0.10-i10.zip via Git or via direct file transfer. 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.

3.1. Assume the identity of your osehra Unix user

This step assumes you type a sudo command to do this. If your configuration is different, please adjust this step to match your configuration:

$ sudo su - osehra

3.2. Prepare the archive file

Create install and backup directories:

$ mkdir -p ~/run/in/sami/1.18.0.10/back/www/

If using Git to receive packages, update your VAPALS-ELCAP Git repo, copy the sami-1.18.0.10-i10.zip file to your install directory, and change directories to that install directory:

$ cd ~/lib/silver/a-sami-vapals-elcap--vo-osehra-github/
$ git pull
[...a successful git pull will result in a great deal of chatter...]
$ cp dist/1.18.0.10/sami-1.18.0.10-i10.zip ~/run/in/sami/1.18.0.10/

If not using Git, you may obtain the archive here: sami-1.18.0.10-i10.zip (57 KB ZIP archive).

As the identity of the sysadmin Unix user, follow your usual procedure to transfer archive file sami-1.18.0.10-i10.zip to one of the sysadmin user directories and change to that directory.

Then move the archive file to the osehra user install directory, change ownership of the archive file to osehra, assume the osehra user identity, and change directories to that install directory:

$ sudo mv sami-1.18.0.10-i10.zip /home/osehra/run/in/sami/1.18.0.10/
$ sudo chown osehra:osehra \
    /home/osehra/run/in/sami/1.18.0.10/sami-1.18.0.10-i10.zip
$ sudo su - osehra

3.3. Expand the KIDS archive

Change directories to the install directory, and expand the archive file, using the Unix unzip command:

$ cd ~/run/in/sami/1.18.0.10/
$ unzip sami-1.18.0.10-i10.zip
Archive:  sami-1.18.0.10-i10.zip
  inflating: sami-1.18.0.10-i10-recipe.txt
  inflating: sami-1.18.0.10-i10.kid
  inflating: sami-1.18.0.10-i10.txt
$ cd
$ _

4. Pre-install instructions

It is important when installing packages to back up the existing package elements that are about to be changed, so that if anything goes wrong with the install, these package elements can be restored. For this patch, we will back up M routines.

4.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:

4.1.1. On Caché

$ csession vapals

Node: vapalscache, Instance: VAPALS

>_

4.1.2. On YottaDB/GT.M

$ mumps -dir

>_

4.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:
>_

4.3. Back up routines

Back up existing VAPALS-ELCAP routines that will be overwritten by this install. Do this by calling direct-mode interface ^%RO (routine out), selecting the list of routines to save, selecting sami-1.18.0.10-i10-back.ro to save to, and answering any other additional prompts.

The prompts vary between M implementations, so be sure to follow the correct dialog for yours. The routine names to save are listed below under each implementation; copy the list and paste it at the Routine prompt. At the final Routine prompt, press return to indicate the list of routines is done.

4.3.1. List of routines

SAMICTT0
SAMICTT1
SAMICTT2
SAMICTT3
SAMICTT4
SAMICTT9
SAMICTTA
SAMICTUL
SAMIFLD
SAMIFUL
SAMINOT1
SAMINUL
SAMIUR

4.3.2. On Caché

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:

> do ^%RO

Routine output (please use %ROMF for object code output)
Routine(s): SAMICTT0
Routine(s): SAMICTT1
Routine(s): SAMICTT2
Routine(s): SAMICTT3
Routine(s): SAMICTT4
Routine(s): SAMICTT9
Routine(s): SAMICTTA
Routine(s): SAMICTUL
Routine(s): SAMIFLD
Routine(s): SAMIFUL
Routine(s): SAMINOT1
Routine(s): SAMINUL
Routine(s): SAMIUR
Routine(s):

Description: SAMI 1.18.0.10-i10 routine backup

Output routines to
Device: /home/osehra/run/in/sami/1.18.0.10/back/sami-1.18.0.10-i10-back.ro
Parameters? ("WNS") =>
Printer Format? No => No
SAMICTT0.INT    SAMICTT1.INT    SAMICTT2.INT    SAMICTT3.INT
SAMICTT4.INT    SAMICTT9.INT    SAMICTTA.INT    SAMICTUL.INT
SAMIFLD.INT     SAMIFUL.INT     SAMINOT1.INT    SAMINUL.INT
SAMIUR.INT
>_

4.4. On YottaDB/GT.M

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:

> do ^%RO

Routine Output - Save selected routines into RO file.

Routine: SAMICTT*
SAMICTT0  SAMICTT1  SAMICTT2  SAMICTT3  SAMICTT4  SAMICTT9
SAMICTTA  SAMICTUL
Current total of 8 routines.

Routine: SAMIFLD
SAMIFLD
Current total of 9 routines.

Routine: SAMIFUL
SAMIFUL
Current total of 10 routines.

Routine: SAMINOT1
SAMINUL
Current total of 11 routines.

Routine: SAMINUL
SAMINUL
Current total of 12 routines.

Routine: SAMIUR
SAMIUR
Current total of 13 routines.

Routine:

Output device: <terminal>: /home/osehra/run/in/sami/1.18.0.10/back/sami-1.18.0.10-i10-back.ro

Header Label: SAMI 1.18.0.10-i10 routine backup
Strip comments <No>?:
SAMICTT0  SAMICTT1  SAMICTT2  SAMICTT3  SAMICTT4  SAMICTT9
SAMICTTA  SAMICTUL  SAMIFLD   SAMIFUL   SAMINOT1  SAMINUL
SAMIUR

Total of 4645 lines in 13 routines.


>_

Your VAPALS-ELCAP environment is now ready to install VAPALS-ELCAP 1.18.0.10-i10 (SAMI*18.0*10 SEQ #10).

5. Main install instructions

This consists of entering the Vista menu system, loading and installing the KIDS package, and exiting M.

5.1. Enter Vista menu system

5.1.1. Enter M

Repeat step 4.1 to enter M.

5.1.2. Sign in and select the KIDS Installation menu

At the M prompt, call Vista’s direct-mode interface, enter your access code, 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

Setting up programmer environment
This is a TEST account.

Access Code: *******
Terminal Type set to: C-VT100

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:_

5.2. Load KIDS package

Select option 1 and press return at the Continue prompt.

Select Installation <TEST ACCOUNT> Option: 1  Load a Distribution
Enter a Host File: /home/osehra/run/in/sami/1.18.0.10/sami-1.18.0.10-i10.kid

KIDS Distribution saved on Mar 22, 2021@18:21:03
Comment: Released SAMI*18.0*10 SEQ #10 (1.18.0.10-i10)

This Distribution contains Transport Globals for the following Package(s):
  SAMI*18.0*9=10
Distribution OK!

Want to Continue with Load? YES//
Loading Distribution...

   SAMI*18.0*10
Use INSTALL NAME: SAMI*18.0*10 to install this Distribution.


   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:_

5.3. Install KIDS package

Select option 6, enter the space bar at the INSTALL NAME prompt, and press return at the next three prompts.

Select Installation <TEST ACCOUNT> Option: 6  Install Package(s)
Select INSTALL NAME:    SAMI*18.0*10     Loaded from Distribution    3/18/21@08:58:30
   => Released SAMI*18.0*10 SEQ #10 (1.18.0.10-i10)  ;Created on Mar 18, 2021@07

This Distribution was loaded on Mar 18, 2021@08:58:30 with header of
   Released SAMI*18.0*10 SEQ #10 (1.18.0.10-i10)  ;Created on Mar 18, 2021@07:44:50
   It consisted of the following Install(s):
    SAMI*18.0*10
Checking Install for Package SAMI*18.0*10

Install Questions for SAMI*18.0*10



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//   VMS


 Install Started for SAMI*18.0*10 :
               Mar 18, 2021@08:59:38

Build Distribution Date: Mar 18, 2021

 Installing Routines:.........
               Mar 18, 2021@08:59:38

 Updating Routine file......

 Updating KIDS files.......

 SAMI*18.0*10 Installed.
               Mar 18, 2021@08:59:38

 NO Install Message sent


   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 1.18.0.10-i10 (SAMI*18.0*10 SEQ #10) 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.

6. Optional backout instructions

Should errors or other problems result from installing this package contact the VAPALS development team for package-backout instructions.

7. Routines

Lines 2 & 3 of each of these routines now look like:

;;18.0;SAMI;[Patch List];2020-01;[optional Build #]
;;1.18.0.10-i10

The checksums below are Vista Type B checksums (do CHECK1^XTSUMBLD).

Name Checksum after Patch list

SAMICTT0

B95163696

**4,10**

SAMICTT1

B117982335

**4,10**

SAMICTT2

B115984956

**4,10**

SAMICTT3

B222224982

**4,10**

SAMICTT4

B54435090

**4,10**

SAMICTT9

B17246420

**4,10**

SAMICTTA

B34902655

**4,10**

SAMICTUL

B93951

**10**

SAMIFLD

B215854610

**5,10**

SAMIFUL

B129116

**10**

SAMINOT1

B436917317

**2,6,8,10**

SAMINUL

B99724

**9,10**

SAMIUR

B283175290

**5,10**

8. Authors

Dates By

Developed

2021-02-01/2021-03-23

George P. Lilly (VEN)
Frederick D. S. Marshall (VEN)

Tested

2021-02-01/2021-03-23

George P. Lilly (VEN)
Frederick D. S. Marshall (VEN)
Linda M. R. Yaw (VEN)

Released

2021-03-21/2021-03-23

Frederick D. S. Marshall (VEN)
Kenneth W. McGlothlen (VEN)

$END TXT