Readme.rtf       Date 2023/12/26

BlackWood Systems, Inc.

phone: 602-569-8766
email: support@blackwood-systems.com
web:   www.blackwood-systems.com

This file contains the latest version and upgrade information. This file is the first place to look for initial installation and upgrade information.

Please thoroughly read and accept the License Agreement as displayed in the installer before using this software.

For an initial install, further in this document the section entitled FIRST INSTALLATION describes the installation process from start to finish.

Sections in this document

Compatibility between client and server
Special Notes
CURRENT VERSIONS
NEW FEATURES / BUGS FIXED
CLIENT INSTALLATION NOTES
mini-MOMI
MULTIPLE PLATFORM SERVER SUPPORT
FIRST INSTALLATION
UPDATE AN EXISTING INSTALLATION
RUNNING SSMOMI SCREEN SAVER AS A STAND ALONE PROGRAM
MANUAL INSTALLATION OF NONSTOP BASED PROGRAMS
FUTURE PLANS
Directory layout

Compatibility between client and server

The ability of our customers to upgrade as painlessly as possible to a new MOMI release is important to us.

Our standard release migration recommendation is to upgrade the server first and the client second within a release series (i.e. 4.xx, 5.xx and 6.xx). Normally, when a release series changes, both the client and server must both be upgrade at the same time. However, a 5.xx client will operate with MOMI 6.xx.

Please check below for Oldest client version 	tested with server.

Note that not all features may operate when running a combination of old and new MOMI software.

Special Notes

MOMI software is packaged within an MSI file created by InstallShield and provides the capabilities to install to the PC (all users or current user), copy MOMI software to the NonStop System and copy MOMI software to a shared located. 

Short-cuts to MOMI software under the Windows Start menu use the format of BWS MOMI n.nn (where n.nn is the version number). 

The PC must be configured with at least 24-bit color for the client to operate fully with MOMI. A warning message is displayed at client startup if a lower color depth is detected. While the client will generally function correctly with a lower color depth, certain features are not available such as the pop-up window when the mouse is placed over the connector lines between systems on the screen SubSystems / Expand / Diagram.

The CAIL Emulator was provided courtesy of CAIL and is not a component of any purchased MOMI product. The Emulator is no longer provided and was removed from the MOMI installation package.
 
The IP Workshop Pro TCP/IP Subnet calculator is provided courtesy of Peter Kostov and Peko Software and is not a component of any purchased MOMI product. BlackWood Systems and Peko Software reserves the right to discontinue, limit or alter the availability in future releases. Please see the IP Workshop Pro help within the calculator for additional information and to check out other tools he has available.

CURRENT VERSIONS
   
Release Package            6.17h
Release Date (yyyy/mm/dd)  2023/12/26

Item	Version
----	-------
Latest O/S tested	G06.32.01  
		J06.23.01 – L23.08.00
	
Client Version	6.17g  Build 915
Server Version (VPROC)	6.17h  T0000G06___V6_17h___2023_12_22
      
Buffer Version	Client 21.71   Server 21.72
History database	3.10
CONFMOMI	6.02
OBYMOMI	6.00
OBYCSQL	5.02
MomiFTP.exe	2.15
CentralServer.exe	1.8
ssMOMI.scr	6.00
MomiEMail.exe	1.11
SendMail.exe	1.01
IPCalc.exe	1.3.3

Oldest client version
 tested with server	5.80

Clients 5.15 and earlier may fail on connect.

NEW FEATURES / BUGS FIXED 
(see MOMI HISTORY.RTF for previous versions)

Common new features (requires current client and server)
If you are using Client Access, newly added screens in a MOMI release update are not available to users by default. This action may be changed on the screen Configure / Client Access / Global Settings by checking the option New screens enabled by default. The user that started MOMI, known as the Default Security User, always has new screens enabled by default.  

Installer
•	None.

Help Documentation
•	The PDF format currently starts with a blank page.

