General CA MIM Statements and Commands › (MIM) ALTERSYS Command-Alter System Definitions

(MIM) ALTERSYS Command-Alter System Definitions

The ALTERSYS command lets you modify existing system definitions (DEFSYS) while CA MIM is synchronized. The ALTERSYS command requires COMPATLEVEL 12.0 or higher.

SCOPE: Global

This command has the following format:

ALTERSYS target sysname,NAME=(sysname,alias),STATUS=[ENABLED|DISABLED]

target sysname

Specifies the name of the system definition (DEFSYS) entry you want to modify. Specify either system name, index, or alias.

sysname

Specifies the new system name for the target system definition entry.

alias

Specifies the new system alias name for the target system definition entry.

STATUS

(Optional) Determines whether the system can join a currently executing MIMplex.

ENABLED

Indicates that the system is able to join a currently executing MIMplex.

DISABLED

Indicates that the system is strictly prevented from joining a currently executing MIMplex.

Default: STATUS=DISABLED

Note: Altering a system definition automatically marks the system as DISABLED. Specifying STATUS=ENABLED enables the system.

AUTHCHK Command-Check Licensing Statements

The AUTHCHK command lets you perform an immediate check on the CA MIM LMP statements.

This command has the following format:

AUTHCHK

Usage Notes: AUTHCHK Command

• The AUTHCHK command is a privileged command that can be issued from the service virtual machine console or from a CMS user ID having OPER authorization.
• Although CA MIM periodically checks its LMP statements, you can use the AUTHCHK command to perform an immediate authorization check. (The interval for periodic checks is determined by the AUTHCHECK parameter on the SETOPTION command.)

Example: AUTHCHK Command

To check the authorization statements for this CPU, issue the following command:

AUTHCHK

(MIM) CTC Command-Clear CTC Error

If a CTC error occurs, then the CTC command lets you clear and reset the status of one or more CTC devices linked to the local system. You can specify this command only when CA MIM is operating on VCF.

Scope: Local

This command has the following format:

CTC [ABEND]
    [RECOVERY
    [RESET[=device]]
    [SWITCH]

ABEND

(Optional) ABENDs the virtual control file operation with a U0051 ABEND code and initiates migration to a backup DASD control file. Specify this operand only if you cannot initiate migration to a backup DASD control file through the MIGRATE command.

RECOVERY

(Optional) Initiates recovery when virtual control file operations fail in a CTC environment. In a CTCDASD environment, recovery takes place by migrating to a new DASD control file. In a CTCONLY environment, recovery takes place when all systems resynchronize and communicate with the new master system.

Note: This parameter should be used only if you cannot initiate migration to a backup DASD control file or new master system using the MIGRATE command.

RESET

(Optional) Clears the internal and external error indicators for one or more CTC devices.

By default, CA MIM clears these error indicators for all CTC devices on the local system. To clear these indicators only for a certain device, specify the address of the device in place of device.

SWITCH

(Optional) Switches the virtual control file to the next CTC device address.

Note: The CTC SWITCH command is not valid from a master system.

Usage Notes: CTC Command

• You must specify at least one parameter for this command.
• You may need to use this command if CA MIM detects an error condition associated with a CTC device. If you correct the hardware or software problem, then CA MIM does not automatically detect that the error state no longer exists. You can use the CTC command to clear the error state and resume CTC activity.
• You can use the DISPLAY PATH command to display a list of all CTC devices known to the local system.
• The CTC command usually is issued from a virtual machine, rather than from the CA MIM parameter files.
• The CTC command is a privileged command. You can issue it from the service virtual machine console or from a CMS user ID having OPER authorization.

Examples: CTC Command

• To clear the error indicators for CTC device 02C1, issue this command:

  CTC RESET=02C1
  

• To take a currently active CTC device offline and migrate to the next available CTC path, issue this command:

  CTC SWITCH