Home » Archimedes archive » Acorn User » AU 1995-04.adf » !Internet_StarterPak » !SLIPdial/Resources/UK/Help/taskwindow

!SLIPdial/Resources/UK/Help/taskwindow

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1995-04.adf » !Internet_StarterPak
Filename: !SLIPdial/Resources/UK/Help/taskwindow
Read OK:
File size: 052D bytes
Load address: 0000
Exec address: 0000
File contents
taskwindow [/name=<name>] [/size=<nK>] [/exit=<command>] [/wait] [/keep]
                [/output=<filename>] "<external command>"
 Starts a taskwindow process.
 /name  name for task manager (default is "SDtaskn", where n is a number).
 /size  sets wimpslot size for task (default is size of "Next" slot).
 /exit  defines command to execute when task terminates
 /output    sets file to store output in (if no file specified, all output
        goes to a buffer window).
 /nooutput  prevents an output window from being opened, though the data
        is still buffered internally as if a window were present.
 /wait  forces the script to wait for the started task to finish. Otherwise,
        script execution continues as soon as the task starts (the "/exit"
        command, if any, being added to the event queue when the task
        finishes).
 /keep  causes the buffer window, if any, to be kept onscreen after the
        task finishes. Otherwise, the window is deleted as the task exits.
        The slipdial taskwindow "slot" cannot be re-used until the window
        is closed.
 It is possible to combine the "/wait" and "/exit" qualifiers, but also
 pointless!

taskwindow /kill=<id>
 kills the given taskwindow.

taskwindow /suspend=<id>
taskwindow /resume=<id>
 these commands suspend or resume a taskwindow.
