(MIA) RESYNCH Command-Change Managed Devices

CA MIA Statements and Commands › (MIA) RESYNCH Command-Change Managed Devices

(MIA) RESYNCH Command-Change Managed Devices

The RESYNCH command allows you to change the devices that are managed by CA MIA without the need to restart your system or CA MIA.

Scope: Local

This command has the following format:

RESYNCH  [COMMANDS={member|NONE}]
	  [DEVCLASS={NONE|TAPE}]
	  [DEVLIST={member|NONE}]
	  [DEVEXCL={member|NONE}]

COMMANDS

(Optional) Allows commands to be issued automatically from a data set after resynchronization takes place. This parameter is similar to the MIMINIT COMMANDS statement specified at startup. Specify one of the following values:

member: Specifies the member that CA MIM should use.
NONE: Specifies that you are not using a commands data set.

Default: See the RESYNCH operand for the SETOPTION GTAF command.

DEVCLASS

(Optional) Indicates which class of devices CA MIA will automatically manage after resynchronization. Specify one of the following values:

NONE: Indicates that you are not placing a class of devices under CA MIA management.
TAPE: Places all tape devices under CA MIA management.

Default: See the RESYNCH operand for the SETOPTION GTAF command.

DEVLIST

(Optional) Identifies the member that CA MIA uses to obtain device control information. Specify one of the following values:

member: Specifies the name of the member that CA MIA should use.
NONE: You are not using a member for this purpose.

DEVEXCL

(Optional) Identifies the member of the CA MIA parameter data set that contains a list of tape devices you wish to exclude from CA MIA management. Specify one of these values on the DEVEXCL parameter.

member

Specifies the name of the member that CA MIA should use.

NONE

You are not using a member for this purpose.

Default: DEVEXCL=NONE

Usage Notes: RESYNCH Command

The RESYNCH command is a local command. This command only takes effect on the system where it is issued. Issue the RESYNCH command on every system requiring a change in CA MIA managed devices.
During RESYNCH processing, CA MIA uses the default values for DEVCLASS, DEVLIST, DEVEXCL, and COMMANDS as defined on the SETOPTION RESYNCH command in the MIMCMNDS member. You can temporarily override these default values using the DEVCLASS, DEVLIST, DEVEXCL, and COMMANDS parameters of the RESYNCH command.
You can perform dynamic I/O reconfiguration using the z/OS ACTIVATE command or the Hardware Configuration Definition (HCD). This action can change how your tape devices are configured. Therefore, CA MIA automatically goes through a “resynchronization” process after any dynamic I/O configuration to handle any changes that are made to tape devices by the new I/O configuration.
When a task, is in the process of tape allocation and a resynchronization occurs, the resynchronization removes all the devices that were requested by the task from CA MIA management. CA MIA discontinues the cross-system serialization of the allocation. However, CA MIA may continue its involvement in some parts of the allocation until the allocation completes. For example, if the task goes into allocation recovery, then CA MIA manages the recovery until the allocation recovery messages are responded to.
For more information, see the description of the RESYNCH operand for the SETOPTION GTAF and SETOPTION TPCF commands.

Example: RESYNCH Command

To change the class of devices managed by CA MIA from NONE to TAPE, issue the following command:

RESYNCH DEVCLASS=TAPE

In this example, CA MIA uses TAPE for the DEVCLASS option, which temporarily overrides the value set on the SETOPTION RESYNCH command for DEVCLASS. The values for the COMMANDS and DEVLIST options remain the same.