SIO_MODE - UCMD Manager configuration option

Description

The SIO_MODE option specifies whether transferred data is treated as text or binary.

It also can specify, optionally, the translation method for a text data transfer. The translation method specifies how the text translation is performed.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

-m mode[,method]


(tick)

(tick)

(tick)

Command Line, Long Form

-mode mode[,method]


(tick)

(tick)

(tick)

Environment Variable

n/a





Configuration File Keyword

n/a





STRUCM stdin Parameter

STRUCM stdout Parameter

STRUCM stderr Parameter

SINMODE(*mode)

SOTMODE(*mode)

SERMODE(*mode)

(tick)




Values

mode is the specification for how transferred data is treated.

Valid values for mode are:

  • text
    Treat the data as text. The data is translated to and from local character code pages.
    An example of text data is reports. Reports contain character data that must be translated from one code page to another if they are to be read on the receiving system.
  • binary
    Treat the data as binary. The data is not translated in any way.
    An example of binary data is backup files. Backup files are not viewed on the receiving system. They contain non-printable characters that are used for its internal representation.

Default is text.


IBM i

An asterisk ( * ) must be entered with mode, as shown above, in the selected parameter. If an asterisk is not entered, an error message will show. Do not enter an asterisk in the command line.


method is the method to use for translation TEXT data.

(Specify the method after the mode, separated by a comma and no spaces.)

Valid values for method are:

  • ucs
    Text translation is performed by converting local codepages to the Universal Character Set (Unicode) format and back again.
    This method requires:
    • Less time and network resources to establish network connections between the UCMD Manager and remote server.
    • More time and CPU resources to perform the text translation.
  • direct
    Text translation is performed by converting directly from the local codepage to the remote codepage.
    This method requires:
    • More time and network resources to establish network connections between the UCMD Manager and remote server.
    • Less time and CPU resources to perform the text translation.

Note

For transferring large amounts of text data, the direct method is recommended.

Default is direct.