Syntax
SENDPRINT [ AS report_name ] device [ expression ] [ AT expression ]
Parameters
SendPrint can be abbreviated as Send or SP.
AS report_name
Indicates the report is an outputstream with a different name, specified by the qualifier.
device
The device to direct output to, as listed below in Device Types.
expression
The name of the destination output device.
This is only an optional parameter if the LP device type is specified. It is a required parameter if one of the TP, VD, or EX device types are specified.
AT expression
The At command option is not supported on applications deployed to Windows.
For MCP, this option only applies to ROC reports directed to LP, RP and TP devices. The hostname value is a literal specifying the host.
Description
The SendPrint logic command outputs a report to multiple destinations. It is applicable only to Standard reports printed under the ROC system. It is ignored for ROC Direct reports (and, on MCP-based systems, all reports that do not use ROC).
Output to the specified device or devices does not commence until a Release logic statement or end-of-job is encountered. If directed to a video device, output must be explicitly requested by the receiving terminal through the ROC menu.
Note: The SendPrint logic command is for use in Reports only. The use of this command in Ispecs and Messengers is invalid or is ignored.
Device types
The following table lists available device types.
Device | Host Type | Description |
---|---|---|
EX | Windows MCP | ROC alias or the Glb.Stn value Extract file (standard system data file) |
LP | Windows MCP | Command defined by the LP alias Line printer |
RP | Windows MCP | (This device type is not supported on applications deployed to Windows.) Remote printer, via Prints/Reprints |
TP | Windows MCP | Temporary file for direct reports User-defined terminal printer |
VD | Windows MCP | Temporary file for direct reports. For other reports, no output request is created. The attached user terminal |
Failure behavior
The Glb.Status built-in segment attribute is set to "*****" if invalid device types or destinations are specified, or if no output has been produced by the report. Otherwise, Glb.Status is set to spaces upon completion of the SendPrint logic command.
Restrictions
The following restrictions apply to use of the SendPrint logic command:
It is restricted to standard reports printed under ROC. It is ignored for ROC direct reports.
It must come after the first Print method invocation of a report.