REDEFINE

Read syntax diagramSkip visual syntax diagram REDEFine vdev1 AS vdev2

Authorization

Privilege Class: G

Purpose

Use REDEFINE to change the virtual device number of any existing virtual device in your configuration.

Operands

vdev1
is the virtual device number of an existing virtual device.
vdev2
is the new virtual device number.

Usage Notes

  1. Virtual paging subsystem devices should not be redefined in order to protect the integrity of the user's virtual paging subsystem.
  2. When you use the REDEFINE command to alter the configuration of your virtual machine, the changes are temporary and are only in effect for the current session.
  3. The virtual device numbers you specify can be no higher than FFFF.
  4. Informational responses are sent to your display to confirm that the configuration change you requested has taken place. These responses do not appear if you have issued the SET IMSG OFF command.
  5. If you change the virtual device number of your console while spooling your console, the spool file device number will also change.
  6. If the existing virtual device is part of a Concurrent Copy (CONCOPY) session for your virtual machine, the CONCOPY session is terminated in the storage control associated with the device.

Responses

Response 1: 
type vdev DEFINED
confirms that the device number has been changed.
Type Meaning
DASD Direct access storage device
TAPE Magnetic tape
RDR Card reader
PRT Line printer
PUN Card punch
GRAF Display device
CONS Console
CTCA Channel-to-channel adapter
CTLR 3745 Communications Controller
MSC Mass Storage Controller
SWCH Dynamic switching device
DEV Any other device.
Response 2: 
Redefining vdev1 has caused the termination of
CONCOPY session(s) on device(s): vdev...
indicates that Concurrent Copy (CONCOPY) sessions have been terminated during the process of changing the existing virtual device number.
vdev1
is the existing virtual device number that you are changing.
vdev...
is a list of the virtual device numbers that are part of the terminated CONCOPY sessions.

Messages

  • HCP002E Invalid operand - operand
  • HCP022E A virtual device number was not supplied or it was invalid.
  • HCP026E Operand missing or invalid
  • HCP040E Device {rdev|vdev|ldev} does not exist
  • HCP092E Device vdev not defined; device vdev already defined
  • HCP1150E DASD {rdev|vdev} is not a valid base exposure.
  • HCP1200E DASD vdev has not been redefined because paging subsystem device cannot be redefined.