View source for USE command: Directing output

===USE command capabilities===
<p>The capabilities available through USE depend upon the operating system under which <var class="product">Model&nbsp;204</var> is running. The capabilities of the USE command are: </p>
<ul> 
<li>
<p>z/OS users can dynamically create printer and punch output and can submit jobs.</p>
</li>
 
<li>
<p>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.</p>
</li>
 
<li>
<p>z/VSE users can dynamically create printer and punch output and can submit jobs using POWER.</p>
</li>
 
<li>
<p>CICS users can print output on CICS printers.</p>
</li>
 
<li>
<p>All users can write output to sequential data sets. </p>
</li>
 
<li>
<p>USE support is at the command level. See [[RESET COMMAND command|RESET COMMAND: Control USE data set support]] for details.</p>
</li>
 </ul>

===Forms of the USE command===
<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&nbsp;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 class="code">USE <var class="term">name</var>
</p>
<p>where <var class="term">name</var> does not begin with the prefix OUT, <var class="product">Model&nbsp;204</var> searches in the following order: </p>
<ol> 
<li>
<p>Device specified by a DEFINE PRINTER command</p>
</li>
 
<li>
<p>Device specified by a DEFINE PUNCH command</p>
</li>
 </ol>
<p>If the command takes the form:</p>
<p class="code">USE OUT<var class="term">xxxxx</var> 
</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&nbsp;204</var> searches in the following order: </p>
<ol> 
<li>
<p>Data set specified by a DEFINE DATASET command</p>
</li>
 
<li>
<p>Existing data set</p>
</li>
 
<li>
<p>Device specified by a DEFINE PRINTER command</p>
</li>
 
<li>
<p>Device specified by a DEFINE PUNCH command</p>
</li>
 </ol>
<p>You can override forms of the USE command outlined above through a USE PRINTER or USE PUNCH command.</p>

===USE command output===
<p>The format of the USE command's output is affected by the settings of these user parameters:</p>
<table>
<tr class="head"> <th>
<p>Parameter</p>
</th> <th>
<p>Meaning</p>
</th> </tr>
   
<tr> <th><var>[[UDDCC parameter|UDDCCC]]</var>
</th> <td>Continuation character column on the alternate output
</td> </tr>
 
<tr> <th><var>[[UDDLPP parameter|UDDLPP]]</var></th> 
<td>Number of lines per page on the alternate output
</td> </tr>
 
<tr> <th><var>[[UDDRFM parameter|UDDRFM]]</var></th> 
<td>Record format for the alternate output
</td> </tr>
 
<tr> <th><var>[[MUDD parameter|MUDD]]</var></th> 
<td>Maximum number of lines on the alternate output
</td> </tr>   
</table>
<p>
When a USE command is executed, <var class="product">Model&nbsp;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 class="code">M204.1327: NUMBER OF U DD LINES OUTPUT=<i>n</i>
</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&nbsp;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>The USE command must be repeated before any other request whose output is to appear in the data set.</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>

[[Category:Commands]]