p command (PROC processor)

The p command processes the commands in the currently active output buffers. The primary output buffer is processed first, followed by the secondary output buffer. Both the primary and secondary output buffers are automatically reset after the p command, and the active buffer pointer is reset to point to the primary output buffer.

Syntax

p{option}

Parameter(s)

`option`	Type of additional options to perform:
	h	Suppress output to the terminal.
	p	Display the contents of both output buffers.
	w	Display the contents of both output buffers, then wait for response from the terminal. Valid responses are:
		`g` or pressing ENTER	Proceeds with the process.
		`s`	Skip to the next command in the Proc.
		`x` or `n`	Abort the Proc.
	x	After the TCL command has been processed, abort the rest of the Proc, if any, and return to TCL.

Description

The p command submits the contents of the primary output buffer to TCL for processing. The contents of the secondary output buffer are used as input for other interactive processors. If the secondary output buffer or stack contains any data and the last character is not a carriage return, the system appends a carriage return to the stack.

After the TCL command completes, the Proc resumes at the next statement after the p command. The input buffers are unchanged. The output buffers are cleared and their pointers are reset.

Example(s)

hlist entity
h name address
p
o report completed at +
htime
p

The first p command in this example processes the AQL sentence, list entity name address. The second p command processes the TCL time command.

hselect entity by name
ston
hsave-list entity.by.name
p

The p command in this example processes the commands in both output buffers.

hsselect entity by name
ston
hsave-list entity.list
px
oEND OF PROC