Profile Maintenance

This document covers the following topics:

• Profile Maintenance Overview

• PF-Key Definition

• Library Definition

• Magic-Character Definition

• Editor Profile

• User Defaults

• BS2000 Defaults

• Natural Defaults

• Editor Color Definition

Profile Maintenance Overview

With the profile maintenance facility, you can modify your user profile according to your personal requirements when working with Natural ISPF.

A special feature allows you to specify whether any modification is to be valid for the current session only, or whether it is to be saved for the next time you log on to Natural ISPF: when you press PF3 to leave a specific profile screen, a window is opened in which Natural ISPF asks you to specify Y to save the definition or N to retain it for the current session only (Y is the default). Press ENTER to close the window.

To enter the profile maintenance facility

• Select the PROFILE option from the Natural ISPF Main Menu. Alternatively, issue the PROFILES session command from any system screen.

  The Profiles Menu appears:

  ------------------------------- PROFILES MENU --------------------------------- OPTION ===> Userid BRY Time 15:40:50 1 KEYS - Display and update pf keys definition Terminal DAEFTC30 2 LIBRARIES - Libraries definition Library BRY 3 CHARS - Magic chars definition Node 148 4 EDITOR - Editor profile 5 DEFAULTS - User parameters 6 BS2 - 1 - BS2000 General defaults 7 BS2 - 2 - BS2000 Submit defaults 8 NATURAL - Natural defaults 9 COLOURS - Editor colour definition Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

  This menu offers the following options:

  Option	Meaning
  KEYS	Assign commands to PF keys.
  LIBRARIES	Define abbreviations for library names.
  CHARS	Define magic characters for commands.
  EDITOR	Modify your Editor profile.
  DEFAULTS	Maintain user defaults.
  BS2 - 1	Maintain BS2000-specific user defaults.
  BS2 - 2	Define default parameters for BS2000 jobs to be submitted.
  NATURAL	Define default parameters for processing Natural objects.
  COLORS	Define colors for Editor.

  These options are described in detail in the following subsections.

  Note:
  The BS2000 options are offered only at BS2000 sites, or if the BS2000 subsystem has been enabled by your System Administrator.

PF-Key Definition

To display and modify your PF-key assignments

• Select option 1 (KEYS) from the Profiles Menu. Alternatively, you can issue the KEYS session command from any system screen.

  The Keys Update screen appears with a list of PF keys and their current assignments:

  ---------------------------------KEYS-UPDATE----------------------------------- COMMAND ==> PF01 Help PF13 Help PF02 Split PF14 Split PF03 End PF15 End PF04 Suspend PF16 Suspend PF05 Rfind PF17 Rfind PF06 Rchange PF18 Rchange PF07 Up PF19 Up PF08 Down PF20 Down PF09 Swap PF21 Swap PF10 Left PF22 Left PF11 Right PF23 Right PF12 Cursor PF24 Cursor SHOW KEYS ON SCREEN OPTION ON KEYS PORTION TO DISPLAY FIRST Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- HELP SPLIT END SUSPE RFIND RCHAN UP DOWN SWAP LEFT RIGHT CURSO

You can modify your PF-key assignments by overtyping any command with one or more valid Natural ISPF commands. If you assign more than one command to a PF key, they must be separated with the command delimiter specified in your user defaults. Pressing the associated PF key from any system screen has the same effect as entering the command(s) in the command line.

An additional feature enables you to assign Editor line commands to PF keys. When assigning Editor line commands to PF keys, you must precede them with a colon (:) . For example, specifying :I to PF13 means that whenever you are in an edit session and press PF13, a line is inserted at the cursor position as if you had used the I line command.

Some useful command sequences assigned to PF keys are:

SUSPEND;E :C
SUBMIT;FOLLOW
:A;COPY

The PF key assignment screen also allows you to specify the following:

• In the field labelled SHOW KEYS ON SCREEN OPTION, you can specify ON to display PF keys with their associated direct commands in the last two lines of any system screen. Specify OFF to suppress PF-key display;

• If you opt to display PF keys on system screens, you can specify which PF keys are to be displayed in the field labelled KEYS PORTION TO DISPLAY. Specify FIRST to display PF1 to PF12; specify LAST to display PF13 to PF24. You can use the FLIP direct command in any system screen to change from FIRST to LAST or vice versa.

Having entered your PF-key definition, press PF3 to open the confirmation window. Enter Y to save the PF-key definition or N to retain the definition for the current session only (Y is the default). Press ENTER to return to the Profiles Menu.

You can also use the KEYS session command with parameters to assign a command sequence to a PF key, without entering the profile facility. The command format is:

