Parameters

For the definitions of the return_code, reason_code, exit_data_length, and exit_data parameters, see Parameters common to all verbs.

rule_array_count

Direction:	Input
Type:	Integer

A pointer to an integer variable containing the number of elements in the rule_array variable. This value must be 1.

rule_array

Direction:	Input
Type:	String array

An array of 8-byte keywords providing the processing control information. The keywords must be left-aligned and padded on the right with space characters. The rule_array keywords are described in Table 1.

Table 1. Keywords for the CSNBXEA utility

Keywords for the CSNBXEA utility

Keyword	Description
Service requested (One, required)
TOASCII	Converts the contents of source_text from EBCDIC character set to ASCII character set using the appropriate code table that is displayed in Usage notes. The result is placed in parameter target_text. The parameters code_table and code_table_length are ignored for this keyword.
TOEBCDIC	Converts the contents of source_text from ASCII character set to EBCDIC character set by using the code table that is displayed in Usage notes. The result is placed in parameter target_text. The parameters code_table and code_table_length are ignored for this keyword.
USETABLE	Converts the contents of source_text from the original character set to a custom character set by using the appropriate code table that is passed by the application in the code_table parameter. The result is placed in parameter target_text. Each byte of the source_text is used to index the code_table to discover the resulting byte for the target_text. This keyword assumes that the conversion data is single-byte aligned. One byte of source_text is used to look up 1 byte of conversion value in the code table. Therefore the code_table_length must be at least 256 bytes. If the code_table_length is larger than 256 bytes, the extra is ignored.

text_length

Direction:	Input
Type:	Integer

A pointer to an integer variable that contains the length of the source_text parameter. The length must be a positive nonzero value.

source_text

Direction:	Input
Type:	String

This parameter contains the string to be converted.

target_text

Direction:	Output
Type:	String

This parameter contains the converted text that is returned by this verb. The size of this buffer must be at least as long as indicated by text_length.

code_table_length

Direction:	Input
Type:	Integer

The size in bytes of the buffer that is passed as the code_table parameter.

code_table

Direction:	Input
Type:	String

A data conversion table that is specified by the user for converting the contents of source_text to target_text.