PROCEDURE DIVISION

 
CALL 'CBLDCUTL' USING unique-name-1 unique-name-1 unique-name-1
 

DATA DIVISION

 
01 unique-name-1.
   02 data-name-A PIC X(8)  VALUE 'CNVOPN  '.
   02 data-name-B PIC X(5).
   02 FILLER     PIC X(3).
   02 data-name-C PIC X(256) 
   02 data-name-D PIC S9(9) COMP.
   02 data-name-E PIC 9(9) COMP.
 

Starts character code conversion to allocate a code mapping table to be used in the memory.

• data-name-A
  Set VALUE 'CNVOPN ' as the request code for indicating the start of character code conversion.
  
• data-name-C
  Set a blank.
  
• data-name-D
  Specify the conversion method.
  1: Links with CommuniNet for conversion.
  0: Performs conversion by operations without using a code mapping table.
  

• data-name-B
  A status code is returned using a five-digit number.
  
• data-name-E
  The handle of a character code conversion control table allocated on the memory is returned.
  

Status code	Meaning
00000	Normal termination
02501	Invalid value for the data name. The request code (data-name-A) may be invalid.
02504	Insufficient memory
02557	No code mapping table exists.
02558	This status does not support using the code mapping table. This status code is also returned if a code mapping table is not saved using the CommuniNet code mapping utility after the installation of CommuniNet.
02559	An I/O error occurred in the code mapping table.

Specify three unique names 1 for the USING clause in the CALL statement.

• The use of this function requires a CommuniNet code mapping table. Before using this function, create a code mapping table using the CommuniNet code mapping utility.
• You cannot use a code mapping table unless you first save the table using the CommuniNet code mapping utility after the installation of CommuniNet. Before using this function, save a code mapping table using the CommuniNet code mapping utility.
• The filename of a CommuniNet code mapping table must be CMAPEX.TBL. Store the code mapping table under a Windows directory before using this function.
• The processing by the character code converter does not reflect the changes in the contents of a code mapping table changed by the CommuniNet code mapping utility during the use of this function.
• This function does not save error logs and UAP trace information.
• Issue the function for starting character code conversion (CBLDCUTL('CNVOPN ')) only once for code conversion (CBLDCUTL('CNVEXEC ')). Do not issue the function for starting character code conversion more than once to prevent memory shortage. If you issue two or more functions, issue one function for terminating character code conversion (CBLDCUTL('CNVCLS ')) for each of the issued functions.