LD$HELP.HLB  —  LD  CREATE
   LD CREATE filespec

 	This command will create a file which can be used as a Logical Disk.
 	The default extension is ".DSK". The file will be set /NOMOVE and
 	/CACHING_ATTRIBUTE=NO_CACHING.

 	If the command is used with tapes (LM) then the newly created containerfile
 	will automatically contain tape metadata like username, creation time etc.
 	which can be displayed with LM SHOW/FULL.

1    /BACKUP

  /BACKUP (default)
  /NOBACKUP

 	This qualifier can be used to mark the file /NOBACKUP. In
 	that case when a backup of the file is done only the file-
 	header will be copied. On a restore the file will be re-
 	created, and all data will be lost.

2    /CLONE

  /CLONE=device

 	Allows size and geometry to be cloned from the specified device. This
 	device has to be mounted for this to function. The geometry will
 	automatically be saved in the containerfile.

3    /CONTIGUOUS

  /CONTIGUOUS
  /NOCONTIGUOUS (default)

 	This qualifier can be used to create the container file contiguous.

4    /CYLINDERS

  /CYLINDERS=number_of_cylinders

 	When this qualifier is specified the device will be created with the
 	specified number of cylinders. If not specified, and no /TRACKS
 	and /SECTORS switches are specified, then the device geometry will
 	be calculated by the driver. If it is specified then any other geometry
 	switch will default to 1 when not specified.

 	The maximum number of cylinders is 65535.

 	If SECTORS * TRACKS * CYLINDERS is less than the capacity of the
 	containerfile an error message will be issued.

 	This setting will be stored in the containerfile as metadata (in the
 	fileheader), and if present will be used when the container file is
 	connected (unless /NOAUTOGEOMETRY is specified).

5    /ERASE

  /ERASE

 	This qualifier will erase the contents of the container file. For a
 	new file all blocks will be erased, if this qualifier is used in
 	combination with /EXTEND then only the extension of the file will
 	be erased, so the original contents will be preserved in that case.

 	This can be useful if a non-privileged user creates a container file,
 	and at certain blocks on disk is data which resembles blocks recognized
 	by INIT preventing initializing due to lack of VOLPRO privilege.

 	This qualifier is ignored when the container file is placed on a volume
 	with active highwater marking as the filesystem will take care of the
 	erasure in that case.

6    /EXTEND

  /EXTEND

 	This qualifier allows for extension of an existing container file.
 	Specify /SIZE=xxx to set the number of blocks to extend the current
 	file to.

7    /LBN

  /LBN=nnn

 	Allows placement of the containerfile on a specific LBN. If that LBN
 	is not available an error will be returned. Notice that when
 	/CONTIGUOUS is not specified and the request succeeds the file may be
 	split in multiple segments at the discretion of the XQP, in that case
 	only the first part of the file will be on the specified LBN.

8    /LOG

  /LOG
  /NOLOG (default)

 	Shows the complete filespec of the created file after file
 	creation.

9    /MAXBLOCKS

  /MAXBLOCKS=number_of_block

 	When this qualifier is specified the specified number of blocks
 	will be the maximum used for the device. It may not be bigger than
 	the allocated size of the container file.

 	This setting will be stored in the containerfile as metadata (in the
 	fileheader), and if present will be used when the container file is
 	connected (unless /NOAUTOGEOMETRY is specified).

10    /SECTORS

  /SECTORS=number_of_sectors

 	When this qualifier is specified the device will be created with the
 	specified number of sectors. If not specified, and no /CYLINDERS
 	and /TRACKS switches are specified, then the device geometry will
 	be calculated by the driver. If it is specified then any other geometry
 	switch will default to 1 when not specified.

 	The maximum number of sectors is 255.

 	If SECTORS * TRACKS * CYLINDERS is less than the capacity of the
 	containerfile an error message will be issued.

 	This setting will be stored in the containerfile as metadata (in the
 	fileheader), and if present will be used when the container file is
 	connected (unless /NOAUTOGEOMETRY is specified).

11    /SIZE

  /SIZE[=disksize]

 	Specifies the size of the logical disk file. The default size
 	is 512 blocks.

12    /TRACKS

  /TRACKS=number_of_tracks

 	When this qualifier is specified the device will be created with the
 	specified number of tracks. If not specified, and no /CYLINDERS
 	and /SECTORS switches are specified, then the device geometry will
 	be calculated by the driver. If it is specified then any other geometry
 	switch will default to 1 when not specified.

 	The maximum number of tracks is 255.

 	If SECTORS * TRACKS * CYLINDERS is less than the capacity of the
 	containerfile an error message will be issued.

 	This setting will be stored in the containerfile as metadata (in the
 	fileheader), and if present will be used when the container file is
 	connected (unless /NOAUTOGEOMETRY is specified).
Close Help