USE command: Directing output - Revision history

JAL: add "See also" section

2018-01-16T21:15:23Z

add "See also" section

← Older revision		Revision as of 21:15, 16 January 2018
Line 102:		Line 102:
	<p>If an I/O error is encountered in the USE data set, the request being run is canceled.</p>		<p>If an I/O error is encountered in the USE data set, the request being run is canceled.</p>
	<p>If two users attempt to write to the same data set, the second user sees messages stating that the data set is in use and that the output is set for routing to the normal device. The second user's output is not routed to the data set.</p>		<p>If two users attempt to write to the same data set, the second user sees messages stating that the data set is in use and that the output is set for routing to the normal device. The second user's output is not routed to the data set.</p>

			==See also==
			<ul>
			<li>[[USE command: To a sequential data set]] </li>
			</ul>

	[[Category:Commands]]		[[Category:Commands]]

ELowell: /* Forms of the USE command */

2017-04-13T16:35:30Z

Forms of the USE command

← Older revision		Revision as of 16:35, 13 April 2017
Line 31:		Line 31:
	<p>The way in which <var class="product">Model 204</var> handles the name specified in a USE command is determined in a hierarchical manner.</p>		<p>The way in which <var class="product">Model 204</var> handles the name specified in a USE command is determined in a hierarchical manner.</p>
	<p>If the command takes the form: </p>		<p>If the command takes the form: </p>
	<p class="code">~~USE~~ <var class="term">name</var>		<p class="code"><b>U</b>SE <var class="term">name</var>
	</p>		</p>
	<p>where <var class="term">name</var> does not begin with the prefix OUT, <var class="product">Model 204</var> searches in the following order: </p>		<p>where <var class="term">name</var> does not begin with the prefix OUT, <var class="product">Model 204</var> searches in the following order: </p>
Line 44:		Line 44:
	</ol>		</ol>
	<p>If the command takes the form:</p>		<p>If the command takes the form:</p>
	<p class="code">~~USE~~ OUT<var class="term">xxxxx</var>		<p class="code"><b>U</b>SE OUT<var class="term">xxxxx</var>
	</p>		</p>
	<p>where OUT<var class="term">xxxxx</var> is a data set or device name beginning with the prefix OUT, then <var class="product">Model 204</var> searches in the following order: </p>		<p>where OUT<var class="term">xxxxx</var> is a data set or device name beginning with the prefix OUT, then <var class="product">Model 204</var> searches in the following order: </p>

JAL: /* USE command output */

2014-08-25T22:35:04Z

USE command output

← Older revision		Revision as of 22:35, 25 August 2014
Line 75:		Line 75:
	</th> </tr>		</th> </tr>

	<tr> <th><var>[[~~UDDCC~~ parameter\|UDDCCC]]</var>		<tr> <th><var>[[UDDCCC parameter\|UDDCCC]]</var>
	</th> <td>Continuation character column on the alternate output		</th> <td>Continuation character column on the alternate output
	</td> </tr>		</td> </tr>

JAL: /* USE command output */

2014-08-01T20:36:12Z

USE command output

← Older revision		Revision as of 20:36, 1 August 2014
Line 76:		Line 76:

	<tr> <th><var>[[UDDCC parameter\|UDDCCC]]</var>		<tr> <th><var>[[UDDCC parameter\|UDDCCC]]</var>
	</th> <td>		</th> <td>Continuation character column on the alternate output
	<p>Continuation character column on the alternate output~~</p>~~
	</td> </tr>		</td> </tr>

	<tr> <th><var>[[UDDLPP parameter\|UDDLPP]]</var></th>		<tr> <th><var>[[UDDLPP parameter\|UDDLPP]]</var></th>
	<td>		<td>Number of lines per page on the alternate output
	<p>Number of lines per page on the alternate output~~</p>~~
	</td> </tr>		</td> </tr>

	<tr> <th><var>[[UDDRFM parameter\|UDDRFM]]</var></th>		<tr> <th><var>[[UDDRFM parameter\|UDDRFM]]</var></th>
	<td>		<td>Record format for the alternate output
	<p>Record format for the alternate output~~</p>~~
	</td> </tr>		</td> </tr>

	<tr> <th><var>[[MUDD parameter\|MUDD]]</var></th>		<tr> <th><var>[[MUDD parameter\|MUDD]]</var></th>
	<td>		<td>Maximum number of lines on the alternate output
	<p>Maximum number of lines on the alternate output ~~</p>~~		</td> </tr>
	</td> </tr>

	</table>		</table>
	<p>		<p>
