jBASE INTERNATIONAL [email protected] jBASE jRCS.
-
Upload
chasity-skeete -
Category
Documents
-
view
275 -
download
5
Transcript of jBASE INTERNATIONAL [email protected] jBASE jRCS.
![Page 2: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/2.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
What is jRCS?
Lightweight remote connector for jBASEProvides access to jBC-like functionality from GUI and web applicationsAdaptable to multiple platforms
![Page 3: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/3.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Similar Products
PickODBC for Raining Data D3UniObjects for IBM’s U2 suite
![Page 4: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/4.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Why jRCS?
Increased demand for GUI and web-based multi-tier applicationsImproved end user experienceAbility to retain most of the legacy jBC code baseSmooth transition to the world of Windows and other graphical environments
![Page 5: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/5.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jRCS Features
Small and fast remote connectorLeverages established technologies
TCP/IP XML
Easy portabilityOpen protocol
![Page 6: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/6.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jRCS Architecture
jRCS Client Library
GUI/Web Client Program
UserUser
jRCS Server
jBASE Runtime
jBC Program/Subroutine
Netw
ork
TCP/IP + XML
![Page 7: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/7.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jRCS Capabilities
Connection establishment and terminationUser authentication via underlying OSjBC environment setupCalling jBC programs and subroutines
![Page 8: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/8.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jRCS Capabilities (Cont’d)
Performing jQL-like conversionsOpening, reading and writing jBASE filesFull locking supportCreating select lists from files
![Page 9: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/9.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jRCS Capabilities (Cont’d)
Selecting records using jQLSelecting jBASE indexesManaging common variable blocksFast client-side dynamic array support (jBASE-supplied client libraries only)
![Page 10: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/10.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Supported Server Platforms
Windows 2000, XP and Server 200332-bit AIX (64-bit server also available)RedHat Enterprise Linux
![Page 11: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/11.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Available Client Libraries
C/C++ client (low-level integration)ActiveX client for VB 6.0 (Windows only)Microsoft .NET client (Windows only)
Framework 1.1 and 2.0 supported
Java client for JDK 1.4.2 and newerMicrosoft .NET Compact Framework client
![Page 13: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/13.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jRCS Authentication
Underlying OS user names and passwords are used for authenticationPermissions are set up based on user credentials supplied at logonUser is placed in his/her home directory
![Page 14: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/14.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Environment Setup
Environment is set up based on user’s jRCS resource file
On Unix: $HOME/.jrcsrcOn Windows: %HOME%\jrcsrc.cmd
All jBC environment variables can be set
![Page 15: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/15.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jrcsrc.cmd on Windows
Follows the cmd.exe syntax for environment variablesPercent sign substitutions can be usedPrograms may not be executedExample:Set JBCOBJECTLIST = %HOME%\lib
Set JEDIFILEPATH = %HOME%
![Page 16: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/16.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
.jrcsrc on Unix
Follows the syntax of the Bourne shell (sh)Dollar sign substitutions may be usedProgram execution and backquote substitution is not permittedExample:JBCOBJECTLIST = $HOME/lib
export JBCOBJECTLIST
JEDIFILEPATH = $HOME
export JEDIFILEPATH
![Page 18: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/18.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Typical jRCS Session
Establish a connection and authenticateRun business logic
Call a subroutineExecute a programOpen and read or write a fileGenerate a select list
Terminate the connection
![Page 19: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/19.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Connection Establishment
Create a JConnection objectCall the Open method and pass the user name, password and host nameExample:Dim _conn As New JConnection
_conn.Open(“localhost”, JConnection.JRCS_PORT, “test”, “test”, “”)
![Page 20: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/20.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
File Management
Use OpenFile method in JConnection to create a JFile objectRead and write records using JFile methodsExample:Dim _file As JFile = _conn.OpenFile(“CUSTOMER”)
Dim _record As JDynArray = _file.Read(“12345”, False, False)
_record.Replace(“New Customer Name”, 1)
_file.Write(“12345”, _record, False)
![Page 21: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/21.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Dynamic Arrays
Create a JDynArray objectUse its methods to extract, replace and insert data, locate fields, count attributesExample:Dim _array As New JDynArray
_array.Insert(“Field 1”, 1)
_array.Replace(“New Field 1”, 1)
Debug.WriteLine(_array.Extract(1))
Debug.WriteLine(“Number of attributes: “ & _array.DCount(_array.AM))
![Page 22: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/22.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Select List Manipulation
Use Select or SSelect in a JFile object to create a JSelectListUse Execute method of JConnection to return a JSelectListUse For Each … Next or ReadNext method to iterate through the listExample:
Dim _file As JFile = _conn.OpenFile(“CUSTOMER”)
Dim _list As JSelectList = _file.SSelect
For Each _key As String In _list
Debug.WriteLine(_key)
Next
![Page 23: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/23.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Calling Subroutines
Use Call method in JConnection to call a subroutineParameters are passed as an array of strings or JDynArray objectsExample:Dim _parameter As New JDynArray(“This will be passed and returned”)
Dim _parms() As JDynArray = New JDynArray() { _parameter }
_conn.Call(“MY_SUBROUTINE”, _parms)
Debug.WriteLine(“Returned value: “ & _parms(0))
![Page 24: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/24.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Executing Programs
Use Execute or ExecuteAndStore method in JConnectionExecuteAndStore allows captured output to be read block-by-blockSelect lists may be passed and returnedExample:Dim _execResults As JExecuteResults = _
_conn.Execute(“LIST CUSTOMER”, _JExecFlags.EXEC_GET_CAPTURE, Nothing)
Debug.WriteLine(“Captured text: “ & _execResults.CaptureString)
![Page 25: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/25.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
Error Handling
Objects of class JException are thrown backUse the Message property of JException to get the error messageExample:Try
Dim _record As JDynArray = _file.Read(“12345”, _
False, False)
Catch _exception As JException
Debug.WriteLine(“Error: “ & _exception.Message)
End Try
![Page 26: jBASE INTERNATIONAL SALES@jBASE.COM jBASE jRCS.](https://reader035.fdocuments.us/reader035/viewer/2022081716/5518d2cf550346a61f8b5db0/html5/thumbnails/26.jpg)
WWW.jBASE.COM jBASE INTERNATIONAL [email protected]
jBASE and the jBASE logo are registered trademarks of T-jBASE SA, a company of the TEMENOS Group, copyright © 2009 T-jBASE SA.