[ 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 ]