readpipe Utility

Command Prompt Utilities

Command Prompt Utilities

readpipe Utility

The readpipe utility tests the integrity of the network Named Pipe services, in conjunction with makepipe.

Syntax

readpipe /Sserver_name /Dstring [/n] [/q] [/w] [/t] [/p pipe_name] [/h]

Arguments

/Sserver_name

Is the name of a default instance of Microsoft® SQL Server™ on which you just ran makepipe. readpipe does not support named instances of SQL Server 2000. There are no spaces between /S and server_name.

/Dstring

Is a test character string. There are no spaces between /D and string.

/n

Specifies the number of iterations.

/q

Queries for incoming data (polling). Without /q, readpipe reads the pipe and waits for data.

/w

Specifies the wait time, in seconds, to pause while polling. The default is 0.

/t

Asks for Transact-SQL named pipes. This option overrides polling.

/p pipe_name

Is the name of the pipe. The default pipe_name is abc.

/h

Displays usage.

Remarks

This diagnostic utility checks to see if the named pipes are working. Use it (along with makepipe) if you cannot connect to an instance of SQL Server.

Because applications for Microsoft Windows NT®, Microsoft Windows®, and Microsoft MS-DOS® all run on Windows NT, you must be careful about which version of makepipe and readpipe you are running. You must use the version specific to the operating system on which you are testing the integrity of the named pipe.

After makepipe is started, the server waits for a client to connect. The readpipe command prompt utility can then be run from other workstations. When all testing is complete, go to the screen where the makepipe utility is running and press CTRL+BREAK or CTRL+C to stop execution.

The readpipe utility is not installed by SQL Server Setup. The utility can be found in the x:\x86\Binn directory on the SQL Server compact disc.

See Also

makepipe Utility