Microsoft KB Archive/84718

= Redirecting a TSR May Leave File Handle Open =

Article ID: 84718

Article Last Modified on 5/12/2003

-

APPLIES TO


 * Microsoft MS-DOS 3.1
 * Microsoft MS-DOS 3.2 Standard Edition
 * Microsoft MS-DOS 3.21 Standard Edition
 * Microsoft MS-DOS 3.3 Standard Edition
 * Microsoft MS-DOS 3.3a
 * Microsoft MS-DOS 4.0 Standard Edition
 * Microsoft MS-DOS 4.01 Standard Edition
 * Microsoft MS-DOS 5.0 Standard Edition
 * Microsoft MS-DOS 5.0a
 * Microsoft MS-DOS 6.0 Standard Edition
 * Microsoft MS-DOS 6.2 Standard Edition
 * Microsoft MS-DOS 6.21 Standard Edition
 * Microsoft MS-DOS 6.22 Standard Edition

-



This article was previously published under Q84718



SUMMARY
If you run a terminate-and-stay-resident (TSR) program and redirect the output to a file using a command similar to

TSR > file

the file handle of the redirected file is not closed automatically by MS-DOS. In this case, you can run out of file handles if the TSR reinstalls itself each time it is invoked.



MORE INFORMATION
When a program is executed, it inherits all the files its &quot;parent&quot; (usually COMMAND.COM) had open. At a minimum, this usually includes the file handles for the standard devices: STDIN, STDOUT, STDAUX, STDERR, and STDPRN.

If the input or output of a program is redirected, MS-DOS opens the specified file(s) and redirects STDIN or STDOUT to the file specified before executing the program. The program will input and output information as normal, but anything read from STDIN or written to STDOUT will actually go to the specified file instead. The program is not aware of this redirection (and if the program does not use STDIN or STDOUT, the redirection will appear &quot;fail&quot;).

When the program exits, MS-DOS automatically closes the handles that were opened due to redirection. TSR programs stay resident instead of exiting, thus the redirected files are not closed automatically by MS-DOS. If MS-DOS closed file handles when a program terminates but stays resident, problems could occur if the TSR tried to use the file(s) at a later time.

TSR programs can avoid this problem by closing file handle(s) when the TSR program is finished using them. For example, if the program has sent all its startup information to STDOUT and will not be using STDOUT in the future, the program can close STDOUT before terminating. If the program has read all necessary input from STDIN, close STDIN.

Additional query words: 6.22 2.00 2.10 2.11 3.00 3.10 3.20 3.21 3.30 3.30a 4.00 4.00a 4.01 4.01a 5.00 5.00a 6.00 6.20

Keywords: KB84718

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.