182 lines
11 KiB
HTML
182 lines
11 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="reference" />
|
|
<meta name="DC.Title" content="RXCS0100" />
|
|
<meta name="abstract" content="The REXEC server command processing selection (RXCS0100) exit point allows you to specify which command processor the REXEC server uses for interpreting and running your commands." />
|
|
<meta name="description" content="The REXEC server command processing selection (RXCS0100) exit point allows you to specify which command processor the REXEC server uses for interpreting and running your commands." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzal7exitpt.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2000, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2000, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rxcs0100" />
|
|
<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>RXCS0100</title>
|
|
</head>
|
|
<body id="rxcs0100"><a name="rxcs0100"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">RXCS0100</h1>
|
|
<div><p>The REXEC server command processing selection (RXCS0100) exit point
|
|
allows you to specify which command processor the REXEC server uses for interpreting
|
|
and running your commands.</p>
|
|
<div class="section"><div class="p"><img src="./delta.gif" alt="Start of change" />The RXCS0100 exit program enables you to select: <ul><li>Which command processor runs the command that the REXEC client user provides</li>
|
|
<li>Whether the REXEC server converts data between ASCII and EBCDIC (for Qshell
|
|
commands or spawn path names)</li>
|
|
</ul>
|
|
<img src="./deltaend.gif" alt="End of change" /></div>
|
|
|
|
<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" width="22.311827956989248%" id="d0e30">Parameter</th>
|
|
<th valign="bottom" width="24.731182795698924%" id="d0e32">Description</th>
|
|
<th valign="bottom" width="26.881720430107524%" id="d0e34">Input or output</th>
|
|
<th valign="bottom" width="26.0752688172043%" id="d0e36">Type and length</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="22.311827956989248%" headers="d0e30 ">1</td>
|
|
<td valign="top" width="24.731182795698924%" headers="d0e32 ">User profile</td>
|
|
<td valign="top" width="26.881720430107524%" headers="d0e34 ">Input</td>
|
|
<td valign="top" width="26.0752688172043%" headers="d0e36 ">Char(10)</td>
|
|
</tr>
|
|
<tr><td valign="top" width="22.311827956989248%" headers="d0e30 ">2</td>
|
|
<td valign="top" width="24.731182795698924%" headers="d0e32 ">Remote IP address</td>
|
|
<td valign="top" width="26.881720430107524%" headers="d0e34 ">Input</td>
|
|
<td valign="top" width="26.0752688172043%" headers="d0e36 ">Char(*)</td>
|
|
</tr>
|
|
<tr><td valign="top" width="22.311827956989248%" headers="d0e30 ">3</td>
|
|
<td valign="top" width="24.731182795698924%" headers="d0e32 ">Length of remote IP address</td>
|
|
<td valign="top" width="26.881720430107524%" headers="d0e34 ">Input</td>
|
|
<td valign="top" width="26.0752688172043%" headers="d0e36 ">Binary(4)</td>
|
|
</tr>
|
|
<tr><td valign="top" width="22.311827956989248%" headers="d0e30 ">4</td>
|
|
<td valign="top" width="24.731182795698924%" headers="d0e32 ">Command string</td>
|
|
<td valign="top" width="26.881720430107524%" headers="d0e34 ">Input</td>
|
|
<td valign="top" width="26.0752688172043%" headers="d0e36 ">Char(*)</td>
|
|
</tr>
|
|
<tr><td valign="top" width="22.311827956989248%" headers="d0e30 ">5</td>
|
|
<td valign="top" width="24.731182795698924%" headers="d0e32 ">Length of command string</td>
|
|
<td valign="top" width="26.881720430107524%" headers="d0e34 ">Input</td>
|
|
<td valign="top" width="26.0752688172043%" headers="d0e36 ">Binary(4)</td>
|
|
</tr>
|
|
<tr><td valign="top" width="22.311827956989248%" headers="d0e30 ">6</td>
|
|
<td valign="top" width="24.731182795698924%" headers="d0e32 ">Command processor identifier</td>
|
|
<td valign="top" width="26.881720430107524%" headers="d0e34 ">Output</td>
|
|
<td valign="top" width="26.0752688172043%" headers="d0e36 ">Binary(4)</td>
|
|
</tr>
|
|
<tr><td valign="top" width="22.311827956989248%" headers="d0e30 ">7</td>
|
|
<td valign="top" width="24.731182795698924%" headers="d0e32 ">Character conversion option</td>
|
|
<td valign="top" width="26.881720430107524%" headers="d0e34 ">Output</td>
|
|
<td valign="top" width="26.0752688172043%" headers="d0e36 ">Binary(4)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>Exit point format name: RXCS0100</p>
|
|
<p>Exit point name: QIBM_QTMF_SVR_SELECT</p>
|
|
<div class="note"><span class="notetitle">Note:</span> Character
|
|
data passes to the exit program in the coded character set identifier (CCSID)
|
|
of the job. If the job CCSID is 65535, the server uses the default CCSID of
|
|
the job.</div>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Required parameter group</h4><dl><dt class="dlterm">User profile</dt>
|
|
<dd>INPUT; CHAR(10) The user profile under which the requested operations
|
|
is run.</dd>
|
|
<dt class="dlterm">Remote IP address</dt>
|
|
<dd>INPUT; CHAR(*) The Internet protocol (IP) address of the REXEC client
|
|
system. This string is in dotted decimal format, left justified.</dd>
|
|
<dt class="dlterm">Length of remote IP address </dt>
|
|
<dd>INPUT; BINARY(4) Indicates the length (in bytes) of the remote IP address.</dd>
|
|
<dt class="dlterm">Command string</dt>
|
|
<dd>INPUT; CHAR(*) The command to be run as specified by the REXEC client.</dd>
|
|
<dt class="dlterm">Length of command string</dt>
|
|
<dd>INPUT; BINARY(4) Indicates the length (in bytes) of the command string.</dd>
|
|
<dt class="dlterm">Command processor identifier</dt>
|
|
<dd>OUTPUT; BINARY(4) Indicates the command processor that you want the server
|
|
to use for interpreting and running the command. The following values are
|
|
valid:
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 2. Valid values</caption><thead align="left"><tr valign="bottom"><th valign="bottom" width="13.402061855670103%" id="d0e150">Value</th>
|
|
<th valign="bottom" width="86.5979381443299%" id="d0e152">Operation</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="13.402061855670103%" headers="d0e150 ">0</td>
|
|
<td valign="top" width="86.5979381443299%" headers="d0e152 "><span class="keyword">i5/OS™</span> control
|
|
language — The server processes the command as an <span class="keyword">i5/OS</span> control
|
|
language (CL) command. This is the default value.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="13.402061855670103%" headers="d0e150 ">1</td>
|
|
<td valign="top" width="86.5979381443299%" headers="d0e152 ">Qshell command — The Qshell command interpreter processes
|
|
the command. The server uses the spawn() application programming interface
|
|
(API) to call Qshell as a child job.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="13.402061855670103%" headers="d0e150 ">2</td>
|
|
<td valign="top" width="86.5979381443299%" headers="d0e152 ">Spawn path name — The server treats the command name
|
|
as a path name and passes it to the spawn() application programming interface
|
|
(API), which runs as the child job.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</dd>
|
|
<dt class="dlterm">Character conversion option</dt>
|
|
<dd>OUTPUT; BINARY(4) Indicates whether the REXEC server performs ASCII-EBCDIC
|
|
character conversion for data that is passed on the stdin, stdout, and stderr
|
|
streams. These values are valid:
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 3. Valid values</caption><thead align="left"><tr valign="bottom"><th valign="bottom" width="19.072164948453608%" id="d0e191">Value</th>
|
|
<th valign="bottom" width="80.9278350515464%" id="d0e193">Operation</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="19.072164948453608%" headers="d0e191 ">0</td>
|
|
<td valign="top" width="80.9278350515464%" headers="d0e193 ">Do not convert data. The server transfers all data on
|
|
the stdin, stdout, and stderr streams without converting it.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="19.072164948453608%" headers="d0e191 ">1</td>
|
|
<td valign="top" width="80.9278350515464%" headers="d0e193 ">Convert data. This is the default. <ul><li>The server converts data in the stdin stream from the ASCII CCSID that
|
|
the CHGRXCA command specifies to the job CCSID. If the job CCSID is 65535,
|
|
the server uses the default CCSID of the job.</li>
|
|
<li>The server converts data in the stdout and stderr streams from the job
|
|
CCSID to the ASCII CCSID that the CHGRXCA command specifies. If the job CCSID
|
|
is 65535, the server uses the default CCSID of the job. </li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Usage notes</h4><ul><li>If you add exit programs to both the QIBM_QTMX_SERVER_REQ and QIBM_QTMX_SVR_SELECT
|
|
exit points, REXEC server first calls the exit program that you add to the
|
|
QIBM_QTMX_SERVER_REQ exit point. If this program allows the operation, the
|
|
server then calls the exit program that you add to the QIBM_QTMX_SVR_SELECT
|
|
exit point.</li>
|
|
<li>When you set the Command processor identifier parameter to 0 (<span class="keyword">i5/OS</span> control language command),
|
|
the conversion option is ignored. The server always performs character conversion
|
|
for the CL commands.</li>
|
|
<li>When you set the command processor identifier to <kbd class="userinput">1</kbd> (<span>Qshell</span> Command),
|
|
the server sets these environment variables: <ul><li>TERMINAL_TYPE=REMOTE</li>
|
|
<li>PATH= /usr/bin:</li>
|
|
<li>LOGNAME= <em>user</em> (where <em>user</em> is the user profile)</li>
|
|
<li>HOME= <em>homedir</em> (where <em>homedir</em> is the user's home directory)</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzal7exitpt.htm" title="This topic includes information about exit points that can be used for controlling REXEC server.">Exit points for controlling REXEC server</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |