Browse Prior Art Database

Network PL1 subprograms (RFC0120)

IP.com Disclosure Number: IPCOM000002013D
Original Publication Date: 1971-Apr-21
Included in the Prior Art Database: 2000-Sep-12
Document File: 13 page(s) / 35K

Publishing Venue

Internet Society Requests For Comment (RFCs)

Related People

M. Krilanovich: AUTHOR

Abstract

A set of assembly-language written subprograms is provided to facilitate the use of the Network by PL1 programmers. They serve as an interface between the user and the Network Control Program (NCP), which supervises all Network operations at this site.

This text was extracted from a ASCII document.
This is the abbreviated version, containing approximately 8% of the total text.

NETWORK PL1 SUBPROGRAMS

April 21, 1971

Mark Krilanovich

Computer Research Lab

University of California

Santa Barbara, California

PREFACE

The subroutines described in this document have been implemented at UCSB

and make the Network (via the NCP) accessible to PL1 programs executing

in the 360/75. They are callable from within any PL1 main program or

subroutine compiled at UCSB.

A set of assembly-language written subprograms is provided to

facilitate the use of the Network by PL1 programmers. They serve as

an interface between the user and the Network Control Program (NCP),

which supervises all Network operations at this site.

A concept fundamental to PL1 Network operations is that of a

completion code variable. Associated with each socket that is not in

the closed state is a unique variable, called a completion code

variable. This variable serves two purposes: it identifies the

local socket referenced, and upon completion of the operation it

contains a completion code to indicate the outcome of the operation

to the programmer. It may be used at any time for any purpose other

than Network operations. Its value at the beginning of a Network

operation is immaterial; rather, it is the variable itself that is

important. In all Network operations, whenever a completion code

variable is called for, the only acceptable attributes for the

variable are BINARY FIXED(31,0)ALIGNED.

In general, the subprograms will initiate the operation, and enter

the WAIT state (consume no CPU time) until notified by the NCP of the

completion of the operation. For such operations, the programmer

supplies a time limit, with attributes BINARY FIXED(31,0), which

specifies, in tenths of a second, the maximum length of time the

subprogram is to wait for the operation to complete. If this time

limit is exceeded, a completion code is supplied to indicate the

error, and control is returned to the calling program, with the

operation still pending.

In those operations requiring a socket to be specified by its socket

identifier, the following format is used. The identifier is

specified as a BINARY FIXED(31,0) array, singly dimensioned with at

least two elements, and with a lower subscript bound of one. The

first element is taken to be the site number, and the second element

the socket number. A socket n...