|
|
|
|
The Copy Presentation Space function copies the entire contents of the presentation space to a string in your application program. Copied characters are translated into ASCII values before being stored in the data string.
Your application program must be connected to a valid presentation space before issuing the request for this function. Use Connect Presentation Space to connect to a presentation space.
Your application program must pass the following parameters to this function:
An empty data string defined in your application program. This string must be large enough to hold all of the information in the current presentation space. Presentation Space Sizes, shows the PS sizes for each of the display models.
If the option is set in Set Session Parameters , the string must be at least twice the PS size to allow for the EAB characters.
This parameter is not used.
This parameter is not used.
This function returns the following parameters to your application program:
5
Contents of the current presentation space.
This parameter is not used.
The valid return codes for this function are:
Function was successful; presentation space is active, keyboard is unlocked, and contents of host presentation space were copied to your application program.
Application program is not connected to a valid presentation space.
Copy was successful, but presentation space is waiting for host response.
Copy was successful, but keyboard is locked.
System error occurred.
This function is affected by the following options of the Set Session Parameters function:
Causes field attribute bytes to be included unchanged in the returned string.
Causes field attribute bytes to be returned as blanks.
Copies each character from the presentation space followed by its extended attribute byte.
Does not copy attribute bytes.
If the option is set, causes the copied extended attribute bytes to be translated into CGA format.
If the option is set, causes extended attribute bytes to be copied without translation.
For more information, see Set Session Parameters.
Usage and restrictions are:
Use this function to copy the entire presentation space. Use Copy Presentation Space to String when you need to copy only a portion of the presentation space.
The predefined data string in your program must be at least the size of the presentation space from which the data is copied. If you use this function with different 3270 screen models, you can use Query Sessions to find the size of the current presentation space.
If the option has been set in Set Session Parameters, the length of the target string must allow for the additional EAB characters as well as the data characters. If extended attributes are not used by the host program, the EAB characters will be returned as nulls (0x00).
|
|
|
 |
|