Module ap_charset

Important: 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 http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center for more information.

Summary

The module ap_charset provides support for performing ASCII to EBCDIC and EBCDIC to ASCII codepage conversions.

Directives

DefaultFsCCSID

Module: ap_charset
Syntax: DefaultFsCCSID server-character-set-identification-number
Default: dependent on server settings
Context: server config
Override: none
Origin: iSeries™
Example: DefaultFsCCSID 37

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:

A configuration file can contain more than one DefaultFsCCSID directive, but the last directive in the configuration file determines the CCSID.

If the HTTP Server startup value -fsccsid is specified on the STRTCPSVR 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.

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.

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 65535, 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 ccsid which is set to an appropriate value based on the language (LANGID) of the server job.

To display the CCSID of the server, complete the following task:

  1. Start a 5250 session on your iSeries.
  2. Type WRKACTJOB (Work Active Job).
  3. Type a 5 (Work with...) next to your server job.
  4. Type a 2 (Display job definition attributes) on the Work with Job screen.
  5. Page down until you see the job CCSID fields.
Example
In this case, the QCCSID system value was used to start the server job. We see that the Coded character set identifier is 65535. However, the Default coded character set identifier has been set to 37 because the Language identifier is ENU (United States English). The server will use CCSID 37 as the EBCDIC CCSID.
Language identifier . . . . . . . . . . . . . . . :   ENU       
Country or region identifier  . . . . . . . . . . :   US        
Coded character set identifier  . . . . . . . . . :   65535     
Default coded character set identifier  . . . . . :   37

UseJCD

Module: ap_charset
Syntax: UseJCD On | Off
Default: UseJCD Off
Context: server config
Override: none
Origin: iSeries
Example: UseJCD Off

This directive is used to instruct the server to perform Japanese codepage detection on the request body.

Japanese browsers can potentially send data in one of three code pages, JIS (ISO-2022-JP), S-JIS (PC-Windows), or EUC (UNIX®). If this directive is set to On, 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.

Parameter: On | Off
  • When On 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.
  • When Off is specified, Japanese codepage detection on the request body is disabled.

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.