Previous Topic: Fields That Can Be EditedNext Topic: Audit Record Format


TMC Format and Contents

A TMC logical record length is 340 bytes. Each control record is 340 bytes, each TMC record is 340 bytes, and each DSNB (two for each TMC record) is 170 bytes. An Audit record logical record length is 370 bytes. The first 340 bytes of these records are copied from either a TMC volume record or two DSNB records. The last 30 bytes contain the audit date, time, and code information.

CA VM:Tape does not update all TMC fields. For a list of those fields, contact Technical Support.

The TMC Volume Record Format and Contents table lists the names and format of the fields in a TMC volume record.

Note: Offsets in the TMC records are relative to zero in both decimal and hexidecimal.

TMC Volume Record Format and Contents

Field Name/
Keyword

Data Label

Offset

Length (Bytes)

Type

Editable

Description

VOLSER

TMVOLSER

0(0)

6

Char

No

Volume serial number

DSN

TMDSN

6(6)

44

Char

DSNB

Data set name

EXPDT

TMEXPDT

50(32)

4

Date

Yes

Expiration date

VOLSEQ

TMVOLSEQ

54(36)

2

Bin

N/R

Volume sequence number

1STVOL

TMFRSVOL

56(38)

6

Char

N/R

First volser of data set

PREVVOL

TMPRVVOL

62(3E)

6

Char

N/R

Previous volser of data set

NEXTVOL

TMNXTVOL

68(44)

6

Char

N/R

Next volser of data set

NUMDSNB

TM#DSNBS

74(4A)

2

Bin

N/R

Number of data set name blocks

1STDSNB

TMADSNB

76(4C)

4

Bin

Yes

Address and number of first DSNB record associated with this volume record

LSTDSNB

TMALDSNB

80(50)

4

Bin

Yes

Address and number of last DSNB record associated with this volume record

FLAG1

TMFLAG1

84(54)

1

Hex

Yes

Internal FLAG1 Bits are as follows:

  • X'01' volume eligible for RDS override (TMDEFAULT)
  • X'02' volume in delete (inactive) status (TMDELETE)
  • X'04' volume in scratch status (TMSCRTCH)
  • X'08' volume listed to be cleaned (TMCLEAN)
  • X'10' volume closed by abend (TMABEND)
  • X'20' volume record requested by user (TMUPDATE)
  • X'40' volume closed normally (TMCLOSED)
  • X'80' internal field changed by user (TMINTAL)

FLAG2

TMFLAG2

85(55)

1

Hex

Yes

Internal FLAG2 Bits are as follows:

  • X'01' expired by CA1-, CA-11 or EDM (TMETMS)
  • X'02' expired from LDATE control (TMELDATE)
  • X'04' expired from cycle control (TMECYCLE)
  • X'08' expired from catalog control (TMECATLG)
  • X'10' temporary data set (TMTEMPDS)
  • X'20' data set recreated (TMREUSE)
  • X'40' volume opened for output (TMOUTPUT)
  • X'80' data set was on z/OS catalog (TMCATLOG)

FLAG3

TMFLAG3

86(56)

1

Hex

Yes

Internal FLAG3 Bits are as follows:

  • X'01' created by CA-1/Copycat (TMFILCPY)
  • X'02' additional files exist in volume set (TMULTIF)
  • X'04' default expiration date used at open output (TMDFEXU)
  • X'08' data set erase required (TMERASE)
  • X'10' controlled by CA-DYNAM/T (TMDYNAM)
  • X'20' controlled by external data manager (TMEDMTAP)
  • X'40' tape released by external vault manager (TMRELEVM)
  • X'80' CA-9/R+ indicated bad tape, do not mount for scratch (TMBADTAP)

FLAG4

TMFLAG4

87(57)

1

Hex

Yes

Internal flag bit

  • X'01' no further stacking allowed (TMNOSTAK)
  • X'02' tape is in use for RTS (Real Time Stacking) (TMINUSE)
  • X'04' non-resident tape (TMNRS)
  • X'08' file on OS catalog (TMISCAT)
  • X'10' tape has been degaussed (TMDEGAU)
  • X'20' vault specific request (TMVSR)
  • X'40' actual volser in use (TMACVOLI)
  • X'80' tape expired by SMS max retention (TMESMS)

TRTCH

TMTRTCH

88(58)

1

Hex

Yes

