FUNPARM parameter - Revision history

JAL: /* Description */ typo

2016-03-29T17:49:01Z

Description: typo

← Older revision		Revision as of 17:49, 29 March 2016
Line 15:		Line 15:

	==Description==		==Description==
	This is a bitmask parameter that controls the behavior of the <var class="product">[[Fast/Unload SOUL Interface]]</var>, where the bits mean:		This is a bitmask parameter that controls the behavior of the <var class="product">[[Fast/Unload SOUL Interface]]</var> (FUSI), where the bits mean:
	<table class="thJustBold">		<table class="thJustBold">
	<tr><th>X'01'</th>		<tr><th>X'01'</th>
	<td>Indicates that a synchronous <var class="product">[[Fast/Unload]]</var> request is not to be allowed while an updating transaction is active.		<td>Indicates that a synchronous <var class="product">[[Fast/Unload]]</var> request is not to be allowed while an updating transaction is active. This is to prevent a <var class="product">Fast/Unload</var> request that might take a long time to complete from being run while a user has resources enqueued for an updating
	This is to prevent a <var class="product">Fast/Unload</var> request that might take a long time to complete from being run while a user has resources enqueued for an updating
	transaction. These resources would, of course, include the blocking of checkpoints if		transaction. These resources would, of course, include the blocking of checkpoints if
	subtransaction checkpoints are not being used.		subtransaction checkpoints are not being used.

JAL: misc cleanup

2015-04-16T14:26:32Z

misc cleanup

← Older revision		Revision as of 14:26, 16 April 2015
Line 42:		Line 42:
	</table>		</table>

			===Using the X'02', X'04', and X'08' bits===
	For both of the <var>FUNPARM</var> X'02' and X'04' bits, the same bit has the same meaning (for an individual user) in the <var>[[FUNPRMU parameter\|FUNPRMU]]</var> user parameter; the indicated effect takes place if either of the <var>FUNPRMU</var> or <var>FUNPARM</var> bits are on.		For both of the <var>FUNPARM</var> X'02' and X'04' bits, the same bit has the same meaning (for an individual user) in the <var>[[FUNPRMU parameter\|FUNPRMU]]</var> user parameter; the indicated effect takes place if either of the <var>FUNPRMU</var> or <var>FUNPARM</var> bits are on.
	That is also true for the X'08' bit, although there are some additional details for the X'08' bit which generally you don't need		That is also true for the X'08' bit, although there are some additional details for the X'08' bit which generally you don't need
Line 47:		Line 48:
	[[FUNPRMU parameter#Fast/Unload report processing\|Fast/Unload report processing discussion]].		[[FUNPRMU parameter#Fast/Unload report processing\|Fast/Unload report processing discussion]].

	The X'02', X'04', and X'08' bits of this parameter, together with the same bits of <var>FUNPRMU</var>,		The X'02', X'04', and X'08' bits of this parameter, together with the same bits of <var>FUNPRMU</var>, control the auditing of messages when using the <var class="product">Fast/Unload SOUL Interface</var>.
	control the auditing of messages when using the <var class="product">Fast/Unload SOUL Interface</var>.		These parameters can be used to augment the availability of auditing information, in such a way that the user or the system manager can ensure that information is available for a single job or all jobs, without changes to any SOUL program invoking <var>[[FastUnload (Recordset function)\|FastUnload]]</var>, <var>[[FastUnloadTask (Recordset function)\|FastUnloadTask]]</var>, or <var>[[$Funload]]</var>.
	These parameters can be used to augment the availability of auditing information, in such a way that the user or the system manager can		Without the use of these parameters, some auditing information may be available from the <code>FUNAUDIT</code> dataset, but that information may be inadequate:
	ensure that information is available for a single job or all jobs, without changes to any SOUL		for example, messages from a <var>FastUnload</var> job will not be in <code>FUNAUDIT</code> if the <var>Report</var> parameter is specified.
	program invoking <var>[[FastUnload (Recordset function)\|FastUnload]]</var>, <var>[[FastUnloadTask (Recordset function)\|FastUnloadTask]]</var>, or <var>[[$Funload]]</var>.
	Without the use of these parameters,
	some auditing information may be available from the <code>FUNAUDIT</code> dataset, but that information may be inadequate:
	for example, messages from a <var>FastUnload</var> job will not be in <code>FUNAUDIT</code> if the <var>Report</var> parameter is ~~used~~.

	The X'02', X'04', and X'08' bits ~~are~~ new in version 8.1 of the <var class="product">Sirius Mods</var>, and these bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.		<p class="note"><b>Note:</b> The X'02', X'04', and X'08' bits were new in version 8.1 of the <var class="product">Sirius Mods</var>, and these bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>. </p>

	Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|Fast/Unload report processing discussion]].		Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward, and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|Fast/Unload report processing discussion]].

	[[Category:System parameters]]		[[Category:System parameters]]
	[[Category:Parameters]]		[[Category:Parameters]]
	[[Category:Fast/Unload SOUL Interface]]		[[Category:Fast/Unload SOUL Interface]]

