ENQCTL command - Revision history

JAL: misc cleanup

2016-04-04T21:46:54Z

misc cleanup

JAL: /* Syntax */

2014-10-21T15:09:24Z

Syntax

← Older revision		Revision as of 15:09, 21 October 2014
Line 7:		Line 7:
	</dl>		</dl>
	==Syntax==		==Syntax==
	<p class="syntax">ENQCTL <i>filename</i>		<p class="syntax">ENQCTL <span class="term">filename</span>
	[<i>sysid</i> [<i>jobname</i> [stepname [<i>date</i> [<i>time</i>]]]]]		[<span class="term">sysid</span> [<span class="term">jobname</span> [<span class="term">stepname</span> [<span class="term">date</span> [<span class="term">time</span>]]]]]
	</p>		</p>

Line 15:		Line 15:
	<tr>		<tr>
	<th>filename</th>		<th>filename</th>
	<td> ~~is the~~ name of the file to be examined or modified. The file need not be open. If only a file name is specified, all list entries for the file are displayed.</td>		<td>The name of the file to be examined or modified. The file need not be open. If only a file name is specified, all list entries for the file are displayed.
			<p class="note"><b>Note:</b>
			<var class="term">filename</var> cannot be <code>CCATEMP</code>.</p></td>
	</tr>		</tr>

	<tr>		<tr>
	<th>sysid</th>		<th>sysid</th>
	<td> ~~is the~~ System Management Facility (SMF) system ID for entries to be deleted from the enqueuing list.</td>		<td>The System Management Facility (SMF) system ID for entries to be deleted from the enqueuing list.</td>
	</tr>		</tr>

	<tr>		<tr>
	<th>jobname</th>		<th>jobname</th>
	<td> ~~specifies the~~ job name for entries to be deleted from the enqueuing list on a z/OS or z/VSE operating system or the USERID on a CMS system.</td>		<td>The job name for entries to be deleted from the enqueuing list on a z/OS or z/VSE operating system or the USERID on a CMS system.</td>
	</tr>		</tr>

	<tr>		<tr>
	<th>stepname</th>		<th>stepname</th>
	<td> ~~specifies the~~ step name for entries to be deleted from the enqueuing list on a z/OS or z/VSE operating system or the CPU ID on a CMS system.</td>		<td>The step name for entries to be deleted from the enqueuing list on a z/OS or z/VSE operating system or the CPU ID on a CMS system.</td>
	</tr>		</tr>

	<tr>		<tr>
	<th>date</th>		<th>date</th>
	<td> ~~is the~~ date for entries to be deleted from the enqueuing list; the format of the date is yy.ddd.</td>		<td>The date for entries to be deleted from the enqueuing list; the format of the date is yy.ddd.</td>
	</tr>		</tr>

	<tr>		<tr>
	<th>time</th>		<th>time</th>
	<td> ~~is the~~ time for entries to be deleted from the enqueuing list in the format hh:mm:ss.</td>		<td>The time for entries to be deleted from the enqueuing list in the format hh:mm:ss.</td>
	</tr>		</tr>

	</table>		</table>
	~~===Syntax notes===~~
	~~The filename keyword cannot be CCATEMP.~~
	==Example==		==Example==
	The following example removes all enqueuing list entries from CENSUS that were added by jobs running on system S133; this might be done in case of a system crash on system S133:		The following example removes all enqueuing list entries from CENSUS that were added by jobs running on system S133; this might be done in case of a system crash on system S133:

JAL at 02:00, 8 March 2013

2013-03-08T02:00:47Z

← Older revision		Revision as of 02:00, 8 March 2013
Line 101:		Line 101:
	</ul>		</ul>
	[[Category: System administrator commands]]		[[Category: System administrator commands]]
			[[Category: Operator commands]]
	[[Category:Commands]]		[[Category:Commands]]

Alex: Automatically generated page update

2013-02-28T01:04:59Z

Automatically generated page update

New page

==Summary==
<dl>
<dt>Privileges
<dd>System administrator or operator
<dt>Function
<dd>Examines or modifies the status of a <var class="product">Model 204</var> file enqueuing list
</dl>
==Syntax==
ENQCTL filename
[sysid [jobname [stepname [date [time]]]]]


Where:
<table>
<tr>
<th>filename</th>
<td> is the name of the file to be examined or modified. The file need not be open. If only a file name is specified, all list entries for the file are displayed.</td>
</tr>

<tr>
<th>sysid</th>
<td> is the System Management Facility (SMF) system ID for entries to be deleted from the enqueuing list.</td>
</tr>

<tr>
<th>jobname</th>
<td> specifies the job name for entries to be deleted from the enqueuing list on a z/OS or z/VSE operating system or the USERID on a CMS system.</td>
</tr>

<tr>
<th>stepname</th>
<td> specifies the step name for entries to be deleted from the enqueuing list on a z/OS or z/VSE operating system or the CPU ID on a CMS system.</td>
</tr>

<tr>
<th>date</th>
<td> is the date for entries to be deleted from the enqueuing list; the format of the date is yy.ddd.</td>
</tr>

<tr>
<th>time</th>
<td> is the time for entries to be deleted from the enqueuing list in the format hh:mm:ss.</td>
</tr>

</table>
===Syntax notes===
The filename keyword cannot be CCATEMP.
==Example==
The following example removes all enqueuing list entries from CENSUS that were added by jobs running on system S133; this might be done in case of a system crash on system S133:
ENQCTL CENSUS S133

==Usage notes==
The ENQCTL command examines or modifies the status of a file's enqueuing list. The enqueuing list, contained in each file, is a list of jobs that have control of the file.
<ul>
<li>
When you issue an ENQCTL command with only a filename, <var class="product">Model 204</var> displays all the enqueue list entries with their options data for the file.
</li>

<li>
If any arguments are given, all of the entries that satisfy the arguments are deleted. For example, if a system crash occurs for system S133, the operator at another system can issue the command:
ENQCTL filename S133

Indiscriminate use of ENQCTL might affect the integrity of a shared DASD by removing list entries for active systems or jobs. When a file is closed, the <var class="product">Model 204</var> job must remove its enqueuing list entry. If the correct entry cannot be found, the operator receives an error message in the following form: 
*** M204.0585: SHARED DASD ENQ LIST OVERLAID FOR filename AT hh:mm:ss ON yy:ddd

where the date and time identify the most recent update of the file. 
</li>
</ul>
====Handling z/VM stepnames====
Under z/VM, the part of an enqueue entry referred to as the stepname is actually the CPUID. Prior to <var class="product">Model 204</var> V6R1.0, if the CPUID contained unprintable characters-as is commonly the case-you could not specify the CPUID as the stepname on the ENQCTL command. In V6R1.0, you can.
The ENQCTL command, with no options, displays the first eight entries in the SHARED DASD enqueue list. Previously, the stepname was displayed as 1-8 characters. Now, if the stepname is printable, it is displayed as before. Otherwise, if the stepname contains unprintable characters, it is displayed in hexadecimal.
====Deleting entries in the ENQCTL list====
The ENQCTL command, with options, deletes all matching entries in the SHARED DASD enqueue list. With this enhancement, you can specify the stepname as before, if the stepname is printable: otherwise, in hexadecimal. To specify a stepname in hexadecimal, use the format output by the ENQCTL command in display mode: the 2 characters X plus a single quotation mark (X'), followed by exactly 16 hexadecimal digits (0-F) followed by a single quotation mark (').
Since the stepname can be up to 8 characters, when it is expressed as a sequence of hexadecimal codes, it is displayed as 19 characters. Hence the format of entries displayed by the ENQCTL command has changed slightly-the date and time are now 11 columns further to the right.
<var class="product">Model 204</var> message M204.0588 was changed to the following formats: 
M204.0588: ZOS EXCL jjjjjjjj ssssssss yy.ddd hh:mm:ss
M204.0588: CMS EXCL jjjjjjjj X'ssssssssssssssss' yy.ddd hh:mm:ss

====Mishandling ENQCTL entries====
You can effectively crash your Online if you do not bring <var class="product">Model 204</var> down cleanly with an EOJ command, but are terminating the service machine by either issuing:
<ul>
<li>
An IPL of CMS
</li>

<li>
#CP LOGOUT
</li>
</ul>
This leave enqueues in all files that were still open when you terminated the service machine. If you then bring <var class="product">Model 204</var> up on a different CPU, you cannot automatically remove those enqueue entries, which will cause you problems. 
Review the procedures that bring down the service machine. It must be done by issuing: 
<ul>
<li>
EOJ from a user machine logged into the <var class="product">Model 204</var> Online
</li>

<li>
EOJ from the service machine
Note: You cannot use the service machine unless you have a HALT command coded in the <var class="product">Model 204</var> CCAIN for that Online.
</li>
</ul>
[[Category: System administrator commands]]
[[Category:Commands]]