Refreshing the management directory
Refreshing the management directory for a service instance gathers
existing configuration data on the service instance from the z/OS
system. This data might be used in the customization dialogs of the
service or when updating the system configuration. A service
instances' refresh data can also be used in the customization dialogs or
update processing of another service that has dependencies on the service that
provides the refresh data.
Note:
- Not every service that can be customized needs to be refreshed. Not
every service that can be refreshed can be customized.
- For a service the refresh data provided by another service can be required
or optional. You cannot customize unless the required refresh data has
become available. You can opt to customize without the optional refresh
data.
- A service may have cross-scope dependencies. In this case,
required and optional data may be provided by system level as well as
syplex-wide services that may reside on a different z/OS
system.
When to refresh the management directory:
Refresh the management directory in these situations:
- Refresh the management directory in preparation to a customization.
If a service has previously been set up on a system without using
msys for Setup, refreshing the management directory can gather data from this
previous setup, to be used as default for the new configuration. Some
services also have dependencies on the configuration data of other system
level or syplex-wide services that is gathered when you refresh the management
directory.
- Refresh the management directory to keep the information in the management
directory up to date with the actual configuration data on your system if
changes have been made to the system configuration outside msys for
Setup. This can happen, for example, if you set up a product that is
not enabled for msys for Setup, or in a recovery situation.
- Refresh the management directory as part of error recovery. See
backup and restore.
- Refresh the management directory for the Sysplex-wide settings service if
another Couple Data set has been activated (through a command or a new IPL)
since the previous refresh was performed.
You are prompted to refresh the management directory when attempting to
customize a service that requires refresh data for its customization.
You can start refresh from the list of services in the list view of the
workplace (see Displaying the refresh management directory panel for a service instance).
- Note:
- There is an icon Refresh console and a menu item
View --> Refresh console F5. This
merely refreshes the workplace with data from the management directory.
Do not confuse this with refreshing the management directory with data from a
z/OS system.