Janus environment definition - Revision history

JAL: RKTools replaces UL/SPF

2015-10-23T22:20:42Z

RKTools replaces UL/SPF

← Older revision		Revision as of 22:20, 23 October 2015
Line 34:		Line 34:
	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.		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 <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">~~UL/SPF~~</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">~~UL/SPF~~</var> products.		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 <var>SDAEMDEV</var> parameter can be any odd number from 1 to 53.		The <var>SDAEMDEV</var> parameter can be any odd number from 1 to 53.

Tom: /* TCP/IP notes */

2014-05-15T19:11:14Z

TCP/IP notes

← Older revision		Revision as of 19:11, 15 May 2014
Line 96:		Line 96:
	<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>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, <var>NSUBTKS</var> 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, and are using the BPX interface, TCP buffers for Janus Web ports will be allocated (if possible) in ATB storage.		<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>		</li>
	</ul>		</ul>

Tom at 19:09, 15 May 2014

2014-05-15T19:09:34Z

← Older revision		Revision as of 19:09, 15 May 2014
Line 66:		Line 66:
	<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~~, then KNET. For CMS the order is IUCV, then KNET~~. You can always override auto-detection by explicitly supplying a <var>TCPTYPE</var> parameter.		<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>

Line 96:		Line 96:
	<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>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, <var>NSUBTKS</var> 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, and are using the BPX interface, TCP buffers for Janus Web ports will be allocated (if possible) in ATB storage.
			</li>
	</ul>		</ul>

JAL: /* See also */

2013-04-29T01:07:55Z

JAL2: /* References */

2012-03-19T22:28:19Z

References

← Older revision		Revision as of 22:28, 19 March 2012
Line 106:		Line 106:
	</ul>		</ul>

	==~~References~~==		==See also==

	[[Category:Janus TCP/IP Base]]		[[Category:Janus TCP/IP Base]]

JAL2 at 22:27, 19 March 2012

2012-03-19T22:27:49Z

← Older revision		Revision as of 22:27, 19 March 2012
Line 40:		Line 40:

	<tr><th><var>SRSDEFTO</var></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 <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 ~~$Web_Save_Recset]] function.~~ <var>~~SRSDEFTO~~</var> ~~can be reset~~. ~~The saved record set facility and the~~ <var>SRSDEFTO</var> ~~parameter are available in version 5.1 and later of Sirius Mods~~.</td></tr>		<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><var>SRSMAX</var></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, [[$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		<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~~. The saved record set facility and the <var>SRSMAX</var> parameter are available in version 5.1 and later of Sirius Mods~~.</td></tr>		storage. </td></tr>

	<tr><th><var>SRSMAXTO</var></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 [[$Web_Save_Recset]] 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 $~~WEB_SAVE_RECSET~~, so the timeout value is derived from <var>SRSDEFTO</var>, but if <var>SRSDEFTO</var> is greater than <var>SRSMAXTO</var>,		<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 <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.		<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>
	~~The saved record set facility and the <var>SRSMAXTO</var> parameter are available in version 5.1 and later of [[Sirius Mods]].~~</td></tr>

	<tr><th><var>SRSMAXUS</var></th>		<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>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>
	~~The saved record set facility and the <var>SRSMAXUS</var> parameter are available in version 5.1 and later of [[Sirius Mods]].~~</td></tr>

	<tr><th><var>TCPSERV</var></th>		<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 TCPIP.</td></tr>		<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><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.		<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.

	If ~~you are using Janus Version 5.5 or later, and~~ you specify type IBM, Janus will detect and set the type of IBM interface it will use:		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, then KNET. For CMS the order is IUCV, then KNET. You can always override auto-detection by explicitly supplying a TCPTYPE parameter.		<li>If multiple types are installed, Janus will select the interface in the following order for MVS: BPX, HPNS, IUCV, Interlink, then KNET. For CMS the order is IUCV, then KNET. You can always override auto-detection by explicitly supplying a <var>TCPTYPE</var> parameter.
	</ul>		</ul>

Line 96:		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>
	</ul>		</ul>

Line 103:		Line 101:

	<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 [[User Language]] code that responds to a client request.		<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>

JALWiccan: 1 revision

2012-03-19T22:15:59Z

1 revision

← Older revision	Revision as of 22:15, 19 March 2012
(No difference)

JALWiccan: 1 revision

2012-03-19T22:15:58Z

1 revision

← Older revision		Revision as of 22:15, 19 March 2012
Line 44:		Line 44:
	<tr><th><var>SRSMAX</var></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, [[$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		<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, [[$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. The saved record set facility and the SRSMAX parameter are available in version 5.1 and later of Sirius Mods.</td></tr>		storage. The saved record set facility and the <var>SRSMAX</var> parameter are available in version 5.1 and later of Sirius Mods.</td></tr>

	<tr><th><var>SRSMAXTO</var></th>		<tr><th><var>SRSMAXTO</var></th>

JALWiccan: 1 revision

2012-03-19T22:15:02Z

1 revision

← Older revision	Revision as of 22:15, 19 March 2012
(No difference)

JALWiccan: 1 revision

2012-03-19T22:15:01Z

1 revision

← Older revision		Revision as of 22:15, 19 March 2012
Line 54:		Line 54:

	<tr><th><var>SRSMAXUS</var></th>		<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 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.		<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.

	The saved record set facility and the SRSMAXUS parameter are available in version 5.1 and later of [[Sirius Mods]].</td></tr>		The saved record set facility and the <var>SRSMAXUS</var> parameter are available in version 5.1 and later of [[Sirius Mods]].</td></tr>

	<tr><th><var>TCPSERV</var></th>		<tr><th><var>TCPSERV</var></th>

← Older revision		Revision as of 01:07, 29 April 2013
Line 107:		Line 107:

	==See also==		==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]]