Janus TCP/IP Base IFDIAL installation

Please refer to the Sirius Mods Installation Guide for details about installing Janus. If you are using the IFDIAL support provided by Janus, refer back to this section after completing the basic installation. For installation of the mainframe components, see "Janus, the Sirius Mods, and UL/SPF". This appendix is about installing Janus TCP/IP Base IFDIAL workstation components.

Unix-style workstations

1. Install the Sirius Mods.

   See the Sirius Mods Installation Guide for details. The Online in which Janus will run must use a load module containing the Sirius Mods.

2. Transfer IFDIAL Library to Unix workstations.

   Log on to the target workstation, then create the target directory with the mkdir command. The recommended target directory is "/usr/janus", so to create the directory, enter:

   mkdir /usr/janus

   Make the newly created directory the current directory:

   cd /usr/janus

   Download the appropriate "tar" file from the mainframe. The appropriate file depends on the target workstation. Under MVS the tar files are members of SIRIUS.LIB. Under CMS, they are files on the Sirius Mods installation disk with filetype TAR. The appropriate tar files for the supported target workstations are:

   Target workstation	File/member name
   SPARC (Sun) workstation	SPARC
   RS/6000 running AIX	RS6000
   All others	UNIX

   The following stream shows how the RS/6000 tar file is downloaded from a mainframe running IBM's TCP/IP product under MVS (user input is highlighted):

   # 'ftp ibmtcp' Connected to ibmtcp. 220-FTPSERVE IBM MVS V2R2 at IBMTCP, 12:44:31 on 09/13/93 220 Connection will close if idle for more than 5 minutes. Name (ibmtcp:root): 'renn' 331 Send password please. Password:'xxxxxxx' 230 RENN is logged on. ftp> 'binary' 200 Representation type is IMAGE. ftp> 'get sirius.lib(rs6000) rs6000.tar' 200 Port request OK. 125 Sending data set JANUS.V100.LIB(RS6000) FIXrecfm 80 250 Transfer completed successfully. 102400 bytes received in 1.676 seconds (59.66 Kbytes/s) ftp> 'quit' 221 Quit command received. Goodbye.

   The following stream shows how the RS/6000 tar file is downloaded from a mainframe running Interlink's TCP/IP product (user input is highlighted):

   # 'ftp snstcp' Connected to snstcp. 220 SNSTCP.SIRIUS.COM — FTP Server, Enter command or HELP Name (snstcp:root): 'stimpy' 331 Enter PASS command Password:'xxxxxxx' 230 Logged in - Host 204.0.0.4 User STIMPY Sess# 3 ftp> 'binary' 200 OK, Ready ftp> 'get sirius.lib(rs6000) rs6000.tar' 200 OK, Ready 150-Dataset open with attributes: Type I N Stru F Mode S Path JANUS.V100.LIB(RS6000) Volser MVSUSR Unit SYSALLDA Dsorg PO Recfm FB Lrecl 80 Blksize 3120 150 226-Transfer complete Sess# 3 102400 bytes sent in 2.22 seconds (46126 bytes/s) Path JANUS.V100.LIB(RS6000) User STIMPY Data bytes sent 102400 Disk tracks read 4 226 102400 bytes received in 1.851 seconds (54.03 Kbytes/s) ftp> 'quit' 221 Session terminated

   Note in the preceding examples that the file transfer is done in binary mode.

   After the appropriate tar file has been downloaded to the workstation, the individual files in the tar file must be extracted. This can be done with the following command:

   tar -xvf rs6000.tar

3. Recompile Janus IFDIAL Library on workstation

   If the workstation does not have a platform-specific tar file, it is necessary to rebuild the object version of the Janus IFDIAL Library and the executable version of the workstation utilities. The following commands will accomplish this:

   make ifdial.o make batch2 make m204

This completes the installation of the Janus IFDIAL Library on the workstation. The Janus IFDIAL Library must be transferred to each workstation that is to have access to its services.

Windows-based workstations

1. Install the Sirius Mods.

   See the Sirius Mods Installation Guide for details. The Online in which Janus will run must use a load module containing the Sirius Mods.

2. Transfer IFDIAL Library to the Windows workstation.

   Log on to the target workstation, then create the target directory with the mkdir command. The recommended target directory is "\usr\janus", so to create the directory, enter:

   mkdir \usr\janus

   Make the newly created directory the current directory:

   cd \usr\janus

   Download the appropriate distribution file from the mainframe. Under MVS, the distribution file is SIRIUS.LIB(WIN). Under CMS, the file is WIN TAR.

   The Windows distribution file is a self-extracting executable.

   The following stream shows how the distribution file is downloaded from a mainframe running IBM's TCP/IP product (user input is highlighted) under MVS:

   # 'ftp ibmtcp' Connected to ibmtcp. 220-FTPSERVE IBM MVS V2R2 at IBMTCP, 12:44:31 on 09/13/93 220 Connection will close if idle for more than 5 minutes. Name (ibmtcp:root): 'renn' 331 Send password please. Password:'xxxxxxx' 230 RENN is logged on. ftp> 'binary' 200 Representation type is IMAGE. ftp> 'get sirius.lib(win) setup_janus_ifdial_win.exe' 200 Port request OK. 125 Sending data set JANUS.V100.LIB(WIN) FIXrecfm 80 250 Transfer completed successfully. 88967 bytes received in 1.676 seconds (53.08 Kbytes/s) ftp> 'quit' 221 Quit command received. Goodbye.

   Note that the file transfer is done in binary mode.

   After the distribution file has been downloaded to the workstation, the individual files in it must be extracted. This can be done with the following command:

   setup_janus_ifdial_win.exe

   This will extract all the files into the current directory. If you want to install them in other than the download directory, simply move the distribution file there before running it. After extracting the files, the distribution file itself may be deleted.

3. Recompile Janus IFDIAL Library on workstation

   The distribution file contains already-built binaries for the Janus IFDIAL Library (ifdial.lib, ifdial.dll) and the executable versions of the workstation utilities. To rebuild them (or to build debug versions), see the readme.txt file; if you run the dist_bld.bat file with no parameters, it will give a usage message. In particular, to rebuild all binaries with debug information:

   dist_bld all debug

This completes the installation of the Janus IFDIAL Library on the workstation. The Janus IFDIAL Library must be transferred to each workstation that is to have access to its services.