RTAUTOPT - Restart Automatic Line Numbering or Character Prompting

Use the RTAUTOPT macro instruction to restart either the automatic line numbering feature or the automatic character prompting feature. These features are suspended when the terminal user causes an attention interruption or enters a null line of input. Because only one of these features can be used at a time, the restarted feature is the one that was suspended. See STAUTOLN - Start Automatic Line Numbering. for a description of the automatic line numbering feature and STAUTOCP - Start Automatic Character Prompting for a description of the automatic character prompting feature.

When this macro instruction is used to restart automatic line numbering, the first line number assigned after line numbering is restarted is the same line number that would have been assigned to the next line of terminal input if automatic line numbering had not been suspended.

If your application program is creating a line numbered data set, use the STAUTOLN macro to specify the starting numbers when restarting automatic line numbering. This will ensure that the application's numbers are still in synchronization with the system's.

The RTAUTOPT 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 RTAUTOPT macro instruction.

Figure 1. The RTAUTOPT macro instruction

[symbol]      RTAUTOPT

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

Table 1. Return codes from RTAUTOPT
Return code dec(Hex)	Meaning
0(0)	Successful. Either automatic line numbering or automatic character prompting has been restarted.
4(4)	A parameter was specified. No parameter should be specified.
8(8)	The request is not valid because one of the following has occurred: Automatic line numbering or automatic character prompting was never started or never suspended. An SPAUTOPT macro instruction has been issued to stop automatic line numbering or automatic character prompting.