Newsgroups: bit.listserv.ibmtcp-l
Date:         Mon, 13 Apr 1992 04:07:00 PDT
From:         310 Denis DeLaRoca 825-4580 <CSP1DWD@UCLAMVS.BITNET>
Subject:      UCLA Sockets (for OS/MVS) Distribution

I am making available my Sockets implementation and suite of tcp/ip
applications via 'anonymous' FTP at host acp.oac.ucla.edu. I apologize
for the delay as some folks have been interested in the software for
some time but the continued lack of an 'anonymous' FTP facility in
our mainframe has hampered distribution for a long time... also, the
FTP server mentioned above is very antique and doesn't understand
things like PDS libraries, thus the distribution is made up entirely
of sequential datasets, some in NETDATA format from which PDS source
libraries may be extracted. If the code proves useful and of interest
maybe somebody on netland could offer a more modern and convenient FTP
server to host the distribution. The README.FIRST file is included
below.

-- Denis DeLaRoca  <delaroca@oac.ucla.edu>
   UCLA Office of Academic Computing
   5628 MSA C0012, Los Angeles, Ca 90024
   Tel: 213-478-8916, fax: 213-206-7025

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

                                                          April 12 '92


         CSOCK - A Unix Sockets Implementation for IBM'S FAL/MVS
         -------------------------------------------------------

The UCLA Sockets package (for OS/MVS) has evolved over the last two
years, it was begun at a time when IBM's own C Sockets interface was
awfully bulky to use and lacked esential functionality in many areas.
With the re- lease of IBM's v2 of their TCPIP software this particular
area has seen tremendous improvement, yet a lot of my code continues to
have relevance as witness the suite of applications included in the
package. The code is work in progress and does continue to evolve,
hopefully it will be of use to people... I would most welcome res-
ponses as well as fixes and contributions.

The salient features of the package are,

- A VMCF-based implementation of Sockets for C370 with raw-ip,
  udp and tcp socket support and assorted extensions, not as
  modern an implementation as that of IBM's newly released IUCV
  Sockets interface but still notable in some of its features
  and extensions.

- A complete port of the Berkeley Domain Name Resolver routines.

- Clients for DAYTIME, GMTTIME, FINGER, WHOIS, REXEC, RSH,
  RLOGIN and TELNET. The telnet client counts amongst its
  salient features support for vt100 terminal emulation, a
  very popular requirement nowadays for users stuck with
  3270 terminals and needing to interoperate with telnet
  hosts requiring vt100 terminal support.

- A port of the ISI Domain Information Groper - DIG, a very
  useful and indispensable tool to query DNS servers.

- An REXEC server implementation for MVS/TSO which works pretty
  much like its Unix sibling... the only limitation being that
  no more than one rexec transaction per userid is allowed at a
  time due to the fact that TSO doesn't allow multiple logons.

- A C370 Multitasking Kernel (pseudo processes -- co-routines --
  with synchronizing primitives) to aid development of tcp/ip
  server applications.

- An implementation of the Unix tcp/ip superserver INETD with
  supplied servers for the "trivial" protocols ECHO, DISCARD,
  CHARGEN, TIME and DAYTIME for tcp/udp. A simple but useful
  WHOIS server is included as well... soon a FINGER server will be
  added too. This INETD platform makes adding additional servers
  extremely easy.

- Measurement utilities TTCP and TVMCF to test tcp/udp/vmcf
  throughput performance.

- Maintenance tools for pinging and traceroute. The supplied
  XPING utility is superior to the IBM supplied ping command
  and features some rather unusual features such as pinging
  of blocks of addresses. The suplied XROUTE is an enhanced in-
  plementation of the popular Van Jacobsen TRACEROUTE utility.

- Facilities to build NETSTAT utilities. Both an interface to
  the TCPIP monitor/query function and a full C370 mapping of
  IBM's NETSTAT data structures is provided to support develop-
  ment of NETSTAT utilities.


These are the files making out the current release. On some distri-
bution sites the PDS libraries below are supplied as single files
in NETDATA format.

sys8.csock.alib.asm      - ASM source library
   (dsorg=PO,recfm=FB,lrecl=80,blksize=3120)
   ATPUT       ATRAN       ATTMP       AVMCF       AXA24       UNCSTK

sys8.csock.dig.c         - ISI Domain Information Groper
   (dsorg=PO,recfm=VB,lrecl=259,blksize=6160)
   DIG         GETHBYNA    HERROR      INCLUDE     LIST        OPTIONS
   QTIME       README      RES#COMP    RES#DEBU    RES#INIT    RES#MKQU
   RES#QURY    RES#SEND    SETHENT     SETHENT@    SHELL       SUBR

sys8.csock.dig.h         - ISI DIG header include files
   (dsorg=PO,recfm=VB,lrecl=259,blksize=6160)
   HFILES      PARAM       PFLAG       QTIME       RES         SUBR

sys8.csock.document      - some documents and samples
   (dsorg=PO,recfm=VBA,lrecl=84,blksize=6160)
   DIG         PACKET      RELEASE     REXEC       TRACE       TR26
   TTCP        UPGRADE1    UPGRADE2    UPGRADE3    XPING       XROUTE
   XTELNET

