Use FileEdit to create an Edit session of an existing file.
FileEdit may also be entered as FileEd[it], EditFile, EdFile, or Ed[it].
Optional Operands
FILE is the BIM, workstation, PDS, or VSE file to be edited.
Default: last referenced file.
LIST [relevant for BIM, PDS, and VSE files] specifies whether FileEdit will create a List session of FILE if Edit access to FILE is denied for security reasons or because FILE has the CHECK attribute on. Specify "On" or "Yes" to create a List session. Otherwise, specify "Off" or "No".
Default: No.
FileEdit can also be invoked by entering the ContextEdit command while a FileLibrary or FileScan session is current.
Before FILE can be edited, it must be created by either the FileDefine or FileCopy commands. FileEdit creates a session with the text and attributes of an existing file. FILE is updated only when the Edit session is saved (see the SessionSave and SessionFile commands). Before the session is saved, you can use the NOSAVE option of the SessionClose command to end the Edit session without updating the file.
For workstation files, if attributes have never been defined for the file, FileEditwill use attributes from a template file (see Template files).
FileEdit sets the last referenced file.
When Valid
FILE cannot be currently undergoing editing.
For Host files, the user must have EDIT access level for the FILE directory. FILE cannot be check-out slave assigned to another user. FILE cannot be a check-out master (have CHECK=ON) -- use the FileCheckout command to create a slave (working) copy.
Return Codes
OK Successful.
CK One of the following:
File is under checkout control.
File is checked out to another user.
ED File is already being edited.
NF File not found.
SC Inadequate access level.
Procedure Notes
FileEdit sets the TXM variables to the attributes of FILE.
Examples
Edit workstation file EdtMain.C:
=> ed edtmain.c
Edit BIM file RM3521:
=> ed rm3521