[ Previous |
Next |
Contents |
Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference
CONVERT POSITION or CONVERT ROWCOL (99)
Purpose
Converts the host presentation space (PS) positional value into the display row-column coordinates or converts the display row-column coordinates to the host PS positional value.
Prerequisite Calls
This function requires no prerequisite calls to other functions.
Syntax
hllc (func, apistring, len, ret)
int *func;
char *apistring;
int *len;
int *ret;
Supplied Parameters
Supply the following parameters to invoke the CONVERT POSITION or CONVERT ROWCOL function:
func |
Specifies the number of the function called; must be 99 for the CONVERT POSITION or CONVERT ROWCOL function. |
apistring |
Specifies the host PS short session ID and P for the CONVERT POSITION function (for example, AP
converts the position of session A
).
OR |
|
Specifies the host PS short session ID and R for the CONVERT ROWCOL function (for example, AR
converts the row and column position of session A
). |
|
|
|
len |
Specifies a row when R is in the supplied data string parameter. Valid input is a number between 1 and the maximum row length (typically 24). This parameter is not applicable when P is specified in the supplied data string parameter. |
ret |
Specifies a column when R is specified in the supplied data string parameter. Valid input is a number between 1 and the maximum column (typically 80).
OR |
|
Specifies the host PS position when P is specified in the supplied data string parameter. Valid input is a number between 1 and the maximum PS size (typically 1920). |
|
|
|
Returned Parameters
len |
For the CONVERT POSITION function, a number between 1 and the maximum row is returned. This value is the number of the row that contains the PS position specified in the supplied PS position parameter. For the CONVERT ROWCOL function, a value of 0 indicates an error in the input value for row (calling the len parameter). |
ret |
The CONVERT POSITION or CONVERT ROWCOL function is the exception to the rule that the return code parameter always contains a return code. For this function, the value returned in the return code parameter is a status code. The following status codes are valid:
0 |
Specifies that incorrect column input was provided. |
>0 |
Specifies that this is the PS position or column. |
9998 |
Specifies that an invalid host PS ID was specified or a system error occurred. |
9999 |
Specifies that the input character string in position two is neither P nor R. |
|
Remarks
When converting the PS into a row-column format, this function does not change the cursor position. To determine how many rows and columns there are in your PS size, refer to bytes 13 and 15 of the returned data string for the QUERY SESSION STATUS (22) function.
Related Information
QUERY SESSION STATUS (22) function.
[ Previous |
Next |
Contents |
Search ]