| 1 | Session handle | Input | Binary(4) |
| 2 | Data | Input | Char(*) |
| 3 | Data length | Input | Binary(4) |
| 4 | CCSID | Input | Binary(4) |
| 5 | Error code | I/O | Char(*) |
| Return code | Output | Binary(4) |
The Write Characters to Scroller with CCSID (QsnWrtSclChrCC) API writes one or more characters to the scroller starting at the active position. The active position following this operation is one position past the last character written or that specified by a control character sequence if it appears at the end of the data. If the entire data string cannot fit in the scroller buffer, no portion of the string will be written.
Note: CDRA conversion is not performed upon this data.
This command is not supported by all control units. A CPFA306 error occurs if an attempt is made to issue this command to a control unit that does not support it.
The CCSID value given must be supported by the device or emulator, otherwise a CPF3BDE will be signaled.
None
A handle for the session to which the scroller characters are to be written.
The characters in the CCSID given by the CCSID parameter to be written to the scroller. If the data does not fit within the width of the session window, it is wrapped across multiple lines or truncated, depending on the value of the wrap indication field on the session description.
The length of the data parameter.
The CCSID of the data to be written. If the CCSID given is not supported by the device, a CPF3BDE is signaled.
If this parameter is omitted (zero is passed in as the CCSID), the job CCSID is used. If the job CCSID is 65535, the default job CCSID is used instead.
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.
A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3BDE E | CCSID &1 not supported by API. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPFA333 E | Parameter &1 not positive integer value. |
| CPFA31E E | Required parameter &1 omitted. |
| CPFA343 E | Output operation not done. |
| CPFA344 E | The file &2 in library &3 is not valid. |
| CPFA345 E | The invite active flag is not valid. |
| CPFA3D6 E | Session handle is incorrect. |
| CPFA3D7 E | Data for scroller is too long. |
[ Back to top | Dynamic Screen Manager APIs | APIs by category ]