Print Scroller Data (QsnPrtScl) API

The Print Scroller Data (QsnPrtScl) API prints the entire contents of the scroller data to the default printer file. No printer output is produced if the scroller is empty. CCSID-based data in the scroller is converted to the job CCSID before being printed.

Restrictions

If the low-level environment description (see Format of the Low-Level Environment Description) for the session specifies DBCS support, or the device supports CCSID-based I/O, the printer file must have a record length greater than or equal to 4. A CPCA3D2 will be placed on the session message line otherwise. This can occur if the application uses the OVRPRTF (Override with Printer File) CL command.

Authorities and Locks

None

Required Parameter

Session handle

INPUT; BINARY(4)

A handle for the session that the operation applies to.

Omissible Parameter

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.

Returned Value

Return code

OUTPUT; BINARY(4)

A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.

Error Messages