MemCom Reference Manual > MemCom ftn Fortran API > Database Manager (DB) > mcf_db_rename_set

Name

mcf_db_rename_set — Rename dataset (Fortran API)

Synopsis

 
subroutine mcf_db_rename_set(handle,nameo,namen,status)

integer*4 handle
character*(*) nameo
character*(*) namen
integer*4 status

Description

mcf_db_rename_set renames a dataset on the database file identified by handle.

Parameters

handle

Handle of database file on which the set(s) reside (input).

nameo

Name of dataset to be renamed (input). The string may not exceed the maximum dataset name length.

namen

Name of renamed dataset (input). The string may not exceed the maximum dataset name length.

status

Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued.