Janus Web Server: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (add link)
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<var class="product">Janus Web Server</var> is part of the Janus family of products that provides connectivity to the <var class="product">Model 204</var> database.  
<var class="product">Janus Web Server</var> is part of the Janus family of products that provides connectivity to the <var class="product">Model&nbsp;204</var> database. <var class="product">Janus Web Server</var> allows Model 204 to act as a web server on a TCP/IP network, providing access to <var class="product">Model 204</var> data and applications from web browsers.


A site that has <var class="product">Janus Web Server</var> must have the <var class="product">[[Janus TCP/IP Base]]</var> because without it, it is impossible to use <var class="product">Janus Web Server</var>. A <var class="product">Janus Web Server</var> site might also have one or more of the other products in the Janus family, though no others are required. Note that if <var class="product">Limited Janus Web Server</var> is available, then <var class="product">Janus TCP/IP Base</var> is automatically authorized. <var class="product">Limited Janus Web Server</var> is a free, restricted version of <var class="product">Janus Web Server</var>.
Janus Web Server lets you use <var class="product">User Language</var> to send and receive HTML data with a web browser, and you can easily route output from Model 204 commands to the browser. A set of $functions retrieve information about a browser request and control the data sent back. You can serve static HTML, image, and audio data from Model 204 procedures and maintain both the form that initiates an application request and the application itself in the same procedure file. The existing Model&nbsp;204 security structures can be used for secure sections of web sites, and SSL (Secure Socket Layer) protocol support offers end-to-end encryption of data.  


The <var class="product">Janus Web Server</var> programmer API is implemented as the [[List_of_Janus_Web_Server_$functions|Janus Web Server $functions]].
A site that has <var class="product">Janus Web Server</var> must have the <var class="product">[[Janus TCP/IP Base]]</var> because without it, it is impossible to use <var class="product">Janus Web Server</var>. A <var class="product">Janus Web Server</var> site might also have one or more of the other products in the Janus family, though no others are required. Note that if <var class="product">[[#Limited Janus Web Server|Limited Janus Web Server]]</var> is available, then <var class="product">Janus TCP/IP Base</var> is automatically authorized. <var class="product">Limited Janus Web Server</var> is a free, restricted version of <var class="product">Janus Web Server</var>.


==Janus, the Sirius Mods, and UL/SPF==
The <var class="product">Janus Web Server</var> programmer API is implemented as the [[List of Janus Web Server $functions|Janus Web Server $functions]].


The Janus family of products is itself made up of two distinct components:
Use the [[#See also|See also]] links below to prepare to use <var class="product">Janus Web Server</var>, and for all <var class="product">Janus Web Server</var>-specific topics, see the [[:Category:Janus Web Server|Janus Web Server category]].
 
<ul>
<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. The <var class="product">Sirius Mods</var> 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 <var class="product">Sirius Mods</var> products are required to run <var class="product">Janus Web Server</var> other than itself and <var class="product">Janus TCP/IP Base</var>.</li>
 
<li>A collection of <var class="product">Model 204</var> procedures that contain <var class="product">User Language</var>, documentation, and assorted other data.
 
These <var class="product">Model 204</var> procedures install and implement the components of the User Language Structured Programming Facility, also known as <var class="product">UL/SPF</var>. All the <var class="product">UL/SPF</var> files reside in the SIRIUS procedure file (as of <var class="product">Sirius Mods</var> version 6.8). which also contains code and data useful to Janus users including <var class="product">Janus Web Server</var> 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>, SirScan, and <var class="product">SirMon</var>. No other <var class="product">UL/SPF</var> products are required to run <var class="product">Janus Web Server</var>, or any other Janus product, for that matter. Thus, to install <var class="product">Janus Web Server</var>, both the <var class="product">[[Sirius Mods]]</var> and <var class="product">[[ULSPF|UL/SPF]]</var> must be installed, following the instructions in the ''Sirius Mods Installation Guide'' and the ''UL/SPF Installation and Maintenance Guide'', 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.</li>
</ul>
 
==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.
 
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.
 
Sirius Software has a strong commitment to backward compatibility with the <var class="product">Sirius Mods</var>. This means that any <var class="product">User Language</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> &mdash; 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. <var class="product">Janus Web Server</var> was first available in version 4.4 of the <var class="product">Sirius Mods</var>, so the first version of <var class="product">Janus Web Server</var> was actually called version 4.4.
 
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 <var class="product">Janus Web Server</var>; 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>.


==Additional Janus Web tools==
==Additional Janus Web tools==
<var class="product">Janus Web Server</var> is distributed with two utilities: SIRPIPE and SIRPUT. These can be used to facilitate loading of binary and text data into <var class="product">Model 204</var> procedure files. Both utilities are distributed as stand-alone load modules that requires a separate (though simple) installation from the <var class="product">Sirius Mods</var> and <var class="product">UL/SPF</var>.
<var class="product">Janus Web Server</var> is distributed with two utilities: [[Loading with the SIRPIPE and SIRPUT utilities|SIRPIPE and SIRPUT]]. These can be used to facilitate loading of binary and text data into <var class="product">Model 204</var> procedure files. Both utilities are distributed as stand-alone load modules that requires a separate (though simple) installation from the <var class="product">[[RKTools]]</var>.


<var class="product">Janus Web Server</var> also includes a facility called Janus Web Legacy Support. Not a separate product, this is a standard part of <var class="product">Janus Web Server</var>. By converting 3270 screens into HTML pages, Janus Web Legacy Support makes it possible to access existing 3270 applications from a browser. For more information about this feature, see [[Janus Web Legacy Support]].
<var class="product">Janus Web Server</var> also includes a facility called <var class="product">[[Janus Web Legacy Support]]</var>. Not a separate product, this is a standard part of <var class="product">Janus Web Server</var>. By converting 3270 screens into HTML pages, <var class="product">Janus Web Legacy Support</var> makes it possible to access existing 3270 applications from a browser.


==Related documentation==
==Limited Janus Web Server==
The Limited Janus Web Server capability allows you to write limited-scale <var class="product">Janus Web Server</var> applications without requiring you to purchase a copy of <var class="product">Janus Web Server</var>. This lets you implement low-volume Internet applications without additional expense.


As mentioned above in [[#Janus, the Sirius Mods, and UL/SPF|"Janus, the Sirius Mods, and UL/SPF"]], <var class="product">Janus Web Server</var>
The <var class="product">Limited Janus Web Server</var> capability is automatically created in any <var class="product">Model&nbsp;204</var> 7.5 or greater load module. Earlier Model 204 versions require at least one <var class="product">[[Sirius Mods|Sirius Mods product]] authorized (and the duration of <var class="product">Limited Janus Web Server</var> capability is the maximum duration of any of the site's authorized Sirius Mods products).
requires the installation of both the <var class="product">Sirius Mods</var> and <var class="product">UL/SPF</var>. As such, the person
responsible for the installation of <var class="product">Janus Web Server</var> should refer to the <var class="product">Sirius Mods</var>
Installation Guide and the <var class="product">UL/SPF</var> Installation and Maintenance Guide.  


The Sirius Messages Manual contains documentation on <var class="product">Sirius Mods</var> error messages, so it
<var class="product">Limited Janus Web Server</var> consists of the following:
might be useful to application programmers.


<var class="product">Janus Web Server</var> depends on the Janus TCP/IP Base
<ul>
product, and there is much useful information in the Janus TCP/IP Base Reference
<li>Authorization to use the $Web* functions ([[Janus Web Server $functions]]).</li>
Manual.
 
You are authorized to use a number of Sirius $functions along with <var class="product">Janus Web Server</var>,
including procedure processing $functions and $list processing $functions. Unless
otherwise stated, documentation for these functions, and any $functions mentioned but
not documented here that are not standard <var class="product">Model 204</var> $functions, is accessible via the [[List of $functions|"List of $functions"]].
<br/>'''Note:''' One of the limitations of Limited <var class="product">Janus Web Server</var> is that it only authorizes the
$WEBxxx functions; it does not authorize the other Sirius Functions, which are
authorized by a full <var class="product">Janus Web Server</var> license.
 
For details about date
processing relevant to some of the <var class="product">Janus Web Server</var> $functions, see [[Datetime string formats|"Datetime string formats"]].
 
==Related products==
 
The <var class="product">Janus TCP/IP Base</var> must be installed to use <var class="product">Janus Web Server</var>. 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 <var class="product">Janus Web Server</var>.
 
If security is a concern, whether it be internet or intranet security, SSL (Secure Socket
Layer) is the de-facto standard for providing encryption and validation security for web-based applications. The <var class="product">Janus Network Security</var> product provides SSL support for
<var class="product">Janus Web Server</var> (as well as other products in the Janus family).


One of the convenient debugging features available with <var class="product">Janus Web Server</var> is a TRACE
<li>If <var class="product">[[Janus TCP/IP Base]]</var> is not otherwise authorized, authorization to it with 3 threads. </li>
facility which logs Janus request/response information to the <var class="product">Model 204</var> journal. In
addition, most application debugging in a <var class="product">Model 204</var> environment is done on a 3270 or
3270 emulator &mdash; but since <var class="product">Janus Web Server</var> applications are not associated with a
3270, debugging techniques geared toward a 3270 will not work for them, so most of
their debugging information 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>.


<var class="product">SirScan</var> is a product in the <var class="product">UL/SPF</var> family that facilitates the interactive extraction of
<li>Authorization to define and use <var class="product">Janus Web Server</var> (<var>WEBSERV</var>) ports with up to 5 connections. </li>
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.
<br>'''Note:''' If <var class="product">[[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.


==System requirements==
<li>Authorization to use <var class="product">SirScan</var> to view the audit trail entries of any <var>WEBSERV</var> thread. </li>


The current release of <var class="product">Janus Web Server</var> requires the following components to run:
<li>Authorization for the <var>[[Text and Html statements|Html/Text]]</var> statement and the <var>[[SIREDIT parameter|SIREDIT]]</var> and <var>[[WEBAUDIT parameter|WEBAUDIT]]</var> parameters.</li>


<ul>
<li>Customer support and maintenance for Limited Janus Web Server. </li>
<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>Model 204 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>
<li>Any HTTP 1.0 or later compliant browser such as Mozilla Firefox 1.0 or later or Microsoft Internet Explorer 6.0 or later, or virtually any other browser</li>
</ul>
</ul>


==Limited Janus Web Server &#x2014; Free Use of Janus Web Server==
The limitations imposed in Limited Janus Web Server relative to a full
 
<var class="product">Janus Web Server</var> license are as follows:
The Limited Janus Web Server capability allows you to write limited-scale <var class="product">Janus Web Server</var> applications without requiring you to purchase a copy of <var class="product">Janus Web Server</var>. This allows you to implement low-volume applications using the power of the Web, even if your only <var class="product">Sirius Mods</var> product is, for example, Fast/Backup or Fast/Reload.
 
The Limited Janus Web Server capability is automatically created in any <var class="product">Model 204</var> load module that has at least one <var class="product">Sirius Mods</var> product authorized and does not contain authorization to <var class="product">Janus Web Server</var>. The duration of that capability is the maximum duration of any of the authorized <var class="product">Sirius Mods</var> products. See the "Overview" chapter in the [http://www.sirius-software.com/maint/download/siri.pdf Sirius Mods Installation Guide] for a list of all products that are in the  <var class="product">Sirius Mods</var>.
 
Limited Janus Web Server consists of the following:
 
<ul>
<li>Authorization to use the $WEBxxx functions ([[Janus Web Server API ($functions)|"Janus Web Server API ($functions)"]]).</li>
<li>If Janus TCP/IP Base is not otherwise authorized, authorization to it with 3 threads.
<li>Authorization to define and use <var class="product">Janus Web Server</var> (<var>WEBSERV</var>) ports with up to 3
connections.</li>
<li>Authorization to use SirScan to view the audit trail entries of any <var>WEBSERV</var> thread.
<li>Authorization for the <var>HTML/TEXT</var> statement and the <var>SIREDIT</var> and <var>WEBAUDIT</var>
parameters.</li>
<li>Customer support and maintenance for Limited Janus Web Server.
The limitations imposed in Limited Janus Web Server are as follows, relative to a full
<var class="product">Janus Web Server</var> license:</li>
<ul>
<ul>
<li>At most 3 concurrent Janus <var>WEBSERV</var> threads may be active.</li>
<li>At most 3 concurrent Janus <var>WEBSERV</var> threads may be active.</li>
<li>The only $functions authorized by Limited Janus Web Server are the $WEBxxx ones; <var class="product">Janus Web Server</var> authorizes many $functions beyond the $WEBxxx functions.</li>
 
</ul>
<li>The only $functions authorized by <var class="product">Limited Janus Web Server</var> are the $Web* ones; <var class="product">Janus Web Server</var> authorizes many $functions beyond the $Web* functions.</li>
</ul>
</ul>


Sirius Software will encourage and assist users among its customer base to develop applications that can be shared among Limited Janus Web Server and <var class="product">Janus Web Server</var> customers. Of course, Sirius Software hopes that the functionality provided by Limited Janus Web Server convinces you to purchase full <var class="product">Janus Web Server</var> and <var class="product">[[SirScan]]</var> licenses.
For further information about Limited Janus Web Server, [[Contacting Rocket Software Technical Support|contact Rocket Model 204 Technical Support]]. Rocket Software will encourage and assist users among its customer base to develop applications that can be shared among Limited Janus Web Server and <var class="product">Janus Web Server</var> customers. Of course, Rocket Software hopes that the functionality provided by <var class="product">Limited Janus Web Server</var> convinces you to purchase full <var class="product">Janus Web Server</var> and <var class="product">[[SirScan]]</var> licenses.
 
==References and links==


==See also==
<ul>
<ul>
<li>[[:Category:Janus Web Server $functions]]</li>
<li>[[Understanding Web processing]]</li>
<li>[[Getting started with Janus Web Server]]</li>
<li>[[List of Janus Web Server $functions]]</li>
<li>[[List of Janus Web Server $functions]]</li>
<li>[[Understanding Web processing]]</li>
<li>[[List of Janus commands]]</li>
<li>[[List of Janus commands]]</li>
<li>[[Getting started with Janus Web Server]]</li>
<li>[[Janus products|Janus products' overview]]
</ul>
</ul>


[[Category:Janus Web Server]] [[Category: Sirius Software products]]
[[Category:Janus Web Server]]

Latest revision as of 16:41, 7 August 2018

Janus Web Server is part of the Janus family of products that provides connectivity to the Model 204 database. Janus Web Server allows Model 204 to act as a web server on a TCP/IP network, providing access to Model 204 data and applications from web browsers.

Janus Web Server lets you use User Language to send and receive HTML data with a web browser, and you can easily route output from Model 204 commands to the browser. A set of $functions retrieve information about a browser request and control the data sent back. You can serve static HTML, image, and audio data from Model 204 procedures and maintain both the form that initiates an application request and the application itself in the same procedure file. The existing Model 204 security structures can be used for secure sections of web sites, and SSL (Secure Socket Layer) protocol support offers end-to-end encryption of data.

A site that has Janus Web Server must have the Janus TCP/IP Base because without it, it is impossible to use Janus Web Server. A Janus Web Server site might also have one or more of the other products in the Janus family, though no others are required. Note that if Limited Janus Web Server is available, then Janus TCP/IP Base is automatically authorized. Limited Janus Web Server is a free, restricted version of Janus Web Server.

The Janus Web Server programmer API is implemented as the Janus Web Server $functions.

Use the See also links below to prepare to use Janus Web Server, and for all Janus Web Server-specific topics, see the Janus Web Server category.

Additional Janus Web tools

Janus Web Server is distributed with two utilities: SIRPIPE and SIRPUT. These can be used to facilitate loading of binary and text data into Model 204 procedure files. Both utilities are distributed as stand-alone load modules that requires a separate (though simple) installation from the RKTools.

Janus Web Server also includes a facility called Janus Web Legacy Support. Not a separate product, this is a standard part of Janus Web Server. By converting 3270 screens into HTML pages, Janus Web Legacy Support makes it possible to access existing 3270 applications from a browser.

Limited Janus Web Server

The Limited Janus Web Server capability allows you to write limited-scale Janus Web Server applications without requiring you to purchase a copy of Janus Web Server. This lets you implement low-volume Internet applications without additional expense.

The Limited Janus Web Server capability is automatically created in any Model 204 7.5 or greater load module. Earlier Model 204 versions require at least one Sirius Mods product authorized (and the duration of Limited Janus Web Server capability is the maximum duration of any of the site's authorized Sirius Mods products).

Limited Janus Web Server consists of the following:

  • Authorization to use the $Web* functions (Janus Web Server $functions).
  • If Janus TCP/IP Base is not otherwise authorized, authorization to it with 3 threads.
  • Authorization to define and use Janus Web Server (WEBSERV) ports with up to 5 connections.
  • Authorization to use SirScan to view the audit trail entries of any WEBSERV thread.
  • Authorization for the Html/Text statement and the SIREDIT and WEBAUDIT parameters.
  • Customer support and maintenance for Limited Janus Web Server.

The limitations imposed in Limited Janus Web Server relative to a full Janus Web Server license are as follows:

  • At most 3 concurrent Janus WEBSERV threads may be active.
  • The only $functions authorized by Limited Janus Web Server are the $Web* ones; Janus Web Server authorizes many $functions beyond the $Web* functions.

For further information about Limited Janus Web Server, contact Rocket Model 204 Technical Support. Rocket Software will encourage and assist users among its customer base to develop applications that can be shared among Limited Janus Web Server and Janus Web Server customers. Of course, Rocket Software hopes that the functionality provided by Limited Janus Web Server convinces you to purchase full Janus Web Server and SirScan licenses.

See also