FCOPY Reference Manual (32212-90008)

50 Chapter3
FCOPY Applications and Examples
Copying Files in Native Languages
Copying Files in Native Languages
You can use the LANG parameter with four FCOPY functions to copy files in a particular
native language. The four functions are CHAR, EBCDICIN, EBCDICOUT, and UPSHIFT. You can
use LANG to describe a language name or number in the form:
LANG=
language
where
language
represents a language name or number. The language you specify must
be installed on your system.
If you omit the LANG parameter, FCOPY uses the current language. If there is no current
language, FCOPY uses the default, NATIVE-3000. Refer to the Native Language Support
Reference Manual (32414-90001) for MPE V/E or (32650-90022) for MPE XL for more
information on using native languages.
Use with CHAR
When you specify a language with the CHAR function, FCOPY uses the character definition
table associated with the language to display these characters. It replaces undefined
graphic characters and control codes with periods. For example, the command below
instructs FCOPY to display the contents of a file in German characters:
>FROM=DEUTSCH;TO=;LANG=GERMAN;CHAR;NORECNUM
Use with EBCDICIN/OUT
EBCDICIN converts a file from EBCDIC to ASCII and EBCDICOUT converts a file from ASCII
to EBCDIC. When you use LANG with either of these functions, FCOPY uses the
translation table associated with the given language to convert the file. For example, using
an EBCDIC-to-ASCII conversion table, FCOPY converts data from German EBCDIC to
ROMAN8:
>FROM=MYGEBCFL;TO=MYROM8FL;LANG=GERMAN;EBCDICIN
EOF FOUND IN FROMFILE AFTER RECORD 29
30 RECORDS PROCESSED * * * 0 ERRORS
Use with UPSHIFT
UPSHIFT converts lowercase characters to uppercase as you copy them to another file.
When you specify a language together with UPSHIFT, FCOPY converts characters
according to the rules of the given language. For example, the command below copies the
file DEUTSCH to a printer, converting lowercase German characters to uppercase German
characters:
>FROM=DEUTSCH;TO=*LP;LANG=GERMAN;UPSHIFT