utleducextd (Command to expand the EBCDIC user table)

This command creates the file for EBCDIC user table expansion. The command also displays the content of the file for EBCDIC user table expansion in the standard output.

Table 1.17 Executability of commands
Grade	User type for DataMagic	Executability
DataMagic Server	Superuser	Executable
DataMagic Server	General user (#1)	Not executable
DataMagic Desktop	-	Not executable

The -r option can be executed by ordinary users also.

Commands

(Creation and display)

utleducextd -i infilename -r {user1|user2|user3} [-o][-path usercodepath]

(Display only)

utleducextd -r {user1|user2|user3} -o [-path usercodepath]

Parameters

-i infilename

File name of the file created to be used as the basis of EBCDIC user table expansion. (This parameter cannot be omitted.)

Use a string of 1 to 200 bytes of characters (Windows) or alphanumeric characters and symbols (UNIX).

-r { user1|user2|user3 }

User table to be expanded

user1: : Expanded as user table 1
user2: : Expanded as user table 2
user3: : Expanded as user table 3

-o

Displays the expanded content in the standard output. (This parameter can be omitted.)

If this parameter is omitted, the content is not displayed in the standard output.

-path usercodepath

Path name for the folder storing the file for EBCDIC user table expansion. (This parameter can be omitted.)

Use a string of 1 to 200 bytes of characters (Windows) or alphanumeric characters and symbols (UNIX).

If you omit this parameter, the following applies:

For Windows: The shared data storage folder is used. If the shared data storage folder is not specified, the current folder is used.
For UNIX: DMPATH is used. If DMPATH is not set, the current directory is used instead.

Note

If you use the -path parameter, you must specify the Path of the EBCDIC user table in the Output Settings screen for data processing information.

Example of using the command for expanding the EBCDIC user table

This example is a conversion of user table 1 from ASCII code to EBCDIC code.

In this example, the yen sign (\) (ASCII: 0x5C) in user table 1 is converted to a backslash (\) (EBCDIC: 0xE0) based on EBCDIC kana characters. The following explains how to make these settings. In the following example, the system administration folder is set to C:\HULFT Family\huledpro\etc.

1. Copy the template file for EBCDIC kana character conversion to a custom file.

For Windows

C:\>copy "C:\HULFT Family\huledpro\etc\ucf\as2ebkn.txt" "C:\temp\work\user1.txt"

For UNIX

% cp $DMPATH/ucf/as2ebkn.txt /home/tmp/user1.txt

2. Edit the copied file.

The file is a text file. Use Notepad (on Windows), vi (on UNIX), or another editor to edit the file.

Content of the EBCDIC user table

For Windows: C:\temp\work\user1.txt
For UNIX: /home/tmp/user1.txt

   |  0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F 
----------------------------------------------------
 0 | 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
 1 | 10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E 1F
 2 | 40 5A 7F 7B E0 6C 50 7D 4D 5D 5C 4E 6B 60 4B 61
 3 | F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 7A 5E 4C 7E 6E 6F
 4 | 7C C1 C2 C3 C4 C5 C6 C7 C8 C9 D1 D2 D3 D4 D5 D6
 5 | D7 D8 D9 E2 E3 E4 E5 E6 E7 E8 E9 4A E0 40 5F 6D
 6 | 79 C1 C2 C3 C4 C5 C6 C7 C8 C9 D1 D2 D3 D4 D5 D6
 7 | D7 D8 D9 E2 E3 E4 E5 E6 E7 E8 E9 C0 4F D0 A1 40
 8 | 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40
 9 | 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40
 A | 40 41 42 43 44 45 46 47 48 49 51 52 53 54 55 56
 B | 58 81 82 83 84 85 86 87 88 89 8A 8C 8D 8E 8F 90
 C | 91 92 93 94 95 96 97 98 99 9A 9D 9E 9F A2 A3 A4
 D | A5 A6 A7 A8 A9 AA AC AD AE AF BA BB BC BD BE BF
 E | 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40
 F | 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40
 #COMMENT=ASCII -> EBCDIC KANA

The nineteenth line, which starts with #, is a comment. You can register up to 60 bytes.
The bold character E0 is the converted character.

Note

In DataMagic, 0x00 is treated as the end of the character string. Therefore, the value shown at the top left of the table (conversion from 0x00) is not in effect.

3. Create the user table 1 expansion file.

For Windows

C:\>"C:\HULFT Family\huledpro\utleducextd" -i
C:\temp\work\user1.txt -r user1 -path
"C:\HULFT Family\huledpro\etc\ucf"

C:\HULFT Family\huledpro\etcf\user1.ucf is created.
If you omit -path, user1.ucf is created in the shared data storage folder.

For UNIX

% utleducextd -i /home/tmp/user1.txt -r user1 -path /home/huled/etc/ucf

/home/huled/etc/ucf/user1.ucf is created.
If you omit -path, $DMPATH/user1.ucf is created.

4. Check the expansion file.

For Windows

C:\>"C:\HULFT Family\huledpro\utleducextd" -r user1 -o
-path "C:\HULFT Family\huledpro\etc\ucf"

The content of C:\HULFT Family\huledpro\etcf\user1.ucf is displayed.
If you omit -path, the content of user1.ucf in the shared data storage folder is displayed.

For UNIX

% utleducextd -r user1 -o -path /home/huled/etc/ucf

The content of /home/huled/etc/ucf/usr1.ucf is displayed.
If you omit -path, $DMPATH/user1.ucf is displayed.