|
|
Process Help SUPEST - write a perimeter file to a SURPAC string file |
|
Process Name |
Menu Path |
Link to Command Table |
|
SUPEST |
Data ribbon | Transfer | Surpac | Output Surpac2 String File |
Introduction
Converts a Datamine perimeter file to a SURPAC string file.
How to use
The compulsory standard fields of a Datamine perimeter file are PVALUE, PTN, XP,YP,ZP and optionally PCODE (4 character alphanumeric). In SURPAC the first and last point in a perimeter are identical if closed, whereas your application automatically closes a perimeter. The standard fields in a SURPAC string file are STRING NUMBER, Y,X,Z, DESCRIPTION. STRING NUMBER is in the range 1-98, so the allocation of STRING NUMBER is done as using the @STRNO parameter.
Files, Fields and Parameters
Input Files
|
Name |
Description |
I/O Status |
Required |
Type |
|
IN |
Input perimeter file with the standard fields PVALUE,PTN,XP,YP,ZP and optionally PCODE. |
Input |
Yes |
String |
Output Files
|
Name |
I/O Status |
Required |
Type |
Description |
Fields
|
Name |
Description |
Source |
Required |
Type |
Default |
|
XP |
Standard perimeter field XP (XP). |
IN |
No |
Numeric |
XP |
|
YP |
Standard perimeter field YP (YP). |
IN |
No |
Numeric |
YP |
|
ZP |
Standard perimeter field ZP (ZP). |
IN |
No |
Numeric |
ZP |
|
DESC1 |
First field to be included in the string file comment. |
IN |
No |
Any |
Undefined |
|
DESC2 |
Second field to be included in the string file comment. |
IN |
No |
Any |
Undefined |
|
DESC3 |
Third field to be included in the string file comment. |
IN |
No |
Any |
Undefined |
Parameters
|
Name |
Description |
Required |
Default |
Range |
Values |
|
STRNO |
Method of calculating SURPAC string number (0). SURPAC string numbers are in the range 1-98. STRNO=0 uses the PVALUE field STRNO=n increments the PVALUE from n. |
No |
0 |
Undefined |
Undefined |
Notes
After completing the dialog you are prompted for the following:
|
>SYSFILE> |
String file pathname |
|
>JOBID> |
SURPAC jobid (max 10 characters) |
|
>DATE> |
Date (max 8 characters). Leave blank to use the current system date |
|
>PURPOSE> |
Purpose of string file (max 42 characters) |
Example
!SUPPEST &IN(PITPER), @STRNO=0
>SYSFILE >SURSTR
>JOBID >
>DATE >
>PURPOSE >
Error and Warning Messages
|
Message |
Description |
Solution |
|
>>> NOT A VALID PERIMETER FILE <<< |
The &IN perimeter file specified does not contain one of the compulsory fields PVALUE, PTN, XP,YP,ZP. Fatal; the process is exited. |
|
|
|
|
|
|
>>> INVALID STRING NUMBER: NSTR = nnnnnnnnnnn <<< |
The STRING NUMBER is outside the valid range of 1 to 98. Fatal; the process is exited. |
|
|
|
|
|
|
>>> POINT NUMBER NOT IN SEQUENCE, PTN = nnnnnnnnn <<< |
The PTN (point number) is out of sequence in the &IN perimeter file specified. Fatal; the process is exited. |
|
|
|
|
|
|
>>> NO POINTS AVAILABLE FOR SUPEST OUTPUT <<<
|
No perimeter points were found to output to the SURPAC string file. Fatal; the process is exited. |
|
|
|
|
|
|
>>> FIELD ffffffff DOES NOT EXIST <<< |
One of the fields specified for *XP, *YP, *ZP does not exist in the &IN perimeter file specified. Fatal; the process is exited. |
|
|
|
|
|
