DTOUCH(1)


NAME

dtouch - Create an empty dataset.


SYNOPSIS

dtouch [-adhv] [-r <record format>] [-t <dataset type>] ... <dataset name>

dtouch [-adhv]
  [-B<block size>]
  [-b<directory blocks>]
  [-c<storage class name>]
  [-D<data class name>]
  [-e<secondary space>]
  [-F<space format>]
  [-k<key length>:<key offset>]
  [-l<logical record length>]
  [-m<management class name>]
  [-r<record format>]
  [-s<primary space>]
  [-t<dataset type>]
  [-V<volumes>]
  <dataset name>

-a
  Verbose allocation output.

-B <block size>
  <block size> is the block size of the dataset.
  Default is 80 for record format F,
  32718 for FBA,
  32720 for FB and FBS,
  32743 for VBA,
  32760 for VB and VBS,
  0 for U.

-b <directory blocks>
  <directory_blocks> is the number of directory blocks for a PDS.
  Optional parameter for PDS datasets
  Default is 5.

-c <storage class name>
  <storage class name> is the storage class for an SMS-managed dataset.
  Required for SMS-managed datasets that do not match an SMS-rule.
  Not valid for datasets that are not SMS-managed.
  Note that all non-linear VSAM datasets are SMS-managed.

-D <data class name>
  <data class name> is the data class for an SMS-managed dataset.
  Optional for SMS-managed datasets that do not match an SMS-rule.
  Not valid for datasets that are not SMS-managed.
  Note that all non-linear VSAM datasets are SMS-managed.

-d
  Print debug messages.

-e <secondary space>
  <secondary space> is the amount of secondary space to allocate for the
  dataset.
  Size of extents. Defaults to 1/10 of primary space.
  Size may include a suffix of K or KB (kilobytes), M or MB (megabytes),
  G or GB (gigabytes), C or CYL (cylinders), T or TRK (tracks).

-F <space format>
  <space format> is the format of allocated space to use when allocating
  the dataset.
  May be one of:
    ALX - Different areas of contiguous space are to be allocated.
    MXIG - Maximum contiguous space is required.
    CONTIG - Space must be contiguous.

-h
  Print out syntax.

-k <key length>:<key offset>
  Required for Key Sequenced Datasets (KSDS).

-l <logical record length>
  <logical record length> is expressed in bytes
  Default is 80 for fixed datasets (F, FB, FBS),
  133 for format FBA,
  137 for variable datasets (VB, VBA, VBS)
  0 for unformatted datasets (U)
  For variable datasets, the length must include the 4-byte prefix area.

-m <management class name>
  <management class name> is the management class for an SMS-managed dataset.
  Optional for SMS-managed datasets that do not match an SMS-rule.
  Not valid for datasets that are not SMS-managed.
  Note that all non-linear VSAM datasets are SMS-managed.

-r <record format>
  <record format> is one of F, FB, VB, FBA, VBA, U, FBS, VBS.
  Default is FB.

-s <primary space>
  <primary space> is the amount of primary space to allocate for the dataset.
  Default is 5M.
  Size may include a suffix of K or KB (kilobytes), M or MB (megabytes),
  G or GB (gigabytes), C or CYL (cylinders), T or TRK (tracks).

-t <dataset type>
  <dataset type> may be one of: KSDS, ESDS, RRDS, LDS, SEQ, LARGE, PDS,
  PDSE, HFS. Default is PDSE.

-V <volumes>
  <volumes> is a list of comma separated volume serials.
  When providing multiple volumes, processing will begin with
  the first volume in the provided list. Offline volumes are not considered.
  Volumes can always be provided when not using SMS.
  When using SMS, volumes can be provided when the storage class being used
  has GUARANTEED_SPACE=YES specified. Otherwise, the allocation will fail.

-v
  Verbose name output.

<dataset name>
  Name of the dataset to allocate.


DESCRIPTION

dtouch allocates a partitioned dataset, partitioned dataset extended, sequential dataset, or VSAM dataset. dtouch is analogous to touch, except it creates datasets instead of files.


EXAMPLES

Allocate an FB 80 PDSE with a primary size of 5M named IBMUSER.DATASET:

dtouch ibmuser.dataset


Allocate an FB 80 sequential dataset with a primary size of 5M named TSTRADM.MY.TEXT:

dtouch -tseq tstradm.my.seq


Allocate an FB 80 sequential dataset with a primary size of 5M named TSTRADM.MY.TEXT on volumes 000000, VOL002, and VOL003:

dtouch -tseq -V000000,vol002,vol003 tstradm.my.seq


Allocate a VSAM KSDS file with a 3 byte primary key starting in column 4 called IBMUSER.DATA.FILE in data class MYDATA:

dtouch -tksds -k3:4 -cmydata ibmuser.data.file


Allocate a VB 136 PDS with a primary size of 400K called IBMUSER.MY.LISTING. This file will have 132 characters of text per record:

dtouch -tpds -rvb -l136 -s400k ibmuser.my.listing


EXIT VALUES

0
    dtouch completed without error.

non-zero
    Errors occurred. See error messages for details.