Use the FILE device class when you are using files on magnetic disk storage as volumes that store data sequentially (as on tape).
The FILE device class does not support EXTERNAL libraries.
The FILE device class does not support EXTERNAL or Remote Storage Manager libraries.
If you are defining a device class for devices that are to be accessed through a z/OS® media server, see DEFINE DEVCLASS (Define a FILE device class for z/OS media server).
To issue this command, you must have system privilege or unrestricted storage privilege.
>>-DEFine DEVclass--device_class_name--DEVType--=--FILE---------> .-MOUNTLimit--=--20-----. .-MAXCAPacity--=--10G--. >--+-----------------------+--+----------------------+----------> '-MOUNTLimit--=--number-' '-MAXCAPacity--=--size-' .-DIRectory--=--current_directory_name-. >--+--------------------------------------+---------------------> | .-,--------------. | | V | | '-DIRectory--=----directory_name-+-----' .-SHAREd--=--No------. >--+--------------------+-------------------------------------->< '-SHAREd--=--+-No--+-' '-Yes-'
A file is a form of sequential-access media.
If the device class is shared with a storage agent (by specifying the SHARED=YES parameter), drives are defined or deleted to match the mount limit value.
If you plan to use the simultaneous-write function, ensure that sufficient drives are available for the write operation. If the number of drives needed for a simultaneous-write operation is greater than the value of the MOUNTLIMIT parameter for a device class, the transaction fails.
The value of the MAXCAPACITY parameter is also used as the unit of allocation when storage pool space triggers create volumes. The default value is 10 GB (MAXCAPACITY=10G). The value that is specified must be less than or equal to the maximum supported size of a file on the target file system.
Specify this value as an integer followed by K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). The minimum size is 1 MB (MAXCAPACITY=1M). If you are defining a FILE device class for database-backup volumes, specify a value for MAXCAPACITY that is appropriate for the size of the database and that minimizes the number of database volumes.
Do not define a MAXCAPACITY value greater than 640M when this file is for REMOVABLEFILE CD support. A value less than a CD's usable space (650 MB) enables a one-to-one match between files from the FILE device class and copies that are on CD.
This parameter is optional.
The default is the current working directory of the server at the time the command is issued.
The default is the current working directory of the server at the time the command is issued. Windows registry information is used to determine the default directory.
By specifying a directory name or names, you identify the location where the server places the files that represent storage volumes for this device class.
For NetApp SnapLock support (storage pools with RECLAMATIONTYPE=SNAPLOCK, which are going to use this device class), the directory, or directories that are specified with DIRECTORY parameter must point to the directory or directories on the NetApp SnapLock volumes.
While the command is processed, the server expands the specified directory name or names into their fully qualified forms, starting from the root directory.
If the server must allocate a scratch volume, it creates a new file in one of these directories. (The server can choose any of the directories in which to create new scratch volumes.) For scratch volumes used to store client data, the file that is created by the server has a file name extension of .bfs. For scratch volumes used to store export data, a file name extension of .exp is used.
For example, if you define a device class with a directory of tsmstor and the server needs a scratch volume in this device class to store export data, the file that the server creates might be named ⁄tsmstor⁄00566497.exp.
For example, if you define a device class with a directory of c:\server and the server needs a scratch volume in this device class to store export data, the file that the server creates might be named c:\server\00566497.exp.
For information about prerequisites when storage is shared by the server and storage agent, see http://www.ibm.com/support/entry/portal/Overview/Software/Tivoli/Tivoli_Storage_Manager.
Define a device class that specifies multiple directories.
define devclass multidir devtype=file
directory=/usr/xyz,/usr/abc,/usr/uvw
define devclass multidir devtype=file
directory=/opt/xyz,/opt/abc,/opt/uvw
define devclass multidir devtype=file
directory=e:\xyz,f:\abc,g:\uvw
define devclass plainfiles devtype=file
maxcapacity=50m