Cloud Data Manager

Working with resources

Searching a resource

Search resources are available on the upper right of any page.

image13.png

Use a full name or a pattern:

Pattern symbol

Description

%

Replacing one character, e.g. M9RES%

*

Replacing one qualifier, e.g. SYS1.*.PROCLIB

**

Replacing none or several qualifiers, e.g. PROD.**.LOADLIB

A search can be invoked for a data set or a volume by using the full name or a pattern. A “**” prefix and suffix is automatically added to every searched term. When searching for a data set, the search displays available backup copies from incremental backup, full dumps, archived data sets and imported data sets. The search results page is divided into tabs:

  1. The first tab displays data sets

  2. The second tab displays full volumes

  3. The third tab displays z/OS UNIX files

image29.png

The results are extracted for each type, and the tab displays the first 350 results that were found. By default, the results are displayed in ascending name order. Each column can be used for sorting, the sort icon is visible when clicking the column name. Additionally, a “search within results” box is available for further filtering.

It is possible to perform immediate actions on the displayed items. Actions can be performed on an individual item using the 3-dot menu, or on multiple items using the actions listed on the upper right side of the page.

Column “complex”

This value indicates the resource complex and can be used to distinguish between data sets or volumes with the same name in different complexes. The resource complex is defined in the agent.yml, with a default of the group-&SYSPLEX. An agent can be associated with one resource complex, several agents can be associated with the same resource complex. Agents sharing the same resource complex can all interact with the same resources, actions such as backup/archive/recall/restore/list are all dependent on the resource complex parameter.

Viewing resource information

View resource details by selecting the “More details” option from the 3-dot menu:

image42.png

A popup window showing the data set’s details is displayed.

image14.png

View the resource activity log by selecting the “View backup log” option from the 3-dot menu:

image67.png

A popup window showing the resource backup log is displayed.

image62.png

Restoring a resource

Select the “Restore” option from the 3-dot menu:

image34.png
Restoring a data set
image88.png

Target data set name

The operation can allocate the restored data set using a different name than the original backed up data set name. Whether the original name is changed or not, the user must have SAF alter access permission for this data set name in the target system, in addition to Model9 permission to perform the UI restore action.

Restore volume name

The VOLSER name to use for the allocated data set name. The VOLSER can be different from the original VOLSER.

Overwrite target data set?

Whether or not to replace the target data set if it already exists.

Catalog restored data set

Whether or not to catalog the restored data set. SMS-managed data sets will be cataloged, regardless of this parameter setting.

Use the “Advanced SMS parameters” tab to set the SMS attributes of the restored data set. These parameters will be passed to the ACS routines, unless “Bypass ACS routines” is specified. For more information, see the IBM DFSMS documentation.

The parameters are:

Storage class

Specify the storage class to be assigned.

Management class

Specify the management class to be assigned.

Null storage class

Set the storage class to null.

Null management class

Set the management class to null.

Bypass ACS routines

Whether or not to give control to the SMS ACS routines during data set allocation. Using this option requires SAF permission to M9.UI.RESTDSN.BYPASSACS.

When done, click “Restore” to restore the data set.

Restoring a full volume dump

Restoring a full dump disk requires both admin and a restore permission:

image73.png

Target volume name

The target online VOLSER on which the full dump volume will be restored. The restore will erase all previous data on the VOLSER. When restoring a disk, only the data on the disk changes, the restore does not update the catalog.

Overwrite target volume name?

Whether or not to copy the original VOLSER to the target volume. If there is another disk with the same name as the original VOLSER, the other disk will be offlined by the system, as 2 disks cannot exist with the same name.

When done, click “Restore” to restore the volume.

Restoring a z/OS UNIX file
image60.png

Target file

Overwrite target file?

Whether or not to override the target file if it already exists.

When done, click “Restore” to restore the file.

Recalling a data set

Select the “Recall” option from the 3-dot menu:

image19.png

A popup window with recall parameters is displayed.

image58.png

Recall volume name

The operation can allocate the restored data set in a different name than the original backed-up data set. Whether the original name is changed or not, the user must have SAF permissions for this data set name in the target system, in addition to Model9 permissions to perform the UI restore action.

Use the “Advanced SMS parameters” tab to set the SMS attributes of the recalled data set. These parameters will be passed to the ACS routines, unless specified “Bypass ACS routines”. For more information, see the IBM DFSMS documentation.

The parameters are:

Storage class

Specify the storage class to be assigned.

Management class

Specify the management class to be assigned.

