DTS parameter - Revision history

JAL: misc formatting

2017-08-03T19:18:31Z

misc formatting

← Older revision		Revision as of 19:18, 3 August 2017
Line 31:		Line 31:

	<ul>		<ul>
	<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only. <~~br /~~>If <~~var~~>DTS=0</~~var~~> is set in the CCAIN for the Online, it ~~will be~~ ignored and <~~var~~>DTS=1</~~var~~> ~~will be~~ assumed, and a warning message ~~will be~~ written to the audit trail.</li>		<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only.
	<li>~~When~~ you are resetting <var>DTS</var> to 0, any open files with the <var>[[~~FOPT_parameter~~\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges, or the <~~var~~>RESET DTS</~~var~~> will fail.</li>		<p>
	<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges, or the <~~var~~>OPEN FILE<~~/var~~> <~~var class="term"~~>~~filename~~</~~var~~> will fail.</li>		If <code>DTS=0</code> is set in the CCAIN for the Online, it is ignored and <code>DTS=1</code> is assumed, and a warning message is written to the audit trail.</p></li>

			<li>If you are resetting <var>DTS</var> to 0, any open files with the <var>[[FOPT parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges, or the <code>RESET DTS</code> will fail.</li>

			<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges, or the <code>OPEN FILE <i>filename</i></code> will fail.</li>
	</ul>		</ul>

Line 40:		Line 44:
	==Usage==		==Usage==
	<ul>		<ul>
	<li>If you reset DTS to 0 on your thread (for example, in a BATCH204 or BATCH2 job, or any Online thread), no date/time stamp processing ~~will occur~~ for any file accessed on this thread.		<li>If you reset <var>DTS</var> to 0 on your thread (for example, in a [[BATCH204]] or [[Program Communication facilities#BATCH2 facility\|BATCH2]] job, or any Online thread), no date/time stamp processing occurs for any file accessed on this thread. </li>

	<li>If you have file manager privileges for a date/time stamp file, you can turn DTS processing off by resetting <var>FOPT</var> to turn off the X'10' bit. This suspends date/time stamp processing for this file for all users.		<li>If you have file manager privileges for a date/time stamp file, you can turn DTS processing off by resetting <var>FOPT</var> to turn off the X'10' bit. This suspends date/time stamp processing for this file for all users.
	<p>Currently, the <var>DTS</var> parameter cannot suspend automatic date/time stamp processing for all files in an Online; that is, the DTS=1 default of the Online cannot be SET or RESET to DTS=0.</p></li>		<p>
			Currently, the <var>DTS</var> parameter cannot suspend automatic date/time stamp processing for all files in an Online; that is, the <code>DTS=1</code> default of the Online cannot be <var>SET</var> or <var>RESET</var> to <code>DTS=0</code>.</p></li>

	<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. Any attempt to open a remote date/time stamp file (<var>FOPT</var> X'10') ~~will fail~~.</li>		<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. Any attempt to open a remote date/time stamp file (<var>FOPT</var> X'10') fails.</li>
	</ul>		</ul>

ELowell: /* Usage */

2017-08-02T20:39:24Z

Usage

← Older revision		Revision as of 20:39, 2 August 2017
Line 41:		Line 41:
	<ul>		<ul>
	<li>If you reset DTS to 0 on your thread (for example, in a BATCH204 or BATCH2 job, or any Online thread), no date/time stamp processing will occur for any file accessed on this thread.		<li>If you reset DTS to 0 on your thread (for example, in a BATCH204 or BATCH2 job, or any Online thread), no date/time stamp processing will occur for any file accessed on this thread.
	<li>If you have file manager privileges for a date/time stamp file, you can turn DTS processing off by ~~stopping the file and~~ resetting <var>FOPT</var> to turn off the X'10' bit. This suspends date/time stamp processing for this file for all users.		<li>If you have file manager privileges for a date/time stamp file, you can turn DTS processing off by resetting <var>FOPT</var> to turn off the X'10' bit. This suspends date/time stamp processing for this file for all users.
	<p>Currently, the <var>DTS</var> parameter cannot suspend automatic date/time stamp processing for all files in an Online; that is, the DTS=1 default of the Online cannot be SET or RESET to DTS=0.</p></li>		<p>Currently, the <var>DTS</var> parameter cannot suspend automatic date/time stamp processing for all files in an Online; that is, the DTS=1 default of the Online cannot be SET or RESET to DTS=0.</p></li>

ELowell: /* Usage */

2017-08-02T18:56:31Z

Usage

← Older revision		Revision as of 18:56, 2 August 2017
Line 40:		Line 40:
	==Usage==		==Usage==
	<ul>		<ul>
	<li>If ~~<var>~~DTS~~</var> is~~ 0, ~~your user~~ thread ~~does~~ no date/time stamp processing on any file. ~~To turn~~ <~~var~~>~~DTS</var> processing off~~ for a file, you ~~must stop~~ the file and ~~turn off the~~ <var>FOPT</var> X'10' bit. This suspends date/time stamp processing for this file for all users.		<li>If you reset DTS to 0 on your thread (for example, in a BATCH204 or BATCH2 job, or any Online thread), no date/time stamp processing will occur for any file accessed on this thread.
	<p>		<li>If you have file manager privileges for a date/time stamp file, you can turn DTS processing off by stopping the file and resetting <var>FOPT</var> to turn off the X'10' bit. This suspends date/time stamp processing for this file for all users.
	Currently, ~~there is no feature that can~~ suspend date/time processing for ~~some~~ files ~~for some users~~, or ~~suspend date/time processing for all users~~.</p></li>		<p>Currently, the <var>DTS</var> parameter cannot suspend automatic date/time stamp processing for all files in an Online; that is, the DTS=1 default of the Online cannot be SET or RESET to DTS=0.</p></li>

	<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. Any attempt to open a remote date/time stamp file (<var>FOPT</var> X'10') will fail.</li>		<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. Any attempt to open a remote date/time stamp file (<var>FOPT</var> X'10') will fail.</li>

ELowell: /* Description */

2017-08-02T16:14:48Z

Description

← Older revision		Revision as of 16:14, 2 August 2017
Line 31:		Line 31:

	<ul>		<ul>
	<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only. If <var>DTS=0</var> is set in the CCAIN for the Online, it will be ignored and <var>DTS=1</var> will be assumed.		<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only. <br />If <var>DTS=0</var> is set in the CCAIN for the Online, it will be ignored and <var>DTS=1</var> will be assumed, and a warning message will be written to the audit trail.</li>
	<li>When you are resetting <var>DTS</var> to 0, any open files with the <var>[[FOPT_parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges, or the <var>RESET DTS</var> will fail.		<li>When you are resetting <var>DTS</var> to 0, any open files with the <var>[[FOPT_parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges, or the <var>RESET DTS</var> will fail.</li>
	<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges, or the <var>OPEN FILE</var> <var class="term">filename</var> will fail.		<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges, or the <var>OPEN FILE</var> <var class="term">filename</var> will fail.</li>
	</ul>		</ul>

ELowell: /* Usage */

2017-08-01T22:02:32Z

Usage

← Older revision		Revision as of 22:02, 1 August 2017
Line 42:		Line 42:
	<li>If <var>DTS</var> is 0, your user thread does no date/time stamp processing on any file. To turn <var>DTS</var> processing off for a file, you must stop the file and turn off the <var>FOPT</var> X'10' bit. This suspends date/time stamp processing for this file for all users.		<li>If <var>DTS</var> is 0, your user thread does no date/time stamp processing on any file. To turn <var>DTS</var> processing off for a file, you must stop the file and turn off the <var>FOPT</var> X'10' bit. This suspends date/time stamp processing for this file for all users.
	<p>		<p>
	Currently, there is no feature that can suspend date/time processing for some files for some users.</p></li>		Currently, there is no feature that can suspend date/time processing for some files for some users, or suspend date/time processing for all users.</p></li>

	<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. Any attempt to open a remote date/time stamp file (<var>FOPT</var> X'10') will fail.</li>		<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. Any attempt to open a remote date/time stamp file (<var>FOPT</var> X'10') will fail.</li>

ELowell: /* Description */

2017-08-01T21:58:37Z

Description

← Older revision		Revision as of 21:58, 1 August 2017
Line 16:		Line 16:
	==Description==		==Description==
	<p>		<p>
	Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. System managers can reset <var>DTS</var> to 0 to disable automatic date/time stamps. When DTS is 0, if you have file manager privileges, you can update a DTSFN field with values of your choosing.</p>		Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. System managers can reset <var>DTS</var> to 0 to disable automatic date/time stamps. When <var>DTS</var> is 0, if you have file manager privileges, you can update a <var>DTSFN</var> field with values of your choosing.</p>

	<table>		<table>
Line 31:		Line 31:

	<ul>		<ul>
	<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only.		<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only. If <var>DTS=0</var> is set in the CCAIN for the Online, it will be ignored and <var>DTS=1</var> will be assumed.
	<li>When you are resetting <var>DTS</var> to 0, any open files with the <var>[[FOPT_parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges, or the RESET DTS will fail.		<li>When you are resetting <var>DTS</var> to 0, any open files with the <var>[[FOPT_parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges, or the <var>RESET DTS</var> will fail.
	<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges, or the OPEN FILE <var class="term">filename</var> will fail.		<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges, or the <var>OPEN FILE</var> <var class="term">filename</var> will fail.
	</ul>		</ul>

	<p class="note"><b>Note:</b> During <var>[[FLOD command\|FLOD]]</var>/<var>[[FILELOAD command\|FILELOAD]]</var>, the DTS field, if one is defined to the file, is not updated. This means that a new DTS field defined as part of a file reorganization will not have a value calculated during the reorganization. Existing DTS fields are only added from TAPEI input, and they are not automatically updated by the DTS feature.</p>		<p class="note"><b>Note:</b> During <var>[[FLOD command\|FLOD]]</var>/<var>[[FILELOAD command\|FILELOAD]]</var>, the <var>DTS</var> field, if one is defined to the file, is not updated. This means that a new <var>DTS</var> field defined as part of a file reorganization will not have a value calculated during the reorganization. Existing <var>DTS</var> fields are only added from TAPEI input, and they are not automatically updated by the DTS feature.</p>

	==Usage==		==Usage==

ELowell: /* Usage */

2017-08-01T21:51:30Z

Usage

← Older revision		Revision as of 21:51, 1 August 2017
Line 44:		Line 44:
	Currently, there is no feature that can suspend date/time processing for some files for some users.</p></li>		Currently, there is no feature that can suspend date/time processing for some files for some users.</p></li>

	<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. ~~If you~~ attempt a remote ~~open of a data~~/time stamp file (<var>FOPT</var> X'10' ~~included~~)~~, the following message is issued:~~		<li><var>DTS</var> is not supported under [[PQO\|Parallel Query Option]]. Any attempt to open a remote date/time stamp file (<var>FOPT</var> X'10') will fail.</li>
	~~<p class="code">M204~~.~~1977: %F MAY NOT BE ACCESSED REMOTELY </p>~~</li>
	</ul>		</ul>

ELowell: /* Description */

2017-08-01T21:44:22Z

Description

← Older revision		Revision as of 21:44, 1 August 2017
Line 16:		Line 16:
	==Description==		==Description==
	<p>		<p>
	Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. System managers can reset <var>DTS</var> to ~~zero~~ to disable automatic date/time stamps. When DTS is ~~zero~~, you can update a DTSFN field with values of your choosing.</p>		Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. System managers can reset <var>DTS</var> to 0 to disable automatic date/time stamps. When DTS is 0, if you have file manager privileges, you can update a DTSFN field with values of your choosing.</p>

	<table>		<table>
Line 32:		Line 32:
	<ul>		<ul>
	<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only.		<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only.
	<li>When <var>DTS</var> ~~is reset~~ to 0, any open files with the <var>[[FOPT_parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges.		<li>When you are resetting <var>DTS</var> to 0, any open files with the <var>[[FOPT_parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges, or the RESET DTS will fail.
	<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges.		<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges, or the OPEN FILE <var class="term">filename</var> will fail.
	</ul>		</ul>

ELowell: /* Description */

2017-08-01T20:07:20Z

Description

← Older revision		Revision as of 20:07, 1 August 2017
Line 16:		Line 16:
	==Description==		==Description==
	<p>		<p>
	Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. ~~As a system manager, you~~ can reset <var>DTS</var> to zero to disable automatic date/time stamps. When DTS is zero, you can update a DTSFN field with values of your choosing.</p>		Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. System managers can reset <var>DTS</var> to zero to disable automatic date/time stamps. When DTS is zero, you can update a DTSFN field with values of your choosing.</p>

	<table>		<table>

ELowell: /* Description */

2017-08-01T20:02:48Z

Description

← Older revision		Revision as of 20:02, 1 August 2017
Line 16:		Line 16:
	==Description==		==Description==
	<p>		<p>
	Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. A system manager can reset <var>DTS</var> to zero to disable automatic date/time stamps. ~~Turning off the date/time stamp feature does not imply that~~ you ~~cannot~~ update ~~any field, including the date/time stamp field; it simply stops automatic updates to the date/time stamp~~ field.</p>		Enables [[Adding a date-time stamp field#Overview of the date-time stamp feature\|date/time stamp processing]] when set to 1. As a system manager, you can reset <var>DTS</var> to zero to disable automatic date/time stamps. When DTS is zero, you can update a DTSFN field with values of your choosing.</p>

	<table>		<table>
Line 30:		Line 30:
	</table>		</table>

	<p>		<ul>
	~~The~~ <var>DTS</var> parameter ~~may be~~ reset only ~~by a user with system manager privileges~~. ~~In addition~~, the ~~user must have file manager privileges for any DTS-enabled (~~<var>[[~~FOPT parameter~~\|FOPT]]</var> X'10'~~) files~~ opened~~, either before or after~~ <var>DTS</var> is ~~reset to~~ 0~~. Turning off the~~ <var>~~DTS~~</var> ~~parameter affects updates only to date/time stamp~~ files~~, so no special restrictions were placed on the~~ file ~~with no date/time stamp~~.</p>		<li>You must be a system manager to reset the <var>DTS</var> parameter. You can reset <var>DTS</var> for your thread only.
			<li>When <var>DTS</var> is reset to 0, any open files with the <var>[[FOPT_parameter\|FOPT]]</var> parameter X'10' bit on must have been opened with file manager privileges.
			<li>If the value of the <var>DTS</var> parameter is 0 on a thread, subsequent opens of <var>FOPT</var> X'10' files must obtain file manager privileges.
			</ul>

	<p class="note"><b>Note:</b> During <var>[[FLOD command\|FLOD]]</var>/<var>[[FILELOAD command\|FILELOAD]]</var>, the DTS field, if one is defined to the file, is not updated. This means that a new DTS field defined as part of a file reorganization will not have a value calculated during the reorganization. Existing DTS fields are only added from TAPEI input, and they are not automatically updated by the DTS feature.</p>		<p class="note"><b>Note:</b> During <var>[[FLOD command\|FLOD]]</var>/<var>[[FILELOAD command\|FILELOAD]]</var>, the DTS field, if one is defined to the file, is not updated. This means that a new DTS field defined as part of a file reorganization will not have a value calculated during the reorganization. Existing DTS fields are only added from TAPEI input, and they are not automatically updated by the DTS feature.</p>