ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaie_5.4.0.1/rzaierefcgipase.htm

74 lines
4.7 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="topic" />
<meta name="DC.Title" content="CGI in PASE for HTTP Server" />
<meta name="DC.Relation" scheme="URI" content="rzaieparcgi.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaierefcgipase" />
<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>CGI in PASE for HTTP Server</title>
</head>
<body id="rzaierefcgipase"><a name="rzaierefcgipase"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">CGI in PASE for HTTP Server</h1>
<div><div class="important"><span class="importanttitle">Important:</span> Information
for this topic supports the latest PTF levels for HTTP Server for i5/OS .
It is recommended that you install the latest PTFs to upgrade to the latest
level of the HTTP Server for i5/OS. Some of the topics documented here are
not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div>
<p>If your CGI programs currently run on a Unix platform, they may run on
the iSeries™ HTTP
Server in PASE. To do this, store your CGI programs in the QOpenSys file system.
You should then verify that your program will run in PASE. For more information
on how to prepare your code and insure that it will run effectively in PASE,
see the <a href="../rzalf/rzalfpreparing.htm">Prepare programs to run in PASE</a> topic. And finally, use
the <a href="rzaiemod_alias.htm#scriptalias">ScriptAlias</a> directive in the configuration file, httpd.conf,
to map the URL to the program, as you would with any CGI program. </p>
<p>For CGI programs that run in PASE, environment variables are converted
from the CGI job CCSID to the CCSID specified by the ILE environment variable
QIBM_PASE_CCSID. The ILE environment variable PASE_LANG specifies the PASE
Locale. The default values are functions of the current LANGID and CNTRYID
attributes of the CGI job, but the system will use PASE_LANG=POSIX and QIBM_PASE_CCSID=819
if it does not recognize the LANGID and CNTRYID pair. The i5/OS™ PASE LANG
environment variable controls the default locale for an i5/OS PASE program.
These default values may be overridden by setting BOTH ILE enviorment variables
'PASE_LANG' and 'QIBM_PASE_CCSID' using the HTTP directive 'setenv'. If either
of these are not set, the default values (based on LANGID and CNTRYID of the
CGI JOB) will be used. For example, <tt>setenv PASE_LANG JA_JP setenv QIBM_PASE_CCSID
1208</tt> </p>
<p>See <a href="../apis/pase_locales.htm">OS/400<sup>®</sup> PASE
Locales</a> to determine what locales are supported by i5/OS PASE. </p>
<div class="note"><span class="notetitle">Note:</span> CGI programs that reside in PASE must have file names that do not include
the following extensions which are reserved for non-PASE CGI programs: <ul><li>.rexx </li>
<li>.pl </li>
<li>.pgm </li>
<li>.class </li>
</ul>
</div>
<p><strong>Sample CGI Program Configuration </strong></p>
<p>This sample code shows one way to use the ScriptAlias directive to map
your CGI program to a URL. </p>
<pre class="block">ScriptAlias /cgi-pase/ /QOpenSys/myserver/cgi-bin/</pre>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaieparcgi.htm" title="This topic provides information about Common Gateway Interfaces (CGI).">Common Gateway Interface</a></div>
</div>
</div>
</body>
</html>