UPSTREAM Profiles

What are UPSTREAM Profiles?

A profile is a set of customized options that are used to control various aspects of UPSTREAM operations, from the primary functions of backup and restore, ancillary functions of file transfer and running a Client process, through to the system utility functions like the re-organization of the UPSTREAM repository data sets (USTREORG). Profiles are also used to control the backup management utility operations, such as vaulting (USTVAULT), backup migration (USTMIGRT), and deferred merge (USTMERGE).

Creating and Viewing UPSTREAM Profiles

Profiles are created and stored in the UPSTREAM configuration data set (see UPSTREAM Configurator), alongside the main configuration parameters. Profiles are usually maintained by the UPSTREAM Administrator through the TSO/ISPF dialogs, although they can also be maintained via the Client interface (see the UPSTREAM Client guide).

From the main TSO/ISPF menu specify option number 5, “PROFILE”, and press ENTER.

The next menu to appear requires you to specify the input and output data set and member names for the UPSTREAM configuration data set.

• The input data set and member name specified must previously exist.
  
• The output data set must also previously exist, but the member will be created if it does not already exist.
  

It is recommended that you “update in place” by specifying the input and output data set and member name as the same. As these names are included in the UPSTREAM startup PROC (see Define the UPSTREAM Started Task PROC), retaining the same names makes configuration management much easier.

When you have completed entering all the fields on this menu press the ENTER key.

Configure Profiles

You can also specify a profile name or profile mask on the preceding menu to limit the list of profiles contained within the configuration that will be displayed on the subsequent menu.

A profile mask can be zero to seven initial characters, followed by the asterisk “*”.

As an example, entering UST* would limit the subsequent list of profiles to just the ones starting with the three characters “UST”.

In the subsequent menu shown below, we can see various “UST” profiles from within the configuration. These “UST” profiles are examples of the reserved profiles that control the behavior of various system utility functions within UPSTREAM, as explained later in this chapter.

Configure Profiles

ADD

Use this option to add an entirely new profile, either from scratch, or by using an existing profile as a template.

• To add a new profile from scratch, type “ADD” on the command line and press ENTER.
  

  Important

  You can also type “ADD profilename”. This is particularly useful when adding some of the special profiles described later in this chapter. For example, typing ADD USTVLT01 would bring up a menu with far fewer options to fill-in than “ADD XYZ”, which would bring up the full backup profile menu.

• To add a new profile utilizing an existing profile as a template, type “ADD” in the command column adjacent to the profile you wish to utilize as the template.
  

The following letters may also be entered in the command column adjacent to a profile entry to cause the following actions:

• Enter “S” or “E” to SELECT or EDIT an existing profile entry (they are equivalent).
  
• Enter “D” to DELETE a profile entry from the list. You will be asked to confirm the deletion.
  
• Enter “B” to BROWSE a profile entry. You will not be able to make any changes to the values displayed while in browse mode.
  

COMPRESS

This allows you to run the IEBCOPY utility program in the TSO foreground to compress the previously specified output configuration data set. This is useful if you are attempting to update a configuration data set member but the PDS data set has filled up.

L

This is a debugging feature that displays the USTLOG output from the USTCONFG configuration program (see UPSTREAM Configurator). It may be utilized to get additional problem determination information about errors encountered in updating the configuration data set.

The following menu shows the individual options that can be set within a profile. As described in the sections below, these options have different characteristics depending on which type of profile is being created. Subsequent sub-sections, below, describe only the parameters that refer to the specific type of profile being created.

A reference table describing all the parameters can be found in DEFINE, MODIFY, and COPY Statements.

Configure Profile

The remainder of this section describes the various types of profiles that can be found in the UPSTREAM configuration data set, as follows:

The GLOBAL Profile

Backup Profiles

Utility Profiles (USTVLTxx, USTMIGxx, USTMERxx)

UPSTREAM Repository Re-organization Profiles

File Transfer Profiles

The GLOBAL Profile

Your UPSTREAM configuration must contain a profile with a name of GLOBAL. The installation process, described in Installation and Configuration, automatically creates a GLOBAL profile for you.

The GLOBAL profile operates as a default profile and specifies options to be used for any profile name that is specified in a UPSTREAM function requested by a user, but which is not explicitly defined in the configuration.

The GLOBAL profile allows requests to use any profile name (except where limited by security - see Security) even if that profile is not included in the configuration.

For this reason, we recommend the following:

• Do not use the GLOBAL profile for your general UPSTREAM functions, such as backup and restore. Make sure that these functions are controlled by user-defined specific or generic backup profiles in the configuration, as described later in this chapter.
  
• Do not alter the defaults of DASD=NO and TAPE=NO for the GLOBAL profile. These defaults intentionally disable backup and restore operations for this profile.
  
