z/VM: CP Commands and Utilities Reference - z/VM - IBM

Chapter 3. CP Utilities
This chapter contains the z/VM CP utilities. They are in alphabetical order.
Each utility is described in the following format:
v Utility name: is the name of the utility. This appears on the top of the page for
easy reference.
v Syntax diagram: shows the syntax, operands, and options. Their function,
description, and permitted values are described under Operands.
v Privilege class: if applicable, identifies the users able to issue the utility or the
implied privilege class because of privileged diagnose codes. If the utility invokes
a diagnose, then the privilege class defined for that diagnose becomes the
privilege class for the utility.
v Purpose: explains what the utility is used for.
v Operand: describes the function of the operand and any values that you can
include in the operand.
v Usage Notes: identifies and describes special situations and other considerations
that may affect your use of the utility.
v Responses: describes CP utility responses that you may receive on your display
device. Responses are normal operation output; they tell you about the execution
and effect of the utility. Unlike system messages, utility responses are not
prefixed with an identifying number and are not contained in the z/VM: System
Messages and Codes - CP.
v Messages: lists the number and text of CP utility messages that may be issued
by the utility or z/VM.
The act of issuing a message to the console may itself cause other messages to
be generated. The following messages can be generated when a message is
written to the console.
HCP427E
type {rdev|vdev|name[userid]} system spool space full; file
{closed|held|purged}
HCP429E
type vdev spool error; file {held| purged}
HCP439E
{User userid|*NSS|*IMG|*UCR|*NLS} spool fileid limit exceeded
HCP410E
CP ENTERED; PAGING ERROR
HCP847E
Maximum system spool file limit exceeded
Messages that are not unique to the utility may be issued. Refer to the z/VM:
System Messages and Codes - CP for more complete information about these
messages, including suggested action.
Note: For migration information see the z/VM: Migration Guidebook.
© Copyright IBM Corp. 1991, 2004 1767