Universal Query for IBM i

Currently, IBM i runs Workload Automation 5.1.1.   These pages provide information for that version.

Workload Automation 5 for IBM i Commands

The names of the Workload Automation 5 for IBM i commands that are installed in the IBM i QSYS library are tagged with the Workload Automation 5 for IBM i version / release / modification number, 511. The names of the commands installed in the Workload Automation 5 for IBM i product library, UNVPRD511, 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 UNVPRD511.

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

Configuration Options

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


Option Name

Description

CODE_PAGE

Character code page used to translate text data received and transmitted over the network.

COMMAND_ID

Requests that Universal Query return information for all records that match the specified command ID.

COMPONENT_ID

Requests that Universal Query return information only for the specified component ID.

HELP

Writes a description of the configuration options and their format.

MANAGERS

Specification for whether or not Universal Query requests manager component information from the queried Broker.

MESSAGE_LANGUAGE

Universal Message Catalog (UMC) file used to write messages.

MESSAGE_LEVEL

Level of messages to write.

PING

Information Universal Query requests from Universal Broker.

PLF_DIRECTORY

Program Lock File (PLF) directory where the program lock files are located.

REMOTE_HOST

IP address of the remote computer.

REMOTE_PORT

TCP port number on the remote computer on which Universal Broker is accepting connections.

REPORT

Format in which Universal Broker information is written.

VERSION

Writes the program version and copyright information.

Command Line Syntax

The following figure illustrates the command line syntax — using the STRUQR parameter form of command line options — of UQUERY for IBM i.

STRUQR
HOST(hostaddress)
[PORT(port)]
[PING(*{yes|no})]
[REPORT(*{normal|fixed})]
[CODEPAGE(codepage)]
[MSGLANG(language)]
[MSGLEVEL(*{trace|audit|info|warn|error}]							
         (NOTE: trace turns on the Trace function.)
[OUTBOUNDIP(host|blank_line)]
[CMDID(ID)]
[COMPID(ID)]
[MANAGERS(*{yes|no})]
[PLFDIR(ifs_directory)]

STRUQR
VERSION(*{yes|no})