MOMI Client
New Screens: 	
•	None

New Features:
•	Grid Tools now allows the grid string display to chop off leading and trailing characters without replacing them with '...'.
•	Configure / Client Access / Global Settings
- now shows current state of CLIENT-LOCKDOWN-MODE.

Bug Fixes:
•	Overview
- 'CPU Info' button mistakenly had a right-click action menu active that would cause crash when 'Copy to Clipboard' was pressed. Fixed.
•	History
- If History was enabled but the server did not have history databases defined, the client might crash on some of the History screens. Fixed.
•	SubSystems/ Logs / EMS Log
- Find would not always scroll to the found matching record if a filter was applied. Fixed.
•	History / Chart
- When changing systems, if the History Elements available on the newly selected system were different than the  previous system might not clear any types no longer available. Fixed.
- When defining a chart element if the 'Clear All Elements' was pressed the Type line spacing would be wrong. Fixed.

Misc. Items:
•	SubSystems/ Logs / EMS Log
- Stop message count limit raised from 9,999 records to 250,000. Requires a server version 6.17g or later.

Known issues:
•	Systems / File Transfer / SFTP
 - If file is transferred as a Key-Sequenced structured file sometimes SFTP will think the transfer is successful but the host file is left empty.  A check is now done and an error shows if this happened. Note: Sometimes making the REC LEN even will succeed. Some failures are caused by unknown factors and seem to be a failure in the SFTP Server on the NonStop.
•	SubSystems / Discovery
- Feature is still under development and subject to change. 
	Comments and suggestions are invited and welcome.

MOMI Server
New Features:

•	The CONFMOMI keyword PASSWORD may be replaced with the keyword LICENSE-KEY. We will be migrating, over time, to the new keyword but both have the same meaning.

Bug Fixes:

•	Various corrections and changes were made to the SMTP protocol used to generate alarm email to enhance message reliability especially when network congestion is present.
•	EMS / User defined alarms that automatically delete no longer generate superfluous updates to the client. 
                                  
Misc. Items:

•	The server now provides the client information for the alarms CPU / PCBs low and CPU / PCBs high to allow it to jump to a helpful page when right-clicking on these active alarms on the screen Alarms / Active.

•	The MOMI server DB Alarm, which maintains an in memory database of active alarms, now has a default restriction to consume no more than 10% of a CPU. This change is a result of a customer report of a high rate of CPU consumption by this process. This value can be changed with the advanced CONFMOMI keyword CPU-LIMIT-DB-ALARM.

Known Issues:
•	None 

MOMIFTP 
•	None

ssMOMI 
•	None

MomiEmail 
•	None

SendMail 
•	None

CentralServer
•	None

IPCalc 
•	None

CLIENT INSTALLATION NOTES

Installation of the PC client may be perform as the current user (i.e. non-administrator level) or as an Administrator for all users of the PC. Security of some corporate environments may prevent a current user install. Administrator level setup usually requires that you right-click on the installer file and select Run as administrator to gain Admin rights, which could be considered a level above Administrator.

Setup also provides the option to copy MOMI files to a shared network location and copy files to the NonStop System (via FTP or sFTP). 

mini-MOMI

MOMI operates in a reduced functionality or mini-MOMI mode when the MOMI server is started without a password (a time limited trial password or a purchased password are placed in the CONFMOMI file on the NonStop System).

Mini-MOMI is available a period of 2-years from the version date of the NonStop server portion of the program. The expiration date is displayed on the PC Client screen Configure / Diagnostics.

Shops running mini-MOMI are encouraged to check our web site from time-to-time for new versions or updates.

While it is our intention to provide mini-MOMI in future versions, BlackWood reserves the right to alter, limit or discontinue mini-MOMI in subsequent releases.

MULTIPLE PLATFORM SERVER SUPPORT

MOMI configuration files support S-Series, NonStop Integrity, NonStop Blades and Integrity NonStop X.

On the NonStop system, in the subvolume where MOMI is installed, the following object files are present by default:

   BWMOMI  - 32-bit TNS/R native (S-Series)
   BWMOMIi - 32-bit TNS/E native (Integrity & Blades)
   BWMOMIx - 32-bit TNS/X native (Intel X64 & Virtual NonStop)

The TACL obey files OBYCSQL, used to SQL/MP compile MOMI objects, and OBYMOMI, used to start the MOMI subsystem, automatically select the correct object file.

If automatic platform selection logic does not function, the error Illegal program file format is encountered, simply change the obey files to reference to the correct BWMOMI? object.

FIRST INSTALLATION
UPDATE AN EXISTING INSTALLATION

The procedures for installing MOMI the first time or updating an existing installation are virtually the same.
 
In prior releases, MOMI installation software was packaged as an EXE or ZIP. The MSI format performs all of the same features, plus allows the client to be installed under the current user which normally does not require administrator access.
 
The MOMI PC Client installs by default into its own version specific subdirectory and is accessed from the Windows Start menu under BWS MOMI n.nn (where n.nn is the version number).
 
It is recommended that a new version of the MOMI server software or an update to an existing version is installed into the same subvolume on the NonStop System. By default, existing startup and configuration information is not changed. Existing files are renamed as necessary to allow for installation while the MOMI server is running and to provide for fallback.
 
The installation process starts by obtaining MOMI software from either our website or perhaps a flash drive handed out a conference (we can also send you the software on a flash drive on request). MOMI installation software is a standard Windows MSI file and can either perform a new install or update an existing installation. The installation program also contains utilities for transferring MOMI server software to the NonStop System (MomiFTP) and for placing MOMI software on a shared drive location (CentralServer). 
 
The following steps describe installing MOMI software on the local PC and on the NonStop System:
 
1)	Obtain MOMI software and double click on the MSI file. The initial screen provides allows display of the ReadMe and detailed installer Help.
 
2)	Click though the Welcome screen. Please read and accept the License Agreement. Click through to continue.
 
3)	The Utilities screen allows the option to run MOMIFTP and CentralServer (can be run now or later). Click Install Client > to continue.
 
4)	The next screen selects the Setup Type. The default is Complete. Click through to continue.
 
5)	The Ready to Install the Program screen allows MOMI software on this PC to be installed Only for me (<user>) or Anyone who uses this computer (all users). Choose the desired option. Note the Anyone... selection prompts for an administrator logon if needed. After the installation completes, click Finish.
 
6)	Press the Windows Start button and under BWS MOMI n.nn (where n.nn is the version just installed) select MomiFTP.  
 
a.	On the screen 1st Connect to HPE NonStop, select the Transport type (FTP or SFTP), fill in the Host Address (NonStop System IP address or DNS),  User ID, Password and Initial $Vol.SubVol where the MOMI files are placed. The User ID specified owns the files after the transfer takes place. Press Connect to HPE NonStop. If the connection was successful, you will see a big green Connected...
 
b.	Press Next >> to advance the screen.
 
c.	On the screen 2nd Select Vol.SubVol on HPE NonStop a list of the files present (if any) in the selected location is displayed. For a new installation, you should choose an empty subvolume. Change the location as needed Change to update the display.
 
d.	Press Next >> to advance the screen.
 
e.	On the screen 3rd Select New Install or Update press Put Files on HPE NonStop to start the transfer. The status boxes indicate the outcome of the transfer. 
 
f.	Press the Exit button to disconnect and stop the program.

7)	From a TACL prompt, logon with the User ID and password that $MOMI will operate under. Volume to the location where the MOMI files were placed.
 
8)	Edit the file OBYMOMI. This is a TACL obey file used to start MOMI and provide initial configuration information. Page down to the section "vvv set values below here vvv". This marked portion of the obey file is used to change the initial startup values for the $MOMI server portion.
 
Check the process name, CPU $MOMI operates in, priority and home terminal. Default values are usually valid for most systems.
 
9)	Edit the file CONFMOMI. This edit file is used to set various MOMI attributes using keywords. Set the System-Description and check TCPIP-LISTEN which defines the TCP/IP process name, optionally the address and port that MOMI will listen on for PC Client connections.

•	mini-MOMI users, the above should be about the only item of concern.

•	MOMI users, add your MOMI password. Also, define any history files desired. MOMI automatically creates the history files.
 
10)	SQL/MP compile MOMI (if you don't use SQL, ignore this step):

from a TACL prompt: OBEY OBYCSQL 
 
11)	Create / update BWSSG (the Super Group helper process) (see Security / General considerations to determine if you need this step): 

(BWSSG is a PROGID'ed copy of the MOMI server. The following steps show you how to rename out any existing BWSSG, keeping a backup copy, create a new file - details such as required logon security to perform these operations is not covered).
 
Purge BWSSG2
Rename BWSSG1, BWSSG2
Rename BWSSG,  BWSSG1

FUP DUP  BWMOMI, BWSSG, sourcedate (BWMOMIi TNS/E - BWMOMIx TNS/X)

FUP Give BWSSG, <Super.Group>
FUP secure  BWSSG, NGNG, PROGID
 
If used, BWSSG must be updated with BWMOMI. The FUP DUP option of SOURCEDATE or SAVEALL must be used.
  
12)	Start MOMI:

From a TACL prompt: OBEY OBYMOMI

(wait at least 1 minute before proceeding to the next step)
 
13)	On your PC, press the Windows Start button and under BWS MOMI n.nn (where n.nn is the version just installed) select MOMI. The first time a Client is started on a PC, it will prompt for the TCP/IP address and port of the NonStop System (the port is defined in the CONFMOMI file and has a default of 2010).

MOMI starts on the NonStop System a measurement (DCPUS file) configured with a variety of entities (CPU, Process, TMF, etc...). This measurement does not specify an interval but is effectively used for LISTACTIVE purposes. 

RUNNING SSMOMI SCREEN SAVER AS A STAND ALONE PROGRAM

Some users have requested the ability to run the ssMOMI screen saver as a standalone program that does not stop when the screen is clicked, or the keyboard is pressed.

To run ssMOMI as a standalone program:

1)	Copy the MOMI screen saver ssMOMI.scr giving it the name ssMOMI.exe.

2)	Start the program as follows:

ssMOMI.EXE /c AsEXE

3)	A pop-up window displays. Select the location of your MOMI.INI file. By default this is located at:

C:\Documents and Settings\<user>\Application Data\BlackWood Systems\MOMI

4)	After pressing OK, the screen saver appears. Press X to close.

5)	Create a Shortcut with the Target as follows:

ssMOMI.EXE AsEXE

(path details to the EXE omitted)

The run-time param /c directs the program to display a pop-up window to configure the location of the MOMI.INI. AsEXE directs the program to continue executing after keys are pressed (i.e. don’t function as a screen-saver).

MANUAL INSTALLATION OF NONSTOP BASED PROGRAMS

If the MOMIFTP utility cannot be used to transfer files from the PC to the NonStop server, these instructions describe how an alternate file transfer program would be used. The MOMIFTP utility does not perform any special actions, but simply renames files (if existing are present) and transfers MOMI files from the PC to the NonStop System using FTP or SFTP.
 
The first step is to locate the source files -

PC install all users:
 
C:\Program Files (x86)\BlackWood Systems\BWS MOMI_n.nn\Tandem Install\NonStop\ 
 
PC install user only:
 
C:\Users\<User ID>\AppData\Local\Programs\BlackWood Systems\BWS MOMI n.nn

Via shared server (varies based on how shared server is organized):
 
\Tandem Install\NonStop\

(where n.nn is the release package number)

If MOMI is not installed, download and execute the MSI file. Select Launch CentralServer and place the files in an empty subdirectory. In the destination subdirectory under \Tandem Install\NonStop are the subdirectories \ascii and \Binary. The grouping indicates the needed file transfer mode (i.e. ASCII or Binary).

Using a file transfer utility, copy files from the PC to the NonStop (all to the same destination subvolume) -

Binary

BWMOMI
BWMOMIi
BWMOMIx
EMSEXPO

ASCII

FUPEVTCX
OBYMOMI
CONFMOMI
OBYCSQL
OBYALTER

Logon to the NonStop System, volume to the location where the files were placed and OBEY the TACL obey file OBYALTER to alter the file codes (or manually perform the steps below):

a)	FUP alter BWMOMI ,code 700
b)	FUP alter BWMOMIi,code 800
c)	FUP alter BWMOMIx,code 500
d)	FUP alter EMSEXPO,code 845

At this point the files are transferred. Continue the instructions in the section First Installation / Update an existing installation after the step using MOMIFTP.

FUTURE PLANS (may or may not be in future releases)

1)	CMON   
2)	More history chart-able entities
3)	New functionality as requested by our users
4)	Additional Tools and References as we think of them
5)	Pathway information

We welcome comments, suggestions, and bug reports. Please send them to:

support@blackwood-systems.com

*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*

Below is the general layout for MOMI Software as seen after user Central Server or on a Flash Drive plus the general purpose for each file: 

Documents							= Directory of documentation
 License.rtf /txt 		=		MOMI disclaimer/license
 MOMI History.rtf			=		Change history
 Readme.rtf       		=		This file	(<<<---START HERE)

Extras            		= Directory of Optional Programs
		IPCalc									=  Directory of IP Calculator	 
	MomiEMail							=  Directory of MOMI Email support (diagnostic) 
ssMOMI.SCR						=		MOMI Screen saver
   
	Help               		=	Directory of Help files
	 HTML5									=  Directory of HTLM5 style help
	 Microsoft_HTML_Help	=  Directory of CHM style help			
	 MS Word								=  Directory of Microsoft Word style help             
 PDF											=  Directory of Adobe PDF style help

	Misc_Sounds						= Directory of Miscellaneous Sounds 

	ShortCuts								= Directory of MOMI shortcuts(after Central Server)
	
	Sounds									= Directory of MOMI sound files

	Tandem Install					=	Directory for Setting up NonStop
	NonStop 							=		Directory of NonStop software
				ASCII								=			Directory of Ascii files
					CONFMOMI						=				Initial configuration file
					FUPEVTCX						=				FUP obey file to create EVENTCX file
					OBYALTER						=				TACL obey file to alter file codes
					OBYCSQL						= 			TACL obey file to SQL compile MOMI
					OBYMOMI						=				Startup obey file
				Binary								=			Directory of Binary files
					G06.29-and-later	= 			optional use if G06.29 or later
						BWMOMI						= 				MOMI Server (TNS/R native code 700)
					Pre-H06.05				=				optional use on pre-H06.05
						BWMOMIi				 	=					MOMI Server (TNS/E native code 800)
					BWMOMI     			 	=				MOMI Server (TNS/R native code 700)
					BWMOMIi					 	=				MOMI Server (TNS/E native code 800)
					BWMOMIx					 	=				MOMI Server (TNS/X native code 500)
					EMSEXPO					 	=				Compiled EMS filter (code 845)

	 MomiFTP.EXE						=			FTP transfer MOMI files to NonStop System
		 TanFiles								=			MomiFTP.EXE config database
   
Calendar.new						= MOMI calendar database (initial and updates)
CentralServer.exe			= Program that copies Client files to central PC           
ErrorCodes.mom					= MOMI system supplied error database
MOMI.EXE									= MOMI client
TimeZone.mom						= MOMI time zone database