Northern Illinois University

Information Technology Services

MVS Archives and Backups

MVS's disk management facility is called Automatic Backup and Recovery, or ABR. What most people notice about ABR is the disappearance of some of their disk data sets. Those missing data sets are safely stored away by ABR's archive system. The less noticable but there-when-you-need-it part of ABR is its backup system. Here's how it all works.

Archiving

Archiving keeps the disk packs (the ACA volumes) from filling up with unused or infrequently used data sets. Once every weekend ABR scans each data set for its last-referenced date (the last time the data set was used); if that date is 31 or more days ago, the data set will be archived--copied to tape and scratched from disk. Archived data sets are not lost forever; they will remain on the archive tapes for one year and are easily accessible at any time via a RESTORE request.

Backup

Anyone who has ever lost a data set by accidentally scratching it or by saving another data set over it can appreciate the value of a backup system. ABR's backup system automatically performs a full backup, copying every disk data set to tape, once every 7 days. Also, a backup copy is made daily of every data set that has been modified since the most recent full backup. All backup copies are written to tape and are kept for two weeks, and like archived data sets, they can be brought back to disk using a RESTORE request.

Restoring Data Sets

A RESTORE request brings the specified data set(s) back to disk from either an archive tape or a backup tape. All restore requests are put on a queue (in a waiting line). RESTOREs from archive tapes are processed approximately every half-hour. RESTOREs from backup tapes are processed once a day at about 2 a.m. Because ABR uncatalogs all cataloged data sets when they are archived, you may need to re-catalog restored data sets.

We recommend that restores from archive tapes be made for only the data sets you need to use. If all data sets are brought back to disk, the space-saving effects of ABR will be lost.

Superwylbur Macros

Simple and easy-to-use Superwylbur macros are available for public use of ABR functions. These macros will prompt you with a series of questions and set up a batch job using your responses. You can either run this job (it will run FETCH) or save the job in a TEMP (temporary file) for future use.

To use the ABR macro commands, first type:

CALL FROM &PUBLIC.ABR.MACROS:CMDS

Press Enter and you will get the usual Superwylbur prompt of "?". Now, just type in one of the following macro commands:

  • ABRDOC
    To obtain general information about ABR's archive and backup system and documentation on each ABR macro.
  • ARCHIVE
    To request that a data set(s) be archived if you don't want to wait for automatic archiving to take place.
  • ARCLIST
    To obtain a list of archived data sets for a given AccountID.
  • BACKLIST
    To obtain a list of data sets which can be returned from backup tapes for a given AccountID. Note: Some Superwylbur sequential data sets may not appear on this list although they actually are on a backup tape. This situation arises from a RESAVE which Superwylbur sees as a new file, erasing all past history.
  • RESET
    To delete an ARCHIVE or BACKUP request (i.e., to allow you to change your mind before ARCHIVE or BACKUP requests are processed).
  • RESTORE
    To request that an archived or backed up data set be brought back to disk.
  • REMOVE
    To cancel a RESTORE request.

We recommend that you place the CALL command shown above in your PROFILE to make these ABR commands available automatically each time you log on.

How to Use the RESTORE Macro

This macro is used to request that a data set be brought back to disk from an archive or backup tape. If a data set has been archived or backed up more than once, the most recent version is restored.

You are required to provide this information:

  1. The type of restore: from ARCHIVE or BACKUP
  2. The data set name
  3. The name of the disk the data set was on (ACA301, ACA302, etc.)

If you know this information, simply type RESTORE. If you're not sure, use either ARCLIST or BACKLIST to get it. Use ARCLIST if one of your data sets isn't on the disk where you put it; it was probably archived. Use BACKLIST if you accidently scratched or damaged one of your data sets; there may be a backup copy on the backup tapes. Once you have entered the required responses, you may skip the remaining optional responses by pressing the ESCAPE key.

After you respond to the prompts, the macro will display the job it has created and ask if you want to run the job or save it in a temporary working storage data set.

To run the job, type "R". The job will run FETCH so that you can view the results at the terminal. If you want a printed listing of the job, type: PRINT nnnn, where nnnn is the job number.

To place the job in a temporary data set, type a 1- to 8-character data set name. To run the job, you can then issue the command:

RUN T tempname

where "tempname" is the name you supplied for the temporary data set. You will then get a printed listing in your bin.

