Copy String to Presentation Space (15)

 Top  Previous  Next

The Copy String to Presentation Space function copies an ASCII data string directly into the host presentation space at the location specified by the PS position calling parameter.

 

3270

5250

Yes

Yes

 

 

Prerequisite Calls

 

Connect Presentation Space (1)

 

 

Call Parameters

 

 

Standard Interface                   Enhanced Interface

Function Number

Must be 15.

Data String

String of ASCII data to be copied into the host presentation space.

Length

Length, in number of bytes, of the source data string. Overridden if in EOT mode.

PS Position

Position in the host presentation space to begin the copy, a value between 1 and the configured size of your host presentation space.

 

 

Return Parameters

 

Return Code

Explanation

0

The Copy String to Presentation Space function was successful.

1

Your program is not connected to a host session.

2

Parameter error or zero length for copy.

5

The target presentation space is protected or inhibited, or incorrect data was sent to the target presentation space (such as a field attribute byte).

6

The copy was completed, but the data was truncated.

7

The host presentation space position is not valid.

9

A system error was encountered.

 

 

Remarks

 

1.The Copy String to Presentation Space function is affected by the following options:
•STRLEN/STREOT
•EOT
•EAB/NOEAB
•XLATE/NOXLATE
•PUTEAB/NOPUTEAB
•EAD/NOEAD (for DBCS only)
•NOSO/SPACESO/SO (for DBCS only)
•EXTEND_PS/NOEXTEND_PS
2.The keyboard mnemonics (see Send Key (3) function) cannot be sent using the Copy String to Presentation Space function.
3.The string ends when an end-of-text (EOT) delimiter is encountered in the string if EOT mode was selected using the Set Session Parameters (9) function.
4.Although the Send Key (3) function accomplishes the same purpose, this function responds with the prompt and enters a command more quickly. Because the Send Key (3) function emulates the terminal operator typing the data from the keyboard, its process speed is slow for an application operating with a lot of data. This function provides a faster input path to the host.
5.The original data (the copied string) cannot exceed the size of the presentation space.
6.DBCS Only: Double-byte characters can be included as a part of the string.