Skip to content
CA 1® Tape Management System - 14.0
Documentation powered by DocOps

TMSBINQ Utility -- Print Volume, DSNB and CA 1 Control Records

Last update March 27, 2019

Use the TMSBINQ batch inquiry program to select and print volume, DSNB, and CA 1® Tape Management System control records. CA 1® Tape Management System must be active or batch active.

The following topics are included in this section:

Report Description

TMSBINQ produces TMS Report 12 - Batch Inquiry. The report contents are determined by the options selected: HEADERS, VOL, DSN, or DSNB.

The HEADERS control statement generates header record output that is formatted differently than output for nonheader records. The HEADERS control statement generates control records from the TMC and Audit. Control Record reports are automatically generated in both character and hexadecimal format.

Header records have the following contents:

  • The last CA 1 IPL date and time
  • The number and values of (internal) volume serial number ranges
  • The value of FLAG1 from Control Record #1
  • The number of DSNBs allocated and used
  • The DSNB base and the first available DSNB
  • The number of allocated Audit records
  • The first and next available Audit record
  • The next label to be printed by TMSLBLPR
  • The next CA Dynam/T pointer
  • The date, time, volume, and data set name of the last TMC backup

The contents of Volume or DSNB records can be listed in three different formats: SHORT, LONG, and DUMP. The LONG format gives descriptions of the flag bytes and the fields that have special meanings for clarity. Examples are RECFM, TRTCH, DEN, and BATCH ID.

Job Control Statements

//stepname EXEC PGM=TMSBINQ[,PARM='DATEFMT=(fmt)']

//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR

//TMSRPT   DD  SYSOUT=A

//SYSIN    DD  *

(control statements here)

