RENAME PROCEDURE command

From m204wiki
Jump to: navigation, search

Summary

Privileges
File manager
Function
Changes the name of a procedure

Syntax

RENAME [PROCEDURE] old-procname, new-procname

Where:

old-procname and new- procname are procedure names. When the command is executed, the new procname becomes the official name of the procedure.

If PROCEDURE is omitted, Model 204 assumes that a procedure is being renamed.

Syntax notes

The comma is required.

RENAME PROCEDURE cannot be issued from within a procedure.

Example

RENAME PROC NEW EMPLOYEE, EMP RENAME AUDIT, OLDAUDIT

Usage notes

The RENAME PROCEDURE command changes the name of a procedure. The old official name of the procedure is kept as an alias, and all existing procedure aliases are preserved.

The RENAME command is rejected if the old procname does not exist, if the new procname cannot be added to the file (either because it already exists or because there is not enough space), or if multiple procedure files were specified for a group.

When it processes RENAME PROCEDURE, Model 204 ends any current User Language update unit and begins a non-backoutable update unit. If a Model 204 command non-backoutable update unit is in progress, RENAME PROCEDURE is included in that update unit. For more information about Model 204 update units, see Update units and transactions.