comp.lang.ada
 help / color / mirror / Atom feed
* comp.lang.ada FAQ 2/2
@ 1993-03-25 23:02 Ada Info. Clearinghouse
  0 siblings, 0 replies; only message in thread
From: Ada Info. Clearinghouse @ 1993-03-25 23:02 UTC (permalink / raw)


Archive-name: comp-lang-ada/cla-faq2


comp.lang.ada Frequently Asked Questions part 2 of 2

Effective date: 25 MAR 93

19) Is there a list of Ada compiler vendor e-mail contacts?

      (from drew@verdix.com (Drew Johnson))

      Alsys sales (e-mail contact only): tne@world.std.com (Tom Erickson)
      Alsys sales (voice) Scott Dorman
      Tel: 617/270-0030

      Convex questions: allison@convex.com (Brian Allison)
      Tel: 214/497-4346

      Cray questions: det@cray.com (Dave Thersleff)
      Tel: 612/683-5701
      Cray sales: svc@cray.com (Sylvia Crain)
      Tel: 505/988-2468

      Harris questions: jeffh@ssd.csd.harris.com (Jeff Hollensen)

      IBM/Ada questions: malcho@torolab6.vnet.ibm.com (Don Malcho)
      Tel: 416/448-3727

      Intermetrics questions: ryer@inmet.inmet.com (Mike Ryer)

      Irvine Compiler Corp (ICC) questions: info@irvine.com

      Tartan questions: englert@tartan.com (Susan Englert)
      Tel: 412/856 3600

      Telesoft questions: adasupport@telesoft.com
      Tel: 619/457-2700
      TeleSoft Sales: marketng@telesoft.com (Philippe Collard)
      Tel: 619/457-2700

      Verdix questions: drew@verdix.com (Drew Johnson)
      Verdix sales information: moskow@verdix.com (Paul Moskowitz)
      Tel: 800-BUY-VADS

20) Is there a list of good Ada books?

      Just for a list of texts, etc. (no evaluations or
      recommendations), you might take a look at the ADABOOKS.HLP file
      on the AdaIC Bulletin Board and in the public/ada-info directory
      on the AJPO host (ajpo.sei.cmu.edu).

      Books for use in class (and others):
      (from mfeldman@seas.gwu.edu (Michael B. Feldman))

      As co-chair of the SIGAda Education Committee, and a denizen of
      the Internet newsgroups, I am often asked to give references for
      "Ada textbooks."  This list responds to these many queries.  It
      is far from exhaustive, merely a selected list of 26 books being
      used successfully in undergraduate computer science courses.

      The six books in the Group 1 are written especially for students
      without programming experience, who are learning Ada as their
      first language.  Most of these can also cover at least part of a
      typical CS2-level course.  The seven books in Group 2 use Ada as
      their language of discourse but are "subject-oriented:" data
      structures, file structures, compilers, comparative languages.
      The thirteen books in Group 3 are either "Ada books" focusing on
      the language features or more general books that use Ada, at
      least in part, but do not fit obviously into a standard
      curriculum "pigeonhole."

      I invite you to add to the list.  Please write your annotated
      entry in the form I have used here and write or e-mail it to me.
      I will include it in my next version and credit you as a
      co-compiler of the list.

      Disclaimers: I wrote two of the texts listed here; I hope the
      annotations are impartial enough.  And any annotated
      bibliography is selective and opinionated.  Your mileage may
      vary.

      Group 1: Books Suitable for a First Course in Programming

      Bover, D.C.C., K.J. Maciuas, and M.J. Oudshoorn.
      Ada: A First Course in Programming and Software Engineering.
      Addison-Wesley, 1992.
      This work is, to our knowledge, the first Ada book to emerge
      from Australia, from a group of authors with much collective
      experience in teaching Ada to first-year students.  A number of
      interesting examples are presented, for example, an Othello
      game.  The book is full of gentle humor, a definite advantage in
      a world of dry and serious texts.  In the book's favor is the
      large number of complete programs.  On the other hand, it is
      rather "European" in its terseness; American teachers may miss
      the pedagogical apparatus and "hand-holding" typically found in
      today's CS1 books.  Generic units are hardly mentioned.

      Culwin, F.
      Ada: a Developmental Approach.
      Prentice-Hall, 1992.
      This work introduces Ada along with a good first-year approach
      to software development methodology.  Much attention is paid to
      program design, documentation, and testing.  Enough material is
      present in data structures and algorithm analysis is present to
      carry a CS2 course.  A drawback of the book is that the first
      third is quite "Pascal-like" in its presentation order:
      procedures, including nested ones, are presented rather early,
      and packages are deferred until nearly the middle of the book.
      This is certainly not a fatal flaw, but it will frustrate
      teachers wishing a more package-oriented presentation.  The
      programs and solutions are apparently available from the author.

      Feldman, M.B., and E.B. Koffman.
      Ada: Problem Solving and Program Design.
      Addison-Wesley, 1991.
      This work combines the successful material from Koffman's CS1
      pedagogy with a software-engineering-oriented Ada presentation
      order.  Packages are introduced early and emphasized heavily;
      chapters on abstract data types, unconstrained arrays, generics,
      recursion, and dynamic data structures appear later.  The last
      five chapters, combined with some language-independent algorithm
      theory, can serve as the basis of a CS2 course.  A diskette with
      all the fully-worked packages and examples (about 180) is
      included; the instructor's manual contains a diskette with
      project solutions.

      Savitch, W.J. and C.G. Petersen.
      Ada: an Introduction to the Art and Science of Programming.
      Benjamin/Cummings, 1992.
      This is a straightforward adaptation of the well-known Savitch
      Pascal books.  Ada is introduced in a Pascal-like order, with
      subtypes and packages introduced halfway through the book.  This
      is purely a CS1 book.  The final chapter covers dynamic data
      structures.  There is no coverage of unconstrained array types;
      generics are introduced at the halfway point to explain Text_IO,
      then dropped until the final chapter.  The authors intended this
      book to provide a painless transition to Ada for teachers of
      Pascal; one wishes they had taken advantage of the chance to
      show some of the interesting Ada concepts as well.  Program
      examples from the text are available on disk, but only as part
      of the instructor's manual; a solutions disk is available for a
      fee from the authors.

      Skansholm, J.
      Ada from the Beginning.
      Addison Wesley, 1988.
      This book was one of the first to use Ada with CS1-style
      pedagogy.  There are excellent sections on the idiosyncracies of
      interactive I/O (a problem in all languages), and a sufficient
      number of fully-worked examples to satisfy students.  Generics,
      linked lists and recursion are covered at the end; there is no
      tasking coverage, but one would not expect this at CS1-level.

      Volper, D., and M. Katz.
      Introduction to Programming Using Ada.
      Prentice-Hall, 1990.
      This book uses a heavily "spiraled" approach to Ada, and is
      designed for a 2-semester course, covering nearly all of Ada
      eventually.  There are lots of fully-coded examples, and good
      pedagogical sections on testing, coding style, etc.  If you like
      spiraling, you'll like this.  The down side is that you can't
      find all you need on a given subject in one place.  It's at the
      other end of the scale from the "Ada books" that follow the Ada
      Language Reference Manual (LRM) order.

      Group 2: Other Books Intended for Undergraduate Courses

      Ben-Ari, M.
      Principles of Concurrent and Distributed Programming.
      Prentice-Hall 1990.  (OS/concurrency)
      In my opinion, this is the best introduction to concurrency on
      the market.  Ada notation is used for everything, but the focus
      is on concurrency and not on Ada constructs per se.  I liked the
      CoPascal notation of the first edition better, but this book is
      still great.  A software disk is promised in the preface; I had
      to work quite hard to get it from the publisher, which finally
      had to express-ship it from England.  The software comes with a
      tiny Ada-ish interpreter, complete with Pascal source code,
      adapted from Wirth's Pascal/S via CoPascal.  There are also some
      real Ada programs, most of which I've tested and found correct
      and portable.

      Feldman, M.B.
      Data Structures with Ada.
      Prentice Hall, 1985 (now distributed by Addison-Wesley).
      (CS2/data structures)
      This book is a reasonable approximation to a modern CS2 book:
      "big O" analysis, linked lists, queues and stacks, graphs,
      trees, hash methods, and sorting, are all covered.  The Ada is a
      bit old-fashioned, especially the lack of generics; the book was
      published before compilers could handle generics.  The packages
      and other programs are available free from the author.  The book
      is currently under revision with Addison-Wesley and should
      appear in 1993.

      Fischer, C., and R. LeBlanc.
      Crafting a Compiler.
      Benjamin Cummings, 1988.  (compilers)
      This book uses Ada as its language of discourse and Ada/CS, a
      usefully large Ada subset, as the language being compiled.  If
      you can get the "plain Pascal" tool software by ftp from the
      authors, you'll have a good translator-writing toolset.  Skip
      the Turbo Pascal diskette version, which is missing too many
      pieces to be useful.  I've used the book since it came out with
      both undergrad and graduate compiler courses; it embodies a good
      blend of theory and "how it's really done" coding.  Students
      like it.  The authors have recently published a second version,
      which uses C as its coding language but retains Ada/CS as the
      language being compiled.

      Lomuto, N.
      Problem-Solving Methods with Examples in Ada.
      Prentice-Hall, 1987.  (algorithms)
      Inspired by Polya's classic How to Solve It, this book can make
      a nice addition to an Ada-oriented algorithms course.  It makes
      too many assumptions about students' programming background to
      use as a CS1 book, and doesn't teach enough Ada to be an "Ada
      book."  But it makes nice reading for students sophisticated
      enough to handle it.  I'd classify it as similar to Bentley's
      Programming Pearls.

      Miller, N.E. and C.G. Petersen.
      File Structures with Ada.
      Benjamin/Cummings, 1990.  (file structures)
      Designed for a straightforward ACM-curriculum file structures
      course, this book succeeds at what it does.  There are good
      discussions of ISAM and B-tree organizations.  The software can
      be purchased a low cost from the authors; it seems to
      approximate in Ada all those C-based file packages advertised in
      programmer-oriented trade publications.

      Schneider, G.M., and S.C. Bruell.
      Concepts in Data Structures and Software Development (with Ada
      Supplement by P. Texel).
      West, 1991.  (CS2/data structures)
      This work is not, strictly speaking, an Ada book; rather, it is
      a solid, language-independent approach to modern CS2.  The
      language of discourse in the book is a Pascal-like ADT language
      rather like Modula-2 in style; some examples are coded in legal
      Pascal.  The Ada supplement makes it usable in an Ada-based
      course, but the supplement is rather too terse (100 pages of
      large type) for my taste, and insufficiently well keyed to the
      book chapters.  The supplement's effectiveness would be greatly
      enhanced by full translations to Ada of a large number of the
      book's examples.

      Sebesta, R.W.
      Concepts of Programming Languages.
      Benjamin Cummings, 1989.  (comparative languages)
      If you've been around for a while, you might remember the late
      Mark Elson's 1975 book by the same title.  This is similar: a
      concept-by- concept presentation, with -- in each chapter --
      examples taken from several languages.  There is a nice
      impartial presentation of Ada along with the others.  I
      especially like the chapters on abstraction and exception
      handling.  The book covers -- comparatively, of course -- most
      of the lanuages you'd like to see, including C, Lisp, Smalltalk,
      etc., with nice historical chapters as well.  The book is
      readable; my students like it.  Our undergraduate and graduate
      courses both use it as a base text.

      Group 3: A Selection of Other Ada-Related Books

      Barnes, J.
      Programming in Ada.  (3rd edition)
      Addison Wesley, 1989.
      Barnes' work has been one of the most popular "Ada books."  Some
      students find it hard to see how the pieces fit together from
      Barnes' often fragmentary examples; it is difficult to find
      complete, fully- worked out, compilable programs.  A version is
      available with the entire Ada Language Reference Manual bound in
      as an appendix.

      Booch, G.
      Object-Oriented Design, with Applications.
      Benjamin Cummings, 1991.
      This is a good comparative introduction to the "object-oriented
      (OO)" concept.  The first half gives a balanced presentation of
      the issues in OO Design; the second half gives nontrivial
      examples from Ada, Smalltalk, C++, CLOS, and Object Pascal.  The
      author tries to sort out the difference between object-based
      (weak inheritance, like Ada) and object-oriented (like C++)
      languages.  My only real complaint is that Booch should have
      worked out at least some of his case studies using several
      different languages, to highlight the similarities and
      differences in the language structures.  As it is, each case
      study is done in only a single language.  The good news is that
      the book is remarkably free of the hyperbolic claims one
      sometimes finds in the OO literature.  I think this book could
      be used successfully in a second- level comparative languages
      course.

      Booch, G.
      Software Components with Ada.
      Benjamin Cummings, 1987.
      This work is an encyclopedic presentation of data structure
      packages from Booch's OOD point of view.  It is great for those
      who love taxonomies.  It's not for the faint-hearted, because
      the volume of material can be overwhelming.  It could serve as a
      text for an advanced data structures course, but it's thin in
      "big O" analysis and other algorithm-theory matters.  The book
      is keyed to the (purchasable) Booch Components.

      Booch, G.
      Software Engineering with Ada.  (2nd edition)
      Benjamin Cummings 1987.
      Another of the classical "Ada books."  Introduces Booch's OOD
      ideas.  Not for use to introduce Ada to novices, in my opinion;
      there are some nice fully-worked case studies but they begin too
      far into the book, after long sections on design, philosophy,
      and language elements.  The earlier chapters contain too much
      fragmentary code, a common flaw in books that follow the LRM
      order.

      Bryan, D.L., and G.O. Mendal.
      Exploring Ada, Volumes 1 and 2.
      Prentice-Hall, 1990 and 1992 respectively.
      This is an excellent study of some of the interesting nooks and
      crannies of Ada; it sometimes gets tricky and
      "language-lawyerly."  Volume 2 takes up tasking, generics,
      exceptions, derived types, scope and visibility; Volume 1 covers
      everything else.  The programs are short and narrowly focused on
      specific language issues.  If you like Bryan's "Dear Ada" column
      in Ada Letters, you'll like this book.  It is certainly not a
      book for beginners, but great fun for those who know Ada already
      and wish to explore.

      Burns, A.
      Concurrent Programming in Ada.
      Cambridge University Press, 1985.
      I used this book for years in my concurrency course.  It's
      roughly equivalent to Gehani's book, but its age is showing.
      Cambridge Press is not always easy to get books from, especially
      in the US.

      Cohen, N.
      Ada as a Second Language.
      McGraw Hill, 1986.
      This book is a quite comprehensive exploration of Ada which
      follows the LRM in its presentation order.  My graduate students
      like it because it is more detailed and complete than
      alternative texts.  It's an excellent book for students who know
      their languages and want to study all of Ada.  There are good
      discussions of "why's and wherefore's" and many long,
      fully-worked examples.

      Gauthier, M.
      Ada: Un Apprentissage (in French).
      Dunod, 1989.
      I found this an especially interesting, almost philosophical
      approach to Ada.  The first section presents Ada in the context
      of more general laguage principles: types, genericity,
      reusability.  The second section introduces testing and
      documentation concerns, as well as tasking; the third considers
      generics and variant records in the more general context of
      polymorphism.  For mature Ada students in the French-speaking
      world, and others who can follow technical French, this book can
      serve as a different slant on the conventional presentations of
      the language.  An English translation would be a real
      contribution to the Ada literature.

      Gehani, N.
      Ada: an Advanced Introduction (2nd edition).
      Prentice-Hall, 1989.
      I've always liked Gehani's literate writing style; he knows his
      languages and treats Ada in an interesting, mature, and balanced
      fashion.  This book comes with a diskette sealed in the back of
      the book, which is advantageous because the book has numerous
      nontrivial, fully- worked examples.

      Gehani, N.
      Ada: Concurrent Programming (2nd edition).
      Silicon Press, 1991.
      This is a less formal, more Ada-oriented presentation of
      concurrency than the Ben-Ari work.  I use both books in my
      concurrency course; its real strength is the large number of
      nontrivial, fully worked examples.  Gehani offers a nice
      critique of the tasking model from the point of view of an OS
      person.  The preface promises the availability of a software
      disk from the publisher.

      Nyberg, K.
      The Annotated Ada Reference Manual.  (2nd edition)
      Grebyn Corporation, 1991.
      This is the definitive work on Ada legalities, because it
      presents not only the full text of the LRM but also the official
      Ada Interpretations.  These commentaries, interleaved with the
      LRM text, have been approved and promulgated by the Ada Board
      and the various standards organizations, and are binding upon
      compiler developers.  I recommend this book as an essential
      volume in the library of every serious Ada enthusiast.

      Shumate, K.
      Understanding Ada.  (2nd edition)
      John Wiley, 1989.
      This would make a CS1 book if it included more overall pedagogy,
      independent of language constructs.  Otherwise it is a nice
      introduction to Ada in fairly gentle steps.  Lots of completely
      worked examples, right from the start.  Doesn't follow the LRM
      order, which is great.

      Watt, D.A., B.A. Wichmann, and W. Findlay.
      Ada Language and Methodology.
      Prentice-Hall, 1987.
      This work presents some interesting programming projects, and
      the coverage of design and testing--at the level of a first-year
      student--is quite good.  The first third of the book
      concentrates heavily on classical control and data structures,
      leaving exceptions and packages until the "programming in the
      large" material in the second third.  CS2 teachers will find too
      little concentration on algorithm analysis.  On the other hand,
      tasking and machine-dependent programming are covered.  Like the
      Shumate work, this book would make a suitable introduction to
      Ada for students with a semester or so of programming
      experience; it "jumps in" too quickly to satisfy the needs of
      neophytes and is not well-tailored to CS1 or CS2 needs.

