October 2007

IOFTech    EndFAQ    Maintenance   Release8G       Newsletters    Doc    FAQ    Contacts    Home    Webmaster

Managing the IOF Environment






An IOF userís session can be affected by a number of environmental factors, including: 

  • The version of IOF
  • Global IOF options settings
  • Options settings for the userís group
  • The userís override of global or group options
  • The userís current TSO or CICS environment
  • The current version of JES2 and z/OS
  • The IOF load modules currently being used

The information below describes IOF tools that help you display and manage these environmental factors.


Displaying the Current IOF Environment

The IOF DVAR command displays the IOF environmental variables.  Many environment variables are defined by IOF options settings.  Others, such as a user's userid or logon procedure name, are set by the TSO session logon.  Still other variables are internal IOF settings that may be useful in diagnosing IOF problems.

DVAR can be entered on any IOF panel.  The Display Current Variable Values lets you select the type variable to be shown.  Or you can press ENTER repeatedly to step through all the variable displays.

--------------------- Display of Current Variable Values ----------------
 COMMAND ===>                                                            
          1  SESSION environment attributes                               
          2  SESSION environment attributes 2                             
          3  SESSION environment attributes 3                             
          4  SYSTEM  environment attributes                               
          5  JES2    Information                                          
          6  GROUP   attributes defined for your IOF Group                
          7  GROUP   attributes defined for your IOF Group 2              
          8  Misc    attributes                                           
          9  Misc    attributes 2                                         
         10  JAR     Job Archival and Retrieval Attributes                
         11  SLAM    System Log Access Management Attributes              
         12  RACF    Security System Attributes                           
         13  APPC    Servers and Alias Names Listing                      
         14  Sysids  (and alias) with Printers Attached                   
         15  Logical Console Usage Attributes                             
         16  Logical Console Initial Commands                             
         17  All user profile variables                                   
         18  Print variables                                              
   ENTER - Scan Items     n - Select Item     END - Back     Q - Quit HELP     

Selecting option 1, or just pressing ENTER displays the first variable screen.

--------------------- SESSION Variables Display Screen 1 ----------------------
COMMAND ===>                                                           
   USERID      SYSP188     SESSION           Userid of this session            
   ASCBTYPE    TSU         SESSION           Job, TSU, or STC                  
   GRPNAME     OPERATOR    SESSION  B23ALLOW IOF Group name                    
   ACCT                    SESSION           Account code                      
   PROC        TSIPROC     SESSION           Logon Proc                        
   TERM        LCL91D      SESSION           Terminal name                     
   UADSOPER    YES         SESSION           TSO Operator authority            
   UADSJCL     YES         SESSION           TSO Submit authority              
   XEQSYSID    TSI1        SESSION           Execution system id               
   INTRFACE    ISPF        SESSION           IO interface type                 
   EXPRDATE    10/03/2008  SESSION  A50EXPIR IOF expiration date (MM/DD/YYYY)
   DOWN/UP - Scroll Display      ENTER - Next      END - Back to Menu  

When a variable is defined or is controlled in some way by the parameters in an IOF option member, that member name is listed in the Option column.  In the display above, the IOF Group definition parameters are specified in the B23ALLOW option as shown.  The IOF Expiration date password is defined in options data set member A50EXPIR.  This information often shows you exactly where to make desired changes to IOF.