To restore other than the most recent version of a data set, you will need to answer some of the optional prompts using information obtained from ARCLIST or BACKLIST. Example:

  1. Run ARCLIST or BACKLIST, whichever is appropriate.
  2. When you get the results, run RESTORE. Type Y in response to the prompt, "Enter 'y' for instructions."
  3. Items 5, 6, and 7 explain how to get an old version of a data set that has been backed up more than once. This involves answering one or two prompts in addition to the required responses. Item 5 refers to the number of backups (not the number of days). A full backup runs every 7th day; on 5 other days a backup is only taken if your data set was modified. If you want to RESTORE from BACKUP giving a specific generation and cycle, you should press RETURN in response to the prompt about an older backup number and answer the next two prompts appropriately. If you are unable to determine which generation and cycle to use, call the Storage Librarian (815-753-0498) for assistance.

How to Use the ARCLIST and BACKLIST Macros

These macros are used to get lists of data sets stored on the archive and backup tapes for a given AccountID. These are two different sets of tapes.

All responses to the ARCLIST macro are optional. For a complete list of all your archived data sets, just press ENTER (or RETURN) in response to the prompts from the macro.

When using the BACKLIST macro, type responses to the prompts as shown below to get a complete list of all your data sets on the backup tapes. Next to each number is the prompt you will see. Below each prompt is the response you should give.

  1. Enter 'y' for instructions:

    Type y and press Enter

    You won't need to read the instructions every time, but you should read them the first time you use the BACKLIST macro so that you will be able to properly identify which backup version you wish to bring back using the RESTORE macro. If you don't wish to read the instructions, just press Enter.

  2. Press RETURN to list YOUR data sets, or enter a dataset name or group (optional):

    Press Enter (or Return)

  3. Enter the volume or group to be listed (optional):

    Type: ACA* and press Enter

  4. Enter 'CUR', 'ALL', or a number from 0 to 13 (optional):

    Type: ALL

  5. Enter 'Y' to list most recent backup for scratched datasets (optional):

    Type: Y

How to Specify the Data Set Name

Your AccountID will be added to the beginning of the name unless you put "&&&" at the beginning of the data set name. A group of data sets may be specified by appending an asterisk (*) to the data set name (this option is not available for RESTORE from backup). Here is a list of possible responses when prompted for a data set name:

Response                 Result
 DATA.SET                The data set yourAccountID.DATA.SET
                         will be restored.

 &&&AccountID.DATA.SET     The data set AccountID.DATA.SET will be
                         restored.

 DATA*                   All data sets beginning with
                         yourAccountID.DATA will be restored.

Batch Jobs

If you do not want to use the Superwylbur macros, you may want to create and run your own batch jobs. Here's the format of a job to get a list of archived data sets and a job for restoring data sets:

Format of an ARCLIST job:

//ARCL     JOB ,'your name'

/*JOBPARM      R=xxx

//S1    EXEC   ABRPRT

//SYSIN  DD    *

PRINT   ARCHIVE,DSG=AccountID.,VOLG=ACA

/*

//

This job will print a list of all the data sets archived from all the academic disks for the AccountID specified by DSG=.

Format of a BACKLIST job:

//BACL     JOB ,'your name'

/*JOBPARM      R=xxx

//S1    EXEC   ABRPRT

//SYSIN  DD    *

PRINT   VTOC,XREF,DSG=AccountID.,

        OLDBACKUP=ALL,

        FORMAT=CRT,

        VOLG=ACA

PRINT   SCRATCH,XREF,DSG=AccountID.,

        FORMAT=CRT,

        VOLG=ACA

/*

//

This job will print a list of all data sets on the backup tapes for the AccountID specified by DSG=.

Format of a RESTORE job:

//REST     JOB ,'your name'

/*JOBPARM      R=xxx

//S1    EXEC   ABRUT

//SYSIN  DD    *

RESTORE  type,DSN=AccountID.data.set.name,VOL=volume

/*

//

This job will restore the most recently archived or backed up copy of the specified data set. Just do the following:

  1. Replace "type" with either ARCHIVE or BACKUP;
  2. Replace "AccountID" with your AccountID and "data.set.name" with the full data set name;
  3. Replace "volume" with the volume the data set resided on just prior to the archive or backup (ACA301, ACA302, etc.).

ACF2 Rules

ACF2 rules are in effect for all ABR requests. If you are making requests for only your own data sets, you will not have to concern yourself with setting new ACF2 rules because, as usual, you have access to all data sets beginning with your own AccountID. However, if you need to make requests for another user's data sets, the data set owner must write some special access rules. See "Quick ACF2" for details on how to set up these rules.

We encourage you to become familiar with ABR. You will find that its archive system is almost like having your own tape; a complete listing of all your archived data sets is easily available, and data sets can be brought back to disk quickly. ABR's backup system provides an invaluable safety feature which may help you keep your sanity the next time you accidentally lose an important data set.