IBM

Program Directory for

IBM DB2 Net Search Extender
for OS/390 and z/OS

Version 7 Release 1, Modification Level 0

Program Number 5675-DB2

FMID HDB771N

for Use with

OS/390 and z/OS

Document Date: February 2001

GI10-8242-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 2001. All rights reserved.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

1.0 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 Net Search Extender Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 Net Search Extender FMIDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2.0 Program Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2.1 Basic Machine-Readable Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2 Optional Machine-Readable Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.3 Program Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.3.1 Basic Program Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.3.2 Optional Program Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.4 Program Source Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.5 Publications Useful During Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3.0 Program Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.1 Program Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2 Preventive Service Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3 Statement of Support Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

4.0 Program and Service Level Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

4.1 Program Level Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.2 Service Level Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

5.0 Installation Requirements and Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

5.1 Driving System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
5.1.1 Machine Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
5.1.2 Programming Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
5.2 Target System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5.2.1 Machine Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5.2.2 Programming Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5.2.2.1 Mandatory Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5.2.2.2 Functional Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5.2.2.3 Toleration/Coexistence Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5.2.2.4 Incompatibility (Negative) Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5.2.3 DASD Storage Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5.3 FMIDs Deleted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5.4 Special Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

6.0 Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

6.1 Installing Net Search Extender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

 Copyright IBM Corp. 2001 iii

 6.1.1 SMP/E Considerations for Installing Net Search Extender . . . . . . . . . . . . . . . . . . . . . 14
6.1.2 SMP/E Options Subentry Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
6.1.3 SMP/E CALLLIBS Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6.1.4 Unload the Sample JCL from the Product Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6.1.5 Perform SMP/E RECEIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.1.6 Allocate SMP/E Target and Distribution Libraries and Paths . . . . . . . . . . . . . . . . . . . 16
6.1.7 Create DDDEF Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6.1.8 Perform SMP/E APPLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6.1.9 Perform SMP/E ACCEPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6.2 Activating Net Search Extender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Reader's Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Figures
1. Basic Material: Program Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Basic Material: Unlicensed Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3. Publications Useful During Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
4. PSP Upgrade and Subset ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
5. Component IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
6. Driving System Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
7. Mandatory Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
8. Functional Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
9. Total DASD Space Required by Net Search Extender . . . . . . . . . . . . . . . . . . . . . . . . . 10
10. Storage Requirements for Net Search Extender Target Libraries . . . . . . . . . . . . . . . . . . . 12
11. Net Search Extender HFS Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
12. Storage Requirements for Net Search Extender Distribution Libraries . . . . . . . . . . . . . . . . 12
13. SMP/E Options Subentry Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
14. Sample Installation Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

iv Net Search Extender Program Directory

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. 2001 v

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:

IBM RACF
CBPDO RETAIN
CustomPac SMP/E
DATABASE 2 SystemPac
DB2 ServerPac
Language Environment Unix System Services
MVS VTAM
Net.Data z/OS
OS/390

The following terms are trademarks of other companies as follows:

ODBC Microsoft Corporation
Open Database Connectivity Microsoft Corporation
Java Sun Microsystems
Java Database Connectivity Sun Microsystems
Java Virtual Machine Sun Microsystems
JDBC Sun Microsystems

vi Net Search Extender Program Directory

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 DB2 Net Search Extender for OS/390 and z/OS. This publication refers to DB2 Net Search
Extender for OS/390 and z/OS as Net Search Extender. 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 Net Search Extender.

3.0, “Program Support” on page 6 describes the IBM support available for Net Search Extender.

4.0, “Program and Service Level Information” on page 7 lists the APARs (program level) and PTFs
(service level) incorporated into Net Search Extender.

5.0, “Installation Requirements and Considerations” on page 8 identifies the resources and
considerations for installing and using Net Search Extender.

6.0, “Installation Instructions” on page 14 provides detailed installation instructions for Net Search
Extender. It also describes the procedures for activating the functions of Net Search Extender, or
refers to appropriate publications.

Before installing Net Search Extender, 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 Net Search Extender 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 Net Search Extender 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 Net Search Extender are included on the
CBPDO tape.

Documentation is available in HTML at the Net Search Extender Web site. Please see:
http://www.ibm.com/software/data/db2/extenders/netsearch

 Copyright IBM Corp. 2001 1

