[ Previous |
Next |
Contents |
Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference
SET CURSOR (40)
Purpose
Sets the position of the cursor within the currently connected host Presentation Space (PS).
Prerequisite Calls
This function requires a prerequisite call to the CONNECT PRESENTATION SPACE (1) function.
Syntax
hllc (func, apistring, len, ret)
int *func;
char *apistring;
int *len;
int *ret;
Supplied Parameters
Supply the following parameters to invoke the SET CURSOR function:
| func |
Specifies the number of the function called; must be 40 for the SET CURSOR function. |
| apistring |
Does not apply for this function. |
| len |
Does not apply for this function. |
| ret |
Specifies the desired cursor position in the connected host PS. |
Returned Parameters
| ret |
The following codes are valid:
| 0 |
Specifies that the cursor was successfully located at specified position. |
| 1 |
Specifies that your program was not connected to the host session. |
| 4 |
Specifies that the session was busy. |
| 7 |
Specifies that a cursor location less than one or greater than the maximum PS size was specified. |
| 9 |
Specifies that a system error occurred. |
|
Remarks
The SET CURSOR function sets the position of the cursor within the currently connected host PS. Before using the SET CURSOR function, connect first to the host PS.
DBCS Remarks
If the desired cursor position is the second byte of a DBCS character, it is moved to the first byte of the DBCS character.
Related Information
CONNECT PRESENTATION SPACE (1) function and DISCONNECT PRESENTATION SPACE (2) function.
[ Previous |
Next |
Contents |
Search ]