• Do not delete the GLOBAL profile, as it is utilized by some internal UPSTREAM functions.
  

Backup Profiles

UPSTREAM backup profiles control the behavior of backup and restore operations. Each “entity” to be backed up by UPSTREAM (e.g., an application, a drive, or perhaps even a whole server) will have a backup profile associated with it.

The menu below displays the option settings for a backup profile called TEST. See DEFINE, MODIFY, and COPY Statements for a full description of the options specified.

• The backup media to be used
  
• The data set names that will be allocated to contain the backup data
  
• The retention and expiration of the backups
  
• Tape handling issues
  

Our example TEST profile on the previous page has the following important attributes:

• It allows backups to DASD and TAPE
  
• It utilizes z/OS GDGs to store the data and provide for retention control
  
• It allows the use of merge backups
  
• It allows the use of vaulting with USTVAULT
  
• It allows USTVAULT to create AES-encrypted copies of the backups
  

Having entered all the options into the menu, type “SAVE” on the command line and press the ENTER key to save your changes.

The menu below reappears and contains your newly defined profile in the list of system profiles.

Backup Profile Options

This chapter describes the options that were set in our sample TEST backup profile. See DEFINE, MODIFY, and COPY Statements for a full lit of all the parameters that can be specified in an UPSTREAM profile.

PROFILE=

cccccccc

Specifies the backup profile name. It may be 1-8 characters, and it must start with an alphabetic or national character (the remainder may be any alpha, numeric, or national characters). Every entity to be backed up by UPSTREAM (e.g., be it a server, an application, a drive) should have a unique backup profile name associated with its backups. All backups and restores taken for that entity are associated with that unique profile name.

PREFIX=

ccccccc

Indicates that the backup profile name is a “prefix” (max. 7 characters), rather than a fully qualified name. When this option is in effect, the parameters specified for this backup profile will be used when the exact profile name specified in the backup request does not exist in the configuration, but it does match all the characters specified.

For example, a “prefix” backup profile called “TES” could be used to control UPSTREAM backup requests that use profiles of TEST, TEST21, TESTER, etc. This effectively allows you to manage numerous unique backup profile names with just one overall controlling backup profile in the configuration. This feature is useful if a large number of profiles have similar prefix naming and can utilize similar profile attributes.

This option may also be used for Oracle and DB2 multi-channel database backups. If the backup profile is defined as a prefix, the channel number of that portion of the multi-channel backup is appended to the profile prefix name in the backup data set name. This feature, in addition to the backup date and time, creates a unique backup data set name. If the data set is a GDG, either the profile prefix name must be specified as the last qualifier of the GDG base data set name or the “%PROFILE” profile name substitution parameter must be used as a qualifier in the GDG base data set name. When creating the GDG base, define a base name for each profile_prefix_channel_number combination for all channels that may be used when the backup is run. For example, using the example above, data set names might be:

HLQ.DB2.DATA.TES1.G0123V00

and

HLQ.DB2.DATA.TES2.G0123V00

where “TES” is the profile prefix name and channels 1 and 2 are used in the backup.

See also WSPREF=.

TAPE=

cccccccc

Specifies that this backup profile will allow backups directly to z/OS sequential tape. When enabled for a given profile, the TAPEPREF and the TUNIT or TAPESTORCLAS options must also be enabled. This is equivalent to the TAPECOMP operands on a USTCONFG DEFINE, MODIFY, or COPY statement (see DEFINE, MODIFY, and COPY Statements).

IDRC

This option only applies to 3480/3490 cartridge drives and causes UPSTREAM to specify the TRTCH=COMP parameter when dynamically allocating the tape backup to request hardware (IDRC) compaction of the tape data set. IDRC compaction may be used even if compaction is your system default.

TAPEGDG=#

Applies to profiles where TAPE=YES has been specified. It allows a tape backup data set to be allocated as a new generation of a GDG. YES is recommended, since GDG processing will automatically delete old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required backups.

YES

Use GDG for sequential tape backups.

NO

Use non-GDG for sequential tape backups.

TAPEPREF=#

prefix

Applies to profiles where TAPE=YES has been specified. It specifies the high level qualifiers of the data set name to be used for sequential tape backups. See Section “DEFINE, MODIFY, and COPY Statements” for a full description of the naming standards used for the “TAPEPREF=” in Section parameter.

TUNIT=

tapeunit

Applies to profiles where TAPE=YES has been specified. Specifies an z/OS tape unit name for use in allocating the backup data set.

EXPDT=

yyddd

