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 delivery instructions for spun sysout data sets
                (JES2 4.1.0 and later only)
    
           3  - Specify NOTIFY and USERLIB options for spun sysouts
                (JES2 4.1.0 and later only)
    
           4  - Specify USERDATA options for spun sysouts
                (JES2 4.2.0 and later only)
    
           5  - Specify default characteristics for disk snap data sets
    
           6  - Specify print attributes to be set for TSO session
    
           7  - Specify screen field attributes (ISPF only)
    

    Terminal and PF Key Options

    Option 0 is used to specify your terminal and PF Key options. These values will be initialized like your ISPF terminal characteristics and PF Keys. You may want to modify some of the PF key sequences after you become familiar with IOF.

    IOF User Profile Options

    Option 1 lets you specify your user profile options.

    
    ----------------------------IOF-User-Profile-Options----------------------------
     COMMAND ===>
    
        PRINT    ===> LOCAL                 Default Print Destination
                                                  .
        CLASS    ===> A                     Default Release Class
    
        SCROLL   ===> CURSOR                (SCREEN, HALF, CURSOR, DATA or PAGE)
    
        CONDENSE ===> NO                    Condense as default (Yes or No)
        COMPRESS ===> NO                    Compress as default (Yes or No)
    
        FINDLIM  ===> 10000                 Find limit for browse
    
    

    It is important to assign values to your user profile options. The PRINT and CLASS fields define your default print destination and class. When you release a held data set, the sysout class is changed to the specified class by default. When you make a copy of a data set to sysout, both the class and print destination values are assigned by default to the output. The SCROLL, CONDENSE and COMPRESS fields define how data is displayed and scrolled. The FINDLIM field is used to limit the amount of data searched by the FIND command. The use of these values will be discussed in more detail later.

    IOF Print Delivery Instructions

    Option 2 lets you specify print delivery instructions for your output. JES2 4.1 and later can designate delivery instructions on each piece of output that is printed. IOF automatically can set these values for snap output data. Also, modifying old sysout data sets to include the delivery instructions is accomplished easily.

    
    -------------------------IOF-Print-Delivery-Instructions-----------------------
     COMMAND ===>
    
       The values below will be used when you SNAP a sysout data set from the IOF
       Job Summary Display.  You will also be given an opportunity to select these
       values when you PRINT a sysout data set from the IOF Job Summary if you
       enter "P?" to display the print interface menu.
    
       These options are supported only for JES2 release 4.1.0 and later.
    
     TITLE    ===>
    
     NAME     ===>
     ROOM     ===>
     BUILDING ===>
     DEPT.    ===>
     ADDRESS  ===>
              ===>
              ===>
              ===>
    

    SNAP Default Notify, Userlib and Userdata Options

    Option 3 lets you set default values for the NOTIFY and USERLIB parms for Snap data sets. Option 4 lets you set default values for the USERDATA parm for Snap data sets.

    SD Command Default Values

    Option 5 lets you set default attributes for target disk Snap data sets.

    
    -------------------------------SD-Command-Defaults-----------------------------
     COMMAND ===>
    
       The attributes below will be used by default for snapping to disk data
       sets with the SD command.  SD with no operands will display a parm menu.
    
     DSNAME        ===>
    
     RECFM         ===> VBA           Record format
     LRECL         ===> 255           Logical record length
     BLKSIZE       ===> 3600          Block size
     PRIMARY       ===> 20            Primary allocation   (in tracks)
     SECONDARY     ===> 20            Secondary allocation (in tracks)
    
     UNIT          ===>               Unit name
     VOLUME        ===>               Volume serial
     STORCLAS      ===>               SMS storage class
     MGMTCLAS      ===>               SMS management class
     DATACLAS      ===>               SMS data class
    
     PACK(Y or N)  ===>               Pack data using ISPF method
    
    

    Print Attributes for TSO Session

    Option 6 is used to set print attributes of your TSO session for both IOF and non-IOF use.

    
    ------------------------Print-Attributes-For-TSO-Session-------------------------
     COMMAND ===>
    
          The attributes specified below will be set for your TSO session
          the first time that you actually enter IOF after logging on to
          TSO. These attributes affect only output that is produced by
          your TSO session as "spun" sysout data. IOF produces "spun"
          sysout data in response to SNAP and PRINT data set functions.
    
          ROOM #     ===>                       Room # for print banner
    
          USER NAME  ===>                       User name for print banner
    
          LINE COUNT ===>                       Lines/page for spun sysout
    

    This panel is used to assign print attributes to your TSO session. The values are assigned the first time IOF is used in each TSO session; they remain in effect for the duration of the session. Any sysout data you produce from the TSO session will be assigned these attributes.

    Screen Color

    Option 7 is used to define the colors that IOF displays to color terminals when running under ISPF. Color, intensity, and highlight can be specified.

    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
    OPTOWNER                   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
    

    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