DVT (VTOC の表示)

目的
ディスク・ボリューム上のデータ・セットのリスト (ディスク VTOC から入手) を、表示または印刷します。
使用上の注意
この機能を使用して、ディスク・ボリューム上のデータ・セットおよびフリー・スペースについての情報を表示または印刷します。この情報はディスク VTOC から入手されます。リストの中で、前後へスクロールしたり、代替表示を選択したり、特定のデータ・セット名を探し出すことができます。このリストを印刷できます。

情報をいずれか任意の基準でソートできます (下記の DVT 機能の変数 sortdsnby についての説明を参照してください)。このリストでは、さらにディスク上の空いているエクステントについても示します。

あるいは、「Work with VTOC (VTOC の操作)」: ボリュームのリスト に示すものと同様の、VTOC 要約のみの作成を要求することもできます。要約リストをいずれか任意の基準でソートできます (下記の DVT 機能の変数 sortvolby についての説明を参照してください)。

また、データ・セットと要約リストの複合報告書の作成を要求できます。

注: DVT は、99/999 および 99/366 という有効期限をそれぞれ 9999.999 および 9999.366 として、「有効期限切れのない」ことを示します。また、明示的に 99/365 として指定された有効期限も、「決して有効期限が切れることはなく」、9999.365 として表示されます。ただし、指定された保存期間から計算された 99/365 (現在日付 + 日数 = 99/365) という有効期限は、有効期限が切れることになり、1999.365 として表示されます。リストを有効期限順にソートすると、9999 で始まる値が最初に現れます。
オプション
完全修飾ファイル ID または汎用ファイル ID、あるいは検索パターンを使用して、出力を制限します。項目名、作成日、有効期限、あるいはディスク・エクステントによって、リストをソートすることができます。
戻りコード
DVT 機能からのデフォルトの戻りコードには、変更された以下の意味があります。
4
データ・セットが見つかりませんでした。
4
選択したボリュームのパターンに一致するデータ・セットはありません。
4
パターンに一致するボリュームはありません。
16
ボリュームがマウントされていません。
16
ストレージ不足です。
16
DVT が異常終了しました。
16
処理を停止するその他の重大なエラー (入出力エラーなど) が発生しました。
注: インストール時に、戻りコードをカスタマイズすることができます。上に示したもの以外の戻りコードを受け取った場合には、ご使用のサイトでこの機能用に戻りコードをカスタマイズしている可能性があります。バッチの戻りコードが ABENDCC 値以上であると、File Manager が 999 異常終了を発行する場合もあります。詳しくは、File Manager システム管理者にお問い合わせください。
関連機能
DSX
データ・セットのエクステントを表示します。
図 1. Syntax

1 DVT VOLSER=volser
1! DSNAME=**
1 DSNAME=dsnmask
1! SMSGROUP=*
1 SMSGROUP=smsgroupmask
1! UNIT=*
1 UNIT=unit
1! DEVTYPE=*
1 DEVTYPE=devtype
1! VOLSTATE=*
1 VOLSTATE=volstate
1! LIMIT=0
1 LIMIT=limit
1  COMBINE=NO
2.1 SUMMARY=NO
2.1  SORTDSNBY=sortdsnby
2.1 SUMMARY=YES?LIMITED=
2.2.1! NO
2.2.1 YES
2.1  SORTVOLBY=sortvolby
1  COMBINE=YES SORTDSNBY=sortdsnby SORTVOLBY=sortvolby
1!  FUNCTION = LIST
1 FUNCTION=function
1! DSNREPEAT=NO
1 DSNREPEAT=YES
1! DATEFORM=YYDD
1 DATEFORM=YYMMDD
volser
ディスクのボリューム通し番号。% 記号で 1 文字分を表すか、アスタリスク (*) で任意の数の文字 (または、文字なし) を表す「ボリューム・マスク」を含めることができます。マスクと一致するボリュームのみが処理に関与します。
dsnmask
総称データ・セット名または検索パターン。データ・セット名の中で、パーセント記号 (%) で 1 文字分を表し、アスタリスク (*) で 1 つの修飾子内の任意の数の文字 (または文字なし) を表し、2 つのアスタリスク (**) で任意の数の修飾子内の任意の数の文字 (または文字なし) を表すことができます。デフォルトは ** です。

volser で「ボリューム・マスク」も指定する場合、dsnmask と一致するデータ・セットを持つボリュームのみが処理に関与します。

バッチ・モードを除くいずれのモードでも、ユーザーの TSO 接頭部 (通常は、ユーザー ID) が、引用符で入力されなかったすべての名前の高位修飾子として使用されます。例えば、デフォルトの ** では、バッチ・モードではすべての項目をリストしますが、その他のモードでは、高位修飾子としてユーザーの TSO 接頭部を持つすべての項目をリストします。