Specifies the Julian format expiration date of the data sets created when using this profile. The meaning of this value is identical to the JCL parameter EXPDT. EXPDT only accepts a 2-digit year number. Year values less than 70 are assumed to be in the 21st century (20xx). This parameter is mutually exclusive with RETPD. In our TEST example we specified “99000” to indicate catalog retention control by the tape management system.

See DEFINE, MODIFY, and COPY Statements for full usage notes on the EXPDT=, RETPD=, and DREPTD= operands.

NEWTAPEF=

Applies to profiles where TAPE=YES has been specified. Specifies if a new z/OS data set should be created on a new tape volume when processing full merge backups. See UPSTREAM Backups to z/OS Tape and DASD for a description of these backup types.

YES - Mount new tape for full merge backup.

NO - Append the full merge backup to the prior tape.

Default: NO.

NEWTAPEI=

Applies to profiles where TAPE=YES has been specified. Specifies if a new z/OS data set should be created on a new tape volume when processing incremental merge backups.

YES - Mount new tape for incremental merge backup.

NO - Append the incremental merge backup to the prior tape.

Default: NO

DASD=

Specifies whether this backup profile will allow backups directly to z/OS sequential disk. When enabled for a given profile, the DASDPREF and one of the DUNIT, VOL, or STORCLAS options must also be specified.

YES - Allow sequential disk backups.

NO - Backups to disk are disallowed.

Default: NO.

DASDBLK=

nnnnn

Applies to profiles where DASD=YES has been specified. Specifies the blocksize to be used when allocating those backups. It is not used as the actual blocksize of the backup data set, but it is used in performing space allocation calculations. In our TEST example we left this field blank to allow the system to use the value specified in the matching (system wide) DASDBLK main configuration parameter. (See Configure the MAIN Options).

DASDGDG=#

Applies to profiles where DASD=YES has been specified. It allows a DASD backup data set to be allocated as a new generation of a GDG. YES is recommended, since GDG processing will automatically delete old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required backups.

YES - Use GDG for sequential disk backups.

NO - Do not use GDG data sets for sequential disk backups.

DASDPREF=#

prefix

Applies to profiles where DASD=YES has been specified. It specifies the high level qualifiers of the data set name to be used for sequential DASD backups. See Section “DEFINE, MODIFY, and COPY Statements” for a full description of the naming standards used for the DASDPREF= parameter.

DUNIT=

diskunit

Applies to profiles where DASD=YES has been specified. Specifies an z/OS DASD unit name for the backup data sets to be dynamically allocated on. Either DUNIT, VOL, or STORCLAS is required when the DASD=YES option is enabled. DUNIT and VOL cannot both be specified on the same profile.

MAXSIZE=

nnnnnn

Applies only to profiles with the DASD option set. Specifies a maximum size in kilobytes (units of 1024 bytes) for INCREMENTAL MERGE sequential disk backups. For incremental backups to DASD, if the estimated size of the backup exceeds this value, the backup will be redirected to sequential tape. If MAXSIZE is specified, the profile must be enabled for sequential tape backups (TAPE) as well as sequential disk backups (DASD). However, the DASDPREF value (not TAPEPREF) will be used to name the backup. MAXSIZE=0 indicates never to redirect incremental merge DASD backups to tape.

Default: 0.

MERGE=#

This controls the utilization of the UPSTREAM merge backup and “deferred merge” processes. See Merge Backups for a full description.

YES - specifies that this profile is enabled for merge backup processing. The profile must also be enabled for DASD (sequential disk) or TAPE (sequential tape) backups.

NO - indicates that this profile can not be used for MERGE processing.

DEFER - enables the profile for merge backup processing, but indicates that those backups will be performed with the “deferred merge” (USTMERGE) processing option. (See Completing Deferred Merge Backups).

Default: YES.

COPYINCR=

Applies to profiles where MERGE=YES has been specified. This option determines whether a full merge backup copies all incremental backups that are stored in separate locations to the full backup data set. Incremental backups that are already on the same tape as the full backup are not copied, but incremental backups that are on different tapes, or on DASD, are copied. Incremental backups that are successfully copied will be deleted and uncataloged. All UPSTREAM database records regarding the location of the moved backups are updated to point to the new full backup data set.

YES - Copy incremental backups to full merge.

NO - Do not copy incremental backups to full merge.

Default: NO.

MIGTHRESH=#

nn

Specifies a threshold for the migration of disk-based backups to tape with the USTMIGRT utility. (See Migrating Backups from Disk to Tape). When USTMIGRT is run, it looks for sequential disk backups recorded under each backup profile name. If the number of such backups equals or exceeds the MIGTHRESH=nn value, USTMIGRT migrates the least recent backups to tape until the remaining number is nn-1. MIGTHRESH=0 disables USTMIGRT migration for a backup profile. MIGTHRESH=255 does not migrate incremental backups made after the most recent full backup.