Null storage class

Set the storage class to null.

Null management class

Set the management class to null.

Bypass ACS routines

Whether or not to give control to the SMS ACS routines during data set allocation. Using this option requires SAF permission to M9.UI.RESTDSN.BYPASSACS.

When done, click “Recall” to recall the data set.

Exporting an imported data set

An imported data set is a data set that was imported from tape to cloud by the DATA SET IMPORT policy. The “Export” option provides several methods for exporting the data set for use by z/OS applications. Select the “Export” option from the 3-dot menu:

image91.png

Since tapes work differently than DASD, data sets that were originally allocated on tapes can have attributes that are not always applicable for DASD allocation.

Also, data sets on tape do not have the associated space attributes required for DASD allocation, meaning that the allocation parameters that would be used are the ones specified during the “Export” action.

image93.png

Specify the following parameters:

Target Data Set Name

The name of the data set to be allocated in z/OS. By default, the UI displays the imported data set name. Mandatory field.

Export Volume Name

The name of the VOLSER on which the data set is to be allocated in z/OS. Specifying this parameter means the data set will be allocated on a single volume (The “Volume Count” parameter of the “allocation parameters” will be ignored). For SMS-managed data sets, the target VOLSER will be determined by the ACS routines.

Export to z/OS in format DATA SET

This option will create a z/OS data set.

Export to z/OS in format AWS TAPE

This option will create a z/OS data set, containing the exported tape data in an AWS virtual tape format that can be read by distributed platforms. AWS TAPE format is suitable for data sets with a block size not applicable for DASD allocation.

By default, the exported data set will be allocated in a DATA SET in z/OS format, on DASD, with size as automatically calculated based on the imported data set size. The UI provides additional parameters to set the allocation parameters and overwrite SMS parameters.

When choosing the parameters, consider the following:

Size

Many tape data sets are very large in size and may require allocation as large, extended or multi volume data sets on DASD. When exporting a large data set:

  • For SMS-managed data sets, leave the “Export Volume Name” parameter empty, the ACS routines will determine the storage group. Use the ”Allocation parameters” to set the allocation attributes. If you’d like to overwrite the ACS routines, use the “SMS parameters” section.

  • Non-SMS managed data sets can be allocated on a single volume only, use the ”Allocation parameters” to change additional attributes.

Original block size

Cloud storage can accommodate any block size, however, tape data sets can have a block size larger than 32760, that is not eligible for DASD allocation. In this case, allocate the exported data set using one of the following options:

  • AWSTAPE format.

  • DATASET format on a TAPE unit - choose DATA SET and specify tape attributes for the “Export Volume Name” and the “Allocation parameters”.

image94.png

Use the “Allocation parameters” tab to provide the allocation attributes of the exported data set:

Unit

Any applicable z/OS value. Default: 3390

Space in CYLs

By default, the UI will display an estimated size, as automatically calculated based on the imported data set size.

DSNTYPE

Default: NONE.

Volume Count

Default: 5. This parameter is relevant for SMS-managed data sets only, and is ignored if specifying a value in “Export Volume Name”.

Use the “Advanced SMS parameters” tab to set the SMS attributes of the exported data set:

Storage class

Specify the storage class to be assigned.

Management class

Specify the management class to be assigned.

Data class

Specify the data class to be assigned.

When done, click “Export” to export the data set.

Deleting a resource

Select the "Delete" option from the 3-dot menu:

image45.png

Confirm:

image51.png

Click "Delete" to delete the data set.

Deleting multiple resources

Select the resources to be deleted and click “Delete” in the upper right corner. Check the checkbox next to NAME in the heading bar to select all the resources that are currently displayed on the screen.

image68.png

Preparing a full volume dump for stand-alone restore

The “Prepare Stand-Alone Copy” option in the 3-dot menu is part of the stand-alone restore process. The action is available only to Model9 administrators and will not be visible to non-admin users. If the original full dump was created using DFDSS_GZIP, it will not be possible to create a stand-alone copy of it.

image44.png

After the user confirms the action, an asynchronous activity is created in the management server.

image55.png

Once the stand-alone copy is created, select the “View Log” option from the 3-dot menu to display information pertaining to the stand-alone copy, including:

  • Source volume, backup date and size

  • Output directory path, name and size of each dump section

  • Restore command required for restoring data from the Stand-Alone copy

image72.png

Document the restore command in a place that will be accessible during a stand-alone process. See Performing stand-alone restore (bare-metal recovery) for more details.