阅读部分文件头

Synopsis

PHREAD/['filename',]{STATUS[,status]|,DESCR[,description]|,CAREA[,customer area]|,MCHFMT,[machineformat]|,RELNO,[release num]}[,IFERR,label:]

Description

Allows you to read the status, description and customer area information of part files which were created in native file systems. This function applies to part files only, no other types of files may be read.

You must specify at least one of the minor words STATUS, DESCR, CAREA, MCHFMT, or RELNO.

NOTE: PHREAD and PHMOD should be used together, as should FHREAD and FHMOD. Do not mix their usage (i.e., don't use PHREAD with FHMOD).

Parameters

Parameter

Description

'filename'

The name of the part file to access, which may be up to 128 characters long, including the file type extension (.PRT). If the part file is loaded, then the loaded version of the part is accessed; otherwise, the part file on disk is accessed. If the file name is not specified, then the current work part is accessed.

STATUS

Minor word that indicates that the file status is to be read. The file status is any valid Unigraphics number.

status

A number variable which represents a user defined status.

DESCR

Minor word that indicates that the file description field is to be read. The file description field is a user defined feature string up to 132 characters.

description

A string variable which contains the file description field.

CAREA

Minor word that indicates that the customer area field is to be read. The customer area field is a user defined string up to 132 characters for native file systems.

customer area

A string variable that contains the customer area field.

MCHFMT

Minor word that indicates that the machine format field is to be read. The machine format field is a system defined feature and cannot be modified. It is a string of up to 3 characters.

machine format

A string variable that contains the machine format field. This variable must be declared as a minimum of 3 characters.

RELNO

Minor word that indicates that the release version number is to be read. This field tells the user on which Unigraphics version the part was last filed. The release version number field is a system defined feature and cannot be modified.

release num

A string variable that contains the Unigraphics release version number. This variable must be declared as a minimum of 3 characters.

IFERR,label:

Specifies a label to which the program jumps if an error occurs.

Parameter	Description
'filename'	The name of the part file to access, which may be up to 128 characters long, including the file type extension (.PRT). If the part file is loaded, then the loaded version of the part is accessed; otherwise, the part file on disk is accessed. If the file name is not specified, then the current work part is accessed.
STATUS	Minor word that indicates that the file status is to be read. The file status is any valid Unigraphics number.
status	A number variable which represents a user defined status.
DESCR	Minor word that indicates that the file description field is to be read. The file description field is a user defined feature string up to 132 characters.
description	A string variable which contains the file description field.
CAREA	Minor word that indicates that the customer area field is to be read. The customer area field is a user defined string up to 132 characters for native file systems.
customer area	A string variable that contains the customer area field.
MCHFMT	Minor word that indicates that the machine format field is to be read. The machine format field is a system defined feature and cannot be modified. It is a string of up to 3 characters.
machine format	A string variable that contains the machine format field. This variable must be declared as a minimum of 3 characters.
RELNO	Minor word that indicates that the release version number is to be read. This field tells the user on which Unigraphics version the part was last filed. The release version number field is a system defined feature and cannot be modified.
release num	A string variable that contains the Unigraphics release version number. This variable must be declared as a minimum of 3 characters.
IFERR,label:	Specifies a label to which the program jumps if an error occurs.