Previous Topic: DEQ Return CodesNext Topic: DISABLE Return Codes


EPI DISABLE Command—Disable Virtual Terminals

EPI DISABLE disables 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 is 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.

EPI DISABLE 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 on to 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 DISABLE ALL command 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.

EPI DISABLE Sample Coding Statements

The following sample coding statement disables the TERM1 virtual terminal:

DISABLE TERM1