Previous Topic: Resource Section ConsiderationsNext Topic: Removing Entities in History Status

Preparing and Maintaining VLS Libraries in CA Ideal › Restoring Deleted Entities › Restoration Procedures

Restoration Procedures

Scenario 1

An entity in version 1 was deleted and there are no other versions of that entity in the system.

  1. Create the entity in CA Ideal, filling in the identification section. If the entity is a program, you must also fill in the resource
    section.
  2. Use the VLSUTIL SELREST function to restore all VLS source members for the entity.
Scenario 2

An entity in a version other than version 1 was deleted, and there are no other versions of that entity in the system. Plus, you want the entity returned with the original version number.

  1. Create the entity in CA Ideal, filling in the identification section. If the entity is a program, you must also fill in the resource section.
  2. Source transport the entity, first exporting it, then importing it back to the original system using the command SET IMPORT NEW VERSION x, where x is the version of the program you are going to restore from VLS.
  3. Use the VLSUTIL SELREST function to restore all VLS source members for the entity.
  4. Delete Version 1 of the entity from CA Ideal.
Scenario 3

An entity in a version other than version 1 was deleted and there are no other versions of that entity in the system. Plus, you want the entity returned in a version that is different from the original.

Option 1
  1. Create the entity in CA Ideal, filling in the identification section. If the entity is a program, you must also fill in the resource section. If you want the entity returned in a version other than 1, you must either use source transport to create the correct version or duplicate the entity to the correct version.
  2. Use the VLSUTIL SELREST function to restore all VLS source members for the entity.
  3. Use the VLSUTIL RENAME function to rename all VLS source members for the entity from the original version to the new version.
  4. Delete any unwanted versions of the entity from CA Ideal.
Option 2
  1. Create the entity in CA Ideal, filling in the identification section. If the entity is a program, you must also fill in the resource section.
  2. Source transport the entity, first exporting it, then importing it back to the original system using the command SET IMPORT NEW VERSION x, where x is the version of the program you are going to restore from VLS.
  3. Use the VLSUTIL SELREST function to restore all VLS source members for the entity.
  4. Source transport the entity, first exporting it, then importing it back to the original system using the command SET IMPORT NEW VERSION x, where x is the new version of the entity. Also, make sure that you use the command SET IMPORT DUPLICATE REPLACE.
  5. Delete any unwanted versions of the entity from CA Ideal.
Scenario 4

An entity was deleted and there are lower numbered versions of the entity on the system. The entity is returned with the original version number.

Option 1

  1. Source transport the entity, first exporting it, then importing it back to the original system using the command SET IMPORT NEW VERSION x, where x is the version of the program you are going to restore from VLS.
  2. Use the VLSUTIL SELREST function to restore all VLS source members for the entity.
Option 2
  1. Use the CA Ideal DUPLICATE command to duplicate the entity to the version you are going to restore.
  2. Use the VLSUTIL SELREST function to restore all VLS source members for the entity.
  3. Use the CA Ideal DELETE command to delete unwanted versions of the entity.
Scenario 5

An entity was deleted and there are higher numbered versions of the entity on the system. The entity is returned with the original version number.

  1. Source transport the entity, first exporting it, then importing it back to the original system using the command SET IMPORT NEW VERSION x, where x is the version of the program you are going to restore from VLS.
  2. Use the VLSUTIL SELREST function to restore all VLS source members for the utility.

Example 1

Version 18 of program ABC in system $ID was accidentally deleted. Version 19 of the same program exists in $ID. You want the program in its original version.

You follow Scenario 5 in this example. First export program ABC, version 19, then import using the command SET IMPORT NEW VERSION 18. Next use VLSUTIL SELREST to restore version 18 of the program to the source library.

Example 2

Version 6 of program TEST in system $ID was accidentally deleted. No other version of the program exists in $ID. You want the program returned in version 3.

You follow Scenario 3 for this example. Create program TEST VER 1 in system $ID. Fill in the identification and resource sections. Use source transport to export the program, then import using SET IMPORT NEW VERSION 6. Use VLSUTIL SELREST to restore version 6 of the program to the VLS library. Use source transport again, exporting version 6, then import using SET IMPORT NEW VERSION 3. You can then delete version 6 from CA Ideal.

What to Do When the Library Is Full

A VLS library has a limit of 60,900 blocks with 2-byte block numbers. If the library becomes full, you must determine why the library is full before you can correct the problem. There are four possible reasons for the library to become full:

The following sections describe each of these problems and the recommended solutions.