00000000  74 61 73 6b 77 69 6e 64  6f 77 20 5b 2f 6e 61 6d  |taskwindow [/nam|
00000010  65 3d 3c 6e 61 6d 65 3e  5d 20 5b 2f 73 69 7a 65  |e=<name>] [/size|
00000020  3d 3c 6e 4b 3e 5d 20 5b  2f 65 78 69 74 3d 3c 63  |=<nK>] [/exit=<c|
00000030  6f 6d 6d 61 6e 64 3e 5d  20 5b 2f 77 61 69 74 5d  |ommand>] [/wait]|
00000040  20 5b 2f 6b 65 65 70 5d  0a 20 20 20 20 20 20 20  | [/keep].       |
00000050  20 20 20 20 20 20 20 20  20 5b 2f 6f 75 74 70 75  |         [/outpu|
00000060  74 3d 3c 66 69 6c 65 6e  61 6d 65 3e 5d 20 22 3c  |t=<filename>] "<|
00000070  65 78 74 65 72 6e 61 6c  20 63 6f 6d 6d 61 6e 64  |external command|
00000080  3e 22 0a 20 53 74 61 72  74 73 20 61 20 74 61 73  |>". Starts a tas|
00000090  6b 77 69 6e 64 6f 77 20  70 72 6f 63 65 73 73 2e  |kwindow process.|
000000a0  0a 20 2f 6e 61 6d 65 20  20 6e 61 6d 65 20 66 6f  |. /name  name fo|
000000b0  72 20 74 61 73 6b 20 6d  61 6e 61 67 65 72 20 28  |r task manager (|
000000c0  64 65 66 61 75 6c 74 20  69 73 20 22 53 44 74 61  |default is "SDta|
000000d0  73 6b 6e 22 2c 20 77 68  65 72 65 20 6e 20 69 73  |skn", where n is|
000000e0  20 61 20 6e 75 6d 62 65  72 29 2e 0a 20 2f 73 69  | a number).. /si|
000000f0  7a 65 20 20 73 65 74 73  20 77 69 6d 70 73 6c 6f  |ze  sets wimpslo|
00000100  74 20 73 69 7a 65 20 66  6f 72 20 74 61 73 6b 20  |t size for task |
00000110  28 64 65 66 61 75 6c 74  20 69 73 20 73 69 7a 65  |(default is size|
00000120  20 6f 66 20 22 4e 65 78  74 22 20 73 6c 6f 74 29  | of "Next" slot)|
00000130  2e 0a 20 2f 65 78 69 74  20 20 64 65 66 69 6e 65  |.. /exit  define|
00000140  73 20 63 6f 6d 6d 61 6e  64 20 74 6f 20 65 78 65  |s command to exe|
00000150  63 75 74 65 20 77 68 65  6e 20 74 61 73 6b 20 74  |cute when task t|
00000160  65 72 6d 69 6e 61 74 65  73 0a 20 2f 6f 75 74 70  |erminates. /outp|
00000170  75 74 20 20 20 20 73 65  74 73 20 66 69 6c 65 20  |ut    sets file |
00000180  74 6f 20 73 74 6f 72 65  20 6f 75 74 70 75 74 20  |to store output |
00000190  69 6e 20 28 69 66 20 6e  6f 20 66 69 6c 65 20 73  |in (if no file s|
000001a0  70 65 63 69 66 69 65 64  2c 20 61 6c 6c 20 6f 75  |pecified, all ou|
000001b0  74 70 75 74 0a 20 20 20  20 20 20 20 20 67 6f 65  |tput.        goe|
000001c0  73 20 74 6f 20 61 20 62  75 66 66 65 72 20 77 69  |s to a buffer wi|
000001d0  6e 64 6f 77 29 2e 0a 20  2f 6e 6f 6f 75 74 70 75  |ndow).. /nooutpu|
000001e0  74 20 20 70 72 65 76 65  6e 74 73 20 61 6e 20 6f  |t  prevents an o|
000001f0  75 74 70 75 74 20 77 69  6e 64 6f 77 20 66 72 6f  |utput window fro|
00000200  6d 20 62 65 69 6e 67 20  6f 70 65 6e 65 64 2c 20  |m being opened, |
00000210  74 68 6f 75 67 68 20 74  68 65 20 64 61 74 61 0a  |though the data.|
00000220  20 20 20 20 20 20 20 20  69 73 20 73 74 69 6c 6c  |        is still|
00000230  20 62 75 66 66 65 72 65  64 20 69 6e 74 65 72 6e  | buffered intern|
00000240  61 6c 6c 79 20 61 73 20  69 66 20 61 20 77 69 6e  |ally as if a win|
00000250  64 6f 77 20 77 65 72 65  20 70 72 65 73 65 6e 74  |dow were present|
00000260  2e 0a 20 2f 77 61 69 74  20 20 66 6f 72 63 65 73  |.. /wait  forces|
00000270  20 74 68 65 20 73 63 72  69 70 74 20 74 6f 20 77  | the script to w|
00000280  61 69 74 20 66 6f 72 20  74 68 65 20 73 74 61 72  |ait for the star|
00000290  74 65 64 20 74 61 73 6b  20 74 6f 20 66 69 6e 69  |ted task to fini|
000002a0  73 68 2e 20 4f 74 68 65  72 77 69 73 65 2c 0a 20  |sh. Otherwise,. |
000002b0  20 20 20 20 20 20 20 73  63 72 69 70 74 20 65 78  |       script ex|
000002c0  65 63 75 74 69 6f 6e 20  63 6f 6e 74 69 6e 75 65  |ecution continue|
000002d0  73 20 61 73 20 73 6f 6f  6e 20 61 73 20 74 68 65  |s as soon as the|
000002e0  20 74 61 73 6b 20 73 74  61 72 74 73 20 28 74 68  | task starts (th|
000002f0  65 20 22 2f 65 78 69 74  22 0a 20 20 20 20 20 20  |e "/exit".      |
00000300  20 20 63 6f 6d 6d 61 6e  64 2c 20 69 66 20 61 6e  |  command, if an|
00000310  79 2c 20 62 65 69 6e 67  20 61 64 64 65 64 20 74  |y, being added t|
00000320  6f 20 74 68 65 20 65 76  65 6e 74 20 71 75 65 75  |o the event queu|
00000330  65 20 77 68 65 6e 20 74  68 65 20 74 61 73 6b 0a  |e when the task.|
00000340  20 20 20 20 20 20 20 20  66 69 6e 69 73 68 65 73  |        finishes|
00000350  29 2e 0a 20 2f 6b 65 65  70 20 20 63 61 75 73 65  |).. /keep  cause|
00000360  73 20 74 68 65 20 62 75  66 66 65 72 20 77 69 6e  |s the buffer win|
00000370  64 6f 77 2c 20 69 66 20  61 6e 79 2c 20 74 6f 20  |dow, if any, to |
00000380  62 65 20 6b 65 70 74 20  6f 6e 73 63 72 65 65 6e  |be kept onscreen|
00000390  20 61 66 74 65 72 20 74  68 65 0a 20 20 20 20 20  | after the.     |
000003a0  20 20 20 74 61 73 6b 20  66 69 6e 69 73 68 65 73  |   task finishes|
000003b0  2e 20 4f 74 68 65 72 77  69 73 65 2c 20 74 68 65  |. Otherwise, the|
000003c0  20 77 69 6e 64 6f 77 20  69 73 20 64 65 6c 65 74  | window is delet|
000003d0  65 64 20 61 73 20 74 68  65 20 74 61 73 6b 20 65  |ed as the task e|
000003e0  78 69 74 73 2e 0a 20 20  20 20 20 20 20 20 54 68  |xits..        Th|
000003f0  65 20 73 6c 69 70 64 69  61 6c 20 74 61 73 6b 77  |e slipdial taskw|
00000400  69 6e 64 6f 77 20 22 73  6c 6f 74 22 20 63 61 6e  |indow "slot" can|
00000410  6e 6f 74 20 62 65 20 72  65 2d 75 73 65 64 20 75  |not be re-used u|
00000420  6e 74 69 6c 20 74 68 65  20 77 69 6e 64 6f 77 0a  |ntil the window.|
00000430  20 20 20 20 20 20 20 20  69 73 20 63 6c 6f 73 65  |        is close|
00000440  64 2e 0a 20 49 74 20 69  73 20 70 6f 73 73 69 62  |d.. It is possib|
00000450  6c 65 20 74 6f 20 63 6f  6d 62 69 6e 65 20 74 68  |le to combine th|
00000460  65 20 22 2f 77 61 69 74  22 20 61 6e 64 20 22 2f  |e "/wait" and "/|
00000470  65 78 69 74 22 20 71 75  61 6c 69 66 69 65 72 73  |exit" qualifiers|
00000480  2c 20 62 75 74 20 61 6c  73 6f 0a 20 70 6f 69 6e  |, but also. poin|
00000490  74 6c 65 73 73 21 0a 0a  74 61 73 6b 77 69 6e 64  |tless!..taskwind|
000004a0  6f 77 20 2f 6b 69 6c 6c  3d 3c 69 64 3e 0a 20 6b  |ow /kill=<id>. k|
000004b0  69 6c 6c 73 20 74 68 65  20 67 69 76 65 6e 20 74  |ills the given t|
000004c0  61 73 6b 77 69 6e 64 6f  77 2e 0a 0a 74 61 73 6b  |askwindow...task|
000004d0  77 69 6e 64 6f 77 20 2f  73 75 73 70 65 6e 64 3d  |window /suspend=|
000004e0  3c 69 64 3e 0a 74 61 73  6b 77 69 6e 64 6f 77 20  |<id>.taskwindow |
000004f0  2f 72 65 73 75 6d 65 3d  3c 69 64 3e 0a 20 74 68  |/resume=<id>. th|
00000500  65 73 65 20 63 6f 6d 6d  61 6e 64 73 20 73 75 73  |ese commands sus|
00000510  70 65 6e 64 20 6f 72 20  72 65 73 75 6d 65 20 61  |pend or resume a|
00000520  20 74 61 73 6b 77 69 6e  64 6f 77 2e 0a           | taskwindow..|
0000052d