JAL: UL Interface becomes SOUL Interface

2015-03-16T21:18:55Z

UL Interface becomes SOUL Interface

← Older revision		Revision as of 21:18, 16 March 2015
Line 9:		Line 9:
	<dd>System manager resettable		<dd>System manager resettable
	<dt>Related products		<dt>Related products
	<dd>[[Fast/Unload\|Fast/Unload ~~User Language~~ Interface]]		<dd>[[Fast/Unload\|Fast/Unload SOUL Interface]]
	<dt>Introduced		<dt>Introduced
	<dd><var class="product">[[Sirius Mods]]</var> 6.7		<dd><var class="product">[[Sirius Mods]]</var> 6.7
Line 15:		Line 15:

	==Description==		==Description==
	This is a bitmask parameter that controls the behavior of the <var class="product">[[Fast/Unload ~~User Language~~ Interface]]</var>,		This is a bitmask parameter that controls the behavior of the <var class="product">[[Fast/Unload SOUL Interface]]</var>, where the bits mean:
	where the bits mean:		<table class="thJustBold">
	<dl>		<tr><th>X'01'</th>
	<dt>X'01'		<td>Indicates that a synchronous <var class="product">[[Fast/Unload]]</var> request is not to be allowed while an updating transaction is active.
	<dd>Indicates that a synchronous [[Fast/Unload]] request is not to be allowed while		This is to prevent a <var class="product">Fast/Unload</var> request that might take a long time to complete from being run while a user has resources enqueued for an updating
	an updating transaction is active.		transaction. These resources would, of course, include the blocking of checkpoints if
	This is to prevent a <var class="product">Fast/Unload</var> request that might take a long time to
	complete from being run while a user has resources enqueued for an updating
	transaction.
	These resources would, of course, include the blocking of checkpoints if
	subtransaction checkpoints are not being used.		subtransaction checkpoints are not being used.
			<p>
	If the X'01' bit is set, and a thread attempts a synchronous <var class="product">Fast/Unload ~~User Language~~ Interface</var>		If the X'01' bit is set, and a thread attempts a synchronous <var class="product">Fast/Unload SOUL Interface</var> request (either via <var>$Funload</var> or the <var>[[FastUnload (Recordset function)\|FastUnload]]</var> method of the <var>Recordset</var> class)
	request (either via <var>$Funload</var> or the <var>[[FastUnload (Recordset function)\|FastUnload]]</var> method of the <var>Recordset</var> class)		in the middle of an updating transaction, the transaction will be cancelled with a message like the following: </p>
	in the middle of an updating transaction, the transaction will be cancelled
	with a message like the following:
	<p class="code">CANCELLING REQUEST: MSIR.0561: $FUNLOAD: Synchronous request during		<p class="code">CANCELLING REQUEST: MSIR.0561: $FUNLOAD: Synchronous request during
	update transaction in line 43, procedure FUNTEST,		update transaction in line 43, procedure FUNTEST,
	file ALEXPROC </p>		file ALEXPROC </p></td></tr>
	<dt>X'02'
	<dd>Indicates that "basic"		<tr><th>X'02'</th>
	<var class="product">Fast/Unload</var>		<td>Indicates that "basic" <var class="product">Fast/Unload</var> messages for all users are always audited, regardless of the presence of a <var class="product">Fast/Unload SOUL Interface</var> "report" argument.</td></tr>
	messages for all users are always audited, regardless of the presence of
	a <var class="product">Fast/Unload ~~User Language~~ Interface</var>		<tr><th>X'04'</th>
	"report" argument.		<td>Indicates that <b>all</b> <var class="product">Fast/Unload</var> messages for all users, except "Field statistics", are always audited, regardless of the presence of a
	<dt>X'04'		<var class="product">Fast/Unload SOUL Interface</var> "report" argument. The X'02' bit need not be set if the X'04' bit is set.</td></tr>
	<dd>Indicates that <b>all</b> <var class="product">Fast/Unload</var> messages for all users, except "Field statistics",
	are always audited, regardless of the presence of a		<tr><th>X'08'</th>
	<var class="product">Fast/Unload ~~User Language~~ Interface</var>		<td>Indicates that "basic" <var class="product">Fast/Unload</var> messages for all users are always audited in the <var class="product">Model 204</var> audit trail, whether or not the <code>FUNAUDIT</code> DD name is present. If the X'04' bit is on, <b>all</b> messages are audited there as well.
	"report" argument.		<p>
	The X'02' bit need not be set if the X'04' bit is set.		In the odd case that there is no <var class="product">Model 204</var> audit trail, the X'08' bit is ignored, but auditing is performed as if the X'02' bit were on, whether it is or not.</p></td></tr>
	<dt>X'08'		</table>
	<dd>Indicates that "basic"
	<var class="product">Fast/Unload</var>
	messages for all users are always audited in the
	<var class="product">Model 204</var> audit trail, whether or not the <code>FUNAUDIT</code> DD name is present.
	If the X'04' bit is on, <b>all</b> messages are audited there as well.

	In the odd case that there is no <var class="product">Model 204</var> audit trail, the X'08' bit is ignored, but auditing is
	performed as if the X'02' bit were on, whether it is or not.
	</dl>

	For both of the <var>FUNPARM</var> X'02' and X'04' bits, the same bit has the same meaning (for an individual user) in the <var>[[FUNPRMU parameter\|FUNPRMU]]</var> user parameter; the indicated effect takes place if either of the <var>FUNPRMU</var> or <var>FUNPARM</var> bits are on.		For both of the <var>FUNPARM</var> X'02' and X'04' bits, the same bit has the same meaning (for an individual user) in the <var>[[FUNPRMU parameter\|FUNPRMU]]</var> user parameter; the indicated effect takes place if either of the <var>FUNPRMU</var> or <var>FUNPARM</var> bits are on.
