source: BMXNET_RPMS_dotNET_UTILITIES-BMX/branch/IHS BMX Framework/IndianHealthService.BMXNet/bmxnet.xml@ 1184

Last change on this file since 1184 was 1180, checked in by Sam Habiel, 14 years ago

RemoteSession.cs Interface: Added:

  • Lock method to lock glvns on M db.
  • Encoding ConnectionEncoding to set the connection encoding on the DB

BMXNetSessionConnection: Added:

  • Abstract ConnectionEncoding property
  • Clarified error message that gets called. It now says that you don't have TransmitRPC writer lock??? When the error could be any BMXNetException.

BMXNetSessionSocketConnection:

  • Added ConnectionEncoding property
  • ReceiveString completely refactored: now we get much better performance
  • Timers and Debug Writes are all over the place now.

BMXNetRemoteSession:

  • Implemented the 2 new 'stuff' in Interface RemoteSesssion: -- Lock glvn -- Encoding Property
  • TableFromSQL with Dataset has an honest to god bug in it: The passed dataset and table name are not used even though they are passed.

BMXNetSessionConnectionOverAnotherSessionConnection:

  • Implemented the Encoding Property in Interface RemoteSession to have the project compile.

Updated dlls. Have fun.

File size: 112.7 KB
Line 
1<?xml version="1.0"?>
2<doc>
3 <assembly>
4 <name>BMXNET40</name>
5 </assembly>
6 <members>
7 <member name="T:IndianHealthService.BMXNet.Ado.DataTableFuture">
8 <summary>
9 DataTableFutures are created synchrounously when Async calls are made on a RemoteSession.
10 A DataTabelFuture is used to manage each async call and has a variety of methods to support
11 the relativelty long and dynamic lifecycle and an Async call.
12 </summary>
13 <remarks>
14 Beware that all return communications are not on the UI thread unless an InvokedControl
15 is specify.
16 </remarks>
17 </member>
18 <member name="M:IndianHealthService.BMXNet.Ado.DataTableFuture.Cancel">
19 <summary>
20 Method to cancel the Async call. This does not stop the server-side processing. The Aborted event
21 will be called immediately.
22 </summary>
23 </member>
24 <member name="M:IndianHealthService.BMXNet.Ado.DataTableFuture.PostFetch">
25 <summary>
26 If IsAutoFetchEnabled is false, then the results must be fetched synchrounously useding PostFetch().
27 Call PostFetch() once and check if HasData is true. If not true, there is was error related to the
28 async call.
29 </summary>
30 </member>
31 <member name="E:IndianHealthService.BMXNet.Ado.DataTableFuture.Returned">
32 <summary>
33 Triggered with the async returns, see DataTableFutureEventArgs to know if there
34 is a result waiting. It's very common to hook the Returned event after each Async call and
35 then unhook it when the Returned or Aborted calls return.
36 </summary>
37 </member>
38 <!-- Badly formed XML comment ignored for member "E:IndianHealthService.BMXNet.Ado.DataTableFuture.Aborted" -->
39 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.InvokedControl">
40 If the InvokedControl is set to a valid Form or Control object (non-displosed), the
41 DataTabletFuture will trigger events on the UI thread using Invoke()
42 </member>
43 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.IsAutoFetchEnabled">
44 <summary>
45 If set to true the result will be fetched before the Returned event is called, otherwise
46 the Returned event will be triggered and the application code needs to call PostFetch() to retrieve
47 the result. True by default.
48 </summary>
49 </member>
50 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.ErrorException">
51 <summary>
52 Access to any exceptions that occur during Async call.
53 </summary>
54 </member>
55 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.Result">
56 <summary>
57 The result table if any, or null.
58 </summary>
59 </member>
60 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.WasCancelled">
61 <summary>
62 Answer true if canceled. It's common that a dialog would allow the user to cancel the
63 Async call and the Dialog that is holding on the the Future will cancel the Future. Cancelling
64 the Future does not stop the server-side processing but when the server returns nothing will happen.
65 </summary>
66 </member>
67 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.HasTimedOut">
68 <summary>
69 Answer true if the Async call has timeed-out (a time-based version of Cancel)
70 </summary>
71 </member>
72 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.HasReturned">
73 <summary>
74 Answer true if the Async call has completed on the server and that a result is ready.
75 </summary>
76 </member>
77 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.HasData">
78 <summary>
79 Answer true if the data has been fetched from the server and is ready to be used by the application.
80 </summary>
81 </member>
82 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.PresentTime">
83 <summary>
84 The time the Future was created.
85 </summary>
86 </member>
87 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.FutureTime">
88 <summary>
89 The time the async call returned (the future)
90 </summary>
91 </member>
92 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.WaitTime">
93 <summary>
94 How long in milliseconds the Async call took to complete.
95 </summary>
96 </member>
97 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.MaxWaitTime">
98 <summary>
99 Number of seconds to wait for an async response before returning without a response.
100 </summary>
101 </member>
102 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.ResultDataSet">
103 <summary>
104 The data set the result data table is in.
105 </summary>
106 </member>
107 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFuture.ResultAppContext">
108 <summary>
109 The AppContext that the async call was made with
110 </summary>
111 </member>
112 <member name="T:IndianHealthService.BMXNet.Services.BMXNetSessionConnectionOverAnotherSessionConnection">
113 <summary>
114 To test the BMXNetBroker class, we can use one instance of BMXNetBroker
115 to be the authenicated transport and use the receiver to be the
116 encapsulated BMX interaction.
117 </summary>
118 </member>
119 <member name="T:IndianHealthService.BMXNet.BMXNetSessionConnection">
120 <summary>
121 BMXNetSessionConnection implements low-level connectivity to RPMS databases.
122 </summary>
123 </member>
124 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.ADEBLDPadString(System.String)">
125 <summary>
126 Given strInput = "13" builds "013" if nLength = 3. Default for nLength is 3.
127 </summary>
128 <param name="strInput"></param>
129 <returns></returns>
130 </member>
131 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.ADEBLDPadString(System.String,System.Int32)">
132 <summary>
133 Given strInput = "13" builds "013" if nLength = 3 Default for nLength is 3.
134 </summary>
135 <param name="strInput"></param>
136 <param name="nLength">Default = 3</param>
137 <returns></returns>
138 </member>
139 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.ADEBLDB(System.String)">
140 <summary>
141 Concatenates zero-padded length of sInput to sInput
142 Given "Hello" returns "004Hello"
143 If nSize = 5, returns "00004Hello"
144 Default for nSize is 3.
145 </summary>
146 <param name="sInput"></param>
147 <returns></returns>
148 </member>
149 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.ADEBLDB(System.String,System.Int32)">
150 <summary>
151 Concatenates zero-padded length of sInput to sInput
152 Given "Hello" returns "004Hello"
153 If nSize = 5, returns "00004Hello"
154 Default for nSize is 3.
155 </summary>
156 <param name="sInput"></param>
157 <param name="nSize"></param>
158 <returns></returns>
159 </member>
160 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.ADEBHDR(System.String,System.String,System.String,System.String)">
161 <summary>
162 Build protocol header
163 </summary>
164 <param name="sWKID"></param>
165 <param name="sWINH"></param>
166 <param name="sPRCH"></param>
167 <param name="sWISH"></param>
168 <returns></returns>
169 </member>
170 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.FindSubString(System.String,System.String)">
171 <summary>
172 Returns index of first instance of sSubString in sString.
173 If sSubString not found, returns -1.
174 </summary>
175 <param name="sString"></param>
176 <param name="sSubString"></param>
177 <returns></returns>
178 </member>
179 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.Lock(System.String,System.String,System.String)">
180 <summary>
181 Lock a local or global M variable
182 Returns true if lock is obtained during TimeOut seconds
183 Use + to increment, - to decrement lock.
184 </summary>
185 <param name="Variable"></param>
186 <param name="Increment"></param>
187 <param name="TimeOut"></param>
188 <returns></returns>
189 </member>
190 <member name="M:IndianHealthService.BMXNet.BMXNetSessionConnection.TransmitRPC(System.String,System.String)">
191 <remarks>
192 AppContext is managed an client and server with c/s calls to change
193 appContext on the server. There is no use for AppContext on the client
194 so recommend integrated AppContext into BMX Protocol so always passing
195 it and managing switching it on the server.
196 </remarks>
197 </member>
198 <member name="P:IndianHealthService.BMXNet.BMXNetSessionConnection.BMXRWL">
199 <summary>
200 Returns a reference to the internal ReaderWriterLock member.
201 </summary>
202 </member>
203 <member name="P:IndianHealthService.BMXNet.BMXNetSessionConnection.AppContext">
204 <summary>
205 Gets/sets the Kernel Application context
206 Throws an exception if unable to set the context.
207 </summary>
208 </member>
209 <member name="T:IndianHealthService.BMXNet.Net.BMXAdeCrypto">
210 <summary>
211 This implementation EncryptionProvider is the crypto used for the standard Indian Health Service socket-based BMXNET Broker.
212 </summary>
213 </member>
214 <member name="T:IndianHealthService.BMXNet.Net.EncryptionProvider">
215 <summary>
216 The crypto used to implement the socket-based BMXNET Broker. Any crypto can be used if a new
217 .NET EncryptionProvider is written and a corresponding modification to the RPMS-side is done.
218 </summary>
219 <remarks>
220 An quick experiment can be done by implementing the following ClearText EncryptionProvider and
221 modifying the RPMS-side encryption routines to do nothing.
222 <code>
223 public class ClearText : EncryptionProvider
224 {
225 public string Encrypt(string aString)
226 {
227 return aString;
228 }
229
230 public string Decrypt(string aString)
231 {
232 return aString;
233 }
234 }
235 </code>
236 </remarks>
237 </member>
238 <member name="M:IndianHealthService.BMXNet.Net.EncryptionProvider.Encrypt(System.String)">
239 <summary>
240 Encrypt aString
241 </summary>
242 <param name="aString">The string to be encrypted</param>
243 <returns>An ASCII encrypted string</returns>
244 </member>
245 <member name="M:IndianHealthService.BMXNet.Net.EncryptionProvider.Decrypt(System.String)">
246 <summary>
247 Decrypt aString
248 </summary>
249 <param name="aString">The ASCII string to be decrypted</param>
250 <returns>An ASCII decrypted string</returns>
251 </member>
252 <member name="M:IndianHealthService.BMXNet.Net.BMXAdeCrypto.SetKey(System.String[])">
253 <summary>
254 Set a site specific key
255 </summary>
256 <param name="aKey">The required key for BMX Ade</param>
257 </member>
258 <member name="M:IndianHealthService.BMXNet.Net.BMXAdeCrypto.Encrypt(System.String)">
259 <summary>
260 BMXAde Implementation
261 </summary>
262 <param name="aString">String to encrypt</param>
263 <returns>Encrypt string</returns>
264 </member>
265 <member name="M:IndianHealthService.BMXNet.Net.BMXAdeCrypto.Decrypt(System.String)">
266 <summary>
267 BMXAde Implementation
268 </summary>
269 <param name="aString">String to decrypt</param>
270 <returns>Decrypted string</returns>
271 </member>
272 <member name="T:IndianHealthService.BMXNet.M">
273 <summary>
274 Common M[umps] related function libraries implemented with static members.
275 </summary>
276 </member>
277 <member name="M:IndianHealthService.BMXNet.M.PieceLength(System.String,System.String)">
278 <summary>
279 M-like utility method to answer the number of pieces limited by aDelimiter. Corresponds to M's $L(STRING,DELIMITER)
280 </summary>
281 <param name="thePieces">Delimited input string e.g. one^two^three</param>
282 <param name="aDelimiter">Delimiter character or string, commonly ~ ^ or |</param>
283 <returns>Count of pieces in thePieces delimited by aDelimiter</returns>
284 <example>
285 <code>
286 String team="DOE,JOHN^SMITH, PETER^JONES, SALLY";
287 if (M.PieceLength(team,"~") >=5 ) {
288 this.PlayBasketBall();
289 }
290 else
291 {
292 this.PlayTrackAndField();
293 }
294 </code>
295 </example>
296 </member>
297 <member name="M:IndianHealthService.BMXNet.M.Piece(System.String,System.String,System.Int32)">
298 <summary>
299 M-like utility method to answer the piece at a 1-based offset. Corresponds to M's $$Piece function
300 </summary>
301 <param name="thePieces">Delimited input string e.g. one^two^three</param>
302 <param name="aDelimiter">Delimiter character or string, commonly ~ ^ or |</param>
303 <param name="nthPiece">The 1-based index of the piece</param>
304 <returns>The piece at the index, or an empty string if the index is higher than the explicit number of pieces</returns>
305 <example>
306 <code>
307 String demographics="DOE,JOHN~555-55-5555~34~M";
308 int age=0;
309 if (int.TryParse(M.Piece(demographics,"~",3), out age)) {
310 System.Console.Writeln(M.Piece(demographics,"~",1)+" is "+ (age >= 18 ) ? "an adult" : "a child");
311 }
312 </code>
313 </example>
314 </member>
315 <member name="M:IndianHealthService.BMXNet.M.Piece(System.String,System.String,System.Int32,System.Int32)">
316 <summary>
317 M-like utility method to answer a delimited string of pieces between two 1-based offsets
318 </summary>
319 <param name="thePieces">Delimited input string e.g. one^two^three</param>
320 <param name="aDelimiter">Delimiter character or string, commonly ~ ^ or |</param>
321 <param name="nthStart">Starting 1-based index of the pieces to copy from</param>
322 <param name="mthEnd">Ending 1-based index of the pieces to copy to</param>
323 <returns>The delimited string from start to end, including delimitered blanks for indexes higher than the explicit number of pieces</returns>
324 </member>
325 <member name="M:IndianHealthService.BMXNet.M.DateToFileMan(System.DateTime)">
326 <summary>
327 M-like utility method to convert from a DateTime to the FileMan data/time format
328 </summary>
329 <param name="aDateTime">DateTime to convert</param>
330 <returns>String representing aDateTime in FileMan format</returns>
331 <exception cref="T:System.Exception">Exception thrown in conversion fails</exception>
332 </member>
333 <member name="M:IndianHealthService.BMXNet.M.DateFromFileMan(System.String)">
334 <summary>
335 M-like utility method to convert from a FileMan date/time formatted String to a .NET DateTime
336 </summary>
337 <param name="aString">date/time formated FileMan string</param>
338 <returns>.NET DateTime object from parsing input FileMan string</returns>
339 <exception cref="T:System.Exception">Exception thrown in conversion fails</exception>
340 </member>
341 <member name="T:IndianHealthService.BMXNet.Model.ContextChangingArgs">
342 <summary>
343 An instance of these args are included with the ContextChanging event and this event
344 is a CancelEventArgs subclass. The Cancel property being set to True represents the desire
345 to Veto the change so the patient (and potentially visit) does not change. The Veto can be
346 overriden by the framework so be prepared for the context to change even if you don't want it
347 to.
348 </summary>
349 </member>
350 <member name="P:IndianHealthService.BMXNet.Model.ContextChangingArgs.IsVisitChange">
351 <summary>
352 Answer True if the visit is about to be changed.
353 </summary>
354 </member>
355 <member name="P:IndianHealthService.BMXNet.Model.ContextChangingArgs.IsPatientChange">
356 <summary>
357 Answer True if the visit is about to be changed.
358 </summary>
359 </member>
360 <member name="P:IndianHealthService.BMXNet.Model.ContextChangingArgs.BeforeContext">
361 <summary>
362 The current state of the Context.
363 </summary>
364 </member>
365 <member name="T:IndianHealthService.BMXNet.Model.ContextChangedArgs">
366 <summary>
367 The argument to the ContextChanged method. This event has methods that allow you
368 to detect which aspects of the context have changed and what the new context is.
369 </summary>
370 </member>
371 <member name="P:IndianHealthService.BMXNet.Model.ContextChangedArgs.IsVisitChange">
372 <summary>
373 Answer if the visit had changed. When the patient changes and a visit had been selected, the
374 visit will change to null.
375 </summary>
376 <example>
377 In the following example, the first tab of a notebook is selected whenever the patient changes.
378 <code>
379 void Context_Changed(object sender, ContextChangedArgs e)
380 {
381 if (e.IsPatientChange)
382 {
383 this.SelectedIndex = 1;
384 this.RefreshAll();
385 }
386 }
387 </code>
388 </example>
389 </member>
390 <member name="P:IndianHealthService.BMXNet.Model.ContextChangedArgs.IsPatientChange">
391 <summary>
392 Answer if the patient had changed.
393 </summary>
394 </member>
395 <member name="P:IndianHealthService.BMXNet.Model.ContextChangedArgs.AfterContext">
396 <summary>
397 The current state of the context. This context object is that same instance used for the
398 life of the LocalSession
399 </summary>
400 </member>
401 <member name="T:IndianHealthService.BMXNet.Util.EntryAssemblyInfo">
402 <summary>
403 Convienence class to provide information from the AssembleInfo
404 <code>
405 [assembly: AssemblyTitle("IndianHealthService.BMXNet.Test")]
406 [assembly: AssemblyDescription("A test application")]
407 [assembly: AssemblyCompany("IHS")]
408 [assembly: AssemblyProduct("IndianHealthService.BMXNet.Test")]
409 [assembly: AssemblyCopyright("IHS 2009")]
410 [assembly: AssemblyVersion("2.0.0.0")]
411 </code>
412 </summary>
413 </member>
414 <member name="P:IndianHealthService.BMXNet.Util.EntryAssemblyInfo.AssemblyTitle">
415 <summary>
416 Convienence method to provide information from the AssembleInfo
417 <code>
418 [assembly: AssemblyTitle("IndianHealthService.BMXNet.Test")]
419 </code>
420 </summary>
421 </member>
422 <member name="P:IndianHealthService.BMXNet.Util.EntryAssemblyInfo.AssemblyVersion">
423 <summary>
424 Convienence method to provide information from the AssembleInfo
425 <code>
426 [assembly: AssemblyVersion("2.0.0.0")]
427 </code>
428 </summary>
429 </member>
430 <member name="P:IndianHealthService.BMXNet.Util.EntryAssemblyInfo.AssemblyDescription">
431 <summary>
432 Convienence method to provide information from the AssembleInfo
433 <code>
434 [assembly: AssemblyDescription("A test application")]
435 </code>
436 </summary>
437 </member>
438 <member name="P:IndianHealthService.BMXNet.Util.EntryAssemblyInfo.AssemblyProduct">
439 <summary>
440 Convienence method to provide information from the AssembleInfo
441 <code>
442 [assembly: AssemblyProduct("IndianHealthService.BMXNet.Test")]
443 </code>
444 </summary>
445 </member>
446 <member name="P:IndianHealthService.BMXNet.Util.EntryAssemblyInfo.AssemblyCopyright">
447 <summary>
448 Convienence method to provide information from the AssembleInfo
449 <code>
450 [assembly: AssemblyCopyright("IHS 2009")]
451 </code>
452 </summary>
453 </member>
454 <member name="P:IndianHealthService.BMXNet.Util.EntryAssemblyInfo.AssemblyCompany">
455 <summary>
456 Convienence method to provide information from the AssembleInfo
457 <code>
458 [assembly: AssemblyCompany("IHS")]
459 </code>
460 </summary>
461 </member>
462 <member name="T:IndianHealthService.BMXNet.RemoteSession">
463 <summary>
464 All server-side RPMS RPC calls are performed through this interface. Each instance of RemoteSession corresponds to a single job (e.g. Cache process) on RPMS. There is always one primary RemoteSession and potentially more when using RemoteSessionPool. When the primary RemoteSession is closed all secondary pooled sessions are also closed and the server broker connection is terminated.
465 </summary>
466 </member>
467 <member name="M:IndianHealthService.BMXNet.RemoteSession.TransmitRPC(System.String,System.String)">
468 <summary>
469 Calls a remote procedure on the RPMS server and returns the result as a String.
470 </summary>
471 <remarks>
472 Presumes that the AppContext was set prior to the call.
473 </remarks>
474 <example>
475 <code>
476 ...
477 this.RemoteSession.AppContext="VEN RPC";
478 ...
479 String asqThreadholds= this.RemoteSession.TransmitRPC("VEN ASQ GET DATA", this.Context.Patient.Ien);
480 </code>
481 </example>
482 <param name="rpcCommand">The remote procedure call name </param>
483 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
484 <returns>The result of the RPC call</returns>
485 </member>
486 <!-- Badly formed XML comment ignored for member "M:IndianHealthService.BMXNet.RemoteSession.TransmitRPC(System.String,System.String,System.String)" -->
487 <member name="M:IndianHealthService.BMXNet.RemoteSession.SafelyTransmitRPC(System.String,System.String)">
488 <summary>
489 Calls a remote procedure on the RPMS server and returns the result as a String. If there are any exceptions a
490 colon delimited string in the format Exception:Message is returned.
491 </summary>
492 <remarks>
493 Presumes that the AppContext was set prior to the call.
494 </remarks>
495 <example>
496 <code>
497 ...
498 this.RemoteSession.AppContext="VEN RPC";
499 ...
500 String asqThreadholds= this.RemoteSession.SafelyTransmitRPC("VEN ASQ GET DATA", this.Context.Patient.Ien);
501 </code>
502 </example>
503 <param name="rpcCommand">The remote procedure call name </param>
504 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
505 <returns>The result of the RPC call. If there are any exceptions a colon delimited string in the format Exception:Message is returned.</returns>
506 </member>
507 <member name="M:IndianHealthService.BMXNet.RemoteSession.SafelyTransmitRPC(System.String,System.String,System.String)">
508 <summary>
509 Calls a remote procedure on the RPMS server and returns the result as a String. If there are any exceptions a
510 colon delimited string in the format Exception:Message is returned.
511 </summary>
512 <remarks>
513 Presumes that the AppContext was set prior to the call.
514 </remarks>
515 <example>
516 <code>
517 ...
518 this.RemoteSession.AppContext="VEN RPC";
519 ...
520 String asqThreadholds= this.RemoteSession.SafelyTransmitRPC("VEN ASQ GET DATA", this.Context.Patient.Ien);
521 </code>
522 </example>
523 <param name="rpcCommand">The remote procedure call name </param>
524 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
525 <param name="aContext">The AppContext (OPTION) to be set prior to the call(</param>
526 <returns>The result of the RPC call. If there are any exceptions a colon delimited string in the format Exception:Message is returned.</returns>
527 </member>
528 <member name="M:IndianHealthService.BMXNet.RemoteSession.SaveChanges(System.Data.DataTable)">
529 <summary>
530
531 <example>
532
533 <code>
534
535 this.Context.Visit.Create();
536 if (this.Context.Visit.IsStub)
537 {
538 if (!this.Context.Visit.Create())
539 {
540 return false;
541 }
542 }
543 this.RemoteSession.SaveChanges(this.ScoreTable);
544 </code>
545 </example>
546 </summary>
547 <param name="aDataTable"></param>
548 <returns></returns>
549 </member>
550 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromCommand(System.String)">
551 <summary>
552 Calling a Custom Remote Procedure call (RPC) registered in VA FileMan’s REMOTE PROCEDURE file that results in a DataTable. You must design your remote procedure’s M routine to build its result its data in the specific format described later in this document.
553 </summary>
554 <param name="aCommand">The co /// </param>
555 <remarks>
556 Normally the AppContext is set once, after logging into the BMX, with a
557 single AppContext for the current applications or specified in every RPC call.
558 </remarks>
559 <example>
560 The VEN namespace is for PCC+ and the example below would be used at the beginning
561 of a PCC+ application.
562 <code>
563 aRemoteSession.AppContext = "VEN RPC";
564 </code>
565 The M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
566 <code>
567 Figure 5 2 shows the M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
568 PDEMO(BMXY,BMXPAT,BMXCOUNT) ;EP
569 ;This simple RPC demonstrates how to format data
570 ;for the BMXNet ADO.NET data provider
571 ;
572 ;Returns a maximum of BMXCOUNT records from the
573 ;VA PATIENT file whose names begin with BMXPAT
574 ;
575 N BMXI,BMXD,BMXC,BMXNODE,BMXDOB
576 ;
577 ; BMXY is passed in by reference. Set it to
578 ;the value of the variable in which we will return our data:
579 S BMXY="^TMP(BMX,"_$J_")"
580 ;
581 ;The first subnode of the data global contains the column header information
582 ;in the form "txxxxxCOLUMN1NAME^txxxxxCOLUMN2NAME"_$C(30)
583 ;where t is the column data type:
584 ; T for text
585 ; I for integer
586 ; N for floating point number
587 ; D for date/time.
588 ;xxxxx is the length of the column in characters.
589 ;
590 S BMXI=0,BMXC=0
591 S ^ TMP(BMX,$J,BMXI)="T00030NAME^T00010SEX^D00020DOB"_$C(30)
592 ;
593 ;You MUST set an error trap:
594 S X="PDERR^BMXRPC6",@^%ZOSF("TRAP")
595 ;
596 ;Strip CR, LF, TAB from BMXCOUNT parameter
597 S BMXCOUNT=$TR(BMXCOUNT,$C(13),"")
598 S BMXCOUNT=$TR(BMXCOUNT,$C(10),"")
599 S BMXCOUNT=$TR(BMXCOUNT,$C(9),"")
600 ;
601 ;Iterate through the global and set the data nodes:
602 S:BMXPAT="" BMXPAT="A"
603 S BMXPAT=$O(^DPT("B",BMXPAT),-1)
604 S BMXD=0
605 F S BMXPAT=$O(^DPT("B",BMXPAT)) Q:BMXPAT="" S BMXD=$O(^DPT("B",BMXPAT,0)) I +BMXD S BMXC=BMXC+1 Q:(BMXCOUNT)BMXC BMXCOUNT) D
606 . Q:'$D(^DPT(BMXD,0))
607 . S BMXI=BMXI+1
608 . S BMXNODE=^DPT(BMXD,0)
609 . ;Convert the DOB from FM date to external form
610 . S Y=$P(BMXNODE,U,3)
611 . I +Y X ^DD("DD")
612 . S BMXDOB=Y
613 . ;The data node fields are in the same order as the column header, i.e. NAME^SEX^DOB
614 . ;and terminated with a $C(30)
615 . S ^ TMP(BMX,$J,BMXI)=$P(BMXNODE,U)_U_$P(BMXNODE,U,2)_U_BMXDOB_$C(30)
616 ;
617 ;After all the data nodes have been set, set the final node to $C(31) to indicate
618 ;the end of the recordset
619 S BMXI=BMXI+1
620 S ^ TMP(BMX,$J,BMXI)=$C(31)
621 Q
622 ;
623 PDERR ;Error trap for PDEMO
624 ;
625 S ^ TMP(BMX,$J,BMXI+1)=$C(31)
626 Q
627 </code>
628 Register as an RPC
629 <para>
630 NAME: BMX DEMO TAG: PDEMO
631 ROUTINE: BMXRPC6 RETURN VALUE TYPE: GLOBAL ARRAY
632 </para>
633 Call using a RemoteSession
634 <code>
635 DataTable demoTable=aRemoteSession.TableFromCommand("BMX DEMO^S^10");
636 </code>
637 </example>
638 <param name="aCommand">The name of the RPC </param>
639 <returns>The resulting DataTable</returns>
640 </member>
641 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromCommand(System.String,System.String)">
642 <summary>
643 Calling a Custom Remote Procedure call (RPC) registered in VA FileMan’s REMOTE PROCEDURE file that results in a DataTable. You must design your remote procedure’s M routine to build its result its data in the specific format described later in this document.
644 </summary>
645 <param name="aCommand">The co /// </param>
646 <remarks>
647 Normally the AppContext is set once, after logging into the BMX, with a
648 single AppContext for the current applications or specified in every RPC call.
649 </remarks>
650 <example>
651 The VEN namespace is for PCC+ and the example below would be used at the beginning
652 of a PCC+ application.
653 <code>
654 aRemoteSession.AppContext = "VEN RPC";
655 </code>
656 The M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
657 <code>
658 Figure 5 2 shows the M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
659 PDEMO(BMXY,BMXPAT,BMXCOUNT) ;EP
660 ;This simple RPC demonstrates how to format data
661 ;for the BMXNet ADO.NET data provider
662 ;
663 ;Returns a maximum of BMXCOUNT records from the
664 ;VA PATIENT file whose names begin with BMXPAT
665 ;
666 N BMXI,BMXD,BMXC,BMXNODE,BMXDOB
667 ;
668 ; BMXY is passed in by reference. Set it to
669 ;the value of the variable in which we will return our data:
670 S BMXY="^TMP(BMX,"_$J_")"
671 ;
672 ;The first subnode of the data global contains the column header information
673 ;in the form "txxxxxCOLUMN1NAME^txxxxxCOLUMN2NAME"_$C(30)
674 ;where t is the column data type:
675 ; T for text
676 ; I for integer
677 ; N for floating point number
678 ; D for date/time.
679 ;xxxxx is the length of the column in characters.
680 ;
681 S BMXI=0,BMXC=0
682 S ^ TMP(BMX,$J,BMXI)="T00030NAME^T00010SEX^D00020DOB"_$C(30)
683 ;
684 ;You MUST set an error trap:
685 S X="PDERR^BMXRPC6",@^%ZOSF("TRAP")
686 ;
687 ;Strip CR, LF, TAB from BMXCOUNT parameter
688 S BMXCOUNT=$TR(BMXCOUNT,$C(13),"")
689 S BMXCOUNT=$TR(BMXCOUNT,$C(10),"")
690 S BMXCOUNT=$TR(BMXCOUNT,$C(9),"")
691 ;
692 ;Iterate through the global and set the data nodes:
693 S:BMXPAT="" BMXPAT="A"
694 S BMXPAT=$O(^DPT("B",BMXPAT),-1)
695 S BMXD=0
696 F S BMXPAT=$O(^DPT("B",BMXPAT)) Q:BMXPAT="" S BMXD=$O(^DPT("B",BMXPAT,0)) I +BMXD S BMXC=BMXC+1 Q:(BMXCOUNT)BMXC BMXCOUNT) D
697 . Q:'$D(^DPT(BMXD,0))
698 . S BMXI=BMXI+1
699 . S BMXNODE=^DPT(BMXD,0)
700 . ;Convert the DOB from FM date to external form
701 . S Y=$P(BMXNODE,U,3)
702 . I +Y X ^DD("DD")
703 . S BMXDOB=Y
704 . ;The data node fields are in the same order as the column header, i.e. NAME^SEX^DOB
705 . ;and terminated with a $C(30)
706 . S ^ TMP(BMX,$J,BMXI)=$P(BMXNODE,U)_U_$P(BMXNODE,U,2)_U_BMXDOB_$C(30)
707 ;
708 ;After all the data nodes have been set, set the final node to $C(31) to indicate
709 ;the end of the recordset
710 S BMXI=BMXI+1
711 S ^ TMP(BMX,$J,BMXI)=$C(31)
712 Q
713 ;
714 PDERR ;Error trap for PDEMO
715 ;
716 S ^ TMP(BMX,$J,BMXI+1)=$C(31)
717 Q
718 </code>
719 Register as an RPC
720 <para>
721 NAME: BMX DEMO TAG: PDEMO
722 ROUTINE: BMXRPC6 RETURN VALUE TYPE: GLOBAL ARRAY
723 </para>
724 Call using a RemoteSession
725 <code>
726 DataTable demoTable=aRemoteSession.TableFromCommand("BMX DEMO^S^10");
727 </code>
728 </example>
729 <param name="aCommand">The name of the RPC </param>
730 <param name="aContext">The AppContext to set prior to the call</param>
731 <returns>The resulting DataTable</returns>
732 </member>
733 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromCommand(System.String,System.Data.DataSet,System.String)">
734 <summary>
735 Calling a Custom Remote Procedure call (RPC) registered in VA FileMan’s REMOTE PROCEDURE file that results in a DataTable. You must design your remote procedure’s M routine to build its result its data in the specific format described later in this document.
736 </summary>
737 <param name="aCommand">The co /// </param>
738 <remarks>
739 Normally the AppContext is set once, after logging into the BMX, with a
740 single AppContext for the current applications or specified in every RPC call.
741 </remarks>
742 <example>
743 The VEN namespace is for PCC+ and the example below would be used at the beginning
744 of a PCC+ application.
745 <code>
746 aRemoteSession.AppContext = "VEN RPC";
747 </code>
748 The M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
749 <code>
750 Figure 5 2 shows the M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
751 PDEMO(BMXY,BMXPAT,BMXCOUNT) ;EP
752 ;This simple RPC demonstrates how to format data
753 ;for the BMXNet ADO.NET data provider
754 ;
755 ;Returns a maximum of BMXCOUNT records from the
756 ;VA PATIENT file whose names begin with BMXPAT
757 ;
758 N BMXI,BMXD,BMXC,BMXNODE,BMXDOB
759 ;
760 ; BMXY is passed in by reference. Set it to
761 ;the value of the variable in which we will return our data:
762 S BMXY="^TMP(BMX,"_$J_")"
763 ;
764 ;The first subnode of the data global contains the column header information
765 ;in the form "txxxxxCOLUMN1NAME^txxxxxCOLUMN2NAME"_$C(30)
766 ;where t is the column data type:
767 ; T for text
768 ; I for integer
769 ; N for floating point number
770 ; D for date/time.
771 ;xxxxx is the length of the column in characters.
772 ;
773 S BMXI=0,BMXC=0
774 S ^ TMP(BMX,$J,BMXI)="T00030NAME^T00010SEX^D00020DOB"_$C(30)
775 ;
776 ;You MUST set an error trap:
777 S X="PDERR^BMXRPC6",@^%ZOSF("TRAP")
778 ;
779 ;Strip CR, LF, TAB from BMXCOUNT parameter
780 S BMXCOUNT=$TR(BMXCOUNT,$C(13),"")
781 S BMXCOUNT=$TR(BMXCOUNT,$C(10),"")
782 S BMXCOUNT=$TR(BMXCOUNT,$C(9),"")
783 ;
784 ;Iterate through the global and set the data nodes:
785 S:BMXPAT="" BMXPAT="A"
786 S BMXPAT=$O(^DPT("B",BMXPAT),-1)
787 S BMXD=0
788 F S BMXPAT=$O(^DPT("B",BMXPAT)) Q:BMXPAT="" S BMXD=$O(^DPT("B",BMXPAT,0)) I +BMXD S BMXC=BMXC+1 Q:(BMXCOUNT)BMXC BMXCOUNT) D
789 . Q:'$D(^DPT(BMXD,0))
790 . S BMXI=BMXI+1
791 . S BMXNODE=^DPT(BMXD,0)
792 . ;Convert the DOB from FM date to external form
793 . S Y=$P(BMXNODE,U,3)
794 . I +Y X ^DD("DD")
795 . S BMXDOB=Y
796 . ;The data node fields are in the same order as the column header, i.e. NAME^SEX^DOB
797 . ;and terminated with a $C(30)
798 . S ^ TMP(BMX,$J,BMXI)=$P(BMXNODE,U)_U_$P(BMXNODE,U,2)_U_BMXDOB_$C(30)
799 ;
800 ;After all the data nodes have been set, set the final node to $C(31) to indicate
801 ;the end of the recordset
802 S BMXI=BMXI+1
803 S ^ TMP(BMX,$J,BMXI)=$C(31)
804 Q
805 ;
806 PDERR ;Error trap for PDEMO
807 ;
808 S ^ TMP(BMX,$J,BMXI+1)=$C(31)
809 Q
810 </code>
811 Register as an RPC
812 <para>
813 NAME: BMX DEMO TAG: PDEMO
814 ROUTINE: BMXRPC6 RETURN VALUE TYPE: GLOBAL ARRAY
815 </para>
816 Call using a RemoteSession
817 <code>
818 DataTable demoTable=aRemoteSession.TableFromCommand("BMX DEMO^S^10");
819 </code>
820 </example>
821 <param name="aCommand">The name of the RPC </param>
822 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
823 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
824 <returns>The resulting DataTable</returns>
825 </member>
826 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromCommand(System.String,System.Data.DataSet,System.String,System.String)">
827 <summary>
828 Calling a Custom Remote Procedure call (RPC) registered in VA FileMan’s REMOTE PROCEDURE file that results in a DataTable. You must design your remote procedure’s M routine to build its result its data in the specific format described later in this document.
829 </summary>
830 <param name="aCommand">The co /// </param>
831 <remarks>
832 Normally the AppContext is set once, after logging into the BMX, with a
833 single AppContext for the current applications or specified in every RPC call.
834 </remarks>
835 <example>
836 The VEN namespace is for PCC+ and the example below would be used at the beginning
837 of a PCC+ application.
838 <code>
839 aRemoteSession.AppContext = "VEN RPC";
840 </code>
841 The M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
842 <code>
843 Figure 5 2 shows the M code for a simple remote procedure call (BMX PATIENT DEMO) with two parameters to return a list of patients. See the following example. Note the inclusion of an error trap in the routine; BMXNet RPC routines must contain a functional error trap.
844 PDEMO(BMXY,BMXPAT,BMXCOUNT) ;EP
845 ;This simple RPC demonstrates how to format data
846 ;for the BMXNet ADO.NET data provider
847 ;
848 ;Returns a maximum of BMXCOUNT records from the
849 ;VA PATIENT file whose names begin with BMXPAT
850 ;
851 N BMXI,BMXD,BMXC,BMXNODE,BMXDOB
852 ;
853 ; BMXY is passed in by reference. Set it to
854 ;the value of the variable in which we will return our data:
855 S BMXY="^TMP(BMX,"_$J_")"
856 ;
857 ;The first subnode of the data global contains the column header information
858 ;in the form "txxxxxCOLUMN1NAME^txxxxxCOLUMN2NAME"_$C(30)
859 ;where t is the column data type:
860 ; T for text
861 ; I for integer
862 ; N for floating point number
863 ; D for date/time.
864 ;xxxxx is the length of the column in characters.
865 ;
866 S BMXI=0,BMXC=0
867 S ^ TMP(BMX,$J,BMXI)="T00030NAME^T00010SEX^D00020DOB"_$C(30)
868 ;
869 ;You MUST set an error trap:
870 S X="PDERR^BMXRPC6",@^%ZOSF("TRAP")
871 ;
872 ;Strip CR, LF, TAB from BMXCOUNT parameter
873 S BMXCOUNT=$TR(BMXCOUNT,$C(13),"")
874 S BMXCOUNT=$TR(BMXCOUNT,$C(10),"")
875 S BMXCOUNT=$TR(BMXCOUNT,$C(9),"")
876 ;
877 ;Iterate through the global and set the data nodes:
878 S:BMXPAT="" BMXPAT="A"
879 S BMXPAT=$O(^DPT("B",BMXPAT),-1)
880 S BMXD=0
881 F S BMXPAT=$O(^DPT("B",BMXPAT)) Q:BMXPAT="" S BMXD=$O(^DPT("B",BMXPAT,0)) I +BMXD S BMXC=BMXC+1 Q:(BMXCOUNT)BMXC BMXCOUNT) D
882 . Q:'$D(^DPT(BMXD,0))
883 . S BMXI=BMXI+1
884 . S BMXNODE=^DPT(BMXD,0)
885 . ;Convert the DOB from FM date to external form
886 . S Y=$P(BMXNODE,U,3)
887 . I +Y X ^DD("DD")
888 . S BMXDOB=Y
889 . ;The data node fields are in the same order as the column header, i.e. NAME^SEX^DOB
890 . ;and terminated with a $C(30)
891 . S ^ TMP(BMX,$J,BMXI)=$P(BMXNODE,U)_U_$P(BMXNODE,U,2)_U_BMXDOB_$C(30)
892 ;
893 ;After all the data nodes have been set, set the final node to $C(31) to indicate
894 ;the end of the recordset
895 S BMXI=BMXI+1
896 S ^ TMP(BMX,$J,BMXI)=$C(31)
897 Q
898 ;
899 PDERR ;Error trap for PDEMO
900 ;
901 S ^ TMP(BMX,$J,BMXI+1)=$C(31)
902 Q
903 </code>
904 Register as an RPC
905 <para>
906 NAME: BMX DEMO TAG: PDEMO
907 ROUTINE: BMXRPC6 RETURN VALUE TYPE: GLOBAL ARRAY
908 </para>
909 Call using a RemoteSession
910 <code>
911 DataTable demoTable=aRemoteSession.TableFromCommand("BMX DEMO^S^10");
912 </code>
913 </example>
914 <param name="aCommand">The name of the RPC </param>
915 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
916 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
917 <param name="aContext">The AppContext to set prior to the call</param>
918 <returns>The resulting DataTable</returns>
919 </member>
920 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromSQL(System.String,System.Data.DataSet,System.String,System.String)">
921 <summary>
922 SELECT VA_PATIENT.NAME, VA_PATIENT.SSN, PATIENT.CURRENT_COMMUNITY FROM VA_PATIENT, PATIENT WHERE VA_PATIENT.BMXIEN =* INTERNAL[PATIENT.NAME] AND VA_PATIENT.NAME LIKE 'DEMO%' AND VA_PATIENT.AGE BETWEEN 15 AND 24 SHOWPLAN
923 </summary>
924 <param name="anSqlStatement"></param>
925 <param name="aDataSet"></param>
926 <param name="aTableName"></param>
927 <param name="aContext"></param>
928 <returns></returns>
929 </member>
930 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromRPC(System.String,System.String)">
931 <summary>
932 TabletFromRpc is a double-dispatch method that is used by some developers. Developers create an RPC
933 call the returns a properly format BMX command (custom or BMX SS ADO) that is then transmitted back to RPMS to retrieve the Data Table.
934 </summary>
935 <param name="rpcCommand">The remote procedure call name </param>
936 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
937 <returns>The resulting DataTable</returns>
938 </member>
939 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromRPC(System.String,System.String,System.String)">
940 <summary>
941 TabletFromRpc is a double-dispatch method that is used by some developers. Developers create an RPC
942 call the returns a properly format BMX command (custom or BMX SS ADO) that is then transmitted back to RPMS to retrieve the Data Table.
943 </summary>
944 <param name="rpcCommand">The remote procedure call name </param>
945 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
946 <param name="aContext">The AppContext to set prior to the call</param>
947 <returns>The resulting DataTable</returns>
948 </member>
949 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromRPC(System.String,System.String,System.Data.DataSet,System.String)">
950 <summary>
951 TabletFromRpc is a double-dispatch method that is used by some developers. Developers create an RPC
952 call the returns a properly format BMX command (custom or BMX SS ADO) that is then transmitted back to RPMS to retrieve the Data Table.
953 </summary>
954 <param name="rpcCommand">The remote procedure call name </param>
955 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
956 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
957 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
958 <returns>The resulting DataTable</returns>
959 </member>
960 <member name="M:IndianHealthService.BMXNet.RemoteSession.TableFromRPC(System.String,System.String,System.Data.DataSet,System.String,System.String)">
961 <summary>
962 TabletFromRpc is a double-dispatch method that is used by some developers. Developers create an RPC
963 call the returns a properly format BMX command (custom or BMX SS ADO) that is then transmitted back to RPMS to retrieve the Data Table.
964 </summary>
965 <param name="rpcCommand">The remote procedure call name </param>
966 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
967 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
968 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
969 <param name="aContext">The AppContext to set prior to the call</param>
970 <returns>The resulting DataTable</returns>
971 </member>
972 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromCommand(System.String)">
973 <summary>
974 Same as the corresponding TableFromCommand call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
975 </summary>
976 <param name="aCommand">The name of the RPC </param>
977 <returns>A DataTableFuture</returns>
978 </member>
979 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromCommand(System.String,System.String)">
980 <summary>
981 Same as the corresponding TableFromCommand call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
982 </summary>
983 <param name="aCommand">The name of the RPC </param>
984 <param name="aContext">The AppContext to set prior to the call</param>
985 <returns>A DataTableFuture</returns>
986 </member>
987 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromCommand(System.String,System.Data.DataSet,System.String)">
988 <summary>
989 Same as the corresponding TableFromCommand call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
990 </summary>
991 <param name="aCommand">The name of the RPC </param>
992 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
993 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
994 <returns>A DataTableFuture</returns>
995 </member>
996 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromCommand(System.String,System.Data.DataSet,System.String,System.String)">
997 <summary>
998 Same as the corresponding TableFromCommand call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
999 </summary>
1000 <param name="aCommand">The name of the RPC </param>
1001 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
1002 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
1003 <param name="aContext">The AppContext to set prior to the call</param>
1004 <returns>A DataTableFuture</returns>
1005 </member>
1006 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromRPC(System.String,System.String)">
1007 <summary>
1008 Same as the corresponding TableFromRPC call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
1009 </summary>
1010 <param name="rpcCommand">The remote procedure call name </param>
1011 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
1012 <returns>A DataTableFuture</returns>
1013 </member>
1014 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromRPC(System.String,System.String,System.String)">
1015 <summary>
1016 Same as the corresponding TableFromRPC call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
1017 </summary>
1018 <param name="rpcCommand"></param>
1019 <param name="rpcParameter"></param>
1020 <param name="aContext"></param>
1021 <returns>A DataTableFuture</returns>
1022 </member>
1023 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromRPC(System.String,System.String,System.Data.DataSet,System.String)">
1024 <summary>
1025 Same as the corresponding TableFromRPC call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
1026 </summary>
1027 <param name="rpcCommand">The remote procedure call name </param>
1028 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
1029 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
1030 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
1031 <returns>A DataTableFuture</returns>
1032 </member>
1033 <member name="M:IndianHealthService.BMXNet.RemoteSession.AsyncTableFromRPC(System.String,System.String,System.Data.DataSet,System.String,System.String)">
1034 <summary>
1035 Same as the corresponding TableFromRPC call except a DataTableFuture is returned. See <see cref="T:IndianHealthService.BMXNet.Ado.DataTableFuture"/> on how to use a 'Future
1036 </summary>
1037 <param name="rpcCommand">The remote procedure call name </param>
1038 <param name="rpcParameter">A carrot ^ delimited string of input parameters</param>
1039 <param name="aDataSet">The DataSet to be populated with a resulting DataTable named aTableNAme</param>
1040 <param name="aTableName">The name of the DataTable in the DataSet to populate or to create</param>
1041 <param name="aContext">The AppContext to set prior to the call</param>
1042 <returns>A DataTableFuture</returns>
1043 </member>
1044 <member name="M:IndianHealthService.BMXNet.RemoteSession.IsBmxAdoCommand(System.String)">
1045 <summary>
1046 Answer True if aString is a standard BMX ADO SS command that uses the BMX ADO SCHEMA files
1047 </summary>
1048 <remarks>
1049 This is mostly used by the framework but exposed for potential use.
1050 </remarks>
1051 <param name="aString">The command to be examined</param>
1052 <returns>True if it complied, otherwise false</returns>
1053 </member>
1054 <member name="M:IndianHealthService.BMXNet.RemoteSession.Lock(System.String,System.String)">
1055 <summary>
1056 Locks a Name on the Mumps Database
1057 </summary>
1058 <param name="g/lvnToLock">Global or Local Name to Lock</param>
1059 <param name="addOrSubstract">+ or - to increment or decrement the lock</param>
1060 <returns>true for success; false for failure</returns>
1061 </member>
1062 <member name="M:IndianHealthService.BMXNet.RemoteSession.Close">
1063 <summary>
1064 When done with session it should be closed. Once closed it is unusable.
1065 </summary>
1066 <remarks>Internally the session is a lightweight object and when using multiple sessions internal RPMS connections are pooled . Close sessions when finished</remarks>
1067 <remarks>Closing the primary session closes all sessions and shuts down the RPMS connection</remarks>
1068 </member>
1069 <member name="P:IndianHealthService.BMXNet.RemoteSession.HostAddress">
1070 <summary>
1071 BMX Broker's host address name or IP Address
1072 </summary>
1073 </member>
1074 <member name="P:IndianHealthService.BMXNet.RemoteSession.User">
1075 <summary>
1076 Authenticated user associated with this remote session
1077 </summary>
1078 <example>
1079 this.StatusLabel.Text="Logged in: "+ aRemoteSession.User.Name;
1080 </example>
1081 /// <remarks>
1082 If there is a remoteSession user, it will be the same as the localSession User object
1083 </remarks>
1084 </member>
1085 <member name="P:IndianHealthService.BMXNet.RemoteSession.AppContext">
1086 <summary>
1087 The active AppContext (OPTION) of this remote session.
1088 </summary>
1089 <remarks>
1090 Normally the AppContext is set once, after logging into the BMX, with a
1091 single AppContext for the current applications. The AppContext can also be set in every RPC call. If the AppContext
1092 is the same as the currently set AppContext, the AppContext will not be re-set.
1093 </remarks>
1094 <example>
1095 The VEN namespace is for PCC+ and the example below would be used at the beginning
1096 of a PCC+ application.
1097 <code>
1098 aRemoteSession.AppContext = "VEN RPC";
1099 </code>
1100 </example>
1101 </member>
1102 <member name="P:IndianHealthService.BMXNet.RemoteSession.EventServices">
1103 <summary>
1104 Access the session's RemoteEventServices service provider to configure receiving
1105 remote events and to source new events.
1106 </summary>
1107 </member>
1108 <member name="P:IndianHealthService.BMXNet.RemoteSession.Job">
1109 <summary>
1110 Job number of server-side Cache/MDB process. Very useful for debugging.
1111 </summary>
1112 </member>
1113 <member name="P:IndianHealthService.BMXNet.RemoteSession.DebugLastRpcSignature">
1114 <summary>
1115 String describing RPC call and input parameters of last non-DataTable RPC call
1116 </summary>
1117 </member>
1118 <member name="P:IndianHealthService.BMXNet.RemoteSession.RpcResult">
1119 <summary>
1120 String value of last successful non-DataTable RPC call
1121 </summary>
1122 </member>
1123 <member name="P:IndianHealthService.BMXNet.RemoteSession.DebugLastRpcResult">
1124 <summary>
1125 String value of last successful non-DataTable RPC call
1126 </summary>
1127 </member>
1128 <member name="P:IndianHealthService.BMXNet.RemoteSession.DebugLastTableResult">
1129 <summary>
1130 Last DataTable retrieved by non-async calls
1131 </summary>
1132 </member>
1133 <member name="P:IndianHealthService.BMXNet.RemoteSession.ReceiveTimeout">
1134 <summary>
1135 The networking data receive timeout (in milliseconds). This value can be changed if the developer finds it neccessary
1136 to extend the time after login.
1137 </summary>
1138 <remarks>
1139 Only applicable for the WinFramework
1140 </remarks>
1141 </member>
1142 <member name="P:IndianHealthService.BMXNet.RemoteSession.SendTimeout">
1143 <summary>
1144 The networking data send timeout (in milliseconds). This value can be changed if the developer finds it neccessary
1145 to extend the time after login but normally the send timeout should be kept short unless network conditions are poor.
1146 </summary>
1147 <remarks>
1148 Only applicable for the WinFramework
1149 </remarks>
1150 </member>
1151 <member name="P:IndianHealthService.BMXNet.RemoteSession.IsPrimary">
1152 <summary>
1153 The primary session has the unique in that it holds the authenication privileges for all sessions. If you close the primary session, then all will close.
1154 </summary>
1155 </member>
1156 <member name="T:IndianHealthService.BMXNet.Model.Division">
1157 <summary>
1158 This object represents the RPMS Division.
1159 </summary>
1160 <remarks>
1161 All BMX Broker connections must have an estalibshed Division</remarks>
1162 </member>
1163 <member name="T:IndianHealthService.BMXNet.RemoteEventService">
1164 <summary>
1165 All async communications with RPMS is performed through the RemoteEventService which
1166 is found by calling aRemoteSession.EventServices.
1167 </summary>
1168 <remarks>
1169 <list>
1170 <para>By default remote events are asynchronous and are not on the UI thread. The development
1171 must handed the events propertly and if interacting with a user interface control must use
1172 Invoke(). As a convinenence, InvokedControl can be set to any non-disposed Control and the
1173 event service is use Invoke() so that the event is triggered on the UI thread</para>
1174 <para>The Event timer, IsEventPollingEnabled and EventPollingInterval, is used by the Async RPC calls
1175 and is automattically turned on with IsEventPollingEnabled. If the developer turns on polling or
1176 changes the EventPollingInterval to be a long period, then the Async RPC calls will not respond in
1177 a timely manner if at all.
1178 </para>
1179 </list>
1180 </remarks>
1181 </member>
1182 <member name="M:IndianHealthService.BMXNet.RemoteEventService.Subscribe(System.String)">
1183 <summary>
1184 Subscribe to an event named anEventType. These events are trigger exclusivley by other BMXNet remote services and
1185 travel from client-to-server-to-client. Once subscribed, the RemoteSession will poll based on the EventPollingInterval to
1186 see if a server-side event is waiting to be triggered on the client.
1187 </summary>
1188 <param name="anEventType">The name of the event to subscribe to</param>
1189 <returns>1 if successful, otherwise it's an error. Refer to KIDS source for error codes.</returns>
1190 </member>
1191 <member name="M:IndianHealthService.BMXNet.RemoteEventService.Unsubscribe(System.String)">
1192 <summary>
1193 Unsubscribe from an event named anEventType. Once unsubscribed, published events named anEventType will no longer
1194 trigger an event for this RemoteSession.
1195 </summary>
1196 <param name="anEventType">The name of the event to unsubscribe from</param>
1197 <returns>1 if successful, otherwise it's an error. Refer to KIDS source for error codes.</returns>
1198 </member>
1199 <member name="M:IndianHealthService.BMXNet.RemoteEventService.TriggerEvent(System.String,System.String,System.Boolean)">
1200 <summary>
1201 Access to a RemoteEventService also allows you to publish your own events. Publishing is done through design and
1202 documentation to notify other developers what events you will trigger. An event is published, or triggered, by using TriggerEvent
1203 with the name of the event, an optional event specific string with data, and whether or not the publisher, if subsubscribed,
1204 wants the event published to them.
1205 </summary>
1206 <param name="anEventType">Name of the event to publish</param>
1207 <param name="aParameter">An optional string with event specific data</param>
1208 <param name="raiseBack">Set to True if the publisher of anEventType, that is also a subscriber to anEventType,
1209 also wants the event to be triggered back to them</param>
1210 <returns></returns>
1211 </member>
1212 <member name="E:IndianHealthService.BMXNet.RemoteEventService.RpmsEvent">
1213 <summary>
1214 This event is triggered when an event named anEventType is published and the
1215 receiver has a subscription. Remember that this event is not on the UI-thread unless InvokedControl is properly set.
1216 </summary>
1217 </member>
1218 <member name="E:IndianHealthService.BMXNet.RemoteEventService.TimerEvent">
1219 <summary>
1220 This event is triggered every time the event timer is triggered, based on the EventPollingInterval.
1221 Remember that this event is not on the UI-thread unless InvokedControl is properly set.
1222 </summary>
1223 <remarks>
1224 Respond quickly to this event.
1225 </remarks>
1226 </member>
1227 <member name="P:IndianHealthService.BMXNet.RemoteEventService.InvokedControl">
1228 <summary>
1229 Set InvokedControl to a form or control of your WinForm application or EHR/VueCentric component that
1230 will live the lifetime of your RemoteSession. The RemoteEventServices will Invoke() on the InvokedControl
1231 to ensure all events are triggered on the UI thread.
1232 </summary>
1233 </member>
1234 <member name="P:IndianHealthService.BMXNet.RemoteEventService.IsEventPollingEnabled">
1235 <summary>
1236 EventPolling is used for RemoteService events and Async RPC calls. IsEventPollingEnabled is used
1237 to turn polling on and off: True for on and False for off. The Async RPC framework and remote event service
1238 needs polling to be turned on.
1239 </summary>
1240 <remarks>
1241 If Async RPC's or remote events are not working debug the RemoteEventService to verify polling is enabled
1242 and configured.
1243 </remarks>
1244 <example>
1245 If using Async RPC or remote service events activate and configure the timer when your applications starts
1246 <code>
1247 ... //Poll every 10000 ms, or 10 seconds
1248 this.RemoteSession.EventServices.EventPollingInterval=10000;
1249 this.RemoteSession.EventServices.IsEventPollingEnabled=True;
1250 ...
1251 ... //Perhaps in another part of your application you have a small active Chat Window
1252 ... //Increase the frequency of polling by decreasing the EventPollingInterval to every 2 seconds
1253 this.RemoteSession.EventServices.EventPollingInterval=2000;
1254 </code>
1255 </example>
1256 </member>
1257 <member name="P:IndianHealthService.BMXNet.RemoteEventService.EventPollingInterval">
1258 <summary>
1259 The number of milliseconds (ms) to wait before polling. If a polling event is currently being processed
1260 when a second event is trigger, the second event is skipped. It's recommended to keep this interval at
1261 5000 (5 seconds) or higher.
1262 </summary>
1263 </member>
1264 <member name="T:IndianHealthService.BMXNet.RemoteSessionPool">
1265 <summary>
1266 <para>
1267 Each BMX connection to RPMS contains a single RemoteSessionPool with at least
1268 one Session, the primary session. Applications that need additional server processes
1269 beyond what can be done with async commands can used the RemoteSessionPool.
1270 </para>
1271 <para>
1272 Access to the RemoteSessionPool is accomplished by implementing the RemoteSessionPoolConsumer
1273 interface on your component/control. Secondary sessions can be opened and closed as they
1274 are needed. If the AvailableSessionCount is zero then a null RemoteSession is returned so it
1275 is recommend to first check the if a pool HasAvailableSessions before an OpenSession() request.
1276 </para>
1277 <para>
1278 RemoteSessionPool high-performance can be achieved by keeping RPMS server jobs alive even after
1279 secondary sessions are closed. The pool will maintain MaxSessions - 1 number of jobs alive on the
1280 server. If the application is finished for awhile needing IdleSessionCount idle jobs, then
1281 TerminateIdleSessions() will release those resources on the server. New jobs will then be created
1282 on demand.
1283 </para>
1284
1285 </summary>
1286 </member>
1287 <member name="M:IndianHealthService.BMXNet.RemoteSessionPool.OpenSession">
1288 <summary>
1289 Open a RemoteSession and answer it. If an idle Session exists, it will be recycled
1290 and answered. Use Close() on the RemoteSession to release this secondary RemoteSession
1291 back to the pool.
1292 </summary>
1293 <returns>A newly created or recycled RemoteSession or null if the number of RemoteSessions has reach the MaxSessions count</returns>
1294 </member>
1295 <member name="M:IndianHealthService.BMXNet.RemoteSessionPool.OpenSession(IndianHealthService.BMXNet.Log)">
1296 <summary>
1297 Open a new RemoteSession and answer it. If an idle Session exists, it will be recycled
1298 and answered. Use Close() on the RemoteSession to release this secondary RemoteSession
1299 back to the pool. An implementation of Log can be included to trace RPC execution.
1300 </summary>
1301 <remarks>
1302 Logging is not heavily used in BMXNET40
1303 </remarks>
1304 <returns>A newly created or recycled RemoteSession or null if the number of RemoteSessions has reach the MaxSessions count</returns>
1305 </member>
1306 <member name="P:IndianHealthService.BMXNet.RemoteSessionPool.HasAvailableSession">
1307 <summary>
1308 True if another secondary session can be opened.
1309 </summary>
1310 <remarks>
1311 For this version of BMX, the EHR does not support secondary RemoteSessions and this
1312 method always returns false. If possible, develop your software using the API so when
1313 secondary RemoteSessions are supported your application will work.
1314 </remarks>
1315 </member>
1316 <member name="P:IndianHealthService.BMXNet.RemoteSessionPool.AvailableSessionCount">
1317 <summary>
1318 The number of additional secondary RemoteSessions that can be opened.
1319 </summary>
1320 </member>
1321 <member name="P:IndianHealthService.BMXNet.RemoteSessionPool.MaxSessions">
1322 <summary>
1323 The maximum number of RemoteSessions than can be opened
1324 </summary>
1325 </member>
1326 <member name="T:IndianHealthService.BMXNet.Services.BMXNetRemoteSession">
1327 <summary>
1328 Extends BMX functionality for easier development and debugging.
1329 Copied from Component Framework project IndianHealthService.Xo.Framework.Rpms
1330 </summary>
1331 </member>
1332 <member name="T:IndianHealthService.BMXNet.Net.BMXNetSocketBroker">
1333 <summary>
1334 BMXNetBroker implements low-level socket connectivity to RPMS databases.
1335 The VA RPC Broker must be running on the RPMS server in order for
1336 BMXNetBroker to connect.
1337 </summary>
1338 </member>
1339 <member name="T:IndianHealthService.BMXNet.BMXNetBroker">
1340 <summary>
1341 BMXNetBroker implements low-level socket connectivity to RPMS databases.
1342 The VA RPC Broker must be running on the RPMS server in order for
1343 BMXNetBroker to connect.
1344 </summary>
1345 </member>
1346 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.PieceLength(System.String,System.String)">
1347 <summary>
1348 Corresponds to M's $L(STRING,DELIMITER)
1349 </summary>
1350 <param name="sInput"></param>
1351 <param name="sDelim"></param>
1352 <returns></returns>
1353 </member>
1354 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.Piece(System.String,System.String,System.Int32)">
1355 <summary>
1356 Corresponds to M's $$Piece function
1357 </summary>
1358 <param name="sInput"></param>
1359 <param name="sDelim"></param>
1360 <param name="nNumber"></param>
1361 <returns></returns>
1362 </member>
1363 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.ADEBLDPadString(System.String)">
1364 <summary>
1365 Given strInput = "13" builds "013" if nLength = 3. Default for nLength is 3.
1366 </summary>
1367 <param name="strInput"></param>
1368 <returns></returns>
1369 </member>
1370 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.ADEBLDPadString(System.String,System.Int32)">
1371 <summary>
1372 Given strInput = "13" builds "013" if nLength = 3 Default for nLength is 3.
1373 </summary>
1374 <param name="strInput"></param>
1375 <param name="nLength">Default = 3</param>
1376 <returns></returns>
1377 </member>
1378 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.ADEBLDB(System.String)">
1379 <summary>
1380 Concatenates zero-padded length of sInput to sInput
1381 Given "Hello" returns "004Hello"
1382 If nSize = 5, returns "00004Hello"
1383 Default for nSize is 3.
1384 </summary>
1385 <param name="sInput"></param>
1386 <returns></returns>
1387 </member>
1388 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.ADEBLDB(System.String,System.Int32)">
1389 <summary>
1390 Concatenates zero-padded length of sInput to sInput
1391 Given "Hello" returns "004Hello"
1392 If nSize = 5, returns "00004Hello"
1393 Default for nSize is 3.
1394 </summary>
1395 <param name="sInput"></param>
1396 <param name="nSize"></param>
1397 <returns></returns>
1398 </member>
1399 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.ADEBHDR(System.String,System.String,System.String,System.String)">
1400 <summary>
1401 Build protocol header
1402 </summary>
1403 <param name="sWKID"></param>
1404 <param name="sWINH"></param>
1405 <param name="sPRCH"></param>
1406 <param name="sWISH"></param>
1407 <returns></returns>
1408 </member>
1409 <member name="M:IndianHealthService.BMXNet.BMXNetBroker.FindSubString(System.String,System.String)">
1410 <summary>
1411 Returns index of first instance of sSubString in sString.
1412 If sSubString not found, returns -1.
1413 </summary>
1414 <param name="sString"></param>
1415 <param name="sSubString"></param>
1416 <returns></returns>
1417 </member>
1418 <member name="T:IndianHealthService.BMXNet.LocalSession">
1419 <summary>
1420 The LocalSession is scoped to the client, whether EHR/VueCentric or a WinForm application.
1421 User management, patient/visit context, and local events are the key services. Components/controls that are programmed
1422 against this API will work within both the EhrFramework and WinFramework environments.
1423 </summary>
1424 </member>
1425 <member name="T:IndianHealthService.BMXNet.Log">
1426 <summary>
1427 Current Logging facility for BMXNet. This facility conforms to the EHR/VueCentric
1428 method of logging. Logging is either on or off, there is no scale from Info to Fatal to
1429 turn off and on.
1430 </summary>
1431 <remarks>
1432 Logging is not heavily used in BMXNET40. In the EHR/VueCentric, the VIM.exe can be
1433 started on the command-line with the /trace option to see RPC calls.
1434 </remarks>
1435 </member>
1436 <member name="M:IndianHealthService.BMXNet.Log.Log(System.String,System.String,System.String[])">
1437 <summary>
1438 Call to send information to the log.
1439 </summary>
1440 <param name="aClass">A grouping of log entries</param>
1441 <param name="aCategory">A sub-grouping of log entries</param>
1442 <param name="lines">Lines of text to write to the log</param>
1443 </member>
1444 <member name="M:IndianHealthService.BMXNet.Log.Log(System.String,System.String,System.Exception,System.String[])">
1445 <summary>
1446 Call to send information to the log where an exception occured.
1447 </summary>
1448 <param name="aClass">A grouping of log entries</param>
1449 <param name="aCategory">A sub-grouping of log entries</param>
1450 <param name="anException">An exception to write to the log</param>
1451 <param name="lines">Lines of text to write to the log</param>
1452 </member>
1453 <member name="P:IndianHealthService.BMXNet.Log.IsLogging">
1454 <summary>
1455 True if logging is currently enabled. It's recommend to turn logging off
1456 except for diagnositics.
1457 </summary>
1458 </member>
1459 <member name="M:IndianHealthService.BMXNet.LocalSession.NewUser(System.String,System.String,IndianHealthService.BMXNet.Model.Division)">
1460 <summary>
1461 Create a new user object.
1462 </summary>
1463 <remarks>
1464 Instances of user are used by Frameworks or for configuration/comparisons.
1465 </remarks>
1466 <param name="aName">Display name of the user</param>
1467 <param name="anIen">IEN or DUZ of the User</param>
1468 <param name="aDivision">Currently set division of the user</param>
1469 <returns></returns>
1470 </member>
1471 <member name="M:IndianHealthService.BMXNet.LocalSession.Notify(System.String,System.Exception)">
1472 <summary>
1473 Simple uniform call for local notifications to the user when an exception occurs.
1474 </summary>
1475 <remarks>
1476 API is not commonly used
1477 </remarks>
1478 <param name="aTitle">Title of the dialog</param>
1479 <param name="anException">Exception to be displayed</param>
1480 </member>
1481 <member name="M:IndianHealthService.BMXNet.LocalSession.Notify(System.String,System.String)">
1482 <summary>
1483 Simple uniform call for local notifications to the user.
1484 </summary>
1485 <remarks>
1486 API is not commonly used.
1487 </remarks>
1488 <param name="aTitle">Title of the dialog</param>
1489 <param name="aMessage">Message to be displayed</param>
1490 </member>
1491 <member name="M:IndianHealthService.BMXNet.LocalSession.Close">
1492 <summary>
1493 Call to close the LocalSession which is the last action to take when
1494 shutdown down your application.
1495 </summary>
1496 <remarks>
1497 In the EHR this call does nothing because each instance of BMX EhrFramework manages
1498 a single component within the greater EHR/VueCentric framework.
1499 In a WinForm application this call shuts down the WinFramework, closes all RemoteSessions,
1500 and closes the LocalSession and disconnects from RPMS.
1501 </remarks>
1502 </member>
1503 <member name="P:IndianHealthService.BMXNet.LocalSession.Context">
1504 <summary>
1505 The current patient and visit context.
1506 </summary>
1507 <example>
1508 The context object is access exclusively through the LocalSession and LocalSession
1509 events. The context can be obtained if your control or component is a LocalSessionConsumer and if so then
1510 define the Context property as follows:
1511 <code>
1512 public Context Context
1513 {
1514 get { return this.LocalSession == null ? null : this.LocalSession.Context; }
1515 }
1516 </code>
1517 </example>
1518 </member>
1519 <member name="P:IndianHealthService.BMXNet.LocalSession.User">
1520 <summary>
1521 Authenticated user associated with LocalSession
1522 </summary>
1523 <remarks>
1524 If there are also RemoteSessions, the RemoteSessions will have the same User object
1525 </remarks>
1526 <example>
1527 <code>
1528 this.StatusLabel.Text= aLocalSession.User == null ? "No user" : aLocalSession.User.Name;
1529 </code>
1530 </example>
1531 </member>
1532 <member name="P:IndianHealthService.BMXNet.LocalSession.EventServices">
1533 <summary>
1534 Access to the LocalSessions EventServices
1535 </summary>
1536 </member>
1537 <member name="T:IndianHealthService.BMXNet.Net.EncryptionKeyProvider">
1538 <summary>
1539 A provider of the BMX Ade encryption key
1540 </summary>
1541 </member>
1542 <member name="T:IndianHealthService.BMXNet.Ado.BMXNetCommand">
1543 <summary>
1544 BMXNET implementaiton of DbCommand. This class can be used like
1545 any ADO.NET DbCommand implementation or the suggested RemoteSession API's can
1546 be used.
1547
1548 See ADO.NET documentation for details of this class.
1549 </summary>
1550 </member>
1551 <member name="T:IndianHealthService.BMXNet.Ado.BMXNetDataAdapter">
1552 <summary>
1553 BMXNET implementaiton of DbDataAdaptor. This class can be used like
1554 any ADO.NET DbDataAdaptor implementation or the suggested RemoteSession API's can
1555 be used.
1556
1557 See ADO.NET documentation for details of this class.
1558 </summary>
1559 </member>
1560 <member name="T:IndianHealthService.BMXNet.Model.Visit">
1561 <summary>
1562 The visit object is used to determine the current context of the application. The key wrinkle in the visit
1563 class relates to create a common interface for EHR/VueCentric and WinForm applications. The EHR/VueCentric supports
1564 visit stubs by default and the WinFramework does not. If the consumer of the visit object is going to use
1565 it to make changes to RPMS then the visit can not be a stub and must the visit must be created.
1566 <example>
1567 In either EHR or WinForm applications, always check for a stub before you call RPC's to update RPMS. If you
1568 do not, the visit may not have been created on RPMS and the visit id will be null.
1569 <code>
1570 if (this.Context.HasVisit)
1571 {
1572 if (this.Context.Visit.IsStub &amp;&amp; !this.Context.Visit.Create())
1573 {
1574 MessageBox.Show("Unable to establish visit.","Editing Disabled");
1575 return;
1576 }
1577
1578 //Call RPC to update RPMS with current visit ien
1579 }
1580 </code>
1581 </example>
1582 </summary>
1583 </member>
1584 <member name="M:IndianHealthService.BMXNet.Model.Visit.Create">
1585 <summary>
1586 If the receiver is a stub, then call Create() to create a visit in RPMS and
1587 then new data can be added in the context of a created visit. In the WinForm
1588 edition, this all Visits are created to the method will do nothing yet you should
1589 call it to be consistent.
1590 </summary>
1591 <returns>True if the visit has been created (always True for WinForm)</returns>
1592 </member>
1593 <member name="M:IndianHealthService.BMXNet.Model.Visit.Create(System.Boolean)">
1594 <summary>
1595 In the EHR some visits need user interaction to change from a stub to a created visit.
1596 </summary>
1597 <param name="showGuiToCreateVisit"></param>
1598 <returns></returns>
1599 </member>
1600 <member name="P:IndianHealthService.BMXNet.Model.Visit.Ien">
1601 <summary>
1602 This will be non-null if the visit has been created in RPMS, otherwise
1603 it is null and the receiver in considered a stub.
1604 </summary>
1605 </member>
1606 <member name="P:IndianHealthService.BMXNet.Model.Visit.ProviderName">
1607 <summary>
1608 Primary provider of the visit
1609 </summary>
1610 </member>
1611 <member name="P:IndianHealthService.BMXNet.Model.Visit.LocationName">
1612 <summary>
1613 Hospital Location of the visit
1614 </summary>
1615 </member>
1616 <member name="P:IndianHealthService.BMXNet.Model.Visit.DateTime">
1617 <summary>
1618 Official timetamp of the visit
1619 </summary>
1620 </member>
1621 <member name="P:IndianHealthService.BMXNet.Model.Visit.IsStub">
1622 <summary>
1623 If a visit is transient in the client memory space, it is a stub.
1624 In the EHR visits are often created as stubs (Create New is not checked)
1625 Once data is entered, the visit is created.
1626 The WinForm only supports full created visits therefore IsStub is always false
1627 </summary>
1628 </member>
1629 <member name="P:IndianHealthService.BMXNet.Model.Visit.IsFutureAppointment">
1630 <summary>
1631 Answer true if a future appointment.
1632 </summary>
1633 </member>
1634 <member name="P:IndianHealthService.BMXNet.Model.Visit.IsLocked">
1635 <summary>
1636 If a visit can not be added to if it is locked. In the WinForm edition, all
1637 visits answered by BMX FIND VISIT are considered unlocked.
1638 </summary>
1639 </member>
1640 <member name="T:IndianHealthService.BMXNet.RemoteEventArgs">
1641 <summary>
1642 The event args used by the RemoteEventService
1643 </summary>
1644 </member>
1645 <member name="P:IndianHealthService.BMXNet.RemoteEventArgs.EventType">
1646 <summary>
1647 This string corresponds to well-known/shared EventTypes used to identify
1648 different events published and subscribed between BMX implementations using RemoteSessions.
1649 </summary>
1650 </member>
1651 <member name="P:IndianHealthService.BMXNet.RemoteEventArgs.Details">
1652 <summary>
1653 This is an optional peice of data with some event-specific details.
1654 </summary>
1655 </member>
1656 <member name="T:IndianHealthService.BMXNet.Ado.BMXNetTransaction">
1657 <summary>
1658 BMXNET implementaiton of IDbTransaction. This class can be used like
1659 any ADO.NET IDbTransaction implementation or the suggested RemoteSession API's can
1660 be used.
1661
1662 See ADO.NET documentation for details of this class.
1663 </summary>
1664 </member>
1665 <member name="M:IndianHealthService.BMXNet.Services.BMXRemoteSessionPool.TerminateIdleSessions">
1666 <summary>
1667 Note: idle session connections are really being terminated. We
1668 do not re-use BMXNetRemoteSession objects that wrap the session connection
1669 </summary>
1670 </member>
1671 <member name="T:IndianHealthService.BMXNet.Model.Patient">
1672 <summary>
1673 The Patient object is a read-only object used for patient context.
1674 </summary>
1675 </member>
1676 <member name="P:IndianHealthService.BMXNet.Model.Patient.Ien">
1677 <summary>
1678 The RPMS intenal entry number for the patient
1679 </summary>
1680 </member>
1681 <member name="P:IndianHealthService.BMXNet.Model.Patient.HealthRecordNumber">
1682 <summary>
1683 The RPMS HRN or chart number
1684 </summary>
1685 </member>
1686 <member name="P:IndianHealthService.BMXNet.Model.Patient.PatientName">
1687 <summary>
1688 The default displayable version of the patient's name
1689 </summary>
1690 </member>
1691 <member name="P:IndianHealthService.BMXNet.Model.Patient.AdmitDate">
1692 <summary>
1693 The current admission date of the user. This is a nullable bool for the cases that
1694 the patient is not currently admitted.
1695 </summary>
1696 </member>
1697 <member name="P:IndianHealthService.BMXNet.Model.Patient.Age">
1698 <summary>
1699 The current age of the patient.
1700 </summary>
1701 </member>
1702 <member name="P:IndianHealthService.BMXNet.Model.Patient.Dob">
1703 <summary>
1704 If knownn, the DOB of the patient
1705 </summary>
1706 </member>
1707 <member name="P:IndianHealthService.BMXNet.Model.Patient.PrimaryProvider">
1708 <summary>
1709 The displayable name (external value) of the patient's primary provider.
1710 </summary>
1711 </member>
1712 <member name="P:IndianHealthService.BMXNet.Model.Patient.Sex">
1713 <summary>
1714 The sex of the patient
1715 </summary>
1716 </member>
1717 <member name="P:IndianHealthService.BMXNet.Model.Patient.Ssn">
1718 <summary>
1719 The patient's SSN or an abbrievation of the SSN
1720 </summary>
1721 </member>
1722 <member name="T:IndianHealthService.BMXNet.BMXNetException">
1723 <summary>
1724 This simple exception wrapper is used for Exceptions thrown by umknown sources and
1725 by the BMX library. Check the InnerException for details.
1726 </summary>
1727 </member>
1728 <member name="T:IndianHealthService.BMXNet.Ado.BMXNetConnection">
1729 <summary>
1730 BMXNET implementaiton of DbConnection. This class can be used like
1731 any ADO.NET DbConnection implementation or the suggested RemoteSession API's can
1732 be used.
1733
1734 See ADO.NET documentation for details of this class.
1735 </summary>
1736 </member>
1737 <member name="T:IndianHealthService.BMXNet.Model.User">
1738 <summary>
1739 The user that established the connection to BMX either through the WinFramework dialogs or access/verify codes, or
1740 a user established through attach tho the EHR/VueCentric with the EhrFramework.
1741 <para>The user breaks down into who is it and what can they do with some identify and security key checing.</para>
1742 </summary>
1743 </member>
1744 <member name="M:IndianHealthService.BMXNet.Model.User.HasSecurityKey(System.String)">
1745 <summary>
1746 Check aKey against the active RPMS keys for the user. If the user has the PROGMODE key this
1747 method will always return true.
1748 </summary>
1749 <param name="aKey">The key name that is compared against the keys on the server</param>
1750 <returns>Return true if the user has the key</returns>
1751 </member>
1752 <member name="M:IndianHealthService.BMXNet.Model.User.RequestKeys">
1753 <summary>
1754 Fetch from RPMS the user's current keys. The user's
1755 division must be set before calling this metohd.
1756 </summary>
1757 <returns></returns>
1758 </member>
1759 <member name="M:IndianHealthService.BMXNet.Model.User.HasSecurityKeys(System.String[])">
1760 <summary>
1761 Return a list of keys that the user does NOT have. If the user has all of
1762 the keys then an empty list is returned
1763 </summary>
1764 <example>
1765 List&lt;String&gt; missingKeys=aUser.HasSecurityKeys(new string[] { "Key1","Key2" });
1766 if (missingKeys.Count==0) {
1767 //Take a secured path
1768 } else {
1769 MessageBox.Show(missingKeys);
1770 }
1771 </example>
1772 <remarks>
1773 The HasSecurityKeys appraoch does not give those with PROGMODE a free-pass since it compares
1774 the actual keys. HasSecurityKeys uses RequestKeys
1775 </remarks>
1776 <param name="keys">a list of keys to compare against the user's keys</param>
1777 <returns>A list of keys the user does not have, empty of the user has them all</returns>
1778 </member>
1779 <member name="P:IndianHealthService.BMXNet.Model.User.Duz">
1780 <summary>
1781 The DUZ aka IEN of the NEW Person File of this user
1782 </summary>
1783 </member>
1784 <member name="P:IndianHealthService.BMXNet.Model.User.Name">
1785 <summary>
1786 A displayable name of the user
1787 </summary>
1788 </member>
1789 <member name="P:IndianHealthService.BMXNet.Model.User.Division">
1790 <summary>
1791 The division that this user to currently operating within
1792 </summary>
1793 </member>
1794 <member name="T:IndianHealthService.BMXNet.RemoteSessionConsumer">
1795 <summary>
1796 This interface is used on an UserControl-based components that are designed to work both inside
1797 the EHR and inside a WinForm application. The "Consumer" interfaces basically tell Frameworks
1798 that "Consumer" implementating objects need an specific service.
1799 </summary>
1800 <remarks>
1801 If your component doesn't implement RemoteConsumer you can still user your component. Implementing
1802 RemoteConsumer is very common and is essential for communicating with the RPMS server.
1803 </remarks>
1804 </member>
1805 <member name="P:IndianHealthService.BMXNet.RemoteSessionConsumer.RemoteSession">
1806 <summary>
1807 This property will be set with the primary RemoteSession that the interface implementer can use for communicating
1808 with the RPMS server.
1809 </summary>
1810 <remarks>
1811 If also using a RemoteSessionPool, it's important to realize the if the primary RemoteSession that is set through
1812 this interface is closed then every session in the RemoteSessionPool is also clsoed as well as the broker connection
1813 to RPMS.
1814 </remarks>
1815 </member>
1816 <member name="T:IndianHealthService.BMXNet.Model.Context">
1817 <summary>
1818 Context interface provides the current status and related events of the
1819 patient/visit context within an application, or the EHR.
1820 </summary>
1821 <remarks>
1822 Application developers use the WinFramework and ChangableContext to modify the context. Within
1823 the EHR/VueCentric framework, the Context interface is a basic wrapper of some of the EHR facilties.
1824 </remarks>
1825 </member>
1826 <member name="E:IndianHealthService.BMXNet.Model.Context.Changed">
1827 <summary>
1828 The most important aspect of the Context interface is the Changed event that allows
1829 the receiver of the event know when the user is changing patient and visit. Applications
1830 need to change the data displayed to represent the currnet Patient and optional visit. The
1831 Changed event occurs after there is confirmation that the change has not been vetoed or the
1832 veto has been overridden. See Changing event.
1833 </summary>
1834 <example>
1835 Users of the Context object should hook the event ASAP. The
1836 <code>
1837 public void Startup()
1838 {
1839 if (this.Context != null)
1840 {
1841 this.Context.Changed += new EventHandler&lt;ContextChangedArgs&gt;(Context_Changed);
1842 }
1843 </code>
1844 The context can be obtained if your control or component is a LocalSessionConsumer and if so then
1845 define the Context property as follows:
1846 <code>
1847 public Context Context
1848 {
1849 get { return this.LocalSession == null ? null : this.LocalSession.Context; }
1850 }
1851 </code>
1852 </example>
1853 </member>
1854 <member name="E:IndianHealthService.BMXNet.Model.Context.Changing">
1855 <summary>
1856 When the current patient or visit is being changed by the user, every subscriber to the
1857 Changing method has the option to "Veto" the event by Cancelling it:
1858 <code>
1859 public void Startup()
1860 {
1861 if (this.Context != null)
1862 {
1863 this.Context.Changed += new EventHandler&lt;ContextChangedArgs&gt;(Context_Changed);
1864 this.Context.Changing += new EventHandler&lt;ContextChangedArgs&gt;(Context_Changing);
1865 }
1866
1867 void Context_Changing(object sender, ContextChangingArgs e)
1868 {
1869 e.Cancel = needToFinishSomethingElseBeforeChangingContext;
1870 }
1871 </code>
1872 However, a Veto is like a U.S. presential Veto and that it can be overridden. The WinFramework
1873 or EHR can override any Veto so all components (even if they veto changes) must be prepared to
1874 have the context changed at anytime.
1875 </summary>
1876 </member>
1877 <member name="P:IndianHealthService.BMXNet.Model.Context.Patient">
1878 <summary>
1879 The currently selected patient, or null. The value of the current patient is also in <seealso cref="T:IndianHealthService.BMXNet.Model.ContextChangedArgs"/>.
1880 The concept is that the context is set by external forces, ususally the user. Therefore there is no
1881 way to set the patient here.
1882 </summary>
1883 <remarks>
1884 Remember to refresh your user interface based on the new selection to the information your application displays
1885 or edits is that same as the current context.
1886 </remarks>
1887 </member>
1888 <member name="P:IndianHealthService.BMXNet.Model.Context.Visit">
1889 <summary>
1890 The currently selected visit, or null. The value of the current visit is also in ContextChangedArgs.
1891 The concept is that the context is set by external forces, ususally the user. Therefore there is no
1892 way to set the visit here.
1893 </summary>
1894 <remarks>
1895 In the EHR, a visit stub can be created. A visit stub does not create a visit in RPMS until some data
1896 is entered. IsVisit will return true for a visit stub but is it your responbilty to use HasUnlockedVisit or IsStub
1897 on the Visit to make sure you have a visit to edit with.
1898 Remember to refresh your user interface based on the new selection to the information your application displays
1899 or edits is that same as the current context.
1900 </remarks>
1901 </member>
1902 <member name="P:IndianHealthService.BMXNet.Model.Context.HasPatient">
1903 <summary>
1904 Answer true/false if there is a patient currently selected. This is a convenience method.
1905 </summary>
1906 </member>
1907 <member name="P:IndianHealthService.BMXNet.Model.Context.HasVisit">
1908 <summary>
1909 Answer true/false if there is a patient currently selected. This is a convenience method.
1910 </summary>
1911 </member>
1912 <member name="P:IndianHealthService.BMXNet.Model.Context.HasUnlockedVisit">
1913 <summary>
1914 Answer true if there is a visit and if it is unlocked. The EHR/VueCentric has a notion of the
1915 locked visit, a visit that can no longer be visited. The EHR/VueCetnric has has a visit stub, a visit that
1916 has been create on the desktop but not in RPMS. If a visit is a visit stub, it is not considered unlocked.
1917 </summary>
1918 </member>
1919 <member name="P:IndianHealthService.BMXNet.Model.Context.User">
1920 <summary>
1921 The user that established the connection to BMX either through the WinFramework dialogs or access/verify codes, or
1922 a user established through attach tho the EHR/VueCentric with the EhrFramework.
1923 </summary>
1924 </member>
1925 <member name="P:IndianHealthService.BMXNet.Ado.RPMSDb.ResultSets">
1926 <summary>
1927 Returns the array of RMPSResultSets retrieved from RPMS
1928 </summary>
1929 </member>
1930 <member name="P:IndianHealthService.BMXNet.Ado.RPMSDb.CurrentRecordSet">
1931 <summary>
1932 Sets and Returns the current recordset
1933 </summary>
1934 </member>
1935 <member name="T:IndianHealthService.BMXNet.Ado.DataTableFutureEventArgs">
1936 <summary>
1937 The event args for all DataTableFuture events.
1938 </summary>
1939 <remarks>
1940 The DataTableFuture events are trigger in the non-UI thread and will break any application that is not managing it's
1941 UI calls properly. If implementing a basic GUI-based application, it's recommended to set the InvokedControl on
1942 every DataTableFuture you created.
1943 This EventArgs provides the future, which is the same instance created when the Async call was made.
1944 </remarks>
1945 </member>
1946 <member name="P:IndianHealthService.BMXNet.Ado.DataTableFutureEventArgs.Future">
1947 <summary>
1948 The future object that can be used to determine the state of the future, cancel the future, and perform
1949 some post future processing.
1950 </summary>
1951 </member>
1952 <member name="T:IndianHealthService.BMXNet.RemoteSessionPoolConsumer">
1953 <summary>
1954 This interface is used on an UserControl-based components that are designed to work both inside
1955 the EHR and inside a WinForm application. The "Consumer" interfaces basically tell Frameworks
1956 that "Consumer" implementating objects need an specific service.
1957 </summary>
1958 <remarks>
1959 This interface is rarely used but is essential for application needing multiple server-side
1960 jobs.
1961 </remarks>
1962 </member>
1963 <member name="P:IndianHealthService.BMXNet.RemoteSessionPoolConsumer.RemoteSessionPool">
1964 <summary>
1965 This property will be set with the RemoteSessionPool that is used by the Framework.
1966 </summary>
1967 <remarks>
1968 If you only need one RemoteSession, the most common usage pattern, you do not need the RemoteSessionPoolConsumer
1969 and should use <see cref="T:IndianHealthService.BMXNet.RemoteSessionConsumer"/>.
1970 </remarks>
1971 </member>
1972 <member name="T:IndianHealthService.BMXNet.LocalEventArgs">
1973 <summary>
1974 The event args used by the LocalEventService.
1975 </summary>
1976 </member>
1977 <member name="P:IndianHealthService.BMXNet.LocalEventArgs.EventType">
1978 <summary>
1979 This string corresponds to well-known/shared EventTypes used to identify
1980 different events published and subscribed within a local desktop application (WinFramework)
1981 or in the EHR.
1982 </summary>
1983 <example>
1984 The framewrk implements LocalSession.EventServices.RefreshRequested by sending or receiving
1985 the LocalEvent with the EventType=="REFRESH".
1986 </example>
1987 <example>
1988 The Well Child Module growth chart displays Height and Weight. When the EHR vitals component adds
1989 new Heights and Weights it publishes a LocalEvent with an EventType PCC*MSR. If the growth chart detects
1990 the Vitals update event it then refreshes the growth chart:
1991 <code>
1992 void Session_ApplicationEvent(object sender, LocalEventArgs e)
1993 {
1994 if (this.IsVitalsUpdatedEvent(e))
1995 {
1996 this.RefreshAll();
1997 }
1998 }
1999
2000 protected bool IsVitalsUpdatedEvent(LocalEventArgs anEvent)
2001 {
2002 return anEvent.EventType.StartsWith("PCC") &amp;&amp; anEvent.EventType.EndsWith("MSR");
2003 }
2004 </code>
2005 </example>
2006 </member>
2007 <member name="P:IndianHealthService.BMXNet.LocalEventArgs.Details">
2008 <summary>
2009 This is an optional peice of data with some event-specific details.
2010 </summary>
2011 </member>
2012 <member name="T:IndianHealthService.BMXNet.LocalConsumer">
2013 <summary>
2014 This interface is used on UserControl-based components which are designed to work both inside
2015 the EHR and inside a WinForm application. "Consumer" interfaces basically tell Frameworks
2016 that a "Consumer"-implementating object need a specific service, versus the service being queried.
2017 </summary>
2018 <remarks>
2019 If your component doesn't implement LocalConsumer you can still have a user-control. However, implementing
2020 LocalConsumer is very common because of exclusive access to the patient/visit Context.
2021 </remarks>
2022 </member>
2023 <member name="P:IndianHealthService.BMXNet.LocalConsumer.LocalSession">
2024 <summary>
2025 This property is set with a LocalSession by the framework. The receiver uses it for Context,
2026 local Events, and other services.
2027 </summary>
2028 </member>
2029 <member name="T:IndianHealthService.BMXNet.LocalEventService">
2030 <summary>
2031 Access to local services are access through this interface.
2032 </summary>
2033 </member>
2034 <member name="M:IndianHealthService.BMXNet.LocalEventService.Subscribe(System.String)">
2035 <summary>
2036 Subscribe to the local event named anEventName.
2037 </summary>
2038 <remarks>
2039 To receive published events, handle the ApplicationEvent. If you explicity subscript
2040 to the "REFRESH" event then both RefreshRequested and ApplicationEvent will be triggers.
2041 </remarks>
2042 <param name="anEventName">The name of the event. This name should be shared and wellknown between many components.</param>
2043 </member>
2044 <member name="M:IndianHealthService.BMXNet.LocalEventService.HasSubscribers(System.String)">
2045 <summary>
2046 Checks to see there are any subscriptions for this event.
2047 </summary>
2048 <remarks>
2049 If publishing an event, there is no need to first check if there are subscribers unless there is a
2050 performance hit for the application to Trigger the event.
2051 </remarks>
2052 <param name="anEventName">The name of the event checking to see if it's been subscribed already.</param>
2053 <returns></returns>
2054 </member>
2055 <member name="M:IndianHealthService.BMXNet.LocalEventService.Unsubscribe(System.String)">
2056 <summary>
2057 Unscribe scribes from the event. It is not mandatory to unsubscribe from this event at the end of
2058 your object's lifecycle but you should either subsubscribe or remote the event handler.
2059 </summary>
2060 <param name="anEventName">The name of the event unsubscribing from.</param>
2061 <returns></returns>
2062 </member>
2063 <member name="M:IndianHealthService.BMXNet.LocalEventService.TriggerEvent(System.String,System.String)">
2064 <summary>
2065 To publish an event call TriggerEvent with the event name and optional details. There is no
2066 restriction on what local events that can be triggered. A "REFRESH" event can be broadcast as
2067 well as any other application specific or well-known loal event.
2068 </summary>
2069 <param name="anEventName">The event name. This is normally a well-known event that multiple components used for event-driven communications.</param>
2070 <param name="someDetails">An arbitrary string containing event specific data</param>
2071 </member>
2072 <member name="E:IndianHealthService.BMXNet.LocalEventService.RefreshRequested">
2073 <summary>
2074 This commonly broadcasted event is request to refresh content.
2075 </summary>
2076 <remarks>
2077 In the EHR, this is equivalent to the "REFRESH" event. The WinFramework also uses "REFRESH" as the
2078 event name for triggering a refresh request.
2079 </remarks>
2080 <example>
2081 The following code from Well Child Module's Growth Chart shows registering for the Refresh event
2082 at startup:
2083 <code>
2084 public void Startup()
2085 {
2086 this.LocalSession.EventServices.RefreshRequested += new EventHandler(Session_RefreshRequested);
2087 }
2088
2089 void Session_RefreshRequested(object sender, EventArgs e)
2090 {
2091 this.RefreshAll();
2092 }
2093 </code>
2094
2095 </example>
2096 </member>
2097 <member name="E:IndianHealthService.BMXNet.LocalEventService.ApplicationEvent">
2098 <summary>
2099 Local event subscribers will have this event triggered.
2100 </summary>
2101 <remarks>
2102 The "REFRESH" event is filtered out and is triggered using the RefreshRequested event
2103 </remarks>
2104 <example>
2105 The Well Child Module growth chart displays Height and Weight. When the EHR vitals component adds
2106 new Heights and Weights it publishes a LocalEvent with an EventType PCC*MSR. If the growth chart detects
2107 the Vitals update event it then refreshes the growth chart:
2108 <code>
2109 public void Startup()
2110 {
2111 this.LocalSession.EventServices.ApplicationEvent+= new EventHandler&lt;LocalEventArgs&gt;(Session_ApplicationEvent);
2112 }
2113
2114
2115 void Session_ApplicationEvent(object sender, LocalEventArgs e)
2116 {
2117 if (this.IsVitalsUpdatedEvent(e))
2118 {
2119 this.RefreshAll();
2120 }
2121 }
2122
2123 protected bool IsVitalsUpdatedEvent(LocalEventArgs anEvent)
2124 {
2125 return anEvent.EventType.StartsWith("PCC") &amp;&amp; anEvent.EventType.EndsWith("MSR");
2126 }
2127 </code>
2128 </example>
2129 </member>
2130 <member name="T:IndianHealthService.BMXNet.Net.BMXNetSessionSocketConnection">
2131 <summary>
2132 BMXNetBroker implements low-level socket connectivity to RPMS databases.
2133 The VA RPC Broker must be running on the RPMS server in order for
2134 BMXNetBroker to connect.
2135 </summary>
2136 </member>
2137 <member name="M:IndianHealthService.BMXNet.Net.BMXNetSessionSocketConnection.OpenConnectionCommon">
2138 <summary>
2139 Returns index of first instance of sSubString in sString.
2140 If sSubString not found, returns -1.
2141 </summary>
2142 <returns></returns>
2143 </member>
2144 <member name="M:IndianHealthService.BMXNet.Net.BMXNetSessionSocketConnection.ImHereServer">
2145 <summary>
2146 Ping the server, will reset read-timeout
2147 </summary>
2148 <returns>Answer the #milliseconds to run or -1 if theres an issue</returns>
2149 </member>
2150 <member name="P:IndianHealthService.BMXNet.Net.BMXNetSessionSocketConnection.ReceiveTimeout">
2151 <summary>
2152 Set and retrieve the timeout, in milliseconds, to receive a response from the RPMS server.
2153 If the retrieve time exceeds the timeout, an exception will be thrown and the connection will be closed.
2154 The default is 30 seconds.
2155 </summary>
2156 </member>
2157 <member name="T:IndianHealthService.BMXNet.Ado.BMXNetDataReader">
2158 <summary>
2159 BMXNET implementaiton of IDataReader. This class can be used like
2160 any ADO.NET IDataReader implementation or the suggested RemoteSession API's can
2161 be used.
2162
2163 See ADO.NET documentation for details of this class.
2164 </summary>
2165 </member>
2166 </members>
2167</doc>
Note: See TracBrowser for help on using the repository browser.