General CA MIM Statements and Commands › (MIM) DEFSYS Statement-Define MIMplex Systems

(MIM) DEFSYS Statement-Define MIMplex Systems

The DEFSYS statement identifies the systems participating in the MIMplex. The systems defined here will communicate using the DASDONLY, CTCONLY, CTCDASD, or XCF communication methods.

This statement has the following format:

DEFSYS (sysname[[,alias][,smfid]][,{INITIAL=ACTIVE|FREED}])

sysname

Specifies the one- to eight-character system name that CA MIM should assign to the system.

alias

(Optional) Specifies the one- or two-character alias that CA MIM should assign to the system.

Default: The system index number.

Note: System index numbers are discussed under Usage Notes for this statement.

smfid

(Optional) Specifies an SMF ID or MVS system name. CA MIM uses smfid during initialization to determine the system identity.

INITIAL

(Optional) Specifies in which state the system starts up. Valid values are:

ACTIVE

Specifies that the system starts up and is expected to be active.

FREED

Specifies that the system is to start up in the freed state, meaning you will not need to manually issue the FREE command to synchronize without that system.

Important! INITIAL takes effect only when you format the control file.

Usage Notes: DEFSYS Statement

• The DEFSYS statement can be specified only in the MIMINIT member.
• DEFSYS statements must be the same on all systems (including the order in which systems are listed).
• Do not specify DEFSYS statements between IFSYS and ENDIF statements.
• We recommend that you defined each system participating in the MIMplex in your MIMINIT member. However, you can issue the DEFSYS command dynamically to add systems while CA MIM is executing.
• The DEFSYS statement contains positional parameters. For information of what order you must specify these positional parameters, see the DEFSYS Statement in this chapter.
• Index numbers are assigned to systems based on the order of the system names defined on the DEFSYS statement. The first system on the DEFSYS statement is assigned index number 01, the second system is assigned index number 02, and so on. These indexes must be the same on all systems, so the DEFSYS statements must be the same on all systems.
• Modifications to the DEFSYS statement require a CA MIM restart with FORMAT=BOTH. The exception is adding a system to the DEFSYS statement after adding a system dynamically. For more information, see the CA MIM Programming Guide for detail on how to add systems dynamically.
• You must relate the z/OS system names to the CA MIM system names to use the auto FREE feature. To do this, update the smfid field of the DEFSYS statement with the z/OS system name.

  Note: For more information on determining the z/OS system name, see the CA MIM Programming Guide.

Examples: DEFSYS Statement

• Use the following statement to assign a system name, SYSA, and an alias, AA, to the system having an SMFID of SYSA, and a system name, SYSB, and an alias, BB, to the system having an SMF ID of SYSB:

  DEFSYS (SYSA,AA,SYSA) (SYSB,BB,SYSB)
  

• To assign system names IPOX1 and IPOX2 to systems SMF1 and SMF2 (respectively), specify this statement in the MIMINIT member:

  DEFSYS (IPOX1,,SMF1) (IPOX2,,SMF2)
  

  Because the system aliases are omitted from this statement, CA MIM uses the system index numbers for the aliases. 01 is the alias for system IPOX1 and 02 is the alias for system IPOX2.

• To assign the system names IPOX1 and IPOX2 to systems SMF1 and SMF2 (respectively) and to request that system IPOX2 be initially free, specify this statement in the initialization member:

  DEFSYS (IPOX1,B1,SMF1,INITIAL=ACTIVE),
         (IPOX2,B2,SMF2,INITIAL=FREED)
  

Note: Because INITIAL=FREED was specified for system IPOX2, when CA MIM is started with a control file format on system IPOX1, it is not necessary to issue a FREE command to allow system IPOX1 to synchronize. The INITIAL=FREED parameter can be useful for systems that are designated test systems or infrequently brought into the MIMplex.

(MIM) DEFSYS Command-Dynamically Define MIMplex Systems

The DEFSYS command dynamically defines systems to an active MIMplex. This command is only available when using a VCF communication method and COMPATLEVEL=11.9 or greater.

SCOPE:Global

This command has the following format:

DEFSYS (sysname[[,alias][,smfid]])

sysname

Specifies the one-to-eight-character name that CA MIM assigned to the system.

alias

(Optional) Specifies the one-or-two-character alias that CA MIM assigned to the system.

Default: When no alias is specified, a unique alias is provided by CA MIM.

smfid

(Optional) Specifies an SMF ID or MVS system name. CA MIM uses the smfid during initialization to determine the system identity.

Usage Notes: DEFSYS Command

• The DEFSYS command is only available when running COMMUNICATION=XCF and COMPATLEVEL=11.9 or greater.
• For detailed instructions on how to add a system dynamically, see the CA MIM Programming Guide.
• Do not use this command in any MIM command or MIM synch members.
• Once a system is added to the MIMplex through the DEFSYS command, the only way to remove the system is by shutting down globally and restarting with a control file FORMAT.
• This command can add multiple systems to a MIMplex by issuing one command.
• The DEFSYS command tolerates the INITIAL keyword, but forces INITIAL=FREED.
• At the conclusion of DEFSYS command processing, the desired system is unavailable to become the MASTER system. To add this system to the potential master list you must update the GLOBALVALUE. For detailed instructions on updating GLOBALVALUE, see the CA MIM Programming Guide.