Line 101:		Line 96:
	<p class="code">M204.1327: NUMBER OF U DD LINES OUTPUT=<i>n</i>		<p class="code">M204.1327: NUMBER OF U DD LINES OUTPUT=<i>n</i>
	</p>		</p>
	<p>A new USE command must be issued for each new command that produces output. If USE has been issued and an output command is not received before another USE is issued, <var class="product">Model 204</var> automatically closes the first data set before opening the second.</p>		<p>
			A new USE command must be issued for each new command that produces output. If USE has been issued and an output command is not received before another USE is issued, <var class="product">Model 204</var> automatically closes the first data set before opening the second.</p>
	<p>If a User Language request ends with an END USE statement, the USE data set is left open after the request has been completed, allowing output from another request to be added to the original output. The output page number is not reset. If the USE keyword is not specified in the END statement, the USE command applies only to the first request or DISPLAY command following the USE command. </p>		<p>If a User Language request ends with an END USE statement, the USE data set is left open after the request has been completed, allowing output from another request to be added to the original output. The output page number is not reset. If the USE keyword is not specified in the END statement, the USE command applies only to the first request or DISPLAY command following the USE command. </p>
	<p>The USE command must be repeated before any other request whose output is to appear in the data set.</p>		<p>The USE command must be repeated before any other request whose output is to appear in the data set.</p>

JAL at 21:42, 16 June 2014

2014-06-16T21:42:56Z

← Older revision		Revision as of 21:42, 16 June 2014
Line 1:		Line 1:
	====USE command capabilities====		===USE command capabilities===
	<p>The capabilities available through USE depend upon the operating system under which <var class="product">Model 204</var> is running. The capabilities of the USE command are: </p>		<p>The capabilities available through USE depend upon the operating system under which <var class="product">Model 204</var> is running. The capabilities of the USE command are: </p>
	<ul>		<ul>
Line 26:		Line 26:
	</li>		</li>
	</ul>		</ul>
	====Forms of the USE command====
			===Forms of the USE command===
	<p>Information on each form of the USE command is provided in the sections that follow.</p>		<p>Information on each form of the USE command is provided in the sections that follow.</p>
	<p>The way in which <var class="product">Model 204</var> handles the name specified in a USE command is determined in a hierarchical manner.</p>		<p>The way in which <var class="product">Model 204</var> handles the name specified in a USE command is determined in a hierarchical manner.</p>
Line 65:		Line 66:
	<p>You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.</p>		<p>You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.</p>

	====USE command output====		===USE command output===
	<p>The format of the USE command's output is affected by the settings of these user parameters:</p>		<p>The format of the USE command's output is affected by the settings of these user parameters:</p>
	<table>		<table>

JAL: /* USE command output */

2014-05-20T21:12:43Z

USE command output

← Older revision		Revision as of 21:12, 20 May 2014
Line 68:		Line 68:
	<p>The format of the USE command's output is affected by the settings of these user parameters:</p>		<p>The format of the USE command's output is affected by the settings of these user parameters:</p>
	<table>		<table>
	<tr> <th>		<tr class="head"> <th>
	<p>Parameter</p>		<p>Parameter</p>
	</th> <th>		</th> <th>

ELowell: /* Forms of the USE command */

2014-02-25T19:38:17Z

Forms of the USE command

← Older revision		Revision as of 19:38, 25 February 2014
Line 30:		Line 30:
	<p>The way in which <var class="product">Model 204</var> handles the name specified in a USE command is determined in a hierarchical manner.</p>		<p>The way in which <var class="product">Model 204</var> handles the name specified in a USE command is determined in a hierarchical manner.</p>
	<p>If the command takes the form: </p>		<p>If the command takes the form: </p>
	<p class="code">USE name		<p class="code">USE <var class="term">name</var>
	</p>		</p>
	<p>where name does not begin with the prefix OUT, <var class="product">Model 204</var> searches in the following order: </p>		<p>where <var class="term">name</var> does not begin with the prefix OUT, <var class="product">Model 204</var> searches in the following order: </p>
	<ol>		<ol>
	<li>		<li>
