[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPRQST - Request String

GPRQST (wsid, device, length, status, number, string)

Purpose

Use GPRQST to have the graPHIGS API execute a request to the specified string device.

The graPHIGS API returns a character string from the device.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

String device number (>=1)

length -- specified by user, fullword integer

Length of string array in bytes provided by the application for the graPHIGS API to return the string information (>=1)

status -- returned by the graPHIGS API, fullword integer

Status of string input (1=NONE, 2=OK )

number -- returned by the graPHIGS API, fullword integer

Number of bytes returned.

string -- returned by the graPHIGS API, variable length character string

Character string.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
140
DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
141
INPUT DEVICE NOT IN CORRECT MODE
168
INPUT DEVICE IS CURRENTLY OWNED BY ANOTHER CONNECTION
505
LENGTH OF RETURN ARRAY < ZERO

Related Subroutines

GPINST
Initialize String
GPQLI
Inquire List of Logical Input Devices
GPSTMO
Set String Mode

RCP code

201335564 (X'0C00230C')

[ Previous | Next | Contents | Glossary | Home | Search ]