IBM

Program Directory for

IBM DATABASE 2 SERVER for OS/390
Rexx Language Support
Version 06 Release 01, Modification Level 00
Program Number 5645-DB2
FMID JDB661H
for Use with
OS/390

Document Date: May 2000

GI10-8215-00

Note!
Before using this information and the product it supports, be sure to read the general information under Notices on page v.

A form for reader's comments appears at the back of this publication. When you send information to IBM, you grant IBM a
nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.
Copyright International Business Machines Corporation 1999, 2000. All rights reserved.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
Notices .
Trademarks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.0 Introduction . . . . . . . . . . . . . .
1.1 Rexx Language Support Description
1.2 Rexx Language Support FMIDs . .
2.0 Program Materials . . . . . . . . . .
.
2.1 Basic Machine-Readable Material
2.2 Optional Machine-Readable Material
2.3 Program Publications . . . . . . . . .
2.3.1 Optional Program Publications .
2.4 Program Source Materials . . . . . .
2.5 Publications Useful During Installation

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.0
3.1
3.2
3.3

Program Support
. . . . . . . .
Program Services . . . . . . . . .
Preventive Service Planning . . .
Statement of Support Procedures

4.0
4.1
4.2
4.3

Program and Service Level Information

Program Level Information . . . . . . . . .
Service Level Information . . . . . . . . .
. . . . . . . . .
Cumulative Service Tape

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5.0 Installation Requirements and Considerations

5.1 Driving System Requirements . . . . . . . . . . .
5.1.1 Machine Requirements . . . . . . . . . . . .
5.1.2 Programming Requirements . . . . . . . . .
5.2 Target System Requirements . . . . . . . . . . .
5.2.1 Machine Requirements . . . . . . . . . . . .
5.2.2 Programming Requirements . . . . . . . . .
5.2.2.1 Mandatory Requisites . . . . . . . . . .
5.2.2.2 Functional Requisites . . . . . . . . . .
5.2.2.3 Toleration/Coexistence Requisites . . .
5.2.2.4 Incompatibility (Negative) Requisites
.
5.2.3 DASD Storage Requirements . . . . . . . .
5.3 FMIDs Deleted
. . . . . . . . . . . . . . . . . . .
5.4 Special Considerations . . . . . . . . . . . . . . .
6.0 Installation Instructions . . . .
6.1 Installing Rexx Language Support
Copyright IBM Corp. 1999, 2000

. . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

v
vi
1
1
2
3
3
4
4
4
4
4
6
6
6
6
7
7
7
7
8
8
8
8
8
9
9
9
9
9
9
10
11
11
12
12

iii

6.1.1 SMP/E Considerations for Installing Rexx Language Support

6.1.2 SMP/E Options Subentry Values . . . . . . . . . . . . . . . .
6.1.3 Unload the Sample JCL from the Product Tape . . . . . . . .
6.1.4 Perform SMP/E RECEIVE . . . . . . . . . . . . . . . . . . . .
6.1.5 Perform SMP/E APPLY . . . . . . . . . . . . . . . . . . . . . .
6.1.6 Perform SMP/E ACCEPT . . . . . . . . . . . . . . . . . . . . .
6.2 Activating Rexx Language Support . . . . . . . . . . . . . . . . . .
Appendix A. Rexx Language Support Install Logic
A.1 SMP/E Modification Control Statements . . . .
A.2 SMP/E JCLIN . . . . . . . . . . . . . . . . . . . .
Reader's Comments

. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .

12
12
12
13
14
14
15

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16
16
16

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17

. . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Figures
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.

iv

Basic Material: Program Tape . . . . . . . . . . . . . . . . . . . . . . . .

Program Tape: File Content . . . . . . . . . . . . . . . . . . . . . . . . .
Publications Useful During Installation . . . . . . . . . . . . . . . . . . .
PSP Upgrade and Subset ID . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Component IDs
Driving System Software Requirements
. . . . . . . . . . . . . . . . . .
Mandatory Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functional Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Total DASD Space Required by Rexx Language Support . . . . . . . .
Storage Requirements for Rexx Language Support Target Libraries . .
Storage Requirements for Rexx Language Support Distribution Libraries
. . . . . . . . . . . . . . . . . . . . . .
SMP/E Options Subentry Values
Sample Installation Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . .

