This section covers the following topics:

• Set the Size of the Return-Page Transport Buffer

• Create a User-Defined Error Page

• Create a User-Defined Error Page XML-Style

• Alphanumeric-to-HTML Conversion

• Alphanumeric-to-URL Conversion

---

Set the Size of the Return-Page Transport Buffer

This section applies to SYSWEB only.

Changing the Transport Send Buffer Width

To change the transport send buffer width:

1. Change the upper bound of the variable RETURN_PAGE in the parameter data area W3PARM.

   Use this value for the parameter NWW_INOUT_LENGTH in the initialization file used for the Natural Web Server Extension program and the initialization of the value ##HTTP_RETURN_PAGE_PART in the Local Data Area W3LIMITS.

   This defines the maximum length of the transport buffer.

2. Recatalog all W3* sources from library SYSWEB.

3. Recatalog all subprograms that are to be called using the Natural Web Server Extension,
   all NAT-*, HTTP* and NAT-* programs from the library SYSWEB.

Changing the Received Data Buffer Width

To change the received data buffer width:

1. Initialize ##HTTP_ENVIRONMENT_MAX in the local data area W3LIMITS.

   This defines the maximum length of received data.

   This value must be less than or equal to the maximum length of the transport buffer (see above).

2. Recatalog all W3* sources from the library SYSWEB.

3. Recatalog all subprograms which are to be called using the Natural Web Server Extension,
   all NAT-*, HTTP* and NAT-* programs from library SYSWEB.

Changing Your Return Page

To change your return page:

1. Initialize ##HTTP_RETURN_PAGE_MAX in the local data area W3LIMITS.

   This defines the maximum length of return page.

2. Recatalog all W3* sources from library SYSWEB.

3. Recatalog all subprograms that are to be called using the Natural Web Server Extension,
   all NAT-*, HTTP* and NAT-* programs from the library SYSWEB.

Create a User-Defined Error Page

If a Natural error occurs and the default ON ERROR block is specified, W3ERROR will be called and a predefined error page will be generated.

If you want to change this error page, change the Subroutine W3ERROR-TEMPLATE (SYSWEB/W3ERRTMP or SYSWEB3/W3ERRTMP accordingly).

This program generates a complete HTML page.

Create a User-Defined Error Page XML-Style

If a Natural error occurs and the default ON ERROR block is specified, W3ERROR will be called and a predefined error page will be generated.

If you want to change this error page to an XML-conform HTML, proceed as follows:

1. Uncatalog the subroutine (SYSWEB/W3ERRTMP or SYSWEB3/W3ERRTMP accordingly).

2. Open the subroutine SYSWEB/W3ERXTMP or SYSWEB3/W3ERXTMP accordingly).

3. Rename W3ERROR-TEMPLATE-XML to W3ERROR-TEMPLATE.

4. Stow the program.

This program now generates a complete XML-conform HTML page.

Alphanumeric-to-HTML Conversion

For a conversion to HTML, special characters have to be replaced by the correct HTML representation.

• The subroutine W3-ASCII-HTML-TABLE (SYSWEBP/W3AS2HT) contains the settings for the replacement of characters.

• W3INIT and W3-TEXT-TO-HTML will call W3-ASCII-HTML-TABLE.

It is possible to save up to 128 replacements.

If HEX values are used for the definition (e.g. quote), a value for the ASCII and one for the EBCDIC character set has to be defined. Otherwise the file is not portable.

Alphanumeric-to-URL Conversion

For URL decoding, some special characters have to be replaced by the correct URL-conform representations.

• The subroutine H3-ASCII-URL-TABLE (SYSWEB/H3AS3URL or SYSWEB3/H3AS3URL accordingly) contains the settings for the replacement of characters.

• H3-ASCII-URL-TABLE will be called by H3-TEXT-TO-URL.

It is possible to save up to 128 replacements.

If HEX values are used for the definition (e.g. quote), a value for the ASCII and one for the EBCDIC character set has to be defined. Otherwise the file is not portable.