Line 63:		Line 48:

	The X'02', X'04', and X'08' bits of this parameter, together with the same bits of <var>FUNPRMU</var>,		The X'02', X'04', and X'08' bits of this parameter, together with the same bits of <var>FUNPRMU</var>,
	control the auditing of messages when using the <var class="product">Fast/Unload ~~User Language~~ Interface</var>.		control the auditing of messages when using the <var class="product">Fast/Unload SOUL Interface</var>.
	These parameters can be used to augment the availability of auditing information, in such a way that the user or the system manager can		These parameters can be used to augment the availability of auditing information, in such a way that the user or the system manager can
	ensure that information is available for a single job or all jobs, without changes to any ~~User Language~~		ensure that information is available for a single job or all jobs, without changes to any SOUL
	program invoking <var>[[FastUnload (Recordset function)\|FastUnload]]</var>, <var>[[FastUnloadTask (Recordset function)\|FastUnloadTask]]</var>, or <var>[[$Funload]]</var>.		program invoking <var>[[FastUnload (Recordset function)\|FastUnload]]</var>, <var>[[FastUnloadTask (Recordset function)\|FastUnloadTask]]</var>, or <var>[[$Funload]]</var>.
	Without the use of these parameters,		Without the use of these parameters,
	some auditing information may be available from the <code>FUNAUDIT</code> dataset, but that information may be inadequate:		some auditing information may be available from the <code>FUNAUDIT</code> dataset, but that information may be inadequate:
	for example, messages from a <var>FastUnload</var> job will not be in <code>FUNAUDIT</code> if the		for example, messages from a <var>FastUnload</var> job will not be in <code>FUNAUDIT</code> if the <var>Report</var> parameter is used.
	<var>Report</var> parameter is used.

	The X'02', X'04', and X'08' bits are new in version 8.1 of the <var class="product">Sirius Mods</var>, and these bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.		The X'02', X'04', and X'08' bits are new in version 8.1 of the <var class="product">Sirius Mods</var>, and these bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.
