home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 600s / rfc674.txt < prev    next >
Text File  |  1992-10-14  |  12KB  |  298 lines
  1.  
  2.  
  3.  
  4.  
  5. <GJOURNAL>31484.NLS;1, 12-DEC-74 04:32 XXX ;;;;   Title:  Author(s):
  6. Jonathan B. Postel/JBP; Distribution: /NAG( [ ACTION ] ) NLG( [ ACTION ]
  7. ) NSW( [ ACTION ] ) PI( [ ACTION ] ) ; Sub-Collections: NIC NWG  SRI-ARC
  8. NAG NLG NSW PI; RFC# 674; Clerk: JAKE;         Origin: < NETINFO,
  9. RFC674.NLS;2, >, 11-DEC-74 17:58 JAKE ;;;;####;
  10.  
  11. NWG/RFC# 674                                JBP 11-DEC-74 18:04  31484
  12. Procedure Call Protocol Documents
  13.  
  14.  
  15.  
  16. Request for Comments 674                                    Jon Postel
  17. NIC 31484                                                    Jim White
  18.                                                                SRI-ARC
  19.                                                       12 December 1974
  20.  
  21.                   Procedure Call Protocol Documents
  22.                               Version 2
  23.  
  24.  
  25.                                                                            1
  26.  
  27. As many of you may know SRI is part of a team working on the National
  28. Software Works project. In the course of our work we have developed a
  29. Procedure Call Protocol to be used between the modules which make up
  30. the NSW. We are interested in your comments on this protocol. Please
  31. foreward your remarks to either:                                           2
  32.  
  33.    James E. White (WHITE@SRI-ARC) or Jon Postel (POSTEL@SRI-ARC)          2a
  34.  
  35.                      Augmentation Research Center
  36.                      Stanford Research Institute
  37.                      Menlo Park, California 94025                         2b
  38.  
  39.             (415) 326-6200 x2960 (White) or x3718 (Postel)                2c
  40.  
  41. This note announces the release of the second published version of
  42. several National Software Works (NSW) and Procedure Call Protocol
  43. (PCP) documents. Version 2 is SUBSTANTIALLY different than Version 1;
  44. it and all intermediate, informally distributed PCP documents are
  45. obsoleted by this release.                                                 3
  46.  
  47. Each of the following documents is available on-line in two forms: as
  48. an NLS file and as a formatted text file.  The Journal number (e.g.
  49. 24459) refers to the former, of course, and the pathname (e.g.
  50. [SRI-ARC]<NLS>PCP.TXT) to the latter, accessible via FTP using
  51. USER=ANONYMOUS and PASSWORD=GUEST (no account required). Let it be
  52. emphasised that files indicated by pathname of the form
  53. [SRI-ARC]<NLS>name.TXT are ASCII text files not NLS files.                 4
  54.  
  55. The specifications are contained in the following documents:               5
  56.  
  57.    HOST      (24581,)  "NSW Host Protocol"                                5a
  58.  
  59.       This document describes the host level protocol used in the NSW.
  60.       The protocol is a slightly constrained version of the standard
  61.       ARPANET host to host protocol. The constraints  affect the
  62.       allocation, RFNM wait, and retransmission policies.                5a1
  63.  
  64. NWG/RFC# 674                                JBP 11-DEC-74 18:04  31484
  65. RFC 674;                                              PCP Announcement
  66.  
  67.  
  68.  
  69.          Pathname: [SRI-ARC]<NLS>HOST.TXT                               5a1a
  70.  
  71.    PCP       (24459,)  "The Procedure Call Protocol"                      5b
  72.  
  73.       This document describes the virtual programming environment
  74.       provided by PCP, and the inter-process exchanges that implement
  75.       it.                                                                5b1
  76.  
  77.          Pathname: [SRI-ARC]<NLS>PCP.TXT                                5b1a
  78.  
  79.    PIP       (24460,)  "The Procedure Interface Package"                  5c
  80.  
  81.       This document describes a package that runs in the setting
  82.       provided by PCP and that serves as a procedure-call-level
  83.       interface to PCP proper.  It includes procedures for calling,
  84.       resuming, interrupting, and aborting remote procedures.            5c1
  85.  
  86.          Pathname: [SRI-ARC]<NLS>PIP.TXT                                5c1a
  87.  
  88.    PSP       (24461,)  "The PCP Support Package"                          5d
  89.  
  90.       This document describes a package that runs in the setting
  91.       provided by PCP and that augments PCP proper, largely in the
  92.       area of data store manipulation.  It includes procedures for
  93.       obtaining access to groups of remote procedures and data stores,
  94.       manipulating remote data stores, and creating temporary ones.      5d1
  95.  
  96.          Pathname: [SRI-ARC]<NLS>PSP.TXT                                5d1a
  97.  
  98.    PMP       (24462,)  "The Process Management Package"                   5e
  99.  
  100.       This document describes a package that runs in the setting
  101.       provided by PCP and that provides the necessary tools for
  102.       interconnecting two or more processes to form a multi-process
  103.       system (e.g. NSW).  It includes procedures for creating,
  104.       deleting, logically and physically interconnecting processes,
  105.       and for allocating and releasing processors.                       5e1
  106.  
  107.          Pathname: [SRI-ARC]<NLS>PMP.TXT                                5e1a
  108.  
  109.    PCPFMT    (24576,)  "PCP Data Structure Formats"                       5f
  110.  
  111.       This document defines formats for PCP data structures, each of
  112.       which is appropriate for one or more physical channel types.       5f1
  113.  
  114.          Pathname: [SRI-ARC]<NLS>PCPFMT.TXT                             5f1a
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                                   1
  122.  
  123. NWG/RFC# 674                                JBP 11-DEC-74 18:04  31484
  124. RFC 674;                                              PCP Announcement
  125.  
  126.  
  127.  
  128.    PCPHST    (24577,)  "PCP ARPANET Inter-Host IPC Implementation"        5g
  129.  
  130.       This document defines an implementation, appropriate for
  131.       mediating communication between Tenex forks, of the IPC
  132.       primitives required by PCP.                                        5g1
  133.  
  134.          Pathname: [SRI-ARC]<NLS>PCPHST.TXT                             5g1a
  135.  
  136.    PCPFRK    (24578,)  "PCP Tenex Inter-Fork IPC Implementation"          5h
  137.  
  138.       This document defines an implementation, appropriate for
  139.       mediating communication between processes on different hosts
  140.       within the ARPANET, of the IPC primitives required by PCP.         5h1
  141.  
  142.          Pathname: [SRI-ARC]<NLS>PCPFRK.TXT                             5h1a
  143.  
  144.    EXEC      (24580,)  "The Executive Package"                            5i
  145.  
  146.       This document describes a package that runs in the setting
  147.       provided by PCP.  It includes procedures and data stores for
  148.       user identification, accounting, and usage information.            5i1
  149.  
  150.          Pathname: [SRI-ARC]<NLS>EXEC.TXT                               5i1a
  151.  
  152.    FILE      (24582,)  "The File Package"                                 5j
  153.  
  154.       This document describes a package that runs in the setting
  155.       provided by PCP.  It includes procedures and data stores for
  156.       opening, closing, and listing directories, for creating,
  157.       deleting, and renaming files, and for transfering files and file
  158.       elements between processes.                                        5j1
  159.  
  160.          Pathname: [SRI-ARC]<NLS>FILE.TXT                               5j1a
  161.  
  162.    BATCH     (24583,)  "The Batch Job Package"                            5k
  163.  
  164.       This document describes a package that runs in the setting
  165.       provided by PCP.  It includes procedures for creating and
  166.       deleting batch jobs, obtaining the status of a batch job, and
  167.       communicating with the operator of a batch processing host. This
  168.       package is implemented at the host that provides the batch
  169.       processing facility.                                               5k1
  170.  
  171.          Pathname: [SRI-ARC]<NLS>BATCH.TXT                              5k1a
  172.  
  173.    RJE-MODEL (24655,)  "The NSW Remote Job Entry Model"                   5l
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                   2
  181.  
  182. NWG/RFC# 674                                JBP 11-DEC-74 18:04  31484
  183. RFC 674;                                              PCP Announcement
  184.  
  185.  
  186.  
  187.       This document discusses the process of utilizing a batch
  188.       processing facility to complete a programming task in the NSW
  189.       environment. This same activity in another environment might
  190.       utilize a remote job entry system.                                 5l1
  191.  
  192.          Pathname: [SRI-ARC]<NLS>RJE-MODEL.TXT                          5l1a
  193.  
  194.    LLDBUG    (24579,)  "The Low-Level Debug Package"                      5m
  195.  
  196.       This document describes a package that runs in the setting
  197.       provided by PCP.  It includes procedures for a remote process to
  198.       debug at the assembly-language level, any process known to the
  199.       local process.  The package contains procedures for manipulating
  200.       and searching the process' address space, for manipulating and
  201.       searching its symbol tables, and for setting and removing
  202.       breakpoints from its address space.  Its data stores hold
  203.       process characteristics and state information, and the contents
  204.       of program symbol tables.                                          5m1
  205.  
  206.          Pathname: [SRI-ARC]<NLS>LLDBUG.TXT                             5m1a
  207.  
  208.    TBH       (24656,)  "NSW Requirments on Tool Bearing Hosts"            5n
  209.  
  210.       This document discusses the environment needed in the tool
  211.       bearing host and the interfaces to the operating system
  212.       components by various PCP packages.                                5n1
  213.  
  214.          Pathname: [SRI-ARC]<NLS>TBH.TXT                                5n1a
  215.  
  216.    BOXES     (24584,)  "Black Boxes in PCP"                               5o
  217.  
  218.       This document describes the transliteration of the black boxes
  219.       defined by Millstein and Warshall into the setting provided by
  220.       PCP, especially the File Package and the Executive Package.        5o1
  221.  
  222.          Pathname: [SRI-ARC]<NLS>BOXES.TXT                              5o1a
  223.  
  224. The document on the Host level protocol, HOST, is a suggestion for
  225. some restrictions on the regular ARPANET host protocol for use in NSW,
  226. this topic has little impact on the remainder of the NSW protocols.
  227. The reader is urged to begin with the major Procedure Call Protocol
  228. documents.                                                                 6
  229.  
  230. The document on PCP is the place the interested reader should start.
  231. It gives the required motivation for the Protocol and states the
  232. substance of the Protocol proper.                                          7
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.                                   3
  240.  
  241. NWG/RFC# 674                                JBP 11-DEC-74 18:04  31484
  242. RFC 674;                                              PCP Announcement
  243.  
  244.  
  245.  
  246. The reader may then proceed to the next three documents: PIP, PSP and
  247. PMP. The latter has the most relavence to the casual reader; the
  248. programmer faced with coding in the PCP environment should read all
  249. three.                                                                     8
  250.  
  251. The three documents PCPFMT, PCPHST, and PCPFRK specify low level
  252. details of the communication formats and are of interest only to PCP
  253. implementers.                                                              9
  254.  
  255. The documents EXEC, FILE and BATCH describe procedure packages to be
  256. implemented as appropriate to provide the services of the
  257. accounting/status/usage statistics subsystem, the file subsystem or
  258. batch processing subsystem respectively.                                  10
  259.  
  260. The document RJE-MODEL describes how a user would utilize various
  261. tools in the NSW in the process of  carrying out tasks he might in the
  262. absence of NSW achieve using a remote job entry system. This should be
  263. read with the document on BATCH.
  264.                                                                           11
  265.  
  266. The LLDBUG package specifies a debugging package that operates in the
  267. PCP environment.                                                          12
  268.  
  269. The document called BOXES describes a mapping between the PCP
  270. mechanisms and the File Package procedures and the Black Boxes needed
  271. by the Works Manager.                                                     13
  272.  
  273. The document TBH speaks to the requirements placed on the Tool Bearing
  274. Host. This document indicates how and where various PCP packages
  275. interface to an operating system.                                         14
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.                                   4