1.1 Net Search Extender Description
DB2 Net Search Extender for OS/390 and z/OS contains a DB2(R) stored procedure that adds the power
of fast full-text retrieval to Net.Data, Java, or DB2 CLI applications. It offers application programmers a
variety of search functions, such as fuzzy search, stemming, Boolean operators, and section search.

Searching using Net Search Extender can be particularly advantageous in the Internet when performance
is an important factor.

1.2 Net Search Extender FMIDs

Net Search Extender consists of the following FMIDs:
HDB771N

2 Net Search Extender Program Directory

2.0 Program Materials
An IBM program is identified by a program number and a feature number. The program number for Net
Search Extender is 5675-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 Net Search Extender. 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 14
for more information about how to install the program.

Figure 1 describes the tape or cartridge.

Figure 1. Basic Material: Program Tape

Feature Physical
Medium Number Volume External Label Identification VOLSER
6250 tape 6182 1 DB2 Net Search Extender English (US) DB771N
3480 cart. 6180 1 DB2 Net Search Extender English (US) DB771N
4mm cart. 6181 1 DB2 Net Search Extender English (US) DB771N
6250 tape 6185 1 DB2 Net Search Extender Brazilian Portuguese DB771N
3480 cart. 6183 1 DB2 Net Search Extender Brazilian Portuguese DB771N
4mm cart. 6184 1 DB2 Net Search Extender Brazilian Portuguese DB771N
6250 tape 6188 1 DB2 Net Search Extender Japanese DB771N
3480 cart. 6186 1 DB2 Net Search Extender Japanese DB771N
4mm cart. 6187 1 DB2 Net Search Extender Japanese DB771N

2.2 Optional Machine-Readable Material

No optional machine-readable materials are provided for Net Search Extender.

 Copyright IBM Corp. 2001 3

2.3 Program Publications
The following sections identify the basic and optional publications for Net Search Extender.

2.3.1 Basic Program Publications

Figure 2 identifies the basic unlicensed program publications for Net Search Extender. One copy of each
of these publications is included when you order the basic materials for Net Search Extender. For
additional copies, contact your IBM representative.

Figure 2. Basic Material: Unlicensed Publications

Form
Publication Title Number
DB2 Net Search Extender Administration and Programming SC27-1171-00

2.3.2 Optional Program Publications

No optional publications are provided for Net Search Extender, however, a README file is included which
documents additional instructions regarding the use of Net Search Extender. The README file is installed
to the HFS file /usr/lpp/db2nx/readme which is created during the SMP/E APPLY step.

2.4 Program Source Materials

No program source materials or viewable program listings are provided for Net Search Extender.

2.5 Publications Useful During Installation

The publications listed in Figure 3 may be useful during the installation of Net Search Extender. To order
copies, contact your IBM representative.

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

Form
Publication Title Number
OS/390 SMP/E User's Guide SC28-1740
OS/390 SMP/E Commands SC28-1805
OS/390 SMP/E Reference SC28-1806
OS/390 SMP/E Messages and Codes SC28-1738
IBM HTTP Server for OS/390 V2R7 Planning, Installing, and Using V5.1 SC31-8690

4 Net Search Extender Program Directory

Figure 3 (Page 2 of 2). Publications Useful During Installation
Form
Publication Title Number
IBM HTTP Server for OS/390 V2R7 Web Programming Guide V5.1 SC34-4743
Net.Data Administration and Programming Guide for OS/390
from the Net.Data Web site at http://www.ibm.com/software/data/net.data/library

Program Materials 5
3.0 Program Support
This section describes the IBM support available for Net Search Extender.

3.1 Program Services

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

3.2 Preventive Service Planning

Before installing Net Search Extender, you should review the current Preventive Service Planning (PSP)
information. If you obtained Net Search Extender as part of a CBPDO, there is HOLDDATA and PSP
information included on the CBPDO tape.

If you obtained Net Search Extender 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 Net Search Extender are:

Figure 4. PSP Upgrade and Subset ID

UPGRADE SUBSET Description
DB2710 HDB771N DB2 NET SEARCH EXTENDER

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 Net Search Extender.

Figure 5. Component IDs

