Universal Query for zOS

JCL Procedure

The following figure illustrates the Universal Query for z/OS JCL procedure (UQRYPRC, located in the SUNVSAMP library) that is provided to simplify the execution JCL and future maintenance.


//UQRYPRC  PROC UPARM=,               -- UQUERY options
//             UCMDPRE=#SHLQ.UNV
//*
//PS1      EXEC PGM=UQUERY,PARM='ENVAR(TZ=EST5EDT)/&UPARM'
//STEPLIB  DD  DISP=SHR,DSN=&UCMDPRE..SUNVLOAD
//*
//UNVNLS   DD  DISP=SHR,DSN=&UCMDPRE..SUNVNLS
//UNVTRACE DD  SYSOUT=*
//SYSPRINT DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//CEEDUMP  DD  SYSOUT=*

The parameter UPARM is used to specify EXEC PARM keyword values for Universal Query. The PARM values to the left of the slash ( / ) character are IBM Language Environment parameters.

(See the section on z/OS Installation in the Universal Agent 7.3.x Installation, Upgrade, and Applying Maintenance for information regarding the customization of Language Environment parameters.)

DD Statements used in JCL Procedure

The following table describes the DD statements used in the Universal Query for z/OS JCL procedure illustrated above.
 

ddname

Description

STEPLIB

Load library in which program UQUERY is located.

UNVNLS

UQUERY national language support ddname.

UNVTRACE

UQUERY trace ddname.

SYSPRINT

UQUERY standard output ddname.

SYSOUT

UQUERY standard error ddname.

JCL

The following figure illustrates the Universal Query for z/OS JCL using the UQRYPRC JCL procedure, above.


//jobname  JOB CLASS=A,MSGCLASS=X
//STEP1    EXEC UQRYPRC
//SYSIN    DD  *
-i dallas
/*


Job step STEP1 executes the procedure UQRYPRC.

The command options are specified on the SYSIN DD.

Configuration Options

UQUERY for z/OS operations are controlled by the configuration options, which are specified either on the command lie (via the PARM keyword of the EXEC statement or in the SYSIN ddname) or the configuration file.

The following table identifies the UQUERY configuration options for z/OS. 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.

OUTBOUND_IP

Sets the host or IP address that UQUERY binds to when initiating outgoing connections.

PING

Information Universal Query requests from Universal Broker.

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.

SYSTEM_ID

Local Universal Broker with which the Universal Query must register.

VERSION

Writes the program version and copyright information.

Command Line Syntax

The following figure illustrates the command line syntax — using the command line, long form of the configuration options — of UQUERY for z/OS.

uquery
-host hostaddress
[-port port]
[-system_id ID]
[-ping {yes|no}]
[-report {normal|fixed}]
[-codepage codepage]
[-level {trace|audit|info|warn|error}]
[-lang language]
[-managers {yes|no}]
[-outboundip host]
[-cmdid ID]
[-component ID]

uquery
{ -help | -version }