Janus environment definition: Difference between revisions
Jump to navigation
Jump to search
m (→Notes) |
m (RKTools replaces UL/SPF) |
||
| (15 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
==Overview== | ==Overview== | ||
Once the Janus object modules (see [[Sirius Mods]]) are linked into [[Model 204]], the system manager must modify the CCAIN stream to allow the | Once the Janus object modules (see <var class="product">[[Sirius Mods]]</var>) are linked into <var class="product">[[Model 204]]</var>, the system manager must modify the CCAIN stream to allow the Online to act as a TCP/IP-Janus server. | ||
User 0 parameters that affect Janus functionality are listed and described below. Set the parameters that apply to Janus components installed at your site, and ignore parameters for components not installed at your site. | User 0 parameters that affect Janus functionality are listed and described below. Set the parameters that apply to Janus components installed at your site, and ignore parameters for components not installed at your site. | ||
<ul> | <ul> | ||
<li>[[CSIPID parameter]]</li> | <li><var>[[CSIPID parameter|CSIPID]]</var></li> | ||
<li>[[NCMPBUF parameter]]</li> | <li><var>[[NCMPBUF parameter|NCMPBUF]]</var></li> | ||
<li>[[SDAEMDEV parameter]]</li> | <li><var>[[SDAEMDEV parameter|SDAEMDEV]]</var></li> | ||
<li>[[SRSDEFTO parameter]]</li> | <li><var>[[SRSDEFTO parameter|SRSDEFTO]]</var></li> | ||
<li>[[SRSMAX parameter]]</li> | <li><var>[[SRSMAX parameter|SRSMAX]]</var></li> | ||
<li>[[SRSMAXTO parameter]]</li> | <li><var>[[SRSMAXTO parameter|SRSMAXTO]]</var></li> | ||
<li>[[SRSMAXUS parameter]]</li> | <li><var>[[SRSMAXUS parameter|SRSMAXUS]]</var></li> | ||
<li>[[TCPSERV parameter]]</li> | <li><var>[[TCPSERV parameter|TCPSERV]]</var></li> | ||
<li>[[TCPTYPE parameter]]</li> | <li><var>[[TCPTYPE parameter|TCPTYPE]]</var></li> | ||
</ul> | </ul> | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>CSIPID</th> | <tr><th><var>CSIPID</var></th> | ||
<td>Identifier of the CSI TCP/IP server under VSE. This is a two-character identifier that must match the ID= parameter on the VSE // EXEC statement for the TCP/IP partition with which Janus will communicate. If not specified, this parameter defaults to 00, which is also the CSI TCP/IP default.</td></tr> | <td>Identifier of the CSI TCP/IP server under VSE. This is a two-character identifier that must match the ID= parameter on the VSE // EXEC statement for the TCP/IP partition with which Janus will communicate. If not specified, this parameter defaults to 00, which is also the CSI TCP/IP default.</td></tr> | ||
<tr><th>NCMPBUF</th> | <tr><th><var>NCMPBUF</var></th> | ||
<td>Defines the number of buffers available for compressed data. NCMPBUF must be set to a positive value before the data compression $functions ([[$Deflate]] or [[$Inflate]]) can be used by Janus products and before the compression feature can be used by [[Janus Web Server]] | <td>Defines the number of buffers available for compressed data. <var>NCMPBUF</var> must be set to a positive value before the data compression $functions (<var>[[$Deflate]]</var> or <var>[[$Inflate]]</var>) can be used by Janus products and before the compression feature can be used by <var class="product">[[Janus Web Server]]</var> ports. | ||
NCMPBUF should be set to the maximum number of users expected to concurrently use compression. The default value is 0, that is, compression is not available. About 309K bytes are required for each NCMPBUF buffer. These are allocated in 31-bit storage. | <var>NCMPBUF</var> should be set to the maximum number of users expected to concurrently use compression. The default value is 0, that is, compression is not available. About 309K bytes are required for each <var>NCMPBUF</var> buffer. These are allocated in 31-bit storage. | ||
Although NCMPBUF is available only in | Although <var>NCMPBUF</var> is available only in <var class="product">Sirius Mods</var> 6.4 and later, the compression facility is available for sending data from <var class="product">Janus Web Server</var> ports in <var class="product">Sirius Mods</var> version 6.3. In version 6.3, compression buffers were 64K bytes and were allocated to every thread on a port if the <var>[[COMPRESS (JANUS DEFINE parameter)|COMPRESS]]</var> parameter was specified on the <var>[[JANUS DEFINE]]</var> command. | ||
For more information about the compression feature, see the | For more information about the compression feature, see the <var>$Deflate</var> and <var>$Inflate</var> pages.</td></tr> | ||
<tr><th>SDAEMDEV</th> | <tr><th><var>SDAEMDEV</var></th> | ||
<td>Specifies the IODEV number to be used for sdaemon (pronounced | <td>Specifies the IODEV number to be used for [[Sdaemons|sdaemon]] (pronounced <i>ess-demon</i>) threads. These are special background threads (analogous to IODEV=3 threads) that operate without terminals and that offload processing from the Online user's thread. | ||
from the | |||
Any Janus session that treats the Model 204 address space as a server & | Any Janus session that treats the <var class="product">Model 204</var> address space as a server — that is, <var>IFDIAL2</var>, <var class="product">Janus SDS</var>, <var class="product">Web Server</var>, or <var class="product">Open Server</var> sessions — requires the same resources as any user session, including a <var class="product">Model 204</var> server and a thread on which to run. The sdaemon facility makes these resources available. | ||
Sdaemon threads are activated when Model 204 establishes a | Sdaemon threads are activated when <var class="product">Model 204</var> establishes a <var class="product">Janus Web Server</var>, <var class="product">Janus Sockets</var> (for server ports), <var class="product">Janus Specialty Data Store</var>, <var class="product">Janus Open Server</var>, or <var>IFDIAL</var> connection. Many <var class="product">[[RKTools]]</var> products also use sdaemon threads for brief units of work. It is recommended that a site have an sdaemon thread for each concurrent connection to be maintained by a Janus product, and have at least four sdaemon threads if using any <var class="product">RKTools</var> products. | ||
The SDAEMDEV parameter can be any odd number from 1 to 53. Note: Any IODEV number selected for SDAEMDEV will be unavailable for its normal function. Thus the recommended setting for SDAEMDEV is 15 (unless a site is using BTAM TTY terminals). For more information about setting up sdaemon threads, see the [ | The <var>SDAEMDEV</var> parameter can be any odd number from 1 to 53. | ||
<b>Note:</b> Any <var>IODEV</var> number selected for <var>SDAEMDEV</var> will be unavailable for its normal function. Thus the recommended setting for <var>SDAEMDEV</var> is 15 (unless a site is using BTAM TTY terminals). For more information about setting up sdaemon threads, see the <i>[http://sirius-software.com/maint/download/siri.pdf Sirius_Mods_Installation_Guide]</i>.</td></tr> | |||
<tr><th>SRSDEFTO</th> | <tr><th><var>SRSDEFTO</var></th> | ||
<td>The default timeout value (in seconds) to be used for saved record sets if none is specified on the [[$Web_Save_Recset]] function. If <var>SRSDEFTO</var> exceeds SRSMAXTO, SRSMAXTO will effectively act as the default timeout value. The default for <var>SRSDEFTO</var> is 900, which means 15 minutes. Setting <var>SRSDEFTO</var> to 0 means no record sets will be saved unless an explicit timeout is specified in the | <td>The default timeout value (in seconds) to be used for saved record sets if none is specified on the <var>[[$Web_Save_Recset]]</var> function. If <var>SRSDEFTO</var> exceeds <var>SRSMAXTO</var>, <var>SRSMAXTO</var> will effectively act as the default timeout value. The default for <var>SRSDEFTO</var> is 900, which means 15 minutes. Setting <var>SRSDEFTO</var> to 0 means no record sets will be saved unless an explicit timeout is specified in the <var>$Web_Save_Recset</var> function. <var>SRSDEFTO</var> can be reset. </td></tr> | ||
<tr><th>SRSMAX</th> | <tr><th><var>SRSMAX</var></th> | ||
<td>Maximum number of total saved record sets in the system. This parameter defaults to 0, and it must be set to a positive value to allow use of the saved record set feature of <var class="product>Janus Web Server</var>. If this parameter is 0, | <td>Maximum number of total saved record sets in the system. This parameter defaults to 0, and it must be set to a positive value to allow use of the saved record set feature of <var class="product">Janus Web Server</var>. If this parameter is 0, <var>$Web_Save_Recset</var> will never save a record set. The number of record sets that can actually be saved at a given time might be somewhat less than this value if many of the saved record sets are associated with groups with large numbers of members. The saved record set feature will use approximately <code>64*SRSMAX</code> bytes of virtual | ||
storage | storage. </td></tr> | ||
<tr><th>SRSMAXTO</th> | <tr><th><var>SRSMAXTO</var></th> | ||
<td>Maximum length of time (in seconds) that a saved record set can be saved without being referenced. The actual maximum length of time a record set will be saved can be set in the | <td>Maximum length of time (in seconds) that a saved record set can be saved without being referenced. The actual maximum length of time a record set will be saved can be set in the <var>$Web_Save_Recset</var> function, but it will be set to <var>SRSMAXTO</var> if that value exceeds <var>SRSMAXTO</var>. Similarly if a timeout is not specified on the <var>$Web_Save_Recset</var>, so the timeout value is derived from <var>SRSDEFTO</var>, but if <var>SRSDEFTO</var> is greater than <var>SRSMAXTO</var>, | ||
SRSMAXTO will be used as the timeout. The default for SRSMAXTO is 3600, which means a maximum timeout of one hour. SRSMAXTO can be reset. By resetting SRSMAXTO to 0, the saved record set facility is temporarily disabled, and all enqueues associated with saved record sets are freed. This can be useful in clearing up an enqueuing problem caused by a saved record set. Resetting SRSMAXTO will dynamically adjust the timeout for any record sets saved with a higher timeout value. So if there is a saved record set with a timeout of 1800 seconds when SRSMAXTO is reset to 300, that record set's timeout is updated to 300. If that record set had been saved more than 300 seconds before the reset, it would be immediately freed. | <var>SRSMAXTO</var> will be used as the timeout. The default for <var>SRSMAXTO</var> is 3600, which means a maximum timeout of one hour. <var>SRSMAXTO</var> can be reset. By resetting <var>SRSMAXTO</var> to 0, the saved record set facility is temporarily disabled, and all enqueues associated with saved record sets are freed. This can be useful in clearing up an enqueuing problem caused by a saved record set. Resetting <var>SRSMAXTO</var> will dynamically adjust the timeout for any record sets saved with a higher timeout value. So if there is a saved record set with a timeout of 1800 seconds when <var>SRSMAXTO</var> is reset to 300, that record set's timeout is updated to 300. If that record set had been saved more than 300 seconds before the reset, it would be immediately freed. | ||
</td></tr> | |||
<tr><th><var>SRSMAXUS</var></th> | |||
<td>Maximum number of saved record sets per user. This limit is a per-userid limit, and it applies even if the userid is being used from multiple web browsers. The default for <var>SRSMAXUS</var> is 0, which means that there is no per-user limit for saved record sets. <var>SRSMAXUS</var> can be used to ensure that a single user, either as the result of a programming error or simply through running frequent queries, does not monopolize the saved record set facility. <var>SRSMAXUS</var> can be reset. | |||
< | </td></tr> | ||
<td>Maximum number of saved record sets per user. This limit is a per-userid limit, and it applies even if the userid is being used from multiple web browsers. The default for SRSMAXUS is 0, which means that there is no per-user limit for saved record sets. SRSMAXUS can be used to ensure that a single user, either as the result of a programming error or simply through running frequent queries, does not monopolize the saved record set facility. SRSMAXUS can be reset. | |||
<tr><th><var>TCPSERV</var></th> | |||
<td>Name of the TCP/IP server address space (MVS) or virtual machine (CMS). If not specified, this parameter defaults to <var>TCPIP</var>.</td></tr> | |||
<tr><th> | <tr><th><var>TCPTYPE</var></th><td>Specifies the type of TCP/IP network to which Model 204 is connected. If you are using Janus Version 5.3 or later, you may omit this parameter and allow Janus to automatically detect the type of TCP/IP you have on your machine. | ||
<td> | |||
< | If you specify type <var>IBM</var>, Janus will detect and set the type of IBM interface it will use: | ||
<ul> | <ul> | ||
<li>Under CMS, this is always IUCV. | <li>Under CMS, this is always IUCV. | ||
<li>Under MVS, Janus will select the IBM interface in the following order: BPX (Unix System Services), HPNS, then IUCV. | <li>Under MVS, Janus will select the IBM interface in the following order: BPX (Unix System Services), HPNS, then IUCV. | ||
<li>If multiple types are installed, Janus will select the interface in the following order for MVS: BPX, HPNS, IUCV, Interlink | <li>If multiple types are installed, Janus will select the interface in the following order for MVS: BPX, HPNS, IUCV, then Interlink. You can always override auto-detection by explicitly supplying a <var>TCPTYPE</var> parameter. | ||
</ul> | </ul> | ||
The valid TCPTYPE values are: | The valid <var>TCPTYPE</var> values are: | ||
<table> | <table> | ||
<tr><th>IBM</th> | <tr><th><var>IBM</var></th> | ||
<td>To specify IBM TCP/IP. This means auto-detect the best IBM TCP/IP interface. | <td>To specify IBM TCP/IP. This means auto-detect the best IBM TCP/IP interface. | ||
For CMS, this is always IUCV. For MVS, Janus will look for BPX, HPNS, then IUCV. </td></tr> | For CMS, this is always IUCV. For MVS, Janus will look for BPX, HPNS, then IUCV. </td></tr> | ||
<tr><th>BPX</th> | |||
<tr><th><var>BPX</var></th> | |||
<td>Specifies IBM BPX (Unix System Services) (MVS only). </td></tr> | <td>Specifies IBM BPX (Unix System Services) (MVS only). </td></tr> | ||
<tr><th>HPNS</th> | |||
<tr><th><var>HPNS</var></th> | |||
<td>Specifies IBM HPNS (High Performance Native Sockets) (MVS only). </td></tr> | <td>Specifies IBM HPNS (High Performance Native Sockets) (MVS only). </td></tr> | ||
<tr><th>INTERLNK</th> | |||
<tr><th><var>INTERLNK</var></th> | |||
<td>Specifies InterLink TCP/IP (MVS only). </td></tr> | <td>Specifies InterLink TCP/IP (MVS only). </td></tr> | ||
<tr><th>CSI</th> | |||
<tr><th><var>CSI</var></th> | |||
<td>Specifies Connectivity Systems TCP/IP (VSE only). </td></tr> | <td>Specifies Connectivity Systems TCP/IP (VSE only). </td></tr> | ||
</table> | </table> | ||
| Line 93: | Line 94: | ||
<ul> | <ul> | ||
<li>If you are using the IBM BPX TCP/IP interface, check the following APARs for PTFs that may apply to your system: OW42346, PQ24583, and OW37717. These APARs relate to SIGPIPE handling in the BPX API and can cause abends which result in immediate termination of Model 204. Also, customers have reported occasional hung threads that may be fixed by APAR PQ33040.</li> | <li>If you are using the IBM BPX TCP/IP interface, check the following APARs for PTFs that may apply to your system: OW42346, PQ24583, and OW37717. These APARs relate to SIGPIPE handling in the BPX API and can cause abends which result in immediate termination of <var class="product">Model 204</var>. Also, customers have reported occasional hung threads that may be fixed by APAR PQ33040.</li> | ||
<li>Most of the communication with the TCP/IP address space is accomplished via a PST. Because of this, NSUBTKS may need to be increased by 1 before using Janus.</li> | <li>Most of the communication with the TCP/IP address space is accomplished via a PST. Because of this, <var>NSUBTKS</var> may need to be increased by 1 before using Janus.</li> | ||
<li>If you are running z/OS V1.6 or later with Model 204 V7.5, and are using the BPX interface, TCP buffers for Janus Web ports will be allocated (if possible) in ATB storage. | |||
</li> | |||
</ul> | </ul> | ||
| Line 100: | Line 103: | ||
<ul> | <ul> | ||
<li>When discussing <var class="product">[http://www.sirius-software.com/maint/download/jansslr.pdf Janus Open Server]</var> applications, this manual uses the term server to refer to the [[Model 204]] address space in general. Server program or server application is used when referring to | <li>When discussing <var class="product">[http://www.sirius-software.com/maint/download/jansslr.pdf Janus Open Server]</var> applications, this manual uses the term server to refer to the [[Model 204]] address space in general. Server program or server application is used when referring to <var class="product">User Language</var> code that responds to a client request. | ||
<li>The terms BATCH2 and IFDIAL are used somewhat interchangeably, because IFDIAL is used to refer to the low level routines that are used to provide BATCH2 access to Model 204. | <li>The terms <var>BATCH2</var> and <var>IFDIAL</var> are used somewhat interchangeably, because <var>IFDIAL</var> is used to refer to the low level routines that are used to provide <var>BATCH2</var> access to <var class="product">Model 204</var>. | ||
</ul> | </ul> | ||
== | ==See also== | ||
<ul> | |||
<li>[[Janus TCP/IP Base]] | |||
<li>[[Defining server ports]] | |||
<li>[[Storage requirements]] | |||
<li>[[Translate tables]] | |||
<li>[[Janus commands]] | |||
<li>[[Janus user parameters]] | |||
</ul> | |||
[[Category:Janus TCP/IP Base]] | [[Category:Janus TCP/IP Base]] | ||
Latest revision as of 22:20, 23 October 2015
Overview
Once the Janus object modules (see Sirius Mods) are linked into Model 204, the system manager must modify the CCAIN stream to allow the Online to act as a TCP/IP-Janus server. User 0 parameters that affect Janus functionality are listed and described below. Set the parameters that apply to Janus components installed at your site, and ignore parameters for components not installed at your site.
| CSIPID | Identifier of the CSI TCP/IP server under VSE. This is a two-character identifier that must match the ID= parameter on the VSE // EXEC statement for the TCP/IP partition with which Janus will communicate. If not specified, this parameter defaults to 00, which is also the CSI TCP/IP default. | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| NCMPBUF | Defines the number of buffers available for compressed data. NCMPBUF must be set to a positive value before the data compression $functions ($Deflate or $Inflate) can be used by Janus products and before the compression feature can be used by Janus Web Server ports.
NCMPBUF should be set to the maximum number of users expected to concurrently use compression. The default value is 0, that is, compression is not available. About 309K bytes are required for each NCMPBUF buffer. These are allocated in 31-bit storage. Although NCMPBUF is available only in Sirius Mods 6.4 and later, the compression facility is available for sending data from Janus Web Server ports in Sirius Mods version 6.3. In version 6.3, compression buffers were 64K bytes and were allocated to every thread on a port if the COMPRESS parameter was specified on the JANUS DEFINE command. For more information about the compression feature, see the $Deflate and $Inflate pages. | ||||||||||
| SDAEMDEV | Specifies the IODEV number to be used for sdaemon (pronounced ess-demon) threads. These are special background threads (analogous to IODEV=3 threads) that operate without terminals and that offload processing from the Online user's thread.
Any Janus session that treats the Model 204 address space as a server — that is, IFDIAL2, Janus SDS, Web Server, or Open Server sessions — requires the same resources as any user session, including a Model 204 server and a thread on which to run. The sdaemon facility makes these resources available. Sdaemon threads are activated when Model 204 establishes a Janus Web Server, Janus Sockets (for server ports), Janus Specialty Data Store, Janus Open Server, or IFDIAL connection. Many RKTools products also use sdaemon threads for brief units of work. It is recommended that a site have an sdaemon thread for each concurrent connection to be maintained by a Janus product, and have at least four sdaemon threads if using any RKTools products. The SDAEMDEV parameter can be any odd number from 1 to 53. Note: Any IODEV number selected for SDAEMDEV will be unavailable for its normal function. Thus the recommended setting for SDAEMDEV is 15 (unless a site is using BTAM TTY terminals). For more information about setting up sdaemon threads, see the Sirius_Mods_Installation_Guide. | ||||||||||
| SRSDEFTO | The default timeout value (in seconds) to be used for saved record sets if none is specified on the $Web_Save_Recset function. If SRSDEFTO exceeds SRSMAXTO, SRSMAXTO will effectively act as the default timeout value. The default for SRSDEFTO is 900, which means 15 minutes. Setting SRSDEFTO to 0 means no record sets will be saved unless an explicit timeout is specified in the $Web_Save_Recset function. SRSDEFTO can be reset. | ||||||||||
| SRSMAX | Maximum number of total saved record sets in the system. This parameter defaults to 0, and it must be set to a positive value to allow use of the saved record set feature of Janus Web Server. If this parameter is 0, $Web_Save_Recset will never save a record set. The number of record sets that can actually be saved at a given time might be somewhat less than this value if many of the saved record sets are associated with groups with large numbers of members. The saved record set feature will use approximately 64*SRSMAX bytes of virtual
storage. | ||||||||||
| SRSMAXTO | Maximum length of time (in seconds) that a saved record set can be saved without being referenced. The actual maximum length of time a record set will be saved can be set in the $Web_Save_Recset function, but it will be set to SRSMAXTO if that value exceeds SRSMAXTO. Similarly if a timeout is not specified on the $Web_Save_Recset, so the timeout value is derived from SRSDEFTO, but if SRSDEFTO is greater than SRSMAXTO,
SRSMAXTO will be used as the timeout. The default for SRSMAXTO is 3600, which means a maximum timeout of one hour. SRSMAXTO can be reset. By resetting SRSMAXTO to 0, the saved record set facility is temporarily disabled, and all enqueues associated with saved record sets are freed. This can be useful in clearing up an enqueuing problem caused by a saved record set. Resetting SRSMAXTO will dynamically adjust the timeout for any record sets saved with a higher timeout value. So if there is a saved record set with a timeout of 1800 seconds when SRSMAXTO is reset to 300, that record set's timeout is updated to 300. If that record set had been saved more than 300 seconds before the reset, it would be immediately freed. | ||||||||||
| SRSMAXUS | Maximum number of saved record sets per user. This limit is a per-userid limit, and it applies even if the userid is being used from multiple web browsers. The default for SRSMAXUS is 0, which means that there is no per-user limit for saved record sets. SRSMAXUS can be used to ensure that a single user, either as the result of a programming error or simply through running frequent queries, does not monopolize the saved record set facility. SRSMAXUS can be reset. | ||||||||||
| TCPSERV | Name of the TCP/IP server address space (MVS) or virtual machine (CMS). If not specified, this parameter defaults to TCPIP. | ||||||||||
| TCPTYPE | Specifies the type of TCP/IP network to which Model 204 is connected. If you are using Janus Version 5.3 or later, you may omit this parameter and allow Janus to automatically detect the type of TCP/IP you have on your machine.
If you specify type IBM, Janus will detect and set the type of IBM interface it will use:
The valid TCPTYPE values are:
|
TCP/IP notes
- If you are using the IBM BPX TCP/IP interface, check the following APARs for PTFs that may apply to your system: OW42346, PQ24583, and OW37717. These APARs relate to SIGPIPE handling in the BPX API and can cause abends which result in immediate termination of Model 204. Also, customers have reported occasional hung threads that may be fixed by APAR PQ33040.
- Most of the communication with the TCP/IP address space is accomplished via a PST. Because of this, NSUBTKS may need to be increased by 1 before using Janus.
- If you are running z/OS V1.6 or later with Model 204 V7.5, and are using the BPX interface, TCP buffers for Janus Web ports will be allocated (if possible) in ATB storage.
Notes
- When discussing Janus Open Server applications, this manual uses the term server to refer to the Model 204 address space in general. Server program or server application is used when referring to User Language code that responds to a client request.
- The terms BATCH2 and IFDIAL are used somewhat interchangeably, because IFDIAL is used to refer to the low level routines that are used to provide BATCH2 access to Model 204.