smsgroupmask
総称 SMS ストレージ・グループ名または検索パターン。名前には、1 文字分を表すパーセント記号 (%)、任意数の文字列 (または文字なし) を表すアスタリスク (*) を含めることができます。
ユニット
汎用装置アドレスまたは検索パターン。アドレスには、1 文字分を表すパーセント記号 (%)、任意数の文字列 (または文字なし) を表すアスタリスク (*) を含めることができます。
devtype
汎用装置タイプ名または検索パターン。名前には、1 文字分を表すパーセント記号 (%)、任意数の文字列 (または文字なし) を表すアスタリスク (*) を含めることができます。
volstate
総称ボリューム状況名または検索パターン。名前には、1 文字分を表すパーセント記号 (%)、任意数の文字列 (または文字なし) を表すアスタリスク (*) を含めることができます。
以下の絶対パス名がサポートされています。
  • PRIVATE (PRIV/RSDNT も含む)
  • RESIDENT
  • PUBLIC
  • STORAGE
  • ALL
limit
処理に選択されるデータ・セットの最大数。デフォルト (0) は、選択されるデータ・セット数に制限がないことを示します。
関数
実行したいコマンド。
LIST
リストの表示 (デフォルト)。
PRINT
リストの印刷。
要約
VTOC リストを全体または要約として印刷するかどうかを決めます。
NO
(デフォルト) 全リストが印刷されます。
YES
要約が印刷されて、SORTBY パラメーターは無視されます。リストは装置番号でソートされます。
LIMITED
ボリューム要約リスト (SUMMARY=YES) に、処理されたボリューム上のデータ・セット数に関する詳細データ (NO) を含めるのか、限定されたデータ (YES) を含めるのかを決定します。LIMITED=YES を指定すると、応答時間が短くなります。
NO
ボリューム要約リストにデータ・セットの詳細情報を含めます。
YES
ボリューム要約リストにデータ・セット数を含めません。
sortdsnby
VTOC データ・セット・リストが表示される順序を決定します。
名前
データ・セット名を基準にソートされます。
VOLSER
ボリューム通し番号を基準にソートされます。
EXTENT
エクステントを基準にソートされます。
SIZE
データ・セット・サイズを基準にソートされます。
タイプ
DSORG を基準にソートされます。
RECFM
RECFM を基準にソートされます。
LRECL
LRECL を基準にソートされます。
BLKSIZE
BLKSIZE を基準にソートされます。
DATE
作成日を基準にソートされます。
EDATE
有効期限を基準にソートされます。
RDATE
最後に参照された日付を基準にソートされます。
sortvolby
VTOC ボリューム・リストが表示される順序を決定します。
VOLSER
ボリューム通し番号を基準にソートされます。
UNIT
装置アドレス (装置) を基準にソートされます。
DTYPE
装置タイプを基準にソートされます。
SMSSG
SMS ストレージ・グループを基準にソートされます。
TTTRK
ディスク容量を基準にソートされます。
USTRK
使用されたトラックを基準にソートされます。
USPTRK
使用率 (%) を基準にソートされます。
TRKF
使用可能なトラックを基準にソートされます。
TDSN
データ・セット数を基準にソートされます。
TVSDSN
VSAM データ・セット数を基準にソートされます。
TNVSDSN
非 VSAM データ・セット数を基準にソートされます。
SVTOC
VTOC サイズを基準にソートされます。
UPVTOC
VTOC の使用率 (%) を基準にソートされます。
INDX
VTOC 索引付けを基準にソートされます。
DSCBS
VTOC 空き DSCB を基準にソートされます。
FCYL
使用可能なシリンダーを基準にソートされます。
MFCYL
シリンダー単位の最大フリー・スペースを基準にソートされます。
FTRK
使用可能なトラックを基準にソートされます。
MFTRK
トラック単位の最大フリー・スペースを基準にソートされます。
COMBINE
データ・セットとボリューム要約リストの複合報告書を作成するかどうかを決定します。
NO
データ・セットとボリューム要約リストの複合報告書を作成しません。
YES
データ・セットとボリューム要約リストの複合報告書を作成します。
DSNREPEAT
データ・セットとボリューム要約リストの複合報告書を作成するかどうかを決定します。
NO
2 番目以降のエクステントでデータ・セット名を抑制します。
YES
各エクステントでデータ・セット名が表示されます。
DATEFORM
日付フィールドの表示形式を決定します。
YYDD
日付形式 YYYY.DDD を使用します。
YYMMDD
日付形式 YY/MM/DD を使用します。
//DVT JOB (acct),'name'  Display VTOC
//*
//FMBAT    PROC
//FMBAT    EXEC PGM=FILEMGR
//STEPLIB  DD DSN=FMN.SFMNMOD1,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//         PEND
//*
//FILEMGR  EXEC FMBAT
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
$$FILEM DVT VOLSER=SCPMV5,DSNAME=**,SORTBY=DATE
$$FILEM EOJ
/*