Purpose

LINK-CRT calls an external procedural language routine from PROIV and provides for screen refreshing. 
 

Syntax

variable = LINK-CRT(name,param1…)
 

Operation

name is the subroutine name.
param1... is the parameter (or parameters) to be passed to the subroutine
variable is the return code
 

Remarks

Control is passed to the procedural language routine, and when it completes processing control automatically returns to the PROIV logic statement immediately following the LINK-CRT statement. 

LINK-CRT performs the following actions:

Flushes any pending PROIV screen output.
Resets terminal connection characteristics to those in effect before PROIV was invoked.
Calls the external subroutine.
Resets terminal connection characteristics to those required by PROIV.
Schedules the screen to be redrawn immediately prior to the next PROIV input field.


The resetting of terminal connection characteristics may cause input that the user has already typed, but which has not yet been accepted, to be lost.

The screen is not cleared.  This must be done by the external routine if required.

Output from the external routine is not under PROIV’s control and so PROIV features such as report-to-screen paging cannot be applied to it.

See also LINK and LINK_CLIENT_VAR.