ELowell: /* Description */

2016-12-09T23:15:04Z

Description

← Older revision		Revision as of 23:15, 9 December 2016
Line 185:		Line 185:
	<p>You can suspend a defined VTAM printer by issuing the <var>SUSPEND VTAM PRINTER</var> command and specifying <var class="term">luname</var> or <var class="term">qname</var>. The printer must be in either the clear, idle, or wait state for the completion of the SUSPEND command. </p>		<p>You can suspend a defined VTAM printer by issuing the <var>SUSPEND VTAM PRINTER</var> command and specifying <var class="term">luname</var> or <var class="term">qname</var>. The printer must be in either the clear, idle, or wait state for the completion of the SUSPEND command. </p>
	<p>The FORCE option is another alternative, which forces the suspension. The printer enters the suspended state after the session with the logical unit has terminated.</p>		<p>The FORCE option is another alternative, which forces the suspension. The printer enters the suspended state after the session with the logical unit has terminated.</p>

			==See also==

			{{Template: SNA Communications Server topic list}}

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

ELowell at 21:32, 9 December 2016

2016-12-09T21:32:37Z

← Older revision		Revision as of 21:32, 9 December 2016
Line 187:		Line 187:

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

ELowell: Created page with "This topic describes the VTAM PRINTER commands for the VTAM Printer Support (VPS) feature. ==DEFINE VTAM PRINTER command== ===Syntax===
DEFINE VTAM PRINTER..."

2016-12-09T21:00:51Z

Created page with "This topic describes the VTAM PRINTER commands for the VTAM Printer Support (VPS) feature. ==DEFINE VTAM PRINTER command== ===Syntax=== DEFINE VTAM PRINTER..."

New page

This topic describes the VTAM PRINTER commands for the VTAM Printer Support (VPS) feature.

==DEFINE VTAM PRINTER command==
===Syntax===
DEFINE VTAM PRINTER luname | FOR qname (option a)

STATIC |(DYNAMIC delay n)
RETENTION=NONE | n
FORMS=NONE | fname
OPERATOR=NONE | opr
EJECT | NOEJECT
FF | NOFF
FIRST | NOFIRST
TIME1=t1
TIME2=t2
COUNT1=c1
COUNT1=c2


===Description===
To define the VTAM printer, use the <var>VTAM PRINTER DEFINE</var> command with the following parameters:
<ul>
<li><var class="term">luname</var> is the defined VTAM printer's logical unit name. <var class="term">qname</var> must be a previously defined print queue name, which has been defined with this luname.</li>

<li>STATIC automatically acquires a session with a logical unit. DYNAMIC delays the acquisition of a session until a request is ready from the print queue. After the initial print request, the system waits the specified time (n) for the next print request. If the time expires, the session is terminated and does not acquire a new session until a request is ready from the print queue.</li>

<li>RETENTION (optional) is the time in minutes that a print request is retained before purging from the queue. This option overrides the retention parameter specified in the <var>DEFINE PRINT QUEUE</var> command.</li>

<li>FORMS defines a form, where <var class="term">fname</var> is a 4-character forms name to be used with this printer. This option overrides any FORMS specified with the <var>DEFINE PRINT QUEUE</var> command. The default is NONE, which bypasses any request for a forms change for the VTAM printer.</li>

<li>OPERATOR designates a specific user, who is allowed to execute the <var>READY VTAM PRINTER</var> command or purge requests in a print queue. If you specify NONE (the default), only the creator of a print request can purge that request and only the system manager can ready a VTAM printer. If a specific user is specified, that user can purge a print request and ready a VTAM printer. System managers can use any print queue command, regardless of this specification.</li>

<li>EJECT spaces a page between requests (the default).
NOEJECT eliminates page spacing between requests.</li>

<li>FF indicates that form feeds are needed for 328X type printers.
NOFF indicates a non-328X type printer (the default).</li>

<li>FIRST causes a page eject before printing (the default).
NOFIRST bypasses an initial page eject.</li>
</ul>

==DELETE VTAM PRINTER command==

===Syntax===
DELETE VTAM PRINTER luname | FOR qname

