Specifies the three-fullword storage area in which the system will build the #LINEIN parameter list.
(Default); is the symbolic name of the storage area in which the system will build the line request block (LRB).
A register that points to the area or the symbolic name of the area in which the system will build the LRB.
Specifies the storage area into which the data will be read.
A register that points to the area or the symbolic name of the area. When INAREA is specified, the LOCATE option should not be requested.
Specifies the length, in bytes, of the data area, defined by INAREA, that is reserved for the input data stream.
A register that contains the length of the data area or an absolute expression. When MAXIN is specified, the LOCATE option should not be requested.
Specifies the location to which the system will return the actual length of the input data stream. If INAREA is too small to hold the entire input line, resulting in truncation, the returned length will indicate the original length of the data stream before truncation.
(Default); is the register to which the system will return the actual length of the input data stream.
A register or the symbolic name of a halfword or fullword user-defined field to which the system will return the actual length of the input data stream.
Specifies several options applicable to terminal input operations. This parameter is never required and should be specified only when appropriate. The OPTNS-parameter values must be enclosed in parentheses. If multiple values are specified, each is separated from the previous one by a comma.
Allocates a buffer area for the data being read into the program, rather than a user-defined area. The system allocates the buffer when the read operation is completed. Register 1 contains the address of this buffer on completion of the input operation. The issuing program is responsible for releasing the buffer area, using a #FREESTG command. When this option is requested, INAREA and MAXIN should not be specified.
(3270 devices only); requests that the system save the line of input data as displayed on the screen in the current page. If OPTNS=ECHO is not specified, data entered will not be retained and will not be available for review by the terminal operator.
(3270 devices only); causes the first line of output that follows the #LINEIN to be unprotected. At runtime, the terminal operator can reuse the unprotected first line of an output display for input to a subsequent #LINEIN. The UNPROT option can be used with or without the ECHO parameter. For example, if the terminal operator has made an error in previous input data, the data that is retained by the ECHO option can be rekeyed and corrected. If UNPROT is not included, all lines of the following output display remain protected.
(3270 devices only); requests the system not to keep pages that have been input in a scratch area. If NOBKPG is specified, the terminal operator can view only the current page of data. NOBKPG is valid only with the first request in a line mode session.
Directs the system to translate all letters in a #LINEIN request into uppercase characters.
Specifies that no uppercase translation of characters in a #LINEIN request be performed.
Specifies that the operator's response to the #LINEIN command will not appear on the screen as it is typed in. This option is useful when expecting a secret password to be entered.
Specifies whether this #LINEIN is conditional and under what conditions control should be returned to the issuing program.
(Default); specifies that the request is not conditional.
Specifies that the request is conditional. Control is returned if the request cannot be serviced for any of the reasons listed below.
Specifies conditions under which the system returns control to the issuing task. Multiple conditions must be enclosed in parentheses and separated by commas.
The input data is truncated due to insufficient storage in the specified INAREA.
The line I/O session is terminated by the terminal operator pressing CLEAR (3270), ATTENTION (2741), or BREAK (teletype).
A logical or permanent I/O error is encountered in the input data stream.
There is an invalid parameter in the LRB.
Specifies the symbolic name of the routine to which control should be returned if input data is truncated due to insufficient storage in the INAREA buffer.
Specifies the symbolic name of the routine to which control should be returned if the line I/O session is terminated by the terminal operator.
Specifies the symbolic name of the routine to which control should be returned if a permanent or logical error is detected in the input data stream.
Specifies the symbolic name of the routine to which control should be returned in the event of an invalid parameter in the LRB.
Specifies the symbolic name of the routine to which control should be returned if a condition specified in the COND parameter occurs for which no other exit routine was coded.
|
Copyright © 2014 CA.
All rights reserved.
|
|