Template:Janus overview: Difference between revisions
Jump to navigation
Jump to search
m (link repair) |
|||
| (13 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
==The Janus family== | ==The Janus family== | ||
A site that has a Janus product will probably have one or more of the other products in the Janus family, though no others are required. The Janus products are: | A site that has a Janus product will probably have one or more of the other products in the Janus family, though no others are required. The Janus products are: | ||
< | <table> | ||
< | <tr><th><var class="product">[[Janus TCP/IP Base]]</var></th> | ||
</ | <td>Provides a direct connection between <var class="product">Model 204</var> and a TCP/IP network. The Janus IFDIAL Library is a no-cost C-callable API that operates in conjunction with <var class="product">Janus TCP/IP Base</var> to provide access to <var class="product">Model 204</var> from a wide variety of platforms. | ||
< | </td></tr> | ||
</ | |||
< | <tr><th><var class="product">[[Janus Web Server]]</var></th> | ||
< | <td>Provides access to <var class="product">Model 204</var> data and objects to client browsers via the World Wide Web. | ||
< | </td></tr> | ||
<tr><th><var class="product">[[Janus Network Security]]</var></th> | |||
</ | <td>Supports the Secure Sockets Layer (SSL) protocol, providing secure communications for users of Janus products. | ||
</td></tr> | |||
<tr><th><var class="product">[[Janus Sockets]]</var></th> | |||
<td>Provides HTTP socket-level connectivity between <var class="product">Model 204</var> and any software package or service that provides a sockets interface. | |||
</td></tr> | |||
< | <tr><th nowrap><var class="product">[[Media:JsdsrNew.pdf|Janus Specialty Data Store]]</var></th> | ||
</ | <td>Enables <var class="product">Model 204</var> to operate as a Sybase/Microsoft SQL Server, principally for the Sybase OmniConnect feature of Adaptive Server. Features include optimized translation of SQL into <var class="product">[[SOUL]]</var> and cataloging tools to map unchanged <var class="product">Model 204</var> files onto normalized. | ||
</td></tr> | |||
< | <tr><th><var class="product">[[Media:JoclrNew.pdf|Janus Open Client]]</var></th> | ||
</ | <td>Enables your <var class="product">Model 204</var> <var class="product">[[SOUL]]</var> applications to invoke Sybase/Microsoft Remote Procedure Calls (RPCs) or language requests (for example, SQL) to one or more Sybase or Microsoft Open Servers and/or SQL servers. | ||
</td></tr> | |||
</ | <tr><th><var class="product">[[Media:JosrvrNew.pdf|Janus Open Server]]</var></th> | ||
<td>Enables you to create <var class="product">Model 204</var> <var class="product">SOUL</var> applications which respond to requests from clients which use Sybase DB-Library Open Client calls and SQL EXECUTE statements. | |||
</td></tr> | |||
</table> | |||
A single <var class="product">Model 204</var> Online region can contain any number of the three different Janus server products (<var class="product">Janus Specialty Data Store</var>, <var class="product">Janus Open Server</var>, and <var class="product">Janus Web Server</var>). A <var class="product">Janus Open Server</var> or <var class="product">Janus Web Server</var> <var class="product"> | A single <var class="product">Model 204</var> Online region can contain any number of the three different Janus server products (<var class="product">Janus Specialty Data Store</var>, <var class="product">Janus Open Server</var>, and <var class="product">Janus Web Server</var>). A <var class="product">Janus Open Server</var> or <var class="product">Janus Web Server</var> <var class="product">SOUL</var> request can also invoke <var class="product">Janus Open Client</var> $functions; this enables server applications to exchange information with other <var class="product">Model 204</var> or non-<var class="product">Model 204</var> servers. | ||
==Janus, the Sirius Mods, and UL/SPF== | ==Janus, the Sirius Mods, and UL/SPF== | ||
| Line 28: | Line 38: | ||
<ul> | <ul> | ||
<li>A collection of object code enhancements to the <var class="product">Model 204</var> database-engine | <li>A collection of object code enhancements to the <var class="product">Model 204</var> database-engine | ||
nucleus. These enhancements are distributed as components of the <var class="product">Sirius Mods</var> and make up a collection of products including those in the Janus family. | nucleus. These enhancements are distributed as components of the <var class="product">[[Sirius Mods]]</var> and make up a collection of products including those in the Janus family. | ||
<p> | <p> | ||
The <var class="product">Sirius Mods</var> include many non-connectivity related products (such as <var class="product">Fast/Backup</var>, <var class="product">Fast/Reload</var>, and the <var class="product">Fast/Unload User Language Interface</var>) that are not part of the Janus family. No <var class="product">Sirius Mods</var> products are required to run a Janus product other than itself and <var class="product">Janus TCP/IP Base</var>. </p></li> | The <var class="product">Sirius Mods</var> include many non-connectivity related products (such as <var class="product">Fast/Backup</var>, <var class="product">Fast/Reload</var>, and the <var class="product">Fast/Unload User Language Interface</var>) that are not part of the Janus family. No <var class="product">Sirius Mods</var> products are required to run a Janus product other than itself and <var class="product">Janus TCP/IP Base</var>. </p></li> | ||
<li>A collection of <var class="product">Model 204</var> procedures that contain <var class="product"> | <li>A collection of <var class="product">Model 204</var> procedures that contain <var class="product">[[SOUL]]</var>, documentation, and assorted other data. | ||
<p> | <p> | ||
These <var class="product">Model 204</var> procedures install and implement the components of the User Language Structured Programming Facility, | These <var class="product">Model 204</var> procedures install and implement the components of the formerly named User Language Structured Programming Facility (UL/SPF), now known as <var class="product">[[RKTools]]</var>. All the <var class="product">UL/SPF</var> files reside in the SIRIUS procedure file, which also contains code and data useful to Janus product users. <var class="product">UL/SPF</var> also includes files that are components of non-connectivity related products such as <var class="product">SirPro</var>, <var class="product">SirScan</var>, and <var class="product">SirMon</var>. </p> | ||
<p> | <p> | ||
No other <var class="product">UL/SPF</var> products are required to run any Janus product. Thus, to install a Janus product, both the <var class="product"> | No other <var class="product">UL/SPF</var> products are required to run any Janus product. Thus, to install a Janus product, both the <var class="product">Sirius Mods</var> and <var class="product">UL/SPF</var> must be installed, following the instructions in the <var class="book">[[Media:SiriNew.pdf|Sirius Mods Installation Guide]]</var> and [[RKTools installation]], respectively. When the <var class="product">Sirius Mods</var> are installed, all other products owned by the installing site that are part of the <var class="product">Sirius Mods</var> will also be installed. Similarly, when <var class="product">UL/SPF</var> is installed, all other products owned by the installing site that are part of <var class="product">UL/SPF</var> will be installed. </p></li> | ||
</ul> | </ul> | ||
==Versions and compatibility== | ==Versions and compatibility== | ||
Because the <var class="product">Sirius Mods</var> and <var class="product">UL/SPF</var> have somewhat different release cycles, the version numbers for these two components will often differ in a distribution. For example, version 7.6 of the <var class="product">Sirius Mods</var> might be shipped with version 7.3 of <var class="product">UL/SPF</var>. All the products in <var class="product">UL/SPF</var> depend on certain features being present in the version of the <var class="product">Sirius Mods</var> that is installed in the <var class="product">Model 204</var> load module under which <var class="product">UL/SPF</var> is running. This implies, obviously, that the <var class="product">Sirius Mods</var> must be installed for any <var class="product">UL/SPF</var> component to operate correctly. And, as of version 6.8, the <var class="product">Sirius Mods</var> version must match or be higher than the <var class="product">UL/SPF</var> version number. | Because the <var class="product">Sirius Mods</var> and <var class="product">UL/SPF</var> have somewhat different release cycles, the version numbers for these two components will often differ in a distribution. For example, version 7.6 of the <var class="product">Sirius Mods</var> might be shipped with version 7.3 of <var class="product">UL/SPF</var>. All the products in <var class="product">UL/SPF</var> depend on certain features being present in the version of the <var class="product">Sirius Mods</var> that is installed in the <var class="product">Model 204</var> load module under which <var class="product">UL/SPF</var> is running. This implies, obviously, that the <var class="product">Sirius Mods</var> must be installed for any <var class="product">UL/SPF</var> component to operate correctly. And, as of version 6.8, the <var class="product">Sirius Mods</var> version must match or be higher than the <var class="product">UL/SPF</var> version number. | ||
The <var class="product">Sirius Mods</var> however, do not depend on any particular features of the <var class="product">UL/SPF</var> product, merely the presence of the <var class="product">UL/SPF</var> SIRIUS file. The SIRIUS file contains the code for the sample <var class="product">Janus Web Server</var>, and Janus port definitions have default rules that call to this file. | The <var class="product">Sirius Mods</var> however, do not depend on any particular features of the <var class="product">UL/SPF</var> product, merely the presence of the <var class="product">UL/SPF</var> SIRIUS file. The SIRIUS file contains the code for the sample <var class="product">Janus Web Server</var>, and Janus port definitions have default rules that call to this file. | ||
Any <var class="product">SOUL</var> application (including <var class="product">UL/SPF</var>) that uses the <var class="product">Sirius Mods</var> will run correctly on subsequent versions of the <var class="product">Sirius Mods</var>. It is, thus, always possible to upgrade the <var class="product">Sirius Mods</var> without having to worry about upgrading <var class="product">UL/SPF</var>. This is not to say that this is always a good idea, only that it is possible and that the installed version of a <var class="product">UL/SPF</var> product will continue to run as it had before the <var class="product">Sirius Mods</var> upgrade. | |||
While the Janus family of products has a <var class="product">UL/SPF</var> component, most of the critical code is actually in the <var class="product">Sirius Mods</var> — object code enhancements to the <var class="product">Model 204</var> nucleus. The <var class="product">UL/SPF</var> component of the Janus family consists mostly of utilities, examples, and documentation. Because of this, the version number of a Janus product is generally considered to be the version of the <var class="product">Sirius Mods</var> in which it is contained. | While the Janus family of products has a <var class="product">UL/SPF</var> component, most of the critical code is actually in the <var class="product">Sirius Mods</var> — object code enhancements to the <var class="product">Model 204</var> nucleus. The <var class="product">UL/SPF</var> component of the Janus family consists mostly of utilities, examples, and documentation. Because of this, the version number of a Janus product is generally considered to be the version of the <var class="product">Sirius Mods</var> in which it is contained. | ||
Janus product documentation assumes that a site is running <var class="product">Sirius Mods</var> version 6.7 or later and has installed <var class="product">UL/SPF</var> version 6.2 or later. Any documentation that requires a later version of the <var class="product">Sirius Mods</var> or <var class="product">UL/SPF</var> will be clearly marked to indicate this. For example, a <var>[[JANUS DEFINE]]</var> parameter that is only available in versions 7.7 and later of the <var class="product">Sirius Mods</var> will have a sentence such as "This parameter is only available in version 7.7 and later of <var class="product">Sirius Mods</var>" in its documentation. If a feature, $function, command, or parameter is not indicated as requiring any specific version of the <var class="product">Sirius Mods</var>, it can be assumed that it is available, as documented, in all versions of a Janus product; that is, all versions since version 6.7 of the <var class="product">Sirius Mods</var> and version 6.2 of <var class="product">UL/SPF</var>. | Janus product documentation assumes that a site is running <var class="product">Sirius Mods</var> version 6.7 or later and has installed <var class="product">UL/SPF</var> version 6.2 or later. Any documentation that requires a later version of the <var class="product">Sirius Mods</var> or <var class="product">UL/SPF</var> will be clearly marked to indicate this. For example, a <var>[[JANUS DEFINE]]</var> parameter that is only available in versions 7.7 and later of the <var class="product">Sirius Mods</var> will have a sentence such as "This parameter is only available in version 7.7 and later of <var class="product">Sirius Mods</var>" in its documentation. If a feature, $function, command, or parameter is not indicated as requiring any specific version of the <var class="product">Sirius Mods</var>, it can be assumed that it is available, as documented, in all versions of a Janus product; that is, all versions since version 6.7 of the <var class="product">Sirius Mods</var> and version 6.2 of <var class="product">UL/SPF</var>. | ||
==Related products== | |||
The <var class="product">[[Janus TCP/IP Base]]</var> must be installed to use any Janus product. This is the only other <var class="product">Sirius Mods</var> product that must be installed in a <var class="product">Model 204</var> region to use a Janus product. | |||
In addition: | |||
<ul> | |||
<li><var class="product">[[Janus SOAP]]</var> | |||
<p> | |||
<var class="product">Janus SOAP</var> provides [[XML processing in Janus SOAP|XML APIs]] for the parsing and generation of XML. </p></li> | |||
<li><var class="product">[[SirScan]]</var> | |||
<p> | |||
One of the convenient debugging features available with Janus products is a TRACE | |||
facility which logs Janus request/response information to the <var class="product">Model 204</var> journal. In addition, most of the debugging information for a Janus product goes to the <var class="product">Model 204</var> journal. If you don't have good tools | |||
to view the journal, using it for debugging is a tedious process. AUDIT204 and ISPF | |||
provide some capabilities for viewing the journal, but they have many inherent | |||
shortcomings and inefficiencies. Because of this, it is strongly recommended that any | |||
site that installs <var class="product">Janus Web Server</var> also install <var class="product">SirScan</var>. </p> | |||
<p> | |||
<var class="product">SirScan</var> is a product in the <var class="product">UL/SPF</var> family that facilitates the interactive extraction of | |||
journal information within the <var class="product">Model 204</var> region. It does so via a user-friendly web | |||
browser or full-screen 3270 interface and low-level routines to provide efficient access to | |||
in-memory and on-disk journal buffers. <var class="product">SirScan</var> can provide an order of magnitude | |||
improvement in debugging efficiency for non-terminal-related <var class="product">Model 204</var> processes such | |||
as <var class="product">Janus Web Server</var>, <var class="product">Horizon</var>, BATCH2 and other Janus server applications. </p> | |||
<p class="note"><b>Note:</b> If <var class="product">[[Janus Web Server#Limited Janus Web Server|Limited Janus Web Server]]</var> is available, <var class="product">SirScan</var> is automatically authorized for viewing audit trail entries on <var>[[JANUS DEFINE#type|WEBSERV]]</var> threads. </p></li> | |||
</ul> | |||
==System requirements== | |||
The current release of Janus products requires the following components to run: | |||
<ul> | |||
<li>Mainframe operating systems:</li> | |||
<ul> | |||
<li>Any supported version of z/OS</li> | |||
<li>z/VSE Version 4 or later or</li> | |||
<li>CMS (releases currently supported by IBM) running under any supported version of z/VM</li> | |||
</ul> | |||
<li><var class="product">Model 204</var> Version 6 Release 1 or later</li> | |||
<li>One of the following mainframe TCP/IP implementations:</li> | |||
<ul> | |||
<li>IBM TCP/IP for z/VM or z/OS</li> | |||
<li>InterLink TCP/IP for MVS - Version 1.1 or later</li> | |||
<li>TCP/IP for VSE (Connectivity Systems, Inc., Columbus, OH) - Version 1 Release 4.0 or later</li> | |||
</ul> | |||
</ul> | |||
<var class="product">Janus Web Server</var> also requires: | |||
<ul> | |||
<li>Any HTTP 1.0 or later compliant browser</li> | |||
</ul> | |||
Latest revision as of 19:03, 1 June 2016
The Janus family
A site that has a Janus product will probably have one or more of the other products in the Janus family, though no others are required. The Janus products are:
| Janus TCP/IP Base | Provides a direct connection between Model 204 and a TCP/IP network. The Janus IFDIAL Library is a no-cost C-callable API that operates in conjunction with Janus TCP/IP Base to provide access to Model 204 from a wide variety of platforms. |
|---|---|
| Janus Web Server | Provides access to Model 204 data and objects to client browsers via the World Wide Web. |
| Janus Network Security | Supports the Secure Sockets Layer (SSL) protocol, providing secure communications for users of Janus products. |
| Janus Sockets | Provides HTTP socket-level connectivity between Model 204 and any software package or service that provides a sockets interface. |
| Janus Specialty Data Store | Enables Model 204 to operate as a Sybase/Microsoft SQL Server, principally for the Sybase OmniConnect feature of Adaptive Server. Features include optimized translation of SQL into SOUL and cataloging tools to map unchanged Model 204 files onto normalized. |
| Janus Open Client | Enables your Model 204 SOUL applications to invoke Sybase/Microsoft Remote Procedure Calls (RPCs) or language requests (for example, SQL) to one or more Sybase or Microsoft Open Servers and/or SQL servers. |
| Janus Open Server | Enables you to create Model 204 SOUL applications which respond to requests from clients which use Sybase DB-Library Open Client calls and SQL EXECUTE statements. |
A single Model 204 Online region can contain any number of the three different Janus server products (Janus Specialty Data Store, Janus Open Server, and Janus Web Server). A Janus Open Server or Janus Web Server SOUL request can also invoke Janus Open Client $functions; this enables server applications to exchange information with other Model 204 or non-Model 204 servers.
Janus, the Sirius Mods, and UL/SPF
The Janus family of products is itself made up of two distinct components:
- A collection of object code enhancements to the Model 204 database-engine
nucleus. These enhancements are distributed as components of the Sirius Mods and make up a collection of products including those in the Janus family.
The Sirius Mods include many non-connectivity related products (such as Fast/Backup, Fast/Reload, and the Fast/Unload User Language Interface) that are not part of the Janus family. No Sirius Mods products are required to run a Janus product other than itself and Janus TCP/IP Base.
- A collection of Model 204 procedures that contain SOUL, documentation, and assorted other data.
These Model 204 procedures install and implement the components of the formerly named User Language Structured Programming Facility (UL/SPF), now known as RKTools. All the UL/SPF files reside in the SIRIUS procedure file, which also contains code and data useful to Janus product users. UL/SPF also includes files that are components of non-connectivity related products such as SirPro, SirScan, and SirMon.
No other UL/SPF products are required to run any Janus product. Thus, to install a Janus product, both the Sirius Mods and UL/SPF must be installed, following the instructions in the Sirius Mods Installation Guide and RKTools installation, respectively. When the Sirius Mods are installed, all other products owned by the installing site that are part of the Sirius Mods will also be installed. Similarly, when UL/SPF is installed, all other products owned by the installing site that are part of UL/SPF will be installed.
Versions and compatibility
Because the Sirius Mods and UL/SPF have somewhat different release cycles, the version numbers for these two components will often differ in a distribution. For example, version 7.6 of the Sirius Mods might be shipped with version 7.3 of UL/SPF. All the products in UL/SPF depend on certain features being present in the version of the Sirius Mods that is installed in the Model 204 load module under which UL/SPF is running. This implies, obviously, that the Sirius Mods must be installed for any UL/SPF component to operate correctly. And, as of version 6.8, the Sirius Mods version must match or be higher than the UL/SPF version number.
The Sirius Mods however, do not depend on any particular features of the UL/SPF product, merely the presence of the UL/SPF SIRIUS file. The SIRIUS file contains the code for the sample Janus Web Server, and Janus port definitions have default rules that call to this file.
Any SOUL application (including UL/SPF) that uses the Sirius Mods will run correctly on subsequent versions of the Sirius Mods. It is, thus, always possible to upgrade the Sirius Mods without having to worry about upgrading UL/SPF. This is not to say that this is always a good idea, only that it is possible and that the installed version of a UL/SPF product will continue to run as it had before the Sirius Mods upgrade.
While the Janus family of products has a UL/SPF component, most of the critical code is actually in the Sirius Mods — object code enhancements to the Model 204 nucleus. The UL/SPF component of the Janus family consists mostly of utilities, examples, and documentation. Because of this, the version number of a Janus product is generally considered to be the version of the Sirius Mods in which it is contained.
Janus product documentation assumes that a site is running Sirius Mods version 6.7 or later and has installed UL/SPF version 6.2 or later. Any documentation that requires a later version of the Sirius Mods or UL/SPF will be clearly marked to indicate this. For example, a JANUS DEFINE parameter that is only available in versions 7.7 and later of the Sirius Mods will have a sentence such as "This parameter is only available in version 7.7 and later of Sirius Mods" in its documentation. If a feature, $function, command, or parameter is not indicated as requiring any specific version of the Sirius Mods, it can be assumed that it is available, as documented, in all versions of a Janus product; that is, all versions since version 6.7 of the Sirius Mods and version 6.2 of UL/SPF.
Related products
The Janus TCP/IP Base must be installed to use any Janus product. This is the only other Sirius Mods product that must be installed in a Model 204 region to use a Janus product.
In addition:
- Janus SOAP
Janus SOAP provides XML APIs for the parsing and generation of XML.
- SirScan
One of the convenient debugging features available with Janus products is a TRACE facility which logs Janus request/response information to the Model 204 journal. In addition, most of the debugging information for a Janus product goes to the Model 204 journal. If you don't have good tools to view the journal, using it for debugging is a tedious process. AUDIT204 and ISPF provide some capabilities for viewing the journal, but they have many inherent shortcomings and inefficiencies. Because of this, it is strongly recommended that any site that installs Janus Web Server also install SirScan.
SirScan is a product in the UL/SPF family that facilitates the interactive extraction of journal information within the Model 204 region. It does so via a user-friendly web browser or full-screen 3270 interface and low-level routines to provide efficient access to in-memory and on-disk journal buffers. SirScan can provide an order of magnitude improvement in debugging efficiency for non-terminal-related Model 204 processes such as Janus Web Server, Horizon, BATCH2 and other Janus server applications.
Note: If Limited Janus Web Server is available, SirScan is automatically authorized for viewing audit trail entries on WEBSERV threads.
System requirements
The current release of Janus products requires the following components to run:
- Mainframe operating systems:
- Any supported version of z/OS
- z/VSE Version 4 or later or
- CMS (releases currently supported by IBM) running under any supported version of z/VM
- Model 204 Version 6 Release 1 or later
- One of the following mainframe TCP/IP implementations:
- IBM TCP/IP for z/VM or z/OS
- InterLink TCP/IP for MVS - Version 1.1 or later
- TCP/IP for VSE (Connectivity Systems, Inc., Columbus, OH) - Version 1 Release 4.0 or later
Janus Web Server also requires:
- Any HTTP 1.0 or later compliant browser