1FISQL(FreeTDS)             FreeTDS Reference Manual             FISQL(FreeTDS)
2

NAME

4     fisql — interactive SQL shell
5

SYNOPSIS

7     fisql [-eFgpnvXY] [-a display_charset] [-A packet_size] [-c cmdend]
8           [-D database] [-E editor] [-h headers] [-H hostname] [-i inputfile]
9           [-I interfaces_file] [-J client_charset] [-l login_timeout]
10           [-m errorlevel] [-o outputfile] [-P password] [-s colseparator]
11           [-S server] [-t timeout] [-U username] [-w width] [-y sybase_dir]
12           [-z language]
13

DESCRIPTION

15     fisql is very similar to the ‘isql’ utility programs distributed by
16     Sybase and Microsoft. Like them, fisql uses the command ‘go’ on a line by
17     itself as a separator between batches.
18

OPTIONS

20     -a display_charset
21             The client charset name. Not implemented.
22
23     -A packet_size
24             Set protocol packet size. You should not need to set this parame‐
25             ter.
26
27     -c cmdend
28             Command terminator, defaults to ‘go’.
29
30     -D      Database name on the server to use.
31
32     -e      Echo SQL input (usually in outputfile)
33
34     -E editor
35             Specify an editor to invoke. Defaults to vi.
36
37     -F      FIPS mode ON. Server returns a message (but processes the query
38             anyway) when it encounters a non-standard SQL command.
39
40     -g      Display a brief help message
41
42     -h headers
43             Number of rows after which to repeat the column headers. Default
44             is once per resultset.
45
46     -H hostname
47             Hostname of the client machine as it will be told to the server.
48
49     -I interfaces_file
50             Name of the interfaces or freetds.conf file to use.
51
52     -i inputfile
53             Name of script file, containing SQL.
54
55     -J client_charset
56             Not implemented.
57
58     -l login_timeout
59             How long to wait for the server to acknowledge a login attempt.
60
61     -m errorlevel
62             For errors of the severity level specified or higher, print only
63             the message number, state, and error level.  Below that level,
64             print nothing.
65
66     -n      Suppress line numbers in echoed output.
67
68     -o outputfile
69             Name of output file, holding result data.
70
71     -p      Prints performance statistics. Not implemented.
72
73     -P password
74             Database server password.
75
76     -s colseparator
77             The column separator. Default is space. Shell metacharacters
78             require quoting.
79
80     -S server
81             Database server to which to connect.
82
83     -t timeout
84             The query timeout, in seconds. How long to wait for a query to be
85             processed.  The default is indefinitely, or as determined by
86             freetds.conf.
87
88     -U username
89             Database server login name.
90
91     -v      Display version and copyright.
92
93     -w width
94             How many characters wide to print the output. Defaults to 80.
95
96     -X      Use encrypted login. Not implemented in FreeTDS.
97
98     -y sybase_dir
99             Sets the SYBASE environment variable. Not used by FreeTDS.
100
101     -Y      Use chained transactions.
102
103     -z language
104             Name of a language for fisql's prompts and messages.  Cf. DBSETL‐
105             NATLANG.
106

NOTES

108     fisql is a filter; it reads from standard input, writes to standard out‐
109     put, and writes errors to standard error. The -i, and -e options override
110     these defaults.
111
112     fisql uses the DB-Library API provided by FreeTDS. It was first imple‐
113     mented using Sybase's own library and continues to work with it. Before
114     (and after) modifying it, it would be well to test it with Sybase's
115     library to assure compatibility between it and FreeTDS.  EXIT STATUS
116
117     fisql exits 0 on success, and >0 if the server cannot process the query.
118
119     fisql will report any errors returned by the server, but will continue
120     processing. In a production environment, this behavior may be insuffi‐
121     ciently stringent. To make it extremely intolerant of errors, change the
122     message and error handlers to call exit(3).
123

HISTORY

125     fisql first appeared in FreeTDS 0.65.
126

AUTHORS

128     The fisql utility was written by Nicholas S. Castellano
129     <entropy@freetds.org>, who contributed it to the FreeTDS project under
130     the terms of the GPL.
131

BUGS

133     Requires the GNU readline library.
134
135FreeTDS 1.00.38                 March 25, 2015                 FreeTDS 1.00.38
Impressum