21) Where can I get language translators?

      The AdaIC maintains a Products and Tools Database on its
      bulletin board (703/614-0215), and one of the categories is
      translators.  (The list of products should not be considered
      exhaustive; if you wish to suggest additions, please contact the
      AdaIC.)  Besides access to the database via the bulletin board,
      you can also call the AdaIC (800-AdaIC-11 or 703/685-1477) and
      ask for a customized search.

      In addition to all the usual caveats, however, it should also be
      noted that translation itself is a controversial issue.

      When a project makes the transition to Ada from some other
      language, one question that arises is whether to translate older
      code into Ada.  Among the immediate considerations are how much
      of the code can in fact be translated by a program intended for
      that purpose, versus how much will still require re-coding by
      hand.  And will the translated code will suffer a significant
      loss in speed of execution?  Further, a project must consider
      whether the translated code will reflect sound software
      engineering and be readily understandable and modifiable.  Or
      will it be merely "Fortranized Ada" or "Cobolized Ada", or the
      like, possibly retaining limitations present in the earlier
      code?  Portability is also a problem.

      The resolution of such issues will require an understanding of
      the earlier code, an appreciation of the similarities and
      differences between its language and Ada, and an evaluation of
      the translation program under consideration.

22) What is the status of the POSIX/Ada work?

      (from emery@mitre.org (dave emery))

      The IEEE approved IEEE Standard 1003.5-1992 in June 1992.  This
      is the Ada Binding to the facilities defined in ISO
      9945-1:1989/IEEE 1003.1-1990, the POSIX System Services.

      IEEE Standards Committee P1003.5 is now working on Ada bindings
      to IEEE draft standards 1003.4, Real-Time Extensions and
      1003.4a, Threads Extensions.  Current plans call for an IEEE
      ballot in October 1993, with IEEE approval in September 1995.
      For more information, contact the P1003.5 Chairman, Jim Lonjers
      (lonjers@vfl.paramax.com, 805/987-9457).

