CREATE VOLUMEENTRY Examples. IBM z/OS Version 2 Release 3

CREATE VOLUMEENTRY

NOWRITEPROTECT

indicates that the tape volume is not write protected.

Abbreviation:

NWPRT

CREATE VOLUMEENTRY Examples

Creating a Tape Volume Entry: Example 1

This example creates a tape library entry for a tape volume with volume serial number AL0001.

//CREATVOL JOB ...

//STEP1 EXEC PGM=IDCAMS

//SYSPRINT DD SYSOUT=A

//SYSIN DD *

CREATE VOLUMEENTRY -

(NAME(VAL0001) -

LIBRARYNAME(ATLLIB1) -

STORAGEGROUP(*SCRTCH*) -

USEATTRIBUTE(SCRATCH) -

NOWRITEPROTECT -

LOCATION(LIBRARY) -

SHELFLOCATION(10098SHELF) -

OWNERINFORMATION(’JOHN SMITH,RMKD222’) -

ENTEREJECTDATE(2002-03-18) -

EXPIRATIONDATE(2010-12-31) -

WRITEDATE(2004-01-02) -

MOUNTDATE(2004-01-02))

/*

The parameters are: v VOLUMEENTRY creates a tape volume entry in a tape library.

v NAME names the tape volume entry, VAL0001 (‘V’ concatenated with volume serial number AL0001).

v LIBRARYNAME adds this tape volume to the tape library named ATLLIB1.

v STORAGEGROUP names the storage group *SCRTCH* (default name when

USEATTRIBUTE=SCRATCH).

v USEATTRIBUTE specifies the tape volume as SCRATCH.

v NOWRITEPROTECT identifies the tape volume as not write protected.

v LOCATION specifies that the tape volume will reside in the tape library.

v

SHELFLOCATION gives 10098SHELF as the shelf location.

v OWNERINFORMATION gives JOHN SMITH,RMKD222 for owner information.

v ENTEREJECTDATE is the date on which the tape volume was last entered into, or ejected from, the tape library named ATLLIB1.

v EXPIRATIONDATE is the date on which the tape volume expires.

v WRITEDATE is the date when the tape volume was last written to.

v MOUNTDATE is the date when the tape volume was last mounted onto a tape drive.

Creating a VOLUME Entry: Example 2

This example creates a volume entry for volume 0A2991.

//CREATVOL JOB ...

//STEP1 EXEC PGM=IDCAMS

//SYSPRINT DD SYSOUT=A

//SYSIN DD *

CREATE VOLUMEENTRY(V0A2991)-

Chapter 10. CREATE VOLUMEENTRY

115

CREATE VOLUMEENTRY

(NAME(V0A2991)

LIBRARYNAME(ATLIB02) -

-

LOCATION(LIBRARY) -

USEATTRIBUTE(SCRATCH) -

MEDIATYPE(MEDIA7)

RECORDING(EFMT1))

-

The parameters used in this example are as follows: v CREATE VOLUMEENTRY indicates that an entry describing a single volume in a library is being created.

v V0A2991 specifies that the name of the volume entry being created is V0A2991 and the volser is 0A2991.

v LIBRARYNAME specifies that the name of the library with which this volume record is associated is ATLIB02.

v LOCATION when LIBRARYNAME is specified, location must also be set as

LIBRARY, otherwise it will default to SHELF.

v USEATTRIBUTE identifies the volume as being a SCRATCH tape.

v MEDIATYPE specifies the media type as MEDIA7.

v RECORDING specifies the recording technology as EFMT1.

116

z/OS DFSMS Access Method Services Commands

Chapter 11. DCOLLECT

The DFSMS Data Collection Facility (DCOLLECT) is a function of access method services. DCOLLECT collects stored data set, volume and policy values into a sequential file you can use as input to other programs or applications.

Note:

There is a Report Generator option in the ISMF Storage Administrator primary panel 'G' Report Generator that can be used to create reports based on the sequential file contents that DCOLLECT produces. The report generator ships sample report types for DCOLLECT, both DFSMSdfp and DFSMShsm DCOLLECT record types. In addition, it will ship some sample reports based on those.

DCOLLECT obtains data on: v Active Data Sets

DCOLLECT provides data about space use and data set attributes and indicators on the selected volumes and storage groups.

v VSAM Data Set Information

DCOLLECT provides specific information relating to VSAM data sets residing on the selected volumes and storage groups.

v Volumes

DCOLLECT provides statistics and information on volumes that are selected for collection.

v

Inactive Data

DCOLLECT produces output for DFSMShsm-managed data, (inactive data management), which includes both migrated and backed up data sets.

– Migrated Data Sets: DCOLLECT provides information on space utilization and data set attributes for data sets migrated by DFSMShsm.

– Backed Up Data Sets: DCOLLECT provides information on space utilization and data set attributes for every version of a data set backed up by

DFSMShsm.

v Capacity Planning

Capacity planning for DFSMShsm-managed data (inactive data management) includes the collection of both DASD and tape capacity planning.

– DASD Capacity Planning: DCOLLECT provides information and statistics for volumes managed by DFSMShsm (ML0 and ML1).

– Tape Capacity Planning: DCOLLECT provides statistics for tapes managed by

DFSMShsm.

v SMS Configuration Information

DCOLLECT provides information about the SMS configurations. The information can be from either an active control data set (ACDS) or a source control data set (SCDS), or the active configuration.

DCOLLECT provides attributes that are in the selected configuration for the following:

– Data Class Constructs

– Storage Class Constructs

– Management Class Constructs

– Storage Group Constructs

– SMS Volume Information

– SMS Base Configuration Information

© Copyright IBM Corp. 1973, 2017

117

DCOLLECT

– Aggregate Group Construct Information

– Optical Drive Information

– Optical Library Information

– Cache Names

– Accounting Information for the ACS routines

Restriction:

Use the DCOLLECT command only with volumes that contain an

MVS VTOC. If you use the DCOLLECT command with volumes that contain a VM

VTOC, the DCOLLECT command fails and error message IDC21804I is displayed.

For information on calling DCOLLECT from ISMF, see z/OS DFSMSdfp Storage

Administration. For information on using DCOLLECT to monitor space usage, see

Using the data collection application in z/OS DFSMSdfp Storage Administration.

The syntax of the DCOLLECT command is:

Command

DCOLLECT

Parameters

{OUTFILE(

ddname)|

OUTDATASET(

entryname)}

{[VOLUMES(

volser[ volser...])]

[BACKUPDATA]

[CAPPLANDATA]

[EXCLUDEVOLUMES(

volser[ volser...])]

[MIGRATEDATA]

[SMSDATA(SCDSNAME(

entryname)|ACTIVE)]

[STORAGEGROUP(

sgname[ sgname...])]}

[DDCMEDIA{DDCMENUL|DDCMEDA1|DDCMEDA2|

DDCMEDA3|DDCMEDA4|DDCMEDA5|DDCMEDA6|

DDCMEDA7|DDCMEDA8|DDCMEDA9|DDCMEDA10|

DDCMED11|DDCMED12|DDCMED13}]

[DDCRECTE{DDCRTNUL|DDC18TRK|DDC36TRK|

DDC128TK|DDC256TK|DDC384TK|DDCEFMT1|DDCEFMT2|

DDCEFMT2|DDCEFMT3|DDCEFMT4|DDCEEFM3|DDCEEFM4}]

[ERRORLIMIT(

value)]

[EXITNAME(

entrypoint)]

[MIGRSNAPALL|MIGRSNAPERR]

[NODATAINFO]

[NOVOLUMEINFO]

[REPLACE|APPEND]

DCOLLECT can be abbreviated: DCOL

Exception:

Although BACKUPDATA, CAPPLANDATA, MIGRATEDATA,

SMSDATA, STORAGEGROUP, and VOLUMES are designated as optional parameters, you must use at least one of them. You can use any combination of these parameters; use at least one.

DCOLLECT User Exit:

For a description of the DCOLLECT User Exit, refer to Appendix E,

“DCOLLECT User Exit,” on page 473.

DCOLLECT Output

For an explanation of how to interpret DCOLLECT output, see Appendix F,

“Interpreting DCOLLECT Output,” on page 479.

118

z/OS DFSMS Access Method Services Commands