z/OS ISPF Edit and Edit Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


PROFILE—Set or Query the Current Profile

z/OS ISPF Edit and Edit Macros
SC19-3621-00

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

Read syntax diagramSkip visual syntax diagram
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.

Read syntax diagramSkip visual syntax diagram
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.

Read syntax diagramSkip visual syntax diagram
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.

Read syntax diagramSkip visual syntax diagram
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 -
     ...

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014