The Facility Rename utility (FACRENAME) is used to change a class name contained within a CMS library.
Software Version: FACRENAME Version X0.1
Activates the FACRENAME utility. The FACRENAME utility is run from DCL. Renames an existing CMS class name within a CMS library.
FACRENAME library-spec old-name new-name
Command Qualifiers Defaults /[NO]LOG /LOG=library /PROCESS /PROCESS=flagfree /REMARK None.
| LIB_SPEC: | library-spec |
| OLD_NAME: | old-name |
| NEW_NAME: | new-name |
The FACRENAME command is used to change the name of an existing CMS class name within a CMS library. This utility performs some verification before attempting to rename the specified CMS class to minimize the possibility for errors.
library-spec
Specifies the CMS library that is to be acted on. This specification can contain wildcards, but it must be a valid CMS library directory specification (i.e. VMS$:[YELLOW_TEST.CMS]). An example of a wildcarded specification would be: VMS$:[Y*.CMS]. This specification would process all libraries that start with the letter "Y".old-name
Specifies the CMS class name that is to be renamed.new-name
Specifies the CMS class name that "old-name" is to be renamed to.
/LOG=(log-type[,log-type,...])
Specifies what type of logging the user wants. The default is that the user will only see messages from the utility pertaining to the libraries being processed or skipped. The list of acceptable log types is:
- [NO]ALL - Log all messages
- [NO]LIBRARY - Log only message pertaining to libraries
- [NO]CMS - Log error messages recieved from CMS
/PROCESS=(attribute[,attribute,...])
The PROCESS qualifier is used to identify what libraries are to be processed. Some libraries have special attributes associated with them, VMSCMS$NO_PROPAGATE.FLAG is an example of an attribute. This attribute indicates that this library is not to have any code propagation performed within it. The process qualifier is used to selectively process or skip libraries marked with certain attributes. The list of acceptable attributes is:
- [NO]ALL - process all libraries no matter what attribute it may have
- [NO]ARCHIVEDFACILITY - process all archived libraries
- [NO]FLAGFREE - process libraries with not attributes
- [NO]NOPROPAGATE - process libraries marked no propagate
/REMARK="remark string"
Indicates that the utility should also change the remark associated with the new class name. Specifying a remark string will result in the new class name having a new remark. The default action is for the new class name to retain the original remark entered for the old class name.
| Contents |