BMXNET40

DataTableFutures are created synchrounously when Async calls are made on a RemoteSession. A DataTabelFuture is used to manage each async call and has a variety of methods to support the relativelty long and dynamic lifecycle and an Async call.

Beware that all return communications are not on the UI thread unless an InvokedControl is specify.

Method to cancel the Async call. This does not stop the server-side processing. The Aborted event will be called immediately.

If IsAutoFetchEnabled is false, then the results must be fetched synchrounously useding PostFetch(). Call PostFetch() once and check if HasData is true. If not true, there is was error related to the async call.

Triggered with the async returns, see DataTableFutureEventArgs to know if there is a result waiting. It's very common to hook the Returned event after each Async call and then unhook it when the Returned or Aborted calls return.

If the InvokedControl is set to a valid Form or Control object (non-displosed), the DataTabletFuture will trigger events on the UI thread using Invoke()

If set to true the result will be fetched before the Returned event is called, otherwise the Returned event will be triggered and the application code needs to call PostFetch() to retrieve the result. True by default.

Access to any exceptions that occur during Async call.

The result table if any, or null.

Answer true if canceled. It's common that a dialog would allow the user to cancel the Async call and the Dialog that is holding on the the Future will cancel the Future. Cancelling the Future does not stop the server-side processing but when the server returns nothing will happen.

Answer true if the Async call has timeed-out (a time-based version of Cancel)

Answer true if the Async call has completed on the server and that a result is ready.

Answer true if the data has been fetched from the server and is ready to be used by the application.

The time the Future was created.

The time the async call returned (the future)

How long in milliseconds the Async call took to complete.

Number of seconds to wait for an async response before returning without a response.

The data set the result data table is in.

The AppContext that the async call was made with

To test the BMXNetBroker class, we can use one instance of BMXNetBroker to be the authenicated transport and use the receiver to be the encapsulated BMX interaction.

BMXNetSessionConnection implements low-level connectivity to RPMS databases.

Given strInput = "13" builds "013" if nLength = 3. Default for nLength is 3.

Given strInput = "13" builds "013" if nLength = 3 Default for nLength is 3.

Default = 3

Concatenates zero-padded length of sInput to sInput Given "Hello" returns "004Hello" If nSize = 5, returns "00004Hello" Default for nSize is 3.

Build protocol header

Returns index of first instance of sSubString in sString. If sSubString not found, returns -1.

Lock a local or global M variable Returns true if lock is obtained during TimeOut seconds Use + to increment, - to decrement lock.

AppContext is managed an client and server with c/s calls to change appContext on the server. There is no use for AppContext on the client so recommend integrated AppContext into BMX Protocol so always passing it and managing switching it on the server.

Returns a reference to the internal ReaderWriterLock member.

Gets/sets the Kernel Application context Throws an exception if unable to set the context.

This implementation EncryptionProvider is the crypto used for the standard Indian Health Service socket-based BMXNET Broker.

The crypto used to implement the socket-based BMXNET Broker. Any crypto can be used if a new .NET EncryptionProvider is written and a corresponding modification to the RPMS-side is done.

An quick experiment can be done by implementing the following ClearText EncryptionProvider and modifying the RPMS-side encryption routines to do nothing.


            public class ClearText : EncryptionProvider
            {
                public string Encrypt(string aString)
                {
                    return aString;
                }
            
                public string Decrypt(string aString)
                {
                    return aString;
                }
            }

Encrypt aString

The string to be encrypted An ASCII encrypted string

Decrypt aString

The ASCII string to be decrypted An ASCII decrypted string

Set a site specific key

The required key for BMX Ade

BMXAde Implementation

String to encrypt Encrypt string

BMXAde Implementation

String to decrypt Decrypted string

Common M[umps] related function libraries implemented with static members.

M-like utility method to answer the number of pieces limited by aDelimiter. Corresponds to M's $L(STRING,DELIMITER)

Delimited input string e.g. one^two^three Delimiter character or string, commonly ~ ^ or | Count of pieces in thePieces delimited by aDelimiter


                String team="DOE,JOHN^SMITH, PETER^JONES, SALLY";
                if (M.PieceLength(team,"~") >=5 ) {
                    this.PlayBasketBall();
                } 
                else 
                {
                    this.PlayTrackAndField();
                }

M-like utility method to answer the piece at a 1-based offset. Corresponds to M's $$Piece function

Delimited input string e.g. one^two^three Delimiter character or string, commonly ~ ^ or | The 1-based index of the piece The piece at the index, or an empty string if the index is higher than the explicit number of pieces


                String demographics="DOE,JOHN~555-55-5555~34~M";
                int age=0;
                if (int.TryParse(M.Piece(demographics,"~",3), out age)) {
                    System.Console.Writeln(M.Piece(demographics,"~",1)+" is "+ (age >= 18 ) ? "an adult" : "a child");
                }

M-like utility method to answer a delimited string of pieces between two 1-based offsets

Delimited input string e.g. one^two^three Delimiter character or string, commonly ~ ^ or | Starting 1-based index of the pieces to copy from Ending 1-based index of the pieces to copy to The delimited string from start to end, including delimitered blanks for indexes higher than the explicit number of pieces

M-like utility method to convert from a DateTime to the FileMan data/time format

DateTime to convert String representing aDateTime in FileMan format Exception thrown in conversion fails

M-like utility method to convert from a FileMan date/time formatted String to a .NET DateTime

date/time formated FileMan string .NET DateTime object from parsing input FileMan string Exception thrown in conversion fails

An instance of these args are included with the ContextChanging event and this event is a CancelEventArgs subclass. The Cancel property being set to True represents the desire to Veto the change so the patient (and potentially visit) does not change. The Veto can be overriden by the framework so be prepared for the context to change even if you don't want it to.

Answer True if the visit is about to be changed.

The current state of the Context.

The argument to the ContextChanged method. This event has methods that allow you to detect which aspects of the context have changed and what the new context is.

Answer if the visit had changed. When the patient changes and a visit had been selected, the visit will change to null.

In the following example, the first tab of a notebook is selected whenever the patient changes.


            void Context_Changed(object sender, ContextChangedArgs e)
            {
                if (e.IsPatientChange)
                {
                    this.SelectedIndex = 1;
                    this.RefreshAll();
                }
            }

Answer if the patient had changed.

The current state of the context. This context object is that same instance used for the life of the LocalSession

Convienence class to provide information from the AssembleInfo


            [assembly: AssemblyTitle("IndianHealthService.BMXNet.Test")]
            [assembly: AssemblyDescription("A test application")]
            [assembly: AssemblyCompany("IHS")]
            [assembly: AssemblyProduct("IndianHealthService.BMXNet.Test")]
            [assembly: AssemblyCopyright("IHS 2009")]
            [assembly: AssemblyVersion("2.0.0.0")]