Default: 0.

VAULT=

Specifies whether this backup profile is enabled for the USTVAULT vaulting facility. (See Copying Backups with USTVAULT). If this option is enabled, special data set naming requirements take effect for TAPEPREF and DASDPREF.

YES - Allow vaulting.

NO - Disallow vaulting.

Default: NO.

ENCRYPTV

If you are using the UPSTREAM data encryption feature, this option specifies the encryption algorithm that will be used by USTVAULT when creating encrypted copies of backups belonging to this backup profile. See UPSTREAM Data Encryption for a full description of the UPSTREAM encryption feature.

5.4 Utility Profiles (USTVLTxx, USTMIGxx, USTMERxx)#

Utility profiles are a set of specifically named, special purpose profiles that are used to control the behavior of the following UPSTREAM utility operations:

• Deferred Merge with USTMERGE (see Deferred Merge Utility Profile (USTMERxx))
  
• Migration with USTMIGRT (see Migration Utility Profile (USTMIGxx))
  
• Vaulting with USTVAULT (see Vaulting Utility Profile (USTVLTxx))
  

These special utility profiles cannot be used as a backup profile, or for any other UPSTREAM function. Samples of these utility profiles are automatically generated (with default values) during the installation process and the initial creation of the configuration data set.

When using the sample profiles, or when constructing your own new profiles, the options specified should be carefully reviewed and, if required, modified to meet your installation standards for data set naming, unit names etc, as outlined in the following sections.

Full documentation on the actual functions controlled by these utility profiles can be found in the sections indicated.

Profile Grouping

Utility profiles are created with either a “USTVLT”, “USTMIG”, or “USTMER” prefix, accompanied by a 2-character (alphanumeric) suffix.

The preceding naming convention allows multiple profiles to be created for each of the utilities. Each profile has a unique 2-character suffix, allowing the utility processing to be segregated. This provides more flexibility and control over the utility process, and also allows multiple utility tasks to be run concurrently.

A utility process is associated with a utility profile via a GROUPID parameter. For example, to associate a USTMERGE process with the USTMER01 utility profile, a GROUPID=01 parameter is provided in the USTMER01 profile.

Tape Retention Data Set

By design, the USTVAULT, USTMIGRT, and USTMERGE utilities described below usually create multi-file tape volume sets. Some z/OS tape management systems control the retention of all the files on a multi-file tape volume set by the retention period specified on the first file of the tape set.

USTMERGE, USTMIGRT, and USTVAULT create an empty “Tape Retention Data Set” as the first file on the tape, thus establishing the retention period for all tape volumes that make up the tape set.

Deferred Merge Utility Profile (USTMERxx)

The USTMERGE utility program is used to complete the deferred merge backup process. See Completing Deferred Merge Backups for full details.

If you are going to perform deferred merge backups, you will need to have at least one USTMERxx utility profile defined within your UPSTREAM configuration. The behavior of USTMERGE is controlled by a USTMERxx utility profile.

• The USTMERxx profile must be enabled for sequential tape backups (TAPE=YES).
  
• The tape backup parameters (TAPEGDG, TAPEUNIT, etc.) are used to dynamically allocate an output tape to which the completed deferred merge backup tape set is written.
  
• The TAPEPREF value is used to create an empty “Tape Retention Data Set” as the first file on the tape, unless NEWTAPE is specified.
  

After the tape retention data set has been written, subsequent files placed on the tape set are the completed deferred merge backups. As an example, running USTMERGE for the backup profiles “SERVER01” and “PRODSRV2”, in which each profile has one deferred full merge backup, would result in tape set logically laid out as follows.

Figure 5.7:

Once you have entered all the required options into the menu, type “SAVE” on the command line and press the ENTER key.

Before a new USTMERxx profile can be used the configuration must be reloaded by the UPSTREAM started task, using the REFRESH command. See Reload an Existing Configuration for more details.

USTMERxx Profile Parameters

Below is a description of each of the parameter options that were set in our sample USTMER01 deferred merge utility profile. See DEFINE, MODIFY, and COPY Statements for a full list of all the parameters that can be specified.

PROFILE

Specifies the deferred merge utility profile name. It must begin with “USTMER” and have a suffix of a two character alphanumeric identifier.

TAPEGDG

TAPEGDG=YES indicates that the tape retention data set is to be a new generation of a GDG. This is recommended, since GDG processing will automatically delete old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required deferred merge backups.

TAPEPREF

