USE $PRINT / $PUNCH / $JOB command: Difference between revisions

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


Line 95: Line 72:
JOBNAME=ENDMONTH, ROUTE=ACCT05
JOBNAME=ENDMONTH, ROUTE=ACCT05
</p>
</p>
==Usage notes==
==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.
<ul>
<p class="note"><b>Note:</b> This version of the USE command is obsolete and is supplied only for purposes of compatibility.</p>
<li>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 <var>USE $JOB</var> command's authorization to submit jobs to the internal reader. For more information, refer to the [[:Category:Security interfaces|Security interfaces topics]]. </li>
<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>
 
<li>The <var>USE $PRINT</var> version of the <var>USE</var> command is obsolete and is supplied only for purposes of compatibility. </li>
</ul>
 
===z/OS===
Under z/OS, the <var>USE $PRINT</var>, <var>USE $PUNCH</var>, or <var>USE $JOB</var> command directs output to a dynamically allocated printer, punch device, or internal reader.
<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, <code>ONLINE Model&nbsp;204</code>) that created the data set. <var class="product">Model&nbsp;204</var> also generates a separator page. For <var>$PRINT</var> output under z/OS, if the IBM Block Letter Routine (IEFSD095) is <strong>not</strong> included in the Model&nbsp;204 load module, <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 class="code">M204LIST <i>userid</i>  
</p>
</p>
<p>where userid consists of the first eight characters of the user ID of the user who is running the request.</p>
<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>
Where <var class="term">userid</var> consists of the first eight characters of the ID of the user who is running the request.</p>
<p>
If the IBM Block Letter Routine is included in the Model&nbsp;204 load module, <var class="product">Model&nbsp;204</var> generates a separator that contains the following message lines: </p>
<p class="code">M204LIST  
<p class="code">M204LIST  
userid  
<i>userid</i>
</p>
</p>
<p>These lines are equivalent to the options HDR1 and HDR2. </p>
<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>
These lines are equivalent to the options <code>HDR1</code> and <code>HDR2</code>. </p>
<p>Under z/VM, the <var class="product">Model&nbsp;204</var> separator page always consists of the following message:</p>
<p>
<p class="code">Model 204 SPINOFF FOR USER
The Block Letter Routine can be linked into your Online or [[BATCH204]] during <var class="product">Model&nbsp;204</var> installation.</p>
userid
 
===CMS===
<p>
Under CMS, the <var>USE $PRINT</var> or <var>USE $PUNCH</var> command directs output to a dynamically allocated printer or punch device.
</p>
</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>
Under CMS, the <var class="product">Model&nbsp;204</var> separator page always consists of the following message:
[[Category: General user commands]]
<p class="code">Model 204 SPINOFF FOR USER <i>userid</i>
</p>
 
[[Category: User commands]]
[[Category:Commands]]
[[Category:Commands]]

Latest revision as of 20:13, 10 October 2017

Summary

Privileges
Any user
Function
Under z/OS or z/VM, directs output to a dynamically allocated printer, punch device, or internal reader.

Syntax

USE name [option [,option]...]

Where:

name One of the following:

$function

Routes output to...

$JOB | READER Internal reader that submits a job from Model 204 to JES. (Only z/OS)
$PRINT Printer. USE sets up a 133-character ASA carriage control buffer.
$PUNCH Punch. USE sets up an 80-character buffer.
options Described in the table below.
USE command output options

Option

Specifies the...

CLASS Output class. The class is specified as one alphanumeric character. The default is:

A for $PRINT

B for $PUNCH

(A is assumed for $JOB)
COPIES 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.

If COPIES is omitted or a zero value is specified, COPIES=1 is assumed.

The z/VSE/POWER equivalent option name is COPY.

FCB 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.
FORMS
F
Form name for the output. The name consists of 1 to 8 characters. There is no default.
JOBNAME
J
Identifier that appears in place of your user ID on the separator page. This option is equivalent to HDR2.
ROUTE
R
Desired output destination or routing. The destination consists of one to eight characters. The default is LOCAL.

Example

USE $PRINT COPIES=3, FORMS=TIME,FCB=FM01 - JOBNAME=ENDMONTH, ROUTE=ACCT05

Usage notes

  • 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 Security interfaces topics.
  • The USE $PRINT version of the USE command is obsolete and is supplied only for purposes of compatibility.

z/OS

Under z/OS, the USE $PRINT, USE $PUNCH, or USE $JOB command directs output to a dynamically allocated printer, punch device, or internal reader.

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 Model 204) that created the data set. Model 204 also generates a separator page. For $PRINT output under z/OS, if the IBM Block Letter Routine (IEFSD095) is not included in the Model 204 load module, Model 204 generates a separator page that contains a one-line message:

M204LIST userid

Where userid consists of the first eight characters of the ID of the user who is running the request.

If the IBM Block Letter Routine is included in the Model 204 load module, Model 204 generates a separator that contains the following message lines:

M204LIST userid

These lines are equivalent to the options HDR1 and HDR2.

The Block Letter Routine can be linked into your Online or BATCH204 during Model 204 installation.

CMS

Under CMS, the USE $PRINT or USE $PUNCH command directs output to a dynamically allocated printer or punch device.

Under CMS, the Model 204 separator page always consists of the following message:

Model 204 SPINOFF FOR USER userid