BatchTest

Automatically test multiple targets rather than running interactive CheckTLS.com tests over and over.

Batchtest results can be either people friendly (i.e. easy for you to read) or machine friendly (i.e. easy for a computer to parse). See results formats.

Receiver

BatchTest can run Receiver tests on a "batch" of targets you enter, typically by pasting from a spreadsheet. The batch runs by itself, testing each address in turn. The original list of targets and the test results are sent to an email address you specify along with the target list.

BatchTest uses an XML configuration file to list targets, optional totals for the batch, and the return email address for the results. This file can be generated from most databases, or we have Excel workbooks can that generate it. See BatchTest XML File and Excel Workbook for more information.

When creating a new batch, BatchTest lets you just enter the target addresses or it lets you upload the XML configuration file. Once the test is created, you must edit the XML file to make changes.
See Creating and Maintaining BatchTests below.

Custom

BatchTest can also test multiple custom or private targets. The XML file has elements and attributes that call out each of the options available in the interactive Custom/Private test.
See Creating and Maintaining BatchTests below.

Sender

BatchTest includes an unlimited use Sender test pass-code. This pass-code works just like the one-time code that the interactive CheckTLS.com Sender Test provides, but it can be used over and over. Use it to save and run tests automatically from your system and to run multiple tests more easily.

There is no way an outsider can tell your email system to "send out an email", so CheckTLS.com cannot completely automate the Sender tests. To automate a batch of Sender tests, simply schedule emails to the normal TestSender address (test@TestSender.CheckTLS.com or test@TestSenderAssureTLS.com) with the multi-use pass-code in the Subject:.

End to End (TestThru)

TestThru is our premiere BatchTest, and has no free counterpart on the CheckTLS.com website. It combines TestReceiver, an actual email, and TestSender to test the target email system from "end-to-end": that it can receive secure email, process it, and then send it back securely. TestThru does this by watching itself send an actual email to the target and then listening for and watching a reply come back. It requires the email system administrator to setup an auto-forward email account inside the email system to be tested. This auto-forwarder should take in any email addressed to it and return it to ReplyAddress@TestThru.CheckTLS.com.
See Creating and Maintaining BatchTests below.

Run Tests Automatically (On A Schedule)

Corporate level subscribers can save test batches and schedule them to run automatically. Storing BatchTests on our servers saves even more time and reduces the chances for error. A saved batch can be run on demand from the BatchTest Web Service or from the interactive BatchTest screen. Or saved batches can be scheduled to run automatically on cycles ranging from monthly to hourly.

Saving a group of tests, running it periodically, and tuning the result to send only when something changes, is a powerful tool for keeping an email system running properly and efficiently. You can keep constant watch over the critical components of your own and your trading partner's email systems. See MonitorTLS for how to use this capability with your existing monitoring and notification systems.
See Creating and Maintaining BatchTests below for info on saving and scheduling BatchTests.

Creating and Maintaining BatchTests

There are two ways to create a new BatchTest: interactively, described here, or with the BatchTest Web Service. Certain features such as saving and scheduling BatchTests and the web service are only available to Corporate Level subscribers.

Click BatchTest.
The "Select Test" page appears. This is the main BatchTest page. You will return to it often, because most things you do start from here.
The buttons along the bottom list what you can do. All but two, Enter New Test and Refresh List, act on existing tests. To use any other button, first select a test by clicking in the circle in the Select column on the left of the table, then click the button. Only Corporate Level subscribers can work with more than one batch. When they use Enter New Test, it creates a new batch and a new line on this screen. For a Professional Level subscriber it erases any existing batch and starts a new one.

From this screen you can:

  1. Enter New Test
    The Enter New Test page appears with these fields:
    1. Results To
      Enter your email address. This is where the results of your test will be sent. Be sure this is a valid email address, and be sure your spam filter will not filter it (i.e. add the CheckTLS.com domain to your safe-senders list).
    2. Description
      Enter a brief description of this test. This is just to help you remember what you were testing.
    3. Test Type
      Either Receiver or Thru. A Receiver test tests the target's email system (see Receiver above). A Thru test tests the target's email system End-to-End (see End to End above).
    4. Test Targets
      Enter the email addresses you want to test, one per line.
    After entering these fields, click the Create Test button. The "Select Test" screen reappears with a message above it saying your test was created, and with your test listed as a selection.
  2. Edit XML
    The Edit XML page appears with two mutually exclusive fields:
    1. XML File
      This is a file upload field that lets you browse to a BatchTest XML config file on your PC and upload it. It must be in the proper XML Format. If a file is entered here and XML is entered below, this file takes precedence (i.e. the XML below is ignored).
    2. XML
      The actual XML, i.e. the contents of the config file. This must be in the proper XML Format. If XML is entered here and a file is given for upload above, the upload file takes precedence (i.e. anything entered here is ignored).
    After selecting the XML File or entering/changing the XML, click the Create Test button. The "Select Test" screen reappears with a message above it saying your XML file was saved.
  3. Edit Schedule
    The Edit Schedule page appears with these fields:
    1. Description
      The brief description of this test. This is just to help you remember what you were testing.
    2. Day Of Month
    3. Day Of Week
    4. Hour Of Day
    5. Minute Of Hour
    Schedule parameters are "and-ed" together, meaning the test is run only when all of the conditions listed are met. For example, if Day Of Week is 1 and Hour Of Day is 2, the test runs every Monday (DOW=1) at 2:00AM (HOD=2). Or this bad example, if Day Of Month is 1 and Day Of Week is 1, the test only runs when the first of the month is on a Monday.
    Asterisks mean "all", so an asterisk ("*") in Day Of Week means any day, Sunday through Saturday.
    A typical schedule might be: DOM=*, DOW=7, HOD=3, MOH=5. This runs the test every Sunday at 2:05 AM, so the results are in your email first thing Monday morning.
    After making your changes, click the Save Schedule button. The "Select Test" screen reappears with a message above it saying your schedule was saved.
  4. Check Test
    Tests both the schedule entries and the XML config file. If the schedule makes sense, it displays "SCHEDULE VALIDATION OK!" and the next time the test will be run. If the schedule is invalid, it displays an error message.
    If the XML is syntactically correct, it displays "XML VALIDATION OK!" If the XML is invalid, it displays an error message.
    After viewing the output, click the Return to Test List button.
  5. Delete Test
    Displays details of the test and asks for verification that you want to delete this test.
    After deleting the test, click the Return to Test List button.
    Professional Level subscribers do not have to delete their test; it is automatically removed when you leave the BatchTest screens.
  6. Run Test Now
    Your test is run immediately. After a few moments, the "Select Test" screen reappears with a message above it saying your test was run. The results of your test should be in your email.

BatchTest Web Service BatchTestUpLoad

BatchTests can be created, updated, and/or run with this web service. Again, only Corporate Level subscribers, who can save tests, can use this service. It uses these parameters:

CUSTOMERCODE:
Your Customer Code (not your UserCode). You can find your Customer Code with here.
PASSWORD:
Your Customer Password (not your User Password).
TESTID:
Blank to create a new test, else the test serial number of the config file you wish to replace. You can get the test serial number from running BatchTest interactively.
RUNNOW:
If this starts with a Y the test is run immediately after the new config file is saved. If no config file is provided, the existing saved test is run.
XML_File:
The file on your computer to upload. This must be in the proper XML Format. If a file is entered here and XML is entered below, this file takes precedence (i.e. the XML below is ignored).
XML:
The actual XML, i.e. the contents of the config file. This must be in the proper XML Format. If XML is entered here and a file is given for upload above, the upload file takes precedence (i.e. anything entered here is ignored).