...

Since platform requirements may change with new releases of a product, see Platform Support for Universal Controller 7.12.x and Universal Agent 7.12.x to make sure that your platform is supported before performing an installation.

The Universal Agent 7.2.x for z/OS product distribution file - sb-7.12.x.x-zos.tar.Z - is available for download from the Stonebranch Customer Portal.

...

Step 1	Download one of the Universal Agent 7.2.x for z/OS product distribution files.
Step 2a	If one of the distribution files with the .tar.Z extension was downloaded, decompress it using any utility that can process files in Lempel-Ziv (that is, compress) format. Use tar to extract the files from the uncompressed file. To do both in a single statement, decompress the file to stdout and pipe the result to tar (for example, zcat sb-v.r.m.l-zos.tar.Z \| tar xvf -).
Step 2b	If one of the distribution files with the .zip extension was downloaded, decompress it using any utility that can process files in ZIP (or, PKZIP) format. The .zip file can also be extracted using Windows native file extraction tools.
Step 3	Modify the UNVFTP.TXT script provided by the distribution file. This script contains statements to upload the installation files and sample JCL, which can be used to process the files after upload. Two versions of these files are included in the distribution file. The files in the main directory are EBCDIC-encoded files. ASCII-encoded versions of these files are in the `./ascii` subdirectory. See z/OS Installation - Transferring Installation Files to z/OS for complete details.
Step 4	Modify the JCL uploaded from UNVRECV.JCL and run the job to receive the TSO XMIT file(s). If the distribution file that contains the DFDSS archive is used, UNVRECV.JCL also contains a step to restore the contents of the archive. See Receive the Installation Datasets for complete details.
Step 5	Edit the INSTALL(#SETUP) member to meet local requirements as described in the #SETUP comment prolog. #SETUP creates customized installation JCL members in the INSTALL library. Execute the installation jobs as required for your SMP/E environment. See z/OS Installation - SMPE Installation for complete details.
Step 6	Create started task user and group profiles for Universal Broker and Universal Enterprise Controller. See z/OS Configuration - Started Tasks for complete details.
Step 7	Define the SUNVLOAD library to APF, Program Control, and LNKLST. See z/OS Configuration - Load Library for complete details.
Step 8	Define SMF exits for Universal Command and Universal Automation Center Agent. See z/OS Configuration - SMF Exits for complete details.
Step 9	Configure the UNIX System Services file systems used by the Universal Broker and Universal Enterprise Controller. See Universal Agent Database Configuration for complete details.
Step 10	Perform individual component customization, including JCL procedure edits and adding component licenses. See z/OS Installation - Customization for complete details.
Step 11	Follow the optional steps described in z/OS USS Installation to complete the installation, if desired.

Licensing your Universal Agent 7.

...

2.x for z/OS Components

Note

title	Note

A Universal Agent eventually will be required to obtain its license information from a Universal Controller or UCAM installation. Support for locally-configured license information will be removed at that time.

After Universal Agent 7.12.x for z/OS has been installed, you must configure the following Universal Agent components with product licenses before they can be used:

...

The following is a sample Universal Command Manager for z/OS product license file:

Panel

Html bobswift

<pre>
License_Product "AGENT"
License_Customer "STONEBRANCH"
License_OS_Type "MVS"
License_Type "PERPETUAL"
License_Expiration_Date 2030.12.31          YYYY.MM.DD
License_NT_Servers 100
License_UNIX_Servers 100
License_OS400_Servers 10000
License_OS390_Servers 10000
License_Tandem_Servers 10000
License_OS390_Unix_Servers 10000
License_Key ABCD-1234-EFGH-5678-IJKL-MNOP-9999
</pre>

Universal Data Mover Manager License File

...

The following is a sample Universal Data Mover Manager for z/OS product license file:

Panel

Html bobswift

<pre>
License_Product "MFT"
License_Customer "STONEBRANCH"
License_OS_Type "MVS"
License_Type "PERPETUAL"
License_Expiration_Date 2030.12.31          YYYY.MM.DD
License_NT_Servers 100
License_UNIX_Servers 100
License_OS400_Servers 10000
License_OS390_Servers 10000
License_OS390_Unix_Servers 10000
License_Key ABCD-1234-EFGH-5678-IJKL-MNOP-9999
</pre>

UNVCONF Product Library

In the UNVCONF product library:

...

Stop Universal Broker

Panel

Html bobswift
<pre> STOP UBROKER </pre>

Start Universal Broker

Panel

Html bobswift
<pre> START UBROKER[,UPARM='options'] </pre>

Encrypting User ID and Password for Job Execution

...

The following JCL example executes the UENCRYPT utility that encrypts command options it reads from the UNVIN ddname and writes them to the UNVOUT ddname in the form of an encrypted command file. This example creates member DALLAS in the PDS/E PROD.UNV.USERS. The DALLAS member will contain the user ID and password options specified in the UNVIN ddname in a UENCRYPT format.

Panel

Html bobswift

<pre>
//jobname  JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//STEP1    EXEC PGM=UENCRYPT
//STEPLIB  DD  DISP=SHR,DSN=#SHLQ.UNV.SUNVLOAD
//UNVIN    DD  *
 -USERID USR100 -PWD ABCDEF
/*
//UNVOUT   DD  DSN=PROD.UNV.USERS(DALLAS),DISP=SHR
//SYSPRINT DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//SYSIN    DD  DUMMY
</pre>

Executing a Universal Command Job

The following JCL example executes the UNIX command "ls -l" on remote host DALLAS using the encrypted command file created above.

Panel

Html bobswift

<pre>
//jobname  JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//*
//         JCLLIB ORDER=#SHLQ.UNV.SUNVSAMP
//*
//STEP1    EXEC UCMDPRC
//USER     DD  DSN=PROD.UNV.USERS(DALLAS),DISP=SHR
//SYSIN    DD  *
-cmd 'ls -l' -host dallas -encryptedfile user
/*
</pre>

Executing a Universal Data Mover Job

...

The following JCL example executes Universal Data Mover. Universal Data Mover always reads the script from the UNVSCR ddname. In this example, the script establishes a session with remote host DALLAS and transfers the data set allocated to ddname DATA to file app.data on the remote host. The default transfer mode of binary is used for transferring the data.

Panel

Html bobswift

<pre>
//jobname  JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//STEP1    EXEC UDMPRC
//DATA     DD  DSN=APP.DATA,DISP=SHR
//USER     DD  DSN=PROD.UNV.USERS(DALLAS),DISP=SHR
//UNVSCR   DD  *
set echo=yes halton=warn
open dest=dallas xfile=user
filesys local=dd
copy local=data dest=app.data
quit
/*
</pre>

Running a System Query

Use the Universal Query utility to query the Universal Broker for Broker and active component information. Universal Query returns information about the Universal Broker, as specified by configuration options, as well as information regarding the components managed by Universal Broker.

The following JCL example executes the UQUERY utility. In this example, UQUERY will query the Broker running on host DALLAS.

Panel

Html bobswift
<pre> //jobname JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID //* // JCLLIB ORDER=#SHLQ.UNV.SUNVSAMP //* //STEP1 EXEC UQRYPRC //SYSIN DD * -host dallas /* </pre>

Versions Compared

Old Version 2

New Version Current

Key

Licensing your Universal Agent 7.

2.x for z/OS Components

Universal Data Mover Manager License File

UNVCONF Product Library

Encrypting User ID and Password for Job Execution

Executing a Universal Command Job

Executing a Universal Data Mover Job

Running a System Query

Page Comparison

Versions Compared

Old Version 2

New Version Current

Key

Licensing your Universal Agent 7.

2.x for z/OS Components

Universal Data Mover Manager License File

UNVCONF Product Library

Encrypting User ID and Password for Job Execution

Executing a Universal Command Job

Executing a Universal Data Mover Job

Running a System Query