Line 78:		Line 62:
	[[Category:System parameters]]		[[Category:System parameters]]
	[[Category:Parameters]]		[[Category:Parameters]]
	[[Category:Fast/Unload ~~User Language~~ Interface]]		[[Category:Fast/Unload SOUL Interface]]

JAL at 18:41, 11 November 2014

2014-11-11T18:41:24Z

JAL: /* Description */

2013-10-15T21:59:11Z

Description

← Older revision		Revision as of 21:59, 15 October 2013
Line 30:		Line 30:
	in the middle of an updating transaction, the transaction will be cancelled		in the middle of an updating transaction, the transaction will be cancelled
	with a message like the following:		with a message like the following:
	CANCELLING REQUEST: MSIR.0561: $FUNLOAD: Synchronous request during		<p class="code">CANCELLING REQUEST: MSIR.0561: $FUNLOAD: Synchronous request during
	update transaction in line 43, procedure FUNTEST,		update transaction in line 43, procedure FUNTEST,
	file ALEXPROC		file ALEXPROC </p>
	<dt>X'02'		<dt>X'02'
	<dd>Indicates that "basic"		<dd>Indicates that "basic"

DmeWiccan: Automatically generated page update

2013-08-27T16:28:11Z

Automatically generated page update

← Older revision		Revision as of 16:28, 27 August 2013
Line 1:		Line 1:
			{{Template:FUNPARM parameter subtitle}}
	==Summary==		==Summary==
	<dl>		<dl>

JALWiccan: Automatically generated page update

2013-04-19T17:43:08Z

Automatically generated page update

← Older revision		Revision as of 17:43, 19 April 2013
Line 10:		Line 10:
	<dd>[[Fast/Unload\|Fast/Unload User Language Interface]]		<dd>[[Fast/Unload\|Fast/Unload User Language Interface]]
	<dt>Introduced		<dt>Introduced
	<dd><var class="product">Sirius Mods</var> 6.7		<dd><var class="product">[[Sirius Mods]]</var> 6.7
	</dl>		</dl>
	==Description==		==Description==

Dme at 18:02, 6 November 2012

2012-11-06T18:02:57Z

← Older revision		Revision as of 18:02, 6 November 2012
Line 70:		Line 70:
	<var>Report</var> parameter is used.		<var>Report</var> parameter is used.

	The X'02', X'04', and X'08' bits are new in version 8.1 of the <var class="product">Sirius Mods</var>, and ~~thes~~ bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.		The X'02', X'04', and X'08' bits are new in version 8.1 of the <var class="product">Sirius Mods</var>, and these bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.

	Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|"Fast/Unload report processing discussion"]].		Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|"Fast/Unload report processing discussion"]].

Dme: /* Description */

2012-11-01T21:17:34Z

Description

← Older revision		Revision as of 21:17, 1 November 2012
Line 69:		Line 69:
	for example, messages from a <var>FastUnload</var> job will not be in <code>FUNAUDIT</code> if the		for example, messages from a <var>FastUnload</var> job will not be in <code>FUNAUDIT</code> if the
	<var>Report</var> parameter is used.		<var>Report</var> parameter is used.

			The X'02', X'04', and X'08' bits are new in version 8.1 of the <var class="product">Sirius Mods</var>, and thes bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.

	Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|"Fast/Unload report processing discussion"]].		Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|"Fast/Unload report processing discussion"]].

Dme: /* Description */

2012-11-01T21:10:49Z

Description

