INITIALIZE STRING
CALL SEQUENCE
PINST (WKID, STDNR, LSTR, ISTR, PET, XMIN, XMAX, YMIN, YMAX, LDR, DATREC)
INPUT PARAMETERS
INTEGER WKID
INTEGER STDNR
INTEGER LSTR
CHARACTER*(*) ISTR
INTEGER PET
REAL XMIN, XMAX, YMIN, YMAX
INTEGER LDR
CHARACTER *80 DATREC(LDR)
ARGUMENTS
- WKID
- Workstation identifier.
- STDNR
- STRING input device identifier.
- LSTR
- Number of characters in the initial string.
- ISTR
- Initial string.
- PET
- Echo type.
- XMIN, XMAX, YMIN, YMAX
- Echo zone in DC.
- LDR
- Number of data records.
- DATREC(LDR)
- Data record.
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
This function restricts the 3D initialize string function to 2D.
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 61
- Ignoring function, specified workstation is neither of category INPUT nor
of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 251
- Ignoring function, the function requires the input device to be in REQUEST
mode
- 254
- Ignoring function, invalid echo area volume: XMIN>=XMAX, YMIN>=YMAX
- 255
- Ignoring function, one of the echo area volume boundary points is outside
the range of the device
- 253
- Ignoring function, the specified prompt echo type is not available on the
specified workstation
- 260
- Ignoring function, one of the fields within the input device data record is
in error
- 261
- Ignoring function, initial value is invalid
- 263
- Ignoring function, length of the initial string is greater than the buffer
size
SEE ALSO
initialize string 3, set string mode, request string, sample string, get
string, inquire string device state, inquire default string device state,
inquire number of available logical input devices