Specifies the high level qualifiers to be used for the tape retention data set. If the TAPEGDG option is not specified as YES, the TAPEPREF value can be up to 19 characters long. USTMERGE will add the merge profile name, date and time in the format “profilename.Dmmyydd.Thhmmss” at the end of the data set name to form a unique name. If the TAPEGDG option is specified as YES, then the TAPEPREF value can be up to 35 characters long and will have the standard GDG type suffix of “.GnnnnV00” appended.

This value may contain a “?”, in which case USTMERGE will substitute the copy number (2 to 9) for the “?” in the name of the tape retention data set. See DEFINE, MODIFY, and COPY Statements for a full description of the naming standards used for the TAPEPREF parameter.

TUNIT

Applies to profiles where TAPE=YES has been specified. Specifies an z/OS tape unit name for use in allocating the deferred merge retention file and subsequent completed deferred merge backup data sets.

EXPDT

Specifies the Julian format expiration date of the tape retention data set. The meaning of this value is identical to the JCL parameter EXPDT.

EXPDT only accepts a 2-digit year number. Year values less than 70 are assumed to be in the 21st century (20xx). This parameter is mutually exclusive with RETPD.

In our example we will specify “99000” to indicate catalog retention control by the tape management system.

See DEFINE, MODIFY, and COPY Statements for full usage notes on the EXPDT= and RETPD=.

Migration Utility Profile (USTMIGxx)

The USTMIGRT utility program is used to migrate previously taken sequential disk backup data sets to tape. See Migrating Backups from Disk to Tape for full details.

If you are going to use USTMIGRT, you will need to have at least one USTMIGxx utility profile defined within your UPSTREAM configuration. The behavior of USTMIGRT is controlled by a USTMIGxx utility profile.

• The USTMIGxx profile must be enabled for sequential tape backups (TAPE=YES).
  
• The tape backup parameters (TAPEGDG, TAPEUNIT, etc.) will be used to dynamically allocate an output tape to which the disk backups will be migrated.
  
• The TAPEPREF value (see TAPEPREF=) will be used to create an empty Tape Retention Data Setas the first file on the tape, unless NEWTAPE is specified. Additional files will be added to the tape to contain the migrated backups using their original DASD backup data set names.
  

For example, performing a migration for the backup profile “SERVER01” for which the MIGTHRESH value is set to “1” and three previously taken DASD backups exist, results in a Migration Tape Set logically laid out as follows, with no backups remaining on DASD.

Figure 5.10:

• Its name will be USTMIG01
  
• It specifies the appropriate data set names and features to allow for the migration of existing DASD backup data sets to tape
  
• It utilizes GDGs to provide for retention control.
  

The menu below shows how to add a new USTMIGxx utility profile to the UPSTREAM configuration. In this instance, we are creating a utility profile called USTMIG01. (See Creating and Viewing UPSTREAM Profilesfor a full description of creating and editing profiles).

Once you have entered all the required options into the menu, type “SAVE” on the command line and press the ENTER key.

Before a new USTMIGxx profile can be used the configuration must be reloaded by the UPSTREAM started task, using the REFRESH command. See Reload an Existing Configuration for more details.

USTMIGxx Profile Parameters

Below is a description of each of the parameter options that were set in our sample USTMIG01 migration utility profile. See DEFINE, MODIFY, and COPY Statements for a full list of all the parameters that can be specified in a UPSTREAM profile.

PROFILE

Specifies the migration utility profile name. It must begin with “USTMIG” and have a suffix of a two character alphanumeric identifier.

TAPEGDG

TAPEGDG=YES indicates that the tape retention data set is to be a new generation of a GDG. This is recommended, since GDG processing automatically deletes old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required migrated backup data sets.

TAPEPREF

Specifies the high level qualifiers to be used for the tape retention data set. If the TAPEGDG option is not specified as YES, the TAPEPREF value can be up to 19 characters long. USTMIGRT will add the migrate profile name, date and time in the format “profilename.Dmmyydd.Thhmmss” at the end of the data set name to form a unique name. If the TAPEGDG option is specified as YES, then the TAPEPREF value can be up to 35 characters long and will have the standard GDG type suffix of “.GnnnnV00” appended.

This value may contain a “?”, in which case USTMIGRT will substitute the copy number (2 to 9) for the “?” in the name of the tape retention data set. See DEFINE, MODIFY, and COPY Statements for a full description of the naming standards used for the TAPEPREF= parameter.

EXPDT

Specifies the Julian format expiration date of the tape retention data set. The meaning of this value is identical to the JCL parameter EXPDT.

EXPDT only accepts a 2-digit year number. Year values less than 70 are assumed to be in the 21st century “20xx”. This parameter is mutually exclusive with RETPD.

In our example we will specify “99000” to indicate catalog retention control by the tape management system.

See DEFINE, MODIFY, and COPY Statements for full usage notes on the EXPDT= and RETPD= operands.

