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 |
---|---|
Character code page used to translate text data received and transmitted over the network. | |
Requests that Universal Query return information for all records that match the specified command ID. | |
Requests that Universal Query return information only for the specified component ID. | |
Writes a description of the configuration options and their format. | |
Specification for whether or not Universal Query requests manager component information from the queried Broker. | |
Universal Message Catalog (UMC) file used to write messages. | |
Level of messages to write. | |
Sets the host or IP address that UQUERY binds to when initiating outgoing connections. | |
Information Universal Query requests from Universal Broker. | |
IP address of the remote computer. | |
TCP port number on the remote computer on which Universal Broker is accepting connections. | |
Format in which Universal Broker information is written. | |
Local Universal Broker with which the Universal Query must register. | |
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 }