Defining SSA data for software upgrade

For a software upgrade installation, two panels are used to define SSAs: one for the master catalog and one for user catalogs.

Note: For software upgrades, if the driving system master catalog is the same as the target system master catalog, do not expect an alias connection to be defined in the driving system master catalog. The connection is not necessary because the driving system master catalog and the target system master catalog are the same catalog.

For the master catalog, define your SSAs with the panel shown in Figure 1.

Figure 1. Panel: Define SSA and catalog data (software upgrade) master catalog

CPPP6035  --------------- SSA to CATALOG ( PC000226 ) -------------------------
COMMAND ==>


Define SSAs



          Catalog : MASTER.CATALOG
          Type    : MCAT






          SSA Name       ==> ZORT            (Required)

In the panel, the fields are described as listed below:

Catalog: Name of the catalog for which an SSA is to be defined.
Type: Type of catalog. Always MCAT, indicating the master catalog.

Define the following field:

SSA Name: Specifies the system-specific alias to be used to locate target system data sets. The name you choose must not have an existing alias entry in the driving system's master catalog, and cannot be the same as the high-level qualifier of any data set cataloged in the driving system's master catalog. For a software upgrade installation, these same restrictions apply to existing entries in the target system's master catalog.

For user catalogs, define your SSAs with the panel shown in Figure 2.

Figure 2. Panel: Define SSA and catalog data (software upgrade)

CPPP6036 --------------- SSA to CATALOG ( PC000226 ) -------------------------
COMMAND ==> _

Define SSA and CATALOG Data

          Catalog : TONY.CATALOG
          Type    : UCAT

          SSA Name ==> SMPESSA     (Required)

          Allocate Catalog ==> (Y or N)


 If allocating the catalog, the following information is required:


          Catalog Volume   ==> AMHCAT    (? For List of Available Vols)
          Primary Space    ==> 1         (1-999 Cylinders)
          Secondary Space  ==> 1         (1-999 Cylinders)

In the panel, the fields are described in the following list:

Catalog: Name of the catalog for which an SSA is to be defined.
Type: Type of catalog. Always UCAT, indicating a user catalog.

Define the following fields:

SSA Name

Specifies the system-specific alias to be used to locate target system data sets that will be cataloged in the specified catalog. The name you choose must not have an existing alias entry in the driving system's master catalog, and cannot be the same as the high-level qualifier of any data set cataloged in the driving system's master catalog. For a software upgrade installation, these same restrictions apply to existing entries in the target system's master catalog.

Allocate Catalog

Specifies whether to allocate the catalog. Set this value to Y (yes) if the catalog does not yet exist on the target system, and is to be allocated. Set this value to N (no) if the catalog already exists on the target system; it cannot be allocated again.

Catalog Volume

If you specify that the catalog is to be allocated (that is, you set the Allocate Catalog field to Y), use the Catalog Volume field to specify the volume serial of the DASD on which the catalog is to reside. For a pop-up list of volumes that exist in the work configuration, enter a question mark (?). Select a volume by entering S before the desired volume serial. You are not required to choose a volume from the list. Any volume serial may be specified; if it does not exist, it is added to the configuration.

If the volume you specified already exists in the work configuration, the unit you specify here must match the unit value you specified previously. Otherwise, a message is displayed to prompt you to resolve the mismatch.

If you did not specify that the catalog is to be allocated (you set the Allocate Catalog field to N), do not enter a value for this field.

Space

Specifies the primary and secondary space to be allocated to the catalog, if the catalog does not yet exist on the target system and must be allocated. See the topic "Determining Catalog Size" in z/OS DFSMS Managing Catalogs for information on how much space to allocate for catalogs.

If you did not specify that the catalog is to be allocated (you set the Allocate Catalog field to N), do not enter values for these fields.