Rexx Language Support Program Directory

. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .

3
4
4
6
6
8
9
9
10
11
11
12
13

Notices
References in this document to IBM products, programs, or services do not imply that IBM intends to
make these available in all countries in which IBM operates. Any reference to an IBM product, program,
or service is not intended to state or imply that only IBM's product, program, or service may be used. Any
functionally equivalent product, program, or service that does not infringe on any of IBM's intellectual
property rights may be used instead of the IBM product, program, or service. Evaluation and verification
of operation in conjunction with other products, except those expressly designated by IBM, is the user's
responsibility.
APAR numbers are provided in this document to assist in locating PTFs that may be required. Ongoing
problem reporting may result in additional APARs being created. Therefore, the APAR lists in this
document may not be complete. To obtain current service recommendations and to identify current
product service requirements, always contact the IBM Customer Support Center or use S/390
SoftwareXcel to obtain the current "PSP Bucket".
IBM may have patents or pending patent applications covering subject matter in this document. The
furnishing of this document does not give you any license to these patents. You can send license
inquiries, in writing, to the
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, New York 10504-1785
USA
For online versions of this book, we authorize you to:

Copy, modify, and print the documentation contained on the media, for use within your enterprise,
provided you reproduce the copyright notice, all warning statements, and other required statements on
each copy or partial copy.

Transfer the original unaltered copy of the documentation when you transfer the related IBM product
(which may be either machines you own, or programs, if the program's license terms permit a
transfer). You must, at the same time, destroy all other copies of the documentation.
You are responsible for payment of any taxes, including personal property taxes, resulting from this
authorization.
THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply
to you.

Copyright IBM Corp. 1999, 2000

Your failure to comply with the terms above terminates this authorization. Upon termination, you must
destroy your machine readable documentation.

Trademarks
The following terms are trademarks of the IBM Corporation in the United States or other countries or both:
CBPDO
IBM

vi

Rexx Language Support Program Directory

DATABASE 2

DB2
REXX

1.0 Introduction
This program directory is intended for the system programmer responsible for program installation and
maintenance. It contains information concerning the material and procedures associated with the
installation of IBM Database 2 Server for OS/390 Rexx Language Support. This publication refers to IBM
Database 2 Server for OS/390 Rexx Language Support as Rexx Language Support. You should read all
of this program directory before installing the program and then keep it for future reference.
The program directory contains the following sections:

2.0, Program Materials on page 3 identifies the basic and optional program materials and
documentation for Rexx Language Support.

3.0, Program Support on page 6 describes the IBM support available for Rexx Language Support.

4.0, Program and Service Level Information on page 7 lists the APARs (program level) and PTFs
(service level) incorporated into Rexx Language Support.

5.0, Installation Requirements and Considerations on page 8 identifies the resources and
considerations for installing and using Rexx Language Support.

6.0, Installation Instructions on page 12 provides detailed installation instructions for Rexx Language
Support. It also describes the procedures for activating the functions of Rexx Language Support, or
refers to appropriate publications.

Appendix A, Rexx Language Support Install Logic on page 16 provides the install logic for Rexx
Language Support.
Before installing Rexx Language Support, read 3.2, Preventive Service Planning on page 6. This section
tells you how to find any updates to the information and procedures in this program directory.
Do not use this program directory if you are installing Rexx Language Support with a SystemPac or
ServerPac. When using these offerings, use the jobs and documentation supplied with the offering. This
documentation may point you to specific sections of the program directory as required.
If you are installing Rexx Language Support using the MVS Custom-Built Product Delivery Offering
(CBPDO, 5751-CS3), a softcopy program directory is provided on the CBPDO tape which is identical to
the printed copy shipped with your order. Your CBPDO contains a softcopy preventive service planning
(PSP) upgrade for this product. All service and HOLDDATA for Rexx Language Support are included on
the CBPDO tape.

1.1 Rexx Language Support Description

This feature provides Rexx Language Support for DB2 access from Rexx programs running either in a
standard MVS Rexx procedure environment or for stored procedures written to use as a Rexx language.

Copyright IBM Corp. 1999, 2000

1.2 Rexx Language Support FMIDs

Rexx Language Support consists of the following FMIDs:
JDB661H

