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.7.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 }

Browser not supported