Exiting and Reentering Full-Screen Mode

If the command processor issues non-full-screen messages (or invokes routines that issue non-full-screen messages), it can issue the STLINENO macro to set full-screen mode off and to set the line number for the next non-full-screen message. In so doing, the command processor eliminates the screen protection function and determines where the next non-full-screen message appears. If the line number is set to 1, VTAM® clears the screen. When the command processor issues the last non-full-screen message (or when the invoked routine returns control to the command processor), the command processor must issue STFSMODE ON to reestablish full-screen mode. The command processor must issue the STFSMODE macro before it issues the next full-screen message macro.

If the command processor exits full-screen mode, expecting to reenter full-screen mode at a later time before termination, the command processor must use STLINENO to set full-screen mode off. (Use of STFSMODE to set the mode off results in the RESHOW key being set to the default.) After a TGET request, the command processor can issue:

STLINENO LINE=n

where n is the desired line number. The command processor not have to specify MODE=OFF on the STLINENO macro because that is the default for the MODE keyword.

When all non-full-screen messages are completed, issue STFSMODE ON before issuing the next full-screen message macro. When the command processor returns to full-screen mode, it must issue the TGET macro to read the RESHOW request in the input queue. It can then continue to transmit and receive information from the terminal.

You may want either to clear part of the screen before issuing STLINENO, or to display information that is to remain on the screen after the STLINENO macro is issued. In either case, issue a full-screen TPUT or TPG macro (including the HOLD option) before issuing the STLINENO. The HOLD option specifies that the program that issued the TPG macro cannot continue its processing until the output line is written to the terminal or deleted. Therefore, the full-screen message reaches the terminal before the STLINENO macro takes effect.