APAR VM62480 MEMO to USERS
This Memo to Users describes a variety of new CP
functions which are introduced by APAR VM62480.
1. Virtual ESCON CTC Support
1.1 DEFINE Command
1.2 QUERY VIRTUAL Command
1.3 User Directory SPECIAL Statement
1.4 COUPLE Command Considerations
2. System Configuration File Extensions
2.1 Symbolic Volume References
2.2 Automatic Start and Restart Options
2.3 IPL Message Control
2.4 Forced Disconnect Timeout
2.5 Default Message Level
2.6 Line-Mode Terminal Logo
3. Automatic DDR Restore
4. ASCII Translation
4.1 DISPLAY Command
4.2 DUMP Command
4.3 LOCATEVM/LOCATE CPREAL/LOCATE CPVIRTUAL Commands
4.4 STORE Command
5. Other Command Enhancements
5.1 QUERY DASD DETAILS Command
5.2 SEND Command
5.3 SHUTDOWN Command
A. System Configuration File Statement Documentation Changes
A.1 CP_OWNED Statement
A.2 FEATURES Statement
A.3 SYSTEM_RESIDENCE Statement
A.4 USER_DEFAULTS Statement
B. User Directory Control Statement Documentation Changes
B.1 SPECIAL Directory Control Statement (Device)
Note: Help files for the following changed CP commands accompany
this APAR.
STORE GUEST STORAGE
STORE HOST STORAGE
DISPLAY GUEST STORAGE
DISPLAY HOST STORAGE
DUMP GUEST STORAGE
DUMP HOST STORAGE
QUERY VIRTUAL CTCA
DEFINE CTCA
COUPLE
QUERY DASD
SEND
LOCATEVM
LOCATE (STORAGE)
SHUTDOWN
LOGOFF
DISCONNECT
1. Virtual ESCON CTC Support
============================
Virtual ESCON Channel-to-Channel adapters are now supported.
1.1 DEFINE Command
------------------
The keywords SCTC (Standard Mode ESCON CTC), BCTC (Basic Mode ESCON
CTC), and CNC (ESCON CNC) may now be used to create the associated
kinds of virtual devices using the DEFINE command.
1.2 QUERY VIRTUAL Command
-------------------------
The response to a QUERY VIRTUAL command for a CTC device now includes
a subclass following the device number. The subclass will be one of
3088, SCTC, BCTC, or CNC.
1.3 User Directory SPECIAL Statement
------------------------------------
Device types SCTC, BCTC, and CNC are now supported on the SPECIAL
statement.
1.4 COUPLE Command Considerations
---------------------------------
The following device combinations are now valid for the COUPLE command:
Local Remote Mode of Operation
--------- --------- -----------------
CTCA/3088 CTCA/3088 3088
SCTC CNC Standard
BCTC CNC Basic
CNC SCTC Standard
CNC BCTC Basic
2. System Configuration File Extensions
=======================================
Several new facilities have been added via the system configuration
file.
2.1 Symbolic Volume References
------------------------------
The system residence and active PARM disk volume serial numbers can
now be referenced symbolically in the CP_OWNED and SYSTEM_RESIDENCE
statements. Use &SYSRES to refer to the system residence (i.e., IPL)
volume, and &SYSPARM to refer to the active PARM disk volume.
2.2 Automatic Start and Restart Options
---------------------------------------
The type of system start to be performed automatically may be specified
using the new AUTO_IPL parameter of the FEATURES statement. Specify a
start type of CLEAN, COLD, FORCE, or WARM, and any combination of the
options DRAIN, NOAUTOLOG, NOENABLE, and NODIRECT to select the kind of
start to be performed when the system is initialized.
Use the AUTO_IPL_AFTER_RESTART parameter of the FEATURES statement to
specify the start type and options to be used after a system restart
is performed.
Use the AUTO_IPL_AFTER_SHUTDOWN_REIPL parameter of the FEATURES statement
to specify the start type and options to be used after a SHUTDOWN REIPL
command is issued.
In all cases, when an automatic start is performed, the system will be
started without prompting the system operator and without changing the
TOD Clock. If a CLEAN start is selected then all spool files, system
data files, accounting, error recording, and symptom records, and the
system log message are purged without prompting the system operator and
without an opportunity to stop. If a COLD start is selected, all spool
files, accounting, error recording, and symptom records, and the system
log message are purged without prompting the system operator and without
an opportunity to stop. If a FORCE start is selected then if any spool
errors are encountered, the spool files in error are purged without
notification and without an opportunity to stop.
2.3 IPL Message Control
-----------------------
Use the IPL_MESSAGES option of the FEATURES statement DISABLE or ENABLE
parameter to control whether CP displays IPL messages or prompts during
system initialization. By default, these messages and prompts are
displayed.
2.4 Forced Disconnect Timeout
-----------------------------
Use the DISCONNECT_TIMEOUT option of the FEATURES statement to specify
the interval between a forced disconnect of a virtual machine and its
logoff. Specify a number of minutes (the default is 15) or specify OFF
to disable the automatic logoff of a virtual machine that is forcibly
disconnected.
2.5 Default Message Level
-------------------------
Use the MESSAGE_LEVEL parameter of the USER_DEFAULTS statement to set
the message level for a user who accesses the system, overriding the
default of WNG ON, MSG ON, EMSG ON, and IMSG ON. Specify any combination
of WNG, MSG, EMSG_CODE, EMSG_TEXT, and IMSG to select individual message
settings, or specify OFF to disable all messages. These settings are used
when a user first accesses VM, before logon, and persist until the user
changes them.
2.6 Line-Mode Terminal Logo
---------------------------
The online message portion of the CP logo used for line-mode terminal
devices is now constructed from the message specified using the
ONLINE_MESSAGE statement of the logo configuration file.
3. Automatic DDR Restore
========================
If the DDR stand-alone utility is IPLed from tape with a LOADPARM of
AUTOxxxx, it automatically restores the tape to the DASD with device
address xxxx. No output is produced on the console. Command completion
is indicated by loading a disabled wait PSW. A wait code of zero in
this PSW indicates a successful restore; a non-zero wait code signals
an unsuccessful restore.
4. ASCII Translation
====================
The DISPLAY, DUMP, STORE, LOCATEVM, LOCATE CPREAL, and LOCATE CPVIRTUAL
commands have been enhanced to support translation to and from ASCII.
4.1 DISPLAY Command
-------------------
A new type modifier, X, may be used with the U and T modifiers to cause
the translated output to use an ASCII rather than an EBCDIC translate
table. For example:
D TX20000
will display 16 bytes at location 20000 in hexadecimal followed by their
ASCII character translation.
4.2 DUMP Command
----------------
A new type modifier, X, may be used with the U and T modifiers to cause
the translated output to use an ASCII rather than an EBCDIC translate
table. For example:
DUMP TX20000
will dump 16 bytes at location 20000 in hexadecimal followed by their
ASCII character translation.
4.3 LOCATEVM/LOCATE CPREAL/LOCATE CPVIRTUAL Commands
----------------------------------------------------
A new option, ASCII, may be specified to cause the character string that
is to be located to be converted to ASCII before it is compared to the
data in storage.
4.4 STORE Command
-----------------
A new type modifier, X, may be used with the U modifier to cause the
character input data that is to be stored to be translated to ASCII
rather than EBCDIC. For example:
ST UX20000 abcd
will store the hexadecimal string 61626364.
5. Other Command Enhancements
=============================
Several CP commands have been enhanced in minor ways.
5.1 QUERY DASD DETAILS Command
------------------------------
The response to QUERY DASD DETAILS now includes the volume size (in
cylinders) in the first line of the command response. For example:
1801 CUTYPE = 3990-EC, DEVTYPE = 3390-06, VOLSER = USPK2, CYL = 3339
For a Fixed-Block Architecture (FBA) device, the value displayed is the
number of logical cylinders, where one logical cylinder is the number
of blocks per access position.
5.2 SEND Command
----------------
A Class C user may now use the SEND command to send both CP and virtual
machine input to a virtual machine that is connected or for which it is
not the secondary user. Responses to these commands are reflected to the
virtual machine, not to the issuer of the SEND command.
5.3 SHUTDOWN Command
--------------------
A new WAIT option may be used on the SHUTDOWN command to set the wait
state code in the disabled wait PSW that CP loads at system termination.
The code specified may be a hexadecimal number between 1 and FFFF. For
example:
SHUTDOWN WAIT 1234
will load a wait PSW with a code of X'1234' in the address portion. The
CP convention is that a wait code corresponds to a message number. It is
recommended that customers use wait codes in the range A000 to FFFF to
avoid conflict with existing and future CP message numbers.
A. System Configuration File Statement Documentation Changes
============================================================
A.1 CP_OWNED Statement
-------------------------------
>>--CP_OWNed--Slot--nnn--|-RESERVEd------------------|-------------------><
| |-Own----| |
! |--|-volid----|--|--------|-|
! |-&SYSRES--| |-Dump---|
! |-&SYSPARM-| |-Shared-|
.
.
.
Operands
.
.
.
! &SYSRES
! indicates that the IPL volume is to be included in the CP-owned
! volume list
!
! &SYSPARM
! indicates that the volume containing the active PARM disk is to
! be included in the CP-owned volume list
.
.
.
A.2 FEATURES Statement
----------------------
>>--FEATures--| Operands |-----------------------------------------------><
Operands:
<----------------------------------------------------------------|
! | <-------------< |
! |---|-AUTO_IPL--|-CLEAN-|---|-----------|--------------------------||-----|
! | |-COLD--| |-NOENABLE--| |
! | |-FORCE-| |-DRAIN-----| |
! | |-WARM--| |-NOAUTOLOG-| |
! | |-NODIRECT--| |
! | |
! | <-------------< |
! |-AUTO_IPL_AFTER_RESTart--|-CLEAN-|---|-----------|------------|
! | |-COLD--| |-NOENABLE--| |
! | |-FORCE-| |-DRAIN-----| |
! | |-WARM--| |-NOAUTOLOG-| |
! | |-NODIRECT--| |
! | |
! | <-------------< |
! |-AUTO_IPL_AFTER_SHUTDOWN_REIPL--|-CLEAN-|---|-----------|-----|
! | |-COLD--| |-NOENABLE--| |
! | |-FORCE-| |-DRAIN-----| |
! | |-WARM--| |-NOAUTOLOG-| |
! | |-NODIRECT--| |
! | |
| <--------------------------------------| |
|-DISable---|-AUTO_WARM_IPL----------------------||------------|
| |-CLEAR_TDisk------------------------| |
| |-CPCHECKing-------------------------| |
| |-|-DYNamic_i/o-|--------------------| |
| | |-DYNamic_io--| | |
! | |-IPL_MESSAGEs-----------------------| |
| |-LOGMSG_FROM_File-------------------| |
| |-NEW_DEVices_initialized_when_added-| |
| |-PROMPt AFTER_RESTart---------------| |
| |-PROMPt AFTER_SHUTDOWN_REIPL--------| |
| |-PROMPt AFTER_POWERoff--------------| |
| |-SET_DEVices------------------------| |
| |-|-SET_DYNamic_i/o-|----------------| |
| | |-SET_DYNamic_io--| | |
| |-SET_PRIVclass----------------------| |
| |-THROTTLE_ALL-----------------------| |
| |
! |-DISCONNECT_TIMEout--|-nnnnnn-|-------------------------------|
! | |-OFF----| |
| |
| <--------------------------------------------------| |
|-ENABle---|-AUTO_WARM_IPL----------------------------------||-|
| |-CLEAR_TDisk------------------------------------| |
| | |-ABEND--| | |
| |-CPCHECKing--|--------|-------------------------| |
| | |-VMSTOP-| | |
| |-|-DYNamic_i/o-|--------------------------------| |
| | |-DYNamic_io--| | |
! | |-IPL_MESSAGEs-----------------------------------| |
| | <--------------------------| | |
| |-LOGMSG_FROM_File---|------------------------||-| |
| | | |-SHOW_ACCount--No--| | | |
| | |-|-------------------|--| | |
| | | |-SHOW_ACCount--Yes-| | | |
| | | |-SHOW_ACIgroup--No--| | | |
| | |-|--------------------|-| | |
| | | |-SHOW_ACIgroup--Yes-| | | |
| | | |-SHOW_Userid--No--| | | |
| | |-|------------------|---| | |
| | |-SHOW_Userid--Yes-| | |
| |-PROMPt AFTER_RESTart---------------------------| |
| |-PROMPt AFTER_SHUTDOWN_REIPL--------------------| |
| |-PROMPt AFTER_POWERoff--------------------------| |
| |-SET_DEVices------------------------------------| |
| |-|-SET_DYNamic_i/o-|----------------------------| |
| | |-SET_DYNamic_io--| | |
| |-SET_PRIVclass----------------------------------| |
| |-THROTTLE_ALL-----------------------------------| |
| |
| |-MAXUsers--NOLimit-| |
|-|-------------------|----------------------------------------|
| |-MAXUsers--nnnnn---| |
| |
| <--------------------| |
| (1) |-AUTOLog--No--| | |
|-PASSWORDS_ON_CMDs------|-|--------------|-||-----------------|
| | |-AUTOLog--Yes-| | |
| | |-LINK--No--| | |
| |-|-----------|----| |
| | |-LINK--Yes-| | |
| | |-LOGon--No--| | |
| |-|------------|---| |
| |-LOGon--Yes-| |
| |
| <--------------------| |
| (1) |-DEFault--7---| | |
|-RETRieve------|-|--------------|-||--------------------------|
| | |-DEFault--nnn-| | |
| | |-MAXimum--7---| | |
| |-|--------------|-| |
| |-MAXimum--nnn-| |
| |
| <-----------------------------------------| |
|-|-VDISK-|----|-Syslim--|--|-Infinite---------------|-|-------|
|-VDSK--| |-Userlim-| |-nnnnnnnnnn--|-Blocks-|-|
| |-Blks---| |
|-nnnnnnnM---------------|
|-nnnnG------------------|
Note:
(1) You must specify at least one of the following operands.
.
.
.
Operands
! AUTO_IPL
! defines the kind of start to be performed when the system is
! initialized. The system will be started without prompting the
! system operator and without changing the TOD Clock.
!
! CLEAN
! tells CP to perform a clean start. This will purge all
! spool files, system data files, accounting, error recording,
! and symptom records, and the system log message without
! prompting the system operator and with no opportunity to
! stop.
!
! COLD
! tells CP to perform a cold start. This will purge all spool
! files, accounting, error recording, and symptom records, and
! the system log message without prompting the system operator
! and with no opportunity to stop.
!
! FORCE
! tells CP to perform a force start. If any spooling errors
! are encountered, the spool files in error will be purged
! without notification and without the opportunity to stop.
!
! WARM
! tells CP to perform a warm start.
!
! NOENABLE
! tells CP not to enable terminal access after system
! initialization.
!
! DRAIN
! tells CP to drain unit-record devices after system
! initialization.
!
! NOAUTOLOG
! tells CP to bypass automatic logon of virtual machines after
! system initialization.
!
! NODIRECT
! tells CP to bring up the system without a User Directory.
!
! AUTO_IPL_AFTER_RESTART
! defines the kind of start to be performed when the system is
! initialized after a system restart. The system will be
! restarted without prompting the system operator and without
! changing the TOD Clock.
!
!
! CLEAN
! tells CP to perform a clean start. This will purge all
! spool files, system data files, accounting, error recording,
! and symptom records, and the system log message without
! prompting the system operator and with no opportunity to
! stop.
!
! Please note that the system dump that may have been created
! during system termination processing will be purged as a
! result of using this operand and it will be difficult or
! impossible to determine the cause of the restart.
!
! COLD
! tells CP to perform a cold start. This will purge all spool
! files, accounting, error recording, and symptom records, and
! the system log message without prompting the system operator
! and with no opportunity to stop.
!
! Please note that the system dump that may have been created
! during system termination processing will be purged as a
! result of using this operand and it will be difficult or
! impossible to determine the cause of the restart.
!
! FORCE
! tells CP to perform a force start. If any spooling errors
! are encountered, the spool files in error will be purged
! without notification and without the opportunity to stop.
!
! WARM
! tells CP to perform a warm start.
!
! NOENABLE
! tells CP not to enable terminal access after system
! initialization.
!
! DRAIN
! tells CP to drain unit-record devices after system
! initialization.
!
! NOAUTOLOG
! tells CP to bypass automatic logon of virtual machines after
! system initialization.
!
! NODIRECT
! tells CP to bring up the system without a User Directory.
!
! AUTO_IPL_AFTER_SHUTDOWN_REIPL
! defines the kind of start to be performed when the system is
! initialized after a SHUTDOWN REIPL. The system will be
! restarted without prompting the system operator and without
! changing the TOD Clock.
!
! CLEAN
! tells CP to perform a clean start. This will purge all
! spool files, system data files, accounting, error recording,
! and symptom records, and the system log message without
! prompting the system operator and with no opportunity to
! stop.
!
! COLD
! tells CP to perform a cold start. This will purge all spool
! files, accounting, error recording, and symptom records, and
! the system log message without prompting the system operator
! and with no opportunity to stop.
!
! FORCE
! tells CP to perform a force start. If any spooling errors
! are encountered, the spool files in error will be purged
! without notification and without the opportunity to stop.
!
! WARM
! tells CP to perform a warm start.
!
! NOENABLE
! tells CP not to enable terminal access after system
! initialization.
!
! DRAIN
! tells CP to drain unit-record devices after system
! initialization.
!
! NOAUTOLOG
! tells CP to bypass automatic logon of virtual machines after
! system initialization.
!
! NODIRECT
! tells CP to bring up the system without a User Directory.
DISable
disables the following system attributes during IPL. Note that
initially, each option is disabled until enabled using the ENABLE
operand.
.
.
.
! IPL_MESSAGES
! tells CP not to display IPL messages or prompts during
! system initialization. If a prompt is required (e.g., to
! set the date and time of day), system initialization fails.
.
.
.
! DISCONNECT_TIMEOUT nnnnnn
! sets the interval between a forced disconnect of a virtual
! machine and its logoff to the specified number of minutes. The
! default is 15 minutes.
!
! DISCONNECT_TIMEOUT OFF
! disables the automatic logoff of a virtual machine that is
! forcibly disconnected.
.
.
.
ENABle
enables the following system attributes during IPL. Note that
initially, each option is disabled until it is enabled.
.
.
.
! IPL_MESSAGES
! (the default) tells CP to display IPL messages and prompts
! during system initialization.
.
.
.
PROMPt AFTER_RESTart
tells CP to force a prompt to the operator when CP bounces, so
that REIPL can be stopped or the type of start desired (WARM,
! FORCE, etc.) can be specified. This suppresses an automatic
! start specified by the AUTO_IPL_AFTER_RESTART parameter.
PROMPt AFTER_SHUTDOWN_REIPL
tells CP to force a prompt to the operator when CP is performing a
SHUTDOWN REIPL, so that REIPL can be stopped or the type of start
! desired (WARM, FORCE, etc.) can be specified. This
! suppresses an automatic start specified by the
! AUTO_IPL_AFTER_SHUTDOWN_REIPL parameter.
.
.
.
Usage Notes
.
.
.
! 4. If you enable AUTO_WARM_IPL or specify the AUTO_IPL parameter
! in the system configuration file and you want to go through the
full series of prompts during the IPL, you can specify the
PROMPT keyword as part of the IPL parameters on the Stand-Alone
Program Loader (SAPL). For more information about the
Stand-Alone Program Loader (SAPL) and the IPL parameters, see
topic 2.4.
.
.
.
A.3 SYSTEM_RESIDENCE Statement
------------------------------
>>--SYSTEM_RESidence--| Operands |---------------------------------------><
Operands:
<------------------------------------------------------------|
|----|-CHECKpoint-|--|---------------------|--| FROM Operands |-|---------|
|-WARMstart--| |-VOLid-|-volid----|--|
! |-&SYSRES--|
! |-&SYSPARM-|
!
FROM Operands:
|-FRom-| |-FOR-|
|--|------|--|-Cylinder-|--start--|-----|--nnnn---------------------------|
|-Page-----|
.
.
.
Operands
.
.
.
! VOLid &SYSRES
! tells CP that the system residence device is to be used as the
! checkpoint or warm start device.
!
! VOLid &SYSPARM
! tells CP that the volume containing the active PARM disk is to
! be used as the checkpoint or warm start device.
.
.
.
A.4 USER_DEFAULTS Statement
---------------------------
>>--USER_DEFAULTS--| Operands |------------------------------------------><
Operands:
<---------------------------------------------------------------------|
|-LPP--OFF-----| |
|--|-|--------------|--------------------------------------------------||-|
| |-LPP--|-OFF-|-| |
| |-nnn-| |
| |
| |-POSIXOPT--QUERYDB--ALLOW--EXEC_SETIDS--DISALLOW---------------| |
|-|---------------------------------------------------------------|-|
| | (1) |-QUERYDB--ALLOW----| |-EXEC_SETIDS--DISALLOW-| | |
| |-POSIXOPT-----|-------------------|--|-----------------------|-| |
| |-QUERYDB--DISALLOW-| |-EXEC_SETIDS--ALLOW----| |
| |
! | |-MESSAGE_LEVel--WNG--MSG--EMSG_CODE--EMSG_TEXT--IMSG-| |
! |-|-----------------------------------------------------|-----------'
! | <-------------< |
! |-MESSAGE_LEVel--|--|-WNG-------|--|------------------|
! | |-MSG-------| |
! | |-EMSG_CODE-| |
! | |-EMSG_TEXT-| |
! | |-IMSG------| |
! |-OFF-------------|
Note:
(1) You must specify at least one of the following operands. If you want
to specify more than one operand, you can specify them in any order.
.
.
.
Operands
.
.
.
! MESSAGE_LEVEL
! sets the default message level for a user who accesses the
! system, overriding the default of WNG ON, MSG ON, EMSG ON, and
! IMSG ON. Specify all message level settings that you want to
! default to ON. Any message level setting that you do not
! specify defaults to OFF. At least one of the following settings
! must be specified:
!
! WNG
! enables the user to receive messages from other users issued
! by the WARNING or WNG command.
!
! MSG
! enables the user to receive messages from other users issued
! by the MESSAGE, MSG, or MSGNOH command.
!
! EMSG_CODE
! enables the user to receive the message code portion of
! error messages. Specifying both EMSG_CODE and EMSG_TEXT
! is equivalent to EMSG ON.
!
! EMSG_TEXT
! enables the user to receive the text portion of error
! messages. Specifying both EMSG_CODE and EMSG_TEXT is
! equivalent to EMSG ON.
!
! IMSG
! enables the user to receive informational messages.
!
! OFF
! prevents the user from receiving any messages, warnings,
! error messages, or informational messages.
.
.
.
Examples
.
.
.
! 4. To set the default message level to WNG ON, EMSG TEXT, MSG OFF
! and IMSG OFF, use the following USER_DEFAULTS statement:
!
! User_Defaults Message_Level WNG EMSG_TEXT
!
.
.
.
B. User Directory Control Statement Documentation Changes
=========================================================
B.1 SPECIAL Directory Control Statement (Device)
------------------------------------------------
>>--SPEcial--vdev--|-3270-----------------|--------------------------><
|-|-CTCA-|--|--------|-|
| |-3088-| |-userid-| |
! | |-SCTC-| |-*------| |
! | |-BCTC-| |
! | '-CNC--' |
| |-Ibm--| |
|-|-2701-|--|------|---|
| |-2702-| |-Tele-| |
| |-2703-| |
|-Ibm------------------|
|-Tele-----------------|
|-MSGProc--msgprocid---|
Purpose
The SPECIAL statement defines special virtual devices, which are
program-simulated and not connected with real devices at definition time.
Refer to the DIAL command for 3270 and communication lines and to the
! COUPLE command for CTCA, 3088, SCTC, BCTC and CNC devices. Refer to
! VM/ESA: CP Command and Utility Reference for details.
.
.
.
Operands
.
.
.
! CTCA
! 3088
! specifies either CTCA or 3088 for a virtual 3088 Multisystem Channel
! Communication Unit logical channel adapter.
!
! SCTC
! specifies ESCON emulation for the virtual device. The
! resulting device will emulate an ESCON CTC in Standard Mode.
! The operational characteristics of the ESCON CTCA are describe
! in the ESCON Channel Adapter reference.
!
! BCTC
! specifies ESCON emulation for the virtual device. The
! resulting device will emulate an ESCON CTC in Basic Mode. Basic
! Mode is defined in the Channel-to-Channel Adapter reference,
! and ESCON deviations are described in the IOCP and ESCON
! Channel-to-Channel reference.
!
! CNC
! specifies ESCON emulation for the virtual device. The
! resulting device will emulate an ESCON CNC. The ESCON CNC
! unit adopts the mode (Standard or Basic) of the coupled CTC
! unit (see SCTC and BCTC keywords).
!
! userid
! *
! "userid" is the user ID of a virtual machine allowed to connect
! to this virtual device using the CP COUPLE command. "*" tells
! CP that a CP COUPLE command is to be allowed only from another
! virtual device owned by the same virtual machine that owns the
! virtual device defined by this SPECIAL statement. If you do
! not specify a user ID or an asterisk (*), a virtual machine
! with any user ID can connect to this virtual device. For more
! information about the CP COUPLE command, see the VM/ESA: CP
! Command and Utility Reference.
.
.
.
Usage Notes:
.
.
.
! 2. SPECIAL CTCA and SPECIAL 3088 both define 3088 devices. To be
! fully functional, the virtual 3088 must be connected to another
! virtual 3088 by the CP COUPLE command. A virtual 3088 device
! cannot be connected to a virtual ESCON CTC.
!
! 3. SPECIAL SCTC, SPECIAL BCTC, and SPECIAL CNC all define ESCON
! devices. To be functional, a virtual ESCON CTC (subclass SCTC
! or BCTC) must be connected to a virtual ESCON CNC by the CP
! COUPLE command. A virtual ESCON device (of any variety) cannot
! be connected to a virtual 3088.
.
.
.