sys8.csock.dot.env       - sample "environment" definitions
   (dsorg=PS,recfm=VB,lrecl=255,blksize=6160)

sys8.csock.dot.netrc     - sample "autologin" file for rexec client
   (dsorg=PS,recfm=VB,lrecl=255,blksize=6160)

sys8.csock.include       - C Sockets header files
   (dsorg=PO,recfm=VB,lrecl=259,blksize=6160)
   BSDTIME     CSOCK       ERRNO       IP          IP@ICMP     MBUF
   NAMESER     NETDB       NETSTAT     PARAM       PROC        RESOLV
   STRINGS     TCPERRNO    TELNET      TTY         TYPES       VLT
   VMCF

sys8.csock.inclu80       - updates to IBM header files
   (dsorg=PO,recfm=FB,lrecl=80,blksize=3120)
   MANIDIFF    MANIFEST    STDDIFF     STDIO

sys8.csock.plib.c        - C370 source library
   (dsorg=PO,recfm=VB,lrecl=259,blksize=6160)
   CSH         CSOCK       DAYTIME     FINGER      GETENV      GETOPT
   GMTTIME     INETD       KERNEL      MELVYL      PSNAP       REXEC
   REXECD      RLOGIN      RSH         SDEBUG      TCHARD      TDAYTD
   TDISCD      TECHOD      TESTKER     TESTQUER    TESTSTK     TRANTAB
   TTCP        TTIMED      TVMCF       VECHO       WHOIS       WHOISD
   XECHO       XPING       XROUTE      XTELNET

sys8.csock.readme.first  - bill of goods
   (dsorg=PS,recfm=VB,lrecl=255,blksize=6160)

sys8.csock.res.c         - Berkeley Name Resolver source library
   (dsorg=PO,recfm=VB,lrecl=259,blksize=6160)
   DOMAIN      GETHBYNA    GETNBYAD    GETNBYNA    GETNENT     HERROR
   NSQUERY     NSTEST      PERROR      RES#COMP    RES#DEBU    RES#INIT
   RES#MKQU    RES#QURY    RES#SEND    SETHENT     STRCSCMP

sys8.csock.resolv.alias  - sample Resolver configuration file
   (dsorg=PS,recfm=FB,lrecl=80,blksize=6400)

sys8.csock.resolv.conf   -       "        "        "
   (dsorg=PS,recfm=FB,lrecl=80,blksize=6400)

sys8.csock.resolv.host   -       "        "        "
   (dsorg=PS,recfm=VB,lrecl=256,blksize=6233)

sys8.csock.resolv.net    -       "        "        "
   (dsorg=PS,recfm=VB,lrecl=256,blksize=6233)

sys8.csock.vltmac        - ASM macro library for VTF application
   (dsorg=PO,recfm=FB,lrecl=80,blksize=6160)
   VCALL       VLTATTN     VLTCLOS     VLTCONT     VLTGET      VLTKNT
   VLTOPEN     VLTOPTS     VLTPARM     VLTPRG      VLTPUT      VLTRTCD
   VLTVQE

sys8.csock.vltsrc        - VTF application source library
   (dsorg=PO,recfm=FB,lrecl=80,blksize=6160)
   APPLALOC    EXEND       EXENTER     EXRETURN    FDBK        IFWAIT
   LCPOST      LPARM       LT          MEQ         QQCALL      QQEND
   QQENTRY     QQLOG       QQMAP       QQMAPX      QQPOST      QQREMEM
   QQRETURN    QQROUTIN    QQSECT      QQSIGNAL    QQSORTM     QQSORTT
   QQSTACKS    QQTOC       QQTRUNC     QQWAIT      QQWAITCK    QQWORKS
   README      TESTSPEC    TMCALL      VLANALER    VLATTN      VLBIND
   VLBLDRPL    VLCLOSE     VLCNTRL     VLCOMMON    VLCONS      VLCTRLOP
   VLDEQ       VLDIRECT    VLDRPL      VLDSA       VLDSECTS    VLEXITS
   VLGEN       VLGET       VLGETAP     VLKEYBD     VLMAP       VLNOGEN
   VLOPEN      VLOPNSEC    VLOUTPUT    VLPUT       VLRECL      VLREFUSE
   VLREQSES    VLRESET     VLSETLOG    VLSNDL      VLSNDRSP    VLSUBS
   VLT         VLTHCOM     VLTLOG      VLTRMSES    VLTTABS     VLVTCLOS
   VLVTOPEN    XTITLE

sys8.csock.whois         - sample Whois Server database
   (dsorg=PS,recfm=VB,lrecl=255,blksize=6160)

sys8.csock.whois2        - sample Whois Server database
   (dsorg=PS,recfm=VB,lrecl=255,blksize=6160)


For an introduction and basic installation suggestions look at the
RELEASE and various UPGRADE notes in sys8.csock.document!


-- Denis DeLaRoca  <delaroca@oac.ucla.edu>
   UCLA Office of Academic Computing
   5628 MSA C0012, Los Angeles, Ca 90024
   Tel: 213-478-8916, fax: 213-206-7025
Comments: Gated by NETNEWS@AUVM.AMERICAN.EDU