Recording Technique (TRTCH) are as follows:

  • X'13' data conversion
  • X'23' evan parity
  • X'2B' even parity & translation
  • X'3B' BCD/EBCIDIC translation
  • X'80' 9 track tape (9TRK)
  • X'C0' 3480 Cartridge - 18 tracks (18TK)
  • X'E0' 3490 Cartridge - 36 tracks (36TK)
  • X'E1' 3490E Cartridge - 36 tracks Extended Length (36X2)
  • X'E4' Redwood 12.5G capacity (RWDA)
  • X'E5' Redwood 25G capacity (RWDB)
  • X'E6' Redwood 50G capacity (RWDC)
  • X'E7' STK 9480 Cartridge (9482)
  • X'E8' 3590 Cartridge (128T)
  • X'E9' 3590 Cartridge tape (256T)
  • X'EA' 3590 Cartridge tape (128X)
  • X'EB' 3590 Cartridge tape (256X)
  • X'EC' 3590 Cartridge 384 tracks
  • X'ED' 3590 Cartridge 384 tracks Extended Length
  • X'E2' STK 9840C cartridge (9844)
  • X'EE' 3592 Cartridge Extended (FORMAT1)
  • X'EF' 3592 Cartridge Extended FORMAT1 performance (scaled)

DEN

TMDEN

89(59)

1

Hex

Yes

