UNDIAL

Read syntax diagramSkip visual syntax diagram UNDIAL

Authorization

Privilege Class: Any

Purpose

Use UNDIAL to logically disconnect your terminal from a z/VM® guest system and return control of that terminal to the host z/VM system.

Usage Notes

  1. If UNDIAL is issued from a terminal that is being controlled by a host z/VM system, an error message will be issued.
  2. UNDIAL can be issued only from a terminal that is not logged on. That is, UNDIAL can be issued before the LOGON command or after the LOGOFF or DISCONNECT commands.
  3. UNDIAL cannot be used if the terminal is connected to a VTAM® service machine (VSM) running in the guest system. If this is the case, the connection to the VSM must be terminated before the CP UNDIAL command can be used.
  4. When UNDIAL is issued from a terminal that is dialed to the guest VM system as a logical terminal or a non-SNA TTY terminal and is not logged on, UNDIAL has the same effect as the LOGOFF command.

Messages

  • HCP2101E This terminal is not dialed to a virtual machine.
  • HCP2102E This terminal is logged on to a virtual machine. You must logoff or disconnect before issuing UNDIAL.
  • HCP2103E This terminal is connected to a VTAM Service Machine. You must disconnect from the service machine before issuing UNDIAL.