STSIZE - Set Terminal Line Size

Use the STSIZE macro instruction to set the logical line size of the time sharing terminal.

If the terminal is a display station, the STSIZE macro instruction is used to set the screen size. The STSIZE macro changes only the logical screen size of a terminal. In non-full-screen processing, the logical and physical screen sizes are the same. However, in full-screen processing they are not necessarily the same and when they are not the same, this macro does not change the physical screen size of the terminal. Full-screen applications can change the physical screen size using the appropriate WRITE command.

The STSIZE macro instruction can be used only in a time sharing environment. If you issue this macro when TSO/E is not active or when your program is running under Session Manager, it is ignored.

Figure 1 shows the format of the STSIZE macro instruction. Each of the operands is explained following the figure.

Figure 1. The STSIZE macro instruction

  [symbol]     STSIZE      {SIZE=number     }[,LINE=number     ]
                           {SIZELOC=address }[,LINELOC=address ]

SIZE=number: Specify the logical line size of the terminal in characters. If the logical line size requested is greater than the physical line size of the terminal, the last character in the line may be repeatedly typed over. Specifying a size greater than 255 gives unpredictable results.
SIZELOC=address: Specify the address of a word containing the logical line size of the terminal in characters.
LINE=number: Specify the number of lines that can appear on the screen of a display station terminal.
LINELOC=address: Specify the address of a word containing the number of lines that can appear on the screen of a display station terminal.

Note: If the terminal is a display station, either the LINE or LINELOC operand must be specified. If the terminal is not a display station, neither operand should be specified.

Defaults by terminal type are as follows:

Terminal type	Line size, number of lines, or screen size
2741	120
1050	120
33/35 Teletype	72
2260, 2265	12x80, 12x40, 6x40, 15x64
3270	12x40 or 24x80
3267	132
3770	132

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

Table 1. Return codes from STSIZE
Return code dec(Hex)	Meaning
0(0)	Successful.
4(4)	An incorrect parameter was specified.
8(8)	The LINE, LINELOC, SIZE, or SIZELOC operands are not valid for one of the following reasons: The LINE or LINELOC operand was specified for a terminal that is not a display station. (An operand value of zero is not an error, and has the same effect as omitting the operand.) The LINE or LINELOC operand was omitted, or specified as zero, for a display station. The SIZE or SIZELOC operand was omitted, or specified as zero, for any terminal type.
12(C)	The dimensions specified for a display station do not correspond to a known, existing screen size. Incorrect screen management can result.