UPSTREAM MAIN Configuration Options
The following describes each parameter and its possible values.
APPLID1
cccccccc / NONE
Beginning with UPSTREAM z/OS 3.9.1, the UPSTREAM started task and USTBATCH may now use TCP/IP to initiate requests. If using TCP/IP, specify NONE.
Alternatively, if using APPC for USTBATCH to started a task communications, this specifies the name of the VTAM application ID used by z/OS Storage Server, usually “UPSTREAM”. This is the name on the first APPL statement in the USTAPPL member of VTAMLST (see Section 2.15 “Define Optional VTAM System Resources”), or, if specified, the ACBNAME= value on that APPL statement. This operand is required.
Default: NONE
DASDBLK
nnnnn
Specifies the default blocksize (1024 to 32760) that UPSTREAM uses when allocating a sequential disk backup. This value can be overridden on any or all individual backup profiles.
Default: 27998.
MAXHIST
nnnnn
Specifies the number of days (0 to 32760) that UPSTREAM retains history records in the CATALOG repository. Records older than the number of days specified are purged when USTMAINT (see Section 16.10 “FDR/UPSTREAM Configuration Maintenance”) is run. If MAXHIST=0 is specified, no history records are created.
Default: 365.
MAXTAPEB
nnn
Specifies the maximum number of tape drives (0 to 255) that UPSTREAM uses for backups at any one time. This includes the output tapes required for the online utilities such as USTMIGRT, USTMERGE, and USTVAULT. If the limit is exceeded, any new tasks requiring tape drives wait until the number of backup tapes in use declines. If MAXTAPEBACKUP=0 is specified, no tape limit is enforced.
Default: 0.
MAXTAPER
nnn
Specifies the maximum number of tape drives (0 to 255) that UPSTREAM uses for restores at any one time. If this limit is exceeded, any new restore tasks requiring tape drives waits until the number tape drives in use drops below MAXTAPERESTORE. If MAXTAPERESTORE=0 is specified, no tape limit is enforced.
Default: 0.
MAXTASKS
nnn
Specifies the maximum number of sub-tasks (1 to 255) that UPSTREAM can have active at any one time. This includes all backups, restores, inquiries, and utility functions. If this limit is exceeded, UPSTREAM rejects the initiation of any new tasks until the number of active tasks drops below MAXTASKS.
Default: 100.
RACFUPD2
Valid only if SECLVL=2 or 3 has been specified and if a userid has been granted UPDATE or READ access to a Client profile name. RACFUPD then specifies what operation the user is authorized to perform:
BACKUP
Allows users with UPDATE authority to do backups or restores, while users with only READ access can do only restores.
RESTORE
Allows users with UPDATE authority to do backups or restores, while users with only READ access can do only backups.
Default: RESTORE.
SECLVL3
Controls UPSTREAM security (see “The SECLVL Parameter” in Section 16.1 USTCONFG System wide Options Parameter Reference
0
(the default) specifies that UPSTREAM is to do no security checking on the userid and password entered by the end user at the Client. Specify this if you have no security system or prefer not to enforce userid security.
1
specifies that UPSTREAM is to issue a security call to verify the userid and password entered by the end user at the Client. No further security checking is done.
2
specifies that, in addition to verifying the userid and password (SECLVL=1), UPSTREAM issues additional security calls to verify that the userid is permitted to access the Client profile name entered by the end user. It also verifies that the userid is permitted to request restores from tape.
3
same as SECLVL=2, except that if the profile name and userid specified at the Client are the same, the user is automatically considered to be authorized to that profile name.
SUBSYS
cccccccc
Specifies the subsystem and control point name (default “UPSTREAM”) that will be used on security system calls if SECLVL=1, 2, or 3 is specified. Contact FDR/UPSTREAM Technical Support if you need assistance in altering this value.
TAPEBLK
ccc
Specifies the maximum tape DCB BLKSIZE parameter that will be used when allocating a new tape data set; the default is “MAX”.
UPSTREAM backups can utilize up to a maximum 256KB DCB BLKSIZE, or the optimum that the target tape device manufacturer will allow.
TCPNAME4
cccccccc
Identifies the z/OS TCP/IP started task instance name with which the UPSTREAM started task will communicate.
This is generally the name of your TCP/IP started task on your z/OS system. However, if you started the TCP/IP started task with the command similar to the following, the proper value for this parameter would be “SYS2”:
If the specified TCP/IP system is not active when z/OS Storage Server is started, a warning message is issued and TCP/IP access is disabled. You must restart the z/OS Storage Server started task to re-establish TCP/IP communications.
TCPPORT
nnnn
Specifies the TCP/IP port number that z/OS Storage Server uses as a “well-known” port number to listen for Client connections.
Default: 1972, which is generally fine.
WTOCOMP
Specifies whether UPSTREAM should issue WTOs to the z/OS system console for all messages relating to backups starting and completing, in addition to writing them to the UPSTREAM log (USTLOG).
YES
UPSTREAM issues WTOs to the z/OS system console for all messages relating to backups starting and completing, in addition to writing them to the UPSTREAM log.
NO
UPSTREAM only writes the messages to the UPSTREAM log.
This operand is optional. If omitted, these messages are written only to USTLOG. This feature may be useful for installations with mainframe automation and tracking facilities that monitor console messages.
Default: NO.
ATBCOUNT
nnnn
This parameter is for internal use only and should only be changed if requested by FDR/UPSTREAM Technical Support.
Default: 10.