Z-OS New Era of Networks Program Directory
Z-OS New Era of Networks Program Directory
FMID JSI2101
GI10-2544-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.
1.0 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 New Era of Networks feature Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 New Era of Networks feature FMID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Reader's Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Figures
1. Basic Material: Program Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Program File Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3. Basic Material: Unlicensed Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
4. Publications Useful During Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
5. PSP Upgrade and Subset ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
6. Component IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
7. Driving System Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
8. Mandatory Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
9. Functional Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
10. Total DASD Space Required by New Era of Networks feature . . . . . . . . . . . . . . . . . . . . 11
11. Storage Requirements for New Era of Networks feature Target Libraries . . . . . . . . . . . . . . 13
12. New Era of Networks feature HFS Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
13. Storage Requirements for New Era of Networks feature Distribution Libraries . . . . . . . . . . . 14
14. Storage Requirements for New Era of Networks feature Non-SMP/E Data Sets . . . . . . . . . . 15
15. SMP/E Options Subentry Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
16. Sample Installation Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
17. High-level qualifiers for data set names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
18. Symbolic parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
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
You are responsible for payment of any taxes, including personal property taxes, resulting from this
authorization.
Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply
to you.
Trademarks
The following terms are trademarks of the IBM Corporation in the United States or other countries or both:
DB2 OS/390
IBM S/390
MQSeries WebSphere
MVS z/OS
Before installing New Era of Networks feature, read 3.2, “Preventive Service Planning” on page 7. 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 New Era of Networks feature 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 New Era of Networks feature using the 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 New Era of Networks feature are included
on the CBPDO tape.
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 New Era of Networks feature.
Ask your IBM representative for this information if you have not already received a copy.
Figure 1 describes the physical tape. Figure 2 describes the file content.
Notes:
1. The data set attributes in these tables should be used in the JCL of jobs reading the data sets, but
since the data sets are in IEBCOPY unloaded format, their actual attributes may be different.
2. If you are installing New Era of Networks feature using the 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.
Program Materials 5
Figure 4 (Page 2 of 2). Publications Useful During Installation
Form
Publication Title Number
IBM SMP/E for z/OS and OS/390 Reference SA22-7772
IBM SMP/E for z/OS and OS/390 Messages, Codes, and Diagnosis GA22-7770
OS/390 SMP/E Commands SC28-1805
OS/390 SMP/E Messages and Codes SC28-1738
OS/390 SMP/E Reference SC28-1806
OS/390 SMP/E User's Guide SC28-1740
OS/390 UNIX System Services User's Guide SC28-1891
z/OS MVS Initialization and Tuning Reference SA22-7592
z/OS MVS JCL Reference SA22-7597
z/OS SMP/E Commands SA22-7771
z/OS SMP/E Messages, Codes, and Diagnosis GA22-7770
z/OS SMP/E Reference SA22-7772
z/OS SMP/E User's Guide SA22-7773
If you obtained New Era of Networks feature 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 New Era of Networks feature are:
Figure 6 identifies the component IDs (COMPID) for New Era of Networks feature.
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.
Figure 10 lists the total space required for each type of library.
Figure 10. Total DASD Space Required by New Era of Networks feature
Library
Type Total Space Required
Target 5 tracks
Distribution 1659 tracks
HFS 200 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. 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. 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.
The following figures describe the target and distribution libraries and HFS paths required to install New
Era of Networks feature. The storage requirements of New Era of Networks feature 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.
Figure 13 (Page 1 of 2). Storage Requirements for New Era of Networks feature 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
ABIPINST E PDS FB 80 5 3
ABIPONA U PDS VB 32000 33 3
ABIPONAW U PDS VB 32000 6 3
ABIPONC U PDS VB 32000 7 3
ABIPONCA U PDS VB 32000 6 3
ABIPONCB U PDS FB 80 2 3
ABIPONCP U PDS VB 32000 10 3
ABIPONCT U PDS VB 32000 14 3
ABIPONDA U PDS VB 32000 6 3
ABIPONDL U PDS VB 32000 1145 3
The following figures list data sets that are not used by SMP/E, but are required for New Era of Networks
feature to execute.
Figure 14. Storage Requirements for New Era of Networks feature Non-SMP/E Data Sets
R L
T E R No. No.
Y O C E of of
Data Set P R F C 3390 DIR
Name E G M L Trks Blks
UBIPINST S PDS FB 80 15 20
If you do not wish to delete these FMIDs at this time, you must install New Era of Networks feature into
separate SMP/E target and distribution zones.
If you are going to install into the same SMP/E zones, then to preserve your current release while you
install and test the new release you should copy the existing release data sets into data sets with different
names. Do not rename or delete the current data sets because they need to be available to SMP/E for
delete processing during the installation of the new release. If they are not available, the APPLY and
ACCEPT steps will fail with a return code of 12. After running a successful ACCEPT of the New Era of
Networks feature products, the previous release data sets are no longer required and can be deleted
when testing of the new release has been completed.
If you use existing SMP/E data sets, you need to know the names of your target zone and distribution
zone, and the data set name of your global CSI.
You must decide upon the names for the SMP/E zones.
You may copy the jobs from the tape or product files by submitting the job below. Use either the
//TAPEIN or the //FILEIN DD statement, depending on your distribution medium, and comment out or
You can also access the sample installation jobs by performing an SMP/E RECEIVE and then copying the
jobs from the SMPTLIBs to a work data set for editing and submission. See Figure 16 on page 18 to find
the appropriate SMPTLIB data set.
NOTE: If you obtained New Era of Networks feature as part of a CBPDO, you can use the RCVPDO job
found in the CBPDO RIMLIB data set to RECEIVE the New Era of Networks feature 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.
Installation Instructions 19
6.1.7 Allocate SMP/E Target and Distribution Libraries and Paths
Edit and submit sample job BIP8ALON to allocate the SMP/E target and distribution libraries for New Era
of Networks feature. Consult the instructions in the sample job for more information.
Edit and submit sample job BIP8MKNJ to allocate the HFS paths for New Era of Networks feature.
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.
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.
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.
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
Installation Instructions 21
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.
If these high-level qualifiers do not already exist, you must define them to RACF, or any other security
product you are using, and have ALIAS definitions in the master catalog.
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
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 z/OS products?
Yes
If you have any comments to make about your ratings above, or any other aspect of the product installation, please
list them below:
Organization
Address
Telephone
Please send the completed form to (or give to your IBM representative who will forward it to the WebSphere MQ
Integrator for z/OS New Era of Networks feature Development group):
Reader's Comments 27
WebSphere MQ Integrator for z/OS Development,
Mailpoint 127,
IBM United Kingdom,
Hursley Park,
Winchester,
Hampshire SO21 2JN,
England.
Printed in U.S.A.
GI1-2544-