Enter END then select option 4 to see system variables.  An alternate way to do this is to just press ENTER 3 times from the previous variable display.

 -------------------------- SYSTEM Variables Display --------------------------
 COMMAND ===>                                                            
    IOFLEVEL    8C          SESSION           IOF  Level                       
    IOFSPIN     2007220     OPTIONS           IOF  Spin Level                  
    IOFENV      TSO         SESSION           IOF  Environment                 
    JES2LEVL    OZ104       SESSION  C75ASMJS JES2 Version assumed by IOF      
    MVSLEVEL    SP7.0.4     SESSION           MVS  Level                       
    MVSFMID     HBB7707     SESSION           MVS  FMID                        
    TSOELEVL    3030        SESSION           TSOE Level                       
    RACFLEVL    7707        SESSION           RACF Level                       
    GRPMVSCH    POUND       SESSION           MVS Command Character override   
    JUMPCHAR    /           OPTIONS  B49CMPAT IOF Jump Character               
    GRPMENUG    YES         SESSION           Global IOF options group override
    MENUGBLC    YES         SESSION           MENUGLOB composite               
    INPRUN      NO          OPTIONS  B49CMPAT Show running with input          
    NOMATCH     MENU        OPTIONS  B49CMPAT What to do when no jobs          
    PRTOPTN     PRINT       OPTIONS  B49CMPAT P command option                 
    SAVESORT    YES         OPTIONS  B49CMPAT Save SORT option                 
    OPTNPANL    DEFAULT     OPTIONS  B49CMPAT Option panel definition          
    ALLPANEL    OPTOPT      OPTIONS  B49CMPAT ALL panel option  
   DOWN/UP - Scroll Display      ENTER - Next      END - Back to Menu

Many of the system variables are defined in the B49CMPAT option.  The JES2 level is indirectly controlled in the C75ASMJS option member by defining the JES2 and z/OS macro libraries.

Press ENTER multiple times to step through the remaining options.  Many variables that control how IOF operates are displayed.

The last screen is the user's profile variables.  Alternately enter DVAR  PROFILE to display just the profile variables. Profile variables will include the user's PFKey settings, default sort values and other personal settings for each user.  Scroll up or down to see additional variables

 ---------------------------- IOF Profile Variables --------------------------
 COMMAND ===>                                                                 
  Name-----Value --------------------------Description--------------------    
  ACTION   ALL                            Display action messages             
  CMPLSIZE 4                              Compare size                        
  CMPLTYPE 1                              Compare type                        
  CNSAUTOC OFF                            AUTOCON value                       
  CNSCROLL ON                             Console scrolling                   
  DFLCLASS H                              Default snap/print sysout class     
  DFLCOMP  NO                             Compress                            
  DFLCOND  YES                            Condense                            
  DFLDEST  FETCH                          Default snap/print destination      
  DFLFINDL 0                              Find limit                          
  DFLLINCT 62                             Line count for snap/print           
  DFLNAME1 G. Simpson                     Default SNAP user name              
  DFLNOTF1 SYSPGS                         Notify                              
  DFLPF1   HELP                           Default PFKey value                 
  DFLPF10  LEFT                           Default PFKey value                 
  DFLPF11  RIGHT                          Default PFKey value                 
  DFLPF12  CURSOR                         Default PFKey value                 
  DFLPF13  HELP                           Default PFKey value                 
  DFLPF14  SPLIT                          Default PFKey value                 
         DOWN/UP - Scroll Display          END - Exit Display                 



Using the New SETIOF Command to Manage IOF Options

While the DVAR command displays the IOF options in effect within the current IOF load modules, the actual options are stored in the IOF options library.  This library is a PDS with each option, or set of related options, stored as a separate member.  A generation process is required install changes to the options library into the IOF load modules

Finding the correct option to change in the IOF OPTIONS PDS can be a difficult task for IOF installers.  Familiarity with the OPTIONS library is required in order to find the member that defines a particular option.  The new SETIOF command  eases this task. 

SETIOF is included in release 8D of IOF.  SETIOF was added to earlier release 8 versions of IOF by fix U8x2333.  U8C2333 is applied to spin level 2007280.  For prior spin levels of 8C, and for all levels of 8A and 8B, download the latest CUMFIX file and apply U8x2333 to add the SETIOF command.  

After applying U8x2333, SETIOF can be entered on any IOF panel to display the Setting IOF Options panel.  This panel divides IOF options into three categories based on option change frequency and importance.

--------------------------Setting IOF Options-----------------------------

Options controlling product execution 

         1   Commonly changed options 

         2   More options 

Options used to generate installation jobs 

         3   All options 

Selecting option 1 displays the most commonly changed options on the IOF Options Display. 

---------------------IOF Options Display ----------------------- Row 1 of 13 
 COMMAND ===>                                               Scroll ===> CSR   
    S or E  - Edit member         V  = View member                     More     
                                                                   Scroll Right 
 ---Option--Change Date-Ac-Description-----------------Current Value--------- 
  _ A10AUTH  1997/03/07    SVC number for IOF          SVC=200             
  _ A40SCOPE 1997/08/28    Default jobs displayed      OWNER,'/U'       
  _ A50EXPIR 2007/08/08    Expiration date password    REP 00 8585,FFFC,D29A,CDEF
  _ A60ACF   2006/05/24    Security system usage       RACF,IBMSAF=YES,OPER=ALL,
  _ A70FLOW  1999/05/15    Option menu or user's jobs  SETFLOW INITCMD=INITCMD  
  _ B23ALLOW 2007/08/07    User groups and privileges  7 GROUP macros           
  _ B23$DOC                B23ALLOW documentation      Documentation            
  _ B30SLAM  2003/08/25    System log indexing         INDEX=YES,SYSID=YES,MEMOJ
  _ B32INDEX               System log Index data set   PREFIX=SYSIOF,SUFFIX=IOFI
  _ B48RESET               Options Menu parm reset     SETRESET YES             
  _ B49CMPAT 2007/08/08    SDSF compatibility          MVSCHAR=POUND,JUMP=/,PCMD
  _ B62CONDS               "CONDENSE" browse option    SETCONDS NO              
  _ B67SERV  2007/05/17    Sysplex support (AT cmd)    9 SERVER macros          

The IOF Options Display shows one line for each options member.  The change date column shows the last time the option was changed locally, or is blank if the option has never been changed locally.  The description column gives a brief description of each option.  The current value column gives a brief description of the current setting for each option where possible.  Some options have multiple macros that can not be described accurately in a single column of information.  For example, the B23ALLOW option description shows the number of IOF GROUP macros defined in that member.  Additional current value information can be seen by scrolling right, or by running on a wide screen terminal.

Note that if you do not see the "current value" column on this display, then you have the preliminary version of SETIOF installed.  You should apply fix U8x2354 to replace the preliminary version.

Edit or view a  member to read the complete description of the parameters that can be defined in each member.   Any changes you make will be reflected in the IOF Options Display when it is re-displayed.

SETIOF can be run as a stand-alone command.  This is the only method available to run SETIOF for IOF/CICS.  The stand-alone command is useful for IOF/TSO to change options after the MPI has been run but before IOF is generated.  To run stand-alone execute SETIOF from the IOF INSTALL data set from ISPF Option 6.

	          ISPF Command Shell

Enter TSO or Workstation commands below:     
===>  ex 'iof.ioft8c0.install(setiof)'
Place cursor on choice and press enter to Retrieve command         


Determining the IOF Version

It is not uncommon for a systems programmer to change IOF options, run the required IOF generation jobs, but see no change in the way IOF operates. The first thing to do in this case is to issue the VERSION command to prove that the latest generation is in fact being run.  The current IOF version will be displayed in the top right corner.  Press PF1(HELP) to see the long message which includes the date and time of the latest IOF generation.    If the date is older than the latest generation date then you were not successful in putting the latest generation into production.

Release 8B and later support the ALL parameter on the VERSION command.  To display the version of IOF ans several IOF libraries, enter:


 IOF Version          8C             
 Installation Level   5              
 IOF Spin Level       2007220        
 Generated on         09/19/07 15.24 
 CLIST Version        8C             
 ISPPLIB Version      8C             
 HELP Version         8C 