23) How can I get a copy of POSIX/Ada?  Is it available via FTP?

      (from emery@mitre.org (dave emery))

      You can buy a copy of the standard from the IEEE.  The order
      number is "SH 15354", and the mailing address is "IEEE Service
      Center, 445 Hoes Lane, Piscataway, NJ 08855-1331".  They will
      accept credit-card orders at 1-800/678-4333.  The cost is $62.50
      + $5.00 s/h ($43.75 + $4.00 s/h for IEEE Members).

      Current IEEE policy prohibits electronic distribution of IEEE
      standards.  Proceeds from the sale of IEEE standards help
      support the IEEE standards program.

      The POSIX P1003.5 committee is trying to work out an arrangement
      with the IEEE to make the POSIX/Ada package specifications
      available for distribution via email and anonymous FTP.

24) Where can I get Ada benchmark programs?

      In addition to the information below, you may also wish to look
      at the AdaIC flyer "How to Obtain Benchmark Performance Test
      Suites and Results", flyer V15, file benchmrk.hlp.<date> on the
      AJPO Host (ajpo.sei.cmu.edu).  For more on the AdaIC and
      downloading files, see questions 14), 15), and 25).

      (from pd@SEI.CMU.EDU (Patrick Donohoe))

      The Ada Evaluation System:

      The Ada Evaluation System (AES) may be obtained from the British
      Standards Institute at the following address:

           Software Product Services
           Software Engineering Department
           BSIQA
           P.O. Box 375
           Milton Keynes MK14 6LL
           United Kingdom
           Tel: 0908 220908
           UUCP: sed@bsiqa.uucp
           (Internet: bsiqa!sed@uunet.uu.net)

      As of February 1993, the current version is the DIY-MAPSE-01
      version.  It is available at a cost of 3,000 pounds sterling.
      BSI also offers a validation service at a cost of 24,000 pounds
      sterling.  Principal documents are a User's Manual, a Reference
      Manual, and a Test Description Document.

      The Ada Evaluation System (AES) will be merged with the Ada
      Compiler Evaluation Capability (ACEC) under a joint agreement
      between the Ministry of Defence of the United Kingdom and the
      Department of Defense of the United States that was signed in
      June of 1991.  The merged product will be released as version
      4.0 of the ACEC; as of March 1993, the expected release time
      was the third or fourth quarter of 1993.

      The Ada Compiler Evaluation Capability:

      The Ada Compiler Evaluation Capability (ACEC) may be obtained
      from:

           Data and Analysis Center for Software (DACS)
           P.O. Box 120
           Utica, NY 13503
           Tel: 315/734-3696
           Internet: dacs-info@kaman.com

      As of February 1993, the current release of the ACEC is 3.0.
      There are three documents: the User's Guide, the Reader's Guide,
      and the Version Description Document.  The total cost for the
      software and documentation is 100 US dollars.  (Release 3.0 of
      the ACEC is not the merged AES-ACEC product referred to above.)

      Hartstone Benchmarks:

      Electronic mail requests for Hartstone should be sent to the
      following Internet address:

           hartstone-info@sei.cmu.edu

      The reply message will contain full details of how to obtain
      source code and documentation by various means, including
      anonymous ftp.  There is no charge for the Hartstone source
      code.

      For people without Internet access, the address to send requests
      to is:

           REST Transition Services
           Software Engineering Institute
           Carnegie Mellon University
           Pittsburgh, PA 15213-3890
           Phone: 412/268-7787

      Hartstone source code may also be retrieved from the PIWG
      bulletin board.  (See below.)

      The PIWG Benchmarks:

      The ACM Performance Issues Working Group (PIWG) benchmarks may
      be obtained in one of three ways:

           1.  Via anonymous ftp from the ajpo.sei.cmu.edu machine.
               Users should issue the command "ftp ajpo.sei.cmu.edu"
               and log in using the word "anonymous" as the login name
               and an identifying string (e.g., the user's e-mail
               address) as password.  Change directory ("cd" command)
               to the "public/piwg/piwg_11_92" directory and use the
               ftp file-transfer commands to retrieve the files.  The
               README file contains information about using the
               benchmarks.

           2.  Via the PIWG bulletin board.
               Ideally, users should access this from a PC (rather
               than a dumb terminal) using a modem capable of sending
               and receiving at 1200 baud or higher.  The number of
               the bulletin board is 412/268-7020.  Once connected to
               the bulletin board, users will be able to navigate
               their way around the system using simple menus that the
               system provides.  The point of contact for this service
               is Gene Rindels, 412/268-6728.

           3.  Via a written request or telephone request to the
               following service:

                   PIWG Distribution
                   Software Engineering Institute
                   Carnegie Mellon University
                   Pittsburgh, PA 15213-3890
                   Tel: 412/268-7787

               As of February 1993, the current release of the PIWG
               suite is the one dated 11/92.  There is no charge for
               the PIWG benchmarks.  Documentation for the PIWG
               benchmarks consists principally of the READ.ME file
               distributed with the suite and comments in the
               individual test programs and command files.  There is
               also additional information about the PIWG suite in the
               Winter 1990 special edition of Ada Letters (Vol. X,
               No. 3, special edition on Ada Performance Issues).

25) The AJPO host has a lot of Ada information files available for
    downloading by anonymous FTP.  But I don't have FTP service on the
    Internet host where I have an account.  Is there any way I can get
    those files?

      The AJPO host, ajpo.sei.cmu.edu, will provide mail-server
      capabilities on an experimental basis.  The available services
      provided by this automatic mail server are: services, Re, help,
      info, man, directory, and file-request.  To request a service,
      send e-mail to "ftpmail@ajpo.sei.cmu.edu" and place its name in
      the Subject line of the mail message, followed by any needed
      parameters.  The mail server will respond to your request with
      either the information you requested or an error message.

      The following are common examples on how to request services
      from the AJPO host mail server:

      ----------------------------------------------------------------------
      1) To get "help" --

      To: ftpmail@ajpo.sei.cmu.edu
      Subject: help

      ----------------------------------------------------------------------

      2) To get "man" pages of a particular service, such as "directory" --

      To: ftpmail@ajpo.sei.cmu.edu
      Subject: man directory

      This service takes as a parameter the name of a service, and
      returns a manual page on that service.

      ----------------------------------------------------------------------

      3) To get a "directory" listing of the AJPO anonymous ftp area
      (/public) --

      To: ftpmail@ajpo.sei.cmu.edu
      Subject: directory

      The "directory" service takes as an optional parameter a file or
      directory name, and returns the results of an "ls -l" on that
      parameter.  For example, to get a listing of the
      /public/ada-info directory you would submit a message with the
      Subject of:

      Subject: directory ada-info

      The filename pattern may include wildcards as defined by the C
      shell.  For example, to get a listing of the /public directories
      beginning with "p" you would submit a message with the Subject
      of:

      Subject: directory p*

      ----------------------------------------------------------------------

      4) Use "file-request" to get /public/README file --

      To: ftpmail@ajpo.sei.cmu.edu
      Subject: file-request README

      The "file-request" service takes as an optional parameter a
      filename, and will return the contents of the file.  Text files
      are returned verbatim, while binary files are encoded via the
      Unix "uuencode" command.  Large files (greater than 1000 lines
      long) will be split into multiple mail messages.  For example,
      to get the file "README" in the /public/ada-info directory you
      would submit a message with the Subject of:

      Subject: file-request ada-info/README

      ----------------------------------------------------------------------

      Below is a sample response to a "help" request.

      From: FTP Mail Server <ftpmail@ajpo.sei.cmu.edu>
      Message-Id: <9301141628.AA26473@ajpo.sei.cmu.edu>
      To: adainfo@ajpo.sei.cmu.edu
      Subject: Re: help
      In-Reply-To: <9301141628.AA26462@ajpo.sei.cmu.edu>
      Content-Type: text/plain; charset=us-ascii

      You have sent electronic mail to the Ada Joint Programs Office
      automatic mail server.  This server is based on the
      ServiceMail(tm) Tookit from Enterprise Integration Technologies.

      In general, you may request a service by placing its name in the
      Subject line of a mail message, followed by any needed
      parameters.  The mail server will respond to your request with
      either the information you requested or an error message.

      Here is a brief description of the available services:

      services:       This service returns a list of the available
                      services.

      Re:             This service discards all messages with "Re:" in
                      the subject line.  This is to prevent mail
                      loops.

      help:           This service returns this help message.

      info:           This service returns this help message.

      man:            This service takes as a parameter the name of a
                      service, and returns a manual page on that
                      service.

      directory:      This service takes as an optional parameter a
                      file or directory name, and returns the results
                      of an "ls -l" on that parameter.  The root of
                      the file structure is the AJPO anonymous FTP
                      area.

      file-request:   This service takes as an optional parameter a
                      file name, and will return the contents of the
                      file.  The root of the file structure is the
                      AJPO anonymous FTP area.  Text files are
                      returned verbatim, while binary files are
                      encoded via the Unix "uuencode" command.  Large
                      files (greater than 1000 lines long) will be
                      split into multiple mail messages.

      Try 'man <service>' to get more information on a particular
      service.  Please report bugs and other problems to
      ftpmail-request@ajpo.sei.cmu.edu.

====================================end=======================================





^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~1993-03-25 23:02 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
1993-03-25 23:02 comp.lang.ada FAQ 2/2 Ada Info. Clearinghouse

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox