DEFINE

Purpose

Use the DEFINE commands to:

Change the configuration of your virtual machine
Change the configuration of your operating system
Add a new alias for an existing CP command on your system
Add a new CP command to your system
Add a new version of an existing CP command to your system
Add a new DIAGNOSE code to your system
Add a new guest LAN to your system.

Usage Notes

(General for DEFINE)

SET IMSG OFF suppresses informational messages for this command.
When you use the DEFINE command to alter the configuration of your virtual machine, the changes are temporary and are in effect only for the current session.
When you use the DEFINE command to alter the real I/O configuration of the processor, the changes are temporary and are in effect only until the next power-on reset (POR). If you want the changes to be permanent, you must update your I/O configuration program (IOCP) file.
Defaults for some real printer attributes (for example CHARS) are not set when a virtual printer is created with the DEFINE command.

Messages

(General for DEFINE)

HCP002E Invalid operand - operand
HCP003E Invalid option - {option|command contains extra option(s) starting with option}
HCP005E Invalid hexdata - hexdata
HCP007E Invalid userid - userid
HCP010E Invalid register - register
HCP013E Conflicting option - option
HCP020E Userid missing or invalid
HCP022E A virtual device number was not supplied or it was invalid.
HCP023E VOLID missing or invalid
HCP024E {CYLINDERS|PAGES} MISSING OR INVALID {Block number|Cylinder|Cylinder or block numbers} missing or invalid
HCP026E Operand missing or invalid
HCP040E Device {rdev|vdev|ldev} does not exist
HCP045E userid not logged on
HCP052E [XAUTOLOG failed for userid:] Error in CP directory
HCP053E [XAUTOLOG failed for userid:] userid not in CP directory
HCP091E DASD vdev not defined; {temp|vdisk} space not available
HCP091E DASD vdev not defined; requested vdisk exceeds DEFINE VFB-512 maximum permitted blocks: 4194296.
HCP092E Device vdev not defined; device vdev already defined
HCP094E Storage exceeds allowed maximum of nnn {M|K}
HCP101E DASD vdev forced R/O; R/O by {nnnn users|userid|userid at sysname}[; stable by {nnnn users|userid|userid at sysname}]
HCP102E DASD vdev forced R/O; R/W by {nnnnn users|userid|userid at sysname}[; stable by {userid|userid at sysname}]
HCP103E DASD vdev forced R/O; R/W by {nnnnn users|userid|userid at sysname}; R/O by {nnnnn users|userid|userid at sysname}[; stable by {userid|userid at sysname}]
HCP104E userid vdev not linked; R/O by {nnnnn users|userid|userid at sysname}[; stable by {nnnn users|userid|userid at sysname}|exclusive by {userid|userid at sysname}]
HCP105E userid vdev not linked; R/W by {nnnnn users|userid|userid at sysname}[; stable by {userid|userid at sysname}|exclusive by {userid|userid at sysname}]
HCP106E userid vdev not linked; R/W by {nnnnn users|userid|userid at sysname}, R/O by {nnnnn users|userid|userid at sysname} [; stable by {userid|userid at sysname}]
HCP107E userid vdev not linked; not in CP directory
HCP108E userid vdev not linked; volid volid not mounted
HCP109E userid vdev not linked; invalid link device
HCP110E userid vdev not linked; type vdev already defined
HCP116I WARNING: Cylinders n through n of minidisk vdev are the target of FlashCopy® relationship hhhhhhhh.
HCP117E Userid userid not linked; volid volid conflict
HCP153E Device {vdev|range} exceeds maximum number of virtual devices
HCP195E alias_name is already a substitute
HCP259E SIZE parameter missing or invalid
HCP260E DEFINE command processing cannot complete due to errors
HCP349E String supplied does not match storage contents
HCP372E Invalid location for exit; command rejected
HCP373E Exit already defined at location; command rejected
HCP844E The device is not defined due to an invalid control unit type.
HCP864E A reserved partition slot does not exist for CSS nn, MIF-ID mm
HCP864E Partition pname is already configured in CSS nn, MIF-ID mm
HCP864E Partition pname not found
HCP1003E module was not found
HCP1006E Command processing cannot complete because the system does not support the Dynamic-I/O-for-I/O-adapters facility.
HCP1006E Command processing cannot complete because the system does not support the coupling over InfiniBand channel-path facility.
HCP1006E Command processing cannot complete because the system does not support the OSA-NCP-(OSN)-channel-path facility
HCP1006E The command processing cannot complete because the system does not support the logical-partition-configuration facility
HCP1006E The command processing cannot complete because the system is not running in EMIF mode
HCP1006E Command processing cannot complete because the system does not support the OSC 3215-type device facility.
HCP1006E Command processing cannot complete because the system does not support the OSX and OSM Channel-Path-Types facility.
HCP1006E Command processing cannot complete because the system does not support the Utility-String facility.
HCP1006E Command processing cannot complete because the system does not support the multiple-subchannel-set facility.
HCP1014E A required option is missing.
HCP1015E [XAUTOLOG failed for userid:] Insufficient storage is available to satisfy your request.
HCP1150E DASD {rdev|vdev} is not a valid base exposure.
HCP1151E userid vdev has not been linked because it is not within CP volume cylinder extents.
HCP1152E userid vdev has not been linked because it would overlap system {directory|spool|paging|temporary disk} space
HCP1200E DASD vdev has not been redefined because paging subsystem device cannot be redefined.
HCP1453E CPU nn is not defined because it already exists.
HCP1454E CPU nn does not exist.
HCP1458E An attempt was made to define more CPU's than is allowed in your directory.
HCP1462E An attempt was made to define CPU(s) that would create a virtual CPU configuration that is not valid.
HCP1464I CPU affinity is suppressed for CPU n
HCP1466I CPU affinity is no longer suppressed for CPU n
HCP1467E Virtual type processors are not supported on your system.
HCP2550I The console has been defined as a 3215 because a console mode of 3270 is not supported by the VTAM® Service Machine controlling the real terminal.
HCP2551E The console has been defined as a 3215 because the real device is not a 3270 display.
HCP2773I Entry point name name is unknown at this time; processing continues
HCP2774E Multiple commands match this [alias] request (command1, command2)
HCP2775E External security virtual machine is running. You cannot define new commands at this time
HCP2781E vdev not created; network devices vdev-lastdev could not be defined
HCP2792E OSA vdevnum has not been redefined because it is part of a virtual network adapter
HCP2800E userid is not an authorized CF Service Machine.
HCP2801E Unable to define 4 consecutive message devices starting with device nnnn.
HCP2802E The maximum number of connections to/from userid are already defined.
HCP2803E A coupled connection with CF Service Machine userid already exists.
HCP2804I Message devices range defined and coupled to msgprocid.
HCP2806E You are not allowed to define any message processors
HCP2806E You are not allowed to define message processor msgprocid
HCP2811E Message processor msgprocid is not operational.
HCP2823E Number of devices must be even.
HCP2880E userid vaddr is not linked, CSE LINK I/O error, code cc.
HCP6005E Option option is not supported by z/VM.
HCP6296E Devices cannot be defined in subchannel set m because subchannel sets 0 and n are currently in use.
HCP6430E DEFINE HYPERPAVALIAS cannot complete because there is at least one base device in this HyperPAV pool that is quiesced for Hyperswap.
HCP6430E DEFINE PAVALIAS cannot complete because the associated PAV base is quiesced for Hyperswap.
HCP6704E Missing token at end of line
HCP6706E DASD vdev1-vdev2 defined
HCP6706E Invalid address range - range
HCP6706E Invalid alias name - alias
HCP6706E Invalid command name - command
HCP6706E Invalid CP Exit number - exit
HCP6706E Invalid Diagnose code - diag
HCP6706E Invalid entry point name - name
HCP6706E Invalid file name - fn
HCP6706E Invalid IBM class - c
HCP6706E Invalid instruction - instruction
HCP6706E Invalid number - nnnn
HCP6706E Invalid privilege classes - classes
HCP6706E Invalid routine name - routine
HCP6706E Invalid subcommand name - subcommand
HCP6706E Invalid time zone ID - zoneid
HCP6706E Invalid time zone offset - offset
HCP6706E Invalid volume label - volid
HCP6779E Volume volid already defined in slot nnn
HCP6780E Slot number cannot exceed the defined maximum of mmm
HCP6781E Requested slot occupied by mounted volume volid
HCP6789E Diagnose code diag is already defined
HCP6789E Requested CP Exit number exit is already defined
HCP6805E Cannot determine partition being changed by this dynamic I/O request
HCP6805E Cannot find RDEV for TYPE 1 subchannel
HCP6806E Dynamic I/O change request [for channel path | for control unit | for device | for logical partition] failed with return code nnnn
HCP6806E Dynamic I/O change request for PCI function failed with return code nnnn
HCP6809E This processor does not support dynamic I/O changes
HCP6815E Command failed in the channel subsystem
HCP6816E Dynamic I/O changes are being controlled by HCD
HCP6816E Dynamic I/O changes are not allowed because LPAR information is not available
HCP6816E Dynamic I/O changes are not allowed because the configuration token is not a valid VM token
HCP6816E Dynamic I/O changes are not allowed for CSS nn
HCP6816E Dynamic I/O changes are not allowed for device rdev
HCP6816E Dynamic I/O changes are not allowed on this system
HCP6816E Hot I/O rates are being controlled by HCD
HCP6817E You must specify an existing CP command for this alias
HCP6819E A dynamic I/O command is currently executing for user userid
HCP6830I volid is currently attached to SYSTEM. Detach the device from SYSTEM and try this command again.
HCP6834E Command parameter list length is too {small|large}.
HCP6835E Offset to alias name exceeds parameter list length.
HCP6835E Offset to alias name is negative.
HCP6835E Offset to alias name overlays parameter list fields.
HCP6835E Offset to command name exceeds parameter list length.
HCP6835E Offset to command name is negative.
HCP6835E Offset to command name is zero.
HCP6835E Offset to command name overlays parameter list fields.
HCP6835E Offset to subcommand name exceeds parameter list length.
HCP6835E Offset to subcommand name is negative.
HCP6835E Offset to subcommand name overlays parameter list fields.
HCP6836E {Command|Subcommand|Alias} name extends beyond end of parameter list.
HCP6838E {Command|Subcommand} name abbreviation is too large.
HCP6839E New command or abbreviation duplicates an existing one (command)
HCP6840E You specified QUERY VIRTUAL without SUBCMD
HCP6840E You specified SUBCMD without SET or QUERY
HCP6841E You specified IBM class H, which is reserved for IBM use only.
HCP6841E You specified more than one IBM class.
HCP6842E Cannot find existing CP command for new alias
HCP6843E All versions of the command must have the same logon value
HCP6844E All versions of the command must have the same {PROC value|entry point name|entry point address|minimum abbreviation|SILENT setting}
HCP6845E You must specify {an entry point name|a privilege class[other than 0]|an IBM class [other than 0]}
HCP6846E Requested entry point name is not {an external label in the nucleus|at the address indicated}
HCP6847E You may not define a command whose alias is itself an alias
HCP6853E CHPID chpid has been created but is in definition error and will be unusable when varied on
HCP6854E CU cu has been created but is in definition error. Devices on the CU are not operational and cannot be varied online.
HCP6867E An internal processing error occurred.
HCP6867E Device vdev is not a base HyperParallel Access Volume.
HCP6867E Device vdev is not a base Parallel Access Volume.
HCP6867E Device vdev is not a minidisk.
HCP6867E There are no available system attached real alias HyperParallel Access Volumes for device vdev to be associated.
HCP6867E There are no available system attached real alias Parallel Access Volumes for device vdev to be associated.
HCP6873E PCI function rpfid has been created but is in definition error and has not been added to the configuration.
HCP9300E A system soft abend code has occurred on CPU nnnn for user userid.