Vaulting Utility Profile (USTVLTxx)

The USTVAULT utility program is used to create secondary copies of sequential backups on tape, usually for off-site storage and disaster recovery. The original backup data sets can be resident on either tape or DASD. See Chapter 9 “Copying Backups with USTVAULT” for full details.

To use USTVAULT, at least one USTVLTxx utility profile must be defined within the UPSTREAM configuration. The behavior of USTVAULT is controlled by a USTVLTxx utility profile, which establishes the name, location, and other allocation related data for the supporting data sets that are placed on the vault tapes.

The Vault Control Data Set

The USTVAULT vault control data set is created as the last file on the tape set and it contains control records extracted from the UPSTREAM database. This data set allows USTREGEN (see Updating the Repository) to quickly reload the UPSTREAM database control records for all backup data sets that are contained on this vaulted tape set, without having to read through all of the backup tapes and data. Since Profile Grouping can be applied to a USTVAULT request, a tape set can consist of many tape volumes and consume a large amount of time to read through all the tapes. Having the control records in a separate file solves this problem.

Data Encryption

If you are using the UPSTREAM data encryption feature (UPSTREAM Data Encryption), USTVAULT can optionally encrypt the copies of the backups that it creates, using a choice of five encryption algorithms. This feature is controlled by the ENCRYPTV option in the backup profile (Backup Profiles).

As an option, USTVAULT can also encrypt the vault control data set before writing it as the last file on the output media. This feature is controlled by the ENCRYTPV option in the USTVLTxx profile (described below).

A Vault Profile (USTVLTxx) should have the following attributes:

• It must be enabled for sequential disk and sequential tape backups (DASD=YES, TAPE=YES).
  
• The tape backup parameters (TAPEGDG, TAPEUNIT, etc.) are used to dynamically allocate an output tape on which the secondary backups will be created.
  
• The TAPEPREF value is used to create an empty Tape Retention Data Setas the first file on the tape. TAPEPREF must have a value that is different from the TAPEPREF or DASDPREF specification in the original profiles.
  
• Additional files are added to the tape to contain the secondary backups using their original names, except that the copy number (specified by a “?” in the DASDPREF=/TAPEPREF= in the backup profile) is changed from “1” to another copy number from “2” to “9” (2 is used by default).
  
• The DASDPREF value is used to create the vault control data set, which is temporarily stored on disk and then copied as the last file on the tape at the end of USTVAULT processing.
  

As an example, performing a USTVAULT on the backup profiles “PRDSRV01” and “SERVER01” would result in a vault tape set logically laid out as follows.

Figure 5.13:

• Its name will be USTVLTAA
  
• It will specify the data set name and attributes of the tape retention data set
  
• It will specify the data set name and attributes of the vault control file
  
• It will utilize GDGs to store the data and provide for retention control
  

The menu below shows how to add a new USTVLTxx utility profile to the UPSTREAM configuration. In this instance, we are creating a utility profile called USTVLTAA. (See Creating and Viewing UPSTREAM Profilesfor a full description of creating and editing profiles).

USTVLTxx Profile Parameters

Below is a description of each of the parameter options that were set in our sample USTVLTAA vault utility profile. See DEFINE, MODIFY, and COPY Statements for a full list of all the parameters that can be specified in a UPSTREAM profile.

PROFILE

Specifies the vault utility profile name. It must begin with “USTVLT” and have a suffix of a two character alphanumeric identifier.

TAPEGDG

TAPEGDG=YES indicates that the tape retention data set is to be a new generation of a GDG. This is recommended, since GDG processing will automatically delete old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required vault copies.

TAPEPREF

Specifies the high level qualifiers to be used for the tape retention data set. If the TAPEGDG option is not specified as YES, the TAPEPREF value can be up to 19 characters long. USTVAULT will add the vault profile name, date and time in the format “profilename.Dmmyydd.Thhmmss” at the end of the data set name to form a unique name. If the TAPEGDG option is specified as YES, then the TAPEPREF value can be up to 35 characters long and will have the standard GDG type suffix of “.GnnnnV00” appended.

This value may contain a “?”, in which case USTVAULT will substitute the copy number (2 to 9) for the “?” in the name of the tape retention data set. See DEFINE, MODIFY, and COPY Statements for a full description of the naming standards used for the TAPEPREF= parameter.

EXPDT

Specifies the Julian format expiration date of the tape retention data set. The meaning of this value is identical to the JCL parameter EXPDT. EXPDT only accepts a 2-digit year number. Year values less than 70 are assumed to be in the 21st century (20xx). This parameter is mutually exclusive with RETPD. In our example we will specify “99000” to indicate catalog retention control by the tape management system. See DEFINE, MODIFY, and COPY Statements for full usage notes on the EXPDT= and RETPD= operands.