Finding IOF Load Modules

If the VERSION command shows that you are not running the latest IOF generation, the problem most likely is that you didn't properly copy the IOF load modules to a linklist library or to LPA.  The IOFWHERE command shows  which IOF load modules are running and where they reside.  IOFWHERE is a Rexx exec that can be executed from TSO READY, from ISPF Option 6, or using the ISPF  TSO command.  IOFWHERE has no parameters.  For example, from any ISPF panel enter:


IOFWHERE produces the following line mode messages.

 The IOF load modules you are using reside in the following libraries:
 IOF      in STEPLIB  IOF.IOFT8C5.LOAD                                
 IOFSPF   in STEPLIB  IOF.IOFT8C5.LOAD                                
 IOFT8C5M LINK APF(Y) SYS2.IOFPROD.LINKLIB                             
 IOFT8C5U LINK APF(Y) SYS2.IOFPROD.LINKLIB                             
 IOFT8C5A LINK APF(Y) SYS2.IOFPROD.LINKLIB                             
 IOFT8C5P LINK APF(Y) SYS2.IOFPROD.LINKLIB                             
 Cpu Serial number is: 9021                                           
 Cpu Model  number is: 4B47                                           
 MVS Product name:     SP7.0.4                                        
 MVS FMID value:       HBB7707                                        
 IPL Date and Time:    2007.209 - 14:45:27   		

Note that IOF and IOFSPF are the only two IOF load modules that will run from a STEPLIB.   See the February 1999 IOF Newsletter for more information of where IOF modules must reside



Building Complex Options

Several IOF options require multiple macros to be used.  Some of these options require significant documentation.  The B21ACESS member is documented in the special B21$DOC documentation member.   B23$DOC documents the B23ALLOW member.  Documentation for all other options is contained in the comments at the beginning of the member.  Additional information can be found in Chapter 27 of the IOF Installation Guide.

The B23ALLOW OPTIONS library member is the primary option member for controlling IOF access for sites that chose not to use the installation security system for access control.  This option can participate even when SAF is used for most access control.  ALLOW and LIMIT macros in B23ALLOW can be used to define exactly who can or can not access any IOF resource.  These macros are documented in Chapter 27 of the IOF Installation Guide. 

The ALLOW command initiates the ALLOW dialog that helps build many common ALLOW and LIMIT macros.  The December 1998 IOF Newsletter describes the ALLOW dialog is detail.  However, the dialog is self documenting.  Try it by entering ALLOW on the IOF Option Menu and follow the prompts.


Restoring Default Options

The IOF options data set includes duplicate copies of many of the options under an alternate name to make it easy to restore the default version.   The duplicate member names begin with "Z".   Member Z00INDEX lists the "Z" member names and the original option.   Z00INDEX for release 8C is shown below.

 Z21ACESS     Copy of B21ACESS              
 Z23ALLOW     Copy of B23ALLOW                    
 Z24ACFDF     Copy of B24ACFDF                    
 Z25DVGRP     Copy of B25DVGRP                    
 Z30SLAM      Copy of B30SLAM                     
 Z34DSWRT     Copy of A34DSWRT    - IOF/CICS only 
 Z35USRID     Copy of A35USRID    - IOF/CICS only 
 Z40SCOPE     Copy of A40SCOPE                    
 Z49CMPAT     Copy of B49CMPAT                    
 Z54SNPDS     Copy of B54SNPDS                    
 Z60ACF       Copy of A60ACF                      
 Z64ACFCK     Copy of B64ACFCK                    
 Z81CXSEC     Copy of C81CXSEC    - IOF/CICS only 


Triangle Systems, Inc. PO Box 12752, Research Triangle Park, NC 27709
Email IOFTech@Triangle-Systems.Com

IOFTech    EndFAQ    Maintenance   Release8G       Newsletters    Doc    FAQ    Contacts    Home    Webmaster