CommonGround Softworks Inc. - Test Parameters


This page provides the parameters to use a Telnet client to interact with a test Helix® database on one of our servers. Following these test parameters, is the text from a sample telnet session using this information


IP: test.commongrnd.com
Port: 3035

Collection Name: Helix Search <Helix%20Search>
UserName: GATEWAY
Password: TEST <case sensitive>

PROCESSMODE: 0 <Process Naming disabled>

Storing a single record: <two (2) text fields>

Relation: STORE
View: STOREIN

Viewing the record just stored:

Relation: GLOBAL
View: GLOBALOUT

Viewing a list of records <with outer abacii, no subform>

Relation: RETRIEVE
View: RETRIEVEOUT <alphabet; 26 records)

Viewing a list of records <with outer abacii and subform>

Relation: RETRIEVE
View: RETRIEVESUB <one subform record per link>

Deleting records <at least one store is required>

Relation: DELETE
View: DELETERECORD

Note: Please do not delete records from GLOBALOUT, RETRIEVEOUT OR
RETRIEVESUB; use DELETERECORD for testing this function.


SAMPLE SESSION - TESTING THE COMMONGROUND GATEWAY SITE


LOG ON: TEST.COMMONGRND.COM:3034

VERSION <Send Keyword>
OK 1 1 HE4.5.1 <Gateway replies, we are compatible with 4.5.1>

PROCESSMODE <Send Keyword>
OK 2 <Gateway Replies, we are using Named Processes>

CHECKFORM HELIX%20SEARCH GATEWAY TEST STORE STOREIN 1 <Send Request to see if form is valid and an entry form>
OK <Helix Replies, "Yes, this form is valid and is an entry form">

STORESETUP HELIX%20SEARCH GATEWAY TEST STORE STOREIN <Send Request>
OK %00%00%00%01 %09 %0d <Helix replies, "Here's your process ID and form delimeters">

STORESTORE %00%00%00%01 <For the process ID, here comes the data>
COMMONGROUND%09SOFTWORKS <Two data fields, separated by a tab {%09}, only one record, use keyboard Return key twice>

OK 0 <Helix replies, one record entered successfully>

CANCEL %00%00%00%01 <Request the process ID for the STORESETUP be cancelled>
OK <Helix replies, process cancelled>

RETRIEVE HELIX%20SEARCH GATEWAY TEST GLOBAL GLOBALOUT <Request to get data just entered>
OK %00%00%00%02 <Helix replies, "Here's your process ID>

WAITDONE %00%00%00%02 <Request to see if process has been completed - see the discussion under Data Fetch Status Request, But Wait>
OK 1 %09 %0d <Helix replies, ready, and tells us there is one record with delimiters>

GETROW %00%00%00%02 0 <Request to provide field/abacus headers for process>
OK 1 <Helix finds headers, and tells us there is one record {always one})
Data Field 1%09Data Field 2%0d <Helix replies with the names of the field/abacus headers separated by a tab {%09} and ends with a {0d} carriage return.>

GETROW %00%00%00%02 1 0 <Request to provide any outer abaci on the form>
OK 0 <Helix finds no outer abaci>

GETROW %00%00%00%02 2 0 1 0 0 <Request to provide data, skipping 0 records, getting one record.>
OK 1 <Helix finds one record>
%00%00%00%01COMMONGROUND%09SOFTWORKS%0d <Helix gives us the record's ID {internal number}, followed by the record data>

CANCEL %00%00%00%02 <Request the process ID for the RETRIEVE be cancelled>
OK <Helix replies, process cancelled>

RETRIEVE HELIX%20SEARCH GATEWAY TEST RETRIEVE RETRIEVEOUT <Request to get data on a list>
OK %00%00%00%04 <Helix replies, "Here's your process ID>

WAITDONE %00%00%00%04 <Request to see if process has been completed>
OK 26 %09 %0d <Helix replies, ready, and tells us there there are 26 records with delimiters>

GETROW %00%00%00%04 0 <Request to provide field/abacus headers for process>
OK 1 <Helix finds headers, and tells us there is one record {always one})
Alphabet%0d <Helix replies with the names of the field/abacus headers separated by a tab {%09} and ends with a {0d} carriage return.>

GETROW %00%00%00%04 1 0 <Request to provide any outer abaci on the form>
OK 1 <Helix an outer abaci>
The alphabet contains 26 letters.%0d <The contents of the outer abaci are returned, followed by the record delimiter>

GETROW %00%00%00%04 2 0 10 0 0 <Request to provide data, skipping 0 records, getting the first 10 records.>
OK 10 <Helix finds the first 10 records>
%00%00%00%01A%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%02B%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%03C%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%04D%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%05E%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%06F%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%07G%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%08H%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%09I%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%0aJ%0d <Helix gives us the record's ID {internal number}, followed by the record data>

GETROW %00%00%00%04 2 10 10 0 0 <Request to provide data, skipping 10 records, getting the next 10 records.>
OK 10 <Helix finds the next 10 records>
%00%00%00%0bK%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%0cL%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%0dM%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%0eN%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%0fO%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%10P%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%11Q%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%12R%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%13S%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%14T%0d <Helix gives us the record's ID {internal number}, followed by the record data>

GETROW %00%00%04 0%04 2 20 6 0 0 <Request to provide data, skipping 20 records, getting the first 6 records.>
OK 6 <Helix finds the next 6 records>
%00%00%00%15U%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%16V%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%17W%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%18X%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%19Y%0d <Helix gives us the record's ID {internal number}, followed by the record data>
%00%00%00%1aZ%0d <Helix gives us the record's ID {internal number}, followed by the record data>

CANCEL %00%00%00%04 <Request the process ID for the RETRIEVE be cancelled>
OK <Helix replies, process cancelled>



CommonGround Softworks Inc. (USA, Eastern Standard Time)

E mail : info@CommonGrnd.com or Support@CommonGrnd.com

Offices:

New Hampshire - Telephone at 603.485.7073

Massachusetts - Voice/Fax at 508.947.9980

Maine (Technical Support) - Voice/Fax at 207.646.8327


webmaster@CommonGrnd.com