114 lines
4.1 KiB
HTML
114 lines
4.1 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<title>Creating Your Own Virtual Controllers and Devices</title>
|
||
|
|
<!-- Begin Header Records ========================================== -->
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<!-- VT2A SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
|
||
|
|
<!-- RCHVMW2 on 5 Feb 1999 at 07:56:18 -->
|
||
|
|
<!-- File restructured for V5R2 -->
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<a name="Top_Of_Page"></a>
|
||
|
|
|
||
|
|
<h2>Creating Your Own Virtual Controllers and Devices</h2>
|
||
|
|
|
||
|
|
<p>You can create your own virtual controllers and devices (terminals);
|
||
|
|
however, you must use the same naming conventions as the automatic controller
|
||
|
|
and device creation support. You may want to create the virtual terminal
|
||
|
|
descriptions to control the number of sign-on attempts possible by not allowing
|
||
|
|
automatic configuration of virtual terminals (which allows additional sign-on
|
||
|
|
attempts to occur). See <a href="vt1f.htm#HDRSIGNATT">Security
|
||
|
|
Considerations</a> for additional information.</p>
|
||
|
|
|
||
|
|
<p>If you do not want to use automatically created descriptions, do the
|
||
|
|
following:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Use the Create Controller Description (Virtual Work Station) (CRTCTLVWS)
|
||
|
|
command to create a controller description for a virtual terminal.
|
||
|
|
|
||
|
|
<pre>
|
||
|
|
CRTCTLVWS CTLD(QPACTL01)
|
||
|
|
TEXT('Virtual Controller for virtual terminals')
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> You must use the i5/OS<SUP>(TM)</SUP> naming convention,
|
||
|
|
QPACTL<em>nn</em>, for naming virtual controllers, where <em>nn</em> is a
|
||
|
|
decimal number starting at 01.</p>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li>Use the Create Device Description (Display) (CRTDEVDSP) command to create a
|
||
|
|
virtual terminal as follows:
|
||
|
|
|
||
|
|
<pre>
|
||
|
|
CRTDEVDSP DEVD(QPADEV0001) DEVCLS(*VRT)
|
||
|
|
TYPE(5251) MODEL(11) CTL(QPACTL01)
|
||
|
|
TEXT('24 X 80 Monochrome
|
||
|
|
Display for Server Program')
|
||
|
|
</pre>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li>The i5/OS licensed program automatically varies on the controller and
|
||
|
|
terminal that you have created. You must use the i5/OS naming convention,
|
||
|
|
QPADEV<em>xxxx</em>, for naming virtual device descriptions, where <em>
|
||
|
|
xxxx</em> are alphanumeric characters from 0000 to ZZZZ.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>After creating the descriptions, you must authorize the server program to
|
||
|
|
use them. Use the Grant Object Authority (GRTOBJAUT) command to authorize the
|
||
|
|
user profile used by the server program to the descriptions. This can be done
|
||
|
|
using the following commands:</p>
|
||
|
|
|
||
|
|
<pre>
|
||
|
|
GRTOBJAUT OBJ(QPACTL01) OBJTYPE(*CTLD)
|
||
|
|
AUT(*CHANGE) USER(user-ID)
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<pre>
|
||
|
|
GRTOBJAUT OBJ(QPADEV0001) OBJTYPE(*DEVD)
|
||
|
|
AUT(*CHANGE) USER(user-ID)
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<p>You may want to prevent virtual terminals from being created automatically.
|
||
|
|
To do this, set the QAUTOVRT system value to 0 as follows:</p>
|
||
|
|
|
||
|
|
<pre>
|
||
|
|
CHGSYSVAL SYSVAL(QAUTOVRT) VALUE(0)
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
See <a href="vt1f.htm#QAUTOVRT">Setting the Number of Automatically Created
|
||
|
|
Virtual Terminals</a> for additional information.
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> Changing this system value affects other iSeries<SUP>(TM)</SUP>
|
||
|
|
products and programs requiring automatic configuration. This includes TELNET,
|
||
|
|
5250 display station pass-through, and any other programs using the virtual
|
||
|
|
terminal APIs.</p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<table align="center" cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="vt1a.htm">Virtual Terminal APIs</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|