How to use/display Cyrillic text on Enterprise Server region / 3270 session.

Problem :

How to use/display Cyrillic text on Enterprise Server region / 3270 session.

Resolution :

Follow the steps below:

Configuration for Enterprise Server region:
Under Server > Properties > General > Configuration information text-box set following:
[ES-Environment]
MFCODESET=1251

For the 3270 terminal emulator software (e.g. Rumba):
-Set host code page/character set to e.g. 1051.
-For the Rumba software it may be needed to go to Options > Display > Fonts and select a font that supports Cyrillic text (Tested successfully with calibri).

For COBOL source Code / Project:
-Set language on Windows > Control Panel > Region > Administrative > Set Language for non-Unicode programs to Bulgarian, deselect the “Beta: use Unicode UTF-8 for worldwide support" option, Restart of machine may be required.
-In the Visual Studio IDE, if affected sources are not already using the “Cyrillic(Windows)-Codepage 1251” encoding then these will need to be opened with the relevant encoding via Solution Explorer view > Right click on source file click Open With > Select “Source Code (Text) With Encoding” > Ok > Choose encoding > Ok.
-In Visual Studio IDE, for the affected .cbl/.bms source files, use the File > Save As > Save with encoding option to save the source files with “Cyrillic(Windows)-Codepage 1251” encoding.
-If COBOL Source code uses/processes data containing Cyrillic text and EBCDIC character set, set: (assuming Visual Studio IDE is used) In Project Properties > Application > Environment button add MFCODESET=1251, also select “Use variables when building the project”.
-Recompile/deploy affected programs/BMS screens.

Setup of custom code set file:
Consider using the attached source files CS1251.cbl and codeset.cpy (contained in attached files.zip).
-It is required to locate hex values for each of the Cyrillic characters and edit the codeset.cpy (01  Cset-EBCDIC-ASCII and 01  Cset-ASCII-EBCDIC) to get those included, this is already done on the files attached.
-Compile cs1251.cbl to .GNT format (I.e. from a 32bit Enterprise Developer command prompt, e.g. command: cobol cs1251.cbl GNT(); ).
-Copy the generated cs1251.gnt to the product install folder (Typically in path C:\\Program Files (x86)\\Micro Focus\\Enterprise Developer\\bin) so that the Enterprise Server region can locate this program.
-Set mfcodeset=1251 on affected Enterprise Server region (step already mentioned above).
-Restart MFDS/region so that changes are detected.

Now 3270 sessions will show Bulgarian / Cyrillic text is correctly.