PROFILE - Display Current File Profile Variables

Syntax


PROFILE

[  { LOCK | UNLOCK }      |

  { RESET }              |

  { COPY profile-name }  |

  { USE  profile-name }  |

  { NEW  profile-name }  |

  { EDIT [ profile-name ] }    ]


Operands


LOCK

Requests the profile be LOCKED.  When locked, all changes to the profile will be in effect only for the duration of the current edit session; and are not written to permanent profile storage.


UNLOCK

Requests the profile be UNLOCKED.  When unlocked, changes to profile variables are saved to permanent storage and will be used in all future edits of this file type.


The permanent storage for a profile is a text file in the SPFLite\Profiles directory, with a name of profile-name.INI


RESET

Requests all profile variables be reset to the SPFLite standard values (described below)


COPY profile-name

Requests all profile variables be copied from another existing file profile.


USE profile-name

Requests this profile to use another specified profile's values as its own.   This is particularly useful in some programming languages which use a variety of file types to store data, but whose editing characteristics are identical.  (An example is the C language that uses .C for programs and .H for header files, both of which are formatted and handled the same way.)  It allows multiple file types to 'share' a profile so that a change to a variable need only be done once to have it take effect over all the shared file types.  The keyword USE may also be specified as USING.


NEW profile-name

Some of the profile variables (such as LRECL, SOURCE and EOL) affect how SPFLite loads a file into the edit work space.  If the file type profile has the incorrect values, the data will not load correctly.   Thus, for the 1st time edit of the file, you need the profile to have already been created.  NEW provides this ability; see below.


EDIT profile-name

Will bring up the Profile edit dialog for an existing Profile.  If several changes to profile settings are going to be made at the same time, it may be easier to make these changes using the dialog rather than doing it with a series of  primary commands.


Note: If no profile-name is entered, EDIT will open the dialog for the currently active profile.

Abbreviations and Aliases

PROFILE can also be spelled as PRO or PROF

LOCK can also be spelled as LOCKED

UNLOCK can also be spelled as UNLOCKED

USE can also be spelled as USING

Description


If the PROFILE command is entered without any operands, it will cause SPFLite to insert a series of =PROF> lines into the text display showing the current status of all Profile settings for the current file type. Special lines for =COLS>, =WORD>, =TABS>, =BNDS> and =MARK> will also be displayed, since these settings are part of the Profile.



Here is a sample display that will be produced by using PROFILE without operands:




The PROFILE LOCK and PROFILE UNLOCK commands alter the LOCK status of a profile.  When a profile is locked, any changes made are in effect for that edit session only and are not saved.


PROFILE RESET can be used if you want to discard all modifications you have made and start over with a standard default set of Profile options.


Note that PROFILE commands that contain a profile-name operand are order dependent.  That is,



This is done so that any name can be used for a profile name, including keywords from the PROFILE command.  


For example, the command PROFILE USE USE is legal.  The first USE is a keyword designating a PROFILE USE command, and the second USE is the profile's name which corresponds to the file's type, and just so happens to be spelled the same as a keyword.


Creating a Profile before needed


The PROFILE NEW profile-name option allows you to set up a profile before its first use.  This is mandatory when creating profiles for files such as EBCDIC mainframe files, or other non-standard formats.  To create such a profile ahead of time, do the following:







Your new profile is ready to use.


PROFILE EDIT profile-name


Brings up the SPFLite Profile Editor window on the named profile.  Only existing profiles can be edited. Attempting to edit an undefined profile causes the message “Specified Profile name does not exist” to be issued.  Either use the correct name, or perform a PROFILE NEW command instead to create a new Profile.  PROFILE EDIT may be issued from an edit window or from the File Manager, thus a file of the given file type (the same as the profile name) need not be open to do a PROFILE EDIT command.


Default Profile values set by a PROFILE RESET command


Profile           UNLOCK

AUTOBKUP          OFF

AUTOSAVE          OFF NOPROMPT

CAPS              OFF

CASE              T

COLS              OFF

EOL               CRLF

HEX               OFF

HILITE            ON  FIND  AUTO

LRECL             0

MARK              ON

MINLEN            0

PRESERVE          ON

RECFM             U

SCROLL            CSR

SETUNDO           10

SOURCE            ANSI

START             OFF

STATE             OFF

TABS              OFF

XTABS             8

USING             (null)


BNDS line         1  MAX

WORD line         A-Z a-z 0-9

MARK line         (none)

TABS line         (none)


Created with the Personal Edition of HelpNDoc: Easily create Help documents