Host Environment Commands › ADDRESS EPI Commands › EPI DISABLE Command—Disable Virtual Terminals

EPI DISABLE Command—Disable Virtual Terminals

Use this command to disable one or more virtual terminals.

Note: We strongly recommend that you do not use the EPI DISABLE command in your automation procedures; the use of this command may result in hang conditions inside the VTAM code, and the EPI will be unable to process commands. Rather, you should use the EPI ENABLE command at initialization to enable your virtual terminals, and you should keep the terminals enabled until the product is terminated.

This command has the following format:

ADDRESS EPI "DISABLE keywords"
  {termname|ALL|*}

termname

Defines the name of the virtual terminal you want to disable. EPI stops the session between this virtual terminal and the external product it is logged onto before disabling the terminal. Once a terminal is disabled, it stops communicating with the external product and EPI. If any commands were being processed when the terminal was disabled, those commands do not execute. An EPI message reports that the terminal was disabled.

You cannot delete a virtual terminal definition unless you have disabled that terminal using the DISABLE command.

ALL

Disables all virtual terminals.

Important! Although the command DISABLE ALL shuts the EPI down quickly, use it with caution, because an external product logged onto one or more of your virtual terminals can have problems if you disable its terminal without logging off properly.

*

Disables the current terminal defined through the SETTERM command.

Example: EPI DISABLE

The following disables the TERM1 virtual terminal:

DISABLE TERM1