1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
|
<HTML>
<HEAD>
<TITLE>New Features in Version 3.0 -- Tcl API</TITLE>
<LINK rel=Previous href="new-ch3.htm">
<LINK rel=ToC href="toc.htm">
<LINK rel=Index href="master.htm">
<LINK rel=Next href="new-ch5.htm">
</HEAD>
<BODY BGCOLOR="#ffffff">
<P>
<A NAME="topofpage"></A>
<TABLE WIDTH=100%>
<TR>
<TD ALIGN=LEFT><A NAME="topofpage"></A> <IMG SRC="as-c-sm.gif"></TD>
<TD ALIGN=RIGHT><A href="new-ch3.htm"><IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm> <IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm> <IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="new-ch5.htm"> <IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<A name="7983"> </A></TD>
</TR>
</TABLE>
<P>
<A name="5330"> </A>
<H3>
Tcl API
</H3>
<P>
<A name="30429"> </A>The following features changes for the Tcl API are included
in AOLserver Version 3.0:
<TABLE Border = "3">
<TR>
<TH><A name="28338"> </A><B>Feature</B></TH>
<TH><A name="28340"> </A><B>Where Documented</B></TH>
</TR>
<TR>
<TD><A name="51090"> </A><B>ADP parsers supported: </B>ADP parsers implement
a specific syntax for ADPs. Two ADP parsers are registered by default: "adp"
and "fancy".
<P>
<A name="51101"> </A>Configure ADP parsers in the ns/server/server-name/adp
and ns/server/server-name/adp/parsers sections of the configuration file.
<P>
<A name="51110"> </A>You can specify a specific ADP parser in the ns_adp_eval
Tcl function.
<P>
<A name="51112"> </A>You can register new ADP parsers with the
Ns_AdpRegisterParser C function.</TD>
<TD><A name="51092"> </A><I>Administrator's Guide:</I>
<A href="con-ch3.htm#75330">page 56</A>, <A href="con-ch3.htm#157087">page
57</A>
<P>
<A name="51113"> </A><I>Tcl Developer's Guide:</I>
<A href="tadp-ch9.htm#23840">page 10</A>, <A href="tapi-c12.htm#222438">page
53</A>
<P>
<A name="51114"> </A><I>C Developer's Guide:</I>
<A href="c-ch8.htm#861558">page 45</A></TD>
</TR>
<TR>
<TD><A name="44778"> </A><B>New ADP configuration parameters: </B>Several
new parameters have been added, and some other parameters have been removed.</TD>
<TD><A name="44780"> </A><I>Administrator's Guide:</I>
<A href="con-ch3.htm#75330">page 56</A></TD>
</TR>
<TR>
<TD><A name="48187"> </A><B>ADP caching configuration changed: </B>Caching
for ADPs is configured with the new Cache parameter in the ADP section.</TD>
<TD><A name="48189"> </A><I>Administrator's Guide:</I>
<A href="con-ch3.htm#75330">page 56</A></TD>
</TR>
<TR>
<TD><A name="48163"> </A><B>Built-in ADP tags no longer supported:</B> The
built-in ADP tags, <aol>, <browser>, <msie>, and
<netscape>, are no longer supported. You can register your own ADP
tags with the <B>ns_adp_registertag</B> and <B>ns_register_adptag</B> functions.</TD>
<TD><A name="48169"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-c17.htm#221672">page 58</A>, <A href="tapi-102.htm#173981">page
160</A></TD>
</TR>
<TR>
<TD><A name="44782"> </A><B>New/Modified ADP functions: </B>The following
Tcl functions are new:
<DL>
<DD>
<B>ns_adp_debug</B>
<DD>
<B>ns_adp_dump</B>
<DD>
<B>ns_adp_eval</B>
<DD>
<B>ns_adp_exception</B>
<DD>
<B>ns_adp_puts</B>
<DD>
<B>ns_adp_registertag</B>
<DD>
ns_adp_return
<DD>
<B>ns_adp_stream</B>
<DD>
<B>ns_adp_tell</B>
<DD>
<B>ns_adp_trunc</B>
</DL>
<P>
<A name="48256"> </A>The following Tcl functions are modified:
<DL>
<DD>
<B>ns_adp_abort</B>
<DD>
ns_adp_break
<DD>
<B>ns_adp_include</B>
<DD>
<B>ns_adp_parse</B>
</DL>
</TD>
<TD><A name="44784"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-ch9.htm#222048">page 50</A> through
<A href="tapi-c21.htm#287024">page 62</A></TD>
</TR>
<TR>
<TD><A name="44786"> </A><B>ADP debugging with TclPro: </B>TclPro debugging
for ADPs can be enabled with the new EnableDebug parameter, or with the new
<B>ns_adp_debug</B> function.</TD>
<TD><A name="44788"> </A><I>Tcl Developer's Guide:</I>
<A href="tadp-ch4.htm#22009">page 7</A>, <A href="tadp-ch6.htm#23673">page
9</A>, <A href="tapi-ch9.htm#222048">page 50</A></TD>
</TR>
<TR>
<TD><A name="48422"> </A><B>Some database services functions removed:</B>
The following database services functions have been removed:
<DL>
<DD>
<B>ns_buildsqldate</B>
<DD>
<B>ns_buildsqltime</B>
<DD>
<B>ns_buildsqltimestamp</B>
<DD>
<B>ns_column</B>
<DD>
<B>ns_entryform</B>
<DD>
<B>ns_entrywidget</B>
<DD>
<B>ns_entrywidgetbytype</B>
<DD>
<B>ns_ill</B>
<DD>
<B>ns_parsesqldate</B>
<DD>
<B>ns_parsesqltime</B>
<DD>
<B>ns_parsesqltimestamp</B>
<DD>
<B>ns_searchform</B>
<DD>
<B>ns_searchopwidget</B>
<DD>
<B>ns_searchqbf</B>
<DD>
<B>ns_table</B>
<DD>
<B>ns_updateform</B>
<DD>
<B>ns_updaterow</B>
<DD>
<B>ns_updaterowbyid</B>
</DL>
</TD>
<TD><A name="48424"> </A>NA</TD>
</TR>
<TR>
<TD><A name="44214"> </A><B>Tcl caching changed:</B> Tcl file caching is
no longer configured through the configuration file. The <B>ns_cache</B>
function has been removed, and a new set of caching functions has been
implemented:
<DL>
<DD>
<B>ns_cache_flush</B>
<DD>
<B>ns_cache_names</B>
<DD>
<B>ns_cache_size</B>
<DD>
<B>ns_cache_stats</B>.
</DL>
</TD>
<TD><A name="48157"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-c26.htm#236562">page 67</A> through
<A href="tapi-c29.htm#236565">page 70</A></TD>
</TR>
<TR>
<TD><A name="48317"> </A><B>New configuration file Tcl functions:</B> The
new <B>ns_section </B>and <B>ns_param </B>Tcl functions are used to define
the sections and parameters in the configuration file. The new
<B>ns_configsection</B> and <B>ns_configsections</B> functions are used to
return information from the configuration file.</TD>
<TD><A name="48319"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-c34.htm#227106">page 76</A>, <A href="tapi-c35.htm#227107">page
77</A>, <A href="tapi-c89.htm#227552">page 145</A>,
<A href="tapi-116.htm#227793">page 182</A></TD>
</TR>
<TR>
<TD><A name="44359"> </A><B>Full Text functions removed: </B>Illustra and
the full text features of AOLserver are no longer supported. As a result,
the following Tcl functions have been removed:
<DL>
<DD>
<B>ns_archivetable</B>
<DD>
<B>ns_hiliteurl</B>
<DD>
<B>ns_htmltoquery</B>
<DD>
<B>ns_textarchive</B>
<DD>
<B>ns_textconfigpath</B>
<DD>
<B>ns_texthandlepool</B>
<DD>
<B>ns_textindex</B>
<DD>
<B>ns_texttable</B>
</DL>
</TD>
<TD><A name="44361"> </A>NA</TD>
</TR>
<TR>
<TD><A name="49741"> </A><B>Linked interpreters no longer used:</B> Tcl
interpreters no longer share the same procedure tables. During startup, a
single interpreter, known as the parent interpreter, exists and is populated
with procedures. After startup, the parent interpreter is copied into many
child interpreters, each of which is assigned a connection thread.</TD>
<TD><A name="49745"> </A><I>Tcl Developer's Guide:</I>
<A href="tgen-ch1.htm#15218">page 29</A></TD>
</TR>
<TR>
<TD><A name="45088"> </A><B>Maintaining state data no longer supported:</B>
AOLserver no longer maintains state data in Tcl. As a result, the following
Tcl functions have also been removed:
<DL>
<DD>
<B>ns_state_delete</B>
<DD>
<B>ns_state_restore</B>
<DD>
<B>ns_state_save</B>
<DD>
<B>ns_state_view</B>
</DL>
</TD>
<TD><A name="45090"> </A>NA</TD>
</TR>
<TR>
<TD><A name="48307"> </A><B>Permissions functions modified:</B> Six new
permissions functions replace the old permissions functions. The new functions
are:
<DL>
<DD>
<B>ns_perm adduser</B>
<DD>
<B>ns_perm addgroup</B>
<DD>
<B>ns_perm allowuser</B>
<DD>
<B>ns_perm denyuser</B>
<DD>
<B>ns_perm allowgroup</B>
<DD>
<B>ns_perm denygroup</B>
<DD>
ns_perm checkpass
<DD>
ns_perm setpass
<DD>
ns_permpasswd
</DL>
<P>
<A name="48470"> </A>The removed functions are:
<DL>
<DD>
<B>ns_group</B>
<DD>
<B>ns_method</B>
<DD>
<B>ns_user</B>
</DL>
</TD>
<TD><A name="48309"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-c94.htm#79412">page 150</A>, <A href="tapi-c95.htm#296291">page
152</A></TD>
</TR>
<TR>
<TD><A name="48483"> </A><B>Server statistics functions removed:</B> The
following functions have been removed:
<DL>
<DD>
<B>ns_intervalstats</B>
<DD>
<B>ns_resetintervalstats</B>
<DD>
<B>ns_totalstats</B>
</DL>
</TD>
<TD><A name="48485"> </A>NA</TD>
</TR>
<TR>
<TD><A name="48328"> </A><B>New sockets functions:</B> Four new sockets functions
have been added:
<DL>
<DD>
<B>ns_sockblocking</B>
<DD>
<B>ns_socklistencallback</B>
<DD>
<B>ns_socknonblocking</B>
<DD>
<B>ns_socknread</B>
</DL>
</TD>
<TD><A name="48330"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-127.htm#232740">page 196</A>, <A href="tapi-132.htm#232820">page
201</A>, <A href="tapi-133.htm#232894">page 202</A>,
<A href="tapi-134.htm#232969">page 203</A></TD>
</TR>
<TR>
<TD><A name="50842"> </A><B>Stored procedures supported:</B> The following
new functions have been added to support database stored procedures:
<DL>
<DD>
<B>ns_db sp_exec</B>
<DD>
<B>ns_db sp_getparams</B>
<DD>
<B>ns_db sp_returncode</B>
<DD>
<B>ns_db sp_setparam</B>
<DD>
<B>ns_db sp_start</B>
</DL>
</TD>
<TD><A name="50844"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-c44.htm#67537">page 88</A></TD>
</TR>
<TR>
<TD><A name="48198"> </A><B>New Tcl functions:</B> The following functions
not otherwise mentioned above are new for v3.0:
<DL>
<DD>
<B>ns_atexit</B>: Register a script to be run at shutdown
<DD>
<B>ns_checkurl</B>: Authorize a request
<DD>
<B>ns_cond</B>: Manage events
<DD>
<B>ns_conncptofp</B>: Write content to a file
<DD>
<B>ns_connsendfp</B>: Write contents of file to conn
<DD>
<B>ns_cport</B>: Control port interface commands
<DD>
<B>ns_gmtime</B>: Return time in GMT form
<DD>
<B>ns_kill</B>: Send a signal to a process
<DD>
<B>ns_logroll</B>: Roll server log
<DD>
<B>ns_markfordelete</B>: Mark interpreter for deletion
<DD>
<B>ns_menu</B>: Administer server in control port
<DD>
<B>ns_modlog</B>: Send notice to the log
<DD>
<B>ns_modlogcontrol</B>: Define log realms
<DD>
<B>ns_modulepath</B>: Return server directory
<DD>
<B>ns_parseheader</B>: Parse HTTP header
<DD>
<B>ns_parsequery</B>: Parse querystring
<DD>
<B>ns_querygetall</B>: Get multiple query values
<DD>
<B>ns_rand</B>: Generate a random number
<DD>
<B>ns_rollfile</B>: Roll an arbitrary file
<DD>
<B>ns_uudecode</B>: Perform base-64 decode
<DD>
<B>ns_uuencode</B>: Perform base-64 encode
</DL>
</TD>
<TD><A name="48200"> </A><I>Tcl Developer's Guide:</I>
<A href="tapi-ch2.htm#69108">"Function Reference"</A></TD>
</TR>
<TR>
<TD><A name="48202"> </A><B>Removed Tcl functions:</B> The following functions
not otherwise mentioned above are no longer supported for v3.0:
<DL>
<DD>
<B>ns_accesslog</B>
<DD>
<B>ns_adminlink</B>
<DD>
<B>ns_browsermatch</B>
<DD>
<B>ns_formvalueput</B>
<DD>
<B>ns_htmlselect</B>
<DD>
<B>ns_parsetime</B>
<DD>
<B>ns_puts</B> (use <B>ns_adp_puts</B> instead)
<DD>
<B>ns_queryresolve</B>
<DD>
<B>ns_quota</B>
<DD>
<B>ns_updateheader</B>
</DL>
</TD>
<TD><A name="48204"> </A>NA</TD>
</TR>
<TR>
<TD><A name="44802"> </A><B>Tcl v7.6 supported: </B>AOLserver<B> </B>now
supports the Tcl v7.6 commands instead of the Tcl v7.4 commands. Visit the
<A HREF="http://www.scriptics.com/man">http://www.scriptics.com/man</A> web
site for the complete descriptions of Tcl 7.6 commands.</TD>
<TD><A name="44804">
</A><A HREF="http://www.scriptics.com/man">www.scriptics.com/man</A></TD>
</TR>
<TR>
<TD><A name="41132"> </A><B>Tcl v7.4 no longer supported</B></TD>
<TD><A name="28354"> </A>NA</TD>
</TR>
</TABLE>
<P>
<A name="45001"> </A>
<TABLE BORDER="2" CELLPADDING="1" width="100%">
<TR>
<TD COLSPAN=3><P ALIGN=Center>
<IMG SRC="bluebult.gif"> <A HREF="#topofpage"> <FONT SIZE=-1>Top of
Page</FONT></A> <IMG SRC="bluebult.gif"></TD>
</TR>
<TR>
<TD COLSPAN=3><P ALIGN=Center>
<A href="new-ch3.htm">
<IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A> <A href=toc.htm>
<IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A> <A href=master.htm>
<IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A> <A href="new-ch5.htm">
<IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A> <BR align=center>
<FONT size=-1>Copyright © 1998-99 America Online, Inc.</FONT></TD>
</TR>
</TABLE>
</BODY></HTML>
|