RETAIN
FMID COMPID Component Name Release
HDB771N 5740XYR07 DB2 Net Search Extender 71N

6  Copyright IBM Corp. 2001

4.0 Program and Service Level Information
This section identifies the program and any relevant service levels of Net Search Extender. The program
level refers to the APAR fixes incorporated into the program. The service level refers to the PTFs
integrated.

4.1 Program Level Information

No APARs have been incorporated into Net Search Extender.

4.2 Service Level Information

No PTFs against this release of Net Search Extender have been incorporated into the product tape.

 Copyright IBM Corp. 2001 7

5.0 Installation Requirements and Considerations
The following sections identify the system requirements for installing and activating Net Search Extender.
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 Net Search Extender.

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 Product Name and
Number Minimum VRM/Service Level
5647-A01 OS/390 SMP/E Version 2 Release 7 or higher

8  Copyright IBM Corp. 2001

5.2 Target System Requirements
This section describes the environment of the target system required to install and use Net Search
Extender.

Net Search Extender installs in the DBS (P115) SREL.

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 Product Name and
Number Minimum VRM/Service Level
Any one of the following:
5645-DB2 DB2 for OS/390 Version 6
5675-DB2 DB2 for OS/390 Version 7

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 Product Name and
Number Minimum VRM/Service Level Function
Any one of the following:
5645-DB2 Net.Data Version 2 Release 2 Feature Searching and Web connectivity using
Net.Data, for use with DB2 for OS/390
Version 6.
5675-DB2 Net.Data Version 7 Feature Searching and Web connectivity using
Net.Data, for use with DB2 for OS/390
Version 7.

Installation Requirements and Considerations 9

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.

Net Search Extender 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.

Net Search Extender has no negative requisites.

5.2.3 DASD Storage Requirements

Net Search Extender libraries can reside on 3380 and 3390 DASD.

Figure 9 lists the total space required for each type of library.

Figure 9. Total DASD Space Required by Net Search Extender

Library
Type Total Space Required
Target 75 3390 DASD tracks
Distribution 630 3390 DASD tracks
HFS 21 MB

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.
S 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.
E 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

10 Net Search Extender Program Directory

 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.
For more information on the names and sizes of the required data sets, please refer to 6.1.6, “Allocate
SMP/E Target and Distribution Libraries and Paths” on page 16.
3. Abbreviations used for the HFS Path type are:
N New path, created by this product.
P Previously existing path, created by another product.
4. All target and distribution libraries listed have the following attributes:

The default name of the data set may be changed

The default block size of the data set may be changed

The data set may be merged with another data set that has equivalent characteristics

The data set may be either a PDS or a PDSE
5. All target libraries listed have the following attributes:

The data set may be SMS managed

It is not required for the data set to be SMS managed

It is not required for the data set to reside on the IPL volume

The values in the "Member Type" column are not necessarily the actual SMP/E element types
identified in the SMPMCS.
6. All target libraries listed which contain load modules have the following attributes:

The data set may be in the LPA

It is not required for the data set to be in the LPA

The data set may be in the LNKLST

It is not required for the data set to be APF authorized

The following figures describe the target and distribution libraries and HFS paths required to install Net
Search Extender. The storage requirements of Net Search Extender 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. In addition, since some ALIAS names may not be unique, ensure that no naming
conflicts will be introduced before merging libraries.

Installation Requirements and Considerations 11

 Figure 10. Storage Requirements for Net Search Extender Target Libraries
R L
T E R No. No.
Y O C E of of
Library Member Target P R F C 3390 DIR
DDNAME Type Volume E G M L Trks Blks
SDNEDATA Data Any U PDS VB 2048 1 3
SDNEDBRM Macro Any U PDS FB 80 2 3
SDNEMOD1 LMOD Any U PDS U 0 63 3
SDNESAMP Sample, Any U PDS FB 80 3 3
Skeleton

Figure 11. Net Search Extender HFS Paths

T
Y
P
DDNAME E Path Name
SDNEMOD2 N /usr/lpp/db2/db2nx/bin/IBM
SDNEMOD3 N /usr/lpp/db2/db2nx/icu/lib/IBM
SDNEMOD4 N /usr/lpp/db2/db2nx/icu/data/IBM
SDNEHFS1 N /usr/lpp/db2/db2nx/IBM

