Readme.rtf       Date 2019/10/25

BlackWood Systems, Inc.

phone: 602-569-8766
fax:   480-905-8778
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 agree to the License.txt file 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

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.05
   Release Date (yyyy/mm/dd)	2019/10/25

	item	Version
	----	-------
	Latest O/S tested	G06.32.01 - H06.29.00
	J06.23.00 – L19.03.00
	
	Client Version	6.05
	Server Version (VPROC)	6.05   T0000G06___V6_05____2019_10_21
      
	Buffer Version	Client 21.59   Server 21.59
	History database	3.10
	CONFMOMI	6.01
	OBYMOMI	5.02
	OBYCSQL	5.02
	MomiFTP.exe	2.14
	ssMOMI.scr	6.00
	MomiEMail.exe	1.10
	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.  

Impacts in this version
The Free version of the CAIL emulator is no longer provided with the MOMI client. If the user has the full-function purchased version installed it will continue to work. If the user has any 6530 Emulator programs on their PC that they want to start from within the MOMI client, the Systems / External screen will allow a button to be created to start their emulator.

MOMI Software short-cuts, as displayed by the Windows Start menu, now use the format of BWS MOMI n.nn. Previously, MOMI software short-cuts were located under BlackWood Systems. This change is for compatibility with Windows 10 which does not handle multiple levels within the Start menu.

MOMI Client
	New Screens: 	
·	None 

	New Features:
·	Files / Enscribe / File
- Right-Click on filename added to copy all selected file names into Clipboard. (for Bill B.)
•	Files / File Explorer / OSS
•	- Current path at top of Grid now is editable and can go directly to the entered location. If the location is invalid it will back up the path until it gets a valid path. (for Tom S.)
•	- Added Refresh button to the current path location so if files are being created or deleted the user can get the new list without starting over at the root. (for Bill B. and Tom S.)
•	SubSystems / logs / EMS logs
•	- Added new feature "Lightning Mode" to perform a much faster load of the EMS messages. If the EMS Msgs screen is busy loading records and the "Lightning Bolt" button is pressed the EMS Msgs screen will be replaced with a "Lightning Mode" screen showing progress. Once the screen is caught up it will switch back into the normal EMS Msgs screen. No messages are lost switching into or out of "Lightning Mode". (For Tom S.)
•	- Config now has a "Lightning Mode" button. (For Tom S.)
•	 SubSystems / Logs / EventBX / List-Import-Export
•	- Added new feature to List Section allowing the user to search thru all EventBX records and locate the wanted text and then click on found list and jump directly to edit them. (For Tom S.)
•	SubSystems / Spooler / Jobs
•	- On columns that are a String-type filter you may now right-click and set a filter to include/exclude rows where that column data is the data in the selected cell. (for Tom S.)
•	- A location may now use Regular expression wildcards (*,?,[xyz],[x-x]) to limit the returned jobs. (for Tom S.)
•	History
•	- On any screen that the user can select the history database to use the user can now click on the interval wanted to set the drop box below.
•	Alarms / Define / Action
•	- Added ability to define which EMS Collector is sent the action message (For Diana K.)
•	Alarms / List / Alarm
•	- Added check column to allow enable/disable of multiple alarms at one time. (for Bill B.)
•	Configure / Client / General
•	- Ability to resize client down to 800x600 that was removed in 6.02 has been put back in with the ability now changed to 'Eliminate Minimum Client size'.  This allows the client to resize as small as the user wants but making the screen less than 1024x768 can result in screen anomalies that might make the screen unusable. (for Tom S.)
•	
•	
•		Bug Fixes:
•	SubSystems / logs / EMS logs
•	- EMS Detail screen eliminated duplicate spaces due to HTML encoding. This could result in the copy to clipboard text not always matching actual record data. Fixed.
•	SubSystems / logs / EMS EventBX
•	- Saving a record when client was resized resulting in incorrect EventBX font sizes. Fixed.
•	SubSystems / Spooler / Jobs  
•	  	SubSystems / Spooler / View Job
•	- Multiple Job View logic sped up and selected list hidden logic corrected to prevent popup disappearing. Fixed.
•	SubSystems / Spooler / Jobs
•	- When a job was copied from one Collector to another after the copy was complete a false error of Item Not Found would appear. Fixed.
•	Alarms / Define / Alarm
•	- Sometimes the Alarm Delay value would not always display correctly even though the value was being correctly utilized. Fixed.
•	Configure / Client Access / User List
•	- When a User was dragged out of the Group IDS and Members of Groups section and dropped into the Individual User IDs section it would report the change was successful, but the user was not actually removed from the group.  Fixed.
•	
•	Misc. Items:
•	Upon startup the INI file now has validity checks and repairs are performed on some items.
•	When Help is launched the O/S assigned default browser for .htm files is now used. Previously, Internet Explorer was always launched.
•	Files / File Explorer
•		Files / Enscribe / File
•		Files / Enscribe / File Detail
•	- Enabled the ability to check multiple SMF files to be Relocated. (for Bill B.)
•	- If a SMF File relocation is performed the screen will no longer auto-refresh after the move is complete. Instead a status popup will show the state of each file. (for Bill B.)
•	SubSystems / logs / EMS logs
•	- EMS Message Detail pop-up window now has a tab with the message and a separate tab ('C/E/R' meaning 'Cause / Effect / Recovery') containing the EventTX record for that message. This data comes from a file on the NonStop System.
•	- Increased size of EMS Message detail and EMS filter Define to allow more text. (for Tom S.)
•	Alarms / List / Group List
•	- The emails are now sorted within the group.
•	
•		Known issues:
•	The FireFox web browser does not display help correctly if HTML4 is selected. Use HTML5 or another browser instead.
•	When using Windows 7 and a 4K monitor and the client is resized to full screen, the down-arrow on a drop box is very small. They do not resize like other items. It works fine with Windows 10.
•	When converting from Mini-MOMI to full MOMI it may be necessary to restart the client.
•	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 server returns the new location of an SMF file in the response to a relocate request.
•	
•	Retrieval speed of EventBX records was greatly increased.
•	
•	Spooler related processing, where a location may be specified, may now use * or ? wild card characters within the field. Internally, MOMI requests all locations and performs pattern matching prior to returning responses to the client. 
•	
•	Internal processing related to searching through spoolers was revised and optimized in several situations reducing CPU overhead.
•	
•	Positioning by time within an EMS collector now returns the name of an expected but missing file. This could occur if the maximum number of files an EMS collector may create is insufficient and deletion was required.
•	
•	EMS log file access failures (1031) now include the file name (if available).
•	
•	 	Bug Fixes:
•	Several problems were corrected so that history consolidation now correctly functions. Issues were addressed with the Process, Msystem and OSSNS entities and an issue when the dump interval for HST01DB was 10 seconds or less.
•	
•	The SPI resources used in converting EMS events to readable tokens now always invokes a SPI finish routine. This prevents a possible situation, although none was reported, where a MOMI server could encounter error to the resource leak.
•	
•	Several potential bugs where corrected related to the occurrence spooler request in progress errors (%14016). The spooler returns this error after 32 internal searches. MOMI code now maintains the correct internal context related to reissuing commands after the request in progress errors.
•	
•	Error 590 (bad parameter) should no longer be returned when displaying records from the EventCX file using Read or Read next requests. A coding error was corrected so the variable specifying the type of file access now is always initialized (some platforms or O/S versions may not encounter the error).
•	
•	The Enscribe operation to duplicate a file, via FUP DUP, no longer returns an error 13 (improper format) when the destination file contains an asterisk. Problem introduced in server 5.51.

	Misc. Items:
