Advanced Topics › Identify Devices to CA MIA › Specify Devices in the MIMUNITS Member

Specify Devices in the MIMUNITS Member

The MIMUNITS member specifies one or more devices that you want CA MIA to manage. The following is an example of a MIMUNITS member:

3C0,T3C0,7C0
0E8* 
0E9*,T39*

Each line of the MIMUNITS member specifies one or more devices that CA MIA will manage. Using the preceding example, the following table describes the order of attributes in a line in the MIMUNITS member:

Position 1-z/OS Device Name

Represents the required z/OS device name. This is also known as the local name in some CA MIA commands and displays. It is always a three- or four-digit hexadecimal number. If three digits are specified, then a leading zero is assumed.

Position 2-Global Name of the Device

Represents the global name of the device. This value may be alphanumeric, as shown, or it may be hexadecimal. Members of the MIMplex use the global name to identify the drive in commands and displays. If you omit this information, then the global name is made equal to the local name. It is possible for a device to have different local names on different systems, but the global name must remain the same across all systems. If your MIMUNITS member is shared by different systems, then you can use IFSYS and ENDSYS statements to define different local names in each system.

Note: The global device name cannot be equal to the local name of a different device on any system in the MIMplex.

Position 3-Autopath Eligibility of the Device

Represents optional information about the drive to the Autopath feature. This value may be either hexadecimal or the three-letter string MIM. If omitted, then the drive is not attached or detached by Autopath.

This value should be specified only for z/OS systems that are running as guests under z/VM. The Autopath feature only works under z/VM. “MIM” must be specified when CA MIA is controlling the drive on the host z/VM system. The z/VM real address of the device, expressed in hexadecimal, is used when CA MIA is not controlling the drive on the host z/VM system. In the previous example, the device known as 7C0 to z/VM is attached to z/OS at virtual address 3C0. Autopath uses CA MIM commands to attach or detach the drive to the z/OS guest when “MIM” is specified, and uses CP commands to attach or detach the drive when a hexadecimal value is specified.

Note: Separate each attribute of the MIMUNITS member with a comma.

Examples

The following are examples of valid entries in the MIMUNITS member:

3C0

Defines z/OS device 03C0 and implies global name is 3C0

3C0,3C0

Has the same effect as the example above

3C0,5C0

Defines z/OS device 03C0 as global name 5C0

3C0,3C0,3C0

Same as the first and second examples, but also specified Autopath real address 3C0

03C0,T3C0,MIM

Defines z/OS device 03C0 as global name T3C0 and Autopath control through CA MIA

03C0,,7C0

Defines z/OS device 03C0 as global name 03C0 and Autopath real address 7C0

03C*, 03C*, 7C*

Defines z/OS devices 03C0-03CF as global names 03C0-03CF and Autopath real addresses 7C0-7CF

Note: You can specify a group of drives having similar addresses on a single line. Use an asterisk in the last character of each attribute to indicate a range of up to 16 devices. For example, 03C* would indicate that all drives from 03C0 through 03CF are included. If an asterisk is used in the first position, then it must also be used in the second and third positions, if they are present, for example, 3C*, T3C*, 7C*.

More information:

z/VM Considerations