Rexx Language Support Program Directory

2.0 Program Materials

An IBM program is identified by a program number and a feature number. The program number for Rexx
Language Support is 5645-DB2.
Basic Machine-Readable Materials are materials that are supplied under the base license and feature
code, and are required for the use of the product. Optional Machine-Readable Materials are orderable
under separate feature codes, and are not required for the product to function.
The program announcement material describes the features supported by Rexx Language Support. Ask
your IBM representative for this information if you have not already received a copy.

2.1 Basic Machine-Readable Material

The distribution medium for this program is 9-track magnetic tape (written at 6250 BPI), 3480 cartridge, or
4mm cartridge. The tape or cartridge contains all the programs and data needed for installation. It is
installed using SMP/E, and is in SMP/E RELFILE format. See 6.0, Installation Instructions on page 12
for more information about how to install the program.
Figure 1 describes the tape or cartridge. Figure 2 on page 4 describes the file content of the program
tape or cartridge.
Notes:
1. The data set attributes in these tables should be used in the JCL of jobs accessing the tape, but since
the data sets on the tape are in IEBCOPY unloaded format, their actual attributes may be different.
2. If you are installing Rexx Language Support using the MVS Custom-Built Product Delivery Offering
(CBPDO) (5751-CS3), some of the information in these figures may not be valid. Consult the CBPDO
documentation for actual values.
3. If any RELFILEs are identified as PDSEs, ensure that SMPTLIB data sets are allocated as PDSEs.
Figure 1. Basic Material: Program Tape
Feature
Number

Physical
Volume

6250 tape

5216

3480 tape
4mm
cartridge

Medium

External Label Identification

VOLSER

Rexx Language Supt

DB661H

5108

Rexx Language Supt

DB661H

5543

Rexx Language Supt

DB661H

Copyright IBM Corp. 1999, 2000

Figure 2. Program Tape: File Content

O
R
G

R
E
C
F
M

L
R
E
C
L

BLK
SIZE

n/a

SEQ

FB

80

6400

IBM.JDB661H.F1

SMPJCLIN

PDS

FB

80

6160

IBM.JDB661H.F2

ADSNLOAD

PDS

6144

IBM.JDB661H.F3

ADSNMACS

PDS

FB

80

6160

VOLSER

F
i
l
e

Name

Dist
Library

DB661H

SMPMCS

2.2 Optional Machine-Readable Material

No optional machine-readable materials are provided for Rexx Language Support.

2.3 Program Publications

The following sections identify the basic and optional publications for Rexx Language Support.
No licensed or unlicensed publications are provided for Rexx Language Support.

2.3.1 Optional Program Publications

No optional publications are provided for Rexx Language Support.

2.4 Program Source Materials

No program source materials or viewable program listings are provided for Rexx Language Support.

2.5 Publications Useful During Installation

The publications listed in Figure 3 may be useful during the installation of Rexx Language Support. To
order copies, contact your IBM representative.
Figure 3 (Page 1 of 2). Publications Useful During Installation
Publication Title
OS/390 SMP/E User's Guide

Rexx Language Support Program Directory

Form
Number
SC28-1740

Figure 3 (Page 2 of 2). Publications Useful During Installation

Publication Title

Form
Number

OS/390 SMP/E Reference

SC28-1806

OS/390 SMP/E Messages and Codes

SC28-1738

Program Materials

3.0 Program Support

This section describes the IBM support available for Rexx Language Support.

3.1 Program Services

Contact your IBM representative for specific information about available program services.

3.2 Preventive Service Planning

Before installing Rexx Language Support, you should review the current Preventive Service Planning
(PSP) information. If you obtained Rexx Language Support as part of a CBPDO, there is HOLDDATA and
PSP information included on the CBPDO tape.
If you obtained Rexx Language Support on a product tape, or if the CBPDO is more than two weeks old
when you install it, you should contact the IBM Support Center or use S/390 SoftwareXcel to obtain the
current "PSP Bucket".
PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the
FMIDs for a product level. The UPGRADE and SUBSET values for Rexx Language Support are:
Figure 4. PSP Upgrade and Subset ID
UPGRADE

SUBSET

Description

DB2610

JDB661H

Rexx Language Support

3.3 Statement of Support Procedures

Report any difficulties you have using this program to your IBM Support Center. If an APAR is required,
the Support Center will provide the address to which any needed documentation can be sent.
Figure 5 identifies the component IDs (COMPID) for Rexx Language Support.
Figure 5. Component IDs

FMID

COMPID

Component Name

RETAIN
Release

JDB661H

5740XYR00

Rexx Language Support

61H

Copyright IBM Corp. 1999, 2000

4.0 Program and Service Level Information

This section identifies the program and any relevant service levels of Rexx Language Support. The
program level refers to the APAR fixes incorporated into the program. The service level refers to the
PTFs integrated. Information about the cumulative service tape is also provided.

4.1 Program Level Information

No APARs have been incorporated into Rexx Language Support.

4.2 Service Level Information

No PTFs against this release of Rexx Language Support have been incorporated into the product tape.

4.3 Cumulative Service Tape

A cumulative service tape, containing PTFs not incorporated into this release, might be included with this
program. Installation instructions for cumulative service tapes can be found in the SMP/E publications.
If you received this product as part of a CBPDO or a ProductPac, PTFs not incorporated into this release
are provided on the tape, and a separate cumulative service tape will not be provided.

Copyright IBM Corp. 1999, 2000

5.0 Installation Requirements and Considerations

The following sections identify the system requirements for installing and activating Rexx Language
Support. The following terminology is used:

Driving system: the system used to install the program.

Target system: the system on which the program is installed.
In many cases, the same system can be used as both a driving system and a target system. However,
you may want to set up a clone of your system to use as a target system by making a separate IPL-able
copy of the running system. The clone should include copies of all system libraries that SMP/E updates,
copies of the SMP/E CSI data sets that describe the system libraries, and your PARMLIB and PROCLIB.
Some cases where two systems should be used include the following:

When installing a new level of a product that is already installed, the new product will delete the old
one. By installing onto a separate target system, you can test the new product while still keeping the
old one in production.

When installing a product that shares libraries or load modules with other products, the installation can
disrupt the other products. Installing onto a test system or clone will allow you to assess these
impacts without disrupting your production system.

5.1 Driving System Requirements

This section describes the environment of the driving system required to install Rexx Language Support.

5.1.1 Machine Requirements

The driving system can run in any hardware environment that supports the required software.

5.1.2 Programming Requirements

Figure 6. Driving System Software Requirements
Program
Number

Product Name and

Minimum VRM/Service Level

5645-A01

OS/390 SMP/E Version 2 Release 4 or higher with PTF UR51067.

5.2 Target System Requirements

This section describes the environment of the target system required to install and use Rexx Language
Support.

Copyright IBM Corp. 1999, 2000

5.2.1 Machine Requirements

The target system can run in any hardware environment that supports the required software.

5.2.2 Programming Requirements

5.2.2.1 Mandatory Requisites: A mandatory requisite is defined as a product that is required
without exception; this product either will not install or will not function unless this requisite is met. This
includes products that are specified as REQs or PREs.
Figure 7. Mandatory Requisites
Program
Number

Product Name and

Minimum VRM/Service Level

5645-001

OS/390 Version 1 Release 3 Base Services

5645-DB2

DB2 UDB Server for OS/390 Version 6 Base Services

5.2.2.2 Functional Requisites: A functional requisite is defined as a product that is not required
for the successful installation of this product or for the basic function of the product, but is needed at run
time for a specific function of this product to work. This includes products that are specified as IF REQs.
Figure 8. Functional Requisites
Program
Number

Product Name and

Minimum VRM/Service Level

Function

5645-DB2

DB2 UDB Server for OS/390 Version 6

DB2 Base Services

5.2.2.3 Toleration/Coexistence Requisites: A toleration/coexistence requisite is defined as a

product which must be present on a sharing system. These systems can be other systems in a
multisystem environment (not necessarily sysplex), a shared DASD environment (such as test and
production), or systems that reuse the same DASD at different time intervals.
Rexx Language Support has no toleration/coexistence requisites.

5.2.2.4 Incompatibility (Negative) Requisites: A negative requisite identifies products which

must not be installed on the same system as this product.
Rexx Language Support has no negative requisites.

Installation Requirements and Considerations

5.2.3 DASD Storage Requirements

Rexx Language Support libraries can reside on 3380 or 3390 DASD.
Figure 9 on page 10 lists the total space required for each type of library.
Figure 9. Total DASD Space Required by Rexx Language Support
Library
Type

Total Space Required

Target

40 tracks for 3390 DASD

Distribution

28 tracks for 3390 DASD

Notes:
1. IBM recommends use of system determined block sizes for efficient DASD utilization for all
non-RECFM U data sets. For RECFM U data sets, IBM recommends a block size of 32760, which is
the most efficient from a performance and DASD utilization perspective.
2. Abbreviations used for the data set type are:
U

Unique data set, allocated by this product and used only by this product. In order to
determine the correct storage needed for this data set, this table provides all required
information; no other tables (or program directories) need to be referenced for the data set
size.
Shared data set, allocated by this product and used by this product and others. In order to
determine the correct storage needed for this data set, the storage size given in this table
needs to be added to other tables (perhaps in other program directories). If the data set
already exists, it must have enough free space to accommodate the storage size given in this
table.
Existing shared data set, used by this product and others. This data set is NOT allocated by
this product. In order to determine the correct storage needed for this data set, the storage
size given in this table needs to be added to other tables (perhaps in other program
directories). This existing data set must have enough free space to accommodate the storage
size given in this table.

If you currently have a previous release of this product installed in these libraries, the installation of
this release will delete the old one and reclaim the space used by the old release and any service that
had been installed. You can determine whether or not these libraries have enough space by deleting
the old release with a dummy function, compressing the libraries, and comparing the space
requirements with the free space in the libraries.
The following figures describe the target and distribution libraries and HFS paths required to install Rexx
Language Support. The storage requirements of Rexx Language Support must be added to the storage
required by other programs having data in the same library or path.
Note: The data in these tables should be used when determining which libraries can be merged into
common data sets. There is no need to define these target and distribution libraries to install this feature,

10

Rexx Language Support Program Directory

because all of them were defined when DB2 base was installed. In addition, since some ALIAS names
may not be unique, ensure that no naming conflicts will be introduced before merging libraries. All these
libraries required to install this feature were defined when DB2 was installed.
Figure 10. Storage Requirements for Rexx Language Support Target Libraries

O
R
G

R
E
C
F
M

L
R
E
C
L

No.
of
3390
Trks

No.
of
DIR
Blks

Member
Type

Target
Volume

T
Y
P
E

SDSNLOAD

LMOD

Any

PDS

16

10

SDSNSAMP

Sample

Any

PDS

FB

80

SDSNDBRM

Data

Any

PDS

FB

80

L
R
E
C
L

No.
of
3390
Trks

No.
of
DIR
Blks

Library
DDNAME

Figure 11. Storage Requirements for Rexx Language Support Distribution Libraries

Library
DDNAME

T
Y
P
E

O
R
G

R
E
C
F
M

ADSNMACS

PDS

FB

80

ADSNLOAD

PDS

16

10

5.3 FMIDs Deleted

Installing Rexx Language Support may result in the deletion of other FMIDs. To see what FMIDs will be
deleted, examine the ++VER statement in the product's SMPMCS. See Appendix A, Rexx Language
Support Install Logic on page 16 for more information on how to do this.
If you do not wish to delete these FMIDs at this time, you must install Rexx Language Support into
separate SMP/E target and distribution zones.
Note: These FMIDs will not automatically be deleted from the Global Zone. Consult the SMP/E manuals
for instructions on how to do this.

5.4 Special Considerations

Rexx Language Support has no special considerations for the target system.

Installation Requirements and Considerations

11

6.0 Installation Instructions

This chapter describes the installation method and the step-by-step procedures to install and to activate
the functions of Rexx Language Support.
Please note the following:

If you want to install Rexx Language Support into its own SMP/E environment, consult the SMP/E
manuals for instructions on creating and initializing the SMPCSI and the SMP/E control data sets.

Sample jobs have been provided to help perform some or all of the installation tasks. The SMP/E jobs
assume that all DDDEF entries required for SMP/E execution have been defined in the appropriate
zones.

The SMP/E dialogs may be used instead of the sample jobs to accomplish the SMP/E installation
steps.

6.1 Installing Rexx Language Support