KEYS n <string>

where n is the number of the PF key and string the command sequence to be assigned.

Important:
When assigning a command sequence consisting of two or more commands to a PF key using the KEYS command syntax, you must enter the command delimiter twice. For example, the command KEYS 13 SUBMIT;;FOLLOW assigns the command sequence SUBMIT;FOLLOW to PF13. See also the description of the KEYS session command in the section Command Reference.

Library Definition

This function does not apply to Natural libraries.

To define a two-character short name as an alias for any library

• Select option 2 (LIBRARIES) on the Profiles Menu. Alternatively, you can access this function directly from any system screen by issuing the SHORTLIB session command.

  The following screen appears:

  ------------------------------ SHORT LIBRARIES --------------------- Row 1 of 1 COMMAND ===> Short Name Data Set Name Volser ---------- -------------------------------------------- ------ RW RW.COMN.SOURCE __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

Meaning of the input fields according to column headings:

You can define up to 126 short names. You can scroll the list with the UP and DOWN commands.

Having defined short names, press PF3 to open the confirmation window. Enter Y to save the short names or N to retain the definitions for the current session only (Y is the default). Press ENTER to return to the Profiles Menu. You can use the short library name instead of the full name anywhere in Natural ISPF (in dataset selection fields and as object parameter in function command syntax).

Note:
The library abbreviations specified here override the abbreviations for the same libraries defined by the system administrator.

To list available short IDs, enter the asterisk wildcard (*) in the Data Set Name field of the appropriate object Entry Panel and press ENTER. Alternatively, you can issue one of the following commands:

LIST DS *         (for z/OS environments)

BROWSE FIL *      (for z/VSE environments)

LIST LMS *(*)     (for BS2000 environments)

from any system screen. This opens a window with the user short IDs. To list system-wide short IDs, enter G in the window and press ENTER.

Magic-Character Definition

You can abbreviate any string used in Natural ISPF commands by assigning it to a magic character, usually a special character. If you enter this special character in the command line of any Natural ISPF screen, the effect is the same as if you had entered the associated string.

This feature makes entering long command sequences and multiple command input much more comfortable, for example when switching sessions, accessing other system functions or issuing operator commands. For example, if you assign the string SUSPEND; to the exclamation mark (!), the command input

!E NAT name

automatically starts a new Natural ISPF editing session with the specified Natural object. Or if you assign the stroke (/) to the string OPERATOR_, the command input:

/C object=name

cancels the specified object from the operating system. Blanks required at the end of a string assigned to a magic character are represented by the underscore wildcard (_).

To display the magic-character definition screen

• Select option 3 (CHARS) from the Profiles Menu. Alternatively, you can issue the CHARPROF session command from any system screen.

  The Magic-Character definition screen appears:

  ---------------------------------MAGIC-CHARS----------------------------------- COMMAND ===> Magic Char Position Substitution ---------- -------- ------------------------- ! SUSPEND; = F RETURN; / OPERATOR_ # NAT_ % MY.COMN + MYFILE > ;NEWNAME_ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

Meaning of the input fields according to column heading:

You can assign any number of strings to special characters. Press PF3 to open the confirmation window. Enter Y to save the magic characters or N to retain them for the current session only (Y is the default). Press ENTER to return to the Profiles Menu.

Below are some example command sequences using magic characters as defined in the above figure:

Note:
Like any command string, magic characters can be assigned to PF keys.

Editor Profile

The Natural ISPF Editor provides a default editing profile which you can display by issuing the Editor PROFILE command from the edit screen. You can modify Editor profile settings for the current edit session using appropriate Editor commands or the Editor SET command.

To change your Editor profile default settings

