You are here: Available Utilities > F > FILE2IDS

FILE2IDS

Use this utility to read a text file which contains a series of requests and submit those requests to IDS. Each line of the text file equals one request. You specify the request type on the command line and the attachment variables are created from each line in the input file in this manner:

Each line is broken into 1000 byte chunks (1000 is the default size, you can set the size using the /L parameter)
Each chunk is added as attachment variable RECORDLINEXX, where XX is the sequence number of the chunk.

The attachment variable RECORDPARTS specifies how many chunks are added.

Note

The FILE2IDS is a Visual Basic program. You must have a VB runtime installed to run this program. You can click the Help button when you run FILE2IDS to see a summary of the various parameters.

To run the FILE2IDS utility, enter this command:

file2ids /C /D /I /L /K /R /T /Name /W

Parameter	Description
/C	Specifies the value of the CONFIG attachment variable
/D	Set to On to turns on the debugging window and wait for the result from IDS.
/I	The name of the file
/K	Enter Y or N to have the system wait or not wait for a key to be pressed in the debug window.
/L	Specifies the line length. The default is 1000.
/R	The request type. The default is Email.
/T	The length of time in milliseconds before IDS times out. The default is 15000.
/Name	Lets you pass a name and value to the IDS rule in this format: /Name=Value For instance, /ABC=BCD adds the attachment variable ABC with the value BCD.
/W	The length of time in milliseconds IDS will wait before retrying. The default is 1000.

All parameters are passed in with the equal sign (=). Here is an example:

/I=file.txt

If you run the utility with no parameters, it displays a window which lets you then enter the parameters shown above.

The utility returns one of the following values:

Value	Description
0	The utility completed its task and no errors occurred.
1	No input file information was found.
2	The utility was canceled before it ran. Typically, this indicates you clicked Exit on the window which asks for the parameters.
3	Other error.