Google
 

Trailing-Edge - PDP-10 Archives - QT020_T20_4.1_6.1_SWSKIT_851021 - swskit-hacks/eisrv.hlp
There are no other files named eisrv.hlp in the archive.
				EISRV

You must send a message to SYS[INFO] to get the PID of EISRV.  Locically
enough, it's name to SYS[INFO] is "EISRV".

You "sign on" to the server before you issue it any other commands.
There is no sign off command - when you drop your PID, EISRV notices
and signs you out.

IPCF messages should be sent in page mode to the server; responses are also
in page mode.

The first word of the IPCF message is the command number. Illegal values
are ignored. The second word is a "transaction number"; if your command
causes the server to send a message back to you, it will send it back
with the transaction number in the answer (in most cases). It should
be limited to a 24bit value.

The format of following words depends on the command.  Generally, it
is a 2 word Ethernet address, followed by a "EISRV user number."

If the command causes NI traffic to another node, and the other node
doesn't acknowledge the request, you will receive message type
-5, node not answering. This can be delayed for up to 40 seconds
from the time of the request.

=========================User to Server===================================
0	signon

format:
	0	0
	1	<anything, ignored>
	2	asciz/name, usually your username, max of 14 characters/

Your name is put into the server table and can be looked up by other
users.  You are assigned a "EISRV user number" that other server
users use to refer to you (you do not get this number returned to you -
the server keeps track of you by the PID assigned to you).

This command will return a IPCF message indicating whether your signon
is sucessful (see the section on server responses);  the reply will be
one of 0,-1,-2,-3.  0 means a sucessful signon.

	+	+	+	+	+	+	+	+	+
1	send text

format:
	0	1 (send text)
	1	<transaction number>
	2	Ethernet address, 1st four 8bit bytes
	3	Ethernet address, last 2 bytes
	4	Destination server user number
	5	asciz/text, max of about 1400 characters/

You get no response unless there is no such user number at the remote
node, or remote node isn't running the server (see server responses).

	+	+	+	+	+	+	+	+
2	Request Load average

	0	2 (load average)
	1	<transaction number>
	2,3	Ethernet node address

The response sent by the remote server is a text message containing the
node name and load average.

	+	+	+	+	+	+	+	+
3	List known nodes running servers

	0	3 (list known nodes)

The response is 3, nodelist (see the section on server responses)

	+	+	+	+	+	+	+	+	+
4	Find user on node

	0	4 (find user)
	1	<transaction number>
	2,3	Ethernet address
	4	<ignored>
	5	asciz/name text to find/

The response is normally 4 (user found), but can be -5, node not answering.

	+	+	+	+	+	+	+	+	+
5	Who is

	0	5 (who is user)
	1	<transaction number>
	2,3	Etherner address
	4	serveruser number

response is 4 (user found), but can be -5
	+	+	+	+	+	+	+	+	+

6	Dump local server stats

	0	5	(dump stats)

The response is normally 6, Stats

==========================================================================
Server responses

If you have not signed in, you will get the following response to any command:

-4	please sign on

format:	0	-4	(not signed in)

	+	+	+	+	+	+	+	+

In response to a signon (command 0), possible responses are:

0	signon OK

	0	0	(OK)
	1	<ignore>
	2	nodelist, of the form:
		 ethernet address or 0 for end of list	! repeated for
		 ethernet address, 2nd word		! each node the server
		 nodename, first 4 bytes, 8BIT ascii	! knows about
		 nodename, last 2 bytes, 8BIT ascii	!

-1	no room
	0	-1	(no room)

The server has no room for another user

-2	duplicate name
	0	-2	(duplicate)

The server has a user with that name signed in already; user names must be
unique.

-3	duplicate PID
	0	-3	(duplicate PID)

That PID has already signed in.

	+	+	+	+	+	+	+	+	+
The response to a Load average response from another node, or text from
a remote user, comes in the form of a text message:

1	Text

	0	1	(text)
	1	<transaction number>
	2,3	Ethernet address from
	4	EISRV user number from (0 if from server)
	5	asciz/text/

	+	+	+	+	+	+	+	+	+
3	Nodelist

	0	3	(nodelist)
	1	<ignore>
	2	nodelist, same format as the signon response message
	+	+	+	+	+	+	+	+	+
4	User response
In response to commands 4 or 5

	0	4	(user search response)
	1	<transaction number>
	2,3	Ethernet address
	4	<ignore>
	5	job # of user, or 0 if not logged in, or >1000 if not checked
	6	server user number, or 0 if not signed in
	7	asciz/name of user/

	+	+	+	+	+	+	+	+	+
6	Dump stats

	0	6	(stats)
	1	<ignore>
	2	# of messages received by server
	3	# of ACk's received by server
	4	# of duplicate messages received
	5	# of messages sent
	6	# of Ack's sent
	7	# of messages resent
	10	# of times looped waiting for a node to talk to (startup)

	The rest of the page contains the following:

	11,12,13 <trash>

	14-600	local user signon blocks <format may change>