131 lines
7.3 KiB
HTML
131 lines
7.3 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="concept" />
|
|
<meta name="DC.Title" content="Device initialization exit program" />
|
|
<meta name="abstract" content="This program allows you to associate your custom exit program with exit points on the iSeries Telnet server." />
|
|
<meta name="description" content="This program allows you to associate your custom exit program with exit points on the iSeries Telnet server." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiwprogramtypes.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiwreqparam.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiwuserdesc.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiwdevdesc.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiwconndesc.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rzaiwdevinit" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- 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. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Device initialization exit program</title>
|
|
</head>
|
|
<body id="rzaiwdevinit"><a name="rzaiwdevinit"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Device initialization exit program</h1>
|
|
<div><p>This program allows you to associate your custom exit program with
|
|
exit points on the iSeries™ Telnet server.</p>
|
|
<p>The Telnet server application includes exit points that allow you to hook
|
|
into Telnet's sign-on and termination logic. You can use the iSeries WRKREGINF
|
|
(Work with Registration Information) or ADDEXITPGM (Add Exit Program) commands
|
|
to associate your custom exit program to an exit point. If the Telnet server
|
|
finds a program registered to one of the exit points for the server, it calls
|
|
that program using parameters defined by the exit point. These parameters
|
|
include things like IP address, user name, and virtual device name. Your custom
|
|
exit program then processes the information, for example, logs a message and
|
|
returns control to the Telnet server. On return, your exit program tells the
|
|
server whether to accept or reject this client and any optional user or password
|
|
overrides.</p>
|
|
<p>Each exit point has a name and an exit point interface. The exit point
|
|
interface is a list of input and output parameters the Telnet server exchanges
|
|
with your exit program. There are two exit points for the Telnet server:</p>
|
|
<ul><li>QIBM_QTG_DEVINIT</li>
|
|
<li>QIBM_QTG_DEVTERM</li>
|
|
</ul>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 1. Required parameter group</caption><thead align="left"><tr valign="bottom"><th valign="bottom" id="d0e37">No.</th>
|
|
<th valign="bottom" id="d0e39">Exit point interface</th>
|
|
<th valign="bottom" id="d0e41">Input or output?</th>
|
|
<th valign="bottom" id="d0e43">Parameters</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" headers="d0e37 ">1</td>
|
|
<td valign="top" headers="d0e39 ">User description information</td>
|
|
<td valign="top" headers="d0e41 ">I/O</td>
|
|
<td valign="top" headers="d0e43 ">Char(*)</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e37 ">2</td>
|
|
<td valign="top" headers="d0e39 ">Device description information</td>
|
|
<td valign="top" headers="d0e41 ">I/O</td>
|
|
<td valign="top" headers="d0e43 ">Char(*)</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e37 ">3</td>
|
|
<td valign="top" headers="d0e39 ">Connection description information</td>
|
|
<td valign="top" headers="d0e41 ">Input</td>
|
|
<td valign="top" headers="d0e43 ">Char(*)</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e37 ">4</td>
|
|
<td valign="top" headers="d0e39 ">Environment options</td>
|
|
<td valign="top" headers="d0e41 ">Input</td>
|
|
<td valign="top" headers="d0e43 ">Char(*)</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e37 ">5</td>
|
|
<td valign="top" headers="d0e39 ">Length of environment options</td>
|
|
<td valign="top" headers="d0e41 ">Input</td>
|
|
<td valign="top" headers="d0e43 ">Binary(4)</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e37 ">6</td>
|
|
<td valign="top" headers="d0e39 ">Allow connection</td>
|
|
<td valign="top" headers="d0e41 ">Output</td>
|
|
<td valign="top" headers="d0e43 ">Char(1)</td>
|
|
</tr>
|
|
<tr><td valign="top" headers="d0e37 ">7</td>
|
|
<td valign="top" headers="d0e39 ">Allow autosign-on</td>
|
|
<td valign="top" headers="d0e41 ">Output</td>
|
|
<td valign="top" headers="d0e43 ">Char(1)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<ul class="simple"><li>QSYSINC Member Name: ETGDEVEX</li>
|
|
<li>Exit Point Name: QIBM_QTG_DEVINIT</li>
|
|
<li>Exit Point Format Name: INIT0100</li>
|
|
</ul>
|
|
<p>The Telnet server will optionally provide for selecting or setting the
|
|
device name to be used over the Telnet session, and allow for a Telnet client
|
|
to bypass traditional device initialization. Administrators might control
|
|
these new features through the use of a new exit program, which will optionally
|
|
start just after client session establishment. Several parameters will be
|
|
supplied to the exit program to be used in the decision process, and the exit
|
|
program can set or change various parameters before returning
|
|
to the Telnet server. You can optionally register a second exit program to
|
|
start just before session termination. You can use this second exit program
|
|
for session auditing or virtual device management.</p>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rzaiwreqparam.htm">Telnet exit point format INIT0100: Required parameter group</a></strong><br />
|
|
You can read this topic for detailed definitions of the required parameter group.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaiwuserdesc.htm">INIT0100: Format of user description information</a></strong><br />
|
|
The auto-signon process will use the information about the user.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaiwdevdesc.htm">INIT0100: Format of device description information</a></strong><br />
|
|
This topic outlines how to create or change the device used for a Telnet session.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaiwconndesc.htm">INIT0100: Format of connection description information</a></strong><br />
|
|
You can read this topic for information about the client connection that the exit program can use.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiwprogramtypes.htm" title="This topic provides information about using exit programs for your Telnet server.">Use Telnet exit point programs</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |