146 lines
9.3 KiB
HTML
146 lines
9.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="topic" />
|
|
<meta name="DC.Title" content="Module ap_charset" />
|
|
<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="rzaiemod_ap_charset" />
|
|
<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>Module ap_charset</title>
|
|
</head>
|
|
<body id="rzaiemod_ap_charset"><a name="rzaiemod_ap_charset"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<!--Java sync-link--><h1 class="topictitle1">Module ap_charset</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><strong>Summary</strong></p>
|
|
<p>The module ap_charset provides support for performing ASCII to EBCDIC and
|
|
EBCDIC to ASCII codepage conversions. </p>
|
|
<p><strong>Directives</strong></p>
|
|
<ul><li><a href="#defaultfsccsid">DefaultFsCCSID</a></li>
|
|
<li><a href="#usejcd">UseJCD</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="hr" id="defaultfsccsid"><a name="defaultfsccsid"><!-- --></a><h2 class="topictitle2">DefaultFsCCSID</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: ap_charset</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: DefaultFsCCSID <var class="varname">server-character-set-identification-number</var></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: dependent on server settings</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="defaultfsccsid__directiveName_context"><a name="defaultfsccsid__directiveName_context"><!-- --></a>server config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="defaultfsccsid__directiveName_origin"><a name="defaultfsccsid__directiveName_origin"><!-- --></a>iSeries™</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: DefaultFsCCSID 37</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The DefaultFsCCSID directive specifies the CCSID that your server runs
|
|
under, the server character set environment, and the EBCDIC CCSID that is
|
|
used when the server converts:</p>
|
|
<ul><li>Input request data for user CGI programs or Apache modules.</li>
|
|
<li>Output response data from user CGI programs, or Apache modules, to be
|
|
sent back to the requester (client browser).</li>
|
|
</ul>
|
|
<p>A configuration file can contain more than one DefaultFsCCSID directive,
|
|
but the last directive in the configuration file determines the CCSID.</p>
|
|
<p>If the HTTP Server startup value <var class="varname">-fsccsid</var> is specified
|
|
on the <kbd class="userinput">STRTCPSVR</kbd> command or as a parameter on the HTTP
|
|
Administration's start server , the value specified overrides all other settings
|
|
and is used for the server CCSID. </p>
|
|
<p>If there is no startup value specified, but there is a DefaultFsCCSID directive
|
|
in the configuration file, the directive value will be used for the server
|
|
CCSID. </p>
|
|
<p>If there is no startup value specified and there is no DefaultFsCCSID directive
|
|
in the configuration file, then the QCCSID system value is used. If the QCCSID
|
|
system value is set to <var class="varname">65535</var>, then the server job will
|
|
be started with that CCSID. However, the CCSID that the server actually uses
|
|
for conversions will be the job default <var class="varname">ccsid</var> which is
|
|
set to an appropriate value based on the language (LANGID) of the server job.
|
|
</p>
|
|
<p>To display the CCSID of the server, complete the following task:</p>
|
|
<ol><li>Start a 5250 session on your iSeries.</li>
|
|
<li>Type <kbd class="userinput">WRKACTJOB</kbd> (Work Active Job).</li>
|
|
<li>Type a <kbd class="userinput">5</kbd> (Work with...) next to your server job.</li>
|
|
<li>Type a <kbd class="userinput">2</kbd> (Display job definition attributes) on
|
|
the <span class="uicontrol">Work with Job</span> screen.</li>
|
|
<li>Page down until you see the job CCSID fields.</li>
|
|
</ol>
|
|
<blockquote><dl><dt class="dlterm"><strong>Example</strong></dt>
|
|
<dd>In this case, the QCCSID system value was used to start the server job.
|
|
We see that the Coded character set identifier is <var class="varname">65535</var>.
|
|
However, the Default coded character set identifier has been set to <var class="varname">37</var> because
|
|
the Language identifier is ENU (United States English). The server will use
|
|
CCSID 37 as the EBCDIC CCSID.<pre>Language identifier . . . . . . . . . . . . . . . : ENU
|
|
Country or region identifier . . . . . . . . . . : US
|
|
Coded character set identifier . . . . . . . . . : 65535
|
|
Default coded character set identifier . . . . . : 37</pre>
|
|
</dd>
|
|
</dl>
|
|
</blockquote>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="usejcd"><a name="usejcd"><!-- --></a><h2 class="topictitle2">UseJCD</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: ap_charset </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: UseJCD <em>On | Off</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: UseJCD Off </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="usejcd__usejcd_context"><a name="usejcd__usejcd_context"><!-- --></a>server config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="usejcd__usejcd_origin"><a name="usejcd__usejcd_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: UseJCD Off </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>This directive is used to instruct the server to perform Japanese codepage
|
|
detection on the request body. </p>
|
|
<p>Japanese browsers can potentially send data in one of three code pages,
|
|
JIS (ISO-2022-JP), S-JIS (PC-Windows), or EUC (UNIX<sup>®</sup>). If this directive is set to <em>On</em>,
|
|
the server uses a well-known JCD utility to determine which codepage to use
|
|
(if not explicitly specified by a charset tag) to convert the request body. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>On | Off </em></dt>
|
|
<dd><ul><li>When <em>On</em> is specified, the server uses a well-known JCD utility
|
|
to determine which codepage to use (if not explicitly specified by a charset
|
|
tag) to convert the request body. </li>
|
|
<li>When <em>Off</em> is specified, Japanese codepage detection on the request
|
|
body is disabled. </li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>This directive is intended for module writers that need the server to detect
|
|
JCD on the request body. CGI writers can use the CGIConvMode value "EBCDIC_JCD"
|
|
to instruct the server to perform JCD.</p>
|
|
</div>
|
|
</div>
|
|
|
|
</body>
|
|
</html> |