HRENAME

Rename an HDS data object

Description:

The object is renamed.

Note that if INP is specified only as a container filename, the name of the top-level object contained will be changed but not the name of the file.

If the new name is too long, DAT__TRUNC is reported and a new value requested.

Usage:

hrename inp to

Parameters:

INP = UNIV (Read)
The object to be renamed.
TO = _CHAR (Read)
The new name - must be a valid HDS component name (not a pathname).

Examples:

% rename cfile.structure.data array
Component STRUCTURE.DATA becomes STRUCTURE.ARRAY
% rename cfile container
The top-level component of container file cfile.sdf (probably named CFILE) is renamed to CONTAINER

Method

Uses subroutine DAT_RENAME.