MemCom Reference Manual > MemCom (Old) Fortran77 API > Database Manager Functions > rendb

Name

rendb — Rename dataset

Synopsis

subroutine rendb(handle,old,new,status)
integer*4 handle
character*(*) old
character*(*) new
integer*4 status

Description

rendb renames a dataset without altering its contents and position on the database.

Parameters

handle

Database handle (input). The file handle handle may not exceed the maximum number of simultaneously open databases.

old

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

new

New name of 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. See MemCom error codes.