Figure 12. Storage Requirements for Net Search Extender Distribution Libraries
R L
T E R No. No.
Y O C E of of
Library P R F C 3390 DIR
DDNAME E G M L Trks Blks
ADNEDATA U PDS VB 2048 1 3
ADNEDBRM U PDS FB 80 2 3
ADNEHFS1 U PDS VB 255 17 4
ADNEMOD1 U PDS U 0 563 6
ADNESAMP U PDS FB 80 3 3

12 Net Search Extender Program Directory

5.3 FMIDs Deleted
Installing Net Search Extender may result in the deletion of other FMIDs. To see what FMIDs will be
deleted, examine the ++VER statement in the product's SMPMCS.

If you do not wish to delete these FMIDs at this time, you must install Net Search Extender 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

Net Search Extender has no special considerations for the target system.

Installation Requirements and Considerations 13

6.0 Installation Instructions
This chapter describes the installation method and the step-by-step procedures to install and to activate
the functions of Net Search Extender.

Please note the following:

If you want to install Net Search Extender 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 Net Search Extender

6.1.1 SMP/E Considerations for Installing Net Search Extender

This release of Net Search Extender 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 13. 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 13. SMP/E Options Subentry Values

SUB-ENTRY Value Comment
DSSPACE 200,200,500 3390 DASD tracks
PEMAX SMP/E Default IBM recommends using the SMP/E default for PEMAX.

14  Copyright IBM Corp. 2001

6.1.3 SMP/E CALLLIBS Processing
Net Search Extender uses the CALLLIBS function provided in SMP/E to resolve external references during
installation. When Net Search Extender is installed, ensure that DDDEFs exist for the following libraries:

SCEELKED
Note: The DDDEFs above are used only to resolve the link-edit for Net Search Extender using
CALLLIBS. These data sets are not updated during the installation of Net Search Extender.

6.1.4 Unload the Sample JCL from the Product Tape

The following sample installation jobs are provided on the distribution tape to help you install Net Search
Extender:

Figure 14. Sample Installation Jobs

Job Name Job Type Description RELFILE
DNERECEV RECEIVE Sample RECEIVE job IBM.HDB771N.F2
DNEALLOC ALLOCATE Sample job to allocate target and distribution IBM.HDB771N.F2
libraries
DNEISMKD MKDIR Sample job to invoke the supplied DNEMKDIR IBM.HDB771N.F2
EXEC to allocate HFS paths
DNEDDDEF DDDEF Sample job to define SMP/E DDDEFs IBM.HDB771N.F2
DNEAPPLY APPLY Sample APPLY job IBM.HDB771N.F2
DNEACCEP ACCEPT Sample ACCEPT job IBM.HDB771N.F2

You may copy the jobs from the tape by submitting the job below. Add a job card and change the
lowercase parameters to uppercase values to meet your site's requirements before submitting.
//STEP1 EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=
//IN DD DSN=IBM.HDB771N.F2,UNIT=tunit,VOL=SER=DB771N,
// LABEL=(3,SL),DISP=(OLD,KEEP)
//OUT DD DSNAME=jcl-library-name,
// DISP=(NEW,CATLG,DELETE),
// VOL=SER=dasdvol,UNIT=SYSALLDA,
// DCB=.STEP1.IN,SPACE=(TRK,(4,1,4))
//SYSUT3 DD UNIT=SYSALLDA,SPACE=(CYL,(1,1))
//SYSIN DD 
COPY INDD=IN,OUTDD=OUT
/
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, and dasdvol is the volume serial of the DASD device where
the data set will reside.

Installation Instructions 15
You can also access the sample installation jobs by performing an SMP/E RECEIVE for FMID HDB771N,
and then copying the jobs from data set hlq.HDB771N.F2 to a work data set for editing and submission.
Note: "hlq" is the high-level qualifier specified as the DSPREFIX value in the SMPTLIB DDDEF or the
OPTIONS entry of the global zone.

6.1.5 Perform SMP/E RECEIVE

Edit and submit sample job DNERECEV to perform the SMP/E RECEIVE for Net Search Extender.
Consult the instructions in the sample job for more information.

NOTE: If you obtained Net Search Extender as part of a CBPDO, you can use the RCVPDO job found in
the CBPDO RIMLIB data set to RECEIVE the Net Search Extender 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 a condition code of 0.

6.1.6 Allocate SMP/E Target and Distribution Libraries and Paths

Edit and submit sample job DNEALLOC to allocate the SMP/E target and distribution libraries for Net
Search Extender. Consult the instructions in the sample job for more information.

Expected Return Codes and Messages: This job should complete with a condition code of 0.

Edit and submit sample job DNEISMKD to allocate the HFS paths for Net Search Extender. Consult the
instructions in the sample job for more information.

If you plan to create a new HFS for this product, you should consider updating the BPXPRMxx PARMLIB
member to mount the new HFS at IPL time. This may be helpful if an IPL occurs before the installation is
complete.

Expected Return Codes and Messages: This job should complete with a condition code of 0.

6.1.7 Create DDDEF Entries

Edit and submit sample job DNEDDDEF to create DDDEF entries for the SMP/E target and distribution
libraries for Net Search Extender. Consult the instructions in the sample job for more information.

Expected Return Codes and Messages: This job should complete with a condition code of 0.

16 Net Search Extender Program Directory

6.1.8 Perform SMP/E APPLY
Edit and submit sample job DNEAPPLY to perform an SMP/E APPLY CHECK for Net Search Extender.
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 from APPLY CHECK: This job should complete with a
condition code of 0 and may issue message IEW2454W which does not affect product installation.

Expected Return Codes and Messages from APPLY: This job should complete with a condition code
of 0 and may issue message IEW2454W which does not affect product installation.

6.1.9 Perform SMP/E ACCEPT

Edit and submit sample job DNEACCEP to perform an SMP/E ACCEPT CHECK for Net Search Extender.
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 accept all requisite SYSMODs. The requisite
SYSMODS might be applicable to other functions.

Expected Return Codes and Messages from ACCEPT CHECK: This job should complete with a
condition code of 0.

Installation Instructions 17
Expected Return Codes and Messages from ACCEPT: This job should complete with a condition code
of 0.

If PTFs containing replacement modules are being ACCEPTed, SMP/E ACCEPT processing will
linkedit/bind the modules into the distribution libraries. During this processing, the Linkage Editor or Binder
may issue messages documenting unresolved external references, resulting in a return code of 4 from the
ACCEPT step. These messages can be ignored, because the distribution libraries are not executable and
the unresolved external references will not affect the executable system libraries.

6.2 Activating Net Search Extender

If you choose to have the HFS in which you have installed Net Search Extender mounted in read-only
mode during execution, then no further tasks are required to accomplish this.

The publication DB2 Net Search Extender Administration and Programming, SC27-1171-00 contains he
step-by-step procedures to activate the functions of Net Search Extender.

The README file, which is installed to the HFS file /usr/lpp/db2nx/readme, contains additional
information regarding the use of Net Search Extender

18 Net Search Extender Program Directory

Reader's Comments
Program Directory for DB2 Net Search Extender for OS/390 and z/OS

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 very not
satisfied <=====================> dissatisfied applicable
1 2 3 4 5 N

Satisfaction
Ease of product installation 1 2 3 4 5 N
Contents of program directory 1 2 3 4 5 N
Installation Verification Programs 1 2 3 4 5 N
Time to install the product 1 2 3 4 5 N
Readability and organization of program directory tasks 1 2 3 4 5 N
Necessity of all installation tasks 1 2 3 4 5 N
Accuracy of the definition of the installation tasks 1 2 3 4 5 N
Technical level of the installation tasks 1 2 3 4 5 N
Ease of getting the system into production after 1 2 3 4 5 N
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

19
 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 DB2 Net Search
Extender for OS/390 and z/OS Development group):

IBM Corporation
PO Box 49023
San Jose, CA 95161
Attn: DB2 Test and Systems Services, W68/B373

FAX Number: (408) 463-2614

E-Mail: jfigoneŒus.ibm.com

20 Net Search Extender Program Directory

IBM
Program Number: 5675-DB2 6180
6181
6182
6183
6184
6185
6186
6187
6188

Printed in U.S.A.

GI19-8242-99