• Use the PROFILE facility from the Natural ISPF Main Menu. Select option 4 (EDITOR) from the Profiles Menu, or issue the EDITPROF session command from any system screen.

  Your Editor Profile appears with its current settings:

  ------------------------------- EDIT PROFILE ---------------------------------- COMMAND ===> PROFILE NAME *default ( Enter command SELECT to select another profile) ( DELETE to delete this profile) SCROLL CSR ( Default scroll ) CAPS OFF ( Upper case translation (ON/OFF/PGM)) HEX OFF ( Hexadecimal mode ) NULLS ON ( Fill end of line with nulls ) RECOVERY ON EACH 7 ( Create recovery file each # updates ) LOG ON ( Retain activity log (allow UNDO ) AUTOSAVE OFF ( Automatic SAVE with END command ) AUTOREN ON ( Automatic renumbering ) PROTECT OFF ( Protect prefix area OFF/ON/INS ) PREFIX ON ( Display prefix area ON/OFF ) ADVANCE ON ( Automatic advance OFF/ON/PAGE ) TABS OFF CHAR ( Use tabs, optionally with specified character ) TABS POS 9 15 39 71 ESCAPE OFF CHAR ( Escape to line command with specified character ) LIMIT ( Limit for Find commands ) Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

Meaning of the input fields:

Having modified your Editor profile, press ENTER to open the confirmation window. Enter Y to save the profile or N to retain it for the current session only (Y is the default). Press ENTER to return to the Profiles Menu.

Assigning Multiple Editor Profiles

Natural ISPF allows you to define multiple Editor profiles for each user or a group. This profile is called *default profile and is also used in BROWSE and LIST sessions. In EDIT sessions the default profile is used if no other profile is found.

Profiles are identified with 8-byte names and when you open an EDIT session, a list of profile names (called a request list) is created. The contents of this list depend on the Natural ISPF object type to be edited and are described in more detail below. If none of the named profiles are found, (remember that a search is usually performed for a user and all groups) the default profile is used.

The following table describes how the request list is built for each object type which can be edited in Natural ISPF. (Member: EDASSIGN)

where qua stands for qualifier, which is part of a z/OS dataset name.

Example:

The following commands create the lists of profile names below:

Whenever a non-default profile is selected for an edit session, a message is displayed indicating the name of the selected profile. If it was taken from another user (group), the user ID is also displayed.

With this mechanism it is very easy to define special Editor profiles, for example, for Assembler programs (including the correct tab setting). If all Assembler programs are stored in datasets with last qualifier ASM, the administrator can define an Editor profile named ASM for user *. This profile is automatically used by all users editing a member in a dataset for ASM programs, unless they have defined a personal Editor profile named ASM.

Local Commands

To maintain the different profiles, 2 additional local commands are available:

Example: SELECT

If you issue the SELECT local command from the Edit Profile screen, the following window opens:

   ------------------------------- EDIT PROFILE ----------------------------------
   COMMAND ===> sel
                           +------Select Profile-------+
                           !                           !
      PROFILE NAME  *defau ! Enter new name  ________  ! elect another profile)
                           ! or select:       1 of 4   ! elete this profile)
      SCROLL    CSR        !   Profile  User           !
      CAPS      OFF        ! _ *default                ! N/OFF/PGM))
      HEX       OFF        ! _ COMN                    !
      NULLS     ON         ! _ COPYCODE                ! ls )
      RECOVERY  ON   EACH  ! _ COBOL    *              !  # updates )
      LOG       ON         ! _                         ! w UNDO )
      AUTOSAVE  OFF        ! _                         ! ommand )
      AUTOREN   ON         ! _                         !
      PROTECT   OFF        ! _                         ! N/INS )
      PREFIX    ON         ! _                         ! F )
      ADVANCE   ON         ! _                         ! PAGE )
      TABS      OFF  CHAR  ! Entr-PF3--PF7--PF8--      !  specified character )
      TABS POS   9 15 39 7 ! Down End  Up   Down       !
      ESCAPE    OFF  CHAR  +---------------------------+ th specified character )
      LIMIT                   ( Limit for Find commands )
  
   Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
         Help  Split End   Suspe Rfind Rchan Up    Down  Swap  Left  Right Curso

This window lists all Editor profiles accessible to this user. If a profile is stored for a group, the name of the group is also listed (as for the profile COBOL in this example).

You can scroll forward or backward through the profile list and can select one for editing.

To create a new editor profile

• Just enter the name of the profile in the appropriate field and press ENTER.

User Defaults

To set several user defaults that affect your working environment in Natural ISPF

• Select option 5 (DEFAULTS) from the Profiles Menu. You can also access this function directly with the DEFPROF session command from any system screen.

  The User Defaults definition screen appears:

  ------------------------------- USER DEFAULTS --------------------------------- COMMAND ===> NODE 148 ( Default system node number ) PRINTER * ( Default printer. '*' for prompt on print ) FILE TYPE NAT ( Default file type in direct commands ) DSNAME ( Default DSname in direct commands ) MACRO EXPAND N ( Expand MACRO in NATURAL programs ) MACRO SMODE S ( SMODE for non NATURAL macros: S/R ) TRACE 1 ( Interval (seconds) for tracing functions ) BREAK ( Allow break after number of traces ) VERSIONS N ( Save PDS/NAT/MEM last versions ) CONFIRM SHORT ( Confirmation type: SHORT/LONG ) COMMAND DEL. ; ( Delimiter between commands in command line ) PARM DEL , ( Delimiter between command parameters ) COMMAND ( Default command when entering NSPF ) NO-RECOVER ( No automatic check for recovery files ) PRINT VIA NOM ( Use ENTIRE OUTPUT MANAGEMENT for printing ) Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

All fields which are stored in the user profile are highlighted. Fields inherited from a user group (like *) or taken from predefined defaults are displayed in normal intensity and are not stored in the user profile. If a field is modified on the screen, it will be highlighted and stored in the user profile.

Note:
With this function, the administrator can easily maintain several important default values like NODE or PRINTER in the user profile of user *. If these fields are not modified in the individual user profiles, they are not stored in individual profile records but are kept in one place only. If the node number must be changed for some reason, the administrator must change only one user ID and all others inherit the new value without having to change every single user profile.

Meaning of the input fields:

Having defined your user defaults, press PF3 to open the SAVE PROFILE confirmation window. Enter Y to save the definitions permanently or N to retain them for the current session only (Y is the default). Press ENTER to return to the Profiles Menu.

BS2000 Defaults

User defaults for BS2000 sites can be specified using two options on the Profiles Menu:

• General Defaults

• Defaults for job submission

These options are only accessible if the BS2000 subsystem is enabled.

General Defaults

To set several user defaults that affect your environment in Natural ISPF when working with BS2000 objects

• Select option 6 (BS2 - 1) on the Profiles Menu. You can also access this function directly by using the DEFBS2PROF direct command (shortest abbreviation is DEFB) from any system screen.

  The BS2000 User Defaults screen appears:

  --------------------------- BS2000 USER DEFAULTS ------------------------- COMMAND ===> Default parameters for LMS element maintenance: LMS Element Type S ( used for new elements ) LMS Element Version § ( used for new elements ) LMS Storage Mode V ( for future use ) Allow Override on SAVE * ( * / YES / NO ) Default parameters for function DELETE-BS2FILE: ERASE Option ( * or blank/DATA/DESTROY/SPACE ) ERASE Range (for FGGs) * ( * or A/B; * will cause prompt) Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right :s

The profile settings have the following meaning:

Submit Defaults

To set several user defaults that take affect when you submit batch jobs from your Natural ISPF session

• Select option 7 (BS2 - 2) on the Profiles Menu. You can also access this function directly by using the direct command DEFSUBPROF (shortest abbreviation is DEFS) from any system screen.

  The following screen appears:

  ----------------- USER DEFAULTS FOR SUBMITTING BS2000 JOBS -------------------- COMMAND ===> USERID ( if USERID or ACCOUNT is preset, ACCOUNT the PASSWORD will be prompted ) JOBCLASS ( blank / full name of jobclass ) TIMELIMIT STD ( * /STD/NTL / nnnnn (in seconds)) JOB-PRIORITY ( blank / value from 1 to 9 ) RUN-PRIORITY ( blank / value from 1 to 255 ) MONITORING-JOBVAR Additional options: FLUSH NO ( * / YES / NO ) RERUN NO ( * / YES / NO ) ERASE NO ( * / YES / NO ) START STD ( * / STD/SOON/IMM/WITHIN/AT etc.) Note: Any value set to * will cause all values to be prompted. Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

The profile settings have the following meaning:

Natural Defaults

To set several defaults that affect your working environment in Natural ISPF

• Select option 8 (NATURAL) from the Profiles Menu. You can also access this function directly by using the NATDEF direct command from any system screen.

  • The Natural Defaults screen appears:

  ----------------------------- Natural Defaults -------------------------------- COMMAND ===> INIT LOGON ( Initial logon when entering N-ISPF ) MODE REPORT ( Default mode of natural programs STRUCT/REPORT ) TYPE P ( Default type of natural program ) EDITOR N ( Use ISPF Editor,not NATURAL program editor) Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

Meaning of the input fields:

Editor Color Definition

This option enables you to define the colors to be used by the Natural ISPF browser, which is responsible for all LIST, BROWSE and EDIT sessions. The colors used in other screens cannot be modified with this profile option.

To define the colors to be used by the Natural ISPF browser

• Select option 9 (COLOR) from the Profiles Menu. You can also access this function directly by using the COLPROF direct command from any system screen.

  The Color Definition screen appears:

  ----------------------------- Colour Definition ------------------------------- COMMAND ===> Command Line TU Edit/List sessions ( Valid Colours ) Intense Input NE BL Blue Intense Output TU GR Green Normal Input GR NE Neutral Normal Output TU PI Pink RE Red Browse sessions TU Turquoise Intense Input NE YE Yellow Intense Output TU Normal Input GR Normal Output TU Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Split End Suspe Rfind Rchan Up Down Swap Left Right Curso

Meaning of the input fields: