TIB Rv-Zos Installation
TIB Rv-Zos Installation
Contents
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Changes from the Previous Release of this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Third Party Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvi
How to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvi
How to Access All TIBCO Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvi
How to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvi
Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Storage Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
System Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
MVS Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Chapter 2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Before Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Distribution Media and Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Complete Replacement Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Component Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Obtaining the Installation Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Checklist for Rendezvous Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Uploading the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Initial Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Rendezvous MVS Installation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Verifying the Rendezvous Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Optional Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Compiling C Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Compiling COBOL Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Tables
Preface
Topics
This section itemizes the major changes from the previous release of this guide.
Revised Content
The following have been revised:
• Updated the installation files to the current release. For details, see Obtaining
the Installation Media on page 9.
• Updated the list of Rendezvous installed data sets. For details, see Table 14,
Installed Data Sets, on page 39.
Related Documentation
Publication Title
IBM RACF User’s Guide
IBM z/OS Security Server RACF User’s Guide
Publication Title
IBM REXX/370 User’s Guide
Typographical Conventions
Convention Use
TIBCO_HOME Many TIBCO products must be installed within the same home directory. This
directory is referenced in documentation as TIBCO_HOME. The value of
ENV_HOME
TIBCO_HOME depends on the operating system. For example, on Windows
TIBRV_HOME systems, the default value is C:\tibco.
Other TIBCO products are installed into an installation environment. Incompatible
products and multiple instances of the same product are installed into different
installation environments. An environment home directory is referenced in
documentation as ENV_HOME. The default value of ENV_HOME depends on the
operating system. For example, on Windows systems the default value is
C:\tibco.
code font Code font identifies commands, code examples, filenames, pathnames, and
output displayed in a command window. For example:
Use MyCommand to start the foo process.
Convention Use
italic font Italic font is used in the following ways:
• To indicate a document title. For example: See TIBCO FTL Concepts.
• To introduce new terms For example: A portal page may contain several
portlets. Portlets are mini-applications that run in a portal.
• To indicate a variable in a command or code syntax that you must replace.
For example: MyCommand PathName
Key Key name separated by a plus sign indicate keys pressed simultaneously. For
combinations example: Ctrl+C.
Key names separated by a comma and space indicate keys pressed one after the
other. For example: Esc, Ctrl+Q.
The note icon indicates information that is of special interest or importance, for
example, an additional action required only in certain circumstances.
The tip icon indicates an idea that could be useful, for example, a way to apply
the information provided in the current section to achieve a specific result.
The warning icon indicates the potential for a damaging situation, for example,
data loss or corruption if certain steps are taken or not taken.
Convention Use
[ ] An optional item in a command or code syntax.
For example:
MyCommand [optional_parameter] required_parameter
| A logical OR that separates multiple items of which only one may be chosen.
For example, you can select only one of the following parameters:
MyCommand para1 | param2 | param3
Convention Use
{ } A logical group of items in a command. Other syntax notations may appear
within each logical group.
For example, the following command requires two parameters, which can be
either the pair param1 and param2, or the pair param3 and param4.
MyCommand {param1 param2} | {param3 param4}
In the next example, the command requires two parameters. The first parameter
can be either param1 or param2 and the second can be either param3 or param4:
MyCommand {param1 | param2} {param3 | param4}
In the next example, the command can accept either two or three parameters.
The first parameter must be param1. You can optionally include param2 as the
second parameter. And the last parameter is either param3 or param4.
MyCommand param1 [param2] {param3 | param4}
Chapter 1 Introduction
Topics
• Overview, page 2
• Hardware Requirements, page 3
• System Software Requirements, page 4
Overview
Hardware Requirements
Before you can begin using the Rendezvous product, your system must have the
appropriate network hardware to support IBM TCP/IP (for example, an ethernet
adapter card) should be installed and properly configured.
The network should be broadcast-capable. For messages to be seen in the local
subnet, the network interface must support UDP broadcast or multicast. If your
network interface does not support UDP broadcast, the Rendezvous software will
not function to its full capability.
Storage Requirements
Rendezvous for the MVS environment requires approximately 350 cylinders of
Direct-Access Storage Device (DASD) space. This spaces calculation is based on
an IBM 3390 DASD device.
MVS Environment
Before installing Rendezvous software in an MVS environment, you must ensure
that the following software components are installed and properly configured:
TCP/IP
Rendezvous z/OS only supports the IBM TCP/IP environment. A TIBCO
messaging client for z/OS is expected to be installed and operated within a
previously existing, fully functional and integrated network. At a minimum, this
includes the following:
• The TCP/IP protocol stack within the z/OS Communications Server.
• A DNS server that provides the host name and host address of the TIBCO
Rendezvous daemon (if the daemon is not running on the same host).
• Unrestricted network connectivity between the DNS, the TIBCO Rendezvous
Client, and the TIBCO Rendezvous daemon (if the daemon is not running on
the same host).
Customers running z/OS version 1.6 and above should be running a properly
configured and customized RESOLVER address space.
Customers should review their TCPCONFIG parameters to ensure that they meet
the installation’s needs. If the customer chooses to run the TIBCO messaging
client non-APF authorized, the RESTRICTLOWPORTS parameter should be used.
If customers want to control TCP buffering, to limit storage usage, or to support
large bandwidth devices, the TCPSENDBFRSIZE, TCPRCVBUFRSIZE, and
TCPMAXRCVBUFRSIZE parameters may be needed. TIBCO Software typically
recommends that customers override the IBM default of 16K by setting
TCPRCVBUFRSIZE and TCPSENDBFRSIZE to a minimum value of 48K.
Next, you must make sure that the following required or recommended TCP and
UDP parameters are appropriately set in the TCP Profile:
Parameter Setting
TCPCONFIG RESTRICTLOWPORTS
TCPSENDB 48K
TCPRCVB 48K
UDPCONFIG RESTRICTLOWPORTS
UDPCHKSUM
UDPQUEUELIMIT
UDPSENDB 32768
UDPRCVB 32768
LE
LE is the language environment. The C language and/or COBOL for MVS
compilers are required for application development under this environment.
IBM TCP uses the OE socket interface. Therefore, all user id's running
Rendezvous daemons or client programs must have an OMVS UID and GID.
Define these values in the OMVS segment of the USERID and GROUP records in
RACF.
For more information, please refer to User Profile Requirements on page 22.
SSL
Rendezvous z/OS supports the following certificate formats:
• PEM (Privacy Enhanced Mail)
• PKCS#12
For details on SSL usage in Rendezvous, see TIBCO Rendezvous Concepts and
TIBCO Rendezvous Administration.
Chapter 2 Installation
This chapter describes how to install the TIBCO Rendezvous z/OS software.
Topics
Before Installation
Table 5 provides a checklist of variables and data set HLQs (High Level
Qualifiers) that you should obtain before performing the installation process. All
Rendezvous supplied JCL and procedures have a standard naming convention.
You must replace TIBCO site-specific installation-defined variables such as JCL
SET statements, procedure overrides, SYSIN data and system data set HLQ with
user values. You must also replace TIBCO Software variables before the JCL's can
be submitted for execution.
It is recommended that you make a copy of the General Variables table below and
then review and complete the entries. Use the User Value column to insert
appropriate values for your site.
Here is a description of the table column headings:
The Description column provides instructional information.
The Variable column supplies the variable name, as they will appear in the
provided JCL(S) and/or the member names. There may be several instances of the
same variable within a specific member.
The User Value column is left blank so you can insert the appropriate
replacement value.
Component Code
The component code for the TIBCO Rendezvous products is RVB. This component
code is registered with the IBM product codes division.
Requesting a CD
If you do not want to download the software over the network, you can obtain a
CD containing the Rendezvous software and load it directly onto your system.
The minimum time period for delivery of a CD is five working days. Contact
TIBCO Support and request the desired media for your environment. For details,
see Connecting with TIBCO Resources on page xvi.
Obtain the data set and or member name PROC RVD, RVRD,
where your site TCPDATA information RVSD, RVSRD,
resides. RVA, and
RVCACHE
If you have acquired the Rendezvous software by downloading it from the TIBCO
web site rather than via a cartridge, you will need to upload the Rendezvous
software to the MVS host system using the FTP file transfer utility. Following is a
sample JCL that details how to perform this file transfer:
Initial Installation
The <USERHLQ>.XMIT.INST file contains JCL that is required to receive other files
and to create the appropriate libraries for Rendezvous. To complete this process,
the TIBCO supplied variables must be substituted with the appropriate
site-specific user values.
Follow these steps:
1. From the ISPF Command Shell Panel, type the following command to receive
a file containing the JCL required to begin a first-time installation:
receive inda('<USERHLQ>.XMIT.INST')
DA('<USERHLQ>.INSTALL')
The data set name supplied in step 2 is output and populated with the members
that are required in order for you to continue with the installation.
The following steps are required to install the MVS components for Rendezvous.
All members reside in the <USERHLQ>.INSTALL dataset.
Edit the data sets and selected members listed in the steps below. Substitute the
variables, follow any instructions that are contained in the member and then
submit the JCL for execution.
VOLSER TIB999
Volume Serial
JOBNAME RVB84
First 5 characters are used
JOBCLASS A
MSGCLASS X
Member: RVB$4ALL
The following table defines the user substitution variables within JCL and
parameter members that are required during the file tailoring process. Ensure that
you have all the necessary information before executing the next step (Step 6).
STEP 7: Populate the Rendezvous data sets with all the update and
downloaded members.
Member: RVB$7UPD
This section provides information that allows you to tests verify that Rendezvous
components have been correctly installed and configured.
Step I1: Network daemon startup JCL
Replace the Rendezvous variables with the appropriate user values. This member
will start the Rendezvous daemon.
After you have started the network daemon, you need to determine if it is
operating correctly by performing a sample publish-and-subscribe operation.
You can use an http browser interface as a method for verifying that the daemon
is running before continuing with the following steps.
For example, specify the following:
http://hostname_or_IP_address:7580/
Replace the Rendezvous variables with the appropriate user values. This member
will initiate a Rendezvous listener that receives messages from the publisher.
Replace the Rendezvous variables with the appropriate user values. This member
will initiate a Rendezvous sender that publishes a message to an already
executing listener.
Member: RVBISND
After you have examined the output of the previous execution, you may consider
testing certified messaging (RVCM) by performing the IVPs for RVCM publish
and subscribe.
Replace the Rendezvous variables with the appropriate user values. This member
will allocate the Rendezvous certified messaging ledger files.
Replace the Rendezvous variables with the appropriate user values. This member
will initiate a Rendezvous certified messaging (CM) listener that receives
messages from the certified messaging (CM) publisher. The listener sends the
confirmation back to the publisher.
Replace the Rendezvous variables with the appropriate user values. This member
will initiate a Rendezvous certified messaging (CM) sender that publishes
messages.
Optional Installation
Compiling C Programs
Step 1a: C language options file
This member is the Options File used for Rendezvous C compiles that needs to
include members from the system C and Rendezvous libraries. Substitute the
appropriate values and installation variables that are located within this member.
The JCL listed below uses a procedure, which may have to be modified so that it
conforms to your site’s requirements and executes correctly.
The JCL listed below uses a procedure, which may have to be modified so that it
conforms to your site's requirements and executes correctly. This member will
compile COBOL supplied sample program(s).
The installation procedure is identical to other UNIX installations. For details, see
the UNIX installation sections in TIBCO Rendezvous Installation.
../J5.0/bin/java -version
For z/OS platforms, compare the command output with the following
requirements:
java version "1.5.0"
Java(TM) 2 Runtime Environment, Standard Edition (build
pmz31devifx-20071025 (SR6b))
IBM J9 VM (build 2.3, J2RE 1.5.0 IBM J9 2.3 z/OS s390-31
j9vmmz3123-20071007 (JIT enabled)
J9VM - 20071004_14218_bHdSMr
JIT - 20070820_1846ifx1_r8
GC - 200708_10)
JCL - 20071025
Topics.
USER=TIBCO01
OMVS INFORMATION
UID= 0000012345
HOME= /tibco/tibco01
PROGRAM= /bin/sh
CPUTIMEMAX= NONE
ASSIZEMAX= NONE
FILEPROCMAX= NONE
PROCUSERMAX= NONE
THREADSMAX= NONE
MMAPAREAMAX= NONE
***
1. First, you need to copy the RVD / RVRD procedures from <USERHLQ>.PROC
into a procedure library that is defined in the JES2 startup.
2. Modify the variables <USERHLQ> and the data set name that contains the
TCPDATA member.
3. The daemon procedures can now be started from the MVS console.
The daemon procedures are long-running applications. The Rendezvous
daemons support operational commands to terminate them. For the syntax and
usage of these commands, refer to z/OS MVS System Commands.
When you start a daemon, the following messages are written to the system log:
RVB1000I Rendezvous Daemon Started.
RVB1001I Rendezvous Daemon ports. Listen:7500 Http:7580
When you issue the command to stop a daemon, you will see the following
message in the system log:
RVB1009I Rendezvous daemon shutdown in progress
This statement identifies the stack that the application will use.
Time Zone
The daemon receives timestamps from the z/OS LE environment. If you have not
configured the LE environment with the correct time zone, then messages from
the daemon report time in GMT format.
You can dynamically set the time zone by setting the TZ environment variable in
the daemon’s startup JCL or PROC. Use either of the following examples as a
model (adjusting for your actual time zone):
//RVD EXEC PGM=RVD,PARM='ENVAR("TZ=GMT-7"),/&TIBPARM'
The first example calculates the time zone as an offset from GMT (either + or -).
The second example uses the time zone name.
You can find the appropriate time zone values in UNIX System Services Command
Reference, Setting the Local Time Zone with the TZ Environment Variable.
Any application program that uses Rendezvous API calls must have the correct
case when specifying input to the API call.
or:
The TIXFILE DD statement specifies the location of the z/OS Rendezvous license
ticket file.
The STEPLIB DD statement specifies the location of the Rendezvous daemon.
Daemons other than 'RVD' can take the '-store' parameter to store configuration
data. The installation allocates the configuration files for the daemons, (for
example, "<USERHLQ>.CFG.RVRD"). The configuration file must reside on a single
DASD volume.
The daemons configuration files are opened internally with a C function call,
fopen(). The qualifier(s)referenced in the '-store' parameter does not require that
the standard "//" be before the DD:RVBCFG.
Example:
PARM='-store "DD:RVRDCFG" '
Adding a Certificate
The following models illustrate the general form for specifying a certificate file
when entering the certificate through the HTTP interface:
Optional When the system uses multiple TCP/IP stacks, insert the following JCL
statement, which identifies the stack that the application will use:
//SYSTCPD DD DISP=SHR,DSN=your.TCPDATA.file
The program uses the default transport settings and the user-supplied parameter
rv.test.subject is a substitution variable.
Except for the DSNTYPE, RECFM and LRECL parameters all other values can be
changed to suit your applications RVCM ledger requirements.
For MVS batch, a ledger file that exists on disk must be defined as a PDS. Failure to
adhere to this requirement will result in an error condition when executing
Rendezvous example certified messaging programs.
From <USERHLQ>.JCL(RVGDEFLF):
where ddname is the name of an existing DDNAME file referenced in your JCL
jobstream.
The default is NULL. A NULL value causes a non-persistent, memory-based
ledger file to be used.
The following ledger file example shows use of the ddname for Listeners and
Senders:
//*
//** CM Ledger file (for Listener) example
//*
//RUNCCMLC EXEC PGM=RVBCCMLC,
// PARM='-ledger "//DD:RVCMLFL1" rvcm-mvs RVCM-MVS'
//*
//STEPLIB DD DISP=SHR,DSN=&USERHLQ..LOAD
//RVCMLFL1 DD DISP=SHR,DSN=&USERHLQ..CMLEDGER.LISTEN01
//*
//*--------------- START OF NEXT EXAMPLE ------------------------
//*
//** CM Ledger file (for Sender) example
//*
//RUNCCMSN EXEC PGM=RVBCCMSN,
// PARM='-ledger "//DD:RVCMLFS1" RVCM-MVS "RVCM Test Message "'
//*
//STEPLIB DD DISP=SHR,DSN=&USERHLQ..LOAD
//RVCMLFS1 DD DISP=SHR,DSN=&USERHLQ..CMLEDGER.SENDER01
//*
Programmer's Checklist
C
C application programmers in an MVS environment can use this checklist.
• Code
Include the appropriate Rendezvous C header files. (See the section,
Include These Header Files, TIBCO Rendezvous C Reference.)
• Compile/Pre-link/Link
Sample JCL for compiling C programs is member RV$3CPL.
— Application source files normally reside in the.C dataset.
— Requirements are specified in the applicable compile procedure.
COBOL
COBOL application programmers in an MVS environment can use this checklist.
• Code
Include the appropriate Rendezvous COBOL copybooks.
• Compile/Pre-link/Link
This appendix describes members required to build and run MVS Batch
transactions that use the Rendezvous Reliable API.
Topics
Sample Programs
These Assembler examples are not ready for compilation and they are not
executable
This appendix lists all of the installed data sets that are associated with
Rendezvous.
Space
Data Set DSORG RECFM LRECL BLK SIZE
(1st/2nd)
<USERHLQ>.ASM CYL (3/1) PO FB 80 27920
Space
Data Set (1st/2nd) DSORG RECFM LRECL BLK SIZE