6.1.1 SMP/E Considerations for Installing Rexx Language Support
This release of Rexx Language Support is installed using the SMP/E RECEIVE, APPLY, and ACCEPT
commands. The SMP/E dialogs may be used to accomplish the SMP/E installation steps.

6.1.2 SMP/E Options Subentry Values

The recommended values for some SMP/E CSI subentries are shown in Figure 12. Use of values lower
than these may result in failures in the installation process. DSSPACE is a subentry in the GLOBAL
options entry. PEMAX is a subentry of the GENERAL entry in the GLOBAL options entry. Refer to the
SMP/E manuals for instructions on updating the global zone.
Figure 12. SMP/E Options Subentry Values
SUB-ENTRY

Value

Comment

DSSPACE

200,200,600

3390 DASD Tracks

PEMAX

9999

The SMP/E default is larger than what can be epecified here

6.1.3 Unload the Sample JCL from the Product Tape

The following sample installation jobs are provided on the distribution tape to help you install Rexx
Language Support:

12

Copyright IBM Corp. 1999, 2000

Figure 13. Sample Installation Jobs

Job
Name

Job
Type

Description

RELFILE

DSNTTJRC

RECEIVE

Sample RECEIVE job

IBM.JDB661H.F3

DSNTTJAP

APPLY

Sample APPLY job

IBM.JDB661H.F3

DSNTTJAC

ACCEPT

Sample ACCEPT job

IBM.JDB661H.F3

You may copy the jobs from the tape by submitting the job below. Add a job card and modify the
parameters in boldface to uppercase values to meet your site's requirements before submitting.
//STEP1
EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=
//IN
DD DSN=IBM.JDB661H.F3,UNIT=tunit,VOL=SER=DB661H,
//
LABEL=(4,SL),DISP=(OLD,KEEP)
//OUT
DD DSNAME=jcl-library-name,
//
DISP=(NEW,CATLG,DELETE),
//
VOL=SER=dasdvol,UNIT=dunit,
//
DCB=.STEP1.IN,SPACE=(TRK,(1&,1&,5))
//SYSUT3
DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSIN
DD 
COPY INDD=IN,OUTDD=OUT
SELECT MEMBER=(DSNTTJAC,DSNTTJAP,DSNTTJRC)
where tunit is the unit value matching the product tape or cartridge, jcl-library-name is the name of the
data set where the sample jobs will reside, dasdvol is the volume serial of the DASD device where the
data set will reside, and dunit is the DASD unit type of the volume.
You can also access the sample installation jobs by performing an SMP/E RECEIVE for FMID JDB661H
and then copying the jobs from data set hlq.IBM.JDB661H.F3 to a work data set for editing and
submission.

6.1.4 Perform SMP/E RECEIVE

Edit and submit sample job DSNTTJRC to perform the SMP/E RECEIVE for Rexx Language Support.
Consult the instructions in the sample job for more information.
NOTE: if you obtained Rexx Language Support as part of a CBPDO, you can use the RCVPDO job found
in the CBPDO RIMLIB data set to RECEIVE the Rexx Language Support FMIDs as well as any service,
HOLDDATA, or preventive service planning (PSP) information included on the CBPDO tape. For more
information, refer to the documentation included with the CBPDO.
Expected Return Codes and Messages: This job should complete with return code 4 or less. NOTE: If
you are running a lower level of OS/390 Version 2 Release 7, your job will end with a return code of 4,
issuing a GIM50050W warning message.

Installation Instructions

13

6.1.5 Perform SMP/E APPLY

Edit and submit sample job DSNTTJAP to perform an SMP/E APPLY CHECK for Rexx Language Support.
Consult the instructions in the sample job for more information.
To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following
on the APPLY CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis
identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated
as warnings, not errors, by SMP/E).
Once you have taken any actions indicated by the APPLY CHECK, remove the CHECK operand and run
the job again to perform the APPLY.
Note: The GROUPEXTEND operand indicates that SMP/E apply all requisite SYSMODs. The requisite
SYSMODS might be applicable to other functions.
Expected Return Codes and Messages: This job should complete with return code 4 or less. NOTE: If
you are running a lower level of OS/390 Version 2 Release 7, your job will end with a return code of 4,
issuing a GIM50050W warning message.

