14. Conventions and terminology used in this document
When this document refers to IBM® System z® servers without stating a specific
server, it refers to all of the following servers:
| v IBM zEnterpriseTM 114 (z114)
v IBM zEnterpriseTM 196 (z196)
v IBM System z10™ Enterprise Class (z10 EC)
v IBM System z10 Business Class (z10 BC)
v IBM System z9® Enterprise Class (z9 EC), formerly the IBM System z9 109
(z9-109)
v IBM System z9 Business Class (z9 BC)
v IBM eServer™ zSeries® 990 (z990)
v IBM eServer zSeries 890 (z890)
v IBM eServer zSeries 900 (z900)
v IBM eServer zSeries 800 (z800)
Important terms you should understand are:
v Migration. Migration is the first of two stages in an upgrade to a new release of
z/OS. (The second stage is exploitation.) During this stage you install your new
system with the objective of making it functionally compatible with the previous
system. After a successful migration, the applications and resources on the new
system function the same way (or similar to the way) they did on the old system
or, if that is not possible, in a way that accommodates the new system
differences so that existing workloads can continue to run. Migration does not
include exploitation of new functions except for new functions that are now
required.
v Exploitation. Exploitation is the second of two stages in an upgrade to a new
release of z/OS. (The first stage is migration.) During this stage you do
whatever customizing and programming are necessary to take advantage of
(exploit) the enhancements available in the new release.
v Coexistence. Coexistence is the situation in which two or more systems at
different software levels share resources. The resources could be shared at the
same time by different systems in a multisystem configuration, or they could be
shared over a period of time by the same system in a single-system
configuration.
Examples of coexistence are two different JES releases sharing a spool, two
different service levels of DFSMSdfp sharing catalogs, multiple levels of SMP/E
processing SYSMODS packaged to exploit the latest enhancements, or an older
level of the system using the updated system control files of a newer level (even
if new function has been exploited in the newer level).
The sharing of resources is inherent in multisystem configurations that involve
Parallel Sysplex® implementations. But other types of configurations can have
resource sharing too. Examples of configurations where resource sharing can
occur are:
– A single processor that is time-sliced to run different levels of the system,
such as during different times of the day
– A single processor running multiple images by means of logical partitions
(LPARs)
– Multiple images running on several different processors in either Parallel
Sysplex or non-Parallel Sysplex configurations
The way in which you make it possible for earlier-level systems to coexist with
the most current level is to install coexistence and fallback PTFs on the
earlier-level systems.
xii z/OS V1R13.0 Migration
15. v Fallback. Fallback is a return to the prior level of a system. Fallback can be
appropriate if you migrate to a new release and, during testing, encounter severe
problems that can be resolved by backing out the new release. By installing
coexistence and fallback PTFs on the “old” system before you migrate, the old
system can tolerate changes that were made by the new system during testing.
To identify the timing of migration actions, this document uses three types of
headings:
v Actions to perform Before installing z/OS V1R13. These are migration actions
that you perform on your current system, either because they require the current
system or because they are possible on the current system. You do not need the
z/OS V1R13 level of code to make these changes, and the changes do not
require the z/OS V1R13 level of code to run once they are made. Examples are
installing coexistence and fallback PTFs on your current system, discontinuing
use of hardware or software that will no longer be supported, and starting to
use existing functions that were optional on prior releases but required in z/OS
V1R13.
v Actions to perform before the first IPL of z/OS V1R13. These are migration
actions that you perform after you have installed z/OS V1R13 but before the
first time you IPL. These actions require the z/OS V1R13 level of code to be
installed but do not require it to be active. That is, you need the z/OS V1R13
programs, utilities, and samples in order to perform the migration actions, but
the z/OS V1R13 system does not have to be IPLed in order for the programs to
run. Examples are running sysplex utilities and updating the RACF® database
template.
It is possible to perform some of the migration actions in this category even
earlier. If you prepare a system on which you will install z/OS V1R13 by
making a clone of your old system, you can perform migration actions that
involve customization data on this newly prepared system before installing
z/OS V1R13 on it. Examples of such migration actions are updating
configuration files and updating automation scripts.
v Actions to perform after the first IPL of z/OS V1R13. These are migration
actions that you can perform only after you have IPLed z/OS V1R13. You need
a running z/OS V1R13 system to perform these actions. An example is issuing
RACF commands related to new functions. Note that the term “first IPL” does
not mean that you have to perform these actions after the very first IPL, but
rather that you need z/OS V1R13 to be active to perform the task. You might
perform the task quite a while after the first IPL.
Each migration action within the headings above is presented using the following
standard format:
v A title that identifies the migration action.
v Description. This is a brief description of the functional change that caused the
migration action.
v Element or feature. This is the name of the base element or optional feature that
changed.
v When change was introduced. This is the z/OS release in which the change was
introduced.
v Applies to migration from. The migration action is relevant if you are migrating
from this release.
About this document xiii
16. v Timing. This is when you should perform the migration action. There are three
categories: before installing z/OS, before first IPL, or after first IPL. (For SMP/E
there are two categories: after installing SMP/E but before starting to use it, and
after starting to use SMP/E.)
v Is the migration action required? This question refers to the migration action
identified by the title. The answer can be one of the following:
– Yes. The migration action is required in all cases.
– Yes, if... The migration action is required only in a certain case. Most of the
migration actions in this document are in this category.
– No, but recommended... The migration action is not required but is
recommended because it is a good programming practice, because it will be
required in the future, or because it resolves unacceptable system behavior
(such as poor usability or poor performance) even though resolution might
require a change in behavior.
v Target system hardware requirements. This is hardware required by the
functional change. It could be processor and peripheral devices; drivers,
engineering changes, or patches needed; or specific hardware functions that
must be active.
v Target system software requirements. This is software required by the functional
change. It could be z/OS optional features, software products, and PTFs that are
needed on the target system, as well as specific software functions that must be
active.
v Other system (coexistence or fallback) requirements. These are requirements
placed on an earlier release by the functional change in the new release. The
earlier release could be running on a system that shares resources (coexists) with
the new system or it could be the release from which you are migrating (and to
which you might want to fall back).
v Restrictions. These are any known limits on how the function can be used.
v System impacts. These are any known impacts of using the function, such as
increased storage or more time required to run.
v Related IBM Health Checker for z/OS check. These are IBM Health Checker for
z/OS checks available for the migration action.
v Steps to take. This is what you have to do to perform the migration action.
v Reference information. This is a pointer to additional information that helps you
perform the migration action.
The order in which the migration actions are presented does not imply importance
or chronology.
Related information
See z/OS Introduction and Release Guide for an introduction to z/OS and an
overview of the new functions in each release of z/OS.
See z/OS Planning for Installation for a summary of installation changes in each
release of z/OS, driving system hardware and software requirements, target
system hardware and software requirements, the coexistence-migration-fallback
policy, required releases of IBM middleware products, and considerations for
planning future installations.
To view, search, and print z/OS publications, go to the z/OS Internet Library at
http://www.ibm.com/eserver/zseries/zos/bkserv/.
xiv z/OS V1R13.0 Migration
20. - “Examine use of the CMDS ABEND command” on page 126.
- “Ensure Runtime Diagnostics is installed before invoking Predictive Failure
Analysis” on page 127.
– Communications Server
- “IP Services: Define a user ID for the system resolver with an associated
OMVS segment” on page 135.
- “IP Services: Ensure storage availability for ancillary input queue for
Enterprise Extender traffic” on page 137.
- “IP Services: Permit IKE daemon running in FIPS mode to use additional
ICSF services” on page 138.
- “IP Services: Understand and prepare for expanded Intrusion Detection
Services” on page 140.
- “IP Services: Ensure that the FTP user exit routine FTCHKPWD tolerates an
additional parameter” on page 141.
- “IP Services: Understand change in VIPARANGE security verification
processing” on page 142.
- “SNA Services: Ensure IVTCSM ASSIGN_BUFFER requests do not exceed
500 images for a single CSM buffer” on page 150.
- “IP Services: Review VIPARANGE definitions” on page 151.
- “SNA Services: Adjust to the relocation of the VTAM internal trace table”
on page 157.
– Cryptographic Services
- “ICSF: Ensure the CSFPUTIL utility is not used to initialize a PKDS” on
page 166.
- “System SSL: Ensure PKCS #11 tokens contain complete certificate chains”
on page 170.
- “ICSF: Ensure the expected master key support is available” on page 173.
– DFSMS
- “DFSMSdfp: Accommodate deletion of NOIMBED and NOREPLICAT
LISTCAT command attributes” on page 179.
- “DFSMSdfp: Update operator procedures and system automation for new
DADSM pre- and post-processing dynamic exits” on page 186.
- “DFSMSdfp: Update procedures that use IEBDSCPY alias name to access
IEBCOPY” on page 187.
- “DFSMShsm: Accommodate the changed default of PDA trace during
DFSMShsm startup” on page 194.
- “DFSMShsm: Accommodate the changed SETSYS FASTREPLICATION
command DATASETRECOVERY parameter default” on page 195.
- “DFSMShsm: Replace user-defined patch with new SETSYS
FASTREPLICATION command to enable ARC1809I messages” on page 196.
- “DFSMShsm: Review messages changed from I (informational) to E
(eventual action) type” on page 197.
- “DFSMShsm: Remove patch that prevents SMS MVT chain rebuild” on
page 198.
- “DFSMShsm: Update operator procedure in the Multicluster CDS
environment” on page 199.
- “DFSMSdfp: Accommodate 64-bit and AR mode rules enforcement in
DFSMS macros” on page 204.
- “DFSMSdfp: Run OAM configuration database migration job” on page 205.
xviii z/OS V1R13.0 Migration
21. - “DFSMSdss: Accommodate Catalog Search Interface default change” on
page 207.
- “DFSMShsm: Stop using the HOLD command to quiesce activity prior to
control data set backup” on page 208.
– Distributed File Service
- “zFS: Accommodate new DASD space requirements” on page 215.
- “zFS: Copy cloned file systems to a compatibility mode aggregate” on page
217.
- “zFS: Copy data from zFS multi-file system aggregates to zFS compatibility
mode aggregates” on page 218.
- “zFS: Ensure sysplex=filesys is available on all zFS R11 and R12 systems in
a shared file system environment” on page 219.
- “zFS: Verify virtual storage usage” on page 222.
- “DCE/DFS: Disable DFS Client initialization” on page 224.
– Infoprint Server
- “Update or remove the region size in the AOPSTART startup procedure”
on page 232.
– JES3
- “Modify code that depends on the format of suppressed split messages in
the DLOG” on page 245.
- “Avoid redundant *S main,FLUSH command in response to XCF messages”
on page 246.
– Language Environment
- “Convert to CEEPRMxx to set system-level default runtime options” on
page 251.
– RMF
- “Check your automation for Monitor III messages ERB812I and ERB813I”
on page 259.
- “Determine need of SMF data collection for Postprocessor Serialization
Delay report” on page 261.
– SDSF
- “Update configuration for sysplex support” on page 266.
- “Review colors on the OPERLOG panel” on page 267.
- “Set the format of device names on the Punch and Reader panels” on page
268.
– Security Server
- “Normalize user names specified as X.500 distinguished names in
distributed identity filters” on page 273.
– z/OS UNIX
- “Update invocations of /usr/sbin/mount commands” on page 289.
- “Update invocations of /usr/sbin/unmount commands” on page 290.
- “Review programs that invoke the BPX1EXM/BPX4EXM callable service”
on page 291.
- “Update invocations of MOUNT statements in the BPXPRMxx parmlib
member” on page 298.
- “Accommodate changes to support read-only z/OS root for the cron, mail,
and uucp utilities” on page 299.
Summary of changes xix
22. - “Discontinue use of invalid REXX variables in z/OS UNIX syscalls” on
page 302.
Changed information:
v z/OS Management Facility (z/OSMF) migration actions are located in
"Migrating from an earlier release of z/OSMF" in IBM z/OS Management Facility
Configuration Guide.
v “Elements and features that do not have migration actions” on page 5 has been
updated.
v “Update your check customization for modified IBM Health Checker for z/OS
checks” on page 28 has been updated to reflect new, changed, and deleted IBM
for Health Checker for z/OS checks.
v Table 3 on page 30 has been updated.
v Table 4 on page 36 has been updated.
v “Accommodate ISC-3, PSC, ESCON, FICON, OSA-Express2, and dial-up modem
changes introduced with the IBM zEnterprise 196 (z196) server and the IBM
zEnterprise 114 (z114) server” on page 42 has been updated to include
information about the new IBM zEnterprise 114 (z114) server.
v The z/OS V1R12 migration action, "Migrate to an IBM zEnterprise 196 (z196)
server," has been undated to include information about the new IBM zEnterprise
114 (z114 server) and is now titled, “Migrate to an IBM zEnterprise server” on
page 47.
v "IP Services: Migrate from DNS BIND 9.2.0" and replaced with “IP Services:
Migrate from BIND 9.2.0” on page 139.
v “Determine the impact of added and changed runtime options” on page 249 has
been updated.
v Also, see additional changes indicated by the change bar | in the margin.
Deleted information:
v Approximately 80 migration actions have been deleted because they applied to
migrations from z/OS V1R10, and that release is not supported for migration to
z/OS V1R13.
v z/OS Management Facility (z/OSMF) migration actions can be found in
"Migrating from an earlier release of z/OSMF" in IBM z/OS Management Facility
Configuration Guide.
This document contains terminology, maintenance, and editorial changes. Technical
changes or additions to the text and illustrations are indicated by a vertical line to
the left of the change.
xx z/OS V1R13.0 Migration
24. 6. Prepare target system hardware and software. During this step, perform the
migration actions identified by headings that say actions to perform before
the first IPL of z/OS V1R13. (Again, not all of the actions are required. Some
depend on your environment, configuration, and workload, and are identified
accordingly.)
7. IPL the new z/OS V1R13 system with your updated customization and
configuration files.
8. Perform any migration actions identified by headings that say actions to
perform after the first IPL of z/OS V1R13. (Again, not all of the actions are
required. Some depend on your environment, configuration, and workload,
and are identified accordingly.)
Use IBM Health Checker for z/OS to assist with some migration actions. See
“Using IBM Health Checker for z/OS for migration checking.”
9. Deploy z/OS V1R13 to other systems within a sysplex, data center, and
enterprise.
The migration is now complete.
10. When you are confident that a system, or in some cases all systems in a
sysplex, are not going to fall back to z/OS V1R12 or z/OS V1R11 exploit the
functions introduced in z/OS V1R13.
11. Deploy this exploitation on other systems (again within a sysplex, data center,
and eventually enterprise).
Using IBM Health Checker for z/OS for migration checking
Beginning with z/OS V1R10, the IBM Health Checker for z/OS infrastructure is
being exploited for migration purposes. Checks are being added to help you
determine the applicability of various migration actions. Before you migrate to
your new z/OS release, you should use these new checks to assist with migration
planning. After you migrate, you should rerun them to verify that the migration
actions were successfully performed. As with any IBM Health Checker for z/OS
check, no updates are made to the system. These new migration checks only report
on the applicability of specific migration actions on a system, and only on the
currently active system.
The migration checks are very similar to the other checks provided by IBM Health
Checker for z/OS. The only differences are:
v The names of migration checks follow the convention
ZOSMIGVvvRrr_component_program_name (or, for ICSF,
ICSFMIGnnnn_component_program_name). Notice the “MIG” characters followed
immediately by the release identifier. This convention tells you that the check
helps with migration and it tells you the release in which the migration action
was introduced. If the release in which the migration action was introduced is
not known, the name will be ZOSMIGREC.
v By default, migration checks are inactive. This is because you might not want to
know about migration actions during nonmigration periods.
System REXX health check considerations
All exploiters of the System REXX support in z/OS require that the System REXX
customization be performed. Using the IBM Health Checker for z/OS health
checks is one example of possible System REXX exploitation. In particular, any
compiled REXX execs must have the proper runtime support available from the
Alternate Library for REXX (available in z/OS since V1R9) or from the IBM
Library for REXX on zSeries (5695-014). Several IBM Health Checker for z/OS
2 z/OS V1R13.0 Migration
25. migration health checks have been written in compiled System REXX. These health
checks rely upon the System REXX customization and runtime activities being
completed. If System REXX (and the security environment that System REXX
requires) have not been properly customized, then System REXX health checks will
not execute successfully.
v For System REXX customization activities, refer to "System REXX" in z/OS MVS
Programming: Authorized Assembler Services Guide.
v For compiled REXX exec runtime availability, see "Alternate Library for REXX
Customization Considerations" in z/OS Program Directory, or refer to product
documentation accompanying IBM Library for REXX on zSeries.
As stated previously, migration checks are intended to be used on your current
z/OS release and then again after you have migrated to your new z/OS release.
The steps you might follow in each of these two scenarios are shown below.
On your current z/OS release:
1. Install the latest migration checks. Review all the latest health checks (for both
best practices and migration) by using the functional PSP bucket HCHECKER
(which is SMP/E FIXCAT IBM.Function.HealthChecker). If you want to see all
IBM Health Checker for z/OS checks see http://www.ibm.com/systems/z/os/
zos/hchecker/check_table.html.
You might want to install the PTFs during a regular service window so that an
IPL is scheduled afterwards. Checks are often added by a function when it is
started or restarted, so you might find that installing the PTFs before a
scheduled IPL works best for you. Additional migration checks can be added at
different times, so having all the latest ones installed prior to making your
migration plans is recommended.
2. Activate the migration checks appropriate to your migration path. Because the
naming convention for migration checks indicates which release introduced the
corresponding migration actions, you can activate just the checks appropriate
for your migration path. Using SDSF (or another method for viewing checks,
such as filters), you can view ahead of time which migration checks you have
available on your system. For example, if you are migrating from z/OS V1R11
to z/OS V1R13 you need to activate the migration checks for changes that
occurred in both z/OS V1R12 and z/OS V1R13. If you are migrating from
z/OS V1R12 to z/OS V1R13, you only need to activate the migration checks for
changes that occurred in z/OS V1R13. There are many ways to make a check
active, as well as many ways of using wildcards to include specific checks.
Here are some examples of using the MODIFY command to make checks
active:
v F HZSPROC,ACTIVATE,CHECK=(IBM*,*MIG*)
v F HZSPROC,ACTIVATE,CHECK=(IBM*,ICSFMIG*)
v F HZSPROC,ACTIVATE,CHECK=(IBM*,ZOSMIGV1R12)
Remember that for z/OS, two naming conventions are used: one for ICSF (that
starts with ICSFMIGnnnn) and one for the rest of z/OS (that starts with
ZOSMIGVvvRrr). Use a wildcard filter that includes the intended migration
checks.
3. Review the migration check output and rerun checks as appropriate. Any exceptions
should be addressed in your migration plan. If you can complete the migration
action prior to moving to the new z/OS release, you can rerun the check to
verify that it was completed correctly on your current system.
Chapter 1. Introduction 3
26. 4. Deactivate the migration checks if you desire. If you no longer desire to have the
migration checks active, you can deactivate them similar to the way you
activated them. For example:
v F HZSPROC,DEACTIVATE,CHECK=(IBM*,*MIG*)
v F HZSPROC,DEACTIVATE,CHECK=(IBM*,ICSFMIG*)
v F HZSPROC,DEACTIVATE,CHECK=(IBM*,ZOSMIGV1R12)
After you have migrated to the new z/OS release, the steps are similar:
1. Install the latest migration checks. New migration checks might be available for
your new z/OS system since you installed it. Therefore, review all the latest
health checks (for both best practices and migration) by using the functional
PSP bucket HCHECKER (which is SMP/E FIXCAT
IBM.Function.HealthChecker). If you want to see all IBM Health Checker for
z/OS checks that are available, see http://www.ibm.com/systems/z/os/zos/
hchecker/check_table.html.
2. Activate the migration checks appropriate to your migration path. For migration
verification, activate the checks appropriate on the release you are migrating
from, migrating through, and migrating to. For example, if you are migrating
from z/OS V1R11 to z/OS V1R13, you need to activate the migration checks
for changes that occurred in both z/OS V1R12 and z/OS V1R13. If you are
migrating from z/OS V1R12 to z/OS V1R13, you only need to activate the
migration checks for changes that occurred in z/OS V1R13. Here are some
examples of using the MODIFY command to make checks active. (These are the
same activation commands shown previously.)
v F HZSPROC,ACTIVATE,CHECK=(IBM*,*MIG*)
v F HZSPROC,ACTIVATE,CHECK=(IBM*,ICSFMIG*)
v F HZSPROC,ACTIVATE,CHECK=(IBM*,ZOSMIGV1R12)
3. Review the migration check output and rerun checks as appropriate. Any exceptions,
which could indicate that a migration action was not performed correctly,
should be addressed. Rerun the check after the corrections have been made.
4. Deactivate the migration checks. Once your migration verification is complete,
deactivate the migration checks similar to the way you activated them. For
example (using the same deactivation commands shown previously):
v F HZSPROC,DEACTIVATE,CHECK=(IBM*,*MIG*)
v F HZSPROC,DEACTIVATE,CHECK=(IBM*,ICSFMIG*)
v F HZSPROC,DEACTIVATE,CHECK=(IBM*,ZOSMIGV1R12)
Within this document, the migration actions that have checks are clearly identified
within the migration actions. All of the checks are made by IBM Health Checker
for z/OS but, as stated earlier, some of the checks are the new migration checks
(identified by names that start with ZOSMIGVvvRrr or ICSFMIGnnnn) and others
are regular health checks.
Note that not all migration actions in this document are addressed by checks;
many migration actions do not lend themselves to programmatic checking.
Therefore, use this document to prepare your migration plan and do not rely solely
on checks.
4 z/OS V1R13.0 Migration
27. EPSPT replaced by FIXCAT and REPORT MISSINGFIX
IBM removed the Enhanced PSP Tool (EPSPT), host compare program, and the
associated extract files from the IBM Technical Support web site
(http://www14.software.ibm.com/webapp/set2/psp/srchBroker), effective 31
December 2010. The Enhanced PSP Tool's function has been replaced by the
addition of FIXCAT (fix category) information to Enhanced HOLDDATA and the
REPORT MISSINGFIX function introduced in z/OS V1R10 SMP/E, which offers
distinct advantages over the Enhanced PSP Tool. This SMP/E function is also
available for all supported releases of z/OS in SMP/E for z/OS V3R6 (5655-G44),
which you can order separately.
| z/OS Management Facility
| IBM z/OS Management Facility (z/OSMF) provides system programmers with a
| framework for managing various aspects of a z/OS system through a web browser
| interface. By streamlining some traditional tasks and automating others, z/OSMF
| can help to simplify the day-to-day operations and administration of a z/OS
| system. For more information about z/OSMF, see www.ibm.com/systems/z/os/
| zos/zosmf/.
| For information about z/OSMF migration steps, see "Migrating from an earlier
| release of z/OSMF" in IBM z/OS Management Facility Configuration Guide.
Elements and features that do not have migration actions
The following z/OS V1R13 elements and features do not have migration actions
and thus are not discussed:
v Alternate Library for REXX
v BDT
v BDT File-to-File
v BDT SNA NJE
v BookManager® BUILD
v BookManager READ
| v CIM
v Communications Server Security Level 3
v EREP
v ESCON® Director Support
v FFST
v GDDM
v GDDM-PGF
v GDDM-REXX
v HCD
| v HCM
v HLASM
v HLASM Toolkit
v IBM HTTP Server
v ICKDSF
| v Integrated Security Services
v ISPF
v Metal C Runtime Library
v MICR/OCR
v NFS
v Run-Time Library Extensions
v TIOC
| v z/OS IBM TDS
Chapter 1. Introduction 5
28. v z/OS Security Level 3
v 3270 PC File Transfer Program
6 z/OS V1R13.0 Migration
