Session File Layout

When you create a Session File automatically or manually with a text editor, you must include all necessary records, commands, command parameters, conditions, condition parameters, and condition results.

A Session File is an ASCII delimited file (each record except the last one must end with a carriage return or line feed) that contains the following types of records:

Record 1: Signature Version Record
Record 2: Number of Script Commands Record
Records 3 through n: Script Command Records

The first record in the Session File is the Signature Version Record. This record is used to determine if the file is a valid Session File. This record is created automatically if you use Process Control to create the Session File. If you create the Session File manually, you need to add this record.

This record is used to determine which version of the Sterling Gentran:Server® software created the file (if the Session File was created automatically) or the version of Sterling Gentran:Server for which the Session File is used (if the Session File was created manually). The version information is used if conversions are needed with subsequent releases of Sterling Gentran:Server.

The format of the Signature Version Record is "GDW-Session","Version 2.0"

Process Control validates the signature (GDW-Session), and then loads the specified version into a variable for future use.

The second record in the Session File contains the number of script commands. If you used the Process Control to create the Session File automatically, the system automatically counts the number of command records and creates this record. If you create the Session File manually, you need to count the total number of command records and add that number to this record.