TranslateTable (HttpRequest property): Difference between revisions
Jump to navigation
Jump to search
(Automatically generated page update) |
No edit summary |
||
| Line 1: | Line 1: | ||
{{Template:HttpRequest:TranslateTable subtitle}} | {{Template:HttpRequest:TranslateTable subtitle}} | ||
The TranslateTable settable property identifies the system translate table to be used for EBCDIC to ASCII conversion, and for ASCII to EBCDIC conversion in any [[HttpResponse class#The_HttpResponse_class|HttpResponse]] object created by the <var>HttpRequest</var> object. | |||
==Syntax== | ==Syntax== | ||
{{Template:HttpRequest:TranslateTable syntax}} | {{Template:HttpRequest:TranslateTable syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%string</th><td> | <tr><th>%string</th><td>The name of the translate table as loaded by the [[JANUS LOADXT]] command.</td></tr> | ||
<tr><th>httpRequest</th> | <tr><th>httpRequest</th> | ||
<td>HttpRequest object</td></tr> | <td>A previously defined and instantiated <var>HttpRequest</var> object.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | |||
<li>Because an <var>HttpRequest</var> object is not associated with a Janus port when it is instantiated, it uses a default internal EBCDIC to ASCII translate table unless the <var>TranslateTable</var> property is set.</li> | |||
<li>Setting the <var>TranslateTable</var> property to null causes the default internal EBCDIC to ASCII translate table to be used.</li> | |||
<li>EBCDIC to ASCII translation is done as EBCDIC data is added to the <var>HttpRequest</var> object. As such, the <var>TranslateTable</var> property should be set before any data is added to the <var>HttpRequest</var> object and should probably not be changed, once set.</li> | |||
<li>The <var>TranslateTable</var> property is case-sensitive when set, so should probably be set to an all upper case name as was probably used on a [[JANUS LOADXT]] command. | |||
</ul> | |||
==Examples== | ==Examples== | ||
The following sets the translate table for a new <var>HttpRequest</var> object to the <span class="literal">STANDARD</span> translate table: | |||
<p class="code">%httpRequest is object httpRequest | |||
... | |||
%httpRequest = new | |||
%httprequest:translateTable = 'STANDARD' | |||
</p> | |||
==See also== | ==See also== | ||
{{Template:HttpRequest:TranslateTable footer}} | {{Template:HttpRequest:TranslateTable footer}} | ||
Latest revision as of 02:58, 17 March 2013
EBCDIC to ASCII translate table name (HttpRequest class)
[Introduced in Model 204 7.5]
The TranslateTable settable property identifies the system translate table to be used for EBCDIC to ASCII conversion, and for ASCII to EBCDIC conversion in any HttpResponse object created by the HttpRequest object.
Syntax
%currentString = httpRequest:TranslateTable httpRequest:TranslateTable = newString Throws InvalidTranslateTable
Syntax terms
| %string | The name of the translate table as loaded by the JANUS LOADXT command. |
|---|---|
| httpRequest | A previously defined and instantiated HttpRequest object. |
Usage notes
- Because an HttpRequest object is not associated with a Janus port when it is instantiated, it uses a default internal EBCDIC to ASCII translate table unless the TranslateTable property is set.
- Setting the TranslateTable property to null causes the default internal EBCDIC to ASCII translate table to be used.
- EBCDIC to ASCII translation is done as EBCDIC data is added to the HttpRequest object. As such, the TranslateTable property should be set before any data is added to the HttpRequest object and should probably not be changed, once set.
- The TranslateTable property is case-sensitive when set, so should probably be set to an all upper case name as was probably used on a JANUS LOADXT command.
Examples
The following sets the translate table for a new HttpRequest object to the STANDARD translate table:
%httpRequest is object httpRequest ... %httpRequest = new %httprequest:translateTable = 'STANDARD'