Skip to main content

IBM Systems  >   z Systems  >   z/VM  >  

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.
 
.
.
.