What's New - August 2015


August 31, 2015

Build Update 19C.03.00 For C10 Posted

We've just posted and install tested Build 19C.03.00 for C10.

This is an incremental update on the 3rd quarter build 19C.

New template: RunCHTSnapEdit

Code Changes:
• Major (on-going) work with the HNDJSON class (HNDJSON.INC/.CLW)
• Major (on-going) work with the HNDSOCKET class (HNDSOCKET.INC/.CLW)
• Significant changes to HNDSMTP class to accommodate SV changes to CLARUNEXT.DLL
• Significant changes to Batch Bot app HNDMAILSMTP.APP to accommodate a --FROM parameter as well as HTML-style mail with the --FILE parameter (mail body file is HTML).
• Significant changes to HNDCHATSVR.APP (chat server) and HNDCHATCLNT.APP (chat client)

Workshop Wednesdays Are Back From Summer Break

Now that September is nearly here and most people's summer holidays are winding down, we're bringing back Workshop Wednesdays.

During the month of September Gus will have a co-host for the 5 Wednesays in September. Many thanks to Paul Epner, for volunteering to co-host the workshops with me.

This Wednesday, September 2nd, 2015 the workshop will be on the topic of mail by CHT batch-bot, specifically HNDMAILSMTP.EXE. The workshop will start at 11:00 AM sharp. A link to the workshop will be posted on the CHT developer forum. You only need to click that link in order to tune in and audit the workshop.

We're going to try and keep these things to 1 hour (11AM to Noon EDT). That should be enough to give you a taste for what this specific SMTP email batch bot can do and how to use it in the context of Snap-In templates and HNDSNAPCALL class.

Paul has volunteered his time for 5 workshops in September.

We're still looking for volunteers to take on the co-hosting chair in October, November and December. Hoping to mix up the hosting duties a little bit, so if you're interested in taking on co-hosting duties for 4 Wednesdays in a row for any of those months, drop Gus an email at gcreces@cwhandy.com.

Your job as co-host is primarily to have enough interesting questions about Clarion 10 and CHT to provide for an hour of attention-getting discussion.

See you Wednesday at 11:AM EDT, Sept 2nd, 2015.


Gus Creces
The Clarion Handy Tools Page
August 31, 2015

August 16, 2015

Build Update 19C.02.00 For C10 Posted

SV SMTP Email/SMS Messages DLL Change

On Friday, August 14th, 2015, Soft Velocity Released a new C10 (C10.0.0.11897) which had one change in it that affects CHT at the email SMTP and SMS messages level. SV changed the SMTP email/SMS messages .DLL called CLARUNEXT.DLL, by adding a parameter to the email and SMS functions in that DLL.

Since we just recently adopted use of this DLL for SMTP email and SMS messaging, this new C10 change will consequently affect your CHT SMS and CHT SMTP Email capability with C10.0.0.11897.

There's nothing wrong with this change, it provides for the capability to optionally disable email certificate checking for SSL mail. It works OK, but it caused a requirement for a prototypte change in our interface layer to the 2 DLL functions which we are using in that SV DLL.

If you have already downloaded and installed C10.0.0.11897, please make a point of downloading this CHT update (19C.02.00) as soon as possible. If you remain on any earlier C10 then please hold off with this update until you move to C10.0.9.11897.

In fact, this need to update your CHT version or not, only really applies, if you're using SV or CHT versions of SMTP email or SV or CHT versions of SMS Messaging. All other SV changes in this recent C10 update, while they may be useful in your overall use of Clarion, have no bearing on CHT directly.

JSON Data Packaging Changes Made By SV

JSON changes were made to SV's variant of JSON data packaging. As we told you last update, SV's JSON changes are irrelevant to CHT JSON functionality, as we've developed and are further developing an entirely independent CHT-only JSON layer.

SV is probably in the process of fixing the bugs we warned about in their JSON classes. Good or bad, these recent changes by SV have no bearing or impact on CHT as our templates do not use SV JSON classes, or rely on them in any way. CHT's JSON functionalities both at the template and class level are entirely independent of anything SV does in their JSON implementation.

TCP/IP Raw Sockets Change Made By SV

The same applies to SV's TCP/IP raw sockets classes (internet connectivity layer). CHT has never relied on these and we have no intention of doing so in the future. So any changes that may have occured there in this update have no impact on your CHT socket-based apps (like servers and clients of any kind) built with CHT.

