next up previous contents index
Next: HEPDB tutorial Up: Using the HEPDB Previous: Termination

Other HEPDB facilities

In this section a few other user callable subroutines of general interest are mentioned, as well as some additional facilities which extend the functionality of the HEPDB package and make it more user friendly.

Print and trace-back

The user can print the contents of a directory with the routine CDLDIR, only the keys with the option 'K' (keys), or both the data and the keys with the option 'D' (data).

The user can print the summary of data base usage through the routine CDSTAT. The summary consists of the numbers of calls to CDUSE and actual disk accesses, for each set of user key values.

Information on the data objects used in a given program execution can be obtained through the routine CDRINFO.

Time related routines

Two sets of routines are available to pack/unpack the date and time to/from one single word - the routines CDPKTM and CDUPTM for times accurate to one minute and CDPKTS and CDUPTS when one second accuracy is required.

The maximum of the start validity and the minimum of the end validity of all data base objects used in a given program execution can be obtained through the routine CDVALID.

The insertion time of the last inserted object in a given directory can be enquired through the routine CDLKEY, and the time when a directory has been last modified, through the routine CDLMOD.

Purging operations

With the automatic updating mode, deleting data objects from a given directory is rather critical, because of the possibility of deleting a master object and leaving alive its updated version(s). Therefore, any direct call to RZ deletion routines should be avoided. The operation can be taken care of by the routines CDPURK and CDPURG. The latter provides a wide range of actions through a number of character options, while CDPURK can be used to purge data objects with selection on user keys like CDUSE.

The user can delete a complete tree of directory starting from a given node, using the routine CDDELT. In the situation where a normal directory has been 'a posteriori' partitioned, through the use of CDPART, the user should call CDDELT to delete the original directory.

With the routine CDPURGP, it is possible to delete all but the last few partitions, as specified by the user, from a partitioned directory.

The user can delete all but a few directory trees from the data base using the routine CDKEEP.



next up previous contents index
Next: HEPDB tutorial Up: Using the HEPDB Previous: Termination


Janne Saarela
Tue May 16 10:31:09 METDST 1995