Utilities and Procedures › CATVMFI - Initialize the Volume Master File › Initialization Commands

Initialization Commands

There are three types of statements in the TLMSIDCK member:

• CONTROL

  Describe various controls for the VMF

• RANGE

  Defines the VOLSER ranges

• SKIP

  Defines unused spaces in ranges

The following keywords may appear on one or more CONTROL statements.

This parameter is required. The COMPANY name must be enclosed in single quotes.

AUX=

Reserve space for auxiliary records. Auxiliary records keep track of volumes that contain more than one data set and data sets that span more than one volume. Auxiliary space is managed so that available records are reused without compressing the VMF. This parameter is required. The minimum number of auxiliary records is 100.

The descriptions below help you with your estimates.

• Multi-data set volumes: If a volume contains more than one data set, the base record holds the first data set and each auxiliary record holds a maximum of two additional data sets. If a volume contains more than three data sets, additional auxiliary records are chained together until all of the data sets are recorded. For example, five data sets on the same volume would be recorded in one base record and two auxiliary records, like this:

• Multivolume data sets: If a data set spans more than one volume, the base record holds the base volume and up to five additional volumes. Each auxiliary record holds up to 32 additional volumes. If a data set requires more than 38 volumes, additional auxiliary records are chained together until all the volumes are recorded. For example, 70 volumes would be listed in one base record and two auxiliary records, like this:

COMPANY=

Provide a company name (1-30 characters) which will be printed on each CA TLMS report.

CPU=

Assign a CA TLMS internal system identification character to each SMF system identification symbol.

A maximum of 16 CPUs may be specified, 8 per CONTROL statement.

MESSAGE=

Indicate whether you want to reserve 50 records for auxiliary disposition messages (Y or N). This parameter is required.

SCRATCH=

Indicate whether all volume records in the VMF will be initialized as scratch volumes: Y (scratch) or N (nonscratch). This parameter is required.

WARNING=

Define when to generate warning messages that indicate that the auxiliary records area is almost full. Specify a number that is less than the number specified above for AUX. For example, if AUX is 5000, specify 4000 for WARNING. You will receive a warning message when 80 percent of the auxiliary messages have been used. This field must be specified on the same statement as AUX, separated by a comma.

The second type of statement in the TLMSIDCK member is the RANGE statement. At least one RANGE statement must be included, and the number of ranges is limited only by VMF size and performance. The format is as follows:

RANGE VSN(bbbbbb eeeeee) LEN(llll) DATE(jjjjj) MFG(mmmmmmmm) +

      TYPE(tt) ATL(ttt nnn) DEN(dddd)

RANGE

Specifies statement identifier and must appear first on the statement.

VSN( )

Contains the beginning and ending VSN of the range. The ending VSN may be omitted for a range of one tape. The beginning and ending VSN range must be alphanumeric.

LEN

(Optional) Specifies tape length.

DATE

(Optional) Specifies the Julian date recorded in the VMF purchase date.

MFG

(Optional) Specifies to supply the value of the vendor field in the VMF.

TYPE

(Optional) Specifies to supply the value of the tape type field of the VMF. This is a user determined value.

ATL

(Optional) Allows information about the ATL to be stored in the VMF for a range of tapes when it is defined. As with the other range keywords, these values only apply to newly-defined tape volumes and do not change the value of records during ++RESTORE or ++REORG. The ATL keyword is useful for defining virtual tape ranges, and new ranges of tapes added to an ATL. There are two positional sub-parameters associated with ATL.

ATL Type

Specifies a 1 to 8 character CA defined name for type of the automatic tape library. If the library contains virtual tapes, the first character of the name is always V. For example, IBM, VIBM, VTAPE, STORTEK, and VEMC.

ATL Number

Used to distinguish between multiple ATLs of the same type. It can have a numeric value of 1 to 254.

DEN

(Optional) Specifies the default tape density. This value will be overridden when a tape file is opened.

The third type of statement in the TLMSIDCK member is the SKIP statement. This statement is optional and may be included to define some numbers of VSNs within a range which are to be skipped. Thus you can avoid creating additional ranges just to skip a few VSNs. Performance is degraded by large numbers of ranges.

SKIP VSN(bbbbbb eeeeee)

SKIP

Specifies the statement identifier and must appear first on the statement.

VSN( )

Contains the beginning and ending VSNs to be skipped. The ending VSN may be omitted for a range of one tape.

/***************************************************/
/* SAMPLE VMF INIT-DECK FOR TLMS TEST SYSTEM        / 
/***************************************************/ 
CONTROL COMPANY=(YOUR TLMS RNN.n COMPANY NAME ) 
CONTROL AUX=00500 WARNING=000450 MESSAGE=Y SCRATCH=Y 
CONTROL CPU=(XE90/A SYS2/B SYS3/C DUMY/X ) 
/*PRINTCPU= */ 
RANGE VSN(000001 000002) LEN(2400) 
RANGE VSN(400001 400050)  DATE(96205) 
RANGE VSN(980001 980050)   MFG(MEMOREX) 
RANGE VSN(ARC001 ARC020) DATE(96315) LEN(9000) MFG(IBM) 
RANGE VSN(HSM001 HSM020) 
RANGE VSN(ODD020 ODD073) 
RANGE VSN(XMIT50 XMIT60) 
RANGE VSN(TST001 TST050) 
RANGE VSN(TRN001 TRN010) 
SKIP  VSN(980027 980027) 
SKIP  VSN(980040 980043) 
SKIP  VSN(ODD021 ODD025) 
SKIP  VSN(ODD027 ODD069) 
SKIP  VSN(ODD070 ODD072)