DASDBLK

This field specifies the block size for the vault control file data set that is initially created on DASD and subsequently placed on tape as the final data set on the vault tape. In our example we left this field blank to allow the system to use the value specified in the matching (system wide) DASDBLK configuration main parameter. (See UPSTREAM MAIN Configuration Options).

DASDGDG

DASDGDG=YES indicates that the vault control data set is to be a new generation of a GDG. This is recommended since GDG processing will automatically delete old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required vault control data sets.

DASDPREF

Specifies the high level qualifiers to be used for the vault control data set. If the DASDGDG option is not specified as YES, the DASDPREF value can be up to 19 characters long. USTVAULT will add a data set name suffix including the Vault control profile name as “USTVLCnn”, the date and time in the format “USTVLCnn.Dmmyydd.Thhmmss” at the end of the data set name to form a unique name. If the DASDGDG option is specified as YES, then the DASDPREF value can be up to 35 characters long and will have the standard GDG type suffix of “.GnnnnV00” appended.

This value may contain a “?”, in which case USTVAULT will substitute the copy number (2 to 9) for the “?” in the name of the vault control data set. See DEFINE, MODIFY, and COPY Statements for a full description of the naming standards used for the DASDPREF= parameter.

UPSTREAM Repository Re-organization Profiles

As described in USTREORG and USTCAMS, the USTREORG utility program can be used to dynamically reorganize the UPSTREAM repository data sets.

Before you use USTREORG, you need to modify the following two default reorganization profiles that were placed into the configuration during the installation process: USTCATLG and USTFILEI.

These special reorganization profile names correspond to the DDNAMEs for the repository data sets in the UPSTREAM started task JCL (Installation and Configuration).

The reorganization profiles must be enabled for either sequential disk or tape backups. The specified parameters will be used to dynamically allocate a sequential data set to hold a copy of the contents of the repository data set being reorganized. This backup should be retained even if the reorganization is successful, allowing it to be used for future recovery processing, in the event that this becomes necessary.

The specification of the reorganization backup data sets as GDGs is strongly recommended so that older backup copies will automatically be uncataloged and scratched as new reorganizations are performed. The GDG base should be defined with two or more generations to allow for the retention of several copies of the backup for emergency recovery of the repository files.

In the following example we will modify the USTFILEI repository reorganization profile that was predefined by the system at installation time. It will have the following important attributes:

• Its name will be USTFILEI.
  
• It will specify the appropriate data set name and other options to allow a backup data set to be created. It will also specify where that backup data set will be placed.
  
• It will utilize GDGs to store the data and provide for retention control.
  

Below, we enter “E” on the left-hand prefix entry area to edit the default system generated USTFILEI reorganization profile.

Once you have entered all the required options into the menu, type “SAVE” on the command line and press the ENTER key.

Before a new USTFILEI (or USTCATLG) reorganization profile can be used the configuration must be reloaded by the UPSTREAM started task, using the REFRESH command. See Reload an Existing Configuration for more details.

USTFILEI and USTCATLG Profile Parameters#

Below is a description of each of the parameter options that were set in our sample USTFILEI reorganization profile. See DEFINE, MODIFY, and COPY Statements for a full list of all the parameters that can be specified in a UPSTREAM profile.

PROFILE

Specifies the name of the reorganization profile. This is a reserved Profile name used solely to reorganize a USTFILEI or USTCATLG repository data set.

TAPE

Specifies that you want the reorganization to occur to mainframe tape. When this option is enabled, the TAPEPREF and the TUNIT or TAPESTORCLAS options must also be specified.

TAPEGDG

TAPEGDG=YES indicates that the backup data set is to be a new generation of a GDG. This is recommended, since GDG processing will automatically delete old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required backups.

TAPEPREF

Specifies the high level qualifiers of the data set name that will be created to hold the backup of repository data set being reorganized. TAPEGDG option is specified as NO, then the TAPEPREF value can be up to 29 characters long and the USTREORG utility program will append the date and time in the format “.Dmmyydd.Thhmmss” to the generated data set name in order to form a unique name. If the TAPEGDG option is specified as YES, then the TAPEPREF value can be up to 35 characters long and will have the standard GDG type suffix of “.GnnnnV00” appended. See DEFINE, MODIFY, and COPY Statements for a full description of the naming standards used for the TAPEPREF= parameter.

EXPDT

Specifies the Julian format expiration date of the backup data set. The meaning of this value is identical to the JCL parameter EXPDT. EXPDT only accepts a 2-digit year number. Year values less than 70 are assumed to be in the 21st century (20xx). This parameter is mutually exclusive with RETPD. In our example we will specify “99000” to indicate catalog retention control by the tape management system. See DEFINE, MODIFY, and COPY Statements for full usage notes on the EXPDT= and RETPD= operands.

