Performing a Backup
Overview
UPSTREAM backups can be initiated from several locations in your enterprise, including:
- From the UPSTREAM Client, using the Client GUI panels.
- From any workstation/server with the Java-based Director interface.
- From your z/OS mainframe using the USTBATCH utility.
The first two options are described in the UPSTREAM Client Guide. The third option (initiation via USTBATCH) is described in this chapter.
Before You Begin
Before you can initiate a backup with UPSTREAM, there are two issues that you must first review.
Create A Backup Profile (Mandatory)
You will need to create a backup profile for the entity (e.g., server, drive, application) that you wish to backup. See Section “Backup Profiles” for full details on creating UPSTREAM backup profiles.
Define Backup GDG Bases (Optional)
If your UPSTREAM backup data sets are going to be GDGs (i.e., you have either TAPEGDG=YES or DASDGDG=YES in your backup profile), then you will also need to build GDG base definitions for those backup files. The following sample JCL illustrates how to construct these definitions. See UPSTREAM Profiles for a full discussion on the TAPEGDG= and DASDGDG= backup profile parameters.
//* DEFINE GDG BASE TO USE WITH UPSTREAM
//*
//DEFINE EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE GDG (NAME(UPSTREAM.TEST.COPY1) LIMIT(20) SCRATCH)
DEFINE GDG (NAME(UPSTREAM.TEST.COPY2) LIMIT(20) SCRATCH)
/*
7.3 Building the USTBATCH Job
This section shows how to use the UPSTREAM TSO/ISPF dialogs to build a USTBATCH batch job to run a backup. USTBATCH JCL can also be constructed manually (although this is not recommended) as described in z/OS Initiation with USTBATCH.
Step #1 - Select USTBATCH - UPSTREAM z/OS Storage Server Initiated Services
Enter the UPSTREAM TSO/ISPF dialog via your installation defined method (see Make the UPSTREAM ISPF Dialogs Easily Available). From the main menu, specify option number 1, “USTBATCH”, and press ENTER.
~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~- UPSTREAM ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~- COMMAND ===> (% class="Red" %)1(%%) V 03.09.04 \\ **1** **USTBATCH** **- Host Initiated Services ** **2** (% class="Red" %)STATUS(%%) - Current Status Information **3** (% class="Red" %)DEFINE(%%) - Define Control Files **4** (% class="Red" %)CONFIGURE(%%) - Main Options **5** (% class="Red" %)PROFILE(%%) - Client Profile Names **6** (% class="Red" %)OPER(%%) - Operator Commands **7** (% class="Red" %)REPORT(%%) - Report **8** (% class="Red" %)REGISTRY(%%) - Name Registry **10** (% class="Red" %)SCHEDULE(%%) - Command Scheduler **11** (% class="Red" %)MANAGEMENT(%%) - Backup Management **12** (% class="Red" style="font-weight: Bold;" %)USTCRYPT(%%) - USTCRYPT Options \\ 11 Active Jobs: \\Sel Jobname System #ACT TCP/IP Address PORT VTAM APL ~-~-- ~-~-~-~-~-~-~-~- ~-~-~-~-~-~-~-~- ~-~-~-~- ~-~-~-~-~-~-~-~-~-~-~-~-~-~-- ~-~-~-~- ~-~-~-~-~-~-~-~- S USTPRODA CPUA 1 192.168.0.1 2001 USTSAAPL USTPRODP CPUA VERSION < 03.09.04 UI CPUB 192.168.0.2 1972 NONE USTEURO CPUE INACTIVE\\ |
Step #2 - USTBATCH Specification
The next menu to appear allows for the specification of the USTBATCH parameters required for the backup request. The parameters of most interest have a value specified, and a description follows on the next page.
USTBATCH Specification
-------------------------- FDR/UPSTREAM - USTBATCH ------- * ------------------ COMMAND ===> 1 SCROLL ===> CSR Gen - Generate statements Read/Save/Delete parameter set 1 - Backup 6 - Restart Restore 2 - Restore & Inquiry 7 - Kill Restart Backup 3 - Run a PC Job 8 - Kill Restart Restore 4 - File Transfer 12 - Operator Commands 5 - Restart Backup 13 - Performance Tests Communication parameters between USTBATCH and the UPSTREAM Storage Server HOSTIP ===> HOSTPORT ===> 2003 HOSTDNS ===> YOUR.LPAR.DNS.NAME APPLPREF ===> QUEUE ===> MAXRETRY ===> USAPPL ===> CONV ===> TMAXRETRY ===> TPNAME ===> WTOCOMP ===> APPLRETRY ===> LOGMODE ===> RESTART ===> TASKLIM ===> Communication parameters between UPSTREAM Storage Server & Client Target System TARGNAME ===> SERVER_REG_NAME or DNSname ===> or TCP/IP addr ===> TCP/IP port ===> IPADAPTER addr ===> . ERRWTO . WTOR=> Remote Parameter File: WSPARM ===> USERID ===> | PASSWORD ===> MIXED ===> NO Login Parameters: Client Login Name ===> Client Password ===> |
USTBATCH Parameters
Supply values to the fields you wish to change and then press the ENTER key to proceed to the next menu. The parameters specified in the panel above are explained here. For a full description of all parameters, see z/OS Initiation with USTBATCH. Beginning with UPSTREAM z/OS 3.9.1, the UPSTREAM started task and USTBATCH may now use TCP/IP to initiate requests. The SNA parameters described further below are no longer required but may still be used. They are required for users of UPSTREAM z/OS 3.9.0 and earlier and are listed here for their reference.
USTBATCH to Started Task TCP/IP Parameters (Preferred):
HOSTDNS
The DNS name of the LPAR hosting your UPSTREAM started task. Mutually exclusive with the HOSTIP parameter.
HOSTIP
The IP address of the TCP/IP stack on the LPAR hosting your UPSTREAM started task. Mutually exclusive with the HOSTDNS parameter.
HOSTPORT
The IP port number of the UPSTREAM started task. If omitted, the default is 1972. This parameter may be used with either the HOSTDNS or HOSTIP parameters.
USTBATCH to Started Task VTAM SNA Parameters (UPSTREAM version 3.9.0 and prior):
APPLPREF
The 5-character prefix of the VTAM APPLID to be used by USTBATCH for its communications with the UPSTREAM started task.
USAPPL
The VTAM APPLID of the UPSTREAM started task.
TPNAME
The Transaction Program Name to be used during LU 6.2 communications.
LOGMODE
The VTAM LOGMODE to be used for communicating with the UPSTREAM started task.
Additional Parameters. (These parameters are used with any version of UPSTREAM and may be used with either TCP/IP or SNA USTBATCH to Started Task communication.):
CONV
This controls whether or not the USTBATCH job should wait for the completion of the request submitted to the started task, or end immediately after the request is accepted.
WTOCOMP
Allows a WTO completion message to be issued to the z/OS system operator when the request finishes.
Started Task to Client Target System Parameters:
TCP/IP ADDR
The IP address of the Client that you wish to backup. Note that this parameter is mutually exclusive with the TARGNAME, DSNAME, and TARGLU keywords.
TCP/IP PORT
The TCP port number configured in the Client that you wish to backup (see the UPSTREAM Client Guide for more details).
ACTION
Controls which UPSTREAM function is to be performed by this set of generated statements. In our preceding example, ACTION=1 specifies a backup request.
Step #3 - Backup Specification #1 (Main Parameters)
The next menu to appear is the first in a series of up to four menus that describe the actual backup process itself. The relevant parameters are described after each menu. For a full description of all parameters, see Chapter 20 “UPSTREAM Configurator”.
In this first menu, we are specifying:
- The backup profile name (TEST)
- The backup type (First-time full)
- The backup media (Sequential tape)
- The files to be backed up (All files on the workstation/server)
---------------------------- UPSTREAM - USTBATCH Backup ------------------ |
Backup Profile
Specifies the backup profile name used for this backup request. See UPSTREAM Profiles for a full description of UPSTREAM backup profiles.
Backup Type
Specifies the type of UPSTREAM backup that we are going to perform. See System Overview for a description of UPSTREAM backup types.
Storage Type
Specifies the z/OS storage media to which the backup is written.
Files Selected for Backup
In this section you specify one or more file specifications or “file specs” (System Overview) to select the drives/folders/files that are included in this backup.
Step #4 - Backup Specification #2 (File Spec - Details)
On the previous menu you notice that an “X” is in the Spec Detail column of the file specification. This indicates that we wish to display the “File Spec Detail” menu (shown below) so that we can specify additional information about our “/*” file spec.
-------------------------- FDR/UPSTREAM - USTBATCH Backup File Spec ----------- COMMAND ===> SCROLL ===> CSR File Spec... //. -----------------------------------Spec Type----------------------------------- | | |( X ) Include these files ( ) Exclude | ------------------------------------------------------------------------------- -------------------------- ------------------------ | Include | | Exclude | |< X > Reset Archive Bit | |( ) Exclude Subdirs | |< > Incremental | ------------------------ |< > Modify date | | < > Before | | Date ( ) | |< > Accessed before.. | | Days old ( 180 )| |< X > Backup Subdirs | | < > Mount Points| | < > Include NFS | | < > Single FS | |< X > Hidden Files | -------------------------- OK <enter> ( ) Chg All ( ) More... Prior panel <PF3> |
Spec Type
This controls the nature of this file specification. “Include” includes the selected files in the backup, while “Exclude” excludes them from the backup. The two options are mutually exclusive.
Reset Archive Bit
This causes the archive bit to be reset for each file backed up, allowing the incremental backup process to function on subsequent (incremental) backups.
Backup Subdirs
Indicates that the backup includes all subdirectories and files found under the file specification.
Hidden Files
All files on the Client that are marked as “hidden” or “read-only” are selected by this backup request.
More…
This takes you to the third of the four menus.
Step #5 - Backup Specification #3 (File Spec - Non File Data)
This menu controls the handling of any non-file data included in the file specification. See the UPSTREAM Client Guide for full details of this menu.
-------------------------- FDR/UPSTREAM - USTBATCH More File Spec ------------- COMMAND ===> SCROLL ===> CSR ---Non File Data-------------------------------------------------------------- |< X > Registry and Event Logs | |< X > File Extended Attributes | |< X > Directory Extended Attributes | |< > File and Directory ACLs (Security) | |< > Reset Last Access Date | |< > Add Permissions If Access Denied | |< > Hard Links...< X > Use Client Default | ------------------------------------------------------------------------------ ---PlugIn--------------------------------------------------------------------- | File Name ( ) | | Parameters( ) | ------------------------------------------------------------------------------ ---Mount Point Options (Restore only)----------------------------------------- |( X ) Do not restore | |( ) Verify before restoring | |( ) Recreate if necessary | |( ) Restore without verification | ------------------------------------------------------------------------------ ---Restore Options------------------------------------------------------------ |< > Restore Migrated Files | | < > Only | ------------------------------------------------------------------------------ ---Restore File Overwrites---------------------------------------------------- |( X ) Restore all files (overwrite) | |( ) Do not overwrite existing files | |( ) Do not overwrite the same files | ------------------------------------------------------------------------------ ---Reparse Point Options (Backup only)---------------------------------------- |( X ) Skip files with Reparse Points | |( ) Open files without using Reparse Points | |( ) Open files using Reparse Points | | < > Recall offline files to disk | ------------------------------------------------------------------------------ ---UNIX Restore Options------------------------------------------------------- |( ) Use UID instead of name | |( ) Use GID instead of name | ------------------------------------------------------------------------------ OK <enter> ( ) Chg All Prior panel <PF3> |
Step #6 - Backup Specification #4 (Misc.)
Pressing ENTER and then PF3 from the previous menu will then take you to the fourth and final backup specification menu, shown below. This menu contains additional parameters that control the overall backup.
-------------------------- FDR/UPSTREAM - USTBATCH More... -------------------- COMMAND ===> SCROLL ===> CSR ---------Compression-------------- ----------Restart Bkup/Restore--------------- |( )No Compression | |( )Never | |( X )Fast Compression | |( x )On Any Error | |( )High Compression 1 | |( )Not Completed | |( )High Compression 2 | | | |( )High Compression 3 | | | |( )zEDC Compression | | | --------------------------------- -------------------------------------------- ---------Miscellaneous------------ -------------Reporting----------------------- |Exclude File... | |( ) Files Backed Up/Restored | ( ) |( ) Files Skipped | | | |( ) Files Deleted/Migrated | | | |( ) Version Inquiries | | | |( ) File Inquiries | | | |Max Report Days...( 0 ) | |DASD Override..( 100% ) | |Report File Name.. | |Max Log Days...( 0 ) | ( UPSTREAM.RPT ) | | --------------------------------------------- |( ) Attended | ------------Local Backup--------------------- |( x ) Log Non-Fatal Messages | |( X ) No Local Backup | | ( ) Skipped files only | | | |( ) Send msg details to host | |( ) PC Disk Local Backup | |( ) Host Sort | |Number of local backups...( 3 ) | |( ) Set archive bit on restore| |Maxsize.( 100000000 ) Maxfile( 10000000 ) | | |Directory.( ) |( ) Full Merge Backup Verify | |( ) FDRSOS Physical Disk Local Backup | |( ) Local Incremental Database| |Disk Name.( ) | | | ( ) UPSTREAM/SOS Restore | ---------------------------------- --------------------------------------------- --Jobs-------------------------------------------------------------------------- | Preprocess.... ( ) | Postprocess... ( ) | Process failed ( ) -------------------------------------------------------------------------------- --Translation------------------------------------------------------------------- | ASCII to EBCDIC ( USATOE.TAB ) | EBCDIC to ASCII ( USETOA.TAB ) -------------------------------------------------------------------------------- OK <enter> Prior panel <PF3> |
Compression
Selects the level of compression to be performed on the backup data by the Client, before that data is transmitted to the z/OS Storage Server.
Restart Bkup/Restore
The backup re-starts if any error occurs during the process.
Log Non-Fatal Messages
All messages that are issued by the UPSTREAM are recorded in the started task USTLOG.
Step #7 - Generate the USTBATCH JCL
Having worked through the four backup specification menus, press the PF3 key twice to return to the USTBATCH specification menu, previously seen in Step #2 - USTBATCH Specification. We can now generate the z/OS JCL that is used to invoke the USTBATCH utility program, which submits your backup request to the UPSTREAM started task for processing.
You do this by specifying “GEN” on the command line and pressing the ENTER key.
-------------------------- FDR/UPSTREAM - USTBATCH ------- * ------------------ |
Step #8 - Adding a JOBCARD and STEPLIB
The panel below then allows you to tailor the USTBATCH JCL to match your installation's requirements. As a minimum, you should alter the JCL to provide a valid mainframe JOBCARD. You will also need to include a STEPLIB to point to the UPSTREAM load library if it is not in the Linklist. If you use the DNSNAME option to address the Client, you may also need a SYSTCPD DD statement.
-------------------------- UPSTREAM - USTBATCH ------------------------- |
Step #9 - Editing the USTBATCH Job
Select Option 2 “Edit” on the command line of the preceding menu (then press ENTER) to review and optionally edit the generated USTBATCH JCL and parameters via a standard ISPF Edit screen.
Figure 7.9:
EDIT------ CRL2.ISP08494.SPFTEMP1.CNTL-------------------------- Command ===> ****** ********************************* Top of Data *********** 000001 //jobname JOB (job acct data),'job id data',NOTIFY=userid 000002 //* 000003 //* 000004 //* 000005 //USTBATCH EXEC PGM=USTBATCH 000006 //STEPLIB DD DISP=SHR,DSN=your.upstream.loadlib 000007 //SYSUDUMP DD SYSOUT=* 000008 //USTLOG DD SYSOUT=* 000009 //* 000010 //USTPARM DD * 000011 HOSTDNS=YOUR.LPAR.DNS.NAME 000012 HOSTPORT=1972 *DEFAULT 000013 * 000014 TARGNAME=SERVER_REG_NAME 000015 BACKUPPROFILE TEST 000016 INQOPTIONS 2 000017 MERGE 3 000018 STORAGETYPE 3 * SEQ. TAPE 000019 LOGNONFATAL 2 000020 SENDHOSTDETAILS Y 000021 * 000022 SPEC \\. 000023 SPECTYPE 0 * INCLUDE 000024 ENDPARM * |
Step #10 - Submitting and Monitoring the USTBATCH Job
The USTBATCH job can then be submitted for batch processing, either immediately, or it can be saved to a member in a PDS for later submission (manually, or through a job scheduling system).
Once it has been initiated, the executing backup request can then be monitored via the UPSTREAM ISPF STATUS panel (Option #2), or via the UPSTREAM STATUS operator command (UPSTREAM Operation).
7.4 What’s Next?#
Having created your backup, you may wish to take a look at some of the following features in UPSTREAM.
- Performing a Restore - Performing a Restore describes how to restore some/all the files from your test backup.
- Copying your backups - Copying Backups with USTVAULT shows you how to make additional tape-based copies of your backups.
- Moving your backups to tape - Migrating Backups from Disk to Tape shows you how to move disk-based backups to tape.
- Deferred merge - Completing Deferred Merge Backups describes the deferred merge process.
- Reporting on your backups - Reporting with USTRPORT and Reporting with USTBKPRT describe various ways to report on your backup, either by extracting information about the backup from the UPSTREAM repository, or by obtaining detailed information directly from the backup itself.
- Data Encryption - UPSTREAM Data Encryption describes UPSTREAM's data encryption feature, which allows you to create encrypted copies of some/all your backups when copying those backups with USTVAULT.