# HG changeset patch
# User roug
# Date 1043268198 0
# Node ID 10fa04d30a712383777509b523b43381c2b4002e
# Parent 5c80e10a5d03d986f18d4bc21d95a33a7f6f4cc7
Updated to use symbols renamed under Level I V1.2
diff -r 5c80e10a5d03 -r 10fa04d30a71 docs/os9sysprog/os9sysprog.docbook
--- a/docs/os9sysprog/os9sysprog.docbook Tue Jan 21 21:17:37 2003 +0000
+++ b/docs/os9sysprog/os9sysprog.docbook Wed Jan 22 20:43:18 2003 +0000
@@ -330,7 +330,7 @@
-OS9 I$READ
+OS9 I$Read
@@ -338,7 +338,7 @@
SWI2
-FCB I$READ
+FCB I$Read
@@ -347,7 +347,7 @@
I/O REQUESTS perform various input/output functions. Requests of
this type are passed by the kernel to IOMAN for processing. The
symbolic names for this category have a "I$" prefix, for example,
-the "read" service request is called "I$READ".
+the "read" service request is called "I$Read".
FUNCTION REQUESTS perform memory management, multiprogramming, and
miscellaneous functions. Most are processed by the kernel. The
@@ -1429,7 +1429,7 @@
The initialization table is copied into the "option section"
of the path descriptor when a path to the device is opened. The
values in this table may be used to define the operating parameters
-that are changeable by the OS9 I$GSTT and I$SSTT service requests.
+that are changeable by the OS9 I$GetStt and I$SetStt service requests.
For example, a terminal's initialization parameters define which
control characters are used for backspace, delete, etc. The maximum
size of initialization table which may be used is 32 bytes. If the
@@ -2137,7 +2137,7 @@
managers, the second and third sections are defined by RBFMAN and
RBFMAN-type device drivers. The option section of the path descriptor
contains many device operating parameters which may be read and/or
-written by the OS9 I$GSTT and I$SSTT service requests. This section
+written by the OS9 I$GetStt and I$SetStt service requests. This section
is initialized by IOMAN which copies the initialization table of the
device descriptor into the option section of the path descriptor when
a path to a device is opened. Any values not determined by this table
@@ -2678,7 +2678,7 @@
- If disk writes are verified, use the F$SRQM service, request
+ If disk writes are verified, use the F$SRqMem service, request
to allocate a 256 byte buffer area where a sector may be read back
and verified after a write.
Initialize the device permanent storage. For floppy disk
@@ -2878,12 +2878,12 @@
These routines are wild card calls used to get (set) the device's
-operating parameters as specified for the OS9 I$GSTT and I$SSTT
+operating parameters as specified for the OS9 I$GetStt and I$SetStt
service requests.
It may be necessary to examine or change the register stack which
-contains the values of MPU registers at the time of the I$GSTT or
-I$SSTT service request. The address of the register stack may be
+contains the values of MPU registers at the time of the I$GetStt or
+I$SetStt service request. The address of the register stack may be
found in PD.RGS, which is located in the path descriptor, . The
following offsets may be used to access any particular value in the
register stack:
@@ -3013,7 +3013,7 @@
3. Remove the device from the IRQ polling list.
4. If the INIT routine reserved a 256 byte buffer for verifying
-disk writes, return the memory with the F$MEM service request.
+disk writes, return the memory with the F$Mem service request.
@@ -3116,7 +3116,7 @@
logical sector specified in DD.BT and extending for (DD.BSZ/256+1)
sectors.
-4. Use the OS9 F$SRQM service request to request the memory area
+4. Use the OS9 F$SRqMem service request to request the memory area
where the boot file will be loaded into.
5. Read the boot file into this memory area.
@@ -3147,7 +3147,7 @@
SCFMAN Line Editing Functions
-I$READ and I$WRITE service requests (which correspond to Basic09
+I$Read and I$Write service requests (which correspond to Basic09
GET and PUT statements) to SCFMAN-type devices pass data to/from the
device without any modification, except that keyboard interrupt,
keyboard abort, and pause character are filtered out of the input
@@ -3156,14 +3156,14 @@
automatically followed by line feeds or nulls, and the high order
bits are passed as sent/received.
-I$RDLN and I$WRLN service requests (which correspond to Basic09
+I$ReadLn and I$WritLn service requests (which correspond to Basic09
INPUT, PRINT, READ and WRITE statements) to SCFMAN-type devices
perform full line editing of all functions enabled for the particular
device. These functions are initialized when the device is first used
by copying the option table from the device descriptor table
associated with the specific device. They may be altered anytime
-afterwards from assembly language programs using the I$SSTT and
-I$GSST service requests, or from the keyboard using the TMODE
+afterwards from assembly language programs using the I$SetStt and
+I$GetStt service requests, or from the keyboard using the TMODE
command. Also, all bytes transfered in this mode will have the high
order bit cleared.
@@ -3196,26 +3196,26 @@
line if PD.DLO = 0, or echo CR/LF if PD.DLO <> 0.
PD.EOR defines the end of record character. This is the last
-character an each line entered (I$RDLN), and terminates the output
-(I$WRLN) when this character is sent. Normally PD.EOR will be set
+character an each line entered (I$ReadLn), and terminates the output
+(I$WritLn) when this character is sent. Normally PD.EOR will be set
to $0D. If it is set to zero, SCF's READLN will NEVER terminate,
unless an EOF occurs.
If PD.EOF <> 0, it defines the end of file character. SCFMAN
-will return an end-of-file error on I$READ or I$RDLN if this is the
+will return an end-of-file error on I$Read or I$ReadLn if this is the
first (and only) character input. It can be disabled by setting its
value to zero.
-If PD.RPR <> 0, SCF (I$RDLN) will, upon receipt of this
+If PD.RPR <> 0, SCF (I$ReadLn) will, upon receipt of this
character, echo a carriage return [optional line feed], and then
reprint the current line.
-If PD.DUP <> 0, SCF (I$RDLN) will duplicate whatever is in
+If PD.DUP <> 0, SCF (I$ReadLn) will duplicate whatever is in
the input buffer through the first "PD.EOR" character.
If PD.PSC <> 0, output is suspended before the next "PD.EOR"
character when this character is input. This will also delete any
-"type ahead" input for I$RDLN.
+"type ahead" input for I$ReadLn.
If PD.INT <> 0, and is received on input, a keyboard
interrupt signal is sent to the last user of this path. Also it will
@@ -3229,12 +3229,12 @@
keyboard interrrupt signal code. This location is normally set to a
control-Q character.
-If PD.OVF <> 0, It is echoed when I$RDLN has satisfied its
+If PD.OVF <> 0, It is echoed when I$ReadLn has satisfied its
input byte count without finding a "PD.EOR" character.
NOTE: It is possible to disable most of these special editing
functions by setting the corresponding control character in the path
-descriptor to zero by using the I$SSTT service request, or by running
+descriptor to zero by using the I$SetStt service request, or by running
the TMODE utility. A more permanent solution may be had by setting
the corresponding control character value in the device descriptor
module to zero.
@@ -3357,7 +3357,7 @@
and third section are specific for SCFMAN and SCFMAN-type device
drivers. The option section of the path descriptor contains many
device operating parameters whicb may be read or written by the OS9
-I$GSTT or I$SSTT service requests. IOMAN initializes this section
+I$GetStt or I$SetStt service requests. IOMAN initializes this section
when a path is opened to a device by copying the corresponding device
descriptor initialization table. Any values not determined by this
table will default to zero.
@@ -3712,7 +3712,7 @@
This routine should get the next character from the input
buffer. If there is no data ready, this routine should copy its
-process ID from V.BUSY into V.WAKE and then use the F$SLEP service
+process ID from V.BUSY into V.WAKE and then use the F$Sleep service
request to put itself to sleep.
Later when data is recieved, the IRQ service routine will leave
@@ -3810,7 +3810,7 @@
This routine is a wild card call used to get (set) the device
-parameters specified in the I$GSTT and I$SSTT service requests.
+parameters specified in the I$GetStt and I$SetStt service requests.
Currently all of the function codes defined by Microware for SCF-type
devices are handled by IOMAN or SCFMAN. Any codes not defined
by Microware will be passed to the device driver.
@@ -4146,12 +4146,12 @@
to the IRQ polling table.
When a device driver routine does something that will result in an
-interrupt, it should immediately execute a F$SLEP service request.
+interrupt, it should immediately execute a F$Sleep service request.
This results in the process' deactivation. When the interrupt in
question occurs, its service routine is executed after some random
interval. It should then do the minimal amount of processing
required, and send a "wakeup" signal to its associated process using
-the F$SEND service request. It may also put some data in its static
+the F$Send service request. It may also put some data in its static
storage (I/O data and status) which is shared with its associated
"sleeping" process.
@@ -4220,7 +4220,7 @@
0011 9F01 LSTENT stx PRMPTR save parameter ptr
0013 8601 lda #READ. select read access mode
-0015 103F84 os9 I$OPEN open input file
+0015 103F84 os9 I$Open open input file
0018 252E bcs LIST50 exit if error
001A 9700 sta IPATH save input path number
001C 9F01 stx PRMPTR save updated param ptr
@@ -4228,24 +4228,24 @@
001E 9600 LIST20 lda IPATH load input path number
0020 3043 leax BUFFER,U load buffer pointer
0022 10BE0C88 ldy #BUFSIZ maximum bytes to read
-0026 103F8B os9 I$RDLN read line of input
+0026 103F8B os9 I$ReadLn read line of input
0029 2509 bcs LIST30 exit if error
002B 8601 lda #1 load std. out. path #
-002D 103F8C os9 I$WRLN output line
+002D 103F8C os9 I$WritLn output line
0030 24EC bcc LIST20 Repeat if no error
0032 2014 bra LIST50 exit if error
0034 C1D3 LIST30 cmpb #E$EOF at end of file?
0036 2610 bne LIST50 branch if not
0038 9600 lda IPATH load input path number
-003A 103F8F os9 I$CLOS close input path
+003A 103F8F os9 I$Close close input path
003D 2509 bcs LIST50 ..exit if error
003F 9E01 ldx PRMPTR restore parameter ptr
0041 A684 lda 0,X
0043 810D cmpa #$0D End of parameter line?
0045 26CA bne LSTENT ..no; list next file
0047 5F clrb
-0048 103F06 LIST50 os9 F$EXIT ... terminate
+0048 103F06 LIST50 os9 F$Exit ... terminate
004B 95BB58 emod Module CRC
@@ -4529,7 +4529,7 @@
LDA PATHNUM
-OS9 I$CLOS
+OS9 I$Close
BCS ERROR
@@ -4557,7 +4557,7 @@
-ABIT Set bits in an allocation bit map F$ABIT
+ABIT Set bits in an allocation bit map F$AllBit
@@ -4566,7 +4566,7 @@
ASSEMBLER CALL:
- OS9 F$ABIT
+ OS9 F$AllBit
MACHINE CODE:
@@ -4599,7 +4599,7 @@
-CHAIN Load and execute a new primary module F$CHAN
+CHAIN Load and execute a new primary module F$Chain
@@ -4608,7 +4608,7 @@
ASSEMBLER CALL:
- OS9 F$CHAN
+ OS9 F$Chain
MACHINE CODE:
@@ -4691,21 +4691,21 @@
WARNING: The hardware stack pointer (SP) should be located
-somewhere in the direct page before the F$CHAN service request is
+somewhere in the direct page before the F$Chain service request is
executed to prevent a "suicide attempt" error or an actual suicide
(system crash). This will prevent a suicide from occurring in case
the new module requires a smaller data area than what is currently
being used. You should allow approximately 200 bytes of stack space
-for execution of the F$CHAN service request and other system
+for execution of the F$Chain service request and other system
"overhead".
-For more information, please see the F$FORK service request
+For more information, please see the F$Fork service request
description.
-COMPARE NAMES Compare two names F$CNAM
+COMPARE NAMES Compare two names F$CmpNam
@@ -4714,7 +4714,7 @@
ASSEMBLER CALL:
- OS9 F$CNAM
+ OS9 F$CmpNam
MACHINE CODE:
@@ -4789,7 +4789,7 @@
-DBIT Deallocate in a bit map F$DBIT
+DBIT Deallocate in a bit map F$DelBit
@@ -4798,7 +4798,7 @@
ASSEMBLER CALL:
- OS9 F$DBIT
+ OS9 F$DelBit
MACHINE CODE:
@@ -4831,7 +4831,7 @@
-EXIT Terminate the calling process. F$EXIT
+EXIT Terminate the calling process. F$Exit
@@ -4840,7 +4840,7 @@
ASSEMBLER CALL:
- OS9 F$EXIT
+ OS9 F$Exit
MACHINE CODE:
@@ -4873,7 +4873,7 @@
-FORK Create a new process. F$FORK
+FORK Create a new process. F$Fork
@@ -4882,7 +4882,7 @@
ASSEMBLER CALL:
- OS9 F$FORK
+ OS9 F$Fork
MACHINE CODE:
@@ -4979,13 +4979,13 @@
concurrently. If the parent executes a F$WAIT call
immediately after the fork, it will wait until the child dies before
it resumes execution. Caution should be exercised when recursively
-calling a program that uses the F$FORK service request since another
+calling a program that uses the F$Fork service request since another
child may be created with each "incarnation". This will
continue until the process table becomes full.
-INTERCEPT Set up a signal intercept trap. F$ICFT
+INTERCEPT Set up a signal intercept trap. F$Icpt
@@ -4994,7 +4994,7 @@
ASSEMBLER CALL:
- OS9 F$ICFT
+ OS9 F$Icpt
MACHINE CODE:
@@ -5038,7 +5038,7 @@
B = Signal code.
NOTE: The value of DP may not be the same as it was when the
-F$ICFT call was made.
+F$Icpt call was made.
Whenever a signal is received. OS-9 will pass the signal code and
the base address of its data area (which was defined by a F$ICPT
@@ -5207,7 +5207,7 @@
-MEM Resize data memory area, F$MEM
+MEM Resize data memory area, F$Mem
@@ -5216,7 +5216,7 @@
ASSEMBLER CALL:
- OS9 F$MEM
+ OS9 F$Mem
MACHINE CODE:
@@ -5260,7 +5260,7 @@
-PRERR Print error message. F$PERR
+PRERR Print error message. F$PErr
@@ -5269,7 +5269,7 @@
ASSEMBLER CALL:
- OS9 F$PERR
+ OS9 F$PErr
MACHINE CODE:
@@ -5305,7 +5305,7 @@
-PARSENAME Parse a path name, F$PNAM
+PARSENAME Parse a path name, F$PrsNam
@@ -5314,7 +5314,7 @@
ASSEMBLER CALL:
- OS9 F$PNAM
+ OS9 F$PrsNam
MACHINE CODE:
@@ -5351,7 +5351,7 @@
Note that this system call processes only one name, so several
calls may be needed to process a pathlist that has more than one name.
-BEFORE F$PNAM CALL:
+BEFORE F$PrsNam CALL:
+---+---+---+---+---+---+---+---+---+---+---+---+---
! / ! D ! 0 ! / ! F ! I ! L ! E ! ! ! ! !
@@ -5359,7 +5359,7 @@
^
X
-AFTER THE F$PNAM CALL:
+AFTER THE F$PrsNam CALL:
+---+---+---+---+---+---+---+---+---+---+---+---+---
! / ! D ! 0 ! / ! F ! I ! L ! E ! ! ! ! !
@@ -5370,7 +5370,7 @@
-SBMAP Search bit map for a free area F$SBIT
+SBMAP Search bit map for a free area F$SchBit
@@ -5379,7 +5379,7 @@
ASSEMBLER CALL:
- OS9 F$SBIT
+ OS9 F$SchBit
MACHINE CODE:
@@ -5410,7 +5410,7 @@
-SEND Send a signal to another process, F$SEND
+SEND Send a signal to another process, F$Send
@@ -5419,7 +5419,7 @@
ASSEMBLER CALL:
- OS9 F$SEND
+ OS9 F$Send
MACHINE CODE:
@@ -5472,12 +5472,12 @@
a "sleep" call for a few ticks before a retry to avoid
wasting MPU time.
-For related information see the F$ICPT, F$WAIT and F$SLEP service
+For related information see the F$ICPT, F$WAIT and F$Sleep service
request descriptions.
-SLEEP Put calling process to sleep. F$SLEP
+SLEEP Put calling process to sleep. F$Sleep
@@ -5486,7 +5486,7 @@
ASSEMBLER CALL:
- OS9 F$SLEP
+ OS9 F$Sleep
MACHINE CODE:
@@ -5519,8 +5519,8 @@
The duration of a "tick" is system dependent but is most commonly
100 milliseconds.
-Due to the fact that it is not known when the F$SLEP request was
-made during the current tick, F$SLEP can not be used for precise
+Due to the fact that it is not known when the F$Sleep request was
+made during the current tick, F$Sleep can not be used for precise
timing. A sleep of one tick is effectively a "give up remaining
time slice" request; the process is immediately inserted into
the active process queue and will resume execution when it reaches
@@ -5531,7 +5531,7 @@
-SETPR Set process priority. F$SPRI
+SETPR Set process priority. F$SPrior
@@ -5540,7 +5540,7 @@
ASSEMBLER CALL:
- OS9 F$SPRI
+ OS9 F$SPrior
MACHINE CODE:
@@ -5756,7 +5756,7 @@
-SETIME Set system date and time. F$STIM
+SETIME Set system date and time. F$STime
@@ -5765,7 +5765,7 @@
ASSEMBLER CALL:
- OS9 F$STIM
+ OS9 F$STime
MACHINE CODE:
@@ -5828,7 +5828,7 @@
-TIME Get system date and time. F$TIME
+TIME Get system date and time. F$Time
@@ -5837,7 +5837,7 @@
ASSEMBLER CALL:
- OS9 F$TIME
+ OS9 F$Time
MACHINE CODE:
@@ -5900,7 +5900,7 @@
-UNLINK Unlink a module. F$UNLK
+UNLINK Unlink a module. F$Unlink
@@ -5909,7 +5909,7 @@
ASSEMBLER CALL:
- OS9 F$UNLK
+ OS9 F$Unlink
MACHINE CODE:
@@ -5997,7 +5997,7 @@
-A64 Allocate a 64 byte memory block F$A64
+A64 Allocate a 64 byte memory block F$All64
@@ -6006,7 +6006,7 @@
ASSEMBLER CALL:
- OS9 F$A64
+ OS9 F$All64
MACHINE CODE:
@@ -6037,8 +6037,8 @@
tour sections. The first 64 bytes of the base page are used as a
"page table", which contains the MSB of all pages in the
memory structure. Passing a value of zero in the X register will
-cause the F$A64 service request to allocate a new base page and the
-first 64 byte memory block. Whenever a new page is needed, an F$SRQM
+cause the F$All64 service request to allocate a new base page and the
+first 64 byte memory block. Whenever a new page is needed, an F$SRqMem
service request will automatically be executed. The first byte of
each block contains the block number; routines using this service
request should not alter it. Below is a diagram to show how 7 blocks
@@ -6071,7 +6071,7 @@
-APRC Insert process in active process queue F$APRC
+APRC Insert process in active process queue F$AProc
@@ -6080,7 +6080,7 @@
ASSEMBLER CALL:
- OS9 F$APRC
+ OS9 F$AProc
MACHINE CODE:
@@ -6116,7 +6116,7 @@
-FIND-64 Find a 64 byte memory block F$F64
+FIND-64 Find a 64 byte memory block F$Find64
@@ -6125,7 +6125,7 @@
ASSEMBLER CALL:
- OS9 F$F64
+ OS9 F$Find64
MACHINE CODE:
@@ -6150,7 +6150,7 @@
This system mode service request will return the address of a 64
-byte memory block as described in the F$A64 service request. OS-9
+byte memory block as described in the F$All64 service request. OS-9
used this service request to find process descriptors and path
descriptors when given their number.
@@ -6160,7 +6160,7 @@
-IODEL Delete I/O device from system F$IODL
+IODEL Delete I/O device from system F$IODel
@@ -6169,7 +6169,7 @@
ASSEMBLER CALL:
- OS9 F$IODL
+ OS9 F$IODel
MACHINE CODE:
@@ -6329,7 +6329,7 @@
-NXTPRCS Start next process F$NPRC
+NXTPRCS Start next process F$NProc
@@ -6338,7 +6338,7 @@
ASSEMBLER CALL:
- OS9 F$NPRC
+ OS9 F$NProc
MACHINE CODE:
@@ -6365,7 +6365,7 @@
-R64 Deallocate a 64 byte memory block F$R64
+R64 Deallocate a 64 byte memory block F$Ret64
@@ -6374,7 +6374,7 @@
ASSEMBLER CALL:
- OS9 F$R64
+ OS9 F$Ret64
MACHINE CODE:
@@ -6399,13 +6399,13 @@
This system mode service request deallocates a 64 byte block of
-memory as described in the F$A64 service request.
+memory as described in the F$All64 service request.
NOTE: THIS IS A PRIVILEGED SYSTEM MODE SERVICE REQUEST
-SRQMEM System memory request F$SRQM
+SRQMEM System memory request F$SRqMem
@@ -6414,7 +6414,7 @@
ASSEMBLER CALL:
- OS9 F$SRQM
+ OS9 F$SRqMem
MACHINE CODE:
@@ -6445,7 +6445,7 @@
-SRTMEM Return System Memory F$SRTM
+SRTMEM Return System Memory F$SRtMem
@@ -6454,7 +6454,7 @@
ASSEMBLER CALL:
- OS9 F$SRTM
+ OS9 F$SRtMem
MACHINE CODE:
@@ -6485,7 +6485,7 @@
-VMOD Verify module F$VMOD
+VMOD Verify module F$VModul
@@ -6494,7 +6494,7 @@
ASSEMBLER CALL:
- OS9 F$VMOD
+ OS9 F$VModul
MACHINE CODE:
@@ -6528,7 +6528,7 @@
-ATTACH Attach a new device to the system. I$ATCH
+ATTACH Attach a new device to the system. I$Attach
@@ -6537,7 +6537,7 @@
ASSEMBLER CALL:
- OS9 I$ATCH
+ OS9 I$Attach
MACHINE CODE:
@@ -6597,7 +6597,7 @@
-CHDIR Change working directory. I$CDIR
+CHDIR Change working directory. I$ChgDir
@@ -6606,7 +6606,7 @@
ASSEMBLER CALL:
- OS9 I$CDIR
+ OS9 I$ChgDir
MACHINE CODE:
@@ -6654,7 +6654,7 @@
-CLOSE Close a path to a file/device. I$CLOS
+CLOSE Close a path to a file/device. I$Close
@@ -6663,7 +6663,7 @@
ASSEMBLER CALL:
- OS9 I$CLOS
+ OS9 I$Close
MACHINE CODE:
@@ -6692,16 +6692,16 @@
requesting processes. All OS-9 internally managed buffers and
descriptors are deallocated.
-Note: Because the OS9 F$EXIT service request automatically closes
+Note: Because the OS9 F$Exit service request automatically closes
all open paths (except the standard I/O paths), it may not he
-necessary to close them individually with the OS9 I$CLOS service request.
+necessary to close them individually with the OS9 I$Close service request.
Standard I/O paths are not typically closed except when it is
desired to change the files/devices they correspond to.
-CREATE Create a path to a new file. I$CREA
+CREATE Create a path to a new file. I$Create
@@ -6710,7 +6710,7 @@
ASSEMBLER CALL:
- OS9 I$CREA
+ OS9 I$Create
MACHINE CODE:
@@ -6783,7 +6783,7 @@
-DELETE Delete a file. I$DLET
+DELETE Delete a file. I$Delete
@@ -6792,7 +6792,7 @@
ASSEMBLER CALL:
- OS9 I$DLET
+ OS9 I$Delete
MACHINE CODE:
@@ -6822,7 +6822,7 @@
-DETACH Remove a device from the system. I$DTCH
+DETACH Remove a device from the system. I$Detach
@@ -6831,7 +6831,7 @@
ASSEMBLER CALL:
- OS9 I$DTCH
+ OS9 I$Detach
MACHINE CODE:
@@ -6860,14 +6860,14 @@
device driver and file manager modules associated with the device are
unlinked (and may be destroyed if not in use by another process.
-The I$DTCH service request must be used to un-attach devices that
-were attached with the I$ATCH service request. Both of these are used
+The I$Detach service request must be used to un-attach devices that
+were attached with the I$Attach service request. Both of these are used
mainly by IOMAN and are of limited (or no use) to the typical user.
SCFMAN also uses ATTACH/DETACH to setup its second (echo) device.
-DUP Duplicate a path. I$DUP
+DUP Duplicate a path. I$Dup
@@ -6876,7 +6876,7 @@
ASSEMBLER CALL:
- OS9 I$DUP
+ OS9 I$Dup
MACHINE CODE:
@@ -6911,7 +6911,7 @@
-GETSTAT Get file device status. I$GSTT
+GETSTAT Get file device status. I$GetStt
@@ -6919,7 +6919,7 @@
ASSEMBLER CALL:
- OS9 I$GSTT
+ OS9 I$GetStt
MACHINE CODE:
@@ -6974,22 +6974,22 @@
-SS.OPT
+SS.Opt
0
Read the 32 byte option section of the path descriptor.
-SS.RDY
+SS.Ready
1
Test for data ready on SCFMAN-type device.
-SS.SIZ
+SS.Size
2
Return current file size (on RBFMAN-type devices).
-SS.POS
+SS.Pos
5
Get current file position.
@@ -6998,6 +6998,11 @@
6
Test for end of file.
+
+SS.ScSiz
+38
+Width of screen in characters.
+
@@ -7020,7 +7025,7 @@
- SS.OPT (code 0):
+ SS.Opt (code 0):
Read option section of the path descriptor.
@@ -7055,7 +7060,7 @@
- SS.RDY (code 1):
+ SS.Ready (code 1):
Test for data available on SCFMAN supported devices.
@@ -7079,7 +7084,7 @@
C bit set
(B)
zero
- $F6 (E$NRDY)
+ $F6 (E$NotRdy)
ERROR Code
@@ -7093,7 +7098,7 @@
- SS.SIZ (code 2):
+ SS.Size (code 2):
Get current file size (RBFMAN supported devices only)
@@ -7120,7 +7125,7 @@
- SS.POS (code 5):
+ SS.Pos (code 5):
Get current file position (RBFMAN supported devices only)
@@ -7180,10 +7185,36 @@
-
-
-
-MAKDIR Make a new directory I$MDIR
+
+
+
+
+
+
+ SS.ScSiz (code 38):
+ Return screen size for COCO (SCFMAN supported devices only)
+
+
+ INPUT:
+ (A) = Path number
+(B) = Function code 38
+
+
+ OUTPUT:
+ (X) = Width of screen in characters. Typically 32 or 80.
+
+
+ ERROR OUTPUT:
+ (CC) = C bit set.
+(B) = Appropriate error code.
+
+
+
+
+
+
+
+MAKDIR Make a new directory I$MakDir
@@ -7192,7 +7223,7 @@
ASSEMBLER CALL:
- OS9 I$MDIR
+ OS9 I$MakDir
MACHINE CODE:
@@ -7241,7 +7272,7 @@
-OPEN Open a path to a file or device I$OPEN
+OPEN Open a path to a file or device I$Open
@@ -7249,7 +7280,7 @@
ASSEMBLER CALL:
- OS9 I$OPEN
+ OS9 I$Open
MACHINE CODE:
@@ -7313,7 +7344,7 @@
-READ Read data from a file or device I$READ
+READ Read data from a file or device I$Read
@@ -7322,7 +7353,7 @@
ASSEMBLER CALL:
- OS9 I$READ
+ OS9 I$Read
MACHINE CODE:
@@ -7353,7 +7384,7 @@
additional processing or editing such as backspace, line delete,
end-of-file, etc.
-After all data in a file has been read, the next I$READ service
+After all data in a file has been read, the next I$Read service
request will return an end of file error.
NOTES:
@@ -7374,7 +7405,7 @@
-READLN Read a text line with editing. I$RDLN
+READLN Read a text line with editing. I$ReadLn
@@ -7383,7 +7414,7 @@
ASSEMBLER CALL:
- OS9 I$RDLN
+ OS9 I$ReadLn
MACHINE CODE:
@@ -7420,14 +7451,14 @@
than the maximum specified, it will not be accepted and a PD.OVF
character (normally bell) will be echoed.
-After all data in the file has been read, the next I$RDLN service
+After all data in the file has been read, the next I$ReadLn service
request will return an end of file error.
NOTE: For more information on line editing, see 7.1.
-SEEK Reposition the logical file pointer I$SEEK
+SEEK Reposition the logical file pointer I$Seek
@@ -7436,7 +7467,7 @@
ASSEMBLER CALL:
- OS9 I$SEEK
+ OS9 I$Seek
MACHINE CODE:
@@ -7476,7 +7507,7 @@
-SETSTAT Set file/device status I$SSTT
+SETSTAT Set file/device status I$SetStt
@@ -7484,7 +7515,7 @@
ASSEMBLER CALL:
- OS9 I$SSTT
+ OS9 I$SetStt
MACHINE CODE:
@@ -7538,17 +7569,17 @@
-SS.OPT
+SS.Opt
$0
Write the 32 byte option section of the path descriptor
-SS.SIZ
+SS.Size
$2
Set the file size (RBF)
-SS.RST
+SS.Reset
$3
Restore head to track zero (RBF)
@@ -7558,7 +7589,7 @@
Write (format) track (RBF)
-SS.FEE
+SS.Feed
$9
Issue Form Feed (SCF)
@@ -7578,7 +7609,7 @@
Sequence down disk drive (RBF)
-SS.DCM
+SS.Dcmd
$D
Direct command to hard disk controller (RBF)
@@ -7597,7 +7628,7 @@
- SS.OPT (code 0):
+ SS.Opt (code 0):
Write option section of the path descriptor.
@@ -7625,7 +7656,7 @@
- SS.SIZ (code 2):
+ SS.Size (code 2):
Set the file size (RBFMAN-type devices)
@@ -7650,7 +7681,7 @@
- SS.RST (code 3):
+ SS.Reset (code 3):
Restore head to track zero.
@@ -7675,7 +7706,7 @@
- SS.WTK (code 4):
+ SS.WTrk (code 4):
Write track
@@ -7744,7 +7775,7 @@
-WRITE Write data to file or device I$WRITE
+WRITE Write data to file or device I$Write
@@ -7753,7 +7784,7 @@
ASSEMBLER CALL:
- OS9 I$WRITE
+ OS9 I$Write
MACHINE CODE:
@@ -7789,7 +7820,7 @@
-WRITELN Write line of text with editing I$WRLN
+WRITELN Write line of text with editing I$WritLn
@@ -7798,7 +7829,7 @@
ASSEMBLER CALL:
- OS9 I$WRLN
+ OS9 I$WritLn
MACHINE CODE:
@@ -8435,13 +8466,13 @@
103F 02
- F$UNLK
+ F$Unlink
Unlink a module.
103F 03
- F$FORK
+ F$Fork
Create a new process.
@@ -8453,37 +8484,37 @@
103F 05
- F$CHAN
+ F$Chain
Load and execute a new primary module
103F 06
- F$EXIT
+ F$Exit
Terminate the calling process.
103F 07
- F$MEM
+ F$Mem
Resize data memory area,
103F 08
- F$SEND
+ F$Send
Send a signal to another process,
103F 09
- F$ICFT
+ F$Icpt
Set up a signal intercept trap.
103F 0A
- F$SLEP
+ F$Sleep
Put calling process to sleep.
@@ -8495,7 +8526,7 @@
103F 0D
- F$SPRI
+ F$SPrior
Set process priority.
@@ -8507,49 +8538,49 @@
103F 0F
- F$PERR
+ F$PErr
Print error message.
103F 10
- F$PNAM
+ F$PrsNam
Parse a path name,
103F 11
- F$CNAM
+ F$CmpNam
Compare two names
103F 12
- F$SBIT
+ F$SchBit
Search bit map for a free area
103F 13
- F$ABIT
+ F$AllBit
Set bits in an allocation bit map
103F 14
- F$DBIT
+ F$DelBit
Deallocate in a bit map
103F 15
- F$TIME
+ F$Time
Get system date and time.
103F 16
- F$STIM
+ F$STime
Set system date and time.
@@ -8621,7 +8652,7 @@
103F 28
- F$SRQM
+ F$SRqMem
System memory request
@@ -8633,7 +8664,7 @@
103F 29
- F$SRTMEM
+ F$SRtMemEM
System memory request
@@ -8657,37 +8688,37 @@
103F 2C
- F$APRC
+ F$AProc
Insert process in active process queue
103F 2D
- F$NPRC
+ F$NProc
Start next process
103F 2E
- F$VMODUL
+ F$VModulUL
Validate module
103F 2F
- F$F64
+ F$Find64
Find a 64 byte memory block
103F 30
- F$A64
+ F$All64
Allocate a 64 byte memory block
103F 31
- F$R64
+ F$Ret64
Deallocate a 64 byte memory block
@@ -8699,7 +8730,7 @@
103F 33
- F$IODL
+ F$IODel
Delete I/O device from system
@@ -8907,25 +8938,25 @@
103F 80
- I$ATCH
+ I$Attach
Attach a new device to the system.
103F 81
- I$DTCH
+ I$Detach
Remove a device from the system.
103F 82
- I$DUP
+ I$Dup
Duplicate a path.
103F 83
- I$CREA
+ I$Create
Create a path to a new file.
@@ -8943,61 +8974,61 @@
103F 86
- I$CDIR
+ I$ChgDir
Change working directory.
103F 87
- I$DLET
+ I$Delete
Delete a file.
103F 88
- I$SEEK
+ I$Seek
Reposition the logical file pointer
103F 89
- I$READ
+ I$Read
Read data from a file or device
103F 8A
- I$WRITE
+ I$Write
Write Data to File or Device
103F 8B
- I$RDLN
+ I$ReadLn
Read a text line with editing.
103F 8C
- I$WRLN
+ I$WritLn
Write Line of Text with Editing
103F 8D
- I$GSTT
+ I$GetStt
Get file device status.
103F 8E
- I$SSTT
+ I$SetStt
Set file/device status
103F 8F
- I$CLOS
+ I$Close
Close a path to a file/device.