DASD

Specifies that you want the reorganization to occur to mainframe DASD. When this option is enabled, the DASDPREF and one of the DUNIT, VOL, or STORCLAS options must also be specified.

DASDGDG

DASDGDG=YES indicates that the backup data set is to be a new generation of a GDG. This is recommended, since GDG processing will automatically delete old generations. GDG bases must be predefined in the appropriate system catalog before they can be used by UPSTREAM. Be sure you define sufficient generations in the GDG base to retain all required backups.

DASDPREF

Specifies the high level qualifiers of the DASD data set name that will be created to hold the backup of the repository data set. If the DASDGDG option is specified as NO, then the DASDPREF value can be up to 29 characters long and the USTREORG utility program will append the date and time in the format “.Dmmyydd.Thhmmss” to the generated data set name in order to form a unique name.

If the DASDGDG option is specified as YES, then the DASDPREF value can be up to 35 characters long and will have the standard GDG type suffix of “.GnnnnV00” appended. See Section “DEFINE, MODIFY, and COPY Statements” for a full description of the naming standards used for the DASDPREF= parameter.

5.6 File Transfer Profiles

If you plan to use the file transfer facility of UPSTREAM (see File Transfer) you need to create one or more file transfer profiles.

• These profiles must have the TRANSFER attribute set
  
• The DASD attribute is required if client-to-host transfers will go directly to z/OS disk
  
• The TAPE attribute is required if client-to-host transfers will go directly to z/OS tape
  
• The DASDPREF and TAPEPREF attributes can be used to supply the name of the z/OS output data set on client-to-host transfers.
  

Below, we have entered “ADD FILETRAN” in the command line to create a new file transfer profile.

Once you have entered all the required options into the menu, type “SAVE” on the command line and press the ENTER key.

Before a new file transfer profile can be used, the configuration must be reloaded by the UPSTREAM started task, using the REFRESH command. See Reload an Existing Configuration for more details.

File Transfer Profile Parameters

Below is a description of each of the parameter options that were set in our sample FILETRAN file transfer profile. See DEFINE, MODIFY, and COPY Statements for a full list of all the parameters that can be specified in a UPSTREAM profile.

PROFILE

Specifies the file transfer profile name. It may be 1-8 characters, and it must start with an alphabetic or national character (the remainder may be any alpha, numeric, or national characters).

TAPE

Specifies that this profile allows file transfers directly to z/OS sequential tape. When enabled for a given profile, the TAPEPREF and the TUNIT or TAPESTORCLAS options must also be enabled.

TAPEPREF

Applies to profiles where TAPE=YES has been specified. It specifies the high level qualifiers of the data set name to be used as output for the file transfer. See DEFINE, MODIFY, and COPY Statements for a full description of the naming standards used for the TAPEPREF= parameter.

TUNIT

Applies to profiles where TAPE=YES has been specified. Specifies an z/OS tape unit name for use in allocating output data sets.

EXPDT

Specifies the Julian format expiration date of the output data sets created when using this profile. The meaning of this value is identical to the JCL parameter EXPDT. EXPDT only accepts a 2-digit year number. Year values less than 70 are assumed to be in the 21st century (20xx). This parameter is mutually exclusive with RETPD. See DEFINE, MODIFY, and COPY Statements for full usage notes on the EXPDT= and RETPD= operands.

In our TEST example we specified “99000” to indicate catalog retention control by the tape management system.

DASD

Specifies that this profile allows file transfers directly to z/OS sequential disk. When enabled for a given profile, the DASDPREF and one of the DUNIT, VOL, or STORCLAS options must also be specified.

DASDBLK

Applies to profiles where DASD=YES has been specified. Specifies the blocksize to be used when allocating the output data set. It is not used as the actual blocksize of the output data set, but it is used in performing space allocation calculations. In our example we left this field blank to allow the system to use the value specified in the matching (system wide) DASDBLK configuration main parameter (See UPSTREAM MAIN Configuration Options).

DASDPREF

Applies to profiles where DASD=YES has been specified. It specifies the high level qualifiers of the data set name to be used as output for the file transfer. See DEFINE, MODIFY, and COPY Statements for a full description of the naming standards used for the DASDPREF= parameter.

DUNIT

Applies to profiles where DASD=YES has been specified. Specifies an z/OS tape unit name for use in allocating output data sets.

Either DUNIT, VOL, or STORCLAS is required when the DASD=YES option is enabled. DUNIT and VOL cannot both be specified on the same profile.

TRANSFER

TRANSFER=YES enables this profile for file transfer.