START Command-Activate CA MIM for z/VM

General CA MIM Statements and Commands › START Command-Activate CA MIM for z/VM

START Command-Activate CA MIM for z/VM

The START command activates CA MIM.

This command has the following format:

START parmlist

parmlist: Indicates any value that can be specified in the INIT MIM file that can be overridden. The value will override the value set by the INIT MIM file or the default value.

Usage Notes: START Command

The START command is a privileged command that can be issued only from the service virtual machine console or from a GCS exec running on the MIMGR service machine. You can issue the START command from the secondary user if MIMGR is running disconnected.
Any value that can be specified on the MIMINIT statement can also be specified on the START command. Any value specified on the START command parameter list overrides the value setting specified in the INIT MIM file. Also, values specified on the START command override default values.

Examples: START Command

To activate CA MIM and to format the control files and checkpoint files, enter the following command at the service virtual machine console:
```
MI START FORMAT=BOTH
```
To activate and format only the checkpoint file, issue the following command:
```
MI START FORMAT=CHKPT
```
To activate and format only the control file, issue the following command:
```
MI START FORMAT=CF
```

SYSDUMP Command-Create System Dump

The SYSDUMP command creates a system dump of the CA MIM service machine. You can request the dump on the issuing system, all systems in the MIM complex, all external systems to the issuing system, or a list of selected systems in the complex.

This command has the following format:

SYSDUMP SYSTEM={ALL|EXTERNAL|LOCAL|sysname}

SYSTEM

(Optional) Determines the target systems that are to obtain the system dump. Specify one of the following values:

ALL: Obtains a system dump on every system in the MIMplex.
EXTERNAL: Obtains a system dump on all systems in the MIMplex except the system on which the command is issued.
LOCAL: Obtains a system dump only on the system where the command is issued.
sysname: Obtains a system dump on the named systems. You can specify any system named in the DEFSYS initialization statements, such as SMF ID, CA MIM alias names, or CA MIM system names.

Default: SYSTEM=LOCAL

Usage Notes: SYSDUMP Command

The SYSDUMP command must be issued from a console or a CMS session. You cannot issue this command from the parameter data set.
You must be authorized to issue system control commands in order to issue the SYSDUMP command. CMS users generally are not authorized to issue system control commands.

Example: SYSDUMP Command

To request a system dump on system SYS1, you could issue the following:

SYSDUMP SYSTEM=SYS1

(MIM) TABLE Statement-Identify Message Table

The TABLE statement identifies a message table for the CA MIM Message Facility.

This command has the following format:

TABLE name [language]

name: Identifies the message table. Each product determines what table name to use.
language: (Optional) Identifies the message table language. If no language is specified, then the default language, English, is used. Any text is valid.

Usage Note: TABLE Command

You can specify this statement only in message table files. Specify the TABLE statement before MSG statements.

Example: TABLE Command

To name a German language message table for CA MIM, specify this statement in your primary message table:

TABLE MIMMSGX GERMAN

(MIM) VCF Recovery - Initiate recovery of CA MIM’s VCF communication

The VCF command allows you to initiate recovery when virtual control file operations fail.

Scope: Global

This command has the following format:

VCF RECOVERY

RECOVERY

Initiates recovery when virtual control file operations fail in a VCF environment.

In a CTCDASD environment, recovery takes place by migrating to a new DASD control file.

In another VCF environment, recovery takes place when all systems resynchronize and communicate with the new master system.

Note: Only use this operand when you cannot initiate migration to a backup DASD or new master system using the MIGRATE command.

Usage Notes: VCF Command

The VCF command can be used when executing in a VCF environment. This command has no effect when CA MIM is using a physical control file.
The VCF command usually is issued from a console, rather than from the MIM parameter files.

Example: VCF Command

To initiate virtual control file recovery, issue this command:

VCF RECOVERY