1 Copyright (c) 1999 Massachusetts Institute of Technology
3 This program is free software; you can redistribute it and/or modify
4 it under the terms of the GNU General Public License as published by
5 the Free Software Foundation; either version 3 of the License, or (at
6 your option) any later version.
8 This program is distributed in the hope that it will be useful, but
9 WITHOUT ANY WARRANTY; without even the implied warranty of
10 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 General Public License for more details.
13 You should have received a copy of the GNU General Public License
14 along with this program; if not, write to the Free Software
15 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
16 ------------------------------
20 This file attempts to maintain up-to-date documentation on all
21 symbolic ("new") system calls. Those wonderful souls who update the
22 information in any way (additions, deletions, corrections) should
23 describe their modifications in a brief note to INFO-ITS@AI so that
24 interested parties can correct their copies or conceptions without
25 needing to print or read the entire file again. For example:
27 :MAIL INFO-ITS@AI I added more details to the "FOO" call ^C
29 If you want to be put on the INFO-ITS mailing list,
30 just say so in a message to it.
31 -------------------------------------------------
33 The format for executing a new system call is:
35 CALL: .CALL CALBLK ;the call itself
36 ;error return is to CALL+1
37 ;successful return is to CALL+2
43 SIXBIT /NAME/ ;where "NAME" is any implemented call
44 parm1 ;parameters start here
49 SETZ parmn ;bit 4.9 (SETZ) => last argument
51 A list of all implemented system calls may be seen in
52 AI:SYSTEM;ITS > starting at SYSCTB:. The actual addresses
53 within ITS where each call is executed may be found from the
54 table starting at SYSCTD:.
56 There are four types of parameters:
59 (error) error return code
62 Bits 4.1-4.3 of the parameter word form an "op code"
65 Op Code Meaning Symbol Value
68 1 immediate argument %CLIMM 1000
70 3 error return code %CLERR 3000
72 5 immediate control %CLBIT 5000
75 The indirect, index, and address fields are used to calculate
76 an effective address, PDP-10 style. These point to the location
77 where the argument is or the output is to be placed. For
78 immediate parameters the address itself is the argument or
79 control bits. (Some calls update their input arguments. Such
80 arguments may not be immediate.)
82 The order of the input arguments matters; so does the order of
83 the output values. Other than that, the order is irrelevant.
84 (As a matter of style, one normally writes them in the order
85 "control, arguments, values, errors" for clarity. In the descriptions
86 given here the parameters will always be described in that order.)
88 If too many input arguments are present, the excess are ignored,
89 except that more than 9 arguments will cause error 15. If too
90 few arguments are present, error 30 occurs. If too many output
91 values are specified, the extra values will be garbage. If too
92 few output values are specified, only those specified will
93 receive information, and any extra output is thrown away.
94 Specifying more than one error return parameter causes error 15.
95 Specifying an illegal sixbit name for the call causes error 43.
97 If an error return parameter is specified, then if the call
98 takes the non-skip return an error code will (probably) have
99 been stored into the error return parameter. It is also
100 stored into the I/O Status Word of some channel, as before.
101 If the call fails but no error code is returned, the error
102 return parameter is zeroed. Note that the error return parameter
103 is also zeroed if the call succeeds. Also, since this zeroing
104 takes place when the arguments are first processed, the error
105 return parameter should not be located on top of any input
106 arguments. Only one error return parameter is permitted.
108 The values of all control bit parameters given are XOR'ed
109 together, and the result may or may not be used by the system
110 call. Only the right half of a non-immediate control bit
111 parameter is significant. Some system calls XOR the left
112 half of their first argument with the control bits as well.
114 FAILURE CODES: Returned by New System CALLs (and .OPEN's, etc.)
116 The failure code from a new system call that doesn't skip can be
117 obtained by reading the .USET variable .BCHN to find the number of
118 the channel on which the code was returned, and then reading
119 that channel's .IOS variable (using the .STATUS uuo or
120 the STATUS symbolic call) to get a word with the error code
123 Alternatively an error return code argument may be specified and the error
124 code will be stored right-justified (not in bits 3.6-3.1, but bits 1.6-1.1).
125 To get the corresponding message from the ERR device, use a first file
126 name of 4 (number, not sixbit) and use the error code as the second file name.
128 The error codes which may be returned by each individual call are described
129 in the documentation for that call. Note that if the call is interpreted
130 by a job device, any error code may be returned, not just those documented;
131 job devices should, however, adhere as closely as possible to normal
132 error code conventions. Errors codes 15, 30, 43, and 44 may be returned by
133 any symbolic system call, and so are not included under the individual
136 The ERR device can be used to get a corresponding message as indicated in
137 the table on the following page. See the OPEN system call for information
140 The error codes have symbolic names, which are pre-defined in DDT and
141 MIDAS. The first two characters in the name are "%E". The remaining
142 letters usually follow the following conventions. 3rd and 4th letters:
143 "TM" = "too many", "BD" = "bad or illegal", "TF" = "too few", "RO" =
144 "read-only", "NA" = "not available", "NS" = "no such", "EX" = "already
145 exists", "FL" = "full", "NR" = "not ready". 5th and 6th letters: "JB" =
146 "job", "RG" = "arg", "DV" = "device", "DR" = "directory", "IO" =
147 "direction", "FL" = "file", "FN" = "file name".
151 Number Symbolic Message
152 ------ -------- -------
153 1 %ENSDV NO SUCH DEVICE
154 2 %ENSIO WRONG DIRECTION
155 3 %ETMTR TOO MANY TRANSLATIONS
156 4 %ENSFL FILE NOT FOUND
157 5 %EFLDR DIRECTORY FULL
159 7 %ENRDV DEVICE NOT READY
160 10 %ENADV DEVICE NOT AVAILABLE
161 11 %EBDFN ILLEGAL FILE NAME
162 12 %ENSMD MODE NOT AVAILABLE
163 13 %EEXFL FILE ALREADY EXISTS
164 14 %EBDCH BAD CHANNEL NUMBER
165 15 %ETMRG TOO MANY ARGUMENTS
166 16 %ENAPK PACK NOT MOUNTED
167 17 %ENADR DIRECTORY NOT AVAIL
168 20 %ENSDR NON-EXISTENT DIRECTORY
169 21 %ELCDV LOCAL DEVICE ONLY
170 22 %ESCO SELF-CONTRADICTORY OPEN
171 23 %ENAFL FILE LOCKED
172 24 %ETMDR M.F.D. FULL
173 25 %EMCHN DEVICE NOT ASSIGNABLE TO THIS PROCESSOR
174 26 %ERODV DEVICE WRITE-LOCKED
175 27 %ETMLK LINK DEPTH EXCEEDED
176 30 %ETFRG TOO FEW ARGUMENTS
177 31 %EROJB CAN'T MODIFY JOB
178 32 %EROPG CAN'T GET THAT ACCESS TO PAGE
179 33 %EBDRG MEANINGLESS ARGS
180 34 %EBDDV WRONG TYPE DEVICE
181 35 %ENSJB NO SUCH JOB
182 36 %EBOJ VALID CLEAR OR STORED SET
183 37 %ENACR NO CORE AVAILABLE
184 40 %ETOP NOT TOP LEVEL
185 41 %ENAPP OTHER END OF PIPELINE GONE OR NOT OPEN
186 42 %ENAJB JOB GONE OR GOING AWAY
187 43 %ENSCL ILLEGAL SYSTEM CALL NAME
188 44 %ENSCH CHANNEL NOT OPEN
189 45 %ENRBF INPUT BUFFER EMPTY OR OUTPUT BUFFER FULL
190 46 %EBDFL UNRECOGNIZABLE FILE
191 47 %EBDLK LINK TO NON-EXISTENT FILE
193 ARGS: Special Common Types of Arguments
196 STY channel # (accesses TTY which is STY's alter ego)
197 400000 + TTY # (may be used to examine TTY variables,
198 but not to alter them or to transact input/output)
200 <JOB> channel # for USR device
201 channel # for JOB device (means job on other end,
202 unless argument may also be a <JOBDEV>, in which
203 case the job device will interpret things)
204 channel # for BOJ device (means calling job)
205 channel # for STY device (means job possessing
206 the corresponding TTY)
207 400000 + job # (user index)
208 -1 or 777777 specifies self.
209 400377 specifies superior.
210 400376 specifies the pdp6.
212 The symbols %JSELF (777777), %JSNUM (400000), %JSSIX (400376),
213 and %JSSUP (400377) are pre-defined in MIDAS and DDT.
214 Various other symbols beginning with %JS are defined
215 for special codes that can be used instead of a
216 <JOB> spec with certain calls; they are documented
219 <JOBDEV> channel # for JOB device
221 Many symbolic system calls which take a channel number
222 as the first argument may be passed to JOB devices
223 for interpretation by that device. A few act on the device
224 itself, and are not passed for interpretation. Those
225 passed for interpretation include:
242 The JOB device may of course interpret such calls in
243 any way desired, and return any results desired.
244 It is of course advisable to adhere as closely to
245 the standard actions of each call as possible.
247 Most of the above calls simply pass the symbolic
248 call name and arguments along to the JOB device. The
249 following have special interfaces for historical reasons:
254 The following calls can open up a JOB device if their
255 sixbit device name argument is not the name of a
256 device that is built into the system:
261 Those calls which are definitely NOT passed for
262 interpretation include:
270 These calls interact with the JOB device in another way.
272 A number of these calls include special bits and fields in their
273 arguments or return values. Several files exist which contain
274 symbolic definitions of these bits and fields. These files
275 can be inserted into a MIDAS program with .INSRT. In addition,
276 most of the symbols are predefined in MIDAS and DDT through
277 a symbol table in the system. The symbols defined are the same
278 as used in this documentation.
280 The following files exist on the SYSENG directory.
282 FSDEFS > Bits in fields used by the file system,
283 including the format of directories.
284 ITS BITS Miscellaneous bits and codes.
286 The following errors are standard for all calls that take <JOB>
287 arguments, and are generally not documented under the individual
290 14 BAD CHANNEL NUMBER
291 The argument was not a special negative code, not
292 400000+a user number, and not a valid channel number.
294 A random number that could not be decoded was given
297 A channel number was specified that did not have open an
298 appropriate type of device (generally USR, STY, or BOJ).
300 400000+user number was specified, but the user number
301 did not correspond to a currently-existing job, or
302 400377 was given, specifying the superior, but the job
304 41 OTHER END OF PIPELINE GONE OR NOT OPEN
305 A STY channel number was specified, but the corresponding
306 TTY was free and had no associated job.
307 42 JOB GONE OR GOING AWAY
308 The specified job exists but is in process of being killed.
310 The following errors are standard for all calls that take <TTY> arguments:
313 400000+tty number was specified, but there is no tty with the
315 14 BAD CHANNEL NUMBER
316 The argument was not 400000+tty number and was not a valid
319 A channel number argument does not refer to a channel open
322 The specified channel is not open.
324 ACCESS: set file access pointer
326 arg 1 Channel number.
327 arg 2 New access pointer. This pointer is
328 the number of bytes from the beginning
329 of the file of the next byte to be
330 processed. Note that in block mode,
331 even ASCII block mode, a byte is always
334 This is useful primarily for DSK and disk-like job devices;
335 that is, any device which has "files."
337 See also the .ACCESS uuo.
341 14 BAD CHANNEL NUMBER
343 If the ACCESS pointer is set to more than the number of words in
344 in the file, an IOC error 2 will occur on the next IOT operation
347 ATTACH: attach a job-tree to a console (ITS DETACH)
349 cbits 2.9 If there are 2 args, causes the jname
350 of the job being attached to be changed
351 to HACTRN, unless there is already a HACTRN.
352 1.3 "
\eP" the job by clearing bit 4.4 of .USTP
353 arg 1 <JOB> to be attached to the console.
354 arg 2 Optional: <TTY> to attach it to. Must be free.
355 If not present, the executing job must be
356 top-level and console-controlled; it is logged
357 out, and its console used as the tty to attach to.
359 Attaching a job tree to a tty causes the job tree to be
360 console-controlled with the specified tty as its console.
361 The specified job must be either the top-level job of
362 a disowned job tree, or a direct inferior of the job executing
363 the ATTACH; in the latter case the specified job is disowned
364 first. The tty to be attached to must be free. In the
365 one-argument case the job executing the ATTACH must be the
366 top-level job of a console-controlled job tree; it is logged
367 out to make the console free. The one-argument case furthermore
368 causes the attached job to take on the jname of the job
369 executing the ATTACH. In the 2-argument case, control bit
370 400000 causes the attached job to take on the jname HACTRN,
371 unless that would cause it to have the same names as an
374 The one-argument case is made available in DDT via the
375 command :ATTACH, which attaches the current job to the console.
376 Also, when a user logs in (say as FOO), DDT checks for the
377 existence of a job called FOO HACTRO; if it exists, DDT asks:
378 --ATTACH YOUR DETACHED JOB--
379 If at this point the user types a space, DDT executes the
380 commands "HACTRO
\eJ :ATTACH ", thereby attaching the HACTRO to
381 the console, and changing the HACTRO's name to HACTRN.
382 This affords a convenient method of recovery from automatic
385 See the DETACH symbolic system call.
389 10 DEVICE NOT AVAILABLE
390 This job's tree is not console-controlled (one argument);
391 the specified tty is not free or does not exist (two arguments).
392 14 BAD CHANNEL NUMBER
393 The first argument is not a valid channel number.
395 The specified job is not disowned or a direct inferior.
397 First argument must be a job.
399 First argument specified a non-existent job.
401 The executing job must be a top-level job (one argument).
403 ATTY: pass tty to inferior
407 The tree's console tty is passed to the <JOB>, which must
408 be a direct inferior. This is the same as the .ATTY uuo.
413 The specified job is not a direct inferior.
416 The specified job is the pdp-6.
418 42 JOB GONE OR GOING AWAY
419 The specified job is dying.
421 CALL: perform system call
423 arg 1 Name of symbolic system call to perform.
425 The other arguments serve as the arguments to the
426 specified symbolic call. The values and errors returned by
427 that call become the values and errors of this call.
428 This is useful if the name of a symbolic call is to be
429 determined dynamically. Lisp hackers should think of this
430 as the "Funcall" system call.
432 CHAOSO: open Chaosnet connection <MOON;CHAORD>
434 arg 1 - receive channel number
435 arg 2 - transmit channel number
436 arg 3 - receive window size
438 First, the two specified channels are closed. Then an index
439 is assigned to the user and the two channels are set up to
440 point to it. Two channels are used since in general ITS
441 channels are unidirectional, and to allow to the user to
442 handle receive and transmit interrupts differently.
444 The created index is placed in the Closed state. To set up
445 a connection, IOT an RFC or LSN packet down the transmit
448 CHAOSQ: Chaosnet Queue <MOON;CHAORD>
450 arg 1 - address of a 126.-word block (packet buffer)
452 This is a special system call for use by the ATSIGN CHAOS
453 program, which is a daemon program that gets run when
454 an RFC is received that does not match up against an
457 The first packet on the pending-RFC queue is copied
458 into the packet buffer, then moved to the end of the
459 queue (so that the right thing happens when several
460 RFC's are pending at the same time.)
462 The call fails if the pending-RFC queue is empty.
464 The program should use the contact name in this
465 packet to choose a server program to execute. This
466 server program will then LSN to (presumably) the same
467 contact name, thus picking up the RFC.
469 CLOSE: close input/output channel
471 arg 1 Channel number to close.
473 The specified input/output channel is closed.
476 A CLOSE on the output channel will cause an automatic FORCE,
477 and a FIN segment will be sent to the remote host indicating
478 "no more data to send". However, the input channel will
479 remain open, and data can continue to be read from it.
480 A CLOSE on the input channel will cause any further input received
481 to be thrown away by ITS. Output can continue to be sent.
482 Return from this call is immediate; it will not hang. Note that,
483 like NCP, this does not allow the user to determine
484 whether the last stuff successfully reached the destination or
485 not. When this is desirable, a FINISH should be done prior to
489 Immediately closes the connection. All buffers and other
490 information associated with the index are discarded. Normally
491 the user should first IOT a CLS
492 packet containing an ascii explanation for why it is
493 closing. Note that any data previously written on the
494 connection but not yet received by the other end will be
495 lost. The system will attempt to send a CLS with reason
496 "channel closed", but this will only be sent if buffer space
499 See also the .CLOSE uuo.
501 CNSGET: get various console parameters (ITS TTY)
503 arg 1 <TTY> or <JOBDEV>
504 val 1 Vertical screen size.
505 val 2 Horizontal screen size.
506 val 3 TCTYP variable.
507 0 %TNPRT Printing terminal.
508 1 %TNDP Good Datapoint.
509 2 %TNODP Bad Datapoint ("loser").
514 7 %TNSFW Software terminal (accepts internal
515 ITS display codes, such as live in
516 internal terminal output buffers;
517 see ITS TTY for details).
519 11 %TNESC Display using ASCII standard display codes.
521 13 %TNRAY Teleray 1061
522 14 %TNHDS Concept 100
524 16 %TNAAA Ann Arbor Ambassador
525 val 4 TTYCOM variable.
526 4.9 Communicate mode.
527 4.8 %TCLFT Local feed through (my job sees his typing).
528 4.7 %TCRFT Remote feed through (his job sees my typing).
529 4.6 %TCICO Input comm override (my job sees my typing).
530 4.5 %TCOCO Output comm override (I see my job's typing).
531 4.4 %TCRFS Refuse comm messages.
532 4.3 %TCQRY Query me if comm attempted to me.
533 4.2 %TCMTR The tty's motor is off, and must be
534 turned on before next output.
535 (Currently only Terminets get turned off.)
536 4.1 %TCECH The last output to this tty was PI echo.
537 3.9 %TCINP Someone waited for input since last home-up.
538 3.8 %TCDET Console's tree detached by top level interrupt.
539 3.7 %TCDNG Type bell (input buffer full).
540 3.6 %TCCBK Reading uname or tty number after ^_K.
541 3.5 %TCCBS Reading uname or tty number after ^_S.
542 3.4 %TCFPD First part of an output code sequence is done.
543 3.3 %TCTPN Type ^_N on leaving comm (unless user types it).
544 3.2 %TCPAD 0 => padding necessary on datapoint.
545 3.1 %TCHNG Done flag seems to be fried - time out quickly.
546 2.9-1.1 -1 if not in comm mode; otherwise number of
547 next tty in circular list of those in comm mode
549 val 5 TTYOPT variable.
550 4.8 %TOALT Standardize altmodes.
551 4.7 %TOCLC Convert lower case input to upper case.
552 4.6 %TOERS This tty can selectively erase.
553 4.5 %TOHDX This tty is half-duplex.
554 4.4 %TOMVB This tty can backspace directly.
555 4.3 %TOSAI This tty handles SAIL characters.
556 4.2 %TOSA1 Used to initialize %TSSAI for new jobs.
557 4.1 %TOOVR This tty can overprint correctly.
558 3.9 %TOMVU This tty can move its cursor upward.
559 3.8 %TOMOR Used to initialize %TSMOR for new jobs.
560 3.7 %TOROL Used to initialize %TSROL for new jobs.
561 3.6 %TORAW Don't optimize cursor motion.
562 3.5 %TOLWR This tty has a lower case keyboard.
563 3.4 %TOFCI This tty's keyboard has the full TV character set.
564 3.3 %TOIML This tty acts like an IMLAC.
565 2.9-2.7 $TPPLF How to pad line feeds:
567 1 Two pad chars (Memorex, 2741).
569 2.6-2.4 $TPPCR How to pad carriage returns:
570 0 Don't. 4 Execuport.
574 For a Datapoint, number of pad chars before
575 each string of cursor motion commands.
576 For a Terminet, 0=no padding, 1,2,3,4,5
577 correspond to 10,15,30,60,120 cps.
578 2.3-2.1 $TPPTB How to pad tabs:
580 <n> Use <n-1> pad chars.
584 2 use VT52-style absolute positioning.
585 1.6 %TPCBS The ^\ intelligent terminal protocol is enabled.
586 1.5 %TP11T PDP-11 TV. Reflects %TY11T.
587 1.4 %TPORS Output reset really does something.
588 1.3 %TPRSC This tty can do region scrolling
589 1.2 %TPIBC Oddball 2741-like tty.
590 1.1 %TPIBM It really is a 2741.
591 val 6 TTYTYP variable.
592 4.9 %TTLCL Local tty (i.e. right near the PDP-10).
593 4.8 %TT340 Near the 340 or a 340 slave.
594 4.7 %TT3HP High priority for grabbing 340.
595 4.3 %TTPAR Tty needs a parity bit generated by software.
596 4.2 %TTDDI Don't ding bell on excess input.
597 4.1 %TTIBM Datel (2741) line.
598 3.8-3.5 $TTISP Input speed code:
599 0 = unknown 6 = 1800 baud 13 = 40K baud
600 1 = 600 baud 7 = 2400 baud 14 = 50K baud
601 2 = 110 baud 10 = 4800 baud 15 = 80K baud
602 3 = 150 baud 11 = 9600 baud 16 unused
603 4 = 300 baud 12 = 25K baud 17 unused
605 3.4-3.1 $TTOSP Output speed code, as above.
606 2.9 %TYDPK Datapoint controller line.
607 2.8 %TYSTY Alter ego to a STY.
608 2.7 %TYNVA Nova tty (requiescat in pace).
609 2.6 %TYMTY Morton controller line.
610 2.5 %TYDIL Dial-up line.
611 2.4 %TY11T PDP-11 TV tty.
613 2.2 %TYOTY KA-10 console tty.
614 2.1 %TYETY DTE-20 tty.
615 1.9 %TYNTY TK-10 tty.
616 1.8 %TYMDM Dial-up line with modem control.
617 1.7 %TYKST KS-10 console tty.
618 1.6 %TYDZT DZ-11 tty on a KS-10.
619 1.5 %TYRLM ROLM data switch tty.
620 val 7 TTYSMT variable.
621 4.9-4.7 %TQMCH Machine type
622 0 = nothing special 1 = PDP11 2 = PDS4
624 4.6-4.2 %TQHGT Character height in dots
625 4.1-3.7 %TQWID Character width in dots
626 3.6 %TQVIR Terminal implements virtual coordinates
627 3.5 %TQBNK Terminal implements blinking
628 3.4 %TQXOR Terminal implements XOR mode
629 3.3 %TQREC Terminal implements rectangle commands
630 3.2 %TQSET Terminal implements multiple object sets
631 3.1 %TQGRF Terminal understands graphics protocol
632 2.9 %TRGIN Terminal has graphic imput
633 2.8 %TRGHC Terminal has graphic hardcopy
634 2.7 %TRLED Terminal has local editing protocol
635 2.6 %TRSCN Terminal implements raster commands
636 2.5-2.3 %TRLSV <>0 means terminal supports 4**N saved lines
637 2.2-1.7 %TRTIM signed offset from GMT minus 20 or zero if
638 terminal's timezone is unknowable.
640 See also the CNSSET, TTYGET, and TTYSET symbolic system calls.
642 CNSSET: set various console parameters (ITS TTY)
644 arg 1 <TTY> or <JOBDEV>
645 arg 2 Vertical screen size (negative => no change).
646 arg 3 Horizontal screen size (negative => no change).
647 arg 4 TCTYP variable (negative => no change).
648 0 %TNPRT Printing terminal.
649 1 %TNDP Good Datapoint.
650 2 %TNODP Bad Datapoint ("loser").
655 7 %TNSFW Software terminal (accepts internal
656 ITS display codes, such as live in
657 internal terminal output buffers;
658 see ITS TTY for details).
660 11 %TNESC Display using ASCII standard display codes.
662 13 %TNRAY Teleray 1061
663 14 %TNHDS Concept 100
665 16 %TNAAA Ann Arbor Ambassador
666 arg 5 TTYCOM variable.
667 4.6 %TCICO Input comm override (my job sees my typing).
668 4.5 %TCOCO Output comm override (I see my job's typing).
669 4.4 %TCRFS Refuse comm messages.
670 4.3 %TCQRY Query me if comm attempted to me.
671 4.2 %TCMTR The tty's motor is off, and must be
672 turned on before next output.
673 (Currently only Terminets get turned off.)
674 3.9 %TCINP Someone waited for input since last home-up.
675 The remaining bits, documented under CNSGET, may not be changed.
676 arg 6 TTYOPT variable.
677 4.8 %TOALT Standardize altmodes.
678 4.7 %TOCLC Convert lower case input to upper case.
679 4.6 %TOERS This tty can selectively erase.
680 4.5 %TOHDX This tty is half-duplex.
681 4.4 %TOMVB This tty can backspace directly.
682 4.3 %TOSAI This tty handles SAIL characters.
683 4.2 %TOSA1 Used to initialize %TSSAI for new jobs.
684 4.1 %TOOVR This tty can overprint correctly.
685 3.9 %TOMVU This tty can move its cursor upward.
686 3.8 %TOMOR Used to initialize %TSMOR for new jobs.
687 3.7 %TOROL Used to initialize %TSROL for new jobs.
688 3.6 %TORAW Don't optimize cursor motion.
689 3.5 %TOLWR This tty has a lower case keyboard.
690 3.4 %TOFCI This tty's keyboard has the full TV character set.
691 3.3 %TOIML This tty acts like an IMLAC.
692 2.9-2.7 $TPPLF How to pad line feeds:
694 1 Two pad chars (Memorex, 2741).
696 2.6-2.4 $TPPCR How to pad carriage returns:
697 0 Don't. 4 Execuport.
701 For a Datapoint, number of pad chars before
702 each string of cursor motion commands.
703 For a Terminet, 0=no padding, 1,2,3,4,5
704 correspond to 10,15,30,60,120 cps.
705 2.3-2.1 $TPPTB How to pad tabs:
707 <n> Use <n-1> pad chars.
711 2 use VT52-style absolute positioning.
712 1.6 %TPCBS The ^\ intelligent terminal protocol is enabled.
713 1.5 %TP11T PDP-11 TV. Reflects %TY11T.
714 1.4 %TPORS Output reset really does something.
715 1.3 %TPRSC This tty can do region scrolling.
716 1.2 %TPIBC Oddball 2741-like tty.
717 1.1 %TPIBM It really is a 2741.
719 Omitting an argument also means no change (only works
720 if all arguments after it are also omitted, of course.)
721 Not all bits of the variables are settable; those explicitly
722 not user-settable have been omitted above. If contradictory
723 bits are supplied, the system will reconcile the conflicts.
724 See also the CNSGET, TTYGET, and TTYSET symbolic system calls.
726 CORBLK: modify blocks of core in page map (ITS CORBLK)
728 cbits 2.9 %CBWRT Try to get write access; okay if can't.
729 2.8 %CBRED Try to get read access; okay if can't.
730 2.7 %CBNDW Try to get write access; fail if can't.
731 2.6 %CBPUB Make page public. This operation fails if
732 an attempt to get write access would fail;
733 however, it does not actually get write
734 access unless bit 2.7 is set also.
735 Any job is allowed to get write access to
737 2.5 %CBPRV Make page private. This operation fails if
738 an attempt to get write access would fail;
739 however, it does not actually get write
740 access unless bit 2.7 is set also.
741 A job can have write access to a private page
742 only if it is getting the page from itself or
743 a job it is allowed to write in, and that job
744 has write access itself. Pages are usually private.
745 2.4 %CBNDR Fail if can't get read access
746 (attempting to share with a non-existent page).
747 2.3 %CBCPY Make a copy (disk files only).
748 2.2 %CBLOK Lock page in core (don't allow swap out.)
749 2.1 %CBULK Unlock page from core.
750 1.9 %CBSLO Force page to reside in slowest memory.
751 This is useful when trying to get
752 reproduceable run time measurements.
753 1.8 %CBUSL Undo the effect of %CBSLO
754 Bits 2.2-1.8 are not yet implemented.
755 All zero means delete page from page map.
756 arg 1 RH and LH are XOR'd with control bits.
757 arg 2 <JOB> to put page into (or delete it from).
758 arg 3 Page number within job specified by arg 2.
759 If LH negative, block mode operation:
760 After doing operation, increment arg 5 if any,
761 AOBJN arg 3, write args back into user core,
762 and repeat the operation, until LH of arg 3
764 arg 4 Any one of the following:
765 <JOB> to get page from.
767 When disk file pages are inserted,
768 the access pointer is left pointing
769 after the last word of the last page
771 If the pages so inserted are inserted
772 with write access for modification,
773 the DSKUPD symbolic system call may
774 be used to set the creation and
775 reference dates for the file.
776 PDP-6 channel number.
777 One of the following special negative codes.
778 Only the right-half matters.
779 -2 %JSTVB means video buffer pages.
780 Pages 0-7 are video buffer.
781 First word of page 10 contains
782 console register and ALU.
783 See the .TVCREG user variable,
784 and the VIDBUF and VIDSW symbolic
786 -5 %JSNEW get a fresh page. A new page, not
787 shared with any other, will be created.
788 The system tries to zero it out, but
789 currently may fail to if there is already
790 a page at the destination address. If
791 wasn't very difficult to fix, I'd fix it
792 instead of documenting it.
793 -6 %JSABS an absolute page. Arg 5 specifies the
794 desired page of physical memory. You are
795 not permitted write access to such a page.
796 400000 specifies the system job (job # 0). Sharing
797 a page with the system job is almost like
798 getting an absolute page via %JSABS, since
799 the system job's address space mostly
800 corresponds to physical memory.
801 400001 specifies the core job. For historical
802 reasons, this is taken to mean get a fresh
803 page instead. This special case will go
804 away some day, so use %JSNEW instead.
805 If arg 4 is omitted, it is the same as arg 2.
806 arg 5 Page number within source specified by arg 4.
807 Arg 5 is ignored for fresh page.
808 If omitted, same as arg 3 if source is a job.
809 If source is a disk file, the current access
810 pointer rounded down to a page boundary
815 10 DEVICE NOT AVAILABLE
816 PDP-11 TV not available for mapping.
817 14 BAD CHANNEL NUMBER
818 Argument 2 or 4 is invalid.
820 Executing job doesn't have modification rights to the job
821 specified by argument 2.
822 32 CAN'T GET THAT ACCESS TO PAGE
823 Can't satisfy access requested by cbits 2.7-2.4.
824 This usually means that the page does not exist in the
825 source specified in argument 4, or that it exists but
826 write access is not permissible. It may also mean that
827 an absolute page which normally exists is currently down.
829 Page number outside range 0-377 for another job's page,
830 or outside 0-10 for a video buffer page,
831 or outside 0-17 for a PDP-6 page.
832 The allowed range for absolute pages depends on the machine.
834 Can't map pages from any device other than those listed above.
836 Argument 2 or 4 specified a non-existent job.
838 Tried to get fresh page, but no more (virtual) core is available.
839 The total number of distinct pages in the system is limited
840 by the size of the MMP table.
842 CORTYP: determine type info from page map (ITS CORBLK)
845 arg 1 Page number within current job.
848 arg 2 Page number within specified job.
849 val 1 4.9 %CBWRT Page is writable.
850 4.8 %CBRED Page is readable (exists).
851 4.6 %CBPUB Page is public (writable by anyone)
852 4.2 %CBLOK page is locked in core
853 (inhibited from swapout)
854 3.9 %CBSLO Page is in slow memory
855 (Doesn't work; Moon says it never will)
856 For non-existent page, whole word is zero.
859 positive => read-only page,
860 negative => writable page.
861 val 2 0 Absolute page.
863 other User index of next job in circular
864 list of jobs sharing the page.
865 val 3 For val 2 = 0, absolute page number.
866 For val 2 = -1, zero.
867 Otherwise, page number within job specified
869 val 4 4.9 Page is in core.
870 2.9-1.1 Number of times page is shared (zero
871 for absolute or non-existent page,
876 14 BAD CHANNEL NUMBER
878 Page number was outside range 0-377.
880 Channel not open on USR, BOJ, JOB, or STY device.
883 DELETE: delete a file
886 arg 1 Byte pointer to ASCIZ filename string,
887 or aobjn pointer to block of such byte pointers.
890 arg 1 Left-justified device name, in SIXBIT.
891 arg 2 File name 1 in SIXBIT.
892 arg 3 File name 2 in SIXBIT.
893 arg 4 Sname in SIXBIT.
895 The file specified either by the four SIXBIT names or by the
896 ASCIZ string(s) is deleted.
898 See the SOPEN symbolic system call for how the byte or AOBJN
899 pointer argument should be formatted and how the string(s) are
902 DELEWO: Delete file While Open.
904 arg 1 Channel number.
906 The file open on the channel is marked for deletion.
907 It is actually deleted as soon as all channels referencing
908 it (including the one used by the DELEWO) are closed.
909 In the meantime, it is inaccessible (starred in the directory).
910 Either an input channel or an output channel can be used.
915 This call works only on DSK, and such job devices as simulate DSK.
919 arg 1 Sixbit name of demon to signal.
921 zero => signal once only.
922 positive => signal repeatedly every 2*n minutes.
923 negative => load demon but do not signal.
925 A demon is a program which runs (and perhaps even exists)
926 only when a request has been signaled for it. If the
927 demon with the specified demon is not currently running,
928 the system job creates a demon job and loads it from the
929 file SYS:ATSIGN <name>, where <name> is the name of the
931 When the demon runs, it can acknowledge receipt of one
932 or more signals by using the .DEMON uuo (q.v.).
933 The status of a demon can be examined and altered by
934 using the RDDMST and STDMST symbolic system calls.
935 When the system is started up, there is a once-only
936 signal for the DEMSTR demon pending; this demon normally
937 signals requests for all other standard systemic demons.
939 Demons were much used on the DM machine for various purposes.
940 Standard demons which are started by the DEMSTR demon include
941 (as of July 23, 1975):
942 NAME REPT RATE PURPOSE
943 TCTYP 0 Set terminal types?? (Doesn't exist on SYS)
944 UNSPOO 0 Line printer unspooler (TPL).
945 SURVEY 10. Network survey generator.
946 LDRDEM 0 Loader demon (obsolete).
947 BATCHM 0 Old batch monitor (obsolete).
948 COMSYS 0 Old message demon (obsolete).
949 NETRJS 0 CCN remote job server demon.
950 ZONE 0 MUDDLE compile batcher.
951 MG 0 Maze Guncher - kills games of MAZE
952 in an obscure way. AV doesn't like them.
953 COMDMN 0 Communications demon (replaces COMSYS).
954 BATCHN 0 Batch monitor (replaces BATCHM).
955 RFC402 0 Message archival demon.
957 DETACH: detach a job tree from a console (ITS DETACH)
959 arg 1 <JOB> for any job in the tree to be detached.
960 If omitted, the tree referred to is that
961 of the executing job.
962 cbits 1.1 Leave the detached tree as a non-disowned,
963 non-console-controlled tree, instead of as
965 1.2 Use system tree's resource word instead
966 of disowned resource word. This is to
967 be used only by legitimate system daemons.
968 1.3 "
\eP" the job by clearing bit 4.4 of .USTP
969 1.4 if an hour goes by and the detached tree
970 does not run and is not reowned or attached,
971 it will be killed automatically by the system.
972 1.5 suppress the console-free message that would
973 otherwise be printed on the tree's console.
974 The entire job tree which the specified job belongs
975 to is made to be disowned. If it was controlled by
976 a console, that console is made free. If the tree is
977 already disowned, nothing happens, but the DETACH call
978 skips anyway. If the top level job of the tree has a
979 jname of HACTRN, the jname is incremented to be HACTRO
980 and then re-incremented as necessary to make its uname-
983 DDT provides a command :DETACH which detaches the tree
984 the DDT itself is in. LOCK provides a DETACH command
985 for detaching other trees conveniently:
986 <n>DETACH detaches the tree containing the
987 job with user index <n>.
988 DETACH<uname> <jname> detaches the tree containing
989 the job named <uname> <jname>.
991 Automatic detachment by the system job:
992 Fatal interrupts in top-level jobs will cause them to be stopped
993 and then detached by the system job, which will type the message
994 TOP LEVEL INTERRUPT, TREE DETACHED
995 on the console detached from, followed by the normal
996 console-free message. A message is also printed on the system
997 console saying which job was detached from which terminal.
999 If the PDP-11 controlling the TV consoles crashes, the system
1000 job automatically detaches all job trees controlled by TV
1001 consoles. This allows the user to log back in and re-attach
1002 his job tree when the PDP-11 is restarted.
1003 If the ARPA network crashes (that is, the local network
1004 attachment crashes, or the host which is connected to
1005 the console of a particular console-controlled tree
1006 crashes) the server telnets automatically detach those
1007 job trees whose consoles are no longer connected to anything.
1008 On some ITS machines if a dial-up line is disconnected
1009 the job tree controlled by that line will be automatically
1010 detached. Other ITS machines do not have the hardware to
1011 to detect disconnection.
1012 When a tree is detached because its tty, whether TV, network
1013 connection, or dialup line, has disconnected, then if the
1014 tree is not logged in it will be killed immediately.
1016 Whenever a tree is detached automatically for any of the
1017 reasons mentioned above, control bit 1.4 is used, so the
1018 tree will go away if it is not touched for an hour.
1020 See the ATTACH and DISOWN symbolic system calls.
1024 14 BAD CHANNEL NUMBER
1026 Cannot detach the SYS or CORE jobs, or the PDP-6.
1027 34 WRONG TYPE DEVICE
1030 DL10MP: Hack the DL10 (pdp11 interface)
1032 THIS SYSTEM CALL CAN CRASH THE SYSTEM IF MISUSED. IT SHOULD
1033 NOT BE USED LIGHTLY.
1036 val 1 AOBJN pointer to DL10 control area
1037 val 2 Pointer to 3 words for pdp11 examine/deposit commands
1038 val 3 Pointer to first free word in DL10 control area
1040 A read/write, unencached, absolute page is created at the
1041 specified page number in the user's address space. The page
1042 contains the DL10 control area, which can be used to examine,
1043 deposit, or bootload the pdp11. A message is printed on the
1044 system console when this call is used.
1048 13 FILE ALREADY EXISTS
1049 The page slot specified is already in use.
1052 The page number is invalid.
1054 DIRSIZ: read the total size of files in a directory.
1056 arg 1 The number of a channel open on the DSK device,
1057 or a <JOBDEV>. The channel should be open to a file
1058 in the directory to be hacked.
1060 arg 2 (optional) quota
1062 arg 3 (optional) dsk number,,allocation
1064 val 1 quota,,total number of disk blocks used by files
1067 val 2 dsk number,,allocation (normally 0).
1069 DISMIS: dismiss an interrupt (ITS INTRUP)
1071 arg 1 Points to the third of three words which
1072 are the new .DF1, .DF2, and .UPC
1073 variables for use in dismissing the interrupt
1074 (but see the cbits for this call).
1075 If not an immediate argument, it is assumed to
1076 be a pdl pointer which is appropriately
1077 popped three times to get these items.
1078 It is then popped twice more to flush the
1079 two interrupt words pushed by a new-style
1081 If the job has enabled the pdl overflow
1082 interrupt (bit 2.8 of the .MASK user variable)
1083 then it will receive such an interrupt if the
1084 popping by DISMIS causes pdl underflow.
1085 arg 2 If present, overrides the new pc on the
1086 stack specified by arg 1.
1087 arg 3 If present, overrides the new .DF1 on
1088 the stack specified by arg 1.
1089 arg 4 If present, overrides the new .DF2 on
1090 the stack specified by arg 1. Thus if four
1091 arguments are supplied, the first is
1092 effectively ignored, except for popping.
1093 arg 5 If present, is the <losing insn addr>,,<lossage code>
1094 for a LOSE that is done, uninterruptably,
1095 after the interrupt has been dismissed.
1097 cbits The control-bits for this argument specify
1098 extra words to be popped off the pdl pointer
1099 which is the first arg, BEFORE the PC and defer
1100 words are popped. The cbits are ignored if the
1101 first arg is immediate. The intention is that
1102 the cbits will tell DISMIS how to pop exactly
1103 what was pushed when the interrupt happened. The
1104 format of the cbits is the same as that of the LH of
1105 the first word of the interrupt table (for new-style
1106 vectored interrupts) (see ITS INTRUP), which is what
1107 specifies what is to be pushed when an interrupt happens.
1109 2.9=1 => throw away three words first thing. Throws away
1110 the debugging info that interrupts can push.
1111 1.1-1.5 nonzero => it is number of ACs to be popped,
1112 and 1.7-2.1 is the number of the lowest AC to be popped.
1113 The ACs to be popped are BLT'ed out of the stack.
1115 If four arguments are supplied and the first is
1116 immediate, then the first is totally ignored (except
1117 that the address calculation is performed).
1118 Thus this call is good for dismissing old-style
1119 interrupts as well as new-style (stack oriented)
1122 Note that if the job is using the feature that interrupts
1123 automatically push some accumulators or some debugging info,
1124 it must explicitly request (with the control bits) that the
1125 same words be popped. DISMIS does NOT vary its function
1126 according to the job's interrupt table, for a given set of args.
1128 If the interrupt handler wishes to pretend that a class 2
1129 interrupt had not been enabled, it can dismiss the interrupt
1130 and supply a fifth argument which is like the first argument
1131 to a symbolic LOSE system call. Making the rh of that
1132 argument 1+.LZ <interrupt bit> will cause DDT to print the
1133 error message appropriate to an unhandled interrupt on that
1134 bit. The lh. of that argument should be the address of
1135 the instruction that caused the interrupt.
1137 See also the .DISMISS uuo.
1139 DISOWN: disown an inferior job
1141 cbits 1.4 Set BUMRTL, saying that if for one hour the
1142 job does not run and is not attached or reowned
1143 it should be gunned down by the system.
1144 1.3 Perform .USET <channel>,[.SUSTP,,[0]].
1145 In this way the job is not started until
1146 after being disowned.
1147 1.2 Use the system resource word instead of
1148 the disowned job resource word for scheduling.
1149 1.1 Make this job not disowned, but rather the
1150 top-level job of a non-disowned, non-console
1151 controlled job tree. This prevents the job
1152 from receiving 1/4'th priority as ordinary
1154 arg 1 A directly inferior <JOB>.
1156 Please do not misuse the 1.1 and 1.2 control bits. These are
1157 intended for generally useful "system daemons" only.
1159 The specified job is caused to be no longer an inferior of
1160 the executing job, and is made to be the top level
1161 job of a disowned job tree. Because of this, the disowned
1162 job will continue to exist even if its erstwhile superior
1163 does not (if, for example, the user logs out).
1165 Disowning is illegal if the executing job has given control
1166 of its console to the job to be disowned (see .ATTY).
1168 All channels on which the executing job has open the job being
1169 disowned will be closed in the process of disowning (see the
1170 .CLOSE uuo). If the disowned job has opened the
1171 console, then the channels are not closed, but
1172 are marked as "disowned tty"; certain operations
1173 on such a channel will succeed, and others will hang
1174 until the job is re-owned and a console tty given
1175 to the job. Such channels appear to be open on
1176 tty number %TINON=77 octal.
1177 A disowned job is distinguished by the fact that
1178 bit 4.9 of its .APRC user variable is set.
1179 A disowned job never succeeds in executing the RELOAD symbolic
1180 system call, even if it is the top level job in its tree.
1181 When a job tree is logged out, any micro-tapes assigned
1182 to the uname of that job tree are de-assigned (see the
1183 .ASSIGN and .DESIGN uuo's), but only if the job tree is
1185 All disowned jobs share a resource word for purposes of
1186 scheduling, in the same way that all jobs in a single
1187 non-disowned tree share a resource word. Thus all disowned
1188 jobs tend collectively to use no more runtime than any
1189 single non-disowned job tree.
1190 Furthermore, individual disowned jobs are given only 1/4
1191 the priority to run as a non-disowned job. This does
1192 not apply, however, if the disowned job in question has
1193 .MASTER mode, or controls the 340 display, the E&S display,
1194 the vidisector, the arm, the LPT (line printer), or the
1196 When operating under heavy loads, the swapper prefers to
1197 swap out disowned jobs rather than non-disowned jobs.
1199 The DETACH symbolic system call makes a non-disowned tree
1200 disowned. See also the %OPDET bit of the .OPTION user
1206 The specified job must be a direct inferior.
1210 arg 1 Disk channel number or <JOBDEV>
1212 The creation and reference dates for the disk file
1213 open on the channel are set to the current date and time.
1214 The dump check bit is cleared (! will show in the
1216 This is useful for programs which modify a file by
1217 mapping pages of the file into their page maps with write
1218 access, and which want to indicate this fact by setting
1219 the creation and reference dates. See the CORBLK symbolic
1220 system call for mapping pages of disk files.
1222 See also the FILBLK, RESRDT, RFDATE, and RQDATE
1223 symbolic system calls.
1227 34 WRONG TYPE DEVICE
1228 The supplied channel number must be a disk or JOB device channel.
1230 ECHOIN: echo characters and store them in a buffer, until a break character
1232 arg 1 TTY channel number
1233 arg 2 Byte pointer to buffer
1234 arg 3 Number of characters left in buffer
1235 arg 4 Address of break table
1236 arg 5 Address of TECO buffer block (or zero)
1238 The second and third arguments are counted out as characters
1239 are stored. When the call returns due to a break character, the
1240 count will still be greater than zero.
1242 ECHOIN tells the system to echo characters and insert them in
1243 the buffer specified by the second and third arguments without
1244 requiring the user program to be executed. This is more
1245 efficient and gets visibly faster response time. Echoing
1246 stops when either the count is exhausted or a break character
1247 is input. When this happens, the ECHOIN returns. If it returns
1248 because of a break character, then the break character
1249 is available for normal input. Non-break characters following
1250 the break character are not handled.
1252 Break characters are specified by the break table,
1253 a four-word block pointed to by the fourth argument. Each of
1254 the four words says, for 32 characters, whether they break
1255 or not. In the first word, the sign bit is for SAIL code 0,
1256 and bit 1.5 is for SAIL code 37. The sign bit of the second
1257 word is for Space, and bit 1.5 is for ?. And so on.
1258 Characters with Control or Meta set (including ASCII control
1259 characters on non-Meta keyboards) are always break characters.
1261 To prevent timing errors, ECHOIN will return immediately if
1262 there are characters in the input buffer already.
1264 For use by TECO, ECHOIN can update the block of counters which
1265 TECO uses to remember the extent of the buffer. The fifth
1266 argument should point to this block, the "Buffer block", which
1267 is seven words long. When a character is inserted, the first
1268 two words of the buffer block are not changed, the next four
1269 are incremented, and th next one is decremented. Passing the
1270 buffer block to ECHOIN allows ECHOIN to insert characters
1271 directly into TECO's buffer as an indivisible operation.
1272 Note that the insertion of the characters themselves is still
1273 controlled by the byte pointer and count arguments.
1274 However, in the future this may change; when ECHOIN is made
1275 able to handle operations besides insertion, it will use the
1276 buffer block for updating the buffer (which may involve deletion)
1277 but will still insert all characters it processes down the byte
1278 pointer. This way, TECO will have both an updated buffer and
1279 a list of the commands which the user typed.
1281 FILBLK: get contents of file parameter block
1283 arg 1 Disk channel number or <JOBDEV>
1284 val 1 First file name.
1285 val 2 Second file name.
1286 val 3 Random information:
1288 4.7-3.7 Word count of last block.
1289 3.6 Has been deleted from an
1291 3.5 Delete the file when closed.
1293 3.3 Open for writing.
1294 3.2 The grim file reaper should not reap this file.
1295 3.1 This is a link, not a file.
1296 2.9-2.5 Pack number.
1297 2.4-1.1 Pointer to internal UFD descriptor.
1298 val 4 File creation date and time in disk format:
1299 4.7-4.1 Year (mod 100.).
1300 3.9-3.6 Month (January = 1).
1301 3.5-3.1 Day of month.
1302 2.9-1.1 Time of creation, in half-seconds
1304 val 5 File reference date in disk format:
1305 4.7-4.1 Year (mod 100.).
1306 3.9-3.6 Month (January = 1).
1307 3.5-3.1 Day of month.
1308 2.1-2.9 Author, as M.F.D. index.
1309 1.1-1.9 File byte size and bit count in compressed form.
1311 See also the DSKUPD, RESRDT, RFDATE, RQDATE, SFDATE,
1312 and SRDATE symbolic system calls.
1314 FILLEN: get file length
1316 arg 1 Disk channel number or <JOBDEV>
1317 val 1 File length in bytes of the size
1318 the channel is open in.
1319 val 2 The size of those bytes.
1320 val 3 File length in bytes of the size used to
1321 write it (actually, the size in use the
1322 last time it was opened for writing).
1323 val 4 The size of those bytes.
1325 The length of the file open on the specified channel
1331 34 WRONG TYPE DEVICE
1332 Currently FILLEN works only for disk files and job devices.
1334 FINISH: wait for output to reach the device
1338 Does a FORCE (see below) then waits until all buffered
1339 output has reached the device.
1341 The following devices currently support FINISH.
1343 TTY: STY: DSK: NET: CHA: TCP:
1345 TCP: Does a FORCE (ensures that data is PUSH'd out) and
1346 waits until all data thus far has been ACK'd, i.e. acknowledged
1347 by the foreign host.
1349 Chaosnet: (channels opened with CHAOSO)
1350 On an output channel, does FORCE and then waits until
1351 there are no queued output buffers. I.e., waits for
1352 all output to be received and acknowledged by the foreign
1353 host. This in fact waits for acknowledge, not just receipt.
1356 * Any errors which the FORCE call might encounter.
1358 FLAP: flap a micro-tape
1360 arg 1 Micro-tape number (typically 1-4).
1362 The directory for the micro-tape is written back onto
1363 the tape if it is currently in core; the tape is then
1364 physically dismounted by running the tape back onto
1365 the original reel (thereby making the tape go flap, flap,
1366 flap ...). Micro-tapes should not be manually dismounted,
1367 for this will cause the directories to get out of phase,
1368 messing up the dismounted tape and also the next one to
1369 use the drive. The FLAP will fail if any files are still
1370 open on the specified drive, or if any one else has the
1371 drive assigned to him.
1372 See also the .UDISMT uuo.
1374 FLUSH: wait for output to reach the device
1378 This call has been renamed to FINISH (in ITS 1052).
1379 The old name will be kept around for a while, but new
1380 programs should not use it.
1382 FORCE: empty out device's output buffers
1386 If any output is buffered for the device, it is now sent
1387 to the device. Note that this is not needed for the TTY
1388 device since output is always sent as soon as possible.
1390 It is not necessary to do a FORCE before doing CLOSE.
1392 The following devices currently support FORCE:
1394 NET: Causes output to be sent as soon as possible;
1395 otherwise it would only be sent when the buffer
1396 was full or when 2 seconds have elapsed since
1397 output was first put in the buffer.
1399 TCP: Same as NET, except that the PUSH flag is set
1400 in outgoing segments. If there is no buffered data,
1401 nothing is sent. (Note that ITS TCP always sets PUSH
1402 in all outgoing segments whether FORCEd or not.
1403 Otherwise, a FORCE with an empty buffer would require ITS
1404 to re-send old data with PUSH set in order to nudge the
1405 remote site into action.)
1407 DSK: Causes the current output buffer and the directory
1408 to be written to disk.
1410 Chaosnet: (channels opened with CHAOSO)
1411 If there is a partially-filled output packet (created by IOT
1412 or SIOT), it is transmitted.
1414 The following devices ignore FORCE (it always skip returns)
1415 because they don't need it:
1417 TTY: STY: LPT: PLT: PTP: COD:
1421 TCP: Channel is not an output channel.
1423 TCP: Connection not open for writing.
1424 34 WRONG TYPE DEVICE
1425 The device is not an output device, or does not have
1426 the kind of buffered up output which needs this call.
1428 IOPOP: pop input/output channel
1430 arg 1 Channel number
1432 The top entry on the job's IO pdl is popped into the
1433 specified channel. Entries on the IO pdl are made
1434 only by pushing channels with IOPUSH. If a channel
1435 is pushed with IOPUSH and then popped into with IOPOP,
1436 it is in exactly the same state as it would have been
1437 if left untouched; however, the channel is available
1438 for other use in the meantime.
1440 IOPUSH: push input/output channel
1442 arg 1 Channel number
1444 The contents of the specified channel are pushed onto
1445 the job's IO pdl, and the channel is put into a
1446 "closed" state. If the channel had been open, the
1447 open file is not closed, but is instead now open on
1448 the IO pdl slot instead of on the channel. It is
1449 not accessible to the job for IOT'ing, etc., while
1450 there, but it can be popped back into a channel with
1451 IOPOP and then will be available for IO.
1454 IOT: input/output transfer
1456 cbits Per-IOT mode bits. Device dependent.
1457 arg 1 Channel number. LH XOR'd with control bits.
1458 arg 2 Location for input/output transfer.
1459 May not be immediate.
1460 For unit mode, this is the word to
1461 output from or read into.
1462 For block mode this is an AOBJN
1463 pointer to a buffer.
1464 arg 3 (Optional) device-independent special mode bits.
1465 These are not currently used.
1467 For ease of use, in unit input mode arg 2 and arg 3
1468 may be omitted and val 1 will then be the word read.
1470 For TTY and Tnn devices (terminals in general),
1471 the following control bits are effective for IOT.
1472 They are XOR'd into the left half of the I/O channel
1473 word both before and after the IOT (see the .IOC user
1474 variable). Thus one can modify the tty's
1475 characteristics temporarily for just one IOT.
1477 Control bits on input:
1478 2.6 %TIECH Read even if char needs pi echoing
1479 2.5 %TIPEK Don't remove char from buffer (peek)
1480 2.3 %TIACT Don't wait for activation char
1481 2.2 %TIINT Read even if char is an interrupt
1482 char and hasn't interrupted yet.
1483 2.1 %TINWT If no input available, don't wait, but return -1.
1484 1.9 %TIFUL Use full character set (for Imlacs and TV's).
1486 Control bits on output:
1487 2.6 %TJECH Echo mode output.
1488 2.5 %TJCTN Don't do line continuation.
1489 2.3 %TJDIS Recognize ^P cursor codes.
1490 2.2 %TJSIO Super-image output. No padding
1491 or cursor control is performed.
1492 2.1 %TJMOR Do not do **MORE** processing.
1493 1.9 %TJPP2 Output in the echo area if it exists.
1494 1.7 %TJHDE Account for cursor motion due to characters
1495 echoed on a half-duplex tty.
1496 For the Chaosnet (channel opened with CHAOSO):
1499 This can be used to do unit-mode 8-bit-byte transfers.
1500 Control bit 1.4 means don't-hang, and applies to both input
1501 and output. Only data packets with opcode 200 will be
1502 transferred. Anything else on input causes the transfer
1503 to stop, like an end-of-file. Use PKTIOT to find out what
1504 the story is. (The correct way is to verify that there are
1505 some packets in the input buffer, then do a (S)IOT, and if it
1506 transfers 0 bytes then the first packet in the input buffer
1507 must not be a data packet, so PKTIOT it in.)
1509 There can be input available to (S)IOT even when the state is
1510 not %CSOPN (e.g. if the input buffer contains data and
1511 a CLS packet.) In this case, you should first (S)IOT (if you
1512 care to pick up the data) then PKTIOT.
1517 14 BAD CHANNEL NUMBER
1519 The second argument was immediate.
1521 IPKIOT: Internet packet (datagram) I/O
1523 This call is similar to PKTIOT and works for channels
1524 opened on the IPQ device. It should NOT BE USED without
1525 a good understanding of Internet Protocol datagram formats.
1526 This call is still subject to change and thus is not
1527 documented further. Ask KLH if you think you need to use it.
1529 ITYIC: read tty interrupt character
1534 This call fails to skip if there is no input
1535 interrupt character to be read from the tty.
1536 Otherwise, it returns the next un-ITYIC'ed
1537 input interrupt character.
1538 ITYIC'ing a character does not remove it from
1539 the input buffer - it is still there to be IOT'ed
1540 in its turn, along with the non-interrupt characters.
1541 ITYIC makes it possible for a program to scan input
1542 interrupt characters as they interrupt, without
1543 interfering with the IOT'ing that will take place
1546 JOBCAL: get info on how job device was called
1548 arg 1 BOJ channel number or <JOBDEV>
1549 arg 2 Optional: AOBJN pointer for job call data.
1550 arg 3 Optional: sixbit device name for PEEK and who-lines.
1551 val 1 "opcode" for requested operation.
1553 See ITS JOB for information on job devices.
1555 This call is to be executed by a JOB device when it
1556 receives an interrupt on its BOJ channel. It returns
1557 data describing the operation desired by the calling job.
1558 Note that the second argument is an AOBJN pointer
1559 to an area in which the call will place data, not get it!
1561 The third argument, if present, is a device name to be used
1562 by PEEK and who-lines for printing things like ARCBO.
1563 (This name is initialized to the device name returned as word
1564 4 by OPEN - see below. The unknown-device handler, if involved
1565 in the process (see the OPEN symbolic system call), resets
1566 this to the second file name of the JOBDEV file it actually
1567 succeeded in loading (this name may have had digits stripped off).)
1569 The "opcode" describes the operation to be performed:
1570 4.9-4.7 Open mode, if 2.9-1.1 contains 0.
1572 4.5 Close (both bits always the same)
1573 4.1 SIOT rather than IOT
1574 3.8 pclsred call restarting
1577 2 MLINK (make a link)
1581 6 .FDELE (delete or rename)
1582 7 .FDELE (rename while open)
1585 The second argument should point to a block of 12
1586 words (0-11) in which the following data are deposited:
1589 wd 1 First file name.
1590 wd 2 Second file name.
1591 wd 3 Directory name.
1593 wd 5 Full 18.-bit open mode in right half.
1594 wd 7 BP or AOBJN ptr specifying filename, if
1595 the SOPEN call was used to do the open.
1599 wd 0 For block IOTs, the loser's IOT
1600 pointer. The left half contains the
1601 negative of the desired number of words.
1602 For SIOTs, the byte count. 1 for unit IOTs.
1605 wd 0 The address within the file to access.
1606 The beginning of the file is 0.
1610 wd 1 FN1 of the link.
1611 wd 2 FN2 of the link.
1612 wd 3 Directory name of the link.
1613 wd 4 Device name of the link.
1615 wd 6 Linked-to directory.
1616 wd 7 BP or AOBJN ptr specifying name of link,
1617 or 0 if the name was specified as SIXBIT.
1618 wd 10 BP or AOBJN ptr specifying name to link to,
1619 or 0 if the name was specified as SIXBIT.
1620 (note links from one device to another don't exist).
1622 FDELE (rename or delete)
1623 wd 0 Zero implies delete. Otherwise, the
1624 new first file name.
1625 wd 1 Old first file name.
1626 wd 2 Old second file name.
1627 wd 3 Name of directory.
1628 wd 4 Name of device.
1629 wd 5 Zero implies delete. Otherwise, the
1630 new second file name.
1631 wd 7 BP or AOBJN ptr specifying file to act on,
1632 or 0 if the name was specified as SIXBIT.
1633 wd 10 BP or AOBJN ptr specifying name to rename to,
1634 or 0 if the name was specified as SIXBIT.
1636 FDELE (rename while open)
1637 wd 0 Zero implies delete. Otherwise, the
1638 new first file name.
1639 wd 5 Zero implies delete. Otherwise, the
1640 new second file name.
1641 wd 10 BP or AOBJN ptr specifying name to rename to,
1642 or 0 if the name was specified as SIXBIT.
1645 wd 0 Name of operation in sixbit.
1646 wd 1 Control bits for the call.
1647 wd 2 Number of following words.
1648 wds 3-n Input arguments to call. The first
1649 will almost always be a channel number.
1650 Values may be returned via the
1651 JOBRET symbolic system call.
1655 34 WRONG TYPE DEVICE
1656 The first argument must be a BOJ channel number or
1657 a JOB device channel number.
1659 JOBGET: get job device information
1661 This symbolic system call is ARCHAIC and OBSOLETE.
1662 It is documented here for historical purposes only.
1663 Its use in new programs is to be avoided.
1664 Its function has been superseded by the JOBCAL
1665 symbolic system call.
1667 arg 1 BOJ channel number or <JOBDEV>
1669 The individual returned values are identical to
1670 the words returned by JOBCAL in the area specified
1671 by JOBCAL's second argument.
1673 JOBINT: cause caller of JOB device to get an interrupt
1675 arg 1 BOJ channel number or <JOBDEV>
1677 See ITS JOB for information on job devices.
1679 This is used by JOB devices to cause the calling job
1680 to receive a word 2 interrupt for the channel it has
1681 the JOB device open on. See also the SETIOC
1682 symbolic system call.
1686 34 WRONG TYPE DEVICE
1687 The first argument must be a BOJ channel number
1688 or a JOB device channel number.
1689 41 OTHER END OF PIPELINE GONE OR NOT OPEN
1691 JOBIOC: set input/output channel error
1693 arg 1 BOJ channel number or <JOBDEV>
1694 arg 2 IOC error code.
1696 This is used by JOB devices to cause the calling job
1697 to receive a word 1 IOC interrupt. This interrupt
1698 will be given when the calling job next attempts
1699 an IOT operation. The .BCHN variable for that job
1700 will be set to the channel it has the JOB device
1701 open on, and bits 4.1-4.5 of the corresponding
1702 .IOS word are set to the specified IOC error code.
1703 See also the JOBINT symbolic system call.
1705 Valid IOC error codes are as follows:
1706 1 ILLEGAL HARDWARE OPERATION ATTEMPTED
1707 2 ATTEMPTED RANDOM ACCESS TO ADDRESS BEYOND END OF FILE
1708 3 NON-RECOVERABLE DATA ERROR
1709 4 NON-EXISTENT SUB-DEVICE
1712 7 USR OP CHNL DOES NOT HAVE USR OPEN
1714 11 DEVICE FULL (can also mean a directory is full)
1715 12 CHNL IN ILLEGAL MODE ON IOT
1716 13 ILLEGAL CHR AFTER CNTRL P ON TTY DISPLAY
1718 15 DIRECTORY'S ALLOCATION EXHAUSTED
1723 Second argument is not a valid IOC error code.
1724 34 WRONG TYPE DEVICE
1725 First argument is not a BOJ channel number.
1726 41 OTHER END OF PIPELINE GONE OR NOT OPEN
1728 JOBRET: return values to loser and let him continue
1730 arg 1 BOJ channel number or <JOBDEV>
1731 arg 2 LH contains error code, or 0 if none.
1732 RH contains amount for loser to skip.
1733 arg 3 Optional AOBJN pointer to a block
1734 of values to be returned to the loser.
1736 See ITS JOB for information on job devices.
1738 This call is used by JOB devices to cause the
1739 calling job to continue after an input/output request.
1740 The second argument specifies an error code in its LH;
1741 if non-zero it is placed in bits 3.6-3.1 of the .IOS
1742 word for the JOB device (see the STATUS symbolic
1743 system call). The RH contains the amount by which
1744 the loser should skip upon continuing if he used a .CALL;
1745 this amount is usually 0 or 1. The third argument is
1746 an AOBJN pointer to a block of values which are
1747 passed back to the .CALL or to the .RCHST.
1751 34 WRONG TYPE DEVICE
1752 First argument must be a BOJ channel number
1753 or a JOB device channel number.
1754 36 VALID CLEAR OR STORED SET
1756 JOBREU: Lets a JOB device handler offer itself for re-use
1758 arg 1 Device name that the handler can handle
1759 arg 2 FN1 of file the handler was loaded from
1760 arg 3 FN2 of file the handler was loaded from
1761 arg 4 SNAME of file the handler was loaded from
1762 (Note: the only device it could have been
1763 loaded from is DSK).
1764 arg 5 Amount of time to wait (for someone to try
1765 to re-use us) before giving up and taking the
1766 failure return, in 30'ths of a second.
1767 Alternatively, minus the time to wait until
1768 (in 30'ths since the system was started up).
1769 If the argument is positive (a duration) it
1770 is converted to a negative one (time to stop)
1773 Some job device handlers take a considerable amount of
1774 work to initialize themselves - for example, the ML device
1775 must set up network connections to another machine.
1776 Improved performance results if the same handler job
1777 can be used for several OPENs, instead of having to
1778 load a new job and open a new set of network connections
1779 for each one. The JOBREU call makes this possible.
1780 The time to use it is when the handler has completed all
1781 of the business for one operation - it has received a
1782 "CLOSE" from its creator, has tidied up its data bases,
1783 and would otherwise have nothing to do except log out.
1784 Instead, it can do a JOBREU. During the time period
1785 specified in the JOBREU, if any job tries to do an OPEN
1786 on a job device which this handler could be used for,
1787 this handler job will in fact be used. In this case,
1788 the JOBREU will skip return. The handler should then
1789 act as if it had just been loaded, and do the "initial
1790 JOBGET". If nobody tries to reuse the handler in the
1791 specified time period, the JOBREU will return without
1792 skipping, and the handler should log out.
1794 Note that one should not do a JOBREU immediately upon
1795 receiving a close when the JOBRET of the initial OPEN
1796 has failed, because the creator has pclsred and is
1797 likely to be coming back. In order to make it use the
1798 same job device when it comes back, JOBREU should not
1799 be done; instead, a PCLSRed JOB device open automatically
1800 finds the right job and sends another request to it.
1801 You should time out and if this second request does not
1802 come in, then give up and do a CLOSE and a JOBREU.
1804 There are two kinds of OPENs that can invoke the JOB device:
1805 1) An open of JOB:<filenames> explicitly. It can reuse a
1806 job device handler if <filenames> match the FN1, FN2,
1807 and SNAME specified in the JOBREU.
1808 2) An open of a device name (such as ARC) that is not
1809 built into the system. Such an open can reuse a job
1810 device handler if the device name matches the one
1811 specified in the JOBREU.
1816 10 DEVICE NOT AVAILABLE
1817 This job isn't a JOB-device handler.
1818 13 FILE ALREADY EXISTS
1819 This job device handler is already (still) in use
1821 41 OTHER END OF PIPELINE GONE OR NOT OPEN
1822 Nobody tried to reuse this job, and the time period ran out.
1824 JOBSTS: set JOB device status
1826 arg 1 BOJ channel number or <JOBDEV>
1827 arg 2 New JOB device status - stored in the RH of
1828 the job channel's .IOS word, where .STATUS
1829 on the job channel will find it.
1830 This may be arbitrary, of course, but the
1831 standard bits are as follows:
1832 2.9-2.3 Device dependent.
1833 2.2 Buffering capacity empty.
1834 2.1 Buffering capacity full.
1835 1.9-1.7 Mode in which device was opened.
1836 1.9 0 = ascii, 1 = image.
1837 1.8 0 = unit, 1 = block.
1838 1.7 0 = input, 1 = output.
1839 1.6-1.1 ITS internal physical device code.
1840 For a job device this should be 22,
1841 unless you really know what you are
1843 If omitted, 000022 is used.
1844 arg 3 Sets the "device name" of this channel.
1845 The device name is used by the RFNAME
1846 and RCHST system calls, and by PEEK
1847 and who-lines, to say what device a job
1848 is transferring to or waiting for in the
1849 job's status. The argument is optional.
1850 arg 4 Sets the "file name 1". Optional.
1851 arg 5 Sets the "file name 2". Optional.
1852 arg 6 Sets the "system name". Optional.
1853 arg 7 Sets the "open mode" that will be returned
1854 by the RFNAME system call. Optional.
1855 arg 8 Optional byte pointer to ASCIZ string in device handler's
1856 address space containing full filenames. The byte pointer
1857 my not be indexed or indirect. Note that ITS might decide
1858 to read a string from this byte pointer at any time, so the
1859 string must continue to exist even after the JOBSTS call
1862 When the channel is first opened the device, file
1863 name 1, file name 2, system name, and open mode
1864 are set to the ones by which the channel was opened.
1865 JOB device programs may change these if they wish,
1866 but are not required to.
1868 See the STATUS symbolic system call, the .STATUS uuo,
1869 and the RFNAME system call.
1871 See ITS JOB for information on job devices.
1873 KLPERF: Use KL10 performance analysis counter
1875 arg 1 <JOB> whose performance is to be measured
1876 -3 (%JSNUL) => the null job
1877 -4 (%JSALL) => all jobs
1878 0,,-3 and 0,,-4 are also acceptable.
1879 arg 2 Performance Analysis Enables word
1880 0 => turn off the performance counter
1881 and make it available for other users.
1882 See DEC drawing M8538-0-MTR4 for the bits in this
1884 val 1 Previous <JOB> setting; -3, -4, or a job number
1885 val 2 Previous Performance Analysis Enables word
1886 val 3 High-order word of the time base
1887 val 4 Low-order word of the time base
1888 val 5 High-order word of the performance counter
1889 val 6 Low-order word of the performance counter
1891 If no arguments are supplied, the state of the counter
1892 is not changed and the six values are returned.
1894 If arguments are supplied, the performance analysis counter
1895 is siezed so no other users can interfere and performance
1896 measurement begins. When the specified job is running
1897 and the conditions specified in the Enables word are met,
1898 the performance counter counts. A bit in the Enables
1899 word controls whether it counts the duration, in microseconds,
1900 that the conditions were satisfied, or the number of times
1901 that the conditions became satisfied. While the specified
1902 job is running, the time base counts microseconds. If -4
1903 (all jobs) was specified, this is the elapsed real time.
1904 Issuing the KLPERF call again allows the results to be
1905 determined by subtracting the values obtained the first time
1906 from the values obtained the second time.
1908 The two counters are double-precision numbers. The high-order
1909 35 bits are in bits 1.1-4.8 of the high-order word, and
1910 the low-order 23 bits are in bits 2.4-4.8 of the low-order
1915 10 DEVICE NOT AVAILABLE
1916 Someone else is using the performance analysis counter.
1917 14 BAD CHANNEL NUMBER
1918 Argument 1 is invalid.
1920 Argument 1 specified a non-existent job.
1922 LISTEN: listen for any typed-ahead input (ITS TTY)
1924 arg 1 <TTY> (but not a STY channel) or <JOBDEV>
1925 val 1 Number of typed-ahead characters pending.
1927 Waits for output buffer to empty before listening.
1928 To check for input without waiting for output use
1929 .STATUS. The uuo .LISTEN is the same as LISTEN,
1930 but applies only to the job's console, and furthermore
1931 returns zero if the job doesn't possess the tty.
1935 14 BAD CHANNEL NUMBER
1937 LNKEDP: find out whether open file was reached via a link
1939 arg 1 Channel number of open disk file
1940 val 1 Nonzero if file was reached via a link.
1942 The file open was reached through a link if the names
1943 actually specified in the OPEN were the names of a link
1944 which pointed at this file. It is not a question of
1945 what file is open, but of what names were specified to
1950 14 BAD CHANNEL NUMBER
1951 Arg 1 is not between 0 and 17.
1952 34 WRONG TYPE DEVICE
1953 Arg 1 does not specify a disk channel.
1955 LOAD: load file (a program) into a job
1958 arg 2 Disk channel number (freshly opened for reading).
1959 arg 3 Optional argument which causes part of the file
1960 to be ignored: either <start>,,<end>, to load
1961 only between addresses <start> and <end> (inclusive),
1962 or zero meaning load only pure pages.
1963 The default is 0,,-1 normally, 20,,-1 when loading
1964 oneself, and 20,,37777 when loading the PDP6.
1965 When loading a PDUMP format file, <start> and <end>
1966 are rounded outward to page boundaries.
1968 The file open on the input channel is loaded into
1969 the specified job. The file may be in one of two formats:
1970 PDUMP format, or SBLK format. The former is produced by
1971 the PDUMP symbolic system call, under which its format
1972 is documented. The latter is described below.
1973 The two formats are distinguished by the
1974 fact that a PDUMP format file begins with a zero word,
1975 but an SBLK format file begins with a non-zero word.
1978 First off, any words in the file are ignored until a word
1979 254000,,1 (JRST 1) is found. This should be followed
1980 by zero or more blocks of the following form:
1984 That is, the first word is an AOBJN pointer describing where
1985 to load <n> consecutive words of data into the job; this is
1986 effectively used as a block .IOT pointer to load the words.
1987 Following the data is a checksum, which is ignored.
1988 (Historically, when microtapes were used, the checksum was
1989 necessary for error checking.)
1990 Following the last block must be a non-negative word
1991 to denote the fact that there are no more blocks.
1992 This word and all succeeding words in the file are ignored.
1993 (DDT assumes that this word contains the starting
1994 address of the program, and that following words contain
1995 the symbol table for the program.) The disk channel
1996 is left open, with the access pointer pointing to the
1997 positive word which followed the last block.
1999 The standard form of symbol table is:
2001 squoze code,symbol -- these 2 words are
2002 value of symbol -- repeated n times
2004 The word after the symbol table is another copy of the starting address.
2009 A disk read error occurred.
2011 The calling job may not write into the job being loaded.
2012 32 CAN'T GET THAT ACCESS TO PAGE
2013 You tried to create an absolute page pointing to memory
2014 that the system doesn't have.
2015 34 WRONG TYPE DEVICE
2016 Arg 2 does not specify a disk read channel, or
2017 you tried to load a PDUMP file into the PDP-6.
2018 37 NO CORE AVAILABLE
2019 The MMP was full so a needed page could not be created.
2020 46 UNRECOGNIZABLE FILE
2021 The file open on the specified channel is not in
2022 valid SBLK format, nor in valid PDUMP format.
2024 LOGIN: log in a job tree
2026 arg 1 Sixbit name to log in under.
2027 " " (0) and "___xxx" (-1 in left half) are illegal.
2028 arg 2 Sixbit name of "terminal." This is not required
2029 for hard-wired terminals. When this field specifies
2030 a network host, the standard form is HSTnnn, where
2031 nnn is the octal host number, however often the English
2032 name of the host, abbreviated to six letters, is used.
2033 arg 3 Sixbit XUNAME. This is normally the same as arg 1
2034 except that if arg 1 is changed to make it unique,
2035 this should not be changed. The XUNAME is what is
2036 used for accounting purposes.
2038 The uname for the job tree is changed from "___nnn"
2039 (where "nnn" is the top-level job's user index in
2040 sixbit octal characters), which is the initial uname of
2041 a non-logged-in job tree, to the specified sixbit name.
2042 If the job tree already has a uname other than "___nnn",
2043 the LOGIN fails. Only top-level jobs with no direct
2044 inferiors may LOGIN.
2048 11 ILLEGAL FILE NAME
2049 Cannot log in as "___xxx" or " ".
2050 12 MODE NOT AVAILABLE
2051 Jobs with direct inferiors may not log in.
2052 13 FILE ALREADY EXISTS
2053 Someone is already logged in under the specified name.
2057 Only top-level jobs may log in.
2059 LOGOUT: log out a job tree
2061 No arguments or values (note, however, that at least
2062 one must be present in order to contain the 4.9 bit
2063 terminating the argument list). If the executing
2064 job is the top level job in its job tree, then the
2065 entire job tree is expunged from the system.
2066 Does not skip if not a top level job. This is not
2067 considered an error, however; no error code is returned.
2068 See also the .LOGOUT uuo.
2070 LOSE: report lossage
2072 arg 1 left half - address of losing instruction
2073 right half - lossage code (defined by DDT.)
2074 arg 2 new PC. If omitted, the address of the .CALL
2077 1.1 default arg 2 to the address of the .CALL plus one.
2078 1.2 do SETZM @.40ADDR, i.e. clear the location
2079 in the job where a UUO returned from the
2080 system would be stored.
2081 1.3 Really take the left half of arg 1 as the address
2082 of the losing instruction. If this control bit
2083 is not specified, the new PC is used instead.
2085 The job's Program Counter is set to the new PC,
2086 the job's .VAL user variable is set to the address
2087 of the losing instruction,,the lossage code, and the
2088 job is given a %PILOS interrupt. If the job does not
2089 enable this interrupt, and its superior is DDT, a
2090 helpful error message will be printed.
2092 The LOSE symbolic system call is a more general version
2093 of the .LOSE UUO. .LOSE is simpler, and usually good
2094 enough. Symbolic LOSE is for situations where sophisticated
2095 error reporting is needed. Symbolic LOSE allows the new PC
2096 value to be specified explicitly, and therefore is suitable
2097 for use inside an error-handling subroutine. In addition,
2098 the address of the "culpable" instruction can be specified
2099 independantly from the address to restart at. Thus, the
2100 program can provide more complicated error recovery
2101 than simply restarting at the losing instruction.
2103 The lossage codes are defined by DDT's interpretation of them.
2104 The defined values are:
2106 %LSSYS==1000 The last error code returned by a failing
2107 system call describes the problem.
2109 %LSFIL==1400 The last error code returned by a failing
2110 system call, together with the name of the file
2111 it was operating on, describe the problem.
2112 The "culpable instruction" address should point
2113 at the failing system call.
2114 DDT will decode it to determine the filenames
2115 (if it is an OPEN) or the channel number and then
2116 the filenames via an RFNAME.
2118 %LSSYS+errcode Means that the system call error code
2119 <errcode> describes the problem.
2121 %LSFIL+errcode Means that the error code <errcode>
2122 together with the filenames being used
2123 describe the problem.
2125 0 Signifies some other nondescript error condition.
2127 1+.LZ <interrupt bit>
2128 Means that the error should be handled as if it
2129 were a fatal interrupt on the specified interrupt
2130 bit. For example, 1+.LZ %PIMPV will make DDT tell the
2131 user that the job received a fatal MPV interrupt. Why
2132 might a program wish to do this? It might have
2133 enabled its own handling of MPV, and then received an
2134 MPV interrupt at a time when one was not expected and
2135 was not recoverable. At such a time the ideal thing
2136 to do is to report the MPV back to DDT, so that DDT
2137 will handle it - to "pretend" that MPV wasn't enabled
2138 at all. To make the pretense complete, the program's
2139 own MPV interrupt handler should dismiss the
2140 interrupt, and leave the PC pointing at the guilty
2141 instruction, since that would be the state of things
2142 if the program had not handled the interrupt. That
2143 can be done with a special feature of the DISMIS
2144 symbolic system call, which can do a .LOSE after
2145 dismissing the interrupt and restoring the PC.
2147 This call never gets an error, and never returns.
2152 arg 1 Byte pointer to ASCIZ string specifying name for link,
2153 or AOBJN pointer to block of byte pointers,
2154 arg 2 Byte pointer to ASCIZ string specifying name to link to,
2155 or AOBJN pointer to block of byte pointers,
2158 arg 1 Left-justified "from" device.
2159 arg 2 "from" file name 1.
2160 arg 3 "from" file name 2.
2162 arg 5 "to" file name 1.
2163 arg 6 "to" file name 2.
2166 A link is created on the specified device.
2167 The only standard device which accepts links
2168 is DSK; of course, various job devices (such as
2169 the AI, ML, DM, and MC devices) also implement it.
2170 Links cause an indirection when opened
2171 for reading; writing or deleting a link affects
2173 The "from" file names are subject to file name
2174 translation. See the TRANAD and TRANDL symbolic
2177 See the SOPEN symbolic system call for a description of
2178 how the byte or AOBJN pointer arguments should be formatted
2179 and how the strings are parsed into filenames.
2181 NETAC: accept network connection OBSOLETE (ITS NCP)
2183 This system call is obsolete, and has been flushed.
2184 It is documented here for historical purposes only.
2186 arg 1 - channel # of an Arpanet NCP channel
2188 If the channel is in the RFC-received state, the
2189 connection is accepted. Use CLOSE to refuse a
2190 request for connection.
2192 See also the .NETAC UUO.
2194 This call only works for NCP and is obsolete. It isn't needed
2195 for TCP since incoming requests that satisfy a LISTEN will
2196 automatically be hooked up and the connection opened.
2200 34 WRONG TYPE DEVICE
2201 The specified channel is not an Arpanet NCP channel
2202 41 OTHER END OF PIPELINE GONE OR NOT OPEN
2203 The socket is not in the %NSRFC (request for
2204 connection received) state.
2206 NETBLK: network block (ITS NCP)
2208 arg 1 Channel number - should be a network channel.
2209 NCP, TCP, and CHAOS are allowed.
2210 arg 2 Connection state code.
2211 NCP: Socket state as returned in the right
2212 half of word 4 by the .RCHST uuo:
2213 0 %NSCLS CLS received.
2214 1 %NSLSN Listening for RFC.
2215 2 %NSRFC RFC received while listening.
2216 3 %NSRCL CLS received while in RFC received state.
2218 5 %NSOPN Connection open.
2219 6 %NSRFN RFNM wait on write link.
2220 7 %NSCLW CLS sent. Waiting for matching CLS.
2221 10 %NSCLI CLS received, but input still available.
2222 11 %NSINP Input available.
2224 TCP: basically the same as NCP. See WHYINT for state list.
2225 arg 3 Optional: address of a word containing an argument
2226 as for the .SLEEP uuo. This word must be writable,
2227 as it will be replaced by an appropriate negative
2228 number as for .SLEEP.
2229 If not supplied, positive infinity (377777,,777777)
2230 is assumed by default for the time to sleep.
2231 val 1 New connection state.
2232 val 2 Time left, in thirtieths of a second.
2233 (Meaningful only if arg 3 supplied.)
2235 The executing job hangs until one of two conditions
2236 becomes true: either the network conection associated
2237 with the specified channel enters a state different
2238 from the specified state, or the amount of time
2239 specified by arg 3 has passed.
2241 Example: suppose that a NCP socket is in state 1
2242 (listening for RFC). This call will return when
2243 the socket is no longer in that state, or after 5
2244 seconds, whichever comes first:
2246 MOVEI AC,5*30. ;five seconds
2248 SIXBIT \NETBLK\ ;network block
2249 1000,,CHNUM ;channel number
2250 1000,,%NSLSN ;old state
2252 2000,,NSTATE ;new state
2253 402000,,TLEFT ] ;time left
2257 34 WRONG TYPE DEVICE
2258 The specified channel is not a network (NCP, TCP, CHAOS) channel.
2260 NETHST: net host status (ITS NCP)
2262 arg 1 Host number (-1 for self).
2263 arg 2 Reason for going down (optional, valid
2264 only if arg 1 is -1).
2265 5 Going down for scheduled P.M.
2266 6 Going down for scheduled hardware work.
2267 7 Going down for scheduled software work.
2268 10 Going down for emergency restart.
2269 11 Going down because of power outage.
2270 12 Stopping at software breakpoint.
2271 13 Going down because of hardware failure.
2272 14 Going down because not scheduled to be up.
2273 val 2 Host number (useful if arg 1 is -1).
2274 Note THESE ARE OUT OF ORDER (because "val 1" is so long).
2276 4.9 1 => RFNM wait on link 0.
2278 4.2-4.1 Host status:
2282 3.9-3.1 Time (as returned by .RDTIME) modulo 1000
2283 the last RFNM sent on link 0.
2284 2.9-1.1 Last message from IMP about "host dead status"
2285 for this host. (See BBN Report #1822, Chapter 3.)
2286 2.7-1.5 Time host will come back up, Greenwich Mean Time:
2287 2.7-2.5 Day of week (0=Monday, ..., 6=Sunday).
2288 2.4-1.9 Hour of day (0-23.).
2289 1.8-1.5 Five-minute interval within hour (0-11.).
2290 -1 means more than a week.
2291 -2 means time coming back up is unknown.
2292 1.4-1.1 Reason host is down:
2293 1 Foreign host not communicating
2294 with network (took ready-line down
2295 without saying why).
2296 2 Foreign host not communicating with
2297 network (host was tardy in accepting
2298 network traffic without saying why).
2299 3 Foreign host does not exist, to the
2300 knowledge of the Network Control Center.
2301 4 The IMP software is preventing
2302 communication with foreign host
2303 (this usually indicates IMP software
2304 initialization at the foreign site).
2305 5 Foreign host down for scheduled P.M.
2306 6 Foreign host down for scheduled
2308 7 Foreign host down for scheduled
2310 10 Foreign host down for emergency restart.
2311 11 Foreign host down because of power outage.
2312 12 Foreign host stopped at software
2314 13 Foreign host down because of hardware
2316 14 Foreign host not scheduled to be up.
2317 17 Foreign host in process of coming up.
2319 If one argument is supplied, then the host status word
2320 for the specified host is returned. If two arguments are
2321 supplied, then the "reason for going down" word for the
2322 local host is set. (As of June 30, 1975, setting this
2323 word doesn't seem to do anything at all. Didn't the code
2324 for sending this data to the IMP ever get written??)
2326 NETIMP: network IMP status (ITS NCP)
2328 If no arguments are present, three values are returned:
2329 val 1 Last message from IMP about going down.
2330 4.9 IMP really is down now.
2332 0 "Last warning" or "panic restart";
2333 the IMP is going down in 30. seconds or less.
2334 1 Scheduled hardware P.M.
2335 2 Scheduled software reload.
2336 3 Emergency restart.
2337 val 2 Time going down, as returned by .RDTIME.
2338 val 3 Time coming back up, as returned by .RDTIME.
2340 If arguments are present, three must be present.
2341 They are used to set three default values which are returned
2342 if the IMP itself has not set the above three values.
2343 Presumably this is good for logically disabling network software?
2347 30 TOO FEW ARGUMENTS
2348 Must have either 3 arguments or no arguments.
2350 NETINT: Send network interrupt OBSOLETE (ITS NCP)
2352 This system call is obsolete, and has been flushed.
2353 It is documented here for historical purposes only.
2357 An INR or INS message is sent, depending on the send/receive
2358 gender of the socket specified by the channel #. What this does
2359 depends on the protocol being used and the program at the
2360 other end of the connection.
2362 This call only works for NCP and is obsolete.
2365 34 WRONG TYPE DEVICE
2366 The channel specified is not an Arpanet NCP channel.
2368 NETRFC: Get pending Request For Connection for a specified network
2371 %NQREF Arg 2 is a previously returned identifier,
2372 refuse connection and flush from queue.
2373 arg 1 - SIXBIT name of network
2374 one of CHAOS, TCP, or ARPNCP (obsolete)
2375 arg 2 - optional network-dependent arg
2376 for CHAOS: pointer to packet buffer
2377 for TCP: If %NQREF set, is <id>,,<port #> of request to
2378 reject (as returned from previous NETRFC call)
2379 val 1 - network-dependent value
2380 for TCP: <id>,,<port #>
2381 for ARPNCP: <id>,,<socket #>
2383 This call is intended for use by very specialized programs
2384 which ITS invokes upon receiving unsolicited requests for
2385 connections. ITS will queue the request for a short time
2386 and start an appropriate job which uses NETRFC to obtain
2387 the request and process it. Currently these programs are
2388 NCP: SYS;ATSIGN NETRFC
2390 CHAOS: SYS;ATSIGN CHAOS
2392 Normally the program will execute a NETRFC appropriate for its
2393 network, and obtain a returned request value. Accepting the
2394 request is device dependent, but refusal can always be done
2395 by calling NETRFC again with the %NQREF control bit set and
2396 furnishing the appropriate request identifier.
2398 See the CHAOSQ system call, which NETRFC is replacing.
2401 4 - TCP: No pending RFCs, or %NQREF with non-existent <id>,,<port>.
2402 12 - CHAOS: can't handle %NQREF yet.
2403 33 - Unknown network specified.
2407 cbits Device dependent. Standard bits are:
2408 2.7-2.9 0 = normal, 1 = write-over mode.
2409 1.3 0 = ascii, 1 = image.
2410 1.2 0 = unit, 1 = block.
2411 1.1 0 = read, 1 = write.
2412 arg 1 Channel number. LH XOR'd with control bits.
2413 arg 2 Left-justified device name.
2416 arg 5 Sname. If not present, defaults to executing
2417 job's current sname (see the .SNAM user variable).
2419 See also the .OPEN uuo.
2421 The file names used for opening are subject to translation.
2422 See the TRANAD and TRANDL symbolic system calls.
2424 The file names .FILE. (DIR) are special:
2425 they cause the directory for the given device
2426 (and sname, if applicable) to be read. It is
2427 illegal to write the directory. If a device has
2428 no directory, then opening .FILE. (DIR) will
2429 supply the string "NON-DIRECTORY DEVICE", presumably.
2430 (This is a function of the unknown-device handler
2431 (see below) and hence the exact results may vary).
2432 Opening a directory in ascii mode yields an
2433 ascii string for people to look at; opening it
2434 in image mode yields a device-dependent file
2435 (or possibly a MODE NOT AVAILABLE error).
2437 For the DSK device, the control bits are:
2438 1.4 %DONRF Don't set the reference date.
2439 1.5 %DONLK Don't chase links. (I. E., if
2440 this is a link, open the link itself,
2441 not the file at which the link points.
2442 1.6 %DORWT Readers wait. On output open, makes would-be
2443 readers wait till we close.
2444 2.7 %DOWOV Write-over mode. Writes on the existing
2445 file of that name, instead of replacing
2448 The file names M.F.D. (FILE) when opened for
2449 input yield a master file directory for all
2450 disks. In ascii mode this is an ascii string
2451 containing the names of all directories, separated
2452 by a cr/lf sequence.
2454 The file names ..NEW. (UDIR) cause a new directory
2455 to be created with the given sname if none already
2456 exists. Creating a directory in this way causes a
2457 message to be printed on the system console.
2458 (A directory is destroyed only when the disks are
2459 salvaged by the stand-alone salvager, which is generally
2460 run just before the time-sharing system is restarted.
2461 A directory is then destroyed iff it contains no files.)
2463 If < or > is used as a file name, it is treated
2464 specially according to an algorithm no one
2465 understands, but which attempts to let it stand
2466 for the numerically smallest or largest file name
2467 among those in the directory. In particular,
2468 if you call your files FOO nnn, where nnn is a version
2469 number, then reading FOO > will read in the latest
2470 version, writing FOO > will write out a version
2471 one higher than the latest one (or FOO 1 if there
2472 is no file named FOO nnn), and deleting FOO <
2473 will delete the oldest one. Writing FOO < doesn't
2474 recreate an old file; it is the same as FOO >.
2475 If a file with numbers and letters in its name,
2476 for example FOO BAR27, already exists,
2477 writing FOO > will generate FOO BAR28
2478 and not FOO 1. Letters to the right of numbers are
2479 generally ignored as far as < and > are concerned.
2481 Note that < and > may be used as first
2482 file names as well; this is mainly useful for the
2483 .LPTR. directory. It is illegal to use < or > for
2484 both file names at once.
2486 The SYS device ignores the sname, and otherwise
2487 is like using the device-sname pair DSK:SYS; .
2488 Writing new files or altering old ones on the SYS
2489 device (or even on DSK:SYS;) causes a message to
2490 appear on the system console documenting who the
2491 culprit is and what he did. This is because system
2492 programs and other files critical to system operation
2493 are kept on SYS:. In fact this applies to writing
2494 or altering files on any disk directory whose name
2495 begins with the three letters "SYS". Standard
2496 directories whose names begin with "SYS" include:
2497 SYS1 Extension for SYS directory (holds programs).
2498 SYS2 Extension for SYS directory (holds programs).
2499 SYS3 Extension for SYS directory (holds programs).
2500 SYSENG Source files for many system programs.
2501 SYSEN1 Extension for SYSENG directory.
2502 SYSEN2 Extension for SYSENG directory.
2503 SYSBIN Binary files for many system programs.
2504 SYSTEM Files having to do with ITS itself.
2505 SYSDOC Documentation for ITS itself.
2506 SYSNET Files having to do with Chaosnet and TCP.
2508 The COM device ignores the sname, and otherwise
2509 is like using the device-sname pair DSK:COMMON; .
2511 The TPL device ignores the sname, and otherwise
2512 is like using the device-sname pair DSK:.LPTR.; .
2513 (On systems without lineprinters the TPL device is
2514 generally just a JOB device.)
2515 On output, it furthermore ignores the file names,
2516 and instead uses the uname of the opening job as
2517 the second file name, and randomly generates a
2518 first file name. The system job prints files
2519 it finds on .LPTR. on the line printer, whenever it
2520 has nothing better to do and the line printer happens
2521 to be free; these files are subsequently deleted.
2522 Thus the TPL device provides a printer spooling facility.
2523 Attempts to rename a file on the TPL device are
2524 ignored, because the name controls the spooling order.
2526 For the LPT device, opening succeeds only if no one
2527 has the LPT, or the same user already has the LPT;
2528 in the former case the opening job must be in a tree
2529 controlled by a "local" tty as defined by its TTYTYP
2530 variable. In all other cases the OPEN is converted
2531 to use the TPL device instead.
2533 For the USR device, the file names should be the
2534 uname-jname pair of the job to open. If the uname is
2535 zero, it is equivalent to using the uname of the
2536 job doing the call. If the jname is zero, then the
2537 uname is interpreted as a <JOB> specification;
2538 in this way one can open a job given its user index.
2539 A jname of PDP6 or PDP10 opens up the PDP-6
2540 as the "job". (PDP10 as a jname goes back to the
2541 days when the PDP-6 ran ITS and the PDP-10 was the
2542 auxiliary processor!)
2544 1.4 Insist on opening an already existing job;
2545 i.e. do not create a new one. The job will
2546 be opened as a foreign job, not as an inferior.
2547 Here is an algorithm for deciding whether job Y will
2548 be a direct inferior or merely a foreign job when
2550 (DEFUN USR-OPEN-RESULT (X Y BIT-1*4)
2551 (COND (BIT-1*4 (COND ((EXISTS Y) 'FOREIGN)
2554 (COND ((INFERIOR Y X) 'INFERIOR)
2555 ((DISOWNED X) 'FOREIGN)
2556 ((NOT (DISOWNED Y)) 'FOREIGN)
2558 (MAKE-NON-DISOWNED Y)
2559 (CHANGE-ALL-UNAMES Y (UNAME X))
2560 (FIX-UP-TTY-CHANNELS Y)
2563 ((= (UNAME X) (UNAME Y))
2570 For the ERR device, the first file name must be
2571 numerically 1, 2, 3, or 4. If it is 1, then the .IOS
2572 word specified by the user variable .BCHN is
2573 examined. If it is 2, the .IOS word for the channel
2574 numerically specified by the second file name is
2575 examined. If it is 3, the second file name is itself
2576 the status word. Bits 3.1-4.5 of the specified word
2577 yield a the number of an error message which can then
2578 be read from the open ERR device. If the first file
2579 name is 4, the second file name must be the value
2580 returned into an error code return argument by a symbolic
2581 system .CALL that didn't skip. The corresponding error
2582 message can be read from the open ERR device.
2584 For TTY and Tnn devices (terminals in general),
2585 some of the control bits set first-time options,
2586 and some are per-channel. Those which are per-channel
2587 are marked below with a *. The standard names for
2588 these bits are also given. (ITS TTY)
2589 Control bits on input:
2590 2.6 * %TIECH Read even if char needs pi echoing
2591 2.5 * %TIPEK Don't remove char from buffer (peek)
2592 2.3 * %TIACT Don't wait for activation char
2593 2.2 * %TIINT Read even if char is an interrupt
2594 char and hasn't interrupted yet.
2596 2.1 * %TINWT Do not wait for input. If no input
2597 is available, return -1 in unit mode, or
2598 return a partially filled block in block mode.
2599 1.9 * %TIFUL Use the full TV character set if possible.
2600 In this mode, characters have this form:
2602 2.2 Obsolete. Used to be Shift lock.
2603 2.1 %TXSUP Super. Used to be Shift.
2606 1.7-1.1 %TXASC Ascii part of character.
2607 Of course, for non-TV's only %TXASC
2609 1.6 Set up 3 line echo area (like SCML of 3).
2610 1.4 "DDT" mode. Initially clear the %TGPIE and
2611 %TGMPE bits for carriage return, line feed,
2612 and tab, thus causing them not to echo.
2613 1.3 Image mode. Initially clear the %TGPIE
2614 and %TGMPE bits for all characters.
2615 1.2 0 = unit mode, 1 = block mode. In block mode,
2616 ^C causes a block mode end of file.
2618 Control bits on output:
2619 2.6 * %TJECH Echo mode output.
2620 2.5 * %TJCTN Don't do line continuation.
2621 2.4 * %TJSTP Channel is hung in **MORE**.
2622 Unusual in that the system modifies this bit.
2623 2.3 * %TJDIS Recognize ^P cursor codes.
2624 2.2 * %TJSIO Super-image output. No padding
2625 or cursor control is performed.
2626 2.1 * %TJMOR Do not do **MORE** processing.
2627 1.9 * %TJPP2 Output in the echo area if it exists.
2628 1.6 Same as 2.2 - turns on %TJSIO.
2629 1.5 Same as 2.3 - turns on %TJDIS.
2630 1.4 Turns on %TJECH, %TJPP2, %TJMOR.
2631 1.3 Image mode. Initially set %TGIMG bits
2633 1.2 0 = unit mode, 1 = block mode. In block mode
2634 output all ^C's are ignored.
2637 For STY device input, control bit 1.4 means that
2638 input IOTs, instead of hanging, will input a -1 in
2639 unit mode or not count out the AOBJN pointer in block
2640 mode (see ITS TTY for details).
2641 For STY output, control bit 1.4 means that output IOTs,
2642 instead of hanging when the tty's input buffer is full,
2643 will cause a ^G to be output, just as on normal ttys.
2644 Control bit 1.5, on input or output, causes a %TDORS
2645 character to be available as input when an output
2646 reset is done on the sty's alter ego.
2647 Control bit 1.3 is copied into the %TOHDX bit of the
2648 associated tty, thus making it half-duplex if set.
2649 These control bits are not per-channel, but rather
2650 will affect all channels open on the same STY.
2652 For the PTR and PTP devices (paper tape reader and
2653 punch), if the 1.4 control bit is on, then the 1.2 bit
2654 must be 0 and the 1.3 bit is ignored. In this mode
2655 all eight paper tape channels may be read or punched.
2657 For the NET device, the arguments are as follows:
2658 cbits 2.1-2.6 byte size for image mode
2659 1.7 Use 8 times as large a buffer.
2660 1.6 If ascii mode, use 8-bit bytes
2661 instead of 7-bit bytes.
2662 If image mode, use byte size in
2664 1.5 Open socket in listen mode.
2665 1.4 0 = use arg 3 as local socket number.
2666 1 = generate unique local socket number.
2667 (A generated socket number can be examined
2668 after opening by using the .RCHST uuo).
2670 arg 1 Channel number.
2671 arg 2 Left-justified device name (i.e. NET).
2672 arg 3 Local socket number.
2673 arg 4 Foreign socket number.
2674 arg 5 Foreign host number.
2676 For the STK device (Stanford keyboard):
2677 cbits 1.7 If 1.6 = 1 and 1.5 = 0,
2678 then don't input the meta bit.
2679 1.6 0 = Stanford mode:
2682 top+shift+others generate 0-177
2685 ctrl means ctrl, and works
2686 with others to generate 0-177
2687 1.5 0 = convert according to 1.6-1.7.
2688 1 = don't convert characters.
2689 1.4 Don't hang if no character
2690 available for input - return -1
2693 If the device name used in the OPEN is not one known to
2694 to the system, the "unknown-device handler" is invoked.
2695 The system creates a job device and loads SYS:ATSIGN DEVICE
2696 into it; this program then has the responsibility for
2697 handling the OPEN. The normal action of this program is
2698 to look for a file DSK:DEVICE;JOBDEV <name>, where <name>
2699 is the requested device name. For example, if an attempt
2700 is made to OPEN the FOOBAR device, and the file
2701 DSK:DEVICE;JOBDEV FOOBAR exists, the program contained in
2702 this file will be used to interpret the OPEN via the JOB device.
2703 If such a file does not exist, but the device name has trailing
2704 digits, the unknown-device handler will try stripping successive
2705 trailing digits and retrying. For example, opening the
2706 AR1 device causes the unknown-device handler to look first for
2707 JOBDEV AR1, and then for JOBDEV AR. If the handler succeeds,
2708 it sets device name for PEEK and who-lines to the second
2709 file name that finally succeeded (see the JOBSTS symbolic
2711 The unknown-device handler also handles requests for the
2712 directories of certain built-in devices whose directories
2713 are seldom asked for. If there is nothing better to return for
2714 a directory, the string "NON-DIRECTORY DEVICE" is returned.
2718 OPEN can return many errors. The following errors in
2719 particular are relevant to OPEN on the DSK device:
2722 The specified directory exists, but the specified file
2725 There is no room in the directory to create an entry
2726 for the new output file.
2728 The disk pack containing the file is offline (should
2729 never really happen).
2730 10 DEVICE NOT AVAILABLE
2731 a specific unit was selected, by opening DKn, and that
2732 unit is off-line or contains a reserved pack. Or, a
2733 specific pack was selected by opening PKn or Pnn,
2734 and that pack is reserved. The reserved-pack check
2735 only applies when writing. Reserved means secondary-pack,
2736 or reserved for the exclusive use of certain directories.
2737 11 ILLEGAL FILE NAME
2738 One or both file names were zero; or, for an output file,
2739 the file names were M.F.D. (FILE) or .FILE. (DIR), which
2740 are names reserved for directories.
2741 12 MODE NOT AVAILABLE
2742 Control bits 2.9-2.7 specified an illegal mode.
2743 14 BAD CHANNEL NUMBER
2744 This is a RENMWO error.
2746 The pack specified by opening PKn or Pnn is not
2747 mounted, or the pack containing the file being read
2749 20 NON-EXISTENT DIRECTORY
2750 The specified directory does not exist.
2751 22 SELF-CONTRADICTORY OPEN
2752 Control bits 2.9-2.7 specified an illegal mode.
2754 An attempt to open a file in write-over mode failed
2755 because someone has the file open for reading; or
2756 an attempt to open a file for read, write-over, rename,
2757 or delete failed because someone is writing the file
2758 or because the file has been deleted, but hasn't gone
2759 away yet because someone is reading it (i.e. there is
2760 a star next to it in the directory listing.) wait a while
2763 Cannot create a new directory because the master file directory
2765 27 LINK DEPTH EXCEEDED
2766 Links may not be chained to a length of greater than 100 links.
2767 This error probably means a circular chain of links.
2768 47 LINK TO NON-EXISTENT FILE
2769 Error 4 or 20 occurred after following a link.
2771 PDUMP: pure dump a job
2774 arg 2 Disk output channel number.
2775 Should have been freshly opened
2777 arg 3 State word; should be 0 initially.
2778 This word is updated as the PDUMP
2779 progresses; a value of 400000,,<n> means
2780 that page <n> is about to be dumped.
2782 The pages of the specified job are dumped onto
2783 the disk file in a form that can be efficiently
2784 loaded. In particular, information as to whether
2785 each page is read-only or not is saved so that
2786 when the program is run it can be swapped
2787 efficiently. If the same file is loaded into
2788 several jobs, they will all share the same
2789 physical copies of the read-only pages.
2790 In addition, absolute pages are remembered.
2791 A number of 2000-word (1K) blocks are dumped onto
2792 the file. The first block is as follows:
2793 wd 0 Contains zero. This distinguishes
2794 PDUMP'ed programs from, for example,
2796 wds 1-400 Word <n> contains information about
2797 block <n-1> of the dumped job. This
2798 information is as follows:
2799 4.9 Absolute page (shared with system).
2800 2.9-2.8 00 Non-existent page.
2802 10,11 Read/write page.
2803 2.2-1.1 If 4.9=1, absolute page number.
2805 wds 1000-1017 The contents of the accumulators.
2806 Note that the accumulators aren't part of
2807 any page, so they wouldn't be saved if it were
2808 not for this special hack.
2809 The following blocks of the file are the successive
2810 pages of the job, but only those which need to be dumped.
2811 That is, absolute and non-existent pages are not dumped.
2812 Thus, suppose the pages of a job are laid out as follows:
2815 pg 6-7 Absolute (e.g., system symbol table).
2818 others Non-existent.
2819 Then nine blocks would be dumped out:
2820 blk 0 Descriptor block.
2823 blk 7 Page 100 (octal).
2824 blk 10 Page 200 (octal).
2825 This is all that PDUMP writes out, leaving the file's access
2826 pointer at the end of the last block written. At this point
2827 the job doing the PDUMP will normally write out the
2828 symbol table, if any, for the dumped job onto the disk
2829 channel, preceded and followed by JUMPA instructions
2830 containing the starting address. When this is done,
2831 the resulting file can be loaded and run as a program
2833 See the LOAD symbolic system call.
2837 14 BAD CHANNEL NUMBER
2839 Can't dump the PDP-6 job.
2840 34 WRONG TYPE DEVICE
2841 First argument was some oddball channel, or
2842 second argument was not a disk output channel number.
2845 PGWRIT: Cause page to be written to disk
2847 arg 1 (Optional) A <JOB>
2848 arg 2 Virtual page number within that job (a number from 0 to 377).
2850 1.1 1 => don't wait for the page to finish getting written out,
2851 return immediately. Issue the call again with this bit 0
2852 if you later want to wait for it to get written out.
2853 1.2 1 => unlock the page.
2854 0 => if the page is locked, swap it out anyway, but when it
2855 next gets swapped in again it will be locked again.
2857 If there is only one argument, it is arg 2. The <JOB> is
2858 assumed to be the job issuing the call.
2860 The disk copy of the specified page is brought up to date;
2861 if the in-core copy has been modified by the specified <JOB>
2862 the page is written out. The PGDUMP call does not return until
2863 the disk has finished recording the page.
2865 This is useful when pages of a file have been mapped into
2866 the user's address space.
2868 If the page cannot be swapped out because no disk space is available,
2869 or some job that is using it cannot be pclsr'ed, it waits a while
2870 and tries again. It does not return.
2872 This call used to be called PGDUMP, but the name was
2873 changed to avoid confusion with PDUMP.
2877 12 MODE NOT AVAILABLE
2878 Page is absolute or tied down by exec pages.
2879 14 BAD CHANNEL NUMBER
2880 The <JOB> argument is invalid.
2882 Executing job doesn't have modification rights to the job
2883 specified by argument 1.
2884 32 CAN'T GET THAT ACCESS TO PAGE
2885 The page number in argument 2 is not between 0 and 377; or the
2886 job does not have a page at that position in its address space.
2887 34 WRONG TYPE DEVICE
2888 The <JOB> specifies the pdp-6, which does not have paging.
2890 The <JOB> argument specified a non-existent job.
2892 PKTIOT: transfer one Chaosnet packet <MOON;CHAORD>
2893 arg 1 - channel number
2894 arg 2 - address of a 126.-word block.
2896 Always transfers exactly one packet.
2897 The format of the 126.-word block is:
2899 -----------------------------------------
2900 | opcode | unused | fc | nbytes | 0 |
2901 -----------------------------------------
2902 |destination host |destination index| 0 |
2903 -----------------------------------------
2904 | source host | source index | 0 |
2905 -----------------------------------------
2906 | packet # | ack packet # | 0 |
2907 -----------------------------------------
2911 -----------------------------------------
2913 For details of how to use these packets, see the Chaosnet
2914 protocol documentation.
2916 RAUTH: read a file's author.
2918 arg 1 Number of a channel open on the DSK device,
2921 val 1 Sixbit name of the file's author (the last
2922 person to write on the file.)
2924 RCHST: read channel status.
2925 Note: This system call is obsolete. Use the RFNAME,
2926 RFPNTR, or WHYINT system call to obtain the
2927 information you want.
2929 arg 1 channel number
2931 val 1 The fullword sixbit name of the device open
2932 on the specified channel, or 0 if the channel
2934 val 2 The first file name of the file open on the
2935 channel, or 0 if filenames mean nothing on
2936 the device which is open.
2937 val 3 The second file name, or 0.
2938 val 4 The directory name of the open file, assuming
2939 that "directory name" has some meaning for the
2940 device which is in use; otherwise, 0.
2941 val 5 The channel's access pointer, if it is randomly
2942 accessible; otherwise, -1.
2943 val 6...additional device-dependent results
2945 The values may not be the same as the filenames, etc.
2946 that were used to open the channel. The results of
2947 this call are quite device-dependent.
2948 in the open-mode returned by RCHST.
2950 The following devices return the access pointer as -1
2951 and the filenames and directory name as 0:
2952 NUL LPT NVD PLT PTP IMX OMX
2953 PTR DIS IDS COD TVC TAB MT0
2956 The data stored by other specific devices is described below.
2957 If a specific numbered value is not mentioned, then the default
2958 is returned by that device - 0 for values 2, 3 and 4;
2962 val 1 The device name
2963 val 2 sixbit/.FILE./
2965 val 4 the directory name, on a multi-directory device
2969 val 2 sixbit/M.F.D./
2970 val 3 sixbit/(FILE)/
2975 val 3 a word in the format of a channel status word,
2976 which has the error codes that the ERR device
2992 USR (including PDP-6)
2997 val 5 Access pointer.
3003 val 4 Uname assigned to, or zero if none (see the .ASSIGN uuo).
3015 val 4 Directory name.
3016 val 5 Access pointer. May be a byte pointer if character mode.
3020 val 2 Uname of creator (zero if he has gone away).
3021 val 3 Jname of creator (zero if he has gone away).
3024 vals 1-n Whatever the job device decides to return.
3025 See the JOBSTS and JOBRET symbolic system calls.
3026 Note that the job sets the results for vals 1-4 once
3027 using the JOBSTS call, and only the values 5, 6, ...
3028 are taken from the JOBRET that responds to the RCHST.
3032 val 2 Local socket number.
3033 val 3 Foreign socket number.
3034 val 4 4.9 Network interrupt (INR/INS) received.
3036 1.9-1.1 Foreign host number.
3037 val 5 4.9-3.1 Time until IMP goes down, in thirtieths
3040 -1 => IMP doesn't plan to go down.
3041 2.9-1.1 Socket state:
3042 0 %NSCLS CLS received. val 6 gives reason.
3043 1 %NSLSN Listening for RFC.
3044 2 %NSRFC RFC received while listening.
3045 3 %NSRCL CLS received while in RFC received state.
3047 5 %NSOPN Connection open.
3048 6 %NSRFN RFNM wait on write link.
3049 7 %NSCLW CLS sent. Waiting for matching CLS.
3050 10 %NSCLI CLS received, but input still available.
3051 11 %NSINP Input available.
3052 val 7 Reason for closing:
3053 0 %NCNTO Never open.
3054 1 %NCUSR Closed by user.
3055 2 %NCFRN Closed by foreign host.
3056 3 %NCRST Foreign host Reset itself.
3057 4 %NCDED Foreign host dead.
3058 5 %NCINC Incomplete transmission.
3059 6 %NCBYT Byte size mismatch.
3060 7 %NCNCP Local NCP went down.
3061 10 %NCRFS Connection refused.
3062 val 8 Input: number of bits available.
3063 Output: number of bits of buffer free.
3068 val 3 Foreign port #
3069 val 4 Foreign net address (HOSTS3 format)
3072 val 1 SIXBIT /CHAOS/
3075 val 4 Foreign net address (HOSTS3 format)
3082 val 1 SIXBIT /DIRHNG/
3085 val 4 Directory name
3091 RCPOS: read cursor position (ITS TTY)
3093 arg 1 <TTY> or <JOBDEV>
3094 val 1 Main program area cursor position.
3095 val 2 Echo area cursor position.
3097 Each cursor position is returned as a word with the
3098 vertical position in the left half and the horizontal
3099 position in the right half.
3100 See the SCML symbolic system call for setting up an
3103 RDDMST: read demon status
3105 arg 1 Either the sixbit name or the user index
3107 val 1 If arg 1 was the sixbit name, the user index;
3108 if it was the user index, the sixbit name.
3109 val 2 4.9-3.1 If non-zero, the time in two-minute ticks
3110 between automatic signals for the demon.
3111 2.9-1.1 Number of requests pending for the demon.
3112 val 3 Time in two-minute ticks until the next automatic
3113 signal will occur (meaningful only if arg 2 bits
3116 See also the DEMSIG and STDMST symbolic system calls,
3119 RDMPBT: read dump bit
3121 arg 1 Disk channel number or <JOBDEV>
3122 val 1 A word, all zero, except with the dump check
3123 bit for the file in bit 1.1.
3125 The dump check bit is used by the magtape file backup
3126 system to keep track of which files have been backed
3127 up on magtape. This bit therefore should not be
3128 twiddled light-heartedly. The "!" you sometimes see
3129 in front of a date in a disk file directory is present
3130 iff the dump check bit for the file is zero.
3132 See also the .DMPCH uuo and the SDMPBT
3133 symbolic system call.
3135 RELOAD: reload top-level job (ITS DETACH)
3137 No arguments or values. Note, however, that an
3138 argument of some kind must be supplied so that the
3139 SETZ bit may be present to terminate the set of
3142 The executing job must be the top level job of
3143 a non-disowned job tree.
3145 Most of the job's system variables are initialized;
3146 the file SYS:ATSIGN <jname> is then loaded and
3147 started up, where <jname> is the jname of the job
3148 (see the .JNAME user variable).
3149 For example, if the jname of the job is HACTRN,
3150 then the file SYS:ATSIGN HACTRN (which is DDT)
3151 is loaded and started. This is how DDT performs
3152 the
\eU. command. Note that the translation lists for
3153 the job are not cleared before this loading; thus one
3154 can translate the file names SYS:ATSIGN <jname> and
3155 cause a different file to be loaded.
3157 More specifically, the way the job is loaded is that
3158 the following program is put into the job's ac's
3159 and started at location 0:
3161 0/ JFCL ;unused word
3162 1/ .OPEN 1,7 ;open up file SYS:ATSIGN <jname>
3163 2/ JRST 0 ;retry on failure
3164 3/ .CALL 12 ;load up program
3165 4/ .LOGOUT ;logout if loading fails
3166 5/ .IOT 1,2 ;read in starting address
3167 6/ JRST (2) ;go there
3168 7/ 4,,'SYS ;SYS device, image unit input
3170 11/ 0 ;<jname> is placed here
3172 13/ SIXBIT \LOAD\ ;load file into job
3173 14/ 16 ;job specification
3174 15/ SETZ 17 ;channel number
3176 17/ 1 ;channel number is 1
3178 Typically the first thing a job used as a top level
3179 (such as DDT) does is close channel 1. Now you know
3180 why. The LOAD system call leaves channel 1 open
3181 so that the start address and symbol table can be
3188 RENAME: rename a file
3191 arg 1 Byte pointer to ASCIZ string specifying the old name,
3192 or AOBJN pointer to block of byte pointers,
3193 arg 2 Byte pointer to ASCIZ string specifying the new name,
3194 or AOBJN pointer to block of byte pointers,
3197 arg 1 Left-justified device name.
3198 arg 2 Old file name 1.
3199 arg 3 Old file name 2.
3200 arg 4 Sname. If zero, the executing job's sname
3201 is used (see the .SNAM user variable).
3202 arg 5 New file name 1.
3203 arg 6 New file name 2.
3205 The file specified by the first four names is renamed
3206 according to the last two. It is not possible to
3207 "rename" a file into a new directory or device.
3208 Attempting to rename to an already existing file will
3209 fail with error code 13 (File already exists).
3211 The old file names are subject to file name translation.
3212 See the TRANAD and TRANDL symbolic system calls.
3214 See the SOPEN symbolic system call for how the byte or AOBJN
3215 pointer argument should be formatted and how the string(s) are
3218 See also the .FDELE uuo.
3220 RENMWO: rename while open
3223 arg 1 Channel number of channel with file open on it.
3224 arg 2 Byte pointer to ASCIZ string specifying the new name,
3225 or AOBJN pointer to block of byte pointers,
3228 arg 1 Channel number of channel with file open on it.
3229 arg 2 New file name 1.
3230 arg 3 New file name 2.
3232 The file open on the specified channel is renamed
3233 according to the specified names.
3235 Ordinarily this is used in connection with output. Often
3236 one opens a file for output with artificial file names, for
3237 instance _TECO_ OUTPUT, instead of the real desired names.
3238 This is so that if something should happen, causing the
3239 channel to be closed before writing to the file is finished,
3240 any previous file with the desired names will not be
3241 replaced by the new, incomplete file. When all the
3242 necessary data have been written into the file,
3243 one RENMWO's to the desired names and then CLOSE's.
3244 This causes the new, good file to replace the old one of
3245 the same names. (By convention, file names beginning
3246 with "_" are artificial names reserved for this purpose.
3247 Ordinarily a program FOO will use the first file name
3248 _FOO_ and a second file name indicating the nature of
3249 the output file; thus _FOO_ OUTPUT, _FOO_ CRFOUT,
3252 See the SOPEN symbolic system call for how the byte or AOBJN
3253 pointer argument should be formatted and how the string(s) are
3256 See also the .FDELE uuo.
3258 REOWN: re-own a disowned job
3262 The foreign job open on the specified channel is made
3263 an inferior of the current job. The sub-tree of that job
3264 becomes part of the sub-tree of the current job. The UNAMEs
3265 of the specified job and all its inferiors are changed to
3266 the UNAME of the current job. The JNAMEs are altered where
3267 necessary to keep all UNAME-JNAME pairs in the system unique.
3272 The current job already has the maximum number of inferiors (8).
3274 The specified job is not top-level, or not disowned.
3275 34 WRONG TYPE DEVICE
3276 Specified channel is not open on the USR device,
3277 or the job is already an inferior of the current job.
3278 42 JOB GONE OR GOING AWAY
3279 The specified job is in the process of logging out.
3281 RESET: reset input/output channel
3283 arg 1 Channel number.
3285 See also the .RESET uuo.
3287 This is a device-dependent operation. In general
3288 the intent is to reset the state of the device to
3289 some standard setting.
3292 If the particular TTY involved is the console,
3293 wait until the executing job possesses the tty.
3294 (If the %TBINT bit is set for the job, give a
3295 word 1 interrupt on bit 4.2 if the job doesn't
3296 have the tty.) If the TTY is in communicate mode,
3297 wait until it leaves communicate mode.
3298 All characters pending in the input buffer are
3299 thrown away. Any interrupt characters which have
3300 not yet interrupted will not interrupt. Any echoing
3301 characters which have not yet echoed will not echo.
3304 If the particular TTY involved is the console,
3305 wait until the executing job possesses the tty.
3306 (If the %TBINT bit is set for the job, give a
3307 word 1 interrupt on bit 4.2 if the job doesn't
3308 have the tty.) If the TTY is in communicate mode,
3309 wait until it leaves communicate mode.
3310 Any characters in the output buffer are thrown away
3311 iff the %TPORS bit is 1. If the channel was hung in
3312 a **MORE**, the **MORE** is forgotten. If the job
3313 was interrupted in the middle of ^P code typeout,
3314 the ^P is forgotten. Other oddball state bits are
3315 also reset to their normal state.
3316 If the intelligent terminal protocol is in use on
3317 the tty, then a %TDORS code will be sent to it,
3318 and a reply stating the terminal's actual cursor
3319 position awaited before any more output is allowed.
3320 See the description of this protocol in the TTY documentation.
3323 This is like doing a .UCLOSE and then re-opening the
3324 job, but with less overhead. All pages of the job
3325 are flushed, and a single page, page 0, is created
3326 and cleared. All resource variables and other variables
3327 are initialized. The %TBNOT and %TBDTY bits are set
3328 in the .TTY variable. The .SNAM variable is initialized
3329 to the uname of the job. The .40ADDR variable is set
3330 to 40 octal. The .APRC variable is set to 447 octal.
3333 The line currently being physically output is terminated
3334 and output. All characters pending in the output buffer
3335 are flushed. The printer is skipped to a new page.
3338 All buffered plotter commands are flushed.
3341 All buffered input characters are flushed.
3344 All buffered output characters are flushed.
3347 All buffered output characters are flushed.
3350 The core of the PDP-6 is cleared. If it is running,
3351 this should cause it to loop, executing the zero word
3352 in location 41. A routine is then placed in core to
3353 clear the PI flags, clear the processor flags, release
3354 all shared devices, clear the accumulators, and finally
3355 clear itself from core. If the routine fails to run
3356 (the PDP-6 is not running), then the routine is cleared
3357 out of the PDP-6 memory again anyway.
3360 Any pending interrupt (INR or INS) is cleared.
3363 Currently does nothing.
3365 For the Chaosnet (channels opened with CHAOSO):
3369 An input reset is much like an output reset for the
3370 tty which is the STY's alter ego; similarly, an output
3371 reset is much like an input reset for the associated tty.
3372 One difference is that a STY input reset does not
3373 reset certain channel-related bits that a tty output
3374 reset would; on the other hand, it always succeeds in
3375 flushing characters even if the %TPORS bit is not set.
3378 All buffered input characters are flushed.
3380 RESRDT: restore file reference date
3382 arg 1 Disk channel number or <JOBDEV>
3384 The reference date for the disk file is restored to
3385 its value prior to the opening of the file.
3386 Note that control bit 1.4 avoids setting the
3387 reference date when a disk file is opened. See
3388 the OPEN symbolic system call.
3390 See also the DSKUPD, FILBLK, RQDATE and SRDATE symbolic
3393 RFDATE: read file creation date
3395 arg 1 Disk channel number or <JOBDEV>
3396 val 1 The creation date of the file:
3397 4.7-4.1 Year (mod 100.).
3398 3.9-3.6 Month (January = 1).
3399 3.5-3.1 Day of month.
3400 2.9-1.1 Time of creation, in half-seconds
3403 See also the RQDATE and SFDATE symbolic system calls.
3405 RFNAME: read name of file channel is open to
3407 arg 1 <JOB> whose channel should be read. (OPTIONAL)
3408 If omitted, self is assumed.
3409 arg 2 channel number
3410 arg 3 Optional byte pointer to store ASCIZ filename string through.
3411 arg 4 Optional maximum number of characters to store.
3413 val 1 The fullword sixbit name of the device open
3414 on the specified channel, or 0 if the channel
3416 val 2 The first file name of the file open on the
3417 channel, or 0 if filenames mean nothing on
3418 the device which is open.
3419 val 3 The second file name, or 0.
3420 val 4 The directory name of the open file, assuming
3421 that "directory name" has some meaning for the
3422 device which is in use; otherwise, 0.
3423 val 5 The mode in which the channel is open.
3425 The filenames and mode as described by the RFNAME may
3426 not be the same as those specified in the original open.
3427 That is because they are intended to be the "real"
3428 filenames, etc., as opposed to those that were specified.
3429 In other words, they are supposed to be the canonical
3430 arguments to specify to attempt to re-open the file.
3431 For example, the results of filename translation and
3432 link following will show up in the names returned by
3433 RFNAME, as opposed to the translated names or the names
3434 of the link that was followed. Similarly, if COM or SYS
3435 is opened, RFNAME will return DSK:COMMON; or DSK:SYS;
3436 since COM and SYS are equivalent to those disk directories.
3437 The core link devices CLO, CLU, CLA and CLI
3438 perform different functions when first opened, but after the
3439 open they result in indistinguishable channels, and the file
3440 could be re-opened in any case by specifying CLO with the
3441 right filenames, so RFNAME will for all four devices return
3442 the device name CLO.
3443 Some open-mode bits also have only an initial effect, and
3444 they too are likely to be missing (or else always present!)
3445 in the open-mode returned by RFNAME.
3448 The following devices return the filenames and directory name as 0:
3449 NUL LPT NVD PLT PTP IMX OMX
3450 PTR DIS IDS COD TVC TAB MT0
3453 The data stored by other specific devices is described below.
3454 If a specific numbered value is not mentioned, then the default
3455 is returned by that device - 0 for values 2, 3 and 4;
3456 bits 1.1, 1.2, 1.3 with their standard meanings
3457 for the open-mode (value 5).
3460 val 1 The device name
3461 val 2 sixbit/.FILE./
3463 val 4 the directory name, on a multi-directory device
3467 val 2 sixbit/M.F.D./
3468 val 3 sixbit/(FILE)/
3473 val 3 a word in the format of a channel status word,
3474 which has the error codes that the ERR device
3482 val 5 see TTY as a device
3486 val 5 Bits 1.1 and 1.2 are standard.
3487 For output channels, all the %TJ... bits
3488 are returned also as they were in the OPEN.
3489 For input channels, all the %TI... bits are
3490 returned as they were specfied in the OPEN.
3494 val 5 All the bits of a STY open are returned.
3496 USR (including PDP-6)
3501 val 5 bits 1.1 and 1.2 as standard
3502 bit 1.4 1 if the job is not an inferior
3503 of the job which has it open.
3509 val 4 Uname assigned to, or zero if none (see the .ASSIGN uuo).
3521 val 4 Directory name.
3525 val 2 Uname of creator (zero if he has gone away).
3526 val 3 Jname of creator (zero if he has gone away).
3529 vals 1-n Whatever the job device decides to return.
3530 See the JOBSTS system call. Note that the JOB device
3531 is not specifically consulted when the RFNAME call is
3532 given; it sets up the file names and open mode once
3533 and then these values are returned whenever a user
3534 asks for them with RFNAME.
3537 Note that val 4 is slightly nonstandard.
3539 val 2 Local socket number.
3540 val 3 Foreign socket number.
3541 val 4 4.9 Network interrupt (INR/INS) received.
3543 1.9-1.1 Foreign host number.
3548 val 3 Foreign port #
3549 val 4 Foreign net address (HOSTS3 format)
3552 val 1 SIXBIT /CHAOS/
3555 val 4 Foreign net address (HOSTS3 format)
3556 val 5 0 or 1 (i.e. .UAI or .UAO)
3563 val 1 SIXBIT /DIRHNG/
3566 val 4 Directory name
3572 RFPNTR: read channel's random access pointer
3574 arg 1 channel # (or <JOBDEV>)
3576 val 1 random access pointer
3577 val 2 channel byte size. The acces pointer
3578 is in terms of bytes of this size.
3580 The random access pointer is the number of bytes
3581 into the file at which the next reading or writing
3582 operation will occur.
3584 See also the ACCESS system call, the .ACCESS UUO,
3585 the RCHST system call, and the .RCHST UUO.
3589 34 WRONG TYPE DEVICE
3590 The device open on the specified channel is not random-access.
3592 RQDATE: read disk format date
3594 val 1 Current date and time in disk format:
3595 4.7-4.1 Year (mod 100.).
3596 3.9-3.6 Month (January = 1).
3597 3.5-3.1 Day of month.
3598 2.9-1.1 Time in half-seconds after midnight.
3599 If date and time are unknown, -1 is returned.
3600 val 2 Date and time the system came up in disk format.
3601 If date and time are unknown, -1 is returned.
3603 See also the DSKUPD, FILBLK, RESRDT, RFDATE, and SFDATE
3604 symbolic system calls.
3606 RSSIZE: read screen size (ITS TTY)
3608 arg 1 <TTY> or <JOBDEV>
3609 val 1 Vertical size of screen (huge if printing).
3610 val 2 Horizontal size of screen (print width).
3612 See also the CNSGET and CNSSET symbolic system calls.
3614 SAUTH: set a file's author
3616 arg 1 The number of a channel open on the DSK
3617 device, or a <JOBDEV>.
3619 arg 2 The sixbit name of the file's author.
3621 Note: the author is actually stored as a directory
3622 number, so if the author does not have a directory
3623 SIXBIT /______/ will be substituted. Trailing digits
3624 are deleted in an attempt to find the author's directory.
3626 SCML: set the number of TTY command lines (ITS TTY)
3628 arg 1 <TTY> or <JOBDEV>
3629 arg 2 Number of command lines (typical value is 4).
3630 Must be less than the height of the screen.
3631 If zero, no echo area.
3633 This causes an echo area to be set up at the bottom
3634 of the display screen, using the last <n> lines.
3635 Characters typed in, or characters output in echo
3636 mode, are output to this area rather than the main area.
3637 Note that control bit 1.6 in an OPEN symbolic
3638 system call for TTY input does an implicit SCML
3639 with a second argument of 3.
3641 SCPOS: set tty cursor position (ITS TTY)
3643 arg 1 <TTY> or <JOBDEV>
3644 arg 2 vertical position (optional).
3645 arg 3 horizontal position (optional).
3646 arg 4 TTOALC word (optional).
3647 val 1 old vertical position.
3648 val 2 old horixontal position.
3649 val 3 old TTOALC word.
3651 This call tells the system what the main-program-level
3652 cursor position of the specified tty really is. It
3653 does NOT request that the cursor be MOVED there;
3654 it asserts that the cursor is expected to end up there
3655 as a result of the characters already IOT'ed.
3656 This call is necessary only when the system cannot figure
3657 the resulting cursor position out for itself.
3658 There are two cases when that happens:
3660 1) The system does not compute cursor motion when
3661 super-image output is done. If the user program, which
3662 presumably knows how the characters are being used, knows
3663 that the cursor will be moved by them, it should inform
3664 the system. This is necessary even if the user program
3665 is just trying to save time by generating the internal
3666 system output buffer codes itself.
3668 2) When an output reset is done on a tty of type %TNSFW
3669 (a "software tty"), the system does not know where the
3670 tty's cursor is physically located. Since the system
3671 does not actually interpret the output characters at
3672 interrupt level, but merely passes them off to the
3673 tty, it does not know how much the tty had done when
3674 the output reset happened. To recover, the system
3675 sets the LH of the tty's TTOALC word to 0, and sends
3676 a %TDORS character to the tty. The tty should respond by
3677 informing the system of the current cursor position and
3678 setting the LH of TTOALC to -1. Physical ttys must
3679 use the intelligent terminal protocol to do that,
3680 but STY users may do it with SCPOS.
3682 SDMPBT: set dump bit
3684 arg 1 Disk channel number or <JOBDEV>
3685 arg 2 A word with the new value for the dump check
3688 The dump check bit is used by the magtape file backup
3689 system to keep track of which files have been backed
3690 up on magtape. This bit therefore should not be
3691 twiddled light-heartedly. The "!" you sometimes see
3692 in front of a date in a disk file directory is present
3693 iff the dump check bit for the file is zero.
3695 See also the .DMPCH uuo and the RDMPBT
3696 symbolic system call.
3698 SETIOC: set input/output channel error
3700 This symbolic system call is ARCHAIC and OBSOLETE.
3701 It is documented here for historical purposes only.
3702 Its use in new programs is to be avoided.
3703 Its function has been superseded by the JOBIOC
3704 symbolic system call.
3706 arg 1 BOJ channel number or <JOBDEV>
3707 arg 2 IOC error code.
3709 This is used by JOB devices to cause the calling job
3710 to receive a word 1 IOC interrupt. This interrupt
3711 will be given when the calling job next attempts
3712 an IOT operation. The .BCHN variable for that job
3713 will be set to the channel it has the JOB device
3714 pen on, and bits 4.1-4.5 of the corresponding
3715 .IOS word are set to the specified IOC error code.
3716 See also the JOBINT symbolic system call.
3718 Valid IOC error codes are as follows:
3719 1 ILLEGAL HARDWARE OPERATION ATTEMPTED
3720 2 ATTEMPTED RANDOM ACCESS TO ADDRESS BEYOND END OF FILE
3721 3 NON-RECOVERABLE DATA ERROR
3722 4 NON-EXISTENT SUB-DEVICE
3725 7 USR OP CHNL DOES NOT HAVE USR OPEN
3727 11 DEVICE FULL (can also mean a directory is full)
3728 12 CHNL IN ILLEGAL MODE ON IOT
3729 13 ILLEGAL CHR AFTER CNTRL P ON TTY DISPLAY
3731 15 DIRECTORY'S ALLOCATION EXHAUSTED
3736 Second argument is not a valid IOC error code.
3737 34 WRONG TYPE DEVICE
3738 First argument is not a BOJ channel number.
3739 41 OTHER END OF PIPELINE GONE OR NOT OPEN
3741 SFDATE: set file creation date
3743 arg 1 Disk channel number or <JOBDEV>
3744 arg 2 New creation date and time in disk format:
3745 4.7-4.1 Year (mod 100.).
3746 3.9-3.6 Month (January = 1).
3747 3.5-3.1 Day of month.
3748 2.9-1.1 Time of creation, in half-seconds
3751 See also the DSKUPD, FILBLK, RFDATE, RQDATE and SRDATE
3752 symbolic system calls.
3754 SIOT: byte-string in/out transfer
3756 cbits Same as for IOT symbolic system call (q.v.).
3757 arg 1 I/O channel number.
3758 arg 2 Byte pointer to string to transfer
3759 (must not be indexed or indirect).
3760 arg 3 Count of bytes to be transferred.
3761 arg 4 (Optional) device-independent special mode bits.
3763 The second and third arguments are updated as the
3764 transfer proceeds. If an end of file condition occurs
3765 or the job is interrupted out of the system call, they
3766 may not be fully counted out.
3768 SIOT is notably efficient for STY input and TTY superimage
3769 output - much faster than block mode. For details of Chaosnet
3770 SIOT, see the description of IOT.
3772 Supposedly some esoteric devices don't support this mode of
3773 I/O transfer, but I can't think of any. Also, it is alleged
3774 that on some devices, SIOT is not yet as efficient as block
3779 12 MODE NOT AVAILABLE
3780 The device open on this channel doesn't support SIOT.
3781 14 BAD CHANNEL NUMBER
3783 The second or third argument was immediate.
3785 SOPEN: open file, using strings to specify the filename
3787 arg 1 mode bits,,channel number
3788 arg 2 byte pointer to ASCIZ filename string,
3789 or AOBJN pointer to a block of byte pointers
3790 to strings to be concatenated.
3792 If the second argument's left half is between -63. and -1, then the
3793 argument is treated as an AOBJN pointer to a block of byte pointers to
3794 ASCIZ strings. Those ASCIZ strings are effectively concatenated for
3795 parsing. Otherwise, the second argument is treated as one byte
3796 pointer. 0 may be used as the left half of a byte pointer, and is an
3797 abbreviation for 440700.
3799 The combined string is parsed using the ordinary ITS filename syntax, with
3800 colon indicating a device name, semicolon indicating a directory name, and
3801 space separating filenames. ^Q is used for quoting colon, semicolon,
3802 space, ^Q and ^@ (which would otherwise terminate the string); it cannot
3803 hurt to quote other characters with ^Q. SOPEN defaults the device to
3804 "DSK", the second filename to ">", and the directory to the executing job's
3807 Multiple devices, directories and names may be significant with some job
3808 devices, and perhaps with disk files as well at some time in the future.
3810 Once the string has been parsed into filenames, operation proceeds as
3811 for the OPEN symbolic system call, which see.
3813 SOPEN appears to a job device handler just like any other OPEN, except
3814 that the original second argument byte or AOBJN pointer is available
3815 as one of the values of the JOBCAL symbolic system call (which see).
3816 For an ordinary OPEN, that value from JOBCAL is zero.
3818 SRDATE: set file reference date
3820 arg 1 Disk channel number or <JOBDEV>
3821 arg 2 New reference date in disk format:
3822 4.7-4.1 Year (mod 100.).
3823 3.9-3.6 Month (January = 1).
3824 3.5-3.1 Day of month.
3826 See also the DSKUPD, FILBLK, RESRDT, and RQDATE
3827 symbolic system calls.
3829 SREAPB: set the do not reap bit
3831 arg 1 Disk channel or <JOBDEV>
3832 arg 2 0 for the normal case.
3833 1 to request the grim file reaper to
3834 leave this file alone.
3836 The do not reap bit of the file open on the channel
3837 is set. The G*** F*** R**P** doesn't
3838 respect this bit yet.
3840 The bit can be read using the FILBLK system call.
3841 It is UNREAP in the FSDEFS insert file.
3843 SSERVE: set server job
3845 arg 1 <JOB> Client job (OPTIONAL)
3846 If omitted, self is assumed.
3847 arg 2 <JOB> Server job
3849 The .SERVER variable of the client job is modified to point to the
3850 server job. See the description of .SERVER in .INFO.;ITS USETS.
3851 This system call permits .SERVER to be updated without trafficking
3856 34 WRONG TYPE DEVICE
3857 Neither the client nor the server can be the PDP6
3859 Executing job must be able to modify the client job.
3861 SSTATU: get various system status variables
3863 val 1 If non-negative, the time (in thirtieths of a
3864 second) until the system will go down.
3865 -1 if the system does not intend to go down.
3866 -2 if the system is already down (can happen
3867 in a job with %OPLIV set).
3868 Obtained from the ITS variable SHUTDN.
3869 See the .DIETIME, .SHUTDN, and .REVIVE uuos.
3870 val 2 Non-zero if the system is being debugged.
3871 This state causes the message
3872 XX ITS ### BEING DEBUGGED
3873 to appear on free consoles instead of the
3874 XX ITS ### IN OPERATION
3875 message usually seen when the system comes up.
3876 If negative, the system is officially down;
3877 ^Z is accepted only from tty 0 (the terminal
3878 physically next to the PDP-10 console) or from
3879 the tty whose number is the absolute value of
3880 the contents of this quantity. A ^Z is also
3881 accepted from a tty associated with a STY;
3882 this is so that STY devices may be debugged!
3883 It is the responsibility of the STELNT server
3884 to examine this quantity and keep network users
3885 from logging in when the system is being debugged.
3886 Obtained from the ITS variable SYSDBG.
3887 val 3 Number of users on the system. This is a
3888 count of logged-in, console-controlled job
3889 trees in the system. This variable is
3890 incremented whenever a user logs in from a
3891 console, and decremented whenever a console-
3892 controlled tree is detached, gunned, or logged out.
3893 This is the ITS variable SUSRS.
3894 val 4 Sum of parity and nxm memory errors during this
3895 incarnation of the system. This is the sum of
3896 the ITS variables PARERR and NXMERR.
3897 val 5 Time the system has been up, in thirtieths of
3898 a second. This is the ITS variable TIME.
3899 See the .RDTIME uuo.
3900 val 6 The left-justified name of the machine, i.e. one of:
3901 SIXBIT \AI\ ;A.I. Lab KS-10
3902 SIXBIT \ML\ ;Mathlab KS-10
3903 SIXBIT \MC\ ;Mail Computer KS-10
3904 SIXBIT \MD\ ;Mostly Development KS-10
3905 SIXBIT \MX\ ;Macsyma Consortium KL-10
3906 SIXBIT \SI\ ;Stacken ITS KS-10
3907 SIXBIT \PM\ ;PandaMonium KS-10
3908 SIXBIT \FU\ ;Australian KS-10
3909 SIXBIT \DM\ ;Dynamic Modeling KA-10 (R.I.P.)
3910 SIXBIT \MLKA\ ;Mathlab KA-10 (R.I.P.)
3911 SIXBIT \AIKA\ ;A.I. Lab KA-10 (R.I.P.?)
3912 This is the name which appears for XX in such
3914 XX ITS ### IN OPERATION
3915 and which serves as a device name for that
3916 machine's disks (i.e. the ML device is the
3917 DSK device of the ML (Mathlab) machine).
3918 If more ITS machines come into existence,
3919 naturally more machine names will be invented.
3920 val 7 The system version number, in sixbit. This is
3921 the ### in such messages as above.
3922 val 8 The number of free job slots.
3924 DDT uses much of this information to print out its
3926 If value 2 is non-zero DDT prints out
3928 If value 1 is non-negative DDT prints out
3929 XX ITS GOING DOWN IN 1:23
3930 if e.g. ITS were going down in 1 minute, 23 seconds.
3931 (DDT also prints the contents of the file SYS:DOWN MAIL
3932 if that file exists.)
3933 Value 3 is used to print out the number of users as
3935 (if your DDT has not logged in itself, it increments
3936 this value so as to count you also).
3937 Values 4 and 5 are used to compute the number of memory
3938 errors per hour, printed as:
3939 MEM ERRS .034142/HOUR
3940 The DDT command :SSTATU will print out all
3943 STATUS: get input/output status word
3945 arg 1 Channel number.
3946 val 1 Status word for specified channel.
3948 This call returns a word describing the state of
3949 the specified channel:
3950 4.9-4.6 Always zero. See the .IOPUSH and .IOPOP
3951 uuo's, and the .IOP and .IOS user variables.
3952 4.5-4.1 If non-zero, the number of a non-display
3953 input/output error (see table below).
3954 3.9-3.7 If non-zero, the number of an interpreted
3955 display input/output error (see table below).
3956 3.6-3.1 If non-zero, the number of a standard error.
3957 These are the same as the error codes returned
3959 2.9-2.3 Device dependent (see below).
3960 2.2 Buffering capacity empty.
3961 2.1 Buffering capacity full.
3962 1.9-1.7 Mode in which device was opened.
3963 1.9 0 = ascii, 1 = image.
3964 1.8 0 = unit, 1 = block.
3965 1.7 0 = input, 1 = output.
3966 1.6-1.1 ITS internal physical device code.
3967 0 TTY Console input.
3968 1 TTY Printing console output.
3969 2 TTY Display console output.
3970 3 LPT Data Products line printer.
3971 4 VID Vidisector ???
3972 5 BAT Vidisector ???
3973 6 PLT Calcomp plotter.
3974 7 PTP Paper tape punch.
3975 10 IMX Input multiplexor.
3976 11 OMX Output multiplexor.
3977 12 PTR Paper tape reader.
3978 13 DIS DEC 340 display, ascii output.
3979 14 IDS Interpreted 340 display. ???
3980 15 MTn Magnetic tape.
3981 16 COD Morse code device.
3983 21 NUL Source of zeroes, or output sink.
3985 23 BOJ Inverse of JOB.
3986 24 SPY Spy on another console.
3987 25 STY Pseudo-teletype.
3988 26 NET ARPAnet (NCP).
3989 27 LPT Vogue line printer (yech!)
3990 30 STK Stanford keyboard.
3991 31 MSP (DM) Interprocess message protocol.
3993 33 TCP TCP Internet.
3994 34 TRAP Trap "device"
3995 35 IPQ Internet IP Queue.
3996 41 UTn Microtape (DECtape).
3997 43 DSK 2311 disk drives or equivalent.
3998 60 USR A not immediately inferior procedure.
3999 61 USR An immediately inferior procedure.
4000 62 CLx Various core link devices (CLA, CLI, CLO, CLU)
4001 63 --- File directory or ERR device.
4003 65 DIRHNG Directory hang "device"
4004 66 LOCK Lock "device"
4006 Device dependent bits for TTY input:
4008 2.8 Next to the 340 or a 340 slave.
4009 2.5 Chars pending which have been .ITYIC'ed but not IOT'ed.
4010 2.4 The job possesses the tty.
4012 Device dependent bits for TTY output:
4013 2.4 The job possesses the tty.
4015 Device dependent bits for Data Products LPT:
4016 2.9-2.3 Current column (left margin = 0).
4018 Device dependent bits for MTn (macro-tape):
4019 2.9 Chunk, write EOR after each IOT (should be block) on output,
4020 don't ignore them on input. See magtap info.
4021 2.8 0 => odd parity, 1 => even parity.
4022 2.7-2.6 Density: 00 => 800, 01 => 200, 10 => 556.
4023 Apparently 11 => IBM 9 track 800 bpi??
4024 2.5 0 => 7 track, 1 => 9 track.
4026 2.3 Read compare error.
4028 Device dependent bits for NET:
4029 2.9-2.4 Socket state:
4030 0 %NSCLS CLS received or net down. Connection closed.
4031 1 %NSLSN Listening for RFC.
4032 2 %NSRFC RFC received while listening.
4033 3 %NSRCL CLS received while in state 2.
4035 5 %NSOPN Connection open.
4036 6 %NSRFN RFNM wait on write link.
4037 7 %NSCLW CLS sent; waiting for matching CLS.
4038 10 %NSCLI CLS received but input still available.
4039 11 %NSINP Input available.
4041 Device dependent bits for TCP:
4042 2.9-2.4 Connection state - see WHYINT call for state codes.
4044 CHAOSnet provides no device dependent bits.
4046 A STATUS word can be supplied to the ERR
4047 device to obtain corresponding error message, if any.
4049 See also the JOBSTS symbolic system call, the .STATUS uuo,
4050 and the .IOS user variable.
4052 STDMST: set demon status
4054 arg 1 Either the sixbit name or the user index
4056 arg 2 If negative, flush all requests for the specified demon.
4058 4.9-3.1 If non-zero, the time in two-minute ticks
4059 between automatic signals for the demon.
4060 2.9-1.1 Number of requests pending for the demon.
4061 arg 3 Time in two-minute ticks until the next automatic
4062 signal will occur (meaningful only if arg 2 bits
4065 See also the DEMSIG and RDDMST symbolic system calls,
4068 STLGET: get information from Server Telnet
4072 val 1 XJNAME of server telnet
4073 val 2 TRMNAM of server telnet
4074 This is the sixbit name of the host connected to.
4075 val 3 SNAME of server telnet
4076 val 4 In LH: STY status bits
4077 In RH: index of telnet server job which owns the STY.
4079 This call can be used to find out where in the network
4082 The STY status bits are from the STYSTS table in ITS.
4083 Some of the more interesting ones include:
4084 %SSNET==4000 ;4.3 = 1 => THIS STY CONNECTED TO SOME NET SOCKETS.
4085 %SSCHA==2000 ;4.2 = 0 FOR ARPANET, 1 FOR CHAOS NET
4086 %SSTCP==1000 ;4.1 = 1 for TCP internet (%SSCHA must be 0)
4090 34 WRONG TYPE DEVICE
4091 Specified TTY is not controlled by a server telnet.
4093 STYGET: get information about STY
4095 arg 1 <TTY> (need not be associated with a STY)
4096 val 1 STY status word:
4097 4.9 %SSHNG Don't hang on input IOT.
4098 4.8 %SSUSE STY is in use.
4099 4.7 %SSINT Have given interrupt on STY output channels.
4100 4.6 %SSONT Have given interrupt on STY input channels.
4101 4.5 %SSOHG Don't hang on output IOT.
4102 4.4 %SSORS Give a %TDORS whenever an output RESET is
4103 done on the controlled tty, regardless
4104 of whether the tty is a software tty.
4105 2.9-1.1 User index of job which owns the STY.
4106 Zero if STY is not in use, or if TTY is not
4107 associated with a STY.
4108 val 2 User index of job which owns the TTY, either as a device
4109 or as a currently possessed console; or -1 if TTY is free.
4110 val 3 -1 if the TTY is not a console or is free. Otherwise,
4111 2.9-1.1 is the user index of the top-level job of the
4112 job tree controlled by the TTY.
4113 4.8 = 1 if that job is in the process of logging out.
4114 4.7 = 1 if that job is logged in.
4116 val 4 4.9 Owner of TTY is in a TTY output wait on the TTY.
4117 1.1 Owner of TTY is in a TTY input wait on the TTY.
4118 These bits probably don't work very well.
4119 val 5 4.9 TTY input available.
4120 4.8 TTY output buffer has room.
4121 val 6 The tty's TTYSTA word.
4122 4.9 %TACFM TTY does not need a console free message
4123 eventually (hasn't been in use since
4125 4.8 %TAC.Z TTY is being ^Z'd. Shouldn't be on with
4126 %TACFM. If %TACFM and %TAC.Z are both 0,
4127 the tty is being freed and a console free
4128 message is immanent.
4129 4.7 %TANJS This ^Z is being flushed because no job
4130 slots are available. If set, %TAC.Z
4131 will be 1 and %TACFM will be 0.
4133 This symbolic system call originally was intended to return
4134 STY information, but now returns useful data concerning any TTY.
4136 STYNET: Connect a STY to a pair of Network connections.
4138 arg 1 Sty channel (either direction).
4139 arg 2 -1 to disconnect the STY from its network channels
4140 (in which case args 3 and 4 are unnecessary),
4141 or Net input channel (to connect STY output to).
4142 This may be a NCP, TCP, or CHAOS channel.
4143 arg 3 Net output channel (to connect STY input to).
4144 arg 4 Characters to send out on net
4145 when an output .RESET is done on the STY's TTY.
4146 Up to 3 8-bit characters, left-justified.
4148 It is possible with this call to connect a STY to a pair
4149 of network channels, one open for input, and one open for output.
4150 When the direct connection is established, anything received by
4151 the net input socket will be fed automatically to the
4152 STY, and any type-out that the STY receives from its TTY will be
4153 fed automatically to the net output channel. The transfer of
4154 data is handled by the system at clock level, eliminating
4155 the need for the program to wake up at each character.
4157 Only one input and one output net channel can be connected to
4158 a STY, and only one STY can be connected to any net channel.
4159 Both sides of a STY are connected and disconnected at once.
4160 A job can connect a STY if it has the STY open in either direction
4161 (but it will generally want to have both directions open).
4163 Once established, the direct connection will last until
4164 broken explicitly by the user, or until an escape condition
4165 is detected by the system. Escape conditions include receipt
4166 of a TELNET control character on the net input channel (any
4167 character with the 200's bit on), and
4168 either net channel's getting into an abnormal state (other
4169 than %NSOPN, %NSINP, or %NSCLI) - in general, things which
4170 the system expects that the user program will want to take
4173 The connection can be broken explicitly by the user either
4174 by a STYNET call with arg 2 negative, or by a CLOSE of any
4175 of the channels involved (this also happens when the job
4176 is killed.) It is an error to IOT on any of the channels
4177 without breaking the connection first.
4179 The STYNET call returns immediately, without actually
4180 transferring any data. The program can assume that the
4181 connection is still in effect until it is notified of
4182 a disconnection by an interrupt on the net input channel.
4183 While the connection lasts, interrupts on the net channels
4184 due to arriving data are intercepted by the system, so
4185 an interrupt implies that the connection has been broken.
4187 When a %TDORS comes out of the STY, indicating that the TTY's
4188 output buffer has been cleared, this is indicated to the net
4189 output channel by means of a network interrupt (NCP only), and the
4190 string of up to 3 characters specified as the fourth argument
4191 to the STYNET call. If TCP, these characters are PUSHed with the
4194 If you use STYNET with the official TELNET protocol, you must
4195 turn on the %TPTEL bit in the STY TTY's TTYOPT variable, to
4196 cause the sequence CR-LF to be turned into just a CR.
4200 arg 2 - Chaos channel to connect to, or
4202 arg 3 - Other Chaos channel (not actually used)
4203 arg 4 - Output-reset character sequence, up to 3 8-bit
4204 characters left-justified.
4206 This works the same as on the Arpanet. The specified STY
4207 is connected to or disconnected from a Chaos net channel.
4208 Data is transferred in and out by the system without the
4209 need for intervention by the user program. If an unusual
4210 condition occurs, the STY is disconnected from the Chaos
4211 channel and the user is interrupted. It is illegal to do
4212 I/O on any of the involved channels while they are connected.
4214 This call is provided for the benefit of the "Telnet" server.
4219 An input net channel was supplied as the third argument, or
4220 an output channel was supplied as the second argument.
4222 The STY or one of the network channels is already direct-connected
4223 to another network channel or another STY.
4224 41 OTHER END OF PIPELINE GONE OR NOT OPEN
4225 An attempt was made to disconnect a STY not already connected.
4227 T11MP: PDP-10 to PDP-11 map
4229 arg 1 Page number within the user's core. That page
4230 must be either non-existent or shared with an
4231 absolute page. The user's virtual page is made
4232 to share with some arbitrarily chosen absolute
4233 page, which is then made to share with PDP-11 memory
4234 according to argument 2.
4235 arg 2 Desired PDP-10 to PDP-11 map word.
4236 4.9 Valid (must be 1).
4239 4.2-3.9 PDP-11 number. See below.
4240 3.8-2.2 Relocation (origin of segment in PDP-11
4241 address space). <PDP-11 address> = 4*<relocation>.
4242 2.1-1.1 Protection (number of accessible words - 1).
4243 <PDP-11 protection> = 4*<protection>.
4244 If protection=0 then only one 16-bit word
4247 The CORBLK symbolic system call may be used in the special
4248 case of mapping one's TV console video buffer memory.
4250 The AI KA-10 has a PDP-10 to PDP-11 interface which lets the PDP-10
4251 programmer directly access the memories of up to eight PDP-11's.
4252 PDP-10 pages are mapped into segments of variable size in the
4253 PDP-11's memory. The PDP-10 to PDP-11 page map is also directly
4254 addressable in memory (it currently lives in absolute locations
4255 2,,776000 - 2,,776377). There are 256. such entries, one for each
4256 page in the range 2,,0 - 2,,777777, which are the addresses fielded
4257 by the PDP-10 to PDP-11 interface. ITS allocates these pages
4258 and their corresponding map entries randomly as needed.
4260 When the PDP-10 attempts to access a physical address in the range
4261 2,,0 to 2,,777777, the interface uses the 776000 bits to index
4262 the map words. If the appropriate map word does not have its
4263 valid bit set, the memory is considered non-existent. The same
4264 is true if the reference would violate the protection bounds.
4265 The reference also fails if it is a write reference and the
4266 map word does not have the write enable bit set.
4267 Otherwise, the relocation quantity is added to the 1777 bits,
4268 and this determines which PDP-11 double-word to access.
4269 The PDP-11 number determines which PDP-11 to access, of course.
4270 The PDP-11 double-word corresponds to the high 32. bits of the
4271 PDP-10 word, as follows:
4272 PDP-10 BIT PDP-11 WORD AND BIT
4284 When reading the PDP-11 memory, bits 1.4-1.1 are read as zeros.
4285 When writing, 1.4=1 means don't change word 0, 1.3=1 means don't
4286 change word 1, and 1.2-1.1 are ignored. Split cycles do the right
4287 thing, so ILDB and IDPB should work correctly.
4288 Note that accessing consecutive 16.-bit PDP-10 bytes will access
4289 consecutive PDP-11 words, but accessing consecutive 8-bit PDP-10
4290 bytes will not access consecutive PDP-11 bytes! Rather, the PDP-11
4291 bytes are accessed in the order 1, 0, 3, 2.
4293 The following PDP11s are currently (4/2/76) attached.
4295 0 The pdp11 that runs the AI KA-10 TV system.
4296 1 The pdp11 that runs the AI KA-10 XGP.
4297 2 The Lisp Machine GT40.
4298 3 The Chess Machine (not really a pdp11.)
4299 4 The Logo pdp11/45.
4300 5 The Micro-Automation pdp11/45.
4305 There is no PDP-11 connected to this PDP-10.
4307 The PDP-11 is not ready.
4309 The page number is invalid, or the map word has bit 4.9=0.
4310 37 NO CORE AVAILABLE
4313 TCPOPN: open a TCP Internet connection (TCP;TCPDOC >)
4315 arg 1 - receive channel number
4316 arg 2 - transmit channel number
4317 arg 3 - local port # (-1 to gensym a unique local port #)
4318 arg 4 - foreign port # (-1 for wild port)
4319 arg 5 - foreign host address (HOSTS3 fmt) (-1 for wild host)
4320 arg 6 - Retransmission timeout (optional, not yet used)
4323 - None needed for channels - they are opened as .UAI and .UAO
4324 automatically (no other modes possible).
4325 - 7 vs 8 bit ASCII transfers can be determined by user-space byte
4326 pointer used in SIOT. System buffers are always 8-bit bytes.
4327 %NOLSN - Listen mode
4329 Note a value of -1 for either the foreign port or host will imply
4330 that the call is a "listen". Return is always immediate, use NETBLK
4331 to determine when the channels become open. For a non-listen call,
4332 there is an internal ITS timeout, but for listen the state can persist
4336 6 - No free TCBs or buffers available (system has too many active conns)
4337 7 - TCP disabled in system.
4338 11 - Bad local or fgn port #
4339 13 - Connection already exists with these ports
4340 14 - Bad channel # arguments.
4341 33 - Illegal to use same channel for both input/output.
4343 TRANAD: add a translation entry (ITS TRANSL)
4345 cbits 2.9 Atomic translation (do not retranslate).
4346 2.8 0 => TRNLST, 1 => TRNLS1.
4347 The TRNLST applies only to the specified job;
4348 the TRNLS1 applies to the job and its inferiors,
4350 1.2 Output translation.
4351 1.1 Input translation.
4352 Before the control bits are interpreted, the LH
4353 of arg 1 is XOR'd into them.
4354 arg 1 RH is a <JOB>. LH XOR'd into cbits.
4355 arg 2 AOBJN pointer to a block of "from" names.
4356 arg 3 AOBJN pointer to a block of "new" names.
4358 Each AOBJN pointer should point to a block of
4359 from one to four words. These are, in order, the
4360 device, file name 1, file name 2, and sname which
4361 are to be translated. All names are left-justified
4362 within a word. A zero or omitted word is equivalent
4364 Before creating the translation, a TRANDL is
4365 performed on the first two arguments to prevent
4366 duplicate translations.
4368 Uuos and symbolic system calls affected by translation
4369 include .FDELE, .OPEN, MLINK, RENAME, and OPEN.
4374 No room in system for new translation entry.
4375 14 BAD CHANNEL NUMBER
4378 34 WRONG TYPE DEVICE
4379 Not meaningful to put a translation on the PDP-6.
4382 TRANCL: clear translation list (delete all entries) (ITS TRANSL)
4384 cbits 2.8 Clear TRNLS1.
4386 The TRNLST applies only to the
4387 specified job; the TRNLS1 applies
4388 to the job and its inferiors,
4390 Before the control bits are interpreted, the LH
4391 of arg 1 is XOR'd into them.
4392 arg 1 RH is a <JOB>. LH XOR'd into cbits.
4395 Either or both lists may be cleared with a single call.
4398 14 BAD CHANNEL NUMBER
4401 34 WRONG TYPE DEVICE
4402 Not meaningful to clear translation lists for PDP-6.
4405 TRANDL: delete a translation entry (ITS TRANSL)
4407 cbits 2.8 0 means TRNLST, 1 means TRNLS1.
4408 The TRNLST applies only to the
4409 specified job; the TRNLS1 applies
4410 to the job and its inferiors,
4412 1.2 Stop translating for output.
4413 1.1 Stop translating for input.
4414 Before the control bits are interpreted, the LH
4415 of arg 1 is XOR'd into them.
4416 arg 1 RH is a <JOB>. LH XOR'd into cbits.
4417 arg 2 An AOBJN pointer to a block of names.
4419 The AOBJN pointer should point to a block of
4420 from one to four words. These are, in order, the
4421 device, file name 1, file name 2, and sname which
4422 are no longer to be translated. All names are
4423 left-justified within a word. A zero or omitted
4424 word is equivalent to *.
4429 No such translation entry to delete.
4430 14 BAD CHANNEL NUMBER
4433 34 WRONG TYPE DEVICE
4434 Not meaningful to delete translation entry for PDP-6.
4437 TRANEX: examine a translation list (ITS TRANSL)
4439 cbits 2.8 0 means TRNLST, 1 means TRNLS1.
4440 The TRNLST applies only to the
4441 specified job; the TRNLS1 applies
4442 to the job and its inferiors,
4444 Before the control bits are interpreted, the LH
4445 of arg 1 is XOR'd into them.
4446 arg 1 RH is a <JOB>. LH XOR'd into cbits.
4447 arg 2 AOBJN pointer to array in core.
4448 val 1 AOBJN pointer to tail end of array,
4449 i.e. the part not needed to hold the data.
4451 The translation list is stored as consecutive
4452 nine-word blocks of translation information.
4453 Each block has the following form:
4454 wd 0 4.9 Atomic translation entry.
4455 3.2 Output translation.
4456 3.1 Input translation.
4457 wd 1 "from" device name.
4458 wd 2 "from" file name 1.
4459 wd 3 "from" file name 2.
4461 wd 5 "to" device name.
4462 wd 6 "to" file name 1.
4463 wd 7 "to" file name 2.
4465 A zero word for a "from" name means translate for any
4466 name in that position; a zero "to" word means don't
4467 change that name when translating.
4471 14 BAD CHANNEL NUMBER
4473 34 WRONG TYPE DEVICE
4474 Not meaningful to examine translation list for PDP-6.
4476 37 NO CORE AVAILABLE
4477 Supplied array too small to hold data.
4479 TRANS: translate some file names (ITS TRANSL)
4481 cbits 1.1 0 for input, 1 for output.
4482 arg 1 "from" device name.
4483 arg 2 "from" file name 1 (defaults to zero).
4484 arg 3 "from" file name 2 (defaults to zero).
4485 arg 4 "from" sname (defaults to job's current sname).
4486 arg 5 mode (XOR'd with control bits; defaults to 0).
4487 val 1 "to" device name.
4488 val 2 "to" file name 1.
4489 val 3 "to" file name 2.
4492 The given file names are translated by the same rules
4493 for translation governing the operations of OPEN,
4494 RENAME, DELETE, and MLINK. These rules are as follows.
4496 Translation lists are searched in the order:
4497 executing job's TRNLST
4498 executing job's TRNLS1
4499 executing job's superior's TRNLS1
4500 that job's superior's TRNLS1
4502 top-level job's TRNLS1
4504 The lists are searched for an entry matching the given "from"
4505 file names. A translation entry is said to match if each
4506 "from" name matches the entry's corresponding name,
4507 and if the translation entry applies to the mode (input or output).
4508 A name in turn matches if the entry's name is the same as
4509 the given name, or if the entry's name is * (matches anything).
4510 If a match is found, the given file names are replaced by the "to"
4511 file names in the translation entry, except that in the entry
4512 a "to" file name of * means don't change the given name;
4513 the process is then repeated from the beginning unless the
4514 matching translation entry is atomic. When this happens, or
4515 when a full search finds no matching translation entries,
4516 the translation process is complete. To prevent endless
4517 retranslation, it is considered an error to repeat the
4518 translation process more than eight times.
4520 When a job is first created its TRNLST and TRNLS1 are null.
4521 The TRANAD, TRANCL, TRANDL, and TRANEX symbolic system calls
4522 may be used to examine and modify translation lists.
4526 3 TOO MANY TRANSLATIONS
4527 No more than eight consecutive translations are permitted.
4529 TRPOPN: Open trap-device channel
4532 arg 2 channel number in that job
4533 arg 3 IOCHNM word (only LH is used)
4536 The specified channel of the specified job is made a trap-device
4537 channel. Almost any attempt to use it will cause a %PITRP interrupt.
4538 See documentation of the TRAP: device.
4542 13 FILE ALREADY EXISTS
4543 The specified channel is open.
4545 14 BAD CHANNEL NUMBER
4549 The <JOB> is not clobberable.
4551 34 WRONG TYPE DEVICE
4552 The <JOB> is the pdp-6.
4554 TTYESC: simulate type-in of ^_
4558 Pretends that the user has just typed in a ^_.
4559 The next character the user types will be interpreted
4562 The intended use of this is for programs which use
4563 super-image input, so that ^_ does not have its normal
4564 effect, but which wish to provide an escape convention
4565 so that the effect of ^_ can be obtained. When the program
4566 sees the escape character sequence as input, it should
4572 The terminal is already in the middle of a ^_ code
4573 being typed by the user.
4575 TTYFLS: flush TTY input
4579 1.1 0 => cause the last interrupt character .ITYIC'ed
4580 to be ignored by .IOT.
4581 1 => discard all input up to and including the last
4582 character .ITYIC'ed.
4584 This call is normally used by TTY input interrupt handlers.
4586 TTYGET: read the variables TTYST1, TTYST2, TTYSTS (ITS TTY)
4588 arg 1 <TTY> or <JOBDEV>
4589 val 1 TTYST1 variable.
4590 This variable contains six groups of six bits.
4591 Each group is as follows:
4592 1.6 %TGMPE Echo at main program level (when IOT'ed).
4593 1.5 %TGPIE Echo at interrupt level (when typed).
4594 1.4 %TGIMG Echo in image mode.
4595 1.3 %TGSPC Special hack: convert lower case to upper.
4596 1.2 %TGACT Activation character.
4597 1.1 %TGINT Interrupt character.
4598 The character groups are:
4599 4.9-4.4 ^@-^F ^K ^L ^N-^R ^T-^Z ^\-^_
4600 4.3-3.7 Upper and lower case letters.
4602 2.9-2.4 ! " # $ % & ' , . : ; ? @ \ ` | ~
4603 2.3-1.7 + * - / = ^ _
4604 1.6-1.1 < > ( ) [ ] { }
4605 val 2 TTYST2 variable.
4606 Six more groups of six bits:
4608 4.3-3.7 ^I ^J (tab, linefeed)
4609 3.6-3.1 altmode (33)
4610 2.9-2.4 ^M (carriage return)
4611 2.3-1.7 rubout (177)
4612 1.6-1.1 space, ^H (backspace)
4613 val 3 TTYSTS variable.
4614 4.9 %TSFRE Free console (not in use).
4615 4.8 %TSCLE ^L should echo as "^L" (normally
4616 clears screen on displays).
4617 4.7 %TSHDX Same as %TOHDX. Vestigial.
4618 4.6 %TSFCO Use full 12-bit TV char set for output and
4619 echoing: echo CONTROL as ALPHA, echo META
4620 as BETA, echo SUPER as EPSILON, and use
4621 Sail graphics if TOP is set.
4622 4.5 %TSALT Do not standardize altmodes.
4623 4.4 %TSROL Scroll mode.
4624 4.3 %TSSAI Echo and ascii output use SAIL
4626 4.2 %TSACT Next input IOT shouldn't wait
4627 for an activation character.
4628 4.1 %TSNEA Don't echo in echo area; echo in M.P. Area.
4629 3.9 %TSINT Next input character should
4630 interrupt even if it ordinarily
4631 would not (%TGINT = 0).
4632 3.8 %TSMOR Inhibit **MORE** processing.
4633 3.7 %TSATY Set whenever an .ATTY executed by
4634 some superior returns the tty to
4636 3.4 %TSNOE Defer echoing.
4637 3.3 %TSLCZ Last character typed was ^Z.
4638 This bit causes .ATTY's to fail.
4639 3.2 %TSSII Super-image input. The special
4640 actions of ^Z and ^_ are suppressed.
4641 3.1 %TSCNS This is a console, not a device.
4642 2.9-1.1 The user index of the job which controls
4643 the tty, or -1 if the tty is free.
4644 val 4 the TTYTYP variable
4645 See the CNSGET documentation.
4646 val 5 the TCTYP variable
4647 See the CNSGET documentation.
4649 Values 4 and 5 probably should not be depended upon.
4651 See also the CNSGET, CNSSET, and TTYSET symbolic system calls.
4656 No tty exists with the specified number.
4657 14 BAD CHANNEL NUMBER
4658 34 WRONG TYPE DEVICE
4660 TTYSET: set the variables TTYST1, TTYST2, TTYSTS (ITS TTY)
4662 arg 1 <TTY> or <JOBDEV>
4663 arg 2 TTYST1 variable. See under TTYGET.
4664 arg 3 TTYST2 variable. See under TTYGET.
4665 arg 4 TTYSTS variable (optional). See under TTYGET.
4666 %TSFRE, %TSHDX, %TSLCZ, and %TSCNS may not be altered,
4669 See also the CNSGET, CNSSET, and TTYGET symbolic system calls.
4674 No tty exists with the specified number.
4675 14 BAD CHANNEL NUMBER
4676 34 WRONG TYPE DEVICE
4678 TTYVAR: read or set a variable associated with a TTY.
4680 arg 1 <TTY> or <JOBDEV>
4682 In the simplest mode:
4684 arg 2 the name of a tty variable, in SIXBIT.
4685 arg 3 (if writing) the new value.
4687 If arg 3 is not supplied, you are reading, and
4688 val 1 is the value of the variable.
4690 In immediate-instruction mode:
4692 arg 2 the SIXBIT name of a tty variable.
4694 arg 4 the instruction
4696 This mode is detected by the presence of four arguments.
4698 The specified instruction is executed as if the
4699 variable was in ac 0. MOVE can be used to set the
4700 variable, MOVEM to read it, but you can also use
4701 TLO to set bits, ADDI to increment, etc.
4705 arg 2 an AOBJN pointer to a block of pairs of words.
4707 This mode is detected by bits 4.1-4.9 of arg 2 being all
4710 The first word in each pair is the SIXBIT name of a tty
4711 variable, and the second word is an instruction to be
4712 executed as if that variable were in ac 0. The block pointer
4713 argument is updated.
4715 The TTY variables include HEIGHT, WIDTH, ISPEED, OSPEED, TTYOPT,
4716 TTYTYP, TTYCOM, TCTYP, TTYROL, TTYSMT, and IDLTIM. See
4717 .INFO.;ITS TTY for a description of their meanings.
4719 The instructions allowed in immediate-instruction and
4720 block modes are: MOVx, MOVxI, MOVEM, ADD, ADDI, SUB, SUBI,
4721 all Booleans in normal and immediate modes, and TxZ, TxC,
4722 and TxO (i.e. all Test instructions that modify and don't
4727 11 ILLEGAL FILE NAME
4728 Unrecognized tty variable name.
4729 26 DEVICE WRITE-LOCKED
4730 Specified variable or specified tty cannot be written.
4732 Attempt to store an illegal value in the TCTYP variable,
4733 or an illegal instruction was specified in immediate-
4734 instruction or block mode.
4736 TVWHER: tell where a TV is
4738 arg 1 <TTY> or <JOBDEV>
4739 val 1 The keyboard number of the physical
4741 The correspondence between keyboard numbers
4742 and physical locations is in the file
4743 SYSENG;TVKBD ROOMS, which is how the NAME
4744 program gets this information. If this table
4745 and that file disagree, that file is correct,
4746 and please update this table.
4747 As of February 7, 1977, these correspondences
4749 KBD # ROOM WHO LIVES THERE
4750 0 809 Fahlman, Holloway, Knight x7807
4751 1 810 Lavin, Kuipers, Miller, Bruss x7836
4752 2 919 Very Small Data Bases north x6765
4753 3 812 Yvonne, Karen x5876
4755 5 814 Sussman, McDermott x5874
4756 6 808 Freiling, Lozano-Perez, Ullman x5875
4758 13 819 Goldstein x5879
4761 21 824 Rich, Levin, DeKleer x6032
4762 22 825 Purcell, Doyle x5848
4763 23 826 Fredkin's Folly x5904
4764 30 925 Moon (Tycho, north wall) x6765
4765 31 902 Mason, Raibert, Hollerbach x3483
4766 32 919 Very Small Data Bases south x6765
4767 33 344 Edwards, Lebel x6765
4768 34 913 Baisley, Greenblatt x6765
4769 35 914 Gosper's Fishbowl x2076
4770 36 912 9th Floor Lounge x6765
4771 37 907 Chess, Lisp Machines x6765
4773 val 2 The number of the TV video buffer in use
4774 on this tty (0-17 octal). This is NOT a
4775 Video Switch input number.
4780 No tty exists with the specified number.
4781 10 DEVICE NOT AVAILABLE
4782 The PDP-11 which services the TV consoles is down.
4783 34 WRONG TYPE DEVICE
4784 The specified tty was not a TV, or the specified
4785 channel was not a <TTY> or <JOBDEV>.
4787 UNLOCK: Unlock JOB's locks.
4791 If the specified job is writable, and is using the locks
4792 feature, its locks are unlocked. (Usually this is used on
4793 onesself.) See the ITS LOCKS file for more information
4796 (Note that this has nothing to do with the LOCK device. In
4797 particular it will -not- close LOCK device channels.)
4802 The specified job is not writable.
4804 Plus the usual errors for <JOB> arguments.
4806 USRMEM: Read or write another job's memory
4808 cbits 2.9 Allow writing into any job
4809 1.1 If page isn't readable or writable give an
4810 MPV or pure interrupt to the job being
4814 Other args are like USRVAR and TTYVAR. In place of
4815 a variable-specifier you put the address in the job
4816 of the word to be read or written.
4818 arg 2 Address to read or write (non-negative)
4822 Specify only 2 arguments.
4828 Writing with an instruction:
4831 arg 4 Instruction to write with
4835 arg 2 An AOBJN pointer to a block of pairs, first address
4836 and then instruction.
4838 val 1 Previous contents (these are not valid in block mode)
4843 The content of the specified address in <JOB>
4844 is returned as val 1.
4847 Arg 3 is written into the specified address
4848 in <JOB>. The previous contents are returned
4851 Writing with an instruction:
4852 The instruction should modify its AC as if the spec'd job's
4853 memory location were in it. The memory operand is fetched
4854 from your own address space and is not stored back.
4855 No jobs can run while the location is being modified, that is
4856 between the fetching of the old value and the storing of
4858 The previous contents are returned as val 1, the new
4864 The specified job is not writable.
4865 32 CAN'T GET THAT ACCESS TO PAGE
4866 The specified page is either nonexistant
4869 Attempt to specify an illegal instruction for writing.
4871 USRVAR: Read or set some of a job's variables
4875 In the simplest mode:
4877 arg 2 user variable specifier (see below).
4878 arg 3 (if writing) the new value.
4880 If arg 3 is not supplied, you are reading, and
4881 val 1 is the value of the variable.
4883 In immediate-instruction mode:
4885 arg 2 user variable specifier (see below).
4887 arg 4 the instruction
4889 This mode is detected by the presence of four arguments.
4891 The specified instruction is executed as if the
4892 variable was in ac 0. MOVE can be used to set the
4893 variable, MOVEM to read it, but you can also use
4894 TLO to set bits, ADDI to increment, etc.
4898 arg 2 an AOBJN pointer to a block of pairs of words.
4900 This mode is detected by bits 4.1-4.9 of arg 2 being all
4903 The first word in each pair is the user variable specifier
4904 (see below), and the second word is an instruction to be
4905 executed as if that variable were in ac 0. The block pointer
4906 argument is updated.
4908 The instructions allowed in immediate-instruction and
4909 block modes are: MOVx, MOVxI, MOVEM, ADD, ADDI, SUB, SUBI,
4910 all Booleans in normal and immediate modes, and TxZ, TxC,
4911 and TxO (i.e. all Test instructions that modify and don't
4914 This call is the symbolic equivalent of the .USET and .SUSET
4915 UUO's. It can read, write, or both (but you are usually not
4916 allowed to write any job except yourself or an inferior);
4917 it is a .SUSET if the <JOB> is %JSELF, or a .USET if given a
4918 channel number as the <JOB>, or it can be given other kinds
4921 The user variable specifier can be either numeric or sixbit.
4922 If sixbit, it is the same as the name given in the ITS USETS
4923 file except without the dot at the beginning. Sixbit specifiers
4924 are good for programs which take arguments as to which user
4925 variable to operate on, and are useful to allow a program
4926 which uses a new variable to assemble before that variable is
4927 actually put in the system (it will get error code 11 when it
4928 tries to refer to the variable.)
4930 A numeric specifier is a small integer similar to those used
4931 with the .USET and .USET uuos. Predefined symbols exist for
4932 these, consisting of ".R" followed by the name of the variable.
4933 (Use ".R" rather than ".S" even if you are writing.) Do not
4934 use the symbols without the "R" (these are something else.)
4935 The .IOC, .IOS, .IOP, and .PMAP arrays of user variables
4936 can only be specified numerically.
4938 See the .SUSET and .USET UUO's (in .INFO.;ITS UUOS)
4939 for more information on particular user variables.
4943 11 ILLEGAL FILE NAME
4944 Unrecognized sixbit user variable specifier, or numeric specifier
4945 larger than the legal range.
4946 12 MODE NOT AVAILABLE
4947 The specified variable is not available for the current combination
4948 of reading versus writing and self versus other job.
4949 13 FILE ALREADY EXISTS
4950 Attempt to cause two jobs in the system to have the same UNAME/JNAME pair.
4952 Attempt to write into a user variable of a job which is not writable.
4954 Attempt to specify an illegal instruction in immediate-
4955 instruction or block mode; or attempt to store an illegal value
4956 into a user variable (e.g. zero into the .UNAME).
4957 34 WRONG TYPE DEVICE
4958 Attempt to access user variables of the pdp-6 other than .UIND
4961 Attempt to set a user variable for a job that is not top level,
4962 when only top-level jobs are allowed to set that variable, for
4963 example the .UNAME and .JNAME.
4965 VIDBUF: request/release video buffer
4967 arg 1 If non-negative, the number of a video buffer
4968 to release. If negative, requests a video buffer.
4969 val 1 If arg 1 was negative, the number of the buffer obtained.
4971 A video buffer for the PDP-11 TV consoles is assigned or
4972 released. If assigned, the video switch input number
4973 of that buffer is returned. This value can be placed
4974 in bits 4.1-3.3 of the .TVCREG user variable in order to
4975 cause video buffer pages in one's page map to refer to
4976 the allocated video buffer.
4978 A video buffer is a segment of PDP-11 memory large enough
4979 to represent all the bits on a TV display. A display
4980 is 1100=576. bits wide by 706=454. lines high. Every
4981 line is represented by 36. 16.-bit PDP-11 words;
4982 this corresponds to 18. PDP-10 words as mapped through
4983 the PDP-10 to PDP-11 interface (see the T11MP symbolic
4984 system call). The word with the lowest address holds
4985 the leftmost displayed bits; furthermore within each word
4986 bit 15 is the leftmost displayed bit. Thus, as seen by the
4987 PDP-10 bits are displayed in the "obvious" manner.
4988 The entire buffer is 16344.=37730 PDP-11 words long;
4989 this corresponds to 8172.=17754 PDP-10 words.
4990 The word 77777 PDP-11 words (17777 PDP-10 words) from the
4991 origin of the video buffer is a special control register:
4992 3.2-2.9 15-13 Unused.
4993 2.8 12 0 => white on black, 1 => black on white.
4994 2.7-1.5 11-00 Scroll offset: video buffer wraps around;
4995 the first word displayed is that 4*<offset>
4996 PDP-11 bytes from the buffer origin. For
4997 best results this should be a multiple
4998 of 9 (for vertical scrolling).
4999 The PDP-11 always sees a video buffer as beginning at its
5000 location 60000 (byte address); which video buffer it is looking
5001 at is controlled by the console register at location 164044 octal.
5002 Thus the PDP-11 sees the scroll register as being at address
5005 See also the VIDSW symbolic system call.
5009 Attempt to release a buffer not assigned to the job.
5011 The PDP-11 is not ready.
5013 Arg 1 is non-negative but not a valid video buffer number.
5015 VIDSW: set video switch
5017 arg 1 Video switch input number.
5018 arg 2 Video switch output number.
5020 The video switch is set up so that the specified video
5021 output will gobble bits from the specified video input.
5023 As of July 25, 1975, the only video inputs are TV
5024 video buffers. These correspond to Tnm device numbers
5027 Tnm Video Input Number
5028 T47 24 T47 is used for console free buffer.
5029 T52 1 When you type ESC<n>S, <n> is
5030 T53 2 the video input number. The PDP-11
5031 T54 5 merely switches that input to your
5032 T55 6 TV display, which is a video output.
5039 The possible video outputs are mostly TV displays, but also
5040 the Tektronix hard-copy device which sits next to the XGP.
5041 (The keyboard number may be relevant to use of the TVWHER
5042 symbolic system call.) As of July 25, 1975:
5044 Video Output Keyboard Location of TV
5045 0 0 809 Fahlman, Holloway, Knight
5047 2 21 824 Rich, McDonald, deKleer
5048 3 6 815 Freiling, Perez, Ullman
5050 5 22 825 Freuder, Grossman, Purcell
5052 7 5 814 Brown, McDermott, Sussman
5053 10 13 819 Goldstein, Woods
5054 11 17 822 Marr, Sandewall
5055 12 35 915 Cohen, Gosper, etc.
5056 13 34 913 Baisley, Greenblatt
5058 15 30 925 Jarvis, Moon
5060 17 32 920 Computer room, near PDP-11
5061 20 3 812 Yvonne, Williams
5062 21 36 912 9th Floor Lounge
5063 22 37 914 Larson, Lebel, Mousouriss
5065 27 Tektronix hard-copy output device.
5070 The PDP-11 is not ready.
5072 WHOLIN: examine and set TV who-line (ITS TV)
5074 arg 1 <TTY> or <JOBDEV>
5075 Must be a TV terminal if a <TTY>.
5076 arg 2 If present, used to set new who mode:
5078 0 User who-line; migrates with TTY.
5079 1 User who-line; frozen on who job.
5081 arg 3 If present, used to set new who <JOB>.
5085 The TTY must be specified by a channel number and not
5086 by 400000 + tty number if the variables are to be altered.
5093 No tty exists with the specified number.
5094 10 DEVICE NOT AVAILABLE
5095 The PDP-11 which services the TV consoles is down.
5096 34 WRONG TYPE DEVICE
5097 The specified tty was not a TV, or the specified
5098 channel was not a <TTY> or <JOBDEV>.
5100 WHYINT: Find out reason for second-word interrupt
5102 arg 1 channel # (or <JOBDEV>)
5104 val 1 %WY code (see below)
5105 val 2-n device-dependent
5107 This system call is the standard response to a second-word
5108 (.IFPIR) interrupt. The first value returned is a code
5109 number which indicates the type of device on the channel.
5110 Usually a program will know what type of device is present,
5111 because it only tries to use one type, but this value
5112 is provided just in case. The codes are:
5120 7 %WYTCP TCP Internet
5121 The device-dependent values returned are:
5123 For a TTY input channel:
5125 val 2 character typed. Reading characters this way
5126 does not interfere with later reading them via
5127 normal IOT. This allows characters to be processed
5128 both as interrupt characters at the time they are
5129 typed, and as normal input. The call fails to
5130 skip if there are no more interrupt characters.
5131 The program should keep calling WHYINT until
5132 it fails to skip, then DISMIS the interrupt.
5134 For a TTY output channel:
5136 val 2 bit mask of reasons. The only reason that presently
5138 4.9 --MORE-- interrupt. (Typeout reached
5139 the bottom of the screen.)
5141 For a STY input channel:
5144 For a STY output channel:
5147 For a NET (Arpanet NCP) channel:
5149 val 2 Sign bit 1 if "network interrupt" received.
5150 Right Half Socket state:
5151 0 %NSCLS Connection closed.
5152 1 %NSLSN Listening for RFC.
5153 2 %NSRFC RFC received while listening.
5154 3 %NSRCL CLS received while in %NSRFC state.
5156 5 %NSOPN Connection open.
5157 6 %NSRFN RFNM wait on write link.
5158 7 %NSCLW CLS sent, waiting for matching CLS.
5159 10 %NSCLI CLS received but input still available.
5160 11 %NSINP Input available.
5161 val 3 Number of bytes of input available (if input channel).
5162 Number of bytes free in output buffer (if output channel.)
5163 val 4 Close reason. Only valid if val 2 is %NSCLS.
5164 0 %NCNTO Never opened.
5165 1 %NCUSR Closed by user.
5166 2 %NCFRN Closed by foreign host.
5167 3 %NCRST Foreign host reset itself.
5168 4 %NCDED Foreign host dead.
5169 5 %NCINC Incomplete transmission.
5170 6 %NCBYT Byte size mismatch.
5171 7 %NCNCP Local NCP went down (local host dead).
5172 10 %NCRFS Request for Connection rejected by fgn host.
5176 val 2 state code (see below)
5177 val 3 input: # bytes avail, output: # bytes free in buffer
5178 val 4 Close reason (same values/meanings as for NET. See
5179 definition of %NX== in SYSTEM;BITS > if curious.)
5181 The TCP state codes are defined in SYSTEM;BITS > at %NT==:
5182 ; Legend: - Pre-Open, * Open, + Post-open, ? impossible.
5183 ; I = can read, O = can write.
5184 ; Note that the input and output channels for a TCP connection
5185 ; will usually have different states. Also, note that
5186 ; for all practical purposes, %NT and %NS symbols with the same
5187 ; value have the same meaning. SYN = Request for connection.
5189 %NTCLS==:0 ; - - Closed (reason available from WHYINT)
5190 %NTLSN==:1 ; - - Listening for a SYN
5191 %NTSYR==:2 ; - - SYN received
5192 %NTCLU==:3 ; + ? Being closed by fgn host
5193 %NTSYN==:4 ; - - SYN sent, waiting for response
5194 %NTOPN==:5 ; *I *O Open
5195 %NTWRT==:6 ; ? *O Output buffer full
5196 %NTCLX==:7 ; ? + Being closed by user
5197 %NTCLI==:10 ; +I ? Closing/closed, input still available
5198 %NTINP==:11 ; *I ? Open, input available
5204 val 3 - number of packets queued (receive,,transmit)
5205 val 4 - window size (receive,,transmit)
5206 val 5 - input channel#,,output channel# (-1 if not open or I/O-pushed)
5208 LH(val 3) is the number of packets available to input IOT.
5209 This is different from the number of received packets
5210 if some are out of order. This is increased by 1 if
5211 there is a partially-read buffer available to SIOT;
5212 this packet is not available to PKTIOT. This is zero
5213 if the connection is direct-connected to a STY.
5215 RH(val 3) is the number of packet slots available in the output
5216 window, i.e. the window size minus the number of packets
5217 which have been transmitted by output IOT but which have
5218 not yet been received and acknowledged by the foreign
5221 The state codes are:
5228 %CSLOS Broken by receipt of "LOS" packet.
5229 %CSINC Broken by incomplete transmission (no acknowledge
5234 34 WRONG TYPE DEVICE
5235 The specified channel supposedly never gives interrupts.
5237 XGPIM: xerox graphic printer image output
5239 arg 1 Address of a word with the number of pages of
5240 data in the left half and the number of the first
5241 data page in right half.
5242 This word must be in writable memory.
5244 Bits are shoved out onto the XGP.
5246 I wonder what the precise semantics of this kludge are?