UPSTREAM Repository Command Reference
This chapter documents, in a tabular reference type format, all the system commands of the UPSTREAM MVS product. These commands can be invoked via a z/OS console interface MODIFY command or via the USTBATCH utility program.
UPSTREAM MVS Commands | ||||
Command | Parameter(s) | Description | ||
ABENDM | Format: ABENDM=nnn | |||
|
| Description: This command is used to cause a diagnostic ABEND dump to be produced when a particular UPSTREAM MVS error message number is produced by the product. The dump taken causes the task that issued the message in question to be terminated. This command should only be used at the instruction of a Innovation Technical Support Representative. | ||
| nnn | Required: This parameter is the three digit number of the error message to scan for when performing ABEND message processing. | ||
CLOSE | Format: CLOSE DD=xxxxxxxx | |||
|
| Description: This command causes the closure and subsequent reopening of the specified UPSTREAM Database File. This command is useful to reset the last used date for the specified Database file so that products like FDRABR can identify for inclusion in an incremental backup. | ||
| DD | Required: This parameter specifies the z/OS DDNAME of the UPSTREAM MVS Started Task Database that you wish to close and reopen. You may use one of the following DDNAMEs: USTCATLG - The CATALOG Database USTFILEI - The FILEINFO Database USTFILEC - The Duplicate File Database | ||
COMTRACE | Format: COMTRACE ON | OFF | |||
|
| Description: This command enables/disables the UPSTREAM MVS Communications tracing facility. When enabled, this facility will consume considerable resources and slow the processing of the UPSTREAM system. This command should only be used at the instruction of a Innovation Technical Support Representative. | ||
| ON | Enable the UPSTREAM MVS Communications Trace. | ||
| OFF | Disable the UPSTREAM MVS Communications Trace. | ||
FLUSHLOG | Format: FLUSHLOG | |||
|
| Description: This command causes the closure and subsequent reopening of the UPSTREAM MVS Started Task USTLOG and USTSUMM datasets. This command is useful to flush the messages that are contained in the in-storage buffers to the log files so that they can be viewed with the installations SYSOUT viewing utilities. | ||
MAINT | Format: MAINT | |||
| Description: This command is used to remove entries for sequential tape and disk backups from the UPSTREAM/MVS Database. When your DASD and tape management systems delete these backup datasets, the USTMAINT utility will detect that they are no longer cataloged and remove the information regarding these deleted backups from the database. USTMAINT also deletes history records from the database when they exceed the retention specified in your configuration. | |||
| none | There are no valid parameters for the MAINT command. | ||
MAINTF | Format: MAINTF | |||
| Description: This command is used to remove entries from the UPSTREAM/MVS FILEINFO Database. When UPSTREAM system ABENDs or z/OS system failures occur, some “orphaned” control records can be left in the FILEINFO file. These records will not be removed by normal MAINT utility processing. It is suggested that this utility be run every time you run the MAINT utility program. This utility has no effect on the UPSTREAM CATALOG or Duplicate File Databases. | |||
| none | There are no valid parameters for the MAINTF command. | ||
MIGRTxx |
| Format: MIGRTxx PROFILE=xxxxxxxx,NEWTAPE,FORWARD | ||
| Description: This command will “migrate” recently created sequential disk backups to tape. This may be especially useful if you want to do daily incremental backups to disk but do not have enough available disk space to hold the entire set of incrementals between full backups. This command can process many backups, for many workstations, to the same set of tapes, reducing the number of tape volumes compared to direct backups to tape. You control the number of backups selected for a specific Backup Profile via the MIGTHRESH parameter specified in the Backup Profile configuration. | |||
| xx | Required: This two character alphanumeric suffix specifies the matching two character suffix of the USTMIGxx Migration Profile to be associated with this request. The USTMIGxx Migration Profile is used by a Migration request to identify the Tape Retention Dataset Name that is created as the first file of the Migration Tape Set. | ||
| PROFILE | Optional: The 1-8 character Backup Profile name that is to be processed by this invocation of the Migration Utility. A trailing “*” character of the value specified will indicate that all profiles that begin with the specified characters are to be selected for processing. | ||
| NEWTAPE | Optional: This parameter causes each individual Backup Profile’s backup datasets that are selected for processing by the Migration utility program to be placed on separate TAPE volumes. | ||
| FORWARD | Optional: This option requests that USTMIGRT do a "forward merge" of any incremental backups previously moved to tape by USTMIGRT (back to the last full backup) by reading those backups and merging the data with the current file being written to tape. It will require a second tape drive for the input tapes. This will create one file on the output tape for each profile processed, containing data from all of the preceding incremental backups. When USTMIGRT is migrating several backups for the same profile from disk in one execution, it already combines them into one file on the output tape. The FORWARD option simply enhances this to add backups that were previous migrated to this merge. No dummy file will be created at the beginning of the tape. | ||
LOGBLKN | Format: LOGBLKN=nnn | |||
|
| Description: Change the number of 64K internal buffers used to save USTLOG messages for display at a workstation. This command is infrequently used. | ||
| nnn | Required: This parameter is the three digit number of the count of 64KB USTLOG message buffers to maintain. | ||
MERGExx |
| Format: MERGExx,PROFILE=xxxxxxxx,NEWTAPE,FORCE | ||
|
| Description: The MERGE command scans the USTCATLG Upstream Database file for pending “Deferred Full Merge” requests. For each deferred merge encountered, it completes the merge by processing the required previous backup tapes and creating the new output tapes in order to complete the Full Merge process. | ||
| xx | Required: This two character suffix specifies the corresponding USTMERxx profile name to use when performing MERGE processing. | ||
| PROFILE | Optional: The 1-8 character Backup Profile name that is to be processed by this invocation of the Merge Utility. A trailing “*” character of the value specified will indicate that all profiles that begin with the specified characters are to be selected for processing. | ||
| NEWTAPE | Optional: This parameter causes each individual Backup Profile’s backup datasets that are selected for processing by the Merge utility program to be placed on separate TAPE volumes. | ||
| FORCE | Optional: | ||
MAXTAPEB | Format: MAXTAPEB=nnn | |||
|
| Description: Specifies the maximum number of tape devices to be used for backup operations. | ||
| nnn | Required: Specifies the 1-3 digit numeric limit on the number of tape devices to be used for backup type requests. | ||
MAXTAPER | Format: MAXTAPER=nnn Description: Specifies the maximum number of tape devices to be used for restore operations. Function requests that cause this limit to be exceeded will wait till units become available. | |||
| nnn | Required: Specifies the 1-3 digit numeric limit on the number of tape devices to be used for restore type requests. | ||
MAXTASKS | Format: MAXTASKS=nnn | |||
| Description: Specifies the maximum number of concurrent UPSTREAM Repository subtasks that will be allowed to simultaneously execute. Function requests that cause this limit to be exceeded are terminated. | |||
| nnn | Required: Specifies the 1-3 digit numeric limit on the number of simultaneous Upstream subtasks. | ||
QUIT | Format: QUIT | |||
| Description: This command causes an orderly shutdown of the UPSTREAM MVS Started Task. Any requests that are already in progress are allowed to complete and then the Started task ends. | |||
| none | There are no valid parameters for the Quit command. | ||
REFRESH | Format: REFRESH | |||
| Description: This command causes the UPSTREAM configuration dataset to be reloaded. This is required to make changes made to the configuration dataset active without recycling the UPSTREAM MVS Repository Started Task. This command will also cause many of the UPSTREAM modules which have had fixes applied (via zaps) to be activated. Most UPSTREAM-MVS modules are loaded once during startup, so fixes applied to the load library are not immediately available. The REFRESH command will cause current copies of all loaded modules to be deleted (as soon as they are no longer in use) and refreshed with the modified copies. | |||
| MEMBER | Optional: specifies the name of an alternate configuration dataset member name to be used in reloading the UPSTREAM Started Task configuration. This member will only be used until another REFRESH command is issued for a different member or the Upstream MVS Started Task is restarted. The start up member name is specified in the Upstream MVS Started Task JCL with a DDNAME of USTCONFG. | ||
REGEN |
| Format: REGEN DSN=xxxxxxxxxxxxx | ||
| Description: The REGEN command is used to read in a previously created Upstream backup dataset or Vault control file and reload its control information into the Upstream MVS database. | |||
| DSN | Required: This is the fully qualified MVS dataset name of the Upstream backup dataset or Vault control file that is to be used as input to the REGEN command. | ||
REMOVEDSN | Format: REMOVEDSN=datasetname | |||
| Description: The REMOVEDSN command is used to remove a previously taken backup completely from the Upstream MVS database. Once removed, the dataset will need to be REGEN’ed in order for it to be used by the Upstream system. | |||
| dataset name | Required: This is the fully qualified MVS dataset name of the Upstream backup dataset that is to be removed from the Upstream MVS database. | ||
REORG |
| Format: REORG DDNAME=xxxxxxxx,%F=nnn | ||
| Description: This command reorganizes the specified Upstream MVS database component. It performs this function by reading the specified database and then writing the data back in place. | |||
| DDNAME | Required: MVS Ddname from the Upstream MVS Started Task PROC for the database component to be reorganized. Options are: USTCATLG, USTFILEI, or USTFILEC. | ||
| %Free | Optional: The specified database will only be reorganized if it is determined to be of the specified percent free. | ||
SCHEDULE |
| Format: SCHEDULE MEMBER=xxxxxxxx,LIST | ||
| Description: This command starts or refreshes the Upstream MVS scheduler component. | |||
| MEMBER | Optional: Specifies the member name to be used for this invocation of the Upstream MVS scheduler. This name must be from 1 to 8 national characters in length. The schedule dataset name cannot be overridden with this option, only the member name. | ||
| LIST | Optional: This option causes the scheduler subtask to list out pending events it has to execute. | ||
STATUS | Format: STAtus | |||
| Description: This command outputs to the MVS SYSLOG and the Upstream MVS USTLOG dataset the current status of all active Upstream MVS subtasks. | |||
| none | There are no valid parameters for the STATUS command. | ||
SWITCHLOG | Format: SWITCHLOG | |||
| Description: This command causes the Upstream MVS system to be switched from its current output DD (USTLOG) to the alternate DD (USTLOG2) or back if it has already been switched. | |||
| none | There are no valid parameters for the SWITCHLOG command. | ||
TIMEOUT | Format: TIMEOUT=nnn | |||
| Description: Number of minutes to elapse before the request should be timed out. | |||
| nnn | Number of minutes to elapse before the request should be timed out. | ||
TRACE | Format: TRACE ON | OFF | |||
| Description: This command enables/disables the Upstream MVS internal tracing function. This command should only be issued under the guidance of a member of the Upstream technical support team. | |||
| ON | Enable the UPSTREAM MVS Internal Trace. | ||
| OFF | Disable the UPSTREAM MVS Internal Trace. | ||
VAULTxx |
| Format: VAULTxx,COPY=n,PROFILE=xxxxxxxx,NOINCR,NOFULL,NOVCHK | ||
| Description: The Vault utility command causes the USTCATLG database file to be scanned for any backups that have been performed and not previously vaulted, back to and including the previous Full backup. Secondary copies of these backup datasets are then made to Vault tapes. A control file is maintained on disk during this process and it is appended to the last vault volume for use by the REGEN utility. | |||
| xx | Required: This two character alphanumeric suffix specifies the matching two-character suffix of the USTVLTxx Vault Profile to be associated with this request. The USTVLTxx Vault Profile is used by a VAULT request to identify the Vault Retention Dataset Name and the Vault Control File Dataset Name. There is no default value. | ||
| COPY=n | Optional: Specifies the substitution number that should replace the “?” special substitution character in the generated VAULT copy dataset names. The default value is “2”. | ||
| PROFILE | Optional: The 1-8 character Backup Profile name that is to be processed by this invocation of the VAULT Utility. A trailing “*” character of the value specified will indicate that all profiles that begin with the specified characters are to be selected for processing. | ||
| NOFULL | Optional: Specifies that First Time Full and Full Merge type backups should NOT be selected for this invocation of the VAULT utility. | ||
| NOINCR | Optional: Specifies that incremental type merge backups should NOT be selected for this invocation of the VAULT utility. | ||
| NOVCHK | Optional: Specifies that previously vaulted backups can be selected for this invocation of the VAULT utility. | ||