Instream Validation Technical Manual 
Validating with Instream  
26 
(Primarily for TIBCO Foresight use) 
Automator mode – uses these file extensions for output, 
regardless of what is specified with the –o parameter: 
DTL 
for the detailed results file 
RPT 
for the report card 
SUM 
for the summary file 
configuration file location – the high-level directory 
containing $dir.ini (Windows) or fsdir.ini (UNIX). See 
Specifying Alternate INI Files on page 29
Not available for EDIFACT-based data. 
Document-only validation – ignore the ISA and GS and 
only validate the segments between ST and SE.  
If you use -d, you must also use -D). 
Please see Document-Only Processing on page 28 for 
details. 
D
Not available for EDIFACT-based data. 
Delimiters for document-only validation (segments ST-
SE, no ISA and GS).  
Parameters: 
segTerminator,elemSeparator,componentSeparator
Possible formats: 
integer 
Example:  
-D”29,30,31”
hexadecimal 
Example:  
-D”0x1E,0x1F,0x1D”
character 
Example:  
-D”~*:”
Important: -D must come before –d in the command-
line. 
Please see Document-Only Processing on page 28 for 
details. 
table file server – use the Table File Server.  
This gives faster processing if you are validating many 
very small files. See page 75
Batch convert pdf to tiff - software application dll:C# PDF Convert to Tiff SDK: Convert PDF to tiff images in C#.net, ASP.NET MVC, Ajax, WinForms, WPF
Online C# Tutorial for How to Convert PDF File to Tiff Image File
www.rasteredge.com
Batch convert pdf to tiff - software application dll:VB.NET PDF Convert to Tiff SDK: Convert PDF to tiff images in vb.net, ASP.NET MVC, Ajax, WinForms, WPF
Free VB.NET Guide to Render and Convert PDF Document to TIFF
www.rasteredge.com
Instream Validation Technical Manual 
Validating with Instream  
27 
Original file information - lets you insert the literal date 
and hour of file creation, the EDI file’s size, and its path 
name into a GEN record with number 15077.  This is 
for your own use; Transaction Insight displays it and 
lets you use it in searches on the Transmissions page.  
Parameters: 
mm/dd/yyyy  hh:mm:ss  fileSize  pathName
Example: 
-m"02/14/2005 14:55:19 2032 
C:/HVInStream/DemoData/835-DEMO1.TXT" 
Instead of -m on the validation command line, you can 
use 
useinputfileasoriginal=1
in Importer.ini. 
This collects the information from the STRT record in 
the validation detail file.
report card – creates a formatted report summarizing 
the results. The report card will be in a file called 
Report_resultsfilename.txt. 
startup profile – profile (APF) file.  
Optional; default is $fsdeflt.apf  (Windows and UNIX) 
Parameter: 
path
Example: 
-s”S:\shared profiles\MyProfile.apf” 
Please see APF.pdf in Instream’s Doc folder for details.  
user message –  free-form text. Allows you to insert 
whatever text you’d like in a GEN record with number 
15078.  This is for your own use. Transaction Insight 
can display it.  
Parameter: 
some text
Example: 
-u"From Sock 2" 
Resulting GEN record:  
GEN           015078 1 0From Sock 2
If you execute Instream with no parameters, you will see the version and a list of 
parameters. 
software application dll:C# PDF Convert to Jpeg SDK: Convert PDF to JPEG images in C#.net
NET. .NET library to batch convert PDF files to jpg image files. High quality jpeg file can be exported from PDF in .NET framework.
www.rasteredge.com
software application dll:VB.NET PDF Convert to Jpeg SDK: Convert PDF to JPEG images in vb.
Word, VB.NET Excel, VB.NET PowerPoint, VB.NET Tiff, VB.NET Best and free VB.NET PDF to jpeg converter SDK for Visual NET components to batch convert adobe PDF
www.rasteredge.com
Instream Validation Technical Manual 
Validating with Instream  
28 
Command Line Examples 
The commands below validate this file: 
EDI.txt
And creates these results files: 
Results.txt
Summary_Results.txt
Windows Example 
All input and output files are in the C:\Files directory. 
"C:\Foresight\Instream\Bin\HVInStream.exe" -
i"C:\Files\EDI.txt"  
-o"C:\Files\Results.txt" -gPDSA837I 
UNIX Example 
All input and output files are in the /Files directory. 
export FSINSTREAMINI=/HVInStream/bin 
export LIBPATH=/HVInStream/bin:$LIBPATH 
/HVInStream/bin/HVInStream -i"/Files/EDI.txt"  
-o"/Files/Results.txt" -gPDSA837I 
Sample Batch or Script Files 
The files that TIBCO Foresight installs in Instream’s Scripts folder contain 
examples of validation. Some also execute Docsplitter, DataSwapper, or Response 
Generator after validating. Please see Demo_Index.pdf for details. 
Document-Only Processing 
Available for X12 messages only.  
The command-line parameters -D and -d work together to validate EDI with no 
delimiters as follows. If the command-line has -d, it must also have -D.  
ISA/GS present in data 
-D on command-line 
-d on command-line 
Delimiters used for validation 
-D 
-D 
-D 
ISA Error Error 
software application dll:C# Create PDF from images Library to convert Jpeg, png images to
Batch convert PDF documents from multiple image formats, including Jpg, Png, Bmp, Gif, Tiff, Bitmap, .NET Graphics, and REImage.
www.rasteredge.com
software application dll:C# Create PDF from OpenOffice to convert odt, odp files to PDF in
A professional .NET PDF control able to batch convert multiple OpenOffice documents to PDF files in C#.NET. Description: Convert to PDF/TIFF and save it on
www.rasteredge.com
Instream Validation Technical Manual 
Validating with Instream  
29 
Specifying Alternate INI Files 
Many configuration features of Instream are defined in the $Dir.ini file (Windows) 
and the fsdir.ini file (UNIX). This file allows you to specify the name and location 
of error message files, set up partner automation, and set certain other options. 
Instream automatically reads this file from the Instream Bin directory when you 
request a validation. 
When you do not want to use the settings in your usual $Dir.ini or fsdir.ini file in 
the Instream Bin directory, you can point to a different one with the -c command-
line parameter. 
The format is: 
-c”
path
” 
Where path is the high-level directory containing a Bin directory which must 
contain: 
$Dir.ini or fsdir.ini 
fscint.ini (only needed here if you are using the table file server) 
Example 
set InStreamRoot=C:\Foresight\Instream 
"%InStreamRoot%\Bin\HVInStream.exe"  
-i"%InStreamRoot%\DemoData\Tutorial837IA.txt"  
-o"%InStreamRoot%\Output\Tutorial837IA_Results.txt"  
-gPDSA837I -c"C:\OtherINI" 
C:\OtherINI\Bin contains: 
$dir.ini or fsdir.ini 
Application Program Interface 
You can integrate Instream validation into another of your applications either 
statically (for C/C++) or dynamically (for C/C++, C#, and Java). 
An advantage of an API interface: you can read and act on results as they come 
back, rather than waiting for a file to be created.  You can also stop the validation 
anytime, based on the type or number of errors. 
The API can pass both the inbound data and resulting output via common memory 
or file. Common memory is normally the most efficient way of connecting, but 
large documents should be called as files. 
For details, see InStreamAPI.pdf in Instream’s Doc folder. 
software application dll:C# PDF Convert to Images SDK: Convert PDF to png, gif images in C#
able to batch convert PDF documents to image formats in C#.NET. Support exporting PDF to multiple image forms, including Jpg, Png, Bmp, Gif, Tiff, Bitmap, .NET
www.rasteredge.com
software application dll:VB.NET PDF Convert to Images SDK: Convert PDF to png, gif images
components for batch convert high resolution images from PDF. Convert PDF documents to multiple image formats, including Jpg, Png, Bmp, Gif, Tiff, Bitmap, .NET
www.rasteredge.com
Instream Validation Technical Manual 
Validation Results  
30 
Validation Results 
Results Files 
Instream Validator writes a summary and a detail results file for each EDI file validated. 
Summary File  Check it to see how many errors, warnings, etc., were found. See 
Summary Results below.  
Detail File 
Check it to see specifics about the validation: error and warning 
messages, general messages, etc. See Detail Results on page 31. 
Both files: 
Consist of records that start with a one- to five-character record identifier or “tag,” 
left justified in a field five characters wide. 
Contains the output from the validation of a single EDI data file.  
Summary Results 
This file is named Summary-xxx where xxx is the name of the detail output file. This 
file contains these five records that summarize the validation results: 
VER  
Version number of the output file format 
see page 70 
STRT 
Date and time when validation started, name and location 
of file validated 
see page 59 
SVRTY 
Message count by severity  
see page 69 
ETYPE 
Message count by type 
see page 53 
END 
Information about the file just validated 
see page 50 
To see an example, run one of the files in Instream’s Scripts directory and then look in 
Instream’s Output directory for a filename that contains the word Summary. 
software application dll:VB.NET Image: PDF to Image Converter, Convert Batch PDF Pages to
project. If you are C# developers for PDF to image converting, please directly link here: C# Windows converting project to convert PDF to jpeg, png, tiff, etc.
www.rasteredge.com
software application dll:VB.NET Create PDF from CSV to convert csv files to PDF in vb.net
VB.NET Excel, VB.NET PowerPoint, VB.NET Tiff, VB.NET CSV file to adobe PDF converter component for Visual Studio Batch convert CSV formats to adobe PDF files.
www.rasteredge.com
Instream Validation Technical Manual 
Validation Results  
31 
Detail Results 
The detail results file contains the details of the validation. Its name and location are 
specified with the -o command line parameter. 
The file has the following structure.  
VER 
STRT 
body (GEN, DTL, EDAT, EMSG, ESEG, SVRTS, ETYPS, Custom Z records) 
SVRTY 
ETYPE 
END 
Each DTL record will be followed by an EMSG and ESEG and possibly an EDAT. 
Don’t assume the order of EMSG, ESEG, and EDAT. 
TA1 
Instream produces a TA1 file under these conditions: 
GuidelineBestFit=0 in the $dir.ini/fsdir.ini 
No guideline is provided on the command line 
No guideline is identified by trading partner automation (GS01 or GS08 is missing) 
Instream Validation Technical Manual 
Validation Results  
32 
Line Numbers 
Line numbers appear throughout Instream’s validation detail file, XML report, and 
delimited report. 
Example from detail file 
DTL          21  2100 NM11036            18 4        ...                       
EMSG         21Element NM104 (D.E. 1036) at col. 18  ... 
Example from validation XML report 
This is the line number where the error was discovered, but not always the line number 
where the problem actually occurred. In some cases, it cannot be determined that a 
segment has an error until later in the transaction.  
For example, balancing rules have to be run at the end of a loop. Instream becomes 
aware of the loop ending when it encounters the first segment after the loop ends. It 
then makes the balancing comparison and uses its current line number – the first 
segment after the loop. This is the line number that will appear in the DTL record. 
Instream Validation Technical Manual 
Validation Results  
33 
Record Definitions 
CSEG: Current Segment Data Record 
The CSEG record is variable length and contains the actual contents of the EDI 
segment currently being processed. 
By default, CSEG records are not output since their presence inflates the size of the 
detail file. To output CSEG records, set CSEG=1 in the APF file. For details, please see 
the Detail Record Output section of the APF.pdf in Instream’s Doc directory. 
CSEG Record Layout 
Field 
Length 
Start 
End 
Record Tag (CSEG) 
Line # 
10 
15 
Segment Data 
16 
EOL 
Record Tag 
Contains CSEG to identify the type of record. 
Line # 
Contains the number of physical lines in the EDI data file up to the point where this 
record is generated.  If the EDI data is wrapped to fixed length blocks, or has segment 
terminators that do not include a new-line character, the physical line number may not 
be a segment count.  
Segment Data 
Contains the complete EDI segment. 
Instream Validation Technical Manual 
Validation Results  
34 
CTX: Context Record for Response Generator 999 
In previous releases, Response Generator created a CTX segment in the 999 if the 
IK403 started with “I” for Implementation syntax errors. Now, you have three options 
for 5010 999 Errata CTX records: 
No CTX records (the default) 
Foresight-supplied CTX records 
Your own custom CTX records 
These are explained in CTX.pdf. 
Example 
The underlined information is static text. 
CTX record in a DTL file: 
CTX          19|CTX02|14,32001 
Corresponding segment in a 999: 
CTX*SITUATIONAL TRIGGER*SBR*14**2*1069~ 
CTX Record Layout 
Field 
Length 
Start 
End 
Record Tag (CTX) 
Line # 
10 
15 
Vertical Bar 
16 
17 
CTX02 
17 
21 
Vertical Bar 
22 
23 
Line # for 1st seg. 
varies 
23 
 (comma) 
Error # 
Record Tag 
Identifies the type of record: CTX. 
Line # 
Contains the number of physical lines in the EDI data file up to the point where this 
record is generated.  If the EDI data is wrapped to fixed length blocks, or has segment 
terminators that do not include a new-line character, the physical line number may not 
be a segment count. 
CTX02 
Currently, this is always CTX02.   
Instream Validation Technical Manual 
Validation Results  
35 
Line # for 1st seg 
Line number in the EDI file for the first segment in the situational relationship. The ST 
is segment 1. 
Error # 
Error number generated when the situational relationship is violated. This must be in the 
[RespGen Overrides] section of the validation APF used with Response Generator.  
Example:  
CTX50001=CTX,32001,SBR,,2,,,1069 
Documents you may be interested
Documents you may be interested