SAS Catalog Entry: _rename

SAS Catalog Entry: _rename

Renames the SAS catalog entry associated with the SAS Catalog Entry object

Syntax
Example

Syntax

CALL SEND (catentry-object-id,'_rename',new-entry-name);

Argument Type Description

new-entry-name C specifies the new one-level entry name for the catalog entry that is associated with catentry-object-id

Argument	Type	Description
new-entry-name	C	specifies the new one-level entry name for the catalog entry that is associated with catentry-object-id

Example

Suppose you have a catalog entry, WORK.GSEG.GTESTIT1.GRSEG, and this entry is associated with CATENTOBJ:

cateclass=loadclass('sashelp.fsp.catentry.
                     class');
catentobj=instance(cateclass);
call send (catentobj, '_setup_', 'work.gseg.
           gtestit1.grseg');

When you initialize CATENTOBJ, the object has these values:

( _class=2663
  DESC='SAS Catentry Class'
  FULLNAME='WORK.GSEG.GTESTIT1.GRSEG'
  DESCRIPTION='PICTURE 1 FROM PROC GTESTIT'
  LIBRARY=<invalid list id>[0]
  CATALOG=<invalid list id>[0]
  ATTRIBUTES=<invalid list id>[0]
)[2687]

You then rename the entry to NEWNAME:

call send (catentobj, '_rename_', 
          'newname');

CATENTOBJ then has these values:

( _class=2663
  DESC='SAS Catentry Class'
  FULLNAME='WORK.GSEG.NEWNAME.GRSEG'
  DESCRIPTION='PICTURE 1 FROM PROC GTESTIT'
  LIBRARY=<invalid list id>[0]
  CATALOG=<invalid list id>[0]
  ATTRIBUTES=<invalid list id>[0]
)[2687]

Chapter Contents
Previous
Next
Top of Page