The
control form of the PROFILE macro command displays your current edit
profile, defines a new edit profile, or switches to a different edit
profile.
The lock form of the PROFILE macro command locks or
unlocks the current edit profile.
The PROFILE assignment statement
retrieves the name and lock status of the current edit profile and
stores those values in variables.
Syntax
Macro command profile control syntax
.-current_edit_profile-. .-5------.
>>-ISREDIT--PROFILE--+----------------------+--+--------+------><
'-name-----------------' '-number-'
- name
- The profile name. It can consist of up to 8 alphanumeric characters,
the first of which must be alphabetic. The edit profile table is searched
for an existing entry with the same name. That profile is then read
and used. If one is not found, a new entry is created in the profile
table.
If you omit this operand, the current edit profile is used.
- number
- The number of lines, from 0 through 8, of profile data to be displayed.
When you type 0 as the number, no profile data is
displayed. When you omit the number operand, the profile modes appear;
the =MASK> and =TABS> lines
are displayed if they contain data, followed by the =COLS> line.
The =BNDS> line does not appear if it contains
the default boundary positions. It does appear when the bounds are
set to something other than the default, and no 'number' parameter
is entered into the PROFILE command.
For more information about
displaying and defining a profile, see Displaying or defining an edit profile.
Macro command profile lock syntax
>>-ISREDIT--PROFILE--+-LOCK---+--------------------------------><
'-UNLOCK-'
- LOCK
- Specifies that the current values in the profile are saved in
the edit profile table and are not modified until the profile is unlocked.
The current copy of the profile can be changed, either because of
commands you enter that modify profile values (BOUNDS and NUMBER,
for example) or because of differences in the data from the current
profile settings. However, unless you unlock the edit profile, the
saved values replace the changes when you end the edit session.
Caps,
number, stats, and pack mode are automatically changed to fit the
data. These changes occur when the data is first read or when data
is copied into the data set. Message lines (==MSG>)
are inserted in the data set to show you which changes occurred.
Note: To
force caps, number, stats, or pack mode to a particular setting, use
an initial macro. Be aware, however, that if you set number mode on,
data may be overlaid.
- UNLOCK
- Specifies that the editor saves changes to profile values.
See Locking an edit profile for
more information about locking and unlocking the profile.
Macro command profile reset syntax
>>-ISREDIT--PROFILE--RESET-------------------------------------><
- RESET
- Specifies that the ZEDFAULT profile is to be removed and the site-wide
configuration for new edit profiles is to be used.
See Locking an edit profile for
more information about locking and unlocking the profile.
Assignment statement syntax
>>-ISREDIT--(var1,var2)-- = --PROFILE--------------------------><
- var1
- The name of a variable to contain the name of the current edit
profile.
- var2
- The name of a variable to contain the profile status, LOCK or
UNLOCK.
Description
Profile names cannot be set
by an assignment statement. Instead, use PROFILE to change a profile
name, thereby changing the current edit profile and the edit profile
values.
Return codes
- 0
- Normal completion
- 20
- Severe error
Examples
To check the lock status of the
profile and perform processing if the profile is locked:
ISREDIT (,STATUS) = PROFILE
IF &STATUS = LOCK THEN -
...