SUPEST Process

To access this process:

Enter "SUPEST" into the Command Line and press <ENTER>.
Display the Find Command screen, locate SUPEST and click Run.

See this process in the Command Table.

Process Overview

Converts a Datamine perimeter file to a SURPAC string file.

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.

The following prompts appear on running the process:

>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)

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

Fields

Name	Description	Source	Required	Type	Default
XP	Standard perimeter field XP.	IN	No	Numeric	XP
YP	Standard perimeter field YP.	IN	No	Numeric	YP
ZP	Standard perimeter field 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

Example

!SUPPEST     &IN(PITPER), @STRNO=0>SYSFILE 
>SURSTR
>JOBID 
>>DATE 
>>PURPOSE >

Error and Warning Messages

Message	Description
>>> 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.