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

Specifies the SMF ID or system name of the system, and should match the actual SMF ID or system name for one, and only one, of your systems. The name and alias is applied to the system whose SMF ID matches.

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.
• You must define names to systems if you are using CTCDASD, CTCONLY, or XCF communication methods. You can omit DEFSYS statements when running in DASDONLY mode, but we recommend that you define one anyway.
• 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.
• You need to reformat your checkpoint and control files to implement modifications to the DEFSYS statement.
• 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.