Hex Artifact Content
Not logged in

Artifact aeed0b3a249320f0885cec86c0cfb97feb8c4675:

Wiki page [about Pause()] by sandro 2019-05-30 07:48:23.
0000: 44 20 32 30 31 39 2d 30 35 2d 33 30 54 30 37 3a  D 2019-05-30T07:
0010: 34 38 3a 32 33 2e 34 38 30 0a 4c 20 61 62 6f 75  48:23.480.L abou
0020: 74 5c 73 50 61 75 73 65 28 29 0a 50 20 39 36 36  t\sPause().P 966
0030: 63 36 35 36 39 65 34 35 31 63 62 64 61 35 30 36  c6569e451cbda506
0040: 35 35 64 63 66 61 30 66 38 36 30 62 32 65 36 30  55dcfa0f860b2e60
0050: 32 32 38 65 66 0a 55 20 73 61 6e 64 72 6f 0a 57  228ef.U sandro.W
0060: 20 36 39 36 38 0a 3c 61 20 68 72 65 66 3d 22 68   6968.<a href="h
0070: 74 74 70 73 3a 2f 2f 77 77 77 2e 67 61 69 61 2d  ttps://www.gaia-
0080: 67 69 73 2e 69 74 2f 66 6f 73 73 69 6c 2f 6c 69  gis.it/fossil/li
0090: 62 73 70 61 74 69 61 6c 69 74 65 2f 77 69 6b 69  bspatialite/wiki
00a0: 3f 6e 61 6d 65 3d 34 2e 33 2e 30 2d 64 6f 63 22  ?name=4.3.0-doc"
00b0: 3e 62 61 63 6b 3c 2f 61 3e 3c 68 72 3e 3c 62 72  >back</a><hr><br
00c0: 3e 0d 0a 3c 68 31 3e 49 6e 74 72 6f 64 75 63 74  >..<h1>Introduct
00d0: 69 6f 6e 3c 2f 68 31 3e 0d 0a 4d 61 6e 79 20 70  ion</h1>..Many p
00e0: 6f 77 65 72 20 75 73 65 72 73 20 72 6f 75 74 69  ower users routi
00f0: 6e 65 6c 79 20 75 73 65 20 53 70 61 74 69 61 4c  nely use SpatiaL
0100: 69 74 65 20 66 6f 72 20 65 78 65 63 75 74 69 6e  ite for executin
0110: 67 20 3c 62 3e 76 65 72 79 20 63 6f 6d 70 6c 65  g <b>very comple
0120: 78 20 53 51 4c 20 53 63 72 69 70 74 73 3c 2f 62  x SQL Scripts</b
0130: 3e 2c 20 6d 61 79 20 62 65 20 6c 61 72 67 65 6c  >, may be largel
0140: 79 20 62 61 73 65 64 20 6f 6e 20 3c 62 3e 53 74  y based on <b>St
0150: 6f 72 65 64 20 50 72 6f 63 65 64 75 72 65 73 3c  ored Procedures<
0160: 2f 62 3e 2e 3c 62 72 3e 0d 0a 53 6f 6d 65 74 69  /b>.<br>..Someti
0170: 6d 65 73 20 61 74 74 65 6d 70 74 69 6e 67 20 74  mes attempting t
0180: 6f 20 64 65 62 75 67 20 61 20 63 6f 6d 70 6c 65  o debug a comple
0190: 78 20 53 51 4c 20 73 63 72 69 70 74 20 6d 61 79  x SQL script may
01a0: 20 65 61 73 69 6c 79 20 62 65 63 6f 6d 65 20 61   easily become a
01b0: 20 64 69 66 66 69 63 75 6c 74 20 61 6e 64 20 66   difficult and f
01c0: 72 75 73 74 72 61 74 69 6e 67 20 61 63 74 69 76  rustrating activ
01d0: 69 74 79 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 49 6e  ity.<br><br>..In
01e0: 20 6f 72 64 65 72 20 74 6f 20 66 61 63 69 6c 69   order to facili
01f0: 74 61 74 65 20 74 68 65 20 64 65 62 75 67 67 69  tate the debuggi
0200: 6e 67 20 6f 66 20 53 51 4c 20 53 63 72 69 70 74  ng of SQL Script
0210: 73 20 61 73 20 6d 75 63 68 20 61 73 20 70 6f 73  s as much as pos
0220: 73 69 62 6c 65 2c 20 53 70 61 74 69 61 4c 69 74  sible, SpatiaLit
0230: 65 20 28 73 74 61 72 74 69 6e 67 20 73 69 6e 63  e (starting sinc
0240: 65 20 3c 62 3e 76 65 72 73 69 6f 6e 20 35 2e 30  e <b>version 5.0
0250: 2e 30 3c 2f 62 3e 29 20 73 75 70 70 6f 72 74 73  .0</b>) supports
0260: 20 61 20 73 70 65 63 69 66 69 63 20 3c 62 3e 50   a specific <b>P
0270: 61 75 73 65 28 29 3c 2f 62 3e 20 53 51 4c 20 66  ause()</b> SQL f
0280: 75 6e 63 74 69 6f 6e 2e 3c 62 72 3e 0d 0a 54 68  unction.<br>..Th
0290: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69  is function is i
02a0: 6e 74 65 6e 74 65 64 20 74 6f 20 62 65 20 74 68  ntented to be th
02b0: 65 20 63 6f 6e 63 65 70 74 75 61 6c 20 65 71 75  e conceptual equ
02c0: 69 76 61 6c 65 6e 74 20 6f 66 20 77 68 61 74 20  ivalent of what 
02d0: 61 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73  a <a href="https
02e0: 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e  ://en.wikipedia.
02f0: 6f 72 67 2f 77 69 6b 69 2f 42 72 65 61 6b 70 6f  org/wiki/Breakpo
0300: 69 6e 74 22 3e 62 72 65 61 6b 70 6f 69 6e 74 3c  int">breakpoint<
0310: 2f 61 3e 20 69 73 20 69 6e 74 65 6e 64 65 64 20  /a> is intended 
0320: 74 6f 20 62 65 20 66 6f 72 20 6f 72 64 69 6e 61  to be for ordina
0330: 72 79 20 64 65 62 75 67 67 65 72 20 74 6f 6f 6c  ry debugger tool
0340: 73 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 46 65 77 20  s.<br><br>..Few 
0350: 62 61 73 69 63 20 63 6f 6e 63 65 70 74 73 3a 0d  basic concepts:.
0360: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 79 6f 75 2c 20  .<ul>..<li>you, 
0370: 61 73 20 74 68 65 20 64 65 76 65 6c 6f 70 65 72  as the developer
0380: 20 6f 66 20 74 68 65 20 53 51 4c 20 53 63 72 69   of the SQL Scri
0390: 70 74 2c 20 61 72 65 20 66 72 65 65 20 74 6f 20  pt, are free to 
03a0: 63 61 6c 6c 20 3c 62 3e 50 61 75 73 65 28 29 3c  call <b>Pause()<
03b0: 2f 62 3e 20 61 74 20 73 6f 6d 65 20 63 72 69 74  /b> at some crit
03c0: 69 63 61 6c 20 70 6f 69 6e 74 20 6f 66 20 74 68  ical point of th
03d0: 65 20 53 63 72 69 70 74 20 28 3c 69 3e 77 68 65  e Script (<i>whe
03e0: 72 65 20 79 6f 75 20 73 75 73 70 65 63 74 20 74  re you suspect t
03f0: 68 61 74 20 6e 61 73 74 79 20 74 68 69 6e 67 73  hat nasty things
0400: 20 68 61 76 65 20 6a 75 73 74 20 68 61 70 70 65   have just happe
0410: 6e 65 64 3c 2f 69 3e 29 2e 3c 2f 6c 69 3e 0d 0a  ned</i>).</li>..
0420: 3c 6c 69 3e 6f 6e 63 65 20 3c 62 3e 50 61 75 73  <li>once <b>Paus
0430: 65 28 29 3c 2f 62 3e 20 69 73 20 65 78 65 63 75  e()</b> is execu
0440: 74 65 64 20 69 74 20 73 75 64 64 65 6e 6c 79 20  ted it suddenly 
0450: 73 74 6f 70 73 20 61 6e 79 20 66 75 72 74 68 65  stops any furthe
0460: 72 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74  r execution of t
0470: 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65  he calling proce
0480: 73 73 2c 20 74 68 61 74 20 77 69 6c 6c 20 69 6e  ss, that will in
0490: 64 65 66 69 6e 69 74 65 6c 79 20 72 65 6d 61 69  definitely remai
04a0: 6e 20 69 6e 20 61 20 66 72 6f 7a 65 6e 20 73 74  n in a frozen st
04b0: 61 74 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 74  ate.</li>..<li>t
04c0: 68 69 73 20 67 69 76 65 73 20 79 6f 75 20 74 68  his gives you th
04d0: 65 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 74 6f  e opportunity to
04e0: 20 73 74 61 72 74 20 61 20 73 65 63 6f 6e 64 20   start a second 
04f0: 68 69 6e 73 74 61 6e 63 65 20 6f 66 20 53 70 61  hinstance of Spa
0500: 74 69 61 4c 69 74 65 20 74 6f 20 62 65 20 75 73  tiaLite to be us
0510: 65 64 20 66 6f 72 20 69 6e 73 70 65 63 74 69 6e  ed for inspectin
0520: 67 20 61 6e 79 20 70 6f 73 73 69 62 6c 65 20 64  g any possible d
0530: 65 74 61 69 6c 20 69 6e 20 74 68 65 20 77 6f 72  etail in the wor
0540: 6b 20 64 61 74 61 62 61 73 65 2c 3c 62 72 3e 0d  k database,<br>.
0550: 0a 41 6e 64 20 79 6f 75 27 6c 6c 20 62 65 20 65  .And you'll be e
0560: 76 65 6e 74 75 61 6c 6c 79 20 66 72 65 65 20 74  ventually free t
0570: 6f 20 63 6f 72 72 65 63 74 20 6f 6e 20 74 68 65  o correct on the
0580: 20 66 6c 79 20 73 6f 6d 65 20 77 72 6f 6e 67 20   fly some wrong 
0590: 76 61 6c 75 65 20 79 6f 75 27 6c 6c 20 6e 6f 74  value you'll not
05a0: 69 63 65 20 73 6f 6d 65 77 68 65 72 65 2e 3c 2f  ice somewhere.</
05b0: 6c 69 3e 0d 0a 3c 6c 69 3e 77 68 65 6e 20 79 6f  li>..<li>when yo
05c0: 75 27 76 65 20 63 6f 6d 70 6c 65 74 65 64 20 61  u've completed a
05d0: 6c 6c 20 79 6f 75 72 20 64 65 62 75 67 20 61 63  ll your debug ac
05e0: 74 69 76 69 74 69 65 73 2c 20 79 6f 75 20 73 69  tivities, you si
05f0: 6d 70 6c 79 20 68 61 76 65 20 74 6f 20 74 61 6b  mply have to tak
0600: 65 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74  e the appropriat
0610: 65 20 3c 62 3e 63 6f 6e 74 69 6e 75 65 20 61 63  e <b>continue ac
0620: 74 69 6f 6e 3c 2f 62 3e 2c 3c 62 72 3e 0d 0a 54  tion</b>,<br>..T
0630: 68 65 20 53 51 4c 20 53 63 72 69 70 74 20 77 69  he SQL Script wi
0640: 6c 6c 20 74 68 65 6e 20 72 65 73 75 6d 65 20 69  ll then resume i
0650: 74 73 20 6e 6f 72 6d 61 6c 20 65 78 65 63 75 74  ts normal execut
0660: 69 6f 6e 20 65 78 61 63 74 6c 79 20 66 72 6f 6d  ion exactly from
0670: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69   the statement i
0680: 6d 6d 65 64 69 61 74 65 6c 79 20 66 6f 6c 6c 6f  mmediately follo
0690: 77 69 6e 67 20 3c 62 3e 50 61 75 73 65 28 29 3c  wing <b>Pause()<
06a0: 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62  /b></li>..<li><b
06b0: 3e 3c 75 3e 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e  ><u>Note</u></b>
06c0: 3a 20 6e 6f 74 68 69 6e 67 20 66 6f 72 62 69 64  : nothing forbid
06d0: 73 20 74 6f 20 63 61 6c 6c 20 3c 62 3e 50 61 75  s to call <b>Pau
06e0: 73 65 28 29 3c 2f 62 3e 20 61 73 20 6d 61 6e 79  se()</b> as many
06f0: 20 74 69 6d 65 73 20 61 73 20 79 6f 75 20 63 61   times as you ca
0700: 6e 20 66 69 6e 64 20 75 73 65 66 75 6c 20 66 72  n find useful fr
0710: 6f 6d 20 77 69 74 68 69 6e 20 74 68 65 20 73 61  om within the sa
0720: 6d 65 20 53 51 4c 20 53 63 72 69 70 74 2e 3c 2f  me SQL Script.</
0730: 6c 69 3e 20 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72  li> ..</ul>..<br
0740: 3e 0d 0a 3c 74 61 62 6c 65 20 63 65 6c 6c 70 61  >..<table cellpa
0750: 64 64 69 6e 67 3d 22 36 22 20 63 65 6c 6c 73 70  dding="6" cellsp
0760: 61 63 69 6e 67 3d 22 36 22 20 62 67 63 6f 6c 6f  acing="6" bgcolo
0770: 72 3d 22 23 66 66 66 66 64 30 22 3e 0d 0a 3c 74  r="#ffffd0">..<t
0780: 72 3e 3c 74 64 3e 0d 0a 3c 68 33 3e 49 6d 70 6f  r><td>..<h3>Impo
0790: 72 74 61 6e 74 20 6e 6f 74 69 63 65 3a 20 50 61  rtant notice: Pa
07a0: 75 73 65 28 29 20 61 6e 64 20 53 51 4c 20 54 72  use() and SQL Tr
07b0: 61 6e 73 61 63 74 69 6f 6e 73 3c 2f 68 33 3e 0d  ansactions</h3>.
07c0: 0a 3c 62 3e 3c 75 3e 52 65 63 61 6c 6c 3c 2f 75  .<b><u>Recall</u
07d0: 3e 3c 2f 62 3e 3a 20 61 6c 6c 20 63 68 61 6e 67  ></b>: all chang
07e0: 65 73 20 63 6f 6e 74 61 69 6e 65 64 20 77 69 74  es contained wit
07f0: 68 69 6e 20 61 20 3c 62 3e 70 65 6e 64 69 6e 67  hin a <b>pending
0800: 3c 2f 62 3e 20 28 3c 69 3e 61 6b 61 3c 2f 69 3e  </b> (<i>aka</i>
0810: 20 3c 62 3e 75 6e 63 6f 6d 6d 69 74 74 65 64 3c   <b>uncommitted<
0820: 2f 62 3e 29 20 53 51 4c 20 54 72 61 6e 73 61 63  /b>) SQL Transac
0830: 74 69 6f 6e 20 61 72 65 20 73 74 72 69 63 74 6c  tion are strictl
0840: 79 20 70 72 69 76 61 74 65 2e 3c 62 72 3e 0d 0a  y private.<br>..
0850: 54 68 69 73 20 70 72 61 63 74 69 63 61 6c 6c 79  This practically
0860: 20 6d 65 61 6e 73 20 74 68 61 74 20 61 6c 6c 20   means that all 
0870: 74 68 65 6d 20 77 69 6c 6c 20 72 65 6d 61 69 6e  them will remain
0880: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 69 6e 76 69   completely invi
0890: 73 69 62 69 6c 65 20 74 6f 20 61 6e 79 20 6f 74  sibile to any ot
08a0: 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61  her connection a
08b0: 63 63 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d  ccessing the sam
08c0: 65 20 64 61 74 61 62 61 73 65 2e 3c 62 72 3e 0d  e database.<br>.
08d0: 0a 42 75 74 20 61 20 64 65 62 75 67 67 69 6e 67  .But a debugging
08e0: 20 73 65 73 73 69 6f 6e 20 61 73 20 70 72 65 76   session as prev
08f0: 69 6f 75 73 6c 79 20 64 65 66 69 6e 65 64 20 6e  iously defined n
0900: 65 63 65 73 73 61 72 69 6c 79 20 72 65 71 75 69  ecessarily requi
0910: 72 65 73 20 75 73 69 6e 67 20 61 74 20 6c 65 61  res using at lea
0920: 73 74 20 74 77 6f 20 64 69 66 66 65 72 65 6e 74  st two different
0930: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 3c 62 72 3e   connections<br>
0940: 0d 0a 28 3c 69 3e 74 68 65 20 6f 6e 65 20 73 75  ..(<i>the one su
0950: 73 70 65 6e 64 65 64 20 62 79 20 3c 2f 69 3e 3c  spended by </i><
0960: 62 3e 50 61 75 73 65 28 29 3c 2f 62 3e 3c 69 3e  b>Pause()</b><i>
0970: 20 61 6e 64 20 74 68 65 20 6f 74 68 65 72 20 75   and the other u
0980: 73 65 64 20 66 6f 72 20 69 6e 73 70 65 63 74 69  sed for inspecti
0990: 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 3c  ng the database<
09a0: 2f 69 3e 29 2e 3c 62 72 3e 3c 62 72 3e 0d 0a 3c  /i>).<br><br>..<
09b0: 62 3e 3c 75 3e 53 68 6f 72 74 20 63 6f 6e 63 6c  b><u>Short concl
09c0: 75 73 69 6f 6e 3c 2f 75 3e 3c 2f 62 3e 3a 20 74  usion</u></b>: t
09d0: 68 65 20 6f 6e 6c 79 20 73 61 66 65 20 77 61 79  he only safe way
09e0: 20 66 6f 72 20 63 61 6c 6c 69 6e 67 20 3c 62 3e   for calling <b>
09f0: 50 61 75 73 65 28 29 3c 2f 62 3e 20 69 73 20 66  Pause()</b> is f
0a00: 72 6f 6d 20 61 20 70 6f 69 6e 74 20 69 6e 20 74  rom a point in t
0a10: 68 65 20 53 51 4c 20 63 6f 64 65 20 73 75 72 65  he SQL code sure
0a20: 6c 79 20 6f 75 74 73 69 64 65 20 61 6e 79 20 70  ly outside any p
0a30: 65 6e 64 69 6e 67 20 54 72 61 6e 73 61 63 74 69  ending Transacti
0a40: 6f 6e 2e 3c 62 72 3e 0d 0a 54 68 69 73 20 77 69  on.<br>..This wi
0a50: 6c 6c 20 61 76 6f 69 64 20 61 6e 79 20 70 6f 73  ll avoid any pos
0a60: 73 69 62 6c 65 20 76 69 73 69 62 69 6c 69 74 79  sible visibility
0a70: 20 69 73 73 75 65 20 61 6e 64 20 61 6e 79 20 6c   issue and any l
0a80: 6f 63 6b 69 6e 67 20 63 6f 6e 66 6c 69 63 74 20  ocking conflict 
0a90: 62 65 74 77 65 65 6e 20 64 69 66 66 65 72 65 6e  between differen
0aa0: 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 3c 62  t connections.<b
0ab0: 72 3e 0d 0a 41 6c 77 61 79 73 20 72 65 6d 65 6d  r>..Always remem
0ac0: 62 65 72 20 74 6f 20 63 61 72 65 66 75 6c 6c 79  ber to carefully
0ad0: 20 63 68 65 63 6b 20 66 6f 72 20 74 68 69 73 20   check for this 
0ae0: 62 65 66 6f 72 65 20 64 65 66 69 6e 69 6e 67 20  before defining 
0af0: 61 20 63 61 6c 6c 20 74 6f 20 3c 62 3e 50 61 75  a call to <b>Pau
0b00: 73 65 28 29 3c 2f 62 3e 0d 0a 3c 2f 74 64 3e 3c  se()</b>..</td><
0b10: 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 3e 0d 0a 3c  tr>..</table>..<
0b20: 68 33 3e 41 75 78 69 6c 69 61 72 79 20 53 51 4c  h3>Auxiliary SQL
0b30: 20 66 75 6e 63 74 69 6f 6e 73 3c 2f 68 33 3e 0d   functions</h3>.
0b40: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 53 45 4c  .<verbatim>..SEL
0b50: 45 43 54 20 49 73 50 61 75 73 65 45 6e 61 62 6c  ECT IsPauseEnabl
0b60: 65 64 28 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d  ed();..---------
0b70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d  ---------------.
0b80: 0a 30 0d 0a 0d 0a 53 45 4c 45 43 54 20 45 6e 61  .0....SELECT Ena
0b90: 62 6c 65 50 61 75 73 65 28 29 3b 0d 0a 53 45 4c  blePause();..SEL
0ba0: 45 43 54 20 49 73 50 61 75 73 65 45 6e 61 62 6c  ECT IsPauseEnabl
0bb0: 65 64 28 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d  ed();..---------
0bc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d  ---------------.
0bd0: 0a 31 0d 0a 0d 0a 53 45 4c 45 43 54 20 44 69 73  .1....SELECT Dis
0be0: 61 62 6c 65 50 61 75 73 65 28 29 0d 0a 53 45 4c  ablePause()..SEL
0bf0: 45 43 54 20 49 73 50 61 75 73 65 45 6e 61 62 6c  ECT IsPauseEnabl
0c00: 65 64 28 29 3b 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d  ed();..---------
0c10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d  ---------------.
0c20: 0a 30 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e 0d  .0..</verbatim>.
0c30: 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 61 6c 6c 20 63  .<ul>..<li>all c
0c40: 6f 6e 6e 65 63 74 69 6f 6e 73 20 77 69 6c 6c 20  onnections will 
0c50: 69 6e 69 74 69 61 6c 6c 79 20 73 74 61 72 74 20  initially start 
0c60: 62 79 20 6b 65 65 70 69 6e 67 20 3c 62 3e 50 61  by keeping <b>Pa
0c70: 75 73 65 28 29 3c 2f 62 3e 20 64 69 73 61 62 6c  use()</b> disabl
0c80: 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e 3c 62  ed by default.<b
0c90: 72 3e 0d 0a 41 6e 64 20 77 68 65 6e 20 50 61 75  r>..And when Pau
0ca0: 73 65 28 29 20 69 73 20 64 69 73 61 62 6c 65 64  se() is disabled
0cb0: 20 69 74 20 77 69 6c 6c 20 62 65 20 6a 75 73 20   it will be jus 
0cc0: 63 6f 6e 73 69 64 65 72 65 64 20 61 73 20 61 6e  considered as an
0cd0: 20 65 66 66 65 63 74 6c 65 73 73 20 3c 62 3e 6e   effectless <b>n
0ce0: 6f 2d 6f 70 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c  o-op</b></li>..<
0cf0: 6c 69 3e 79 6f 75 20 6d 75 73 74 20 65 78 70 6c  li>you must expl
0d00: 69 63 69 74 6c 79 20 63 61 6c 6c 20 3c 62 3e 45  icitly call <b>E
0d10: 6e 61 62 6c 65 50 61 75 73 65 28 29 3c 2f 62 3e  nablePause()</b>
0d20: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 61   in order to ena
0d30: 62 6c 65 20 50 61 75 73 65 28 29 20 74 6f 20 65  ble Pause() to e
0d40: 66 66 65 63 74 69 76 65 6c 79 20 77 6f 72 6b 2e  ffectively work.
0d50: 3c 62 72 3e 0d 0a 4f 6e 63 65 20 74 68 61 74 20  <br>..Once that 
0d60: 50 61 75 73 65 28 29 20 69 73 20 65 6e 61 62 6c  Pause() is enabl
0d70: 65 64 20 74 68 69 73 20 73 65 74 74 69 6e 67 20  ed this setting 
0d80: 77 69 6c 6c 20 70 65 72 73 69 73 74 20 75 6e 74  will persist unt
0d90: 69 6c 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68  il the end of th
0da0: 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 6e 65 63  e current connec
0db0: 74 69 6f 6e 20 6c 69 66 65 20 63 79 63 6c 65 2e  tion life cycle.
0dc0: 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 79 6f 75 20 63  </li>..<li>you c
0dd0: 61 6e 20 65 76 65 6e 74 75 61 6c 6c 79 20 63 61  an eventually ca
0de0: 6c 6c 20 3c 62 3e 44 69 73 61 62 6c 65 50 61 75  ll <b>DisablePau
0df0: 73 65 28 29 3c 2f 62 3e 20 74 6f 20 72 65 76 65  se()</b> to reve
0e00: 72 74 20 62 61 63 6b 20 74 6f 20 74 68 65 20 64  rt back to the d
0e10: 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 75 72  efault behaviour
0e20: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 79 6f 75 20  .</li>..<li>you 
0e30: 63 61 6e 20 63 61 6c 6c 20 3c 62 3e 49 73 50 61  can call <b>IsPa
0e40: 75 73 65 45 6e 61 62 6c 65 64 28 29 3c 2f 62 3e  useEnabled()</b>
0e50: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 63 68 65   in order to che
0e60: 63 6b 20 69 66 20 50 61 75 73 65 28 29 20 69 73  ck if Pause() is
0e70: 20 63 75 72 72 65 6e 74 6c 79 20 65 6e 61 62 6c   currently enabl
0e80: 65 64 20 6f 72 20 6e 6f 74 2e 3c 2f 6c 69 3e 0d  ed or not.</li>.
0e90: 0a 3c 2f 75 6c 3e 3c 62 72 3e 0d 0a 3c 68 72 3e  .</ul><br>..<hr>
0ea0: 0d 0a 3c 68 31 3e 41 20 70 72 61 63 74 69 63 61  ..<h1>A practica
0eb0: 6c 20 65 78 61 6d 70 6c 65 20 6f 66 20 75 73 69  l example of usi
0ec0: 6e 67 20 50 61 75 73 65 28 29 3c 2f 68 31 3e 0d  ng Pause()</h1>.
0ed0: 0a 3c 76 65 72 62 61 74 69 6d 3e 0d 0a 2d 2d 20  .<verbatim>..-- 
0ee0: 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 20 74  creating a new t
0ef0: 61 62 6c 65 0d 0a 43 52 45 41 54 45 20 54 41 42  able..CREATE TAB
0f00: 4c 45 20 74 65 73 74 20 28 0d 0a 20 20 20 20 69  LE test (..    i
0f10: 64 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52  d INTEGER PRIMAR
0f20: 59 20 4b 45 59 2c 0d 0a 20 20 20 20 6e 61 6d 65  Y KEY,..    name
0f30: 20 54 45 58 54 20 4e 4f 54 20 4e 55 4c 4c 29 3b   TEXT NOT NULL);
0f40: 0d 0a 0d 0a 2d 2d 20 73 74 61 72 74 69 6e 67 20  ....-- starting 
0f50: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 0d 0a 42  a transaction..B
0f60: 45 47 49 4e 3b 0d 0a 2d 2d 20 69 6e 73 65 72 74  EGIN;..-- insert
0f70: 69 6e 67 20 73 6f 6d 65 20 72 6f 77 73 20 69 6e  ing some rows in
0f80: 74 6f 20 74 68 65 20 61 62 6f 76 65 20 74 61 62  to the above tab
0f90: 6c 65 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20  le..INSERT INTO 
0fa0: 74 65 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c  test VALUES(NULL
0fb0: 2c 20 27 6f 6e 65 27 29 3b 0d 0a 49 4e 53 45 52  , 'one');..INSER
0fc0: 54 20 49 4e 54 4f 20 74 65 73 74 20 56 41 4c 55  T INTO test VALU
0fd0: 45 53 28 4e 55 4c 4c 2c 20 27 74 77 6f 27 29 3b  ES(NULL, 'two');
0fe0: 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 65  ..INSERT INTO te
0ff0: 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c 20  st VALUES(NULL, 
1000: 27 74 68 72 65 65 27 29 3b 0d 0a 49 4e 53 45 52  'three');..INSER
1010: 54 20 49 4e 54 4f 20 74 65 73 74 20 56 41 4c 55  T INTO test VALU
1020: 45 53 28 4e 55 4c 4c 2c 20 27 66 6f 75 72 27 29  ES(NULL, 'four')
1030: 3b 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74  ;..INSERT INTO t
1040: 65 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c  est VALUES(NULL,
1050: 20 27 66 69 76 65 27 29 3b 0d 0a 2d 2d 20 63 6f   'five');..-- co
1060: 6d 6d 69 74 74 69 6e 67 20 74 68 65 20 70 65 6e  mmitting the pen
1070: 64 69 6e 67 20 74 72 61 6e 73 61 63 74 69 6f 6e  ding transaction
1080: 0d 0a 43 4f 4d 4d 49 54 3b 0d 0a 2d 2d 20 74 68  ..COMMIT;..-- th
1090: 65 6e 20 70 61 75 73 69 6e 67 0d 0a 53 45 4c 45  en pausing..SELE
10a0: 43 54 20 50 61 75 73 65 28 29 3b 0d 0a 0d 0a 2d  CT Pause();....-
10b0: 2d 20 69 6e 73 65 72 74 69 6e 67 20 6d 6f 72 65  - inserting more
10c0: 20 72 6f 77 73 2c 20 74 68 65 6e 20 70 61 75 73   rows, then paus
10d0: 69 6e 67 20 61 67 61 69 6e 0d 0a 42 45 47 49 4e  ing again..BEGIN
10e0: 3b 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74  ;..INSERT INTO t
10f0: 65 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c  est VALUES(NULL,
1100: 20 27 73 69 78 27 29 3b 0d 0a 49 4e 53 45 52 54   'six');..INSERT
1110: 20 49 4e 54 4f 20 74 65 73 74 20 56 41 4c 55 45   INTO test VALUE
1120: 53 28 4e 55 4c 4c 2c 20 27 73 65 76 65 6e 27 29  S(NULL, 'seven')
1130: 3b 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74  ;..INSERT INTO t
1140: 65 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c  est VALUES(NULL,
1150: 20 27 65 69 67 68 74 27 29 3b 0d 0a 49 4e 53 45   'eight');..INSE
1160: 52 54 20 49 4e 54 4f 20 74 65 73 74 20 56 41 4c  RT INTO test VAL
1170: 55 45 53 28 4e 55 4c 4c 2c 20 27 6e 69 6e 65 27  UES(NULL, 'nine'
1180: 29 3b 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20  );..INSERT INTO 
1190: 74 65 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c  test VALUES(NULL
11a0: 2c 20 27 74 65 6e 27 29 3b 0d 0a 43 4f 4d 4d 49  , 'ten');..COMMI
11b0: 54 3b 0d 0a 53 45 4c 45 43 54 20 50 61 75 73 65  T;..SELECT Pause
11c0: 28 29 3b 0d 0a 0d 0a 2d 2d 20 69 6e 73 65 72 74  ();....-- insert
11d0: 69 6e 67 20 74 68 65 20 6c 61 73 74 20 62 6c 6f  ing the last blo
11e0: 63 6b 20 6f 66 20 72 6f 77 73 2c 20 74 68 65 6e  ck of rows, then
11f0: 20 65 78 69 74 69 6e 67 0d 0a 42 45 47 49 4e 3b   exiting..BEGIN;
1200: 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 65  ..INSERT INTO te
1210: 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c 20  st VALUES(NULL, 
1220: 27 65 6c 65 76 65 6e 27 29 3b 0d 0a 49 4e 53 45  'eleven');..INSE
1230: 52 54 20 49 4e 54 4f 20 74 65 73 74 20 56 41 4c  RT INTO test VAL
1240: 55 45 53 28 4e 55 4c 4c 2c 20 27 74 77 65 6c 66  UES(NULL, 'twelf
1250: 65 27 29 3b 0d 0a 49 4e 53 45 52 54 20 49 4e 54  e');..INSERT INT
1260: 4f 20 74 65 73 74 20 56 41 4c 55 45 53 28 4e 55  O test VALUES(NU
1270: 4c 4c 2c 20 27 74 68 69 72 74 65 65 6e 27 29 3b  LL, 'thirteen');
1280: 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 65  ..INSERT INTO te
1290: 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c 20  st VALUES(NULL, 
12a0: 27 66 6f 75 72 74 65 65 6e 27 29 3b 0d 0a 49 4e  'fourteen');..IN
12b0: 53 45 52 54 20 49 4e 54 4f 20 74 65 73 74 20 56  SERT INTO test V
12c0: 41 4c 55 45 53 28 4e 55 4c 4c 2c 20 27 66 69 66  ALUES(NULL, 'fif
12d0: 74 65 65 6e 27 29 3b 0d 0a 49 4e 53 45 52 54 20  teen');..INSERT 
12e0: 49 4e 54 4f 20 74 65 73 74 20 56 41 4c 55 45 53  INTO test VALUES
12f0: 28 4e 55 4c 4c 2c 20 27 73 69 78 74 65 65 6e 27  (NULL, 'sixteen'
1300: 29 3b 0d 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20  );..INSERT INTO 
1310: 74 65 73 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c  test VALUES(NULL
1320: 2c 20 27 73 65 76 65 6e 74 65 65 6e 27 29 3b 0d  , 'seventeen');.
1330: 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 65 73  .INSERT INTO tes
1340: 74 20 56 41 4c 55 45 53 28 4e 55 4c 4c 2c 20 27  t VALUES(NULL, '
1350: 65 69 67 68 74 65 65 6e 27 29 3b 0d 0a 49 4e 53  eighteen');..INS
1360: 45 52 54 20 49 4e 54 4f 20 74 65 73 74 20 56 41  ERT INTO test VA
1370: 4c 55 45 53 28 4e 55 4c 4c 2c 20 27 6e 69 6e 65  LUES(NULL, 'nine
1380: 74 65 65 6e 27 29 3b 0d 0a 49 4e 53 45 52 54 20  teen');..INSERT 
1390: 49 4e 54 4f 20 74 65 73 74 20 56 41 4c 55 45 53  INTO test VALUES
13a0: 28 4e 55 4c 4c 2c 20 27 74 77 65 6e 74 79 27 29  (NULL, 'twenty')
13b0: 3b 0d 0a 43 4f 4d 4d 49 54 3b 0d 0a 0d 0a 2d 2d  ;..COMMIT;....--
13c0: 20 65 6e 64 20 6a 6f 62 20 2d 20 61 6c 6c 20 64   end job - all d
13d0: 6f 6e 65 0d 0a 3c 2f 76 65 72 62 61 74 69 6d 3e  one..</verbatim>
13e0: 0d 0a 3c 62 72 3e 0d 0a 54 68 69 73 20 69 73 20  ..<br>..This is 
13f0: 61 20 76 65 72 79 20 73 69 6d 70 6c 65 20 28 61  a very simple (a
1400: 6e 64 20 73 74 75 70 69 64 29 20 53 51 4c 20 53  nd stupid) SQL S
1410: 63 72 69 70 74 2c 20 62 75 74 20 69 74 27 73 20  cript, but it's 
1420: 65 6e 6f 75 67 68 20 74 6f 20 70 72 61 63 74 69  enough to practi
1430: 63 61 6c 6c 79 20 74 65 73 74 20 68 6f 77 20 3c  cally test how <
1440: 62 3e 50 61 75 73 65 28 29 3c 2f 62 3e 20 77 6f  b>Pause()</b> wo
1450: 72 6b 73 2e 3c 62 72 3e 0d 0a 3c 62 3e 3c 75 3e  rks.<br>..<b><u>
1460: 4e 6f 74 65 3c 2f 75 3e 3c 2f 62 3e 3a 20 74 68  Note</u></b>: th
1470: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  e implementation
1480: 20 6f 66 20 3c 62 3e 50 61 75 73 65 28 29 3c 2f   of <b>Pause()</
1490: 62 3e 20 61 6c 6d 6f 73 74 20 63 6f 6d 70 6c 65  b> almost comple
14a0: 74 65 6c 79 20 64 69 66 66 65 72 73 20 6f 6e 20  tely differs on 
14b0: 4c 69 6e 75 78 20 61 6e 64 20 57 69 6e 64 6f 77  Linux and Window
14c0: 73 3b 20 70 6c 65 61 73 65 20 72 65 61 64 20 74  s; please read t
14d0: 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 73  he appropriate s
14e0: 65 63 74 69 6f 6e 2e 3c 62 72 3e 3c 62 72 3e 0d  ection.<br><br>.
14f0: 0a 3c 68 72 3e 0d 0a 3c 68 33 3e 55 73 69 6e 67  .<hr>..<h3>Using
1500: 20 50 61 75 73 65 28 29 20 6f 6e 20 4c 69 6e 75   Pause() on Linu
1510: 78 3c 2f 68 33 3e 0d 0a 54 68 65 20 4c 69 6e 75  x</h3>..The Linu
1520: 78 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  x implementation
1530: 20 69 73 20 66 75 6c 6c 79 20 62 61 73 65 64 20   is fully based 
1540: 6f 6e 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70  on <a href="http
1550: 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61  s://en.wikipedia
1560: 2e 6f 72 67 2f 77 69 6b 69 2f 53 69 67 6e 61 6c  .org/wiki/Signal
1570: 5f 28 49 50 43 29 23 50 4f 53 49 58 5f 73 69 67  _(IPC)#POSIX_sig
1580: 6e 61 6c 73 22 3e 73 79 73 74 65 6d 20 73 69 67  nals">system sig
1590: 6e 61 6c 73 3c 2f 61 3e 3b 20 74 68 65 20 73 61  nals</a>; the sa
15a0: 6d 65 20 61 70 70 72 6f 61 63 68 20 61 70 70 6c  me approach appl
15b0: 69 65 73 20 74 6f 20 61 6e 79 20 55 6e 69 78 20  ies to any Unix 
15c0: 61 6e 64 20 55 6e 69 78 2d 6c 69 6b 65 20 73 79  and Unix-like sy
15d0: 73 74 65 6d 2c 20 74 68 69 73 20 69 6e 63 6c 75  stem, this inclu
15e0: 64 69 6e 67 20 4d 61 63 20 4f 53 20 58 2e 3c 62  ding Mac OS X.<b
15f0: 72 3e 0d 0a 4d 6f 72 65 20 73 70 65 63 69 66 69  r>..More specifi
1600: 63 61 6c 6c 79 20 69 74 27 73 20 62 61 73 65 64  cally it's based
1610: 20 6f 6e 20 3c 62 3e 53 49 47 53 54 4f 50 3c 2f   on <b>SIGSTOP</
1620: 62 3e 20 61 6e 64 20 3c 62 3e 53 49 47 43 4f 4e  b> and <b>SIGCON
1630: 54 3c 2f 62 3e 20 73 69 67 6e 61 6c 73 3a 0d 0a  T</b> signals:..
1640: 3c 6c 69 3e 3c 62 3e 53 49 47 53 54 4f 50 3c 2f  <li><b>SIGSTOP</
1650: 62 3e 20 69 6e 73 74 72 75 63 74 73 20 74 68 65  b> instructs the
1660: 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65   operating syste
1670: 6d 20 74 6f 20 73 74 6f 70 20 74 68 65 20 63 61  m to stop the ca
1680: 6c 6c 69 6e 67 20 70 72 6f 63 65 73 73 20 66 6f  lling process fo
1690: 72 20 6c 61 74 65 72 20 72 65 73 75 6d 70 74 69  r later resumpti
16a0: 6f 6e 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 62  on.</li>..<li><b
16b0: 3e 53 49 47 43 4f 4e 54 3c 2f 62 3e 20 69 6e 73  >SIGCONT</b> ins
16c0: 74 72 75 63 74 73 20 74 68 65 20 6f 70 65 72 61  tructs the opera
16d0: 74 69 6e 67 20 73 79 73 74 65 6d 20 74 6f 20 63  ting system to c
16e0: 6f 6e 74 69 6e 75 65 20 28 72 65 73 74 61 72 74  ontinue (restart
16f0: 29 20 74 68 65 20 70 72 6f 63 65 73 73 20 70 72  ) the process pr
1700: 65 76 69 6f 75 73 6c 79 20 70 61 75 73 65 64 20  eviously paused 
1710: 62 79 20 74 68 65 20 53 49 47 53 54 4f 50 2e 3c  by the SIGSTOP.<
1720: 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 62 72  /li>..</ul>..<br
1730: 3e 3c 62 72 3e 0d 0a 3c 68 72 3e 0d 0a 3c 68 33  ><br>..<hr>..<h3
1740: 3e 55 73 69 6e 67 20 50 61 75 73 65 28 29 20 6f  >Using Pause() o
1750: 6e 20 57 69 6e 64 6f 77 73 3c 2f 68 33 3e 0d 0a  n Windows</h3>..
1760: 54 68 65 20 57 69 6e 64 6f 77 73 20 69 6d 70 6c  The Windows impl
1770: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 62 61  ementation is ba
1780: 73 65 64 20 6f 6e 20 74 68 65 20 3c 61 20 68 72  sed on the <a hr
1790: 65 66 3d 22 68 74 74 70 73 3a 2f 2f 64 6f 63 73  ef="https://docs
17a0: 2e 6d 69 63 72 6f 73 6f 66 74 2e 63 6f 6d 2f 65  .microsoft.com/e
17b0: 6e 2d 75 73 2f 77 69 6e 64 6f 77 73 2f 63 6f 6e  n-us/windows/con
17c0: 73 6f 6c 65 2f 72 65 61 64 63 6f 6e 73 6f 6c 65  sole/readconsole
17d0: 69 6e 70 75 74 22 3e 52 65 61 64 43 6f 6e 73 6f  input">ReadConso
17e0: 6c 65 49 6e 70 75 74 28 29 3c 2f 61 3e 20 73 79  leInput()</a> sy
17f0: 73 74 65 6d 20 41 50 49 2e 3c 62 72 3e 3c 62 72  stem API.<br><br
1800: 3e 0d 0a 3c 62 3e 3c 75 3e 4e 6f 74 65 3c 2f 75  >..<b><u>Note</u
1810: 3e 3c 2f 62 3e 3a 20 74 68 65 72 65 20 69 73 20  ></b>: there is 
1820: 61 20 73 74 72 69 6b 69 6e 67 20 64 69 66 66 65  a striking diffe
1830: 72 65 6e 63 65 20 66 72 6f 6d 20 74 68 65 20 55  rence from the U
1840: 6e 69 78 2f 4c 69 6e 75 78 20 61 70 70 72 6f 61  nix/Linux approa
1850: 63 68 2e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 6f  ch...<ul>..<li>o
1860: 6e 20 4c 69 6e 75 78 20 65 76 65 72 79 20 70 72  n Linux every pr
1870: 6f 63 65 73 73 20 77 69 6c 6c 20 61 6c 77 61 79  ocess will alway
1880: 73 20 72 65 73 70 65 63 74 20 73 79 73 74 65 6d  s respect system
1890: 20 73 69 67 6e 61 6c 73 20 73 75 63 68 20 61 73   signals such as
18a0: 20 53 49 47 53 54 4f 50 20 61 6e 64 20 53 49 47   SIGSTOP and SIG
18b0: 43 4f 4e 54 2c 20 77 69 74 68 20 6e 6f 20 70 6f  CONT, with no po
18c0: 73 73 69 62 6c 65 20 65 78 63 65 70 74 69 6f 6e  ssible exception
18d0: 2e 3c 62 72 3e 0d 0a 41 6e 64 20 74 68 69 73 20  .<br>..And this 
18e0: 69 6e 64 69 66 66 65 72 65 6e 74 6c 79 20 61 70  indifferently ap
18f0: 70 6c 69 65 73 20 74 6f 20 62 6f 74 68 20 43 4c  plies to both CL
1900: 49 20 61 6e 64 20 47 55 49 20 61 70 70 6c 69 63  I and GUI applic
1910: 61 74 69 6f 6e 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c  ations.</li>..<l
1920: 69 3e 6f 6e 20 57 69 6e 64 6f 77 73 20 61 64 6f  i>on Windows ado
1930: 70 74 69 6e 67 20 61 6e 20 61 70 70 72 6f 61 63  pting an approac
1940: 68 20 62 61 73 65 64 20 6f 6e 20 43 6f 6e 73 6f  h based on Conso
1950: 6c 65 20 49 6e 70 75 74 20 69 6d 70 6c 69 65 73  le Input implies
1960: 20 74 77 6f 20 72 65 6c 65 76 61 6e 74 20 6c 69   two relevant li
1970: 6d 69 74 61 74 69 6f 6e 73 3a 0d 0a 3c 75 6c 3e  mitations:..<ul>
1980: 0d 0a 3c 6c 69 3e 6f 6e 6c 79 20 61 20 70 72 6f  ..<li>only a pro
1990: 63 65 73 73 20 73 74 61 72 74 65 64 20 66 72 6f  cess started fro
19a0: 6d 20 74 68 65 20 3c 62 3e 43 4d 44 2e 65 78 65  m the <b>CMD.exe
19b0: 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 73 68 65  </b> command she
19c0: 6c 6c 20 63 61 6e 20 68 61 76 65 20 69 74 73 20  ll can have its 
19d0: 6f 77 6e 20 43 6f 6e 73 6f 6c 65 2e 3c 62 72 3e  own Console.<br>
19e0: 0d 0a 42 75 74 20 61 20 70 72 6f 63 65 73 73 20  ..But a process 
19f0: 73 74 61 72 74 65 64 20 62 79 20 64 69 72 65 63  started by direc
1a00: 74 6c 79 20 63 6c 69 63 6b 69 6e 67 20 74 68 65  tly clicking the
1a10: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 69   corresponding i
1a20: 63 6f 6e 20 77 69 6c 6c 20 6e 65 76 65 72 20 62  con will never b
1a30: 65 20 63 6f 6e 6e 65 63 74 65 64 20 74 6f 20 61  e connected to a
1a40: 20 43 6f 6e 73 6f 6c 65 2c 20 61 6e 64 20 63 6f   Console, and co
1a50: 6e 73 65 71 75 65 6e 74 6c 79 20 3c 62 3e 50 61  nsequently <b>Pa
1a60: 75 73 65 28 29 3c 2f 62 3e 20 77 69 6c 6c 20 6e  use()</b> will n
1a70: 65 76 65 72 20 77 6f 72 6b 2e 3c 2f 6c 69 3e 0d  ever work.</li>.
1a80: 0a 3c 6c 69 3e 41 6e 64 20 65 76 65 6e 20 69 6e  .<li>And even in
1a90: 20 74 68 65 20 63 61 73 65 20 6f 66 20 61 20 70   the case of a p
1aa0: 72 6f 63 65 73 73 20 73 74 61 72 74 65 64 20 62  rocess started b
1ab0: 79 20 3c 62 3e 43 4d 44 2e 65 78 65 3c 2f 62 3e  y <b>CMD.exe</b>
1ac0: 20 61 6e 20 65 76 65 6e 74 75 61 6c 20 72 65 64   an eventual red
1ad0: 69 72 65 63 74 69 6f 6e 20 6f 66 20 74 68 65 20  irection of the 
1ae0: 3c 62 3e 53 74 61 6e 64 61 72 64 20 49 6e 70 75  <b>Standard Inpu
1af0: 74 3c 2f 62 3e 20 77 69 6c 6c 20 66 6f 72 62 69  t</b> will forbi
1b00: 64 20 61 20 77 6f 72 6b 69 6e 67 20 3c 62 3e 50  d a working <b>P
1b10: 61 75 73 65 28 29 3c 2f 62 3e 2e 3c 2f 6c 69 3e  ause()</b>.</li>
1b20: 0d 0a 3c 2f 75 6c 3e 3c 2f 6c 69 3e 0d 0a 3c 2f  ..</ul></li>..</
1b30: 75 6c 3e 0d 0a 0d 0a 3c 62 72 3e 3c 62 72 3e 0d  ul>....<br><br>.
1b40: 0a 3c 68 72 3e 3c 62 72 3e 0d 0a 3c 61 20 68 72  .<hr><br>..<a hr
1b50: 65 66 3d 22 68 74 74 70 73 3a 2f 2f 77 77 77 2e  ef="https://www.
1b60: 67 61 69 61 2d 67 69 73 2e 69 74 2f 66 6f 73 73  gaia-gis.it/foss
1b70: 69 6c 2f 6c 69 62 73 70 61 74 69 61 6c 69 74 65  il/libspatialite
1b80: 2f 77 69 6b 69 3f 6e 61 6d 65 3d 34 2e 33 2e 30  /wiki?name=4.3.0
1b90: 2d 64 6f 63 22 3e 62 61 63 6b 3c 2f 61 3e 0a 5a  -doc">back</a>.Z
1ba0: 20 34 37 31 33 32 61 37 30 61 34 63 34 30 65 38   47132a70a4c40e8
1bb0: 37 63 37 62 62 61 63 61 33 62 66 32 32 32 63 36  7c7bbaca3bf222c6
1bc0: 33 0a                                            3.