z/OS TSO/E Programming Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


STTIMEOU - Set Time Out Feature

z/OS TSO/E Programming Services
SA32-0973-00

Use the STTIMEOU macro instruction to specify whether the 1050 terminal has the optional text time out suppression feature. The macro instruction allows a 1050 terminal, with or without the feature, to call in using the same switched line, and to be handled initially as if it did not have the feature.

A 1050 without the text time out suppression feature operates as follows: When the PROCEED light is on and the keyboard is unlocked, the terminal will time out; that is, the keyboard will lock if the user does not type input for approximately 20 seconds. The system subsequently responds to the time out by restoring the keyboard so that the user may continue. The user can prevent the time out by periodically pressing the SHIFT key.

A 1050 with the text time out suppression feature operates as follows: The keyboard does not lock if the user does not type input within 20 seconds. The system can therefore use the read inhibit channel command, which does not time out within 28 seconds, in contrast to the read channel command that does time out. (Note: If the system is directed to use the read inhibit channel command for a 1050 that does time out, the terminal may be locked out of the system.)

Until the STTIMEOU macro instruction is issued, 1050 terminals are handled according to the definition provided in the message control program. If the currently connected terminal has the text time out suppression feature, STTIMEOU NO can be issued to direct the system to use read inhibit rather than read channel commands. (STTIMEOU NO should not be issued for a 1050 that does not have the text time out suppression feature. This specification could cause the terminal to be locked out of the system.)

The STTIMEOU macro instruction should be issued only when an IBM® 1050 terminal is being used. Terminals which are equivalent to the one explicitly supported may also function satisfactorily. The customer is responsible for establishing equivalency. IBM assumes no responsibility for the impact that any changes to the IBM-supplied products or programs may have on such terminals.

The STTIMEOU macro instruction can be used only in a time sharing environment. It is ignored if TSO/E is not active when the macro instruction is issued.

Figure 1 shows the format of the STTIMEOU macro instruction.

Figure 1. The STTIMEOU macro instruction
[symbol]     STTIMEOU        [YES]
                             [NO ]
YES | NO
YES
indicates that IBM 1050 terminal does time out. It does not have the text time out suppression feature. If the operand is omitted, the default is YES.
NO
indicates that the IBM 1050 terminal does not time out. The 1050 does have the text time out suppression feature.

When control is returned to the user, register 15 contains one of the following return codes:

Table 1. Return codes from STTIMEOU
Return code dec(Hex) Meaning
0(0) Successful.
4(4) An incorrect parameter was specified.
8(8) The terminal type is not valid. This macro instruction applies to the IBM 1050 terminal only.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014