SHOW-INPUT-HISTORY

Output buffered input to SYSOUT

Component:	SDF
Functional area:	SDF control
Domain:	SDF
Privileges:	STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

The SHOW-INPUT-HISTORY command outputs the contents of the input buffer to
SYSOUT. This enables information to be provided on previous inputs. The user can then request a specific input via the RESTORE-SDF-INPUT command and enter it again, either as it is or in modified form, without having to retype it. For an input to be reused, however, at least one character in the input string must be changed (e.g. you can overwrite a character with the same character).

For identification purposes in the RESTORE-SDF-INPUT command, the information can be requested with input serial numbers (operand: INPUT-SERIAL-NUMBER=*YES).

The user can restrict the scope of the output of the input buffer as follows:

• Specify the maximum number of saved inputs to be displayed (ENTRIES operand); the default value is eight.

• Specify the desired input type (SELECT operand) - either commands or statements; the default is commands.

• Specify a wildcard search pattern (PATTERN operand). Only commands or statements which match this string are displayed; the default value is no search pattern used.

The input buffer is controlled (activated/deactivated and deleted) via the MODIFY-SDF-OPTIONS command. Inputs in guided dialog are saved in ACCEPTED form, while inputs in unguided dialog are saved in INPUT form.
The SHOW-INPUT-HISTORY command or statement is not saved.

Values specified for “secret” operands which match neither the default value nor a value defined via SECRET=*NO are saved in the input buffer with “^”.
In unguided dialog when these values are displayed again with SHOW-INPUT-HISTORY, the user can do one of the following:

• send off the command/statement unchanged. In this case, SDF displays a blanked input field for each secret operand for the user to enter the desired value

• delete the “^” and insert the desired value directly before sending off the command/statement.

In programs with an SDF interface, SHOW-INPUT-HISTORY is available as a standard statement with the same functionality. 

Format

SHOW-INPUT-HISTORY	Alias: SHIH
ENTRIES = 8 / <integer 1..100> / *ALL ,SELECT = *CMD / *ALL / *STMT ,PATTERN = *NONE / <structured-name 1..30 with-wild> ,INPUT-SERIAL-NUMBER = *NO / *YES

Operands

ENTRIES = 8 / <integer 1..100> / *ALL
Determines the maximum number of entries to be displayed. If *ALL is specified, the entire contents of the buffer are displayed.

SELECT = *CMD / *ALL / *STMT
Specifies the type of entries to be displayed.

SELECT = *CMD
Only commands are displayed.

SELECT = *ALL
Commands and statements are displayed.

SELECT = *STMT
Only statements are displayed.

PATTERN = *NONE / <structured-name 1..30 with-wild>
Specifies whether the entries to be displayed are to be selected according to a pattern string. The default value is *NONE (i.e. no pattern string). If a pattern string is specified, only entries which match it are displayed.

INPUT-SERIAL-NUMBER = *NO / *YES
Specifies whether the entries are to be displayed with their input serial numbers. The default value is *NONE (i.e. input serial numbers not shown). The input serial numbers can be used with RESTORE-SDF-INPUT to select the desired entry.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without errors
1	0	CMD0001	Output not possible because input buffer empty. Guaranteed message: CMD0560
1	32	CMD0500	Syntax description in current syntax file invalid. Guaranteed message: CMD0500
1	64	CMD0560	Command execution not successful. Guaranteed message: CMD0560

Example

See RESTORE-SDF-INPUT command.