Setting Profile Options

Introduction

The IOF Profile Menu is used to set global profile variables for your IOF sessions. From this menu you can:

  • Assign unique IOF PF Key sequences.
  • Set terminal characteristics.
  • Specify your default sysout class and printer destination.
  • Save your name and output delivery instructions to insure that any printed output produced from your IOF session will be properly identified and marked for delivery to you.

    IOF maintains a unique profile for each environment from which it can be invoked. If you run IOF from ISPF, CICS, and TSO READY, you must set your profile variables in each of these environments.

    The IOF Profile Menu is invoked by option P on the IOF Option Menu or by entering /P from any IOF panel.

    
    --------------------------------IOF-Profile-Menu-------------------------------
    COMMAND ===>
    
           0  - Specify Program Function Key Options
    
           1  - Specify IOF user profile options
    
           2  - Specify default characteristics for sysout snap data sets
    
           3  - Specify default characteristics for disk snap data sets
    
           4  - Specify print attributes to be set for TSO session
    
           5  - Specify screen field attributes (ISPF only)
    
    
    

    Setting Profile Values with a Command

    In addition to using the Profile Option Menu, any of the IOF profile values also may be set using the SETPVAR command:

    SETPVAR                       variable-name            value
    

    The SETPVAR command can be issued from any IOF screen and will set the requested profile variable. The names of some IOF profile variables are:

    Name                           Usage
    DFLBANNR                       Print banner for spun sysouts (CICS only)
    DFLCLASS                       Default release/print/snap class
    DFLCOND                        Condense option for browse
    DFLCOMP                        Compress option for browse
    DFLFINDL                       Find limit
    DFLLINCT                       Line count value for sysouts spun by IOF
    DFLNAME                        User name for sysouts spun by IOF
    DFLPF1,...,24                  Program Function Key 1,...,24
    DFLPRINT                       Default print dest for IOF session
    DFLROOM                        Room name for sysouts spun by IOF
    DFLTITLE                       Report title for print banner
    DFLNAME1                       Name for print banner delivery instructions
    DFLADDR1                       Line 1 of print delivery address
    DFLADDR2                       Line 2 of print delivery address
    DFLADDR3                       Line 3 of print delivery address
    DFLADDR4                       Line 4 of print delivery address
    DFLDEPT                        Department for print delivery instructions
    DFLBLDG                        Building for print delivery instructions
    DFLROOM1                       Room name for print delivery instructions
    DFLNOFT1                       Notify this user when print completes
    DFLNOTF2                       Notify this user when print completes
    DFLNOTF3                       Notify this user when print completes
    DFLNOTF4                       Notify this user when print completes
    DFLUSLB1                       User library for PAGEDEF's and FORMDEF's
    DFLUSLB2                       User library for PAGEDEF's and FORMDEF's
    DFLUSLB3                       User library for PAGEDEF's and FORMDEF's
    DFLUSLB4                       User library for PAGEDEF's and FORMDEF's
    DFLUSLB5                       User library for PAGEDEF's and FORMDEF's
    DFLUSLB6                       User library for PAGEDEF's and FORMDEF's
    DFLUSLB7                       User library for PAGEDEF's and FORMDEF's
    DFLUSLB8                       User library for PAGEDEF's and FORMDEF's
    DFLSCROL                       Default scroll amount
    OPTDEST                        Destination for DEST command
    OPTJOBN                        Job name for PREFIX command
    OPTSCOP                        Owner id for OWNER command
    OPTSORT                        Sort
    

    The SETPVAR command can be used to assign values to any variable name. In many cases, IOF options can be overridden by setting a profile value to an options variable name.

    Assigning Local and Temporary Variables

    The SETLVAR command assigns a value to a local variable. The syntax is identical to the SETPVAR command. Local variables exist for the duration of the IOF session only. Local variables are used by clists and REXX execs to define a temporary condition, such as the IOF TRACE on/off switch.

    The SETTVAR command assigns a value to a temporary variable that is anchored to the current IOF panel. Temporary variables are automatically deleted as soon as the current panel is terminated. Syntax is identical to the SETPVAR command.

    Deleting Profile and Local Variables

    The DELPVAR command deletes a profile variable. DELLVAR deletes a local variable.

    Syntax

    DELPVAR/DELLVAR variable

    Examples

              DELPVAR   GRPPANEL
              DELLVAR   CANVERFY

    Displaying IOF Variables

    The DVAR command is used to display IOF variables. DVAR will display options, session, system, profile, local and temporary variables. DVAR with no parms displays an option menu to allow selection of variable types for display. To display a specific IOF variable, follow the DVAR command with the variable name.

    Syntax

    DVAR [ variable ]

    Examples

    DVAR

    DVAR              ACFTYPE

    Customizing IOF Panels

    The column arrangement for most IOF list panels can be modified by each user by using the ARRANGE, CUT and PASTE commands. Modifications are saved in the user's profile, and remain in effect until reset. An abbreviated description of these commands is included with each panel on which they are valid. A more complete description is included here. The complete syntax is not needed by most end users but may be needed by clists and REXX execs.

    The easiest way to modify a panel is to enter the CUT command, and point the cursor to the field to be removed from the panel. Several fields can be cut in succession. Then, use the PASTE command with the cursor pointed to the place the previously cut fields will be inserted.

    Each section on an IOF panel must be modified separately. For example, moving the OWNER field on the Input Jobs Section of the Job List Menu has no effect on the Output Jobs Section format.

    CUT Command

    Use the CUT command to remove fields from a panel. Removed fields can be pasted back at a different position. If not pasted, cut fields are eliminated from the panel.

    Syntax

    CUT [field]

    field. The name of the field to be cut. If not specified, the field pointed to by the cursor is cut.

    PASTE Command

    Use the PASTE command to designate where previously cut fields should be inserted in the panel.

    Syntax

    PASTE [ BEFORE / AFTER / FIRST / LAST ] [ field ]

    BEFORE. Paste before the designated field; default parameter.

    AFTER. Paste after the designated field.

    FIRST. Moves field to the first scrollable position.

    LAST. Moves field to the far right of the display.

    field. The name of the pointer field. If not specified, then the previously cut fields are pasted relative to the current cursor position.

    ARRANGE Command

    The ARRANGE command provides the most complete method of modifying a panel format. Both the cut and paste operation optionally can be done at one time using ARRANGE. In addition, it can be used to delete any previously defined panel modifications from the user's profile.

    Syntax

    ARRANGE [ field1 ] [ FIRST / LAST / BEFORE / AFTER ]

    [ field2 ] [ DEFAULT ] [ $TEMP ]

    field1. The name of the field to be moved. This is an optional parameter. An alternate method of specifying field1 is to place the cursor on the desired field.

    FIRST. Moves field1 to the first scrollable position.

    LAST. Moves field1 to the far right of the display.

    BEFORE. Moves field1 in front of field2.

    AFTER. Moves field1 after field2.

    field2. The name of the target field.

    DEFAULT. Resets the display for the current section to the default column arrangement.

    $TEMP. Defines all subsequent ARRANGE, CUT and PASTE commands entered on the current panel as temporary and does not save them in the user's profile. The temporary arrangement ends on exit from the current IOF panel. ARRANGE $TEMP is primarily used in IOF clists to set temporary displays for a specific purpose.

    Examples

                   ARRANGE DEFAULT
                   ARRANGE COMMENTS  FIRST
                   ARRANGE FORMS AFTER DEST
                   ARRANGE $TEMP
    

    ALTVIEW Command

    The ALTVIEW command offers a way to cause pre-defined alternate views of a panel to be displayed. Each time the ALTVIEW command is entered, the next available view is displayed. The original view is displayed after the last available view. The selected alternated view is saved in the user’s profile. Currently, only the output jobs section of the Job List Menu has alternate views defined, but alternate views may be defined for additional panels in future releases of IOF.

    Summary

    The IOF Profile Menu and SETPVAR command can be used to set several options for all your IOF sessions. The importance of specific options will be seen later in this guide.

    The CUT, PASTE and ARRANGE commands can be used on all IOF list displays to customize the panel display. The modified display format is saved in the user's profile.

    Table of Contents