224 lines
7.6 KiB
HTML
224 lines
7.6 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">
|
||
|
|
<title>Start RSE Server (STRRSESVR)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="STRRSESVR.Top_Of_Page"></a>
|
||
|
|
<h2>Start RSE Server (STRRSESVR)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#STRRSESVR.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRRSESVR.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRRSESVR.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRRSESVR"></a>
|
||
|
|
<p>The Start RSE Server (STRRSESVR) command starts the Remote System Explorer (RSE) communications server if it is not already started and associates the current interactive job with the specified RSE connection.
|
||
|
|
</p>
|
||
|
|
<p>The purpose of STRRSESVR command is to associate an emulator with an RSE connection for running and debugging interactive applications. The job is locked for the exclusive use of the associated RSE connection. The job can be released either by disconnecting the associated RSE connection or using the Release Interactive Job action for the RSE connection.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRRSESVR.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRSESVR.NAME"><b>NAME</b></a></td>
|
||
|
|
<td valign="top">Connection name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*PRV</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRSESVR.WRKLIB"><b>WRKLIB</b></a></td>
|
||
|
|
<td valign="top">Working library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *DFT</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRSESVR.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Remote location name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, *RESOLVE, <b><u>*PRV</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRRSESVR.PORT"><b>PORT</b></a></td>
|
||
|
|
<td valign="top">TCP/IP port</td>
|
||
|
|
<td valign="top">1-65534, <b><u>*PRV</u></b>, *DFT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRRSESVR.NAME"></a>
|
||
|
|
<h3>Connection name (NAME)</h3>
|
||
|
|
<p>Specifies the RSE connection which should be associated with this interactive job. The connection name can be specified by itself or optionally qualified with the RSE profile name.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>The connnection name specified in the previous invocation of the STRRSESVR command is used. The connection name must be specified if no previous invocation exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the connection name that should be associated with this job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRSESVR.WRKLIB"></a>
|
||
|
|
<h3>Working library (WRKLIB)</h3>
|
||
|
|
<p>Specifies the library where the STRRSESVR command will create a data queue to communicate with the RSE server.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>The library name specified in the previous invocation of the STRRSESVR command is used. Until a library is specified, QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>Library QGPL is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRSESVR.RMTLOCNAME"></a>
|
||
|
|
<h3>Remote location name (RMTLOCNAME)</h3>
|
||
|
|
<p>Specifies the TCP/IP hostname or IP address of the client machine where the RSE communications daemon is running.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*RESOLVE</b></dt>
|
||
|
|
<dd>Attempt to have the STRRSESVR command resolve the remote location name. This value is recommended for TCP/IP DHCP users.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>The hostname specified in the previous invocation of the STRRSESVR command is used. Until a hostname is specified, *RESOLVE is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the TCP/IP host name or IP address for the client machine.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRRSESVR.PORT"></a>
|
||
|
|
<h3>TCP/IP port (PORT)</h3>
|
||
|
|
<p>Specifies the port number where the RSE communications daemon is listening.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>The port number specified in the previous invocation of the STRRSESVR command is used. Until a port number is specified, port 4300 is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>The default port (4300) is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-65534</i></b></dt>
|
||
|
|
<dd>Specify the TCP/IP port number to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRSESVR.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Start RSE Server Specifying Only a Connection Name</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRSESVR NAME(DEVELOPMENT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command associates the current interactive job with the RSE connection whose name is DEVELOPMENT.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Start RSE Server Specifying Connection Name and Additional Parameters</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRRSESVR NAME(TEST.DEVELOPMENT) RMTLOCNAME('192.168.1.45')
|
||
|
|
WRKLIB(DEVLIB)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command associates the current interactive job with the RSE connection named DEVELOPMENT in the TEST profile on the client machine with the specified IP address. The data queue used to communicate between this job and the RSE is created in the library DEVLIB.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRRSESVR.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>RSE2001</b></dt>
|
||
|
|
<dd>Error connecting to Remote Systems Explorer
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2002</b></dt>
|
||
|
|
<dd>Connection name not defined.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2003</b></dt>
|
||
|
|
<dd>Connection defined for different hostname.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2004</b></dt>
|
||
|
|
<dd>Error creating data queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2005</b></dt>
|
||
|
|
<dd>Working library is not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2006</b></dt>
|
||
|
|
<dd>RSE server failed to start or connect.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2007</b></dt>
|
||
|
|
<dd>Error accessing data queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2008</b></dt>
|
||
|
|
<dd>Data queue could not be deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2009</b></dt>
|
||
|
|
<dd>Error resolving remote location IP address.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2010</b></dt>
|
||
|
|
<dd>Connection already in use.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2011</b></dt>
|
||
|
|
<dd>Socket Error
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2012</b></dt>
|
||
|
|
<dd>Error retrieving job information.
|
||
|
|
</dd>
|
||
|
|
<dt><b>RSE2013</b></dt>
|
||
|
|
<dd>No previous connection name exists.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRRSESVR.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|