CXXMAINT (Maintain Directory) › CXXMAINT ALTER DSN (Modify Data Set Name) › How to Use

How to Use

The MUF must be active when you execute this command, except when running with the Simplify option and the function follows another that only runs with the MUF not enabled, or if you declare the MUF is down using a function: SET OPTION1=MUF_NOT_ENABLED or SET OPTION1=MUF_ENABLED_OR_DISABLED.

Execute DBUTLTY with the command:

►►─ CXXMAINT OPTION=ALTER,AREA=aaa ─ ,DBID=n,DSN=dataset ─────────────────────►◄

Command

CXXMAINT

Invokes the function for Directory maintenance.

Required Keywords

OPTION=ALTER

Requests the CXXMAINT ALTER option.

,AREA=

Identifies the data or Index Area whose data set name is to be changed.

Valid Entries:

The DATACOM-NAME of the data area, or the index area name (IXX or Inn, where nn is 00 to 99).

Default Value:

(No default)

,DBID=

Identifies the database associated with the data or Index Area.

Valid Entries:

DATACOM-ID of the database

Default Value:

(No default)

,DSN=

Specifies the new data set name.

The DSN= cannot be set to spaces. A space serves as a delimiter and terminates the name. Do not use quotation marks to enclose the name.

If you want to remove a stored data set name, specify the data set name as an asterisk (DSN=*). Specifying an asterisk for the data set name sets the data set name to blanks and therefore removes the stored data set name.

Note: See restrictions on changing data set names below.

Valid Entries:

either a valid data set name or an asterisk (*)

Default Value:

(No default)

Note:

• The data set name for the base used for the CBS index can be changed only in one of the following ways:
  • The enabled MUF has a different database as the CBS index.
  • The MUF is not enabled, is not externally secured for DBUTLTY, and the DBUTLTY INIT function is used, or in Simplify mode it can be executed with MUF not enabled (see previous comments), as in the following example:

     DBUTLTY INIT DBID=6,AREA=IXX
     DBUTLTY INIT DBID=17,AREA=IXX
     DBUTLTY INIT DBID=17,AREA=TTM
     DBUTLTY LOAD DBID=17,FORMAT=NONE,KBYTES=9999,SORT=1
    

• The data set name for the SQL temporary table management (TTM) index (IXX) or data area (TTM) may only be changed in one of the following manners:
  • The enabled MUF has a virtual TTM base.
  • The enabled MUF has SQL not generated.
  • The MUF is not enabled, is not externally secured for DBUTLTY, and the DBUTLTY INIT function is used.
• A data area or index area data set cannot be shared by two CXXs. This can result in data integrity problems and index corruption.