/*

Parameter Definitions

DATEFMT=(fmt)

Specifies the date format to be printed on TMS Report 12. The date pattern indicated by (fmt) is limited to 10 bytes and must be enclosed in parentheses. This parameter is optional. For more information about valid date formats, see Overriding the Preferred Date Pattern.

Completion Codes

Possible completion codes and their meanings follow:

  • 0
    Successful completion
  • 12
    Error – See messages in TMSRPT DD.

Control Statement Specification

Four control statements are available for use with TMSBINQ:

  • HEADERS is an optional control statement. HEADERS requests the TMC and Audit header records to be printed.
  • VOL is an optional control statement. VOL requests a specific volume serial number or volume serial number range to be printed.
  • DSN is an optional control statement. DSN requests a specific data set to be printed. The DSN must have an entry on the system catalog.
  • DSNB is an optional control statement. DSNB requests a specific DSNB or a DSNB range to be printed.

Multiple control statements can be entered for each program execution.

HEADERS Control Statement

The HEADERS control statement causes the three TMC header Control Records and the Audit header record to be printed in a hexadecimal and character format. For the TMC and Audit record definitions and keywords, see Programming. The format for the HEADERS control statement is:

1

HEADERS

Control Statement Definition

HEADERS

Control statement identifier and must start in position one.

VOL Control Statement

The VOL control statement inquires by volume serial number. If an inquiry is made to a record containing DSNBs, the DSNBs associated with that volume are printed. If an inquiry is made to a volume of a multivolume file, all subsequent volume serial numbers of the multivolume file are listed. However, if the VOL control statement requests a range of volumes, DSNBs and subsequent volumes are not printed. The format for the VOL control statement is:

1   5

VOL=vvvvvv[-vvvvvv][,format][,NEWPAGE]

Control Statement Definitions

VOL

Control statement identifier and must begin in position one.

vvvvvv

Volume serial number to be printed. If two volume serial numbers that are separated by a dash are specified, all TMC records that are included in the range are printed.

format

Specifies the print format. The values for format are:

SHORT

Only the most significant fields are printed.

LONG

All fields are printed. For each TMC record, nine lines of data appear on the report. For each DSNB record, five lines of data appear on the report. LONG is the default.

DUMP

The record is printed in character and hexadecimal format.

NEWPAGE

Forces a page break when multiple individual volumes or data set names are specified. If NEWPAGE is not specified, no page break occurs when the next control statement is processed. NEWPAGE is optional and, when used, must be the last option specified.

DSN Control Statement

The DSN control statement inquires by data set name. The data set must have an entry on the system catalog. The format for the DSN control statement is:

1   5

DSN=dsname[,format][,NEWPAGE]

Control Statement Definition

VOL

Control statement identifier and must begin in position one.

vvvvvv

Volume serial number to be printed. If two volume serial numbers that are separated by a dash are specified, all TMC records that are included in the range are printed.

format

Specifies the print format. The values for format are:

SHORT

Only the most significant fields are printed.

LONG

All fields are printed. For each TMC record, nine lines of data appear on the report. For each DSNB record, five lines of data appear on the report. LONG is the default.

DUMP

The record is printed in character and hexadecimal format.

NEWPAGE

Forces a page break when multiple individual volumes or data set names are specified. If NEWPAGE is not specified, no page break occurs when the next control statement is processed. NEWPAGE is optional and, when used, must be the last option specified.

DSNB Control Statement

The DSNB control statement requests specific DSNBs to be printed. The format for the DSNB control statement is:

1    6

DSNB=n[-n][,format][,NEWPAGE]

Control Statement Definition

VOL

Control statement identifier and must begin in position one.

vvvvvv

Volume serial number to be printed. If two volume serial numbers that are separated by a dash are specified, all TMC records that are included in the range are printed.

format

Specifies the print format. The values for format are:

SHORT

Only the most significant fields are printed.

LONG

All fields are printed. For each TMC record, nine lines of data appear on the report. For each DSNB record, five lines of data appear on the report. LONG is the default.

DUMP

The record is printed in character and hexadecimal format.

NEWPAGE

Forces a page break when multiple individual volumes or data set names are specified. If NEWPAGE is not specified, no page break occurs when the next control statement is processed. NEWPAGE is optional and, when used, must be the last option specified.

Control Statement Examples

The following example prints the SHORT format of the TMC volumes 000010, 000011 and 000012, and DSNB relative record 10. NEWPAGE causes TMC volumes 000011 and 000012 to be printed on new pages. Volume 000101 are printed in the LONG format. Volume 000099 and the TMC volume containing the data set TMC.BACKUP are printed in hexadecimal, DUMP format. DSNB information for DSNB 000010 are printed in SHORT format.

VOL=000010-000012,SHORT,NEWPAGE

VOL=000101,LONG

VOL=000099,DUMP

DSNB=000010,SHORT

DSN=TMC.BACKUP,DUMP

TMS Report 12 - Batch Inquiry (Dump)

MONDAY, MONTH DD, YYYY.190                    Y O U R   C O M P A N Y   N A M E                        ROxxxxx PAGE=00001


TMS REPORT-12      BATCH INQUIRY            VOL=300009,DUMP




VOLSER=300009      300009CORP.TD.ARCHA                                                                      L

                   FFFFFFCDDD4EC4CDCCC4444444444444444444444444444444092200000000000000000000000000000044008D09000D0021

                   3000093697B34B193810000000000000000000000000000000048C0100000000000000000001000100011020032000700070

                  01...5...10...15...20...25...30...35...40...45...50...55...60...65...70...75...80...85...90...95.....


                                           JOBARCHASTEP1   SEQOUT            JOBARCHA

                   000400004444000009120042DDCCDCCCEECDF444ECDDEE440809120042DDCCDCCC0800000000000009120044444444444400

                   0005000C00000000049C013C16219381235710002586430075049C013C162193817500000000000C049C0200000000000000

                 101...5...10...15...20...25...30...35...40...45...50...55...60...65...70...75...80...85...90...95.....


                                 CORP.TD.ARCHA                     PGM111  PGM111

                   00000000000000CDDD4EC4CDCCC444400000000044444444DCDFFF44DCDFFF44000000000000000000000000000000000000

                   000000000000003697B34B193810000000000000000000007741110077411100000000000000000000000000000000000000

                 201...5...10...15...20...25...30...35...40...45...50...55...60...65...70...75...80...85...90...95.....


                                             CORPA01 XE98

                   00000000000000000109120042CDDDCFF0ECFF00

                   000000000000000004049F013F36971010759820

                 301...5...10...15...20...25...30...35...40


                                                 ***** DSNBS *****


  DSNB=000001                      300009300009  CORP.TD.ARCHB                                           JOBARCHASTEP2

                   F800000000000000FFFFFFFFFFFF00CDDD4EC4CDCCC4444444444444444444444444444444092209120042DDCCDCCCEECDF4

                   F010000100000000300009300009023697B34B193820000000000000000000000000000000048C049C013C16219381235720

                  01...5...10...15...20...25...30...35...40...45...50...55...60...65...70...75...80...85...90...95.....


                                  3         PGM111                         CORPA01 XE98

                   4400000D0021000F944444444DCDFFF4400000000000000409120042CDDECFF0ECFF00

                   000000700070000300000000077411100000000000000004049F013F36921010759820

                 101...5...10...15...20...25...30...35...40...45...50...55...60...65...70



       END OF REPORT 12

TMS Report 12 - Batch Inquiry (Long)

The following example illustrates that all files of a multifile data set are automatically generated:

THURSDAY, MONTH DD, YYYY.346                  Y O U R   C O M P A N Y   N A M E                                ROxxxxx PAGE=00001 

TMS REPORT-12      BATCH INQUIRY            VOL=001508,LONG                                                       

                                                                                                                  

                                                                                                                  

001508  DSN=JESS.XPORT                                        ACCT=

        EXPDT=CATALOG       CDATE=2013/018    CTIME=13.33     CJOB=JESSSPLT       CSTEP=SPLTITUP   CDDNAME=EXPORT    CUNIT=078A 

        FLAG1=E0=(INT,CLO,UPD)                                FLAG2=60=(OUT,REC)                                     CPGM=TMSSPLIT

        FLAG3=06=(DEF,MTF)                                    FLAG4=00=                                     FLAG5=00=           

        VOLSEQ=000001       1STVOL=           PREVVOL=        NEXTVOL=            ACTVOL=          DSN17=                       

        NUMDSNB=00001       1STDSNB=00000005  LSTDSNB=00000005                    WWID=                              WMC=       

        LDATE=2013/018      LTIME=13.33       LJOB=JESSSPLT   LUNIT=078A          LPGM=TMSSPLIT                      BYTEPRC=188

        TRTCH=36TK          DEN=38KC          LABEL=SL        RECFM=FB            LRECL=000366     BLKSIZE=003660    BLKCNT=00000001

        OUTDATE=ZEROS       OUTCODE=          SLOT=0000000    BTHDATE=2013/018    COUNT=00003      VENDOR=           EDMID=     

        TRERRI= 0000        TRERRC= 0000      TWERRI= 0000    TWERRC= 0000        VOLPERC=001      SMSMC=            ROBID=000  

        PRERRI= 0000        PRERRC= 0000      PWERRI= 0000    PWERRC= 0000        FILPERC=001      COMPRES=000       ROBTY=     

        DATECLN=ZEROS       USECLN=000000     CLNCNT=000      BATCHID=TMSUPDTE    HOOKID=          CTLGCNT=000       BESKEY=00000

        AUDATE=2013/346     AUTIME=16.03      USERID=CARPA20  CPUID=ZM1D          AUCODE=00                          AUFLAG1=00

                                                 ***** DSNBS *****  

001508  ACTIND=80          DSN=CARPA20.DSNBADD                               NEXTDSNB=00000000 PREVDSNB=00000000 CURDSNB=00000005

        EXPDT=CATALOG      VOLSER=001508    FILSEQ=00002     F1STVSN=001508  FLAG1=80=(UPD)                              FLAG2=00

        CDATE=2013/340     CTIME=15.17      CJOB=CARPABIN    CSTEP=TMSAGGR   CPGM=                             FILPERC=000     

        RECFM=             LRECL=00000      BLKSIZE=000000   BLKCNT=         BYTEPRC=070      BESKEY=00000     COMPRES=000     

        BATCHID=TMSUDSNB   HOOKID=          BID=FF           SMSMC=                                            CTLGCNT=000     

        AUDATE=2013/346    AUTIME=16.07     USERID=CARPA20   CPUID=ZM1D      AUCODE=00        AUFLAG1=00                       

       END OF REPORT 12                                                                                                        

TMS Report 12 - Batch Inquiry (Short)


MONDAY, MONTH DD, YYYY.190                      Y O U R   C O M P A N Y   N A M E                            ROxxxxx PAGE=00001


TMS REPORT-12      BATCH INQUIRY            VOL=300009,SHORT




300009  DSN=CORP.TD.ARCHA                                     ACCT=

        EXPDT=YYYY/282      CDATE=YYYY/190    CTIME=14.32     CJOB=JOBARCHA       CSTEP=STEP1      CDDNAME=SEQOUT    CUNIT=0785


                                                 ***** DSNBS *****


300009  ACTIND=80          DSN=CORP.TD.ARCHB                                 NEXTDSNB=0000000 PREVDSNB=0000000 CURDSNB=0000001

        EXPDT=YYYY/282     VOLSER=300009    FILSEQ=002       F1STVSN=300009  FLAG1=01=(RDS)                            FLAG2=00



       END OF REPORT 12

TMSBINQ Report Field Definitions


Control statement image

Input control statement


***** DSNBS *****

Related DSNB records display if first volume

TMC CTL REC #1

TMC Control Record #1 display

TMC CTL REC #2

TMC Control Record #2 display

TMC CTL REC #3

TMC Control Record #3 display

TMC CTL REC #4

Audit Control Record #4 display

TMC CTL REC #1 & #3 VOLUME RANGES

Volume ranges display from TMC Control Records #1 and #3

xxxxxx

Volume serial number SHORT or LONG display

VOLSER=xxxxxx

Volume serial number DUMP format display

DSNB=xxxxxx

DSNB number DUMP format display

When the audit file is in the BLOCKSET mode, the audit dates and times are in GMT/UTC. All other dates and times are in local time.
Was this helpful?

Please log in to post comments.