Two New CHT Demo Apps - Chat Server/Chat Client

Speaking of TCP/IP and JSON, we've posted with today's new build, two new demo apps that are a demonstration of our own (CHT exclusive) TCP/IP raw sockets and JSON capabilities. These apps are called HNDCHATSVR.APP (CHT Chat Server) and HNDCHATCLNT.APP (CHT Chat Client).



As we mentioned in our previous post, this TCP/IP expansion and JSON development will grow into a new web server type (Type 2 CHT Web Data Server) later on in this development year, before the end of 2015.

That's all for now. Please do obtain this new CHT update if you have installed Clarion and you are using our SMTP or SMS email functionality. Otherwise, if you are not yet using C10.0.0.11897, hold off on this update until you make that Clarion update.


Gus Creces
The Clarion Handy Tools Page
August 16, 2015

August 6, 2015

CHT TCP/IP And JSON Data Packaging

One of the things we promised to do in 2015 is to study the underlying classes available in C91 and C10 to support generic TCPIP communications especially as it applies to data transmission of JSON (Javascript Object Notation) data packages.

The purpose for this study was/is to see if it is viable to build an internet data server on top of ABC's TCP/IP classes plus ABC's JSON Classes. The difference between such a server (Type 2 discussed here) and present CHT type 1, and 3 servers, is primarily the data packaging methodology.

Our Type 1 Browser Server packages data as JDO object (JavaScript Data Objects)
Our Type 3 Client Server packages data as extended XML.

So the direction (discussed above) was to look at C10's TCP/IP Classes and JSON Classes to see if it was workable to build a Type 2 server to serve up JSON-data packages to clients of all kinds, from browsers to Clarion clients to perhaps clients written in other languages.

What we've discovered about SV's native TCP/IP layer and JSON classes is disappointing in the following sense. While we could build a type 2 server using SV's classes to structure the backbone, the outcome of that would be to incorporate all of SV's TCP/IP and JSON bugs and inadequacies into the finished product. ;-(

The encouraging outcome of this study is that we're now well on the way of building our own JSON data packaging classes, and we're also well on the way to expanding our existing TCP/IP layer to incorporate switchable data packaging (based on server template selection) to include JSON when you choose the type 2 server option on your master server template.

We began our testing with a TCP/IP example that SV supplies. This is a CHAT server available from SV's examples directory. This app sends commands and receives and sends data packages via JSON over an open TCP/IP connection that is not necessarily HTTP. Though it could be HTTP.

We quickly discovered major shortcomings in SV's TCP/IP layer AND their JSON classes. Bugs mostly but also unnecessary design complexities and code garble.

We're well on the way to completing the changes and additions to our own TCP/IP classes which have been tried and true for at least 15 years and we've built our own JSON classes from scratch.

The image attached below is our take on a CHAT server built entirely on CHT classes with CHT templates. (see image)


We're working now on an accompanying CHAT client. When these two demos are complete, at least to the ALPHA test stage, we'll post them along with the latest CHT templates and classes that they require and number that build 19C.02.00 (C10 users currently have 19C.01.00).

While this CHAT server/client set, uses RAW socket connections posting JSON data commands and packages back and forth, without the benefit of HTTP protocol, the Type 2 server we have in mind (as outlined in the above link), will be a standard HTTP server approach. Since that's what every browser appliance expects, a HTTP connection.

We'll keep you posted as this work progresses and may ask a few interested individuals to help me test the chat server since we'll be keeping one of these running at our end to enable live chats among any/all connected members.


Gus Creces
The Clarion Handy Tools Page
August 6, 2015

August 1, 2015

CHT Build 19C.01.00 A New CHT Utility Application

Friday July 31, 2014 we posted some addendum new material to Build 19C.01.00 for C10.

This includes a new tool we've called:
CHT Bulk Code Signing Tool or HNDBULKSIGNER.APP.

Here is an image of the user interface. The app is provided both in source code, (app format) located in your /hndapps/ directory and in precompiled format located in /accessory/hnd/.



Gus Creces
The Clarion Handy Tools Page
August 1, 2015

The Latest Docs

The latest template docs are here: CHT Template Docs

The latest demo application docs are here: CHT Application Docs

The latest utility application docs are here: CHT "Utility" App Docs

The latest "Batch Bot" application docs are here: CHT "Batch Bot" App Docs

The latest classes docs are here: CHT Classes Docs


Gus Creces
The Clarion Handy Tools Page
August 1, 2015