0 |
Create new CFRM policy distinct from the currently
active policy with the updated structure definitions based on CFSizer
or SIZER. Alternatively, update the current policy "in place" to
avoid changing the name of the policy.
|
This step can be done ahead of time to minimize
net down time. Appropriate structure sizes for the new CFCC level
can be obtained from CFSizer (http://www-947.ibm.com/systems/support/z/cfsizer/)
or Sizer (http://www-947.ibm.com/systems/support/z/cfsizer/altsize.html).
Updated structure sizes are necessary to ensure that a performance
problem does not occur due to a structure space constraint. Also,
the updated structure sizes will ensure that there is no issue restarting
an application in the future due to invalid structure sizes.
This
step is required for CFCC Level changes. This step is desirable if
the sizes were not adjusted across the last CFCC Level upgrade or
if the usage of the structures has changed significantly.
Caution: This procedure assumes the CF links,
control unit, and CFRM definition are not changing. If the links,
control unit, or CFRM definition change, the CF may become accessible
earlier than planned.
|
1 |
- Quiesce all work on z/OS images that reside on the CPC being PORd
or removed.
- Issue the following command to remove those z/OS images from the
sysplex:
V XCF,sysname,OFFLINE
|
|
2 |
Reassign STP roles, as needed. |
Ensure that CTN will not be disrupted unexpectedly
when the "old" CPC where the CF image resides is removed. For
more information, see IBM White Paper 101833, Important Considerations
for STP server role assignments, at http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101833.
|
3 |
SETXCF START,MAINTMODE,CFNAME=cfname |
Place the CF to be upgraded in maintenance mode,
so that no new structures will be allocated on the CF. |
4 |
D XCF,REALLOCATE,TEST (available
z/OS Version 1 Release 12) |
Preview the results of REALLOCATE. Evaluate
any exceptions. If a severe problem is detected, remove cfname from
MAINTMODE and address the problem. Then, go back to Step 3. |
5 |
SETXCF START,REALLOCATE |
Issue REALLOCATE to have XCF assess each structure
and relocate, as appropriate. XCF will seek to move the structures
off the CF in MAINTMODE. |
6a |
D XCF,CF,CFNAME=cfname |
Determine if any structures remain in the CF
that is being removed from service. If no structures remain in the
CF being removed, go to Step 8.
If structures remain in the CF being removed, follow Step 6b and Step
7. |
6b |
D XCF,REALLOCATE,REPORT (available
z/OS Version 1 Release 12) |
If a structure did not move, review the REALLOCATE
REPORT output and address any errors. |
7 |
If structures remain in CF cfname,
issue the following commands: SETXCF START,REBUILD,STRNAME=strname,LOC=OTHER
SETXCF STOP,REBUILD,DUPLEX,STRNAME=strname,KEEP=NEW|OLD
D XCF,CF,CFNAME=cfname
|
Move any structures that remain in cfname.
Application-specific protocols may be needed to move structures. Then,
verify that no structures remain on the coupling facility about to
be upgraded. For details about moving structures out of the CF,
see Removing structures from a coupling facility for shutdown and Removing a structure from a coupling facility.
|
8 |
VARY PATH(CFNAME,xx,CFNAME,yy,etc),OFFLINE,UNCOND
|
VARY the paths to the CF offline. The VARY command
must be issued from all systems in the sysplex; path numbers may be
different for each system. Taking the paths offline and then recycling
is cleaner for z/OS to handle than not taking the paths offline. The
hot unplug or TOGGLE is received as an “error” by z/OS. To obtain
the list of CHPIDs, issue D CF from each system.
The list of CHPIDs will be helpful when bringing the paths back online.
The
VARY command is used rather than the CONFIG command because it is
possible that use of the links by STP would cause the CONFIG command
to be rejected. Using the VARY command affects only the logical path
state for coupling facility communication and does not affect (nor
is it affected by) the STP network; STP can still use the links to
maintain the timing network.
When the paths are VARYd OFFLINE,
the D CF,CFNAME=cfname command
shows the paths as being logically offline, but physically online.
|
9 |
RO *ALL,D CF,CFNAME=cfname
D XCF,CF,CFNAME=cfname
|
Verify that no system has an active path to
CF. At this point, the paths will indicate logically OFFLINE. Re-verify
that no structures in the CF and no systems have connectivity to CF. |
10 |
From the CF OPERMSG console, issue: SHUTDOWN
|
The SHUTDOWN command is recommended to avoid
the potential error of DEACTIVATING the coupling facility that has
all of the structures allocated in it. The SHUTDOWN command will not
complete if structures are present in the coupling facility. The
following scenario shows the message sequence for the SHUTDOWN command
when structures are still allocated in the CF:
=> shutdown
CF0090A Do you really want to shut down
the Coupling Facility? (YES/NO)
=> yes
CF0093A There are structures present in
the CF. SHUTDOWN canceled.
After the SHUTDOWN command
completes successfully, the CF LPAR will become “not operating.”
If
structures are still allocated in the CF, verify that the correct
CF was selected for SHUTDOWN. If the correct CF was selected, consider
reviewing the structures still allocated in the CF and seek to move
them out of the CF. At this point, the paths must be VARYd back ONLINE
to allow structures to rebuild out of the CF. VARY the paths ONLINE
and go back to Step 7. If VARYing
the paths ONLINE and moving the structures is not desired (that is,
deleting the structures has been deemed acceptable), the CF image
may be DEACTIVATEd.
|
11 |
Perform Power On Reset. |
|
12 |
Activate the CF partition. |
CF must be activated to allow the system to
connect and utilize the image. |
13 |
Reassign STP roles as necessary. |
Ensure STP is in the desired configuration.
For more information, see IBM White Paper 101833, Important
Considerations for STP server role assignments, at http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101833.
|
14 |
V PATH(CFname,xx,CFname,yy,etc),ONLINE |
Because there was no change to the CF definition
in the CFRM policy and the same links and control unit are to be used
to access the CF, the logical state of the paths will be OFFLINE.
Thus, the paths need to be VARYd ONLINE from all of the z/OS images
that remained active. The list of paths made in Step 8 can be referenced. |
15 |
SETXCF START,POLICY,TYPE=CFRM,POLNAME=new_policy
or
SETXCF START,POLICY,TYPE=CFRM,POLNAME=mod_active_policy
|
Activate the new CFRM policy with the definitions
for the updated structure sizes, per CFSizer or SIZER output. Structure
size changes will be pending after the new or modified policy is activated. Bypass
this step, if no policy was created or modified in Step 0.
|
16 |
SETXCF STOP,MAINTMODE,CFNAME=cfname |
Take the newly-defined CF out of MAINTMODE to
allow structure allocations in the new CF. |
17 |
SETXCF START,REALLOCATE |
Relocate structures to the desired CFs. XCF
will seek to resolve the pending policy changes. |
18 |
D XCF,REALLOCATE,REPORT (available
on z/OS Version 1 Release 12) |
Verify that all structures reside in desired
CFs. Correct any errors noted by the report. |
19 |
Verify that structures reside in preferred CFs.
Review output from z/OS Health Check XCF_CF_STR_PREFLIST. Issue
the following SETXCF REBUILD commands, as necessary, to move structures. SETXCF START,REBUILD,STRNAME=strname,LOC=OTHER
SETXCF STOP,REBUILD,DUPLEX,STRNAME=strname,KEEP=NEW|OLD
|
REALLOCATE processing may complete with 0 exceptions
because XCF / XES placed the structure in the most desirable CFs;
this may not coincide with the order of the CFs in the PREFLIST. Investigate
structures that were not placed in the CF that is noted first in the
PREFLIST. Assess the reason for the structure placement and relocated
structures to desired CFs as needed. |
20 |
IPL z/OS images that reside on the CPC that
was PORd. |
|