===Description===
The <var>DELETE VTAM PRINTER</var> command deletes a defined printer by means of either luname or qname. The printer must be in an idle, clear, or suspended state. To suspend the printer, use the <var>[[#SUSPEND VTAM PRINTER command|SUSPEND VTAM PRINTER]]</var> command.

==DISPLAY VTAM PRINTER command==
===Syntax===
DISPLAY VTAM PRINTER (ALL | FOR qname | IDLE | IREQ | luname | SUSPEND | VTAM)

===Parameter descriptions===
To display the status of VTAM printers, use the <var>DISPLAY VTAM PRINTER</var> command with the ALL parameter (the default).
To select individual printers, use the following parameters:
<ul>
<li>FOR <var class="term">qname</var> specifies an associated queue name.</li>
<li>IDLE displays printers in the clear state.</li>
<li>IREQ displays printers with intervention required.</li>
<li><var class="term">luname</var> (lu) specifies a particular logical unit.</li>
<li>SUSPEND displays all suspended printers.</li>
<li>VTAM displays session waiters.</li>
</ul>

===Attribute descriptions===

Each display comprises the status of the following attributes:
<ul>
<li><var class="term">luname</var> is the VTAM printer's logical unit name.</li>
<li><var class="term">qname</var> is the VTAM printer's associated queue name.</li>
<li><var class="term">RETM</var> is the retention time specified in the DEFINE VTAM PRINTER command.</li>
<li><var class="term">ST</var> displays the current state of the printer. The states can be:
<table>
<tr class="head">
<th>State</th>
<th>Means...</th>
</tr>
<tr>
<td>CLE</td>
<td>Clear state</td>
</tr>
<tr>
<td>FWT</td>
<td>Forms wait</td>
</tr>
<tr>
<td>IDL</td>
<td>Idle state</td>
</tr>
<tr>
<td>IVR</td>
<td>Intervention required</td>
</tr>
<tr>
<td>PRT</td>
<td>Currently printing</td>
</tr>
<tr>
<td>SUS</td>
<td>Suspend state</td>
</tr>
<tr>
<td>SWT</td>
<td>VTAM session wait</td>
</tr>
<tr>
<td>TWT</td>
<td>Session termination wait</td>
</tr>
</table></li>

<li>RETURN CODE contains the last return code from an RPL-based macro instruction.</li>

<li>FEEDBACK contains either a conditional completion return code or a specific error return code of the last RPL-based macro instruction.</li>

<li>SENSE is set for certain RPL-based macro instructions, RETURN CODES, or FEEDBACK, and contains the senses of SSENSEI, SSENSMI, and USENSEI.</li>

<li>QUEUE ID is the request ID's queue name.</li>

<li>REQUEST ID is the request ID's request count.</li>

<li>CREATOR is the user ID of the creator of the request.</li>

<li>SOFAR is the number of lines so far printed in the request.</li>

<li>TOTAL is the total number of lines in the request.</li>
</ul>

==READY VTAM PRINTER command==
===Syntax===
READY VTAM PRINTER luname

===Description===
The <var>READY VTAM PRINTER</var> command restarts the printer pseudo-subtask after one of the following:
<ul>
<li>Redefine of the printer with special forms specifications.</li>
<li>Required intervention on the physical printer.</li>
</ul>

==REDEFINE VTAM PRINTER command==

===Syntax===
REDEFINE VTAM PRINTER (option a)

luname | FOR qname
STATIC | (DYNAMIC delay n)
QUEUE=new qname
RETENTION=NONE | n
FORMS=NONE | fname
OPERATOR=NONE | opr
EJECT | NOEJECT
FF | NOFF
FIRST | NOFIRST
TIME1=t1
TIME2=t2
COUNT1=c1
COUNT1=c2


===Description===
The <var>REDFINE VTAM PRINTER</var> command allows you to change printer options for an existing defined printer. All options perform the same function as listed under the <var>[[#DEFINE VTAM PRINTER command|DEFINE VTAM PRINTER]]</var> command, except the following:
<ul>
<li><var class="term">luname</var> | FOR <var class="term">qname</var> allows you to enter either name.</li>
<li>QUEUE associates a new print queue with this printer using the <var class="term">qname</var> parameter.</li>
</ul>

If you want to change the session characteristics (STATIC, DYNAMIC) or the queue, you must put the printer in the suspend state using the <var>[[#SUSPEND VTAM PRINTER command|SUSPEND VTAM PRINTER]]</var> command.

==RESUME VTAM PRINTER command==

===Syntax===
RESUME VTAM PRINTER luname | FOR qname 

===Description===
The <var>RESUME VTAM PRINTER</var> command restarts a suspended printer by reestablishing a new session with the logical unit. Upon resuming, the printer enters the state as defined with the STATIC | DYNAMIC options of the <var>[[#DEFINE PRINTER command|DEFINE PRINTER]]</var> or <var>[[#REDEFINE PRINTER command|REDEFINE PRINTER]]</var> command.

==SUSPEND VTAM PRINTER command==
===Syntax===
SUSPEND VTAM PRINTER luname | FOR qname
FORCE

===Description===
You can suspend a defined VTAM printer by issuing the <var>SUSPEND VTAM PRINTER</var> command and specifying <var class="term">luname</var> or <var class="term">qname</var>. The printer must be in either the clear, idle, or wait state for the completion of the SUSPEND command. 
The FORCE option is another alternative, which forces the suspension. The printer enters the suspended state after the session with the logical unit has terminated.

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

VTAM PRINTER commands - Revision history

ELowell: /* Description */

ELowell at 21:32, 9 December 2016

ELowell: Created page with "This topic describes the VTAM PRINTER commands for the VTAM Printer Support (VPS) feature. ==DEFINE VTAM PRINTER command== ===Syntax=== DEFINE VTAM PRINTER..."

ELowell: Created page with "This topic describes the VTAM PRINTER commands for the VTAM Printer Support (VPS) feature. ==DEFINE VTAM PRINTER command== ===Syntax===
DEFINE VTAM PRINTER..."