Line 43:		Line 43:
	</ol>		</ol>
	<p>If the command takes the form:</p>		<p>If the command takes the form:</p>
	<p class="code">USE ~~OUTxxxxx~~		<p class="code">USE OUT<var class="term">xxxxx</var>
	</p>		</p>
	<p>where ~~OUTxxxxx~~ is a data set or device name beginning with the prefix OUT, then <var class="product">Model 204</var> searches in the following order: </p>		<p>where OUT<var class="term">xxxxx</var> is a data set or device name beginning with the prefix OUT, then <var class="product">Model 204</var> searches in the following order: </p>
	<ol>		<ol>
	<li>		<li>
Line 64:		Line 64:
	</ol>		</ol>
	<p>You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.</p>		<p>You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.</p>

	====USE command output====		====USE command output====
	<p>The format of the USE command's output is affected by the settings of these user parameters:</p>		<p>The format of the USE command's output is affected by the settings of these user parameters:</p>

JAL: /* USE command output */

2013-05-24T20:11:29Z

USE command output

← Older revision		Revision as of 20:11, 24 May 2013
Line 65:		Line 65:
	<p>You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.</p>		<p>You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.</p>
	====USE command output====		====USE command output====
	<p>The format of the USE command's output is affected by the settings of ~~the~~ user parameters ~~listed in the table below.~~</p>		<p>The format of the USE command's output is affected by the settings of these user parameters:</p>
	<table>		<table>
	~~<caption> User parameters affecting USE command display</caption>~~

	<tr> <th>		<tr> <th>
	<p>Parameter</p>		<p>Parameter</p>
Line 75:		Line 73:
	</th> </tr>		</th> </tr>

	<tr> <th><var>		<tr> <th><var>[[UDDCC parameter\|UDDCCC]]</var>
	~~<p>~~UDDCCC </p>		</th> <td>
	~~</var>~~</th> <td>
	<p>Continuation character column on the alternate output</p>		<p>Continuation character column on the alternate output</p>
	</td> </tr>		</td> </tr>

	<tr> <th><var>		<tr> <th><var>[[UDDLPP parameter\|UDDLPP]]</var></th>
	~~<p>~~UDDLPP ~~</p>~~		<td>
	</var></th> <td>
	<p>Number of lines per page on the alternate output</p>		<p>Number of lines per page on the alternate output</p>
	</td> </tr>		</td> </tr>

	<tr> <th><var>		<tr> <th><var>[[UDDRFM parameter\|UDDRFM]]</var></th>
	~~<p>~~UDDRFM ~~</p>~~		<td>
	</var></th> <td>
	<p>Record format for the alternate output</p>		<p>Record format for the alternate output</p>
	</td> </tr>		</td> </tr>

	<tr> <th><var>		<tr> <th><var>[[MUDD parameter\|MUDD]]</var></th>
	~~<p>~~MUDD ~~</p>~~		<td>
	</var></th> <td>
	<p>Maximum number of lines on the alternate output </p>		<p>Maximum number of lines on the alternate output </p>
	</td> </tr>		</td> </tr>

	</table>		</table>
	<~~p>Refer to Part 1 of this <var>Rocket Model 204 Parameter and Command Reference</var> for a description of these parameters.</~~p>		<p>
	~~<p>~~When a USE command is executed, <var class="product">Model 204</var> opens the specified sequential device. It remains open until a command, such as BEGIN, MORE, or DISPLAY, causes data to be written on it. If other commands are issued before the command that produces output, the data set remains open until an output command is issued and the output is completed. </p>		When a USE command is executed, <var class="product">Model 204</var> opens the specified sequential device. It remains open until a command, such as BEGIN, MORE, or DISPLAY, causes data to be written on it. If other commands are issued before the command that produces output, the data set remains open until an output command is issued and the output is completed. </p>
	<p>Commands with the USE=RESPECT option close the USE output area and generate the following message whether or not output is generated: </p>		<p>Commands with the USE=RESPECT option close the USE output area and generate the following message whether or not output is generated: </p>
	<p class="code">M204.1327: NUMBER OF U DD LINES ~~OTPUT~~=<i>n</i>		<p class="code">M204.1327: NUMBER OF U DD LINES OUTPUT=<i>n</i>
	</p>		</p>
	<p>A new USE command must be issued for each new command that produces output. If USE has been issued and an output command is not received before another USE is issued, <var class="product">Model 204</var> automatically closes the first data set before opening the second.</p>		<p>A new USE command must be issued for each new command that produces output. If USE has been issued and an output command is not received before another USE is issued, <var class="product">Model 204</var> automatically closes the first data set before opening the second.</p>
Line 110:		Line 104:
	<p>If an I/O error is encountered in the USE data set, the request being run is canceled.</p>		<p>If an I/O error is encountered in the USE data set, the request being run is canceled.</p>
	<p>If two users attempt to write to the same data set, the second user sees messages stating that the data set is in use and that the output is set for routing to the normal device. The second user's output is not routed to the data set.</p>		<p>If two users attempt to write to the same data set, the second user sees messages stating that the data set is in use and that the output is set for routing to the normal device. The second user's output is not routed to the data set.</p>

	[[Category:Commands]]		[[Category:Commands]]

Alex: Automatically generated page update

2013-02-28T01:05:34Z

Automatically generated page update

New page

====USE command capabilities====
The capabilities available through USE depend upon the operating system under which <var class="product">Model 204</var> is running. The capabilities of the USE command are: 
<ul>
<li>
z/OS users can dynamically create printer and punch output and can submit jobs.
</li>

<li>
z/VM users running under z/VM or under a guest operating system can dynamically create both print and punch files using the z/VM spooling system.
</li>

<li>
z/VSE users can dynamically create printer and punch output and can submit jobs using POWER.
</li>

<li>
CICS users can print output on CICS printers.
</li>

<li>
All users can write output to sequential data sets. 
</li>

<li>
USE support is at the command level. See [[RESET COMMAND command|RESET COMMAND: Control USE data set support]] for details.
</li>
</ul>
====Forms of the USE command====
Information on each form of the USE command is provided in the sections that follow.
The way in which <var class="product">Model 204</var> handles the name specified in a USE command is determined in a hierarchical manner.
If the command takes the form: 
USE name

where name does not begin with the prefix OUT, <var class="product">Model 204</var> searches in the following order: 
<ol>
<li>
Device specified by a DEFINE PRINTER command
</li>

<li>
Device specified by a DEFINE PUNCH command
</li>
</ol>
If the command takes the form:
USE OUTxxxxx

where OUTxxxxx is a data set or device name beginning with the prefix OUT, then <var class="product">Model 204</var> searches in the following order: 
<ol>
<li>
Data set specified by a DEFINE DATASET command
</li>

<li>
Existing data set
</li>

<li>
Device specified by a DEFINE PRINTER command
</li>

<li>
Device specified by a DEFINE PUNCH command
</li>
</ol>
You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.
====USE command output====
The format of the USE command's output is affected by the settings of the user parameters listed in the table below.
<table>
<caption> User parameters affecting USE command display</caption>

<tr> <th>
Parameter
</th> <th>
Meaning
</th> </tr>

<tr> <th><var>
UDDCCC 
</var></th> <td>
Continuation character column on the alternate output
</td> </tr>

<tr> <th><var>
UDDLPP 
</var></th> <td>
Number of lines per page on the alternate output
</td> </tr>

<tr> <th><var>
UDDRFM 
</var></th> <td>
Record format for the alternate output
</td> </tr>

<tr> <th><var>
MUDD 
</var></th> <td>
Maximum number of lines on the alternate output 
</td> </tr>

</table>
Refer to Part 1 of this <var>Rocket Model 204 Parameter and Command Reference</var> for a description of these parameters.
When a USE command is executed, <var class="product">Model 204</var> opens the specified sequential device. It remains open until a command, such as BEGIN, MORE, or DISPLAY, causes data to be written on it. If other commands are issued before the command that produces output, the data set remains open until an output command is issued and the output is completed. 
Commands with the USE=RESPECT option close the USE output area and generate the following message whether or not output is generated: 
M204.1327: NUMBER OF U DD LINES OTPUT=n

A new USE command must be issued for each new command that produces output. If USE has been issued and an output command is not received before another USE is issued, <var class="product">Model 204</var> automatically closes the first data set before opening the second.
If a User Language request ends with an END USE statement, the USE data set is left open after the request has been completed, allowing output from another request to be added to the original output. The output page number is not reset. If the USE keyword is not specified in the END statement, the USE command applies only to the first request or DISPLAY command following the USE command. 
The USE command must be repeated before any other request whose output is to appear in the data set.
If an I/O error is encountered in the USE data set, the request being run is canceled.
If two users attempt to write to the same data set, the second user sees messages stating that the data set is in use and that the output is set for routing to the normal device. The second user's output is not routed to the data set.
[[Category:Commands]]