← Older revision		Revision as of 21:10, 1 November 2012
Line 39:		Line 39:
	"report" argument.		"report" argument.
	<dt>X'04'		<dt>X'04'
	<dd>Indicates that <b>all</b> <var class="product">Fast/Unload</var> messages for all users, except "Field statistics"		<dd>Indicates that <b>all</b> <var class="product">Fast/Unload</var> messages for all users, except "Field statistics",
	~~and <var>REPORT</var> statement lines~~,
	are always audited, regardless of the presence of a		are always audited, regardless of the presence of a
	<var class="product">Fast/Unload User Language Interface</var>		<var class="product">Fast/Unload User Language Interface</var>

← Older revision		Revision as of 18:41, 11 November 2014
Line 13:		Line 13:
	<dd><var class="product">[[Sirius Mods]]</var> 6.7		<dd><var class="product">[[Sirius Mods]]</var> 6.7
	</dl>		</dl>

	==Description==		==Description==
	This is a bitmask parameter that controls the behavior of the <var class="product">[[Fast/Unload User Language Interface]]</var>,		This is a bitmask parameter that controls the behavior of the <var class="product">[[Fast/Unload User Language Interface]]</var>,
Line 20:		Line 21:
	<dd>Indicates that a synchronous [[Fast/Unload]] request is not to be allowed while		<dd>Indicates that a synchronous [[Fast/Unload]] request is not to be allowed while
	an updating transaction is active.		an updating transaction is active.
	This is to prevent a ''Fast/Unload'' request that might take a long time to		This is to prevent a <var class="product">Fast/Unload</var> request that might take a long time to
	complete from being run while a user has resources enqueued for an updating		complete from being run while a user has resources enqueued for an updating
	transaction.		transaction.
Line 26:		Line 27:
	subtransaction checkpoints are not being used.		subtransaction checkpoints are not being used.

	If the X'01' bit is set, and a thread attempts a synchronous ''Fast/Unload User Language Interface''		If the X'01' bit is set, and a thread attempts a synchronous <var class="product">Fast/Unload User Language Interface</var>
	request (either via $Funload or the [[FastUnload (Recordset function)\|FastUnload ~~method~~]] of the Recordset class)		request (either via <var>$Funload</var> or the <var>[[FastUnload (Recordset function)\|FastUnload]]</var> method of the <var>Recordset</var> class)
	in the middle of an updating transaction, the transaction will be cancelled		in the middle of an updating transaction, the transaction will be cancelled
	with a message like the following:		with a message like the following:
Line 59:		Line 60:
	That is also true for the X'08' bit, although there are some additional details for the X'08' bit which generally you don't need		That is also true for the X'08' bit, although there are some additional details for the X'08' bit which generally you don't need
	to concern yourself with, but are explained as part of the more detailed		to concern yourself with, but are explained as part of the more detailed
	[[FUNPRMU parameter#Fast/Unload report processing\|"Fast/Unload report processing discussion"]].		[[FUNPRMU parameter#Fast/Unload report processing\|Fast/Unload report processing discussion]].

	The X'02', X'04', and X'08' bits of this parameter, together with the same bits of <var>FUNPRMU</var>,		The X'02', X'04', and X'08' bits of this parameter, together with the same bits of <var>FUNPRMU</var>,
Line 73:		Line 74:
	The X'02', X'04', and X'08' bits are new in version 8.1 of the <var class="product">Sirius Mods</var>, and these bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.		The X'02', X'04', and X'08' bits are new in version 8.1 of the <var class="product">Sirius Mods</var>, and these bits are ignored without the corresponding feature introduced in version 4.7 of <var class="product">Fast/Unload</var>.

	Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|"Fast/Unload report processing discussion"]].		Using the X'02', X'04', and X'08' bits of these parameters is fairly straightforward and the above description should be adequate to use them. A complete description of the processing triggered by these bits is presented in the [[FUNPRMU parameter#Fast/Unload report processing\|Fast/Unload report processing discussion]].

	[[Category:System parameters]]		[[Category:System parameters]]
	[[Category:Parameters]]		[[Category:Parameters]]
	[[Category:Fast/Unload User Language Interface]]		[[Category:Fast/Unload User Language Interface]]