Creation
+--------------------------------------------------------------------+
| CALL CDMDIR (PATH,NKEYS,CHFOR,CHTAG,MAXOBJ,IPREC,DELTA,CHOPT,IRC*) |
+--------------------------------------------------------------------+
- PATH
- Character string specifying the path name to be
created
- NKEYS
- Integer variable specifying the number of user
keys, if any. The directory will automatically be created with the
standard keys (system keys, experiment keys and the number of validity
range pairs as specified when the database was created).
- CHFOR
- Character string specifying the user key type,
as for the routine RZMDIR
- CHTAG
- Character array of significant length NKEYS
containing the tags for the user keys
- MAXOBJ
- Integer variable specifying the maximum number
of objects to be stored in each partition of a partioned directory
- IPREC
- Precision word specifying the number of
significant digits to be stored (which may be zero). If IPREC is negative,
then it specifies the number of digits to the left of the decimal point to
retain.
- DELTA
- Variable specifying the absolute value below
which data is treated as zero
- CHOPT
-
- ' '
- Default - non-partitioned directory
- 'C'
- Data in this directory will be compressed by
default
- 'P'
- Create partitioned directories
- IRC
- Integer return code
- 0
- Normal completion
- 43
- Illegal number of user keys
This routine creates directories in a database and sets various directory
constants.
Conversion
+--------------------------------------------+
|CALL CDPART (PATHI,PATHO,MXPART,CHOPT,IRC*) |
+--------------------------------------------+
- PATHI
- Character string describing the input pathname
- PATHO
- Character string describing the output pathname
- MXPART
- Maximum number of objects in each partition
- CHOPT
- Character string
- IRC
- Integer return code
- 0
- Normal completion
- 68
- Input directory is already partitioned
- 71
- Illegal path name
- 73
- RZOUT fails to write on disk
- 74
- Error in RZRENK in updating key values for data
set
- 75
- Cannot find the Top directory name in pathname
- 76
- Cannot form the IO descriptor for the FZ header
- 77
- FZOUT fails to write on to the sequential file
Transforms the contents of a non-partitioned directory to a partitioned
directory.
Deletion
+------------------------------+
|CALL CDDDIR (PATH,CHOPT,IRC*) |
+------------------------------+
- PATH
- Character string specifying the path name to be
deleted
- CHOPT
- Character variable specifying the options
required.
- IRC
- Integer return code
- 0
- Normal completion
- 171
- Illegal Path name
- 172
- Cannot find the top directory for the path name
- 173
- Error in RZ for reading the dictionary object
- 174
- Error in FZOUT for saving the journal file
- 175
- Error in RZ in writing the dictionary object
- 176
- Error in RZ in purging the dictionary directory
- 177
- Error in RZ in deleting the tree
Deleting partitions from a partitioned directory
+------------------------------------+
|CALL CDPURP (PATH,NKEEP,CHOPT,IRC*) |
+------------------------------------+
- PATH
- Character array specifying the path names of the
directory tree to be purged.
- NKEEP
- Integer variable specifying the number of
partitions to keep. Only the last NKEEP partitions will be kept.
- CHOPT
- Character variable specifying the options
required.
- IRC
- Integer return code
- 0
- Normal completion
- 69
- Input directory is not partitioned
- 70
- Error in deleting a partition
- 71
- Illegal path name
- 73
- RZOUT fails to write on disk
- 74
- Error in RZRENK in updating key values for
partitioned data set
- 75
- Cannot find the Top directory name in pathname
- 77
- FZOUT fails to write on to the sequential file
This routine can be used to delete partitions from a partitioned
directory. Only the last NKEEP partitions will be kept.
Deleting multiple directory trees
+------------------------------------+
|CALL CDKEEP (PATH,NPATH,CHOPT,IRC*) |
+------------------------------------+
- PATH
- Character array specifying the path names of the
directory trees to be kept. All directory trees that are not in this list
will be deleted.
- NPATH
- Integer variable specifying the number of path
names in the character array PATH.
- CHOPT
- Character variable specifying the options
required.
- IRC
- Integer return code
- 0
- Normal completion
- 69
- Input directory is not partitioned
- 70
- Error in deleting a partition
- 71
- Illegal path name
- 73
- RZOUT fails to write on disk
- 74
- Error in RZRENK in updating key values for
partitioned data set
- 75
- Cannot find the Top directory name in pathname
- 77
- FZOUT fails to write on to the sequential file
This routine can be used to delete all bar the specified directory trees
from a database.