Chapter Contents

Previous

Next
Command Directory

dbinput

Called from a CLIST or EXEC for Information Input

ABBREVIATION
dbi{nput}

FORMAT
dbinput VARIABLE-NAME ["STRING"]

DESCRIPTION
The dbinput command can be called from a CLIST or an EXEC to input information into a CLIST or EXEC variable. This command, which can only be used in a CLIST or EXEC, causes the debugger to prompt for input using the prompt string specified with the STRING argument. STRING is a group of characters set off by double quotation marks. The command undergoes normal CLIST or EXEC processing, that is, symbolic substitution occurs. Text input is assigned to the CLIST or EXEC variable name specified in the command. Both the VARIABLE-NAME and STRING arguments are limited to 64 characters in length.

In line mode, the debugger reads the input from the terminal at the prompt specified by the STRING argument.

In full-screen mode, the Termin window is used. Instead of displaying a Read... prompt, the Termin window will display Exec... in the upper-left border. The characters specified by the STRING argument are displayed as the input prompt. Setting the EOF field to Y results in the condition code being set to -13. The Intercept: field has no effect on the dbinput command. The functions of other Termin window fields are unchanged by the dbinput command. If it is not possible to open the Termin window, the debugger will accept input from the terminal, in a similar manner to a line mode session.

EXAMPLES

dbinput xyz
reads terminal input into the EXEC or CLIST variable xyz .

dbinput xyz "Please Enter Y or N:"
displays the prompt string and reads terminal input into the variable xyz. In full-screen mode the prompt string is displayed in the Termin window. See Termin Window for information about the Termin window.

SYSTEM DEPENDENCIES
The dbinput command is used to input a value to a CLIST or EXEC under TSO and an EXEC under CMS.

COMMAND CAN BE ISSUED FROM

PROFILE no
configuration file no
Source window prefix none

SCOPE
The dbinput command is not affected by changes in scope.

RETURN CODES SET
Successful: 0
Unsuccessful: 1

SEE ALSO
dblog


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.