Recording density (Density Field Values) are as follows:

  • X'03' 200 BPI (200)
  • X'43' 556 BPI (556)
  • X'83' 800 BPI (800
  • X'C3' 1600 BPI (1600)
  • X'D3' 6250 PBI (6250)
  • X'E3' 38K BPI (Cartridge) (38K)
  • X'E7' 38K BPI (Cartridge-compacted) (38KC)
  • X'E8' 3590 (Cartridge tape) (3590)
  • X'E9'3592 (Cartridge tape)

LABEL

TMLTYPE

90(5A)

1

Hex

Yes

Tape Label Types are as follows:

  • X'01' no label (NL)
  • X'02' standard label (SL)
  • X'04' non-standard label (NSL
  • X'0A' standard user label (SUL)
  • X'10' bypass label process (BLP)
  • X'40'ANSI label - V.1 (AL1
  • X'48' ANSI user label - V.1 (AU1)
  • X'C0' ANSI label - V.3 (AL3)
  • X'C8' ANSI user label - V.3 (AU3)

RECFM

TMRECFM

91(5B)

1

Hex

DSNB

Record format

  • X'08' standard block
  • X'10' blocked
  • X'30' variable blocked ASCII
  • X'40' variable
  • X'44' variable ANSI
  • X'48' variable sequential
  • X'50' variable blocked
  • X'52' variable blocked machine
  • X'54' variable blocked ANSI
  • X'58' variable blocked spanned
  • X'80' fixed
  • X'82' fixed machine
  • X'84' fixed ANSI
  • X'88' fixed standard
  • X'90' fixed block
  • X'92' fixed block machine
  • X'94' fixed block ANSI
  • X'98'fixed block sequential
  • X'C0' undefined
  • X'D0' blocked

LRECL

TMLRECL

92(5C)

4

Bin

DSNB

Logical record length

BLKSIZE

TMBLKSI

96(60)

4

Bin

DSNB

Maximum block size

BLKCNT

TMBLKCNT

100(64)

4

Hex

DSNB

Data set block count

OUTDATE

TMOUTDAT

104(68)

4

Date

Yes

Date tape was marked out-of-area

OUTCODE

TMOUTAR

108(6C)

4

Char

Yes

Location ID of out-of-area tape

SLOT

TMSLOT

112(70)

4

Bin

Yes

Vault slot number

CDATE

TMCRTDT

116(74)

4

Date

DSNB

Creation date

 

 

120(78)

1

 

 

Reserved

CTIME

TMCRTTI

121(79)

3

Time

DSNB

Creation time

CJOB

TMJOBNM

124(7C)

8

Char

Yes

Creating job name

CSTEP

TMSTPNAM

132(84)

8

Char

Yes

Creating step name

CDDNAME

TMDDNAME

140(8C)

8

Char

Yes

Creating DD name

CUNIT

TMCRUNI

148(94)

2

Hex

Yes

Address of creation unit

LDATE

TMLASUSD

150(96)

4

Date

Yes

Date last used

 

 

154

1

 

 

Reserved

LTIME

TMLASUST

155(9B)

3

Time

Yes

Time last used

LJOB

TMLASUSJ

158(9E)

8

Char

Yes

Job name that last used volume

LUNIT

TMUSUNI

166(A6)

2

Hex

Yes

Address of unit last used

ACTVL1

TMACTVL1

168(A8)

5

Char

Yes

Actual internal volser

CLNCNT

TMCLNCNT

173(AD)

1

Bin

Yes

Number of times tape cleaned

USECLN

TMUSECLN

174(AE)

2

Bin

Yes

Use count at last cleaning

DATECLN

TMDATCLN

176(B0)

4

Date

Yes

Date tape was last cleaned

BTHDATE

TMBTHDT

180(B4)

4

Date

Yes

Date tape was first used

COUNT

TMUCOUNT

184(B8)

2

Bin

Yes

Number of times tape opened since BTHDATE

VENDOR

TMVENDOR

186(BA)

8

Char

Yes

Tape vendor name

EDMID

TMEDMID

194(C2)

4

Char

Yes

External data manager ID

TRERRC

TMTERRC

198(C6)

2

Bin

No

Number of temporary read errors since cleaned

TWERRC

TMTWERRC

200(C8)

2

Bin

No

Number of temporary write errors since cleaned

PRERRC

TMPRERRC

202(CA)

2

Bin

No

Number of permanent read errors since cleaned

PWERRC

TMPWERRC

204(CC)

2

Bin

No

Number of permanent write errors since cleaned

TRERRI

TMTRERRI

206(CE)

2

Bin

No

Number of temporary read errors since initialized

TWERRII

TMTWERRI

208(D0)

2

Bin

No

Number of temporary write errors since initialized

PRERRI

TMPRERRI

210(D2)

2

Bin

No

Number of permanent read errors since initialized

PWERRII

TMPWERRI

212(D4)

2

Bin

No

Number of permanent write errors since initialized

DSN17

TMDSN17

214(D6)

17

Char

Yes

Last 17 bytes of DSN

ROBTY

TMROBTY

231(E7)

1

Hex

Yes

Tape in robotic device

  • X’01’ IBM
  • X’02’ STORTEK
  • X’03’ SUTNYM
  • X’04’ BOSCH
  • X’05’ GRAU
  • X’06’ COMPAREX
  • X’07’ HDS
  • X’81’ VIBM
  • X’82’ VSTORTEK
  • X’83’ VSUTMYN
  • X’84’ VBOSCH
  • X’85’ VGRAU
  • X’86’ VCOMPAREX
  • X’87’ VHDS
  • X’88’ VCAVTAPE
  • X’89’ VEMC

CTLGCNT

TMCATCNT

232(E8)

1

Bin

No

Catalog counter

 

 

233(E9)

2

 

 

Reserved

FLAG5

TMFLAG5

235(EB)

1

Hex

Yes

Internal flab bit

  • X'80' tape has been used by RTS (TMSTACK)
  • X'40' volume is owned by an agent (TMAGENT)
  • X'20' virtual volume exported (TMVTEXP)

VOLPERC

TMVOLP

236(EC)

1

Bin

No

Tape percentage in use

FILPERC

TMFILEP

237(ED)

1

Bin

No

Percentage used by file

COMPRES

TMCMPRS

238(EE)

1

Bin

No

Compression ratio

FLAG6

TMFLAG6

239(EF)

1

Hex

Yes

Internal flag bit

SMSMC

TMSMSMC

240(F0)

8

Char

Yes

SMS management class

CPGM

TMCPGM

248(F8)

8

Char

Yes

Creating program name

LPGM

TMLPGM

256(100)

8

Char

Yes

Last used program name

ROBID

TMROBID

264(108)

1

Hex

Yes

Robotic device indicator

ACTVL2

TMACTVL2

265(109)

1

Char

No

Actual internal volser (B)

ACCT

TMUSER

266(10A)

50

Char

Yes

User job accounting area

AUAREA

TMVATSA

 

24

 

 

Time-Stamp Area

BATCHID

TMVABTCH

316(13C)

1

Hex

Yes

ID of last CA 1 program to update record

HOOKID

TMVAHOOK

317(13D)

1

Hex

No

ID of last intercept to update record

  • 00—Open NL input/output
  • 12—EOV NL output
  • 24—EOV NL input
  • 08—OPEN SL input
  • 20—OPEN SL output
  • 04—OPEN SL output
  • 68—CLOSE input/output
  • 64—CLOSE EOV output
  • 16—EOV SL output
  • 60—CLOSE EV input
  • 28—EOV SL input
  • 32-44—User NSL routines

AUDATE

TMVADATE

318(13E)

4

Date

No

Date of last update

 

 

322(142)

1

 

 

Reserved

AUTIME

TMVATIME

323(143)

3

Time

No

Time of last update

USERID

TMVAUSER

326(146)

8

Char

No

ID of last user to update record

CPUID

TMVACPU

334(14E)

4

Char

No

ID of last CPU used for last update

AUCODE

TMVACODE

338(152)

1

Hex

No

Audit code

AUFLAG1

TMVAFLG1

339(153)

1

Hex

No

Audit flag

Total Record Length = 370