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
- データ・セットのエクステントを表示します。
- 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
- リストの表示 (デフォルト)。
- リストの印刷。
- 要約
- 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
/*