Janus TCP/IP Base IFDIAL installation: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Created page with "<!-- Janus TCP/IP Base IFDIAL installation --> Please refer to the [http://sirius-software.com/maint/download/siri.pdf Sirius Mods Installation Guide] for details about insta...")
 
m (link repair)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- Janus TCP/IP Base IFDIAL installation -->
Please refer to the <var class="book">[http://m204wiki.rocketsoftware.com/images/c/c9/SiriNew.pdf Sirius Mods Installation Guide]</var> for details
Please refer to the [http://sirius-software.com/maint/download/siri.pdf Sirius Mods Installation Guide] for details
about installing Janus.
about installing Janus.
If you are using the IFDIAL support provided by
If you are using the [[Janus IFDIAL Library|IFDIAL support]] provided by
Janus, refer back to this section after completing the basic installation.
Janus, refer back to this section after completing the basic installation.
For installation of the mainframe components, see
For installation of the mainframe components, see
[[Janus TCP Base#Janus, the Sirius Mods, and UL/SPF|"Janus, the Sirius Mods, and UL/SPF"]].
[[Janus TCP/IP Base#Janus, the Sirius Mods, and UL/SPF|"Janus, the Sirius Mods, and UL/SPF"]].
This appendix is about installing <var class="product">Janus TCP/IP Base</var> IFDIAL workstation components.
This appendix is about installing <var class="product">Janus TCP/IP Base</var> <var>IFDIAL</var> workstation components.
The first section is for Unix-style workstations; the second is for Windows-based workstations.
 
__TOC__
   
   
==Unix-style workstations==
==Unix-style workstations==
<ol>
<ol>
<li>Install the <var class="product">Sirius Mods</var>.
<li>Install the <var class="product">Sirius Mods</var>.
<p>
See the <var class="product">Sirius Mods Installation Guide</var> for details.
See the <var class="book">Sirius Mods Installation Guide</var> for details.
The Online in which Janus will run must use a load module containing the <var class="product">Sirius Mods</var>.
The Online in which Janus will run must use a load module containing the <var class="product">Sirius Mods</var>. </p>
 
<li>Transfer <var class="product">IFDIAL Library</var> to Unix workstations.
<li>Transfer <var class="product">IFDIAL Library</var> to Unix workstations.
<p>
Log on to the target workstation, then
Log on to the target workstation, then create the target directory with the '''mkdir''' command.
create the target directory with the '''mkdir''' command.
The recommended target directory is "/usr/janus", so to create the directory, enter: </p>
The recommended target directory is "/usr/janus", so to create the directory, enter:
<p class="code">mkdir /usr/janus
<p class="code">mkdir /usr/janus
</p>
</p>
Line 31: Line 29:
The appropriate file depends on the target workstation.
The appropriate file depends on the target workstation.
Under MVS the tar files are members of SIRIUS.LIB.
Under MVS the tar files are members of SIRIUS.LIB.
Under CMS, they are files on the <var class="product">Sirius Mods</var> installation disk with filetypes of TAR.
Under CMS, they are files on the <var class="product">Sirius Mods</var> installation disk with filetype <code>TAR</code>.
The appropriate tar files for the supported target workstations are:
The appropriate tar files for the supported target workstations are:
<table>
<table>
Line 68: Line 66:
   
   
The following stream shows how the RS/6000 tar file is
The following stream shows how the RS/6000 tar file is
downloaded from a mainframe running Interlink's TCP/IP product (user
downloaded from a mainframe running Interlink's TCP/IP product (user input is highlighted):
input is highlighted):
<p class="code"># <b>'ftp snstcp'</b>
<p class="code"># <b>'ftp snstcp'<b>
Connected to snstcp.
Connected to snstcp.
220 SNSTCP.SIRIUS.COM -- FTP Server, Enter command or HELP
220 SNSTCP.SIRIUS.COM -- FTP Server, Enter command or HELP
Line 95: Line 92:
</p>
</p>
Note in the preceding examples that the file transfer is done in binary mode.
Note in the preceding examples that the file transfer is done in binary mode.
<p>
After the appropriate tar file has been downloaded to the
After the appropriate tar file has been downloaded to the
workstation, the individual files in the tar file must be extracted.
workstation, the individual files in the tar file must be extracted.
This can be done with the following command:
This can be done with the following command: </p>
<p class="code">tar -xvf rs6000.tar
<p class="code">tar -xvf rs6000.tar
</p>
</p>
   
   
<li>Recompile <var class="product">Janus IFDIAL Library</var> on workstation
<li>Recompile <var class="product">Janus IFDIAL Library</var> on workstation
<p>
If the workstation does not have a platform specific tar
If the workstation does not have a platform-specific tar
file, it is necessary to rebuild the object version of the <var class="product">Janus IFDIAL Library</var>
file, it is necessary to rebuild the object version of the <var class="product">Janus IFDIAL Library</var>
and the executable version of the workstation utilities.
and the executable version of the workstation utilities.
The following commands will accomplish this:
The following commands will accomplish this: </p>
<p class="code">make ifdial.o
<p class="code">make ifdial.o
make batch2
make batch2
Line 121: Line 118:
<ol>
<ol>
<li>Install the <var class="product">Sirius Mods</var>.
<li>Install the <var class="product">Sirius Mods</var>.
<p>
See the <var class="product">Sirius Mods Installation Guide</var> for details.
See the <var class="book">Sirius Mods Installation Guide</var> for details.
The Online in which Janus will run must use a
The Online in which Janus will run must use a
load module containing the <var class="product">Sirius Mods</var>.
load module containing the <var class="product">Sirius Mods</var>.</p>
 
<li>Transfer <var class="product">IFDIAL Library</var> to the Windows workstation.
<li>Transfer <var class="product">IFDIAL Library</var> to the Windows workstation.
<p>
Log on to the target workstation, then
Log on to the target workstation, then
create the target directory with the '''mkdir''' command.
create the target directory with the '''mkdir''' command.
The recommended target directory is "\usr\janus", so to create the
The recommended target directory is "\usr\janus", so to create the
directory, enter:
directory, enter: </p>
<p class="code">mkdir \usr\janus
<p class="code">mkdir \usr\janus
</p>
</p>
Line 177: Line 175:
   
   
<li>Recompile <var class="product">Janus IFDIAL Library</var> on workstation
<li>Recompile <var class="product">Janus IFDIAL Library</var> on workstation
<p>
The distribution file contains already-built binaries for the
The distribution file contains already-built binaries for the
<var class="product">Janus IFDIAL Library</var> (ifdial.lib, ifdial.dll) and the executable
<var class="product">Janus IFDIAL Library</var> (<code>ifdial.lib</code>, <code>ifdial.dll</code>) and the executable
versions of the workstation utilities.
versions of the workstation utilities.
To rebuild them (or to build debug versions), see the
To rebuild them (or to build debug versions), see the <code>readme.txt</code> file; if you run the <code>dist_bld.bat</code> file with no parameters, it will give a usage message.
readme.txt file; if you run the dist_bld.bat file with no
In particular, to rebuild all binaries with debug information: </p>
parameters, it will give a usage message.
<p class="code">dist_bld all debug
In particular, to rebuild all binaries with debug information:
<p class="code"> dist_bld all debug
</p>
</p>
</ol>
</ol>

Latest revision as of 17:27, 4 December 2014

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.