View source for USE $PRINT / $PUNCH / $JOB command

==Summary==
<dl>
<dt>Privileges
<dd>Any user
<dt>Function
<dd>Under z/OS or z/VM, directs output to a dynamically allocated printer, punch device, or internal reader.
</dl>
==Syntax==
<p class="syntax"><b>U</b>SE <i>name</i> [<i>option</i> [,<i>option</i>]...]
</p>
 
<b>Where:</b>
<table> 
<tr>
<th>name</th>
<td> is one of the following: 
<table>
   
<tr> <th>
<p>$function </p>
</th> <th>
<p>Routes output to...</p>
</th> </tr>
   
<tr> <th><var>
<p>$JOB</p>
</var></th> <td>
<p>Internal reader that submits a job from <var class="product">Model&nbsp;204</var> to JES. (Only z/OS) </p>
</td> </tr>
 
<tr>  <th><var>
<p>$PRINT</p>
</var></th> <td>Printer. USE sets up a 133-character ASA carriage control buffer.    </td> </tr>
 
<tr> <th><var>
<p>$PUNCH</p>
</var></th> <td>Punch. USE sets up an 80-character buffer.    </td> </tr>
   
</table>
</td>
</tr>
 
<tr>
<th>options</th>
<td> are described in the table below.
<table>
<caption>USE command output options </caption>
    
<tr> <th>
<p>Option</p>
</th> <th>
<p>Specifies the...</p>
</th> </tr>
   
<tr> <th><var>
<p>CLASS</p>
</var></th> <td>
<p>Output class. The class is specified as one alphanumeric character. The default is:</p>
<p>A for $PRINT</p>
<p>B for $PUNCH</p>
(A is assumed for $JOB)   </td> </tr>
 
<tr> <th><var>
<p>COPIES</p>
</var></th> <td>
<p>Number of copies to be printed. The number must be in the range 1 to 255 to match the range allowed for the COPY parameter of the z/VSE/POWER *$$LST and *$$PUN statements. The default is 1. </p>
<p>If COPIES is omitted or a zero value is specified, COPIES=1 is assumed. </p>
<p>The z/VSE/POWER equivalent option name is COPY.</p>
</td> </tr>
 
<tr> <th><var> FCB</var></th> <td>Name of the forms control buffer (block) used to control the vertical spacing of output on the page. FCB consists of 1 to 4 characters. There is no default.   </td> </tr>
 
<tr> <th><var>
<p>FORMS</p>
</var></th> <td>Form name for the output. The name consists of 1 to 8 characters. There is no default.   </td> </tr>
 
<tr> <th><var>
<p>JOBNAME<br>J</p>
</var></th> <td>Identifier that appears in place of your user ID on the separator page. This option is equivalent to HDR2.   </td> </tr>
 
<tr> <th><var>
<p>ROUTE</p>
</var></th> <td>
<p>Desired output destination or routing. The destination consists of one to eight characters. The default is LOCAL.   </p>
</td> </tr>
   
</table>
</td>
</tr>
 
</table>

==Example==
<p class="code">USE $PRINT COPIES=3, FORMS=TIME,FCB=FM01 -
JOBNAME=ENDMONTH, ROUTE=ACCT05
</p>
==Usage notes==
Under z/OS or z/VM, the USE $PRINT/$PUNCH/$JOB command directs output to a dynamically allocated printer, punch device, or internal reader. $JOB applies only to z/OS. 
<p class="note"><b>Note:</b> This version of the USE command is obsolete and is supplied only for purposes of compatibility.</p>
<p>Under z/OS, when a data set is printed or punched, the operating system inserts a separator page or card identifying the job (for example, ONLINE <var class="product">Model&nbsp;204</var>) that created the data set. <var class="product">Model&nbsp;204</var> also generates a separator page. For $PRINT output under z/OS, if the IBM Block Letter Routine (IEFSD095) is not in effect, <var class="product">Model&nbsp;204</var> generates a separator page that contains a one-line message: </p>
<p class="code">M204LIST <i>userid</i> 
</p>
<p>where userid consists of the first eight characters of the user ID of the user who is running the request.</p>
<p>If the IBM Block Letter Routine is in effect, <var class="product">Model&nbsp;204</var> generates a separator that contains the following message lines: </p>
<p class="code">M204LIST 
userid 
</p>
<p>These lines are equivalent to the options HDR1 and HDR2. </p>
<p>The Block Letter Routine is automatically linked (by M204LINK or M204RLNK) into your online or BATCH204 during <var class="product">Model&nbsp;204</var> installation<i>.</i></p>
<p>Under z/VM, the <var class="product">Model&nbsp;204</var> separator page always consists of the following message:</p>
<p class="code">Model 204 SPINOFF FOR USER
userid 
</p>
<p>If you are using an external security interface, authorization to open SYSOUT data sets is validated during execution of the command. An external security interface verifies the USE $JOB command's authorization to submit jobs to the internal reader. For more information, refer to the <var>Model&nbsp;204 Security Interfaces Manual</var>.</p>
[[Category: General user commands]]
[[Category:Commands]]