Using GETLINE to Get a Line of Input

Use the GETLINE macro instruction to obtain all input lines other than commands, subcommands, and prompt message responses. Commands, subcommands, and prompt message responses should be obtained with the PUTGET macro instruction.

When you issue a GETLINE macro instruction, the GETLINE service routine obtains a line of input from either:
  • The terminal or the REXX data stack
  • An in-storage list (including a command procedure)

The processing of the input line varies according to several factors. Included in these factors are the source of input, and the options you specify for logical or physical processing of the input line. The GETLINE service routine determines the type of processing to be performed from the operands coded on the GETLINE macro instruction, and returns a line of input.

The sections that follow describe the following topics:
  • The list and execute forms of the GETLINE macro instruction
  • The sources of input
  • The GETLINE parameter block
  • The input line format
  • Return codes from GETLINE
Parent topic: Using the I/O Service Routine macro instructions