10.12 OSWORD A=&13		Call Summary

BGeneral descriptionb
These calls allow general local station information to be read and
written.

BOn entry,b

A=&13
YX point to the control block with the first byte determining the function
and number of parameters. Except for codes 0,1,6,7,11,15 and 16 the NFS
does not need to be selected to perform the operations.

Control byte		Function

    0			Read File Server number
    1			Write File Server number

    2			Read Printer Server number
    3			Write Printer Server number

    4			Read Protection mask
    5			Write Protection mask

    6			Read context handles
    7			Write context handles

    8			Read local station number

    9			Read number and size of arguments

   10			Read error number

   11			Read channel error occured on

   12			Read Printer Server name
   13			Write Printer Server name

   14			Read space in NetPrint buffer

   15			Read File Server retry delay
   16			Write File Server retry delay

   17			Translate net number


BOn exit,b

A,X,Y undefined
Control block modified














Issue 01 Jul 1997						10-34

BChannel error occured on 		         OSWORD &13 (control byte=11)b
General description

This call reads the channel number the last error occured on if it occured
on an open file as the result of a random access operation, or zero if it
was not the result of a random access operation. This is the channel
number given in the 'error on channel xx' message.

On entry,

A=&13
YX point to the control block show below:

	0  +-------------------------+
	   |        Control byte     |
	   | 11 = Read channel last  |
	   |      error occured on   |
	1  +-------------------------+
	   |         Channel         |
	2  +-------------------------+

On exit,
A,X,Y undefined
For read operations, the control block is modified as above. For write
operations, the control block is undefined.








BPS name				      OSWORD &13 (control byte=12/13)b
General description

These calls allow the printer server to be selected by name.

On entry,

A=&13
YX point to the control block show below:

	0  --------------------------|
	   |        Control byte     |
	   | 12 = Read printer name  |
	   | 13 = write printer name |
	1  |-------------------------|
	   |   Printer server name   |
	   |   padded with spaces    |
	7  |-------------------------|

On exit,
A,X,Y undefined
For read operations, the control block is modified as above. For write
operations, the control block is undefined.








Issue 01 Jul 1997						10-34

BRead space in NetPrint buffer			 OSWORD &13 (control byte=14)b
General description

This call reads the amount of free space in the NetPrint buffer used by
the network printer device selected by *FX5,4.

On entry,

A=&13
YX point to the control block show below:

	0  --------------------------|
	   |        Control byte     |
	   | 14 = Read free space in |
	   |       NetPrint buffer   |
	1  |-------------------------|
	   | Number of free bytes in |
	   |     NetPrint buffer     |
	7  |-------------------------|

On exit,
A,X,Y undefined
For read operations, the control block is modified as above. For write
operations, the control block is undefined.









BRead and write fileserver retry delays	     OSWORD &13 (control byte=15/16)b
General description

These calls read and write the delays used when retrying calls to the
fileserver.

On entry,

A=&13
YX point to the control block show below:

	0  +-------------------------+
	   |       Control byte      |
	   | 15 = Read retry delay   |
	   | 16 = Write retry delay  |
	1  +-------------------------+
	   |   Not listening delay   |
	2  +-------------------------+
	   |      No reply delay     |
	3  +-------------------------+
	   |       Machine Peek      |
	4  +-------------------------+

On exit,
A,X,Y undefined
For read operations, the control block is modified as above. For write
operations, the control block is undefined.


Issue 01 Jul 1997						10-34

BTranslate net number			         OSWORD &13 (control byte=17)b
General description

This call reads the current network number of the local machine or the file
server, or translates a supplied network number.

On entry,

A=&13
YX point to the control block show below:

	0  +-------------------------+
	   |       Control byte      |
	   | 17 =Translate net number|
	1  +-------------------------+
	   |     this net or &00     |
	2  +-------------------------+
	   |        undefined        |
	3  +-------------------------+
	   |  translated net number  |
	4  +-------------------------+

If XY+1 is &00, then XY+3 is returned holding the local network number. If
XY+3=0, returns XY+3=fs net number. If XY+3=this net, returns XY+3=0. If
XY+3<>this net, returns XY+3 unchanged.


On exit,
A,X,Y undefined
The control block is modified as above.
































Issue 01 Jul 1997						10-34