修改文件头

Synopsis

FHMOD/'filespec'[,FNAME,'filename'][,OWNER,'owner'][,STATUS,status][,PCLASS,'class'][,DESCR,'description'][,CAREA,'customer area'][,IFERR,label:]

Description

This allows you to change the information in the header of any file to which you have proper access. This command only modifies the file on disk. See PHMOD to modify a part loaded in memory.

NOTE: If you try to modify a field that is not supported by your current file system, FHMOD will ignore the request for that field.

You must have read access to the file in order to modify the information in the status, description or customer area fields. These fields are valid for part files only.

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

Parameters

Parameter

Description

'filespec'

The filespec is the pathname plus the filename you want. If the file you need is in your current directory, the filename should be sufficient to find it. The FHMOD statement requires that the file extension (e.g..PRT, or .GRS) be specified.

FNAME

Minor word which indicates that the file name is to be changed.

'filename'

The new file name which may be up to 30 characters long, including the file type extension .GRS, .PRT, etc.

OWNER

Minor word which indicates that the owner of the file is to be changed.

'owner'

The new owner of the file. You must have sufficient file access permissions to change ownership of a file.

STATUS

Minor word that indicates that the file status is to be changed. You must have read access to the file in order to modify the status field. This field is valid for part files only.

NOTE: The file status is any valid Unigraphics number.

status

A number which represents a user defined status.

NOTE: This field is restricted to 8 characters for file systems.

PCLASS

Minor word which indicates that the protection class of the file is to be changed.

'pclass'

The new protection class of the file. You must have sufficient file access permissions to change protections of a file.

DESCR

Minor word that indicates that the file description field is to be changed. You must have read access to the file in order to modify the description field. This field is valid for part files only.

NOTE: The file description field is a user defined feature.

'description'

The new file description field which may be up to 132 characters long.

CAREA

Minor word that indicates that the customer area field is to be changed. You must have read access to the file in order to modify the customer area field. This field is valid for part files only.

NOTE: The customer area field is a user defined feature.

'customer area'

The new customer area field which may be up to 132 characters long.

IFERR,label:

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

Filename Lengths

Unless otherwise stated, filename lengths are limited to 132 characters which includes any periods or extensions. This includes directory names and part file names. Pathnames are limited to 256 characters. Valid characters for a filename depend on the operating system.

Parameter	Description
'filespec'	The filespec is the pathname plus the filename you want. If the file you need is in your current directory, the filename should be sufficient to find it. The FHMOD statement requires that the file extension (e.g..PRT, or .GRS) be specified.
FNAME	Minor word which indicates that the file name is to be changed.
'filename'	The new file name which may be up to 30 characters long, including the file type extension .GRS, .PRT, etc.
OWNER	Minor word which indicates that the owner of the file is to be changed.
'owner'	The new owner of the file. You must have sufficient file access permissions to change ownership of a file.
STATUS	Minor word that indicates that the file status is to be changed. You must have read access to the file in order to modify the status field. This field is valid for part files only. NOTE: The file status is any valid Unigraphics number.
status	A number which represents a user defined status. NOTE: This field is restricted to 8 characters for file systems.
PCLASS	Minor word which indicates that the protection class of the file is to be changed.
'pclass'	The new protection class of the file. You must have sufficient file access permissions to change protections of a file.
DESCR	Minor word that indicates that the file description field is to be changed. You must have read access to the file in order to modify the description field. This field is valid for part files only. NOTE: The file description field is a user defined feature.
'description'	The new file description field which may be up to 132 characters long.
CAREA	Minor word that indicates that the customer area field is to be changed. You must have read access to the file in order to modify the customer area field. This field is valid for part files only. NOTE: The customer area field is a user defined feature.
'customer area'	The new customer area field which may be up to 132 characters long.
IFERR,label:	Specifies a label to which the program jumps if an error occurs.