6.1.6 Perform SMP/E ACCEPT

Edit and submit sample job DSNTTJAC to perform an SMP/E ACCEPT CHECK for Rexx Language
Support. Consult the instructions in the sample job for more information.
To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following
on the ACCEPT CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis
identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated
as warnings, not errors, by SMP/E).
Before using SMP/E to load new distribution libraries, it is recommended that you set the ACCJCLIN
indicator in the distribution zone. This will cause entries produced from JCLIN to be saved in the
distribution zone whenever a SYSMOD containing inline JCLIN is ACCEPTed. For more information on
the ACCJCLIN indicator, see the description of inline JCLIN in the SMP/E manuals.
Once you have taken any actions indicated by the ACCEPT CHECK, remove the CHECK operand and
run the job again to perform the ACCEPT.
Note: The GROUPEXTEND operand indicates that SMP/E apply all requisite SYSMODs. The requisite
SYSMODS might be applicable to other functions.
Expected Return Codes and Messages: This job should complete with return code 4 or less. NOTE: If
you are running a lower level of OS/390 Version 2 Release 7, your job will end with a return code of 4,
issuing a GIM50050W warning message.

14

Rexx Language Support Program Directory

6.2 Activating Rexx Language Support

Rexx Language Support is fully operational once the SMP/E installation is complete and the execution of
job DSNTIJRX is complete (to bind packages).
Expected Return Codes and Messages: This job should complete with return code 0.

Installation Instructions

15

Appendix A. Rexx Language Support Install Logic

A.1 SMP/E Modification Control Statements
The SMP/E Modification Control Statements (SMPMCS) for Rexx Language Support are contained in the
SMPMCS file on the installation tape. The SMPMCS for each FMID in the product will be loaded to the
SMPPTS data set, with a member name matching the FMID, when the FMID is SMP/E RECEIVEd. You
may browse or print these members using TSO/E, ISPF, or IEBGENER (or IEBPTPCH).

A.2 SMP/E JCLIN

The JCLIN for Rexx Language Support is contained in the RELFILEs on the installation tape. These files
will be loaded to disk by SMP/E when the product is SMP/E RECEIVEd. You may browse or print these
files using TSO/E, ISPF, or IEBGENER (or IEBPTPCH).
The files containing JCLIN are:
FMID JDB661H: DSN610.JDB661H.F1(JDB661H)
Note:

16

The high-level qualifier is the qualifier specified as the DSPREFIX in the SMP/E OPTIONS.

Copyright IBM Corp. 1999, 2000

Reader's Comments
Program Directory for IBM Database 2 Server for OS/390 Rexx Language Support Version 06. 01. 00.
You may use this form to comment about this document, its organization, or subject matter with the understanding that
IBM may use or distribute whatever information you supply in any way it believes appropriate without incurring any
obligation to you.
For each of the topics below please indicate your satisfaction level by circling your choice from the rating scale. If a
statement does not apply, please circle N.
RATING SCALE
very
satisfied
1

<=====================>
2
3
4

very
dissatisfied
5

not
applicable
N

Satisfaction
Ease of product installation

Contents of program directory

Installation Verification Programs

Time to install the product

Readability and organization of program directory tasks

Necessity of all installation tasks

Accuracy of the definition of the installation tasks

Technical level of the installation tasks

Ease of getting the system into production after

installation

How did you order this product?

CBPDO
CustomPac
ServerPac
Independent
Other

Is this the first time your organization has installed this product?
Yes
No

Were the people who did the installation experienced with the installation of MVS products?
Yes

17

No

If yes, how many years? __

If you have any comments to make about your ratings above, or any other aspect of the product installation, please
list them below:

Please provide the following contact information:

Name and Job Title
Organization

Address
Telephone
Thank you for your participation.
Please send the completed form to (or give to your IBM representative who will forward it to the IBM Database 2
Server for OS/390 Rexx Language Support Development group):
IBM Corporation
555 Bailey Avenue
San Jose, California 95141
Attn: DB2 Test and System Services, W68/B373
FAX Number: (408) 463-2614
E-Mail: [email protected]

18

Rexx Language Support Program Directory

IBM
Program Number: 5645-DB2

Printed in U.S.A.

GI1&-8215-&&

5216
5108
5543