Incremental Backup Initiation via TSO/ISPF Interface
This section describes the step by step process of generating all the USTBATCH parameters for an Incremental backup request via the TSO/ISPF Interface. This method is more time consuming and involved than using the sample JCL and parameters outlined in the “Backup Initiation via MVS BATCH JOB” section above, however it allows for a greater level of customization to the backup request. Be aware that a large number of the parameters available on these menus do not apply to the Unix Systems Services environment and are present to support the FDR/UPSTREAM specification for the backup of non-USS systems.
In the sample menu walkthrough we will be constructing the JCL and parameters for an FDR/UPSTREAM USS Incremental backup of your complete USS ROOT file system and all of the subdirectories of ROOT. Please review this specification carefully to determine that this is what you want to do.
Step # 1 - Select USTBATCH - Host Initiated Services
To get started, enter the FDR/UPSTREAM TSO/ISPF Interface via your installation defined method. From the main menu specify option number 1, “USTBATCH”, and press ENTER.
Backup via ISPF - Selecting the USTBATCH Option
COMMAND ===> 1
1 USTBATCH - Host Initiated Services
2 STATUS - Current Status Information
3 DEFINE - Define Control Files
4 CONFIGURE - Main Options
5 PROFILE - Workstation Profile Names
6 OPER - Operator Commands
7 REPORT - Report
8 REGISTRY - Name Registry
9 DUPAUDIT - Duplicate File Audit
10 SCHEDULE - Command Scheduler
11 MANAGEMENT - Backup Management
12 FDRCRYPT - FDRCRYPT Options
Step # 2 - Specify USTBATCH Specific Parameters
The next menu to appear allows for the specification of the USTBATCH specific parameters required for the processing of the backup request. The menu items of the greatest interest are highlighted in the menu. A table follows the menu and briefly describes each highlighted menu field. Each value is discussed in greater detail in the “USTBATCH Parameter Reference”.
For the purposes of this walkthrough, if you have selected the default setting for these fields during FDR/UPSTREAM MVS installation, you will only need to specify the “TCP/IP addr” and “port” fields to specify the IP address and TCP Port Number of your z/OS system. If you do not know this value it can be located in the FDR/UPSTREAM MVS Started Task USTLOG output. Look for message number UST280 and the IP address will be located immediately after the “IPA=” field of this message.
Once you have completed entering all the fields of this menu, press the ENTER key to proceed to the next menu.
Incremental Backup via ISPF - Setting USTBATCH Options
COMMAND ===> SCROLL ===> PAGE
Gen - Generate statements Read/Save/Delete parameter set
More:
APPLPREF ==> UPSTR QUEUE ==> MAXRETRY ==>
USAPPL ==> UPSTREAM CONV ==> WAIT TMAXRETRY ==>
TPNAME ==> UPSTREAM WTOCOMP ==> YES APPLRETRY ==>
LOGMODE ==> #INTER RESTART ==> TASKLIM ==> ALLOWDUP ==>
TARGNAME ===> or TARGLU ===>
or DNSname ===>
or TCP/IP addr ===> 192.168.150.44 TCP/IP port ===> 2972
IPADAPTER addr ===>
. ERRWTO . WTOR=>
WSPARM ===>
USERID ===> | PASSWORD ===>
ACTION ===> 1 (specify to display related parameters and press enter)
1 - Backup 5 - Restart Backup 9 - FDRSOS Backup
2 - Restore & Inquiry 6 - Restart Restore 10 - FDRSOS Restore
3 - Run a PC Job 7 - Kill Restart Backup 11 - PC Migration
4 - File Transfer 8 - Kill Restart Restore 12 - Operator Commands
13 - Performance Tests
Client Login Name ===>
Client Password ===>
Menu Field | Description |
APPLPREF | The 5 character prefix of the VTAM APPLID to be used by USTBATCH for its communications with the FDR/UPSTREAM MVS Started Task. |
USAPPL | The VTAM APPLID of the FDR/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 FDR/UPSTREAM Started Task. |
CONV | Whether or not the USTBATCH requesting JOB should wait for the completion of the request submitted to the Started Task or end immediately after the request is accepted. |
WTOCOMP | Should a WTO Completion message be issued to the MVS system operator when this request finishes. |
TCP/IP ADDR | The IP address of the z/OS system running the USS files you wish to backup. |
PORT | The TCP port number configured in the FDR/UPSTREAM USS process or daemon that it will receive requests on. 2972 is the default for the USS process but not for USTBATCH so it must be specifically coded here. |
ACTION | Which function is to be performed by this set of generated statements. |
Step # 3 - Specify USS Files to be Processed
The next menu to appear is the first in a series of four menus that allow for the specification of the USS file system related parameters for this backup request. The table following the menu below describes each parameter that will be important for the request we are constructing. Please review this table, enter the appropriate values into the menu, and press the ENTER key to proceed to the next menu.
Incremental Backup via ISPF - Specifying Files to be Backed Up
COMMAND ===> SCROLL ===> CSR
Backup Parameters: --------Backup Type------- ----Storage Type---
Backup Profile.( TEST ) |( ) First-time full | |( X) Seq. Tape |
|( ) Full merge | |( ) Seq. Disk |
|( X ) Incremental Merge | |( ) Archive |
|( ) Non-merge | |( ) Keyed/Dup. |
( ) NetWare Directory Svcs -------------------------- -------------------
Spec
Files Selected for Backup Detail
------------------------------------------------ ------
| /*____________________________________________ ( X )|
| ______________________________________________ ( )|
| ______________________________________________ ( )|
| ______________________________________________ ( )|
| ______________________________________________ ( )|
| ______________________________________________ ( )|
| ______________________________________________ ( )|
-------------------------------------------------------
( ) StreetTalk name
OK <enter> ( ) More... Prior panel <PF3>
Menu Field | Description |
Backup Profile | Specifies the Backup Profile Name to be used for this backup request |
Backup Type | An Incremental type Backup is requested to backup just the files that have changed since the last backup request for this Backup Profile. |
Storage Type | This backup will go directly to an MVS sequential dataset on tape. |
Files Selected for Backup | The USS file specification for the directory to begin backing up from. In this case we will be starting with the ROOT of the file system. |
Spec Detail | This indicates that we wish to display the “Spec Detail” menu options screen next so that we can specify additional information about our “/*” files specification. |
Step # 5 - Generate the USTBATCH Control Cards
You have now completed the specification of the FDR/UPSTREAM USS parameters that will be required to perform a backup. The next step is to initiate the generation of the z/OS JCL to be used to invoke the USTBATCH utility program which submits your backup request to the FDR/UPSTREAM MVS Started Task for processing. You do this by specifying “GEN” on the “COMMAND” line of the ISPF panel below and pressing the ENTER key.
Incremental Backup via ISPF - Generating the USTBATCH Control Cards
COMMAND ===> GEN SCROLL ===> PAGE
Gen - Generate statements Read/Save/Delete parameter set
More:
APPLPREF ==> UPSTR QUEUE ==> MAXRETRY ==>
USAPPL ==> UPSTREAM CONV ==> WAIT TMAXRETRY ==>
TPNAME ==> UPSTREAM WTOCOMP ==> YES APPLRETRY ==>
LOGMODE ==> #INTER RESTART ==> TASKLIM ==> ALLOWDUP ==>
TARGNAME ===> or TARGLU ===>
or DNSname ===>
or TCP/IP addr ===> 192.168.150.44 TCP/IP port ===> 2972
IPADAPTER addr ===>
. ERRWTO . WTOR=>
WSPARM ===>
USERID ===> | PASSWORD ===>
ACTION ===> 1 (specify to display related parameters and press enter)
1 - Backup 5 - Restart Backup 9 - FDRSOS Backup
2 - Restore & Inquiry 6 - Restart Restore 10 - FDRSOS Restore
3 - Run a PC Job 7 - Kill Restart Backup 11 - PC Migration
4 - File Transfer 8 - Kill Restart Restore 12 - Operator Commands
13 - Performance Tests
Client Login Name ===>
Client Password ===>
Step # 6 - Specifying the JCL for USTBATCH
The panel below allows for the entry of installation specific JCL statements and options that may be required for proper execution the USTBATCH JOB. At a minimum you should alter the JCL to provide:
- A Valid, Installation Specific z/OS JOBCARD
- A Proper STEPLIB DD Specification for the UPSTREAM/MVS Load Library
Selecting option # 2 on the command line and then pressing the ENTER key will allow you to review via the ISPF EDIT command the generated UPSTREAM/MVS USTBATCH JCL and parameters.
Incremental Backup via ISPF - Altering the USTBATCH JCL
COMMAND ===> 2
Please select one of the following options or press the END key to cancel
1 - Browse the generated JCL stream
2 - Edit the generated JCL stream
3 - Submit the generated JCL stream
4 - Save the generated JCL in a data set
5 - Run the generated USTBATCH statements in the TSO foreground
JCL statements:
( //jobname JOB (job acct data),'job id data',NOTIFY=userid )
( //* )
( //* )
( //* )
( //USTBATCH EXEC PGM=USTBATCH )
( //STEPLIB DD DISP=SHR,DSN=your.upstream.load.library )
( //SYSUDUMP DD SYSOUT=* )
( //USTLOG DD SYSOUT=*
Menu Field | Description |
COMMAND | Select “2” in order to edit the generated USTBATCH JCL and parameters. |
JOB Card Information | This field must specify a valid z/OS JOB Card in order for the JCL generation to work properly. Please specify all applicable information that is applicable to your installation standards. |
STEPLIB DD DSN | This field is the dataset name of the FDR/UPSTREAM MVS LOADLIB. This library must have been previously APF authorized. This DD statement is not required if the LOADLIB has been placed in the z/OS LINKLST concatenation. |
Step # 7 - Edit and Submit the Generated USTBATCH JCL
The following panel shows the generated JCL and USTBATCH control cards. It is suggested that they be reviewed, saved to a member of PDS in case a rerun is necessary, and then subsequently submitted for z/OS BATCH processing.
--------------------------------------------------------------------------------
EDIT------ USER01.SPFTEMP2.CNTL--------------------------- Columns 00001 00072
Command ===> Scroll ===> CSR
****** ***************************** 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.load.library
000007 //SYSUDUMP DD SYSOUT=*
000008 //USTLOG DD SYSOUT=*
000009 //*
000010 //USTPARM DD *
000011 APPLPREF=UPSTR
000012 USAPPL=UPSTREAM
000013 LOGMODE=#INTER
000014 *
000015 TCPTARG=192.168.75.45
000016 ACTION 1
000017 BACKUPPROFILE TEST
. . . . .
. . . . .
000064 *
000065 ENDPARM
/*
//
This completes the steps necessary to construct and submit an z/OS BATCH initiated incremental backup operation. The executing backup request can be monitored via the UPSTREAM/MVS ISPF STATUS panel (Option #2), the UPSTREAM/MVS STATUS operator command, or the FDR/UPSTREAM Director interface.