Janus TCP/IP Base IFDIAL installation: Difference between revisions
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...") |
mNo edit summary |
||
| Line 2: | Line 2: | ||
Please refer to the [http://sirius-software.com/maint/download/siri.pdf Sirius Mods Installation Guide] for details | Please refer to the <i>[http://sirius-software.com/maint/download/siri.pdf Sirius Mods Installation Guide]</i> for details | ||
about installing Janus. | about installing Janus. | ||
If you are using the IFDIAL support provided by | If you are using the <var>IFDIAL</var> 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. | The first section is for Unix-style workstations; the second is for Windows-based workstations. | ||
| Line 14: | Line 14: | ||
<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="product">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 31: | ||
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 | 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 68: | ||
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 94: | ||
</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 120: | ||
<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="product">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 177: | ||
<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> | ||
Revision as of 19:26, 16 March 2012
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. The first section is for Unix-style workstations; the second is for Windows-based workstations.
Unix-style workstations
- 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.
- 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
- 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
- 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.
- 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.
- 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 thereadme.txtfile; if you run thedist_bld.batfile 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.