View source for SNA Communications Server printer support

==Overview==
<p>
SNA Communications Server (formerly VTAM) Printer Support (VPS) feature, which is available for the IBM z/OS operating system, lets you direct output to an SNA Communications Server printer, utilizing the <var>USE</var> command. The creation and maintenance of a print queue is accomplished by formatting a Model&nbsp;204 file's Table D pages into multiple print queues. </p>
<p>
A request is the spooled output produced from a <var>USE</var> command. </p>
<p>
The VPS feature uses two types of pages:</p>
<ul>
<li>Definition pages are the individual print queue definitions. Each print queue definition has two types of print request pages chained from it.</li>
<li>Print request pages are of two types:
<ul>
<li>Requests waiting to print</li>
<li>Requests waiting to purge</li></ul>
</li>
</ul>
<p>
Each print queue is assigned a unique SNA Communications Server printer definition. For each SNA Communications Server printer definition, a subtask is attached that handles all communications between Model&nbsp;204 and the SNA Communications Server printer.</p> 
<p>
The printer daemon manages the interaction between the print queue and SNA Communications Server printer subtask. The printer daemon is an <code>IODEV=3</code> user running as a pseudo-subtask.</p>
<p>
The VPS system does the following:</p>
<ul>
<li>Lets you direct output to SNA Communications Server type TTY and 328X printers utilizing the USE command.</li>
<li>Makes available a print queue for spooling and maintaining USE print requests.</li>
<li>Provides commands to display the status and control the destination of VTAM USE requests.</li>
</ul>

==Initializing SNA Communications Server printer support==
<P  >
Use the following JCL to initialize SNA Communications Server printer support on the z/OS operating system:</P>
<P class="code" ><nowiki>//CCAPRQ DD DSN=MODEL204.PRINT.QUE,DISP=SHR PRINT QUE FILE
//CCAIN  DD    *
  :
  :
  :
VTPRNAME=M204PRT,SPOOLOPT=1 VTAM APPLID and AUTO INIT. CCAPRQ
IODEV=3,LECHO=1,INPUT=DAEMONI,OUTPUT=DAEMONO
  :
  :
/*
//DAEMONO DD   SYSOUT=*
//DAEMONI DD   *     IODEV 3 INPUT
LOGIN USERID
PASSWORD
CREATEPQ             FORMAT CCAPRQ TO BE USED AS A PRINT QUE
                     THIS CAN BE ELIMINATED WITH SPOOLOPT=1
DEFINE PRINT QUEUE   DEFINE INDIVIDUAL PRINT QUEUES
DEFINE VTAM PRINTER  DEFINE VTAM PRINTERS
PRTQDAEMON           START THE PRINT DAEMON
/*
</nowiki></P>
==Spool control==
<p><strong>SPOOLOPT:</strong> Print queue spooling options:</p>
<blockquote>
<table>
<tr class="head">
<th>Setting</th>
<th>Description</th>
</tr>
<tr>
<td>X'01' </td>
<td>Automatic initialization. Attempts to open CCAPRQ if present, but does not stop the run if the open fails.</td>
</tr>
<tr>
<td>X'02' </td>
<td>CCAPRQ is required, insist open has succeeded.</td>
</tr>
<tr>
<td>X'04' </td>
<td>Do not attempt recovery of CCAPRQ.</td>
</tr>
<tr>
<td>X'08' </td>
<td>If there is a DDNAME CCAPRQ, attempt to create the CCAPRQ file automatically, without the user doing the CREATE.</td>
</tr>
<tr>
<td>X'10' </td>
<td>Print daemon prints tracing information after tracing messages.</td>
</tr>
</table>
</blockquote>

==Spool status==
<p>
<strong>SPOOLFLG:</strong> Current status of print spooling:</p>
<blockquote>
<table>
<tr class="head">
<th>Setting</th>
<th>Description</th>
</tr>
<tr>
<td>X'01'</td>
<td>CCAPRQ is open.</td>
</tr>
<tr>
<td>X'02'</td>
<td>Print daemon is active, the DEFINE VTAM PRINTER and DEFINE VTAM PURGE commands are allowed.</td>
</tr>
<tr>
<td>X'04' </td>
<td>CCAPRQ recovery is required, and will be performed by the print daemon.</td>
</tr>
<tr>
<td>X'80' </td>
<td>CCAPRQ open has failed.</td>
</tr>
<tr>
<td>X'40' </td>
<td>0_pgfICCAPRQ recovery has failed.</td>
</tr>
<tr>
<td>X'20' </td>
<td>CCAPRQ recovery was successful.</td>
</tr>
</table>
</blockquote>
<p>
<strong>SPOOLMAX:</strong> Maximum of Table D pages in CCAPRQ.</p>
<p>
<strong>SPOOLNOW:</strong> Current number of CCAPRQ pages in use.</p>
<p>
<strong>SPOOLHWM:</strong> CCAPRQ high water mark for pages in use.</p>
<p>
<strong>VTPRNAME:</strong> SNA Communications Server printer APPLID.</p>
<p>

[[Category: SNA Communications Server]]
[[Category: VTAM Printer Support]]

==See also==
The topics from the former <var class="book">Rocket Model 204 SNA Communications Server Printer Support Summary</var> are listed below. This list is also available as a "See also" link from each of the topics.

{{Template: SNA Communications Server topic list}}