The TMSBLDVR program is invoked by TMSXTEND to read the TMC and create a volume range table based on the ranges it finds, then adding or deleting any volume ranges or DSNBs as requested based on the control statements specified in the SYSIN DD. When executed in standalone mode, TMSBLDVR can be used to identify the volume ranges in an existing TMC, validate volume range or DSNB control statements, and determine the size requirement of the new TMC. The TMSBLDVR utility is a subprogram of TMSXTEND that can also be executed to create a new TMC, replacing functionality provided by the TMSFORMT utility.
TMSBLDVR can also be used to define a new, empty TMC. TMSBLDVR is superior to TMSFORMT for defining a new TMC because of its ability to format alphanumeric volume serial number ranges without the use of the TMSXITE and TMSXITU user exits. Also, when executed in standalone mode with the PARM=NEW parameter is the only time the TMCNEW DD statement is used.
For messages associated with this utility see TMSBLDVR Messages.
TMSBLDVR creates TMS REPORT-80 which displays the volume ranges found in the existing TMC. The report also lists the volume ranges that are built as a result of any add or remove range statements. Statistics are also produced for the number of total and free DSNBs. If you run TMSBLDVR in standalone mode without a PARM=NEW parameter, the report includes the size requirements for the new TMC based on a blocksize of either 340 or 8840. This feature helps ensure that the new TMC is correctly preallocated.
If the required size for the TMC exceeds 4,369 cylinders, allocate the TMC by adding DSNTYPE=LARGE to the DD statement in the allocation step.
The following messages are issued to the report 80 that comes out of TMSBLDVR:
UNIQUE TMC RNAME ACTIVATED
This message is displayed when UNIQUE_RNAME=YES is used to create a TMC and when extending an existing TMC. If you use the Exclude statement, you get an RC=08 error.
UNIQUE TMC RNAME DEACTIVATED
This message is displayed if UNIQUE_RNAME=NO is used when extending an existing TMC and unique RNAME was previously activated.
//STEP01 EXEC PGM=TMSBLDVR,REGION=0M [,PARM=NEW]
//TMSRPT80 DD SYSOUT=*
//TMCNEW DD DSN=new.tmc.name,DISP=OLD,DCB=(BUFNO=60,BLKSIZE=n*340) * NOTE
//SYSUDUMP DD SYSOUT=*
//SYSIN DD *
ADDVOL VT0000-VT2999 ROBTY=88,VENDOR='CA VTAPE'
When this parameter is specified, a new TMC is formatted without copying volume ranges or DSNB records from an input TMC. The new TMC must be preallocated and cataloged. CA 1 does not have to be active or batch active to run with PARM=NEW.
You must have at least one ADDVOL statement and one ADDDSNB statement when formatting a new TMC.
This DD statement is required if PARM=NEW is specified. A newly allocated, empty TMC should be specified.The TMC DCB attributes follow:
The following completion codes are issued by TMSBLDVR:
Requests that you add nnnnnnn free DSNB records to the new TMC.
Lowvol-Highvol DEN=nn ROBTY=nn TRTCH=nn VENDOR=cccccccc DELETE specifies that the volume range lowvol-highvol are added to the new TMC. Optional parameters are provided to initialize the volume records with a density (DEN), robot type (ROBTY) recording technique (TRTCH), and vendor (VENDOR). For the DEN, ROBTY and TRTCH parameters, replace nn with hexadecimal values. For a list of these values, see TMC Volume Record Definition with Keywords in the Programming. The DELETE parameter simply indicates that the volumes are added in DELETE status in the new TMC. VENDOR is a one-through-eight character string that is used to identify the media manufacturer. In addition to a range, you can specify a single VOLSER on the ADDVOL statement. If you do not use DELETE in the control statement, the added volumes are in SCRATCH status.
Requests that you remove nnnnnnn free DSNB records from the new TMC.
Specifies that all volumes in the range lowvol-highvol are removed from the TMC. All volumes in this range must be in DELETE status, otherwise the entire range is not removed. You cannot remove all VOLSER entries from a TMC.
Specifies if UNIQUE_RNAME is used with this TMC. If you code this control statement, code it as the first control statement in the SYSIN DD. You can also use the CA CSM configuration user interface to set this option on. Add "Unique_RNAME=YES/NO" on TMSBLDVR job when you configure the creation of a new TMC using CA CSM.
The following messages are issued to the report 80:
TMS REPORT=80 JOB=MORTBLDV STEP=TMSBLDVR THURSDAY, APRIL 17, 2008.108 TIME=09:23:41
THURSDAY, APRIL 17, 2008.108 Y O U R C O M P A N Y N A M E ROxxxxx PAGE=00001
TMSBLDVR VOLUME DEFINITIONS
TMSBLDVR IS RUNNING STANDALONE MODE
TMC BEING READ: CAI.CA1.TMC
CURRENT TMC VOLUME RANGES
EXTERNAL VSN TMC REC NUMBER
In addition, TMS REPORT-80 also lists the TMC name being evaluated. The input control statements specified and the ranges that would be created for the new TMC. It also gives the number of DSNB's currently allocated, currently unused, and how many can be removed. Finally, it gives the space requirements of the TMC based on a unblocked TMC or a TMC allocated with a blocksize of 8840 (this is only reported if TMSBLDVR is run in standalone mode).