Skip to main content
Version: 8.1

Universal Message Translator for IBM i

Return Codes​

The resulting return code from the translation process is converted into an IBM i escape message.

The escape message ID and message severity depend on the return code value. as identified in the following table.

Return Code

Message ID

Message Severity

1 - 10

UNV0344

10

11 - 20

UNV0345

20

21 - 30

UNV0346

30

31 and higher

UNV0347

40

Universal Agent for IBM i Commands​

The names of the Universal Agent for IBM i commands that are installed in the IBM i QSYS library are tagged with the Universal Agent for IBM i version / release / modification number, 810. The names of the commands installed in the Universal Agent for IBM i product library, UNVPRD810, are untagged.

To maintain consistency across releases, you may prefer to use the untagged names in your production environment. The Change Release Tag program, UCHGRLS, lets you change the tagged command names in QSYS to the untagged command names in UNVPRD810.

These pages reference the IBM i commands by their untagged names. If you are using commands with tagged names to run Universal Message Translator, substitute the tagged names for the untagged names in these references.

Configuration Options​

The following table identifies the UMET for IBM i configuration options. Each Option Name is a link to detailed information about that option.

Option Name

Description

IGNORE_CASE

Specification that matching of message masks to the input file is not case sensitive.

MESSAGE_FILE

Input message file name.

MESSAGE_LEVEL

Level of messages that will be written.

TRANSLATION_TABLE

Translation table file name.

Command Line Syntax​

The following figure illustrates the syntax - using the STRUME parameter form of command line options - of UMET for IBM i.

STRUME
TBL([<library>/]{umetbl|<filename>}) [TBLMBR(<member>)]
[MSGFILE([<library>/]{*stdin|<filename>}) [MSGMBR(<member>)] ]

**Additional Options**
[MSGLEVEL(*{verbose|info|warn|error})]
[IGNORECASE({yes|no})]