·	History consolidation into HST02DB, HST03DB and HST04DB now deletes any data present in the period about to be written. This insure that in the event a partial period is present the new data is written in its entirety (existing data of a partial period remained).

·	Defaults for the CONFMOMI keyword TCPIP-WRITE-BYTES-SEC were changed to 5,000,000 (old 4,000,000) for the TNS/X system and unknown processors are set to 4,000,000.

·	MOMI no longer contacts all spooler supervisors when a specific collector is specified in a request. Internally, when this situation is detected MOMI modifies the request so that it only contacts the parent process of the collector.

·	EMS End of File errors (1032) are now indicated to the client an information error instead of nonfatal error. The change result in many situations the client will no longer shows this error in red.  

	Known Issues:
·		None 

MOMIFTP 
·	Help now uses default browser

ssMOMI 
·	None	

MomiEmail 
·	None	

SendMail 
·	None	

IPCalc 
·	None

CLIENT INSTALLATION NOTES

Installation of the PC client via setup requires logon as the PC administrator. A Windows security failure during setup usually means it is necessary to right-click and select Run as administrator to gain Admin rights, which is a level above Administrator.

The setup launcher has an alternate installation option of copying MOMI files to a shared network location.  

mini-MOMI

MOMI provides the ability to operate in a reduced functionality or lite mode. This mode is automatic whenever MOMI is started without a password. To install mini-MOMI, follow the installation instructions but omit a password in the CONFMOMI file.

Mini-MOMI will operate for 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, updates or a mini-MOMI password.

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

If you are installing MOMI for the first time, or updating an existing installation of MOMI, this section will walk you through 1) installing MOMI on the PC, and 2) installing MOMI on the NonStop System.

Installing MOMI software to the local PC requires Administrator access under Windows. 

1)	If you need MOMI software, download the latest version of MOMI from our web site.

2a) If you downloaded an EXE file:

a. double click on the downloaded file

2b) If you downloaded a ZIP file:

a. expand the ZIP file to an empty subdirectory on your PC

     b. double click on the file Launcher.exe

2c) If you have a MOMI DVD / Flash Drive:

a. double click on the file Launcher.exe

3)	Once the installation process starts your given the options to a) Install the MOMI Client, b) Install the MOMI Server files on NonStop Server, c) Copy MOMI client files to common server location, or d) View ReadMe file for MOMI. Select Install MOMI Client. A logon prompt may occur for administrator. Click though the initial and Welcome screen. Please read and accept the license agreement.

4)	The next screen is Choose the Destination Folder, or location, where the MOMI files on the PC are to be installed (default recommended). By default, each version of MOMI installs into its own version specific subdirectory.

5)	The next screen selects the Setup Type. Choose Complete Installation.

6)	Choose the name of the program group for shortcut on the Start menu (default recommended). By default, each version of MOMI creates its own version specific shortcuts.

7)	Click Next to begin the installation (which may take some time).

8)	Click finish.

9)	The program MomiFTP is automatically started and will perform the FTP or SFTP transfer of files from the PC to the NonStop.

On the 1st Connect to NonStop page, select the transport type, fill in the Host Address (your NonStop IP address), User ID, password and initial Volume/Subvolume where the MOMI files are placed. The User ID specified owns the files once the transfer takes place. Press Connect. If the connection was successful, you will see a big green "Connected..." .

Press Next >>> to advance the screen.

On the 2nd Select Vol/SubVol on NonStop screen shows a list of the files present in the selected location. Change the location if desired and press Change.

Press Next >>> to advance the screen.

On the 3rd Select New Install or Update screen press Put Files on NonStop. The status boxes indicate the outcome of the transfer.

Press the Exit button to disconnect and stop the program.

10)	From a TACL terminal emulator, Logon with the User ID and password to operate $MOMI. Volume to the location where the MOMI files were placed.

11)	Edit the file OBYMOMI. This is a TACL obey file used to start MOMI and provide initial configuration information. Page down to the section "set values below here". This marked portion of the obey file is the place to change initial startup values for MOMI.

Check the process name, CPU $MOMI operates in, priority and home terminal. The default values are good for most systems.

12)	Edit the file CONFMOMI. This edit file is used to set various MOMI attributes using keywords. Set the System-description and check the TCP/IP process name and port that MOMI will 'listen' on for PC client connections.

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

MOMI users, add your MOMI password. Also, define any history files desired. MOMI automatically creates the history files in the location specified.

13)	SQL/MP compile MOMI (if you don't have SQL/MP, ignore this step):

From a TACL prompt: OBEY OBYCSQL

14) Create a Super Group helper program (the steps below omit logon to the super.* ID):

Purge BWSSG2

Rename BWSSG1, BWSSG2

Rename BWSSG, BWSSG1

FUP DUP BWMOMI, BWSSG, sourcedate			(BWMOMIi or BWMOMIx)

FUP GIVE BWSSG, <super.group>					 

FUP SECURE BWSSG, NGNG, PROGID

An existing BWSSG must be updated any time BWMOMI is updated.
(The FUP DUP option of SOURCEDATE or SAVEALL must be used)

15)	Start MOMI:

    From a TACL prompt: OBEY OBYMOMI

    (wait at least 1 minute before proceeding to the next step)

16)	On your PC, start the PC MOMI client (Start/ALL Programs/BlackWood Systems/MOMI_n.nn/MOMI). The MOMI client will detect an initial start on the PC and will prompt for the TCP/IP address of the NonStop and port. The port is defined in the CONFMOMI file and has a default of 2010.

Note that these instructions may reoccur in other portions of this document or provide optional installation methods.

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. If MOMI is installed on the PC the files are located by default at:

C:\Program Files (x86)\BlackWood Systems\MOMI_n.nn\Tandem Install\NonStop\
 			
(where n.nn is the release package number)

If you have the MOMI download ZIP from our website expand the files to an empty subdirectory and look for the subdirectory \NonStop Install. The MOMI DVD files are in the same subdirectory name.

Note that under the subdirectory \NonStop there are two additional directories \Ascii and \Binary. This grouping indicates the file transfer mode (i.e. ASCII or Binary).

The second step, 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

The third step is to 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

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

The MOMI DVD / Flash Drive or EXE files follow the same general layout.  

The following is the general file layout and purpose for each file:

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

Extras             			= Directory of Optional Programs
ssMOMI.SCR          	=		MOMI Screen saver
   
Help               			=	Directory of Help files
		HTML5										=		Directory of HTLM5 style help
		Microsoft_HTML_Help 	=		Directory of CHM style help			
		WebHelp	         			=		Directory of Web style help
		MOMI_User.doc						=		Help in Word format
		MOMI_User.pdf						=		Help in Adobe PDF format

	NonStop 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 MOMI files to NonStop System
			TanFiles							 	=			MomiFTP.EXE config database

   PC Manual Install 			=	Directory for Manual Install
			CAIL										=		Directory containing CAIL Emulator
			Documents							=		Directory of documents
			Extras									=		Directory of optional programs
			Help										=		Directory of Help formats
			Misc_Sounds						=		Directory of misc. sound files
			Sounds									=		Directory of MOMI sound files
			Tandem Install				=		Directory for Setting up NonStop
			Calendar.new					=		MOMI calendar database
			ErrorCodes.mom				=		MOMI system supplied error database
     MOMI.EXE								=		MOMI client
   		Readme.rtf						=		Readme instructions (<<<---START HERE)
     TimeZone.mom					=		MOMI time zone database

		Launcher.exe						= Program allowing user to select install options
   CentralServer.exe     = Program that copies Client files to central PC       Server
		Readme.rtf							= This file
		MOMI_Client.exe				= MOMI Client Installation program