Information/Management User s Guide Version 1.1
Information/Management User s Guide Version 1.1
TME 10 Information/Management User's Guide (November 1997) Copyright Notice Copyright 1997 by Tivoli Systems Inc., an IBM Company, including this documentation and all software. All rights reserved. May only be used pursuant to a Tivoli Systems Software License Agreement or Addendum for Tivoli Products to IBM Customer or License Agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of Tivoli Systems. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed including the warranties of merchantability and fitness for a particular purpose. Note to U.S. Government Users Documentation related to restricted rights Use, duplication, or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Trademarks The following product names are trademarks of Tivoli Systems or IBM Corporation: Advanced Function Printing, AFP, AIX, BookManager, CICS, CICS/ESA, Common User Access, CUA, DATABASE 2, DB2, DFSMS/MVS, DFSMSdss, DFSORT, GDDM, IBM, IMS, MVS, MVS/DFP, MVS/ESA, MVS/XA, NetView, OPC, Operating System/2, OS/2, OS/390, OS/400, RACF, Resource Measurement Facility, RMF, SAA, SP, System/370, SystemView, Tivoli, Tivoli Management Environment, TME 10, TME 10 Global Enterprise Manager, VTAM, VSE/ESA. Java and Hot Java are trademarks of Sun Microsystems, Inc. Microsoft, Windows, and the Windows 95 logo are trademarks or registered trademarks of Microsoft Corporation. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited. Other company, product, and service names mentioned in this document may be trademarks or service marks of others. Notice References in this publication to Tivoli Systems or IBM products, programs, or services do not imply that they will be available in all countries in which Tivoli Systems or IBM operates. Any reference to these products, programs, or services is not intended to imply that only Tivoli Systems or IBM products, programs, or services can be used. Subject to Tivoli System's or IBM's valid intellectual property or other legally protectable right, any functionally equivalent product, program, or service can be used instead of the referenced product, program or service. The evaluation and verification of operation in conjunction User s Guide iii
with other products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of the user. Tivoli Systems or IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood, NY, 10594, USA. iv Version 1.1
Contents Preface Who Should Read This Guide.......................................... xi Related Publications................................................ xi What This Guide Contains............................................ xii Typeface Conventions.............................................. xiii Contacting Customer Support......................................... xiv Information/Management Panel Styles Two Panel Styles for Information/Management.............................. 1-1 Enhanced Panel Style............................................ 1-1 Standard Panel Style............................................. 1-2 Selecting a Panel Style............................................ 1-3 Using the Enhanced Panel Style....................................... 1-3 Using Pull-Down Menus........................................... 1-3 Pull-Down Menus, PF Keys, and Command Line Entries...................... 1-4 Using a Display with More than 26 Lines.................................. 1-4 Using a Display with Fewer than 26 Lines................................. 1-5 Other Considerations for Processing Enhanced Panel Style Panels.............. 1-7 Information/Management Graphical User Interface Using the Graphical User Interface Controls................................ 2-1 Push Buttons.................................................. 2-2 Mnemonic Choice Selections........................................ 2-5 Unavailable Pull-Down Choices...................................... 2-6 Accelerator Keys................................................ 2-7 Separator Bars................................................. 2-8 Using Your Workstation Editor......................................... 2-8 Using ISPF Split Screens............................................ 2-8 Before You Begin Responding to Different Panel Types.................................... 3-1 Three Data-Entry Methods........................................... 3-7 Typing Data Directly into the Field.................................... 3-7 Typing Data on the Command Line................................... 3-11 Using the Equal Sign Function...................................... 3-11 User s Guide v
Contents Leaving Panels.................................................. 3-14 Using PF Keys.................................................. 3-15 Getting Help.................................................... 3-16 Using the Online Overview........................................ 3-16 Requesting Assisted-Entry Panels.................................... 3-16 Using the HELP Command........................................ 3-16 Clearing Messages from the Screen.................................. 3-17 A Note about Information/Management Messages......................... 3-17 Getting Started Preparing to Start................................................. 4-1 Looking at the Primary Options Menu.................................... 4-2 Selecting an Application............................................. 4-4 Understanding and Defining Your User Profile.............................. 4-6 Modifying Your User Profile.......................................... 4-7 Modifying Profile Values........................................... 4-8 Saving Profile Changes........................................... 4-13 Choosing a Privilege Class.......................................... 4-14 Working with Records from the Primary Options Menu Beginning the Exercises............................................. 5-1 Displaying a Record from the Primary Options Menu.......................... 5-2 Printing a Record from the Primary Options Menu............................ 5-7 Copying a Record from the Primary Options Menu.......................... 5-12 Updating a Record from the Primary Options Menu.......................... 5-18 Update by Typing Data Directly into the Field............................ 5-20 Update by Typing the Data on the Command Line......................... 5-21 Update by Using the Equal Sign Function.............................. 5-22 Deleting a Record from the Primary Options Menu.......................... 5-25 Creating a Record from the Primary Options Menu.......................... 5-28 Using Assisted-Entry Panels......................................... 5-32 Validation Data Panel............................................. 5-40 Working with Records from a Search Results List Beginning the Exercises............................................. 6-1 Performing the Search for Records..................................... 6-2 Displaying a Record from the Search Results List............................ 6-4 Printing a Record from the Search Results List.............................. 6-4 Copying a Record from the Search Results List............................. 6-6 Updating a Record from the Search Results List............................. 6-7 Deleting a Record from the Search Results List............................. 6-9 Using Commands Entering Commands............................................... 7-1 Information/Management Command Summary.............................. 7-3 Reading Command Syntax........................................... 7-5 Entering Search Keywords........................................ 7-35 vi Version 1.1
Contents Line Command Summary........................................... 7-46 Block Line Commands........................................... 7-47 Entering Line Commands......................................... 7-47 Understanding Special Types of Records and Fields Parent/Child Record Relationships...................................... 8-1 Required Fields.................................................. 8-1 Automatic Entry of Fields............................................ 8-1 Journal Fields.................................................... 8-2 Record Identifiers................................................. 8-2 Text Control Data Fields............................................. 8-2 Editing Freeform Text.............................................. 8-3 Preserving the Audit Trail for Freeform Text.............................. 8-4 Repairing Mixed Data.............................................. 8-7 Obtaining Information from a Database Searching for Information............................................ 9-1 Creating a Search Argument.......................................... 9-2 Using the Structured Search Method to Create a Search Argument.............. 9-2 Using Quick Search to Create a Search Argument......................... 9-10 Understanding Line Commands....................................... 9-17 Using Block Line Commands....................................... 9-19 Using the Search Argument to Obtain Reports............................. 9-23 Printing Other Kinds of Reports....................................... 9-26 Learning More about Obtaining Information from a Database Choosing a Database............................................. 10-1 Searching for Information........................................... 10-2 Performing a Structured Search..................................... 10-4 Performing a Quick Search........................................ 10-4 Performing a Freeform Search...................................... 10-4 Performing a Combined Search.................................... 10-11 Limiting Your Search........................................... 10-14 Using Search Operators........................................... 10-14 Logical OR.................................................. 10-16 Logical AND................................................. 10-16 Logical NOT................................................. 10-16 Range of Values.............................................. 10-18 Abbreviated Keyword........................................... 10-19 Position-Ignore............................................... 10-20 Position-Ignore in a Range Search.................................. 10-21 Searching for Fields............................................. 10-25 Examples of Searching for Fields................................... 10-25 Searching Mixed Case Data........................................ 10-26 Effects of SDIDS Key Length Settings................................. 10-28 Using the Keyword Glossary........................................ 10-29 Viewing Records Sequentially....................................... 10-29 User s Guide vii
Contents Viewing an Entire File........................................... 10-30 Searching Sequentially and by Search Results.......................... 10-30 Using Response Chains Using Immediate Response Chains.................................... 11-1 Working with an Immediate Response Chain............................ 11-1 Hints and Tips for Entering Immediate Response Chains.................... 11-4 Using Stored Response Chains....................................... 11-5 Hints and Tips for Generating Stored Response Chains.................... 11-13 Producing Reports with Stored Response Chains........................ 11-14 Processing Stored Response Chains.................................. 11-15 Hints and Tips for Processing Stored Response Chains.................... 11-17 Working with Table Displays Understanding Table Displays........................................ 12-1 Learning the Format of Table Displays.................................. 12-3 Understanding Logical Lines and Physical Lines.......................... 12-4 Scrolling Table Displays............................................ 12-6 Scrolling Logical Lines and Physical Lines.............................. 12-7 Scrolling Columns.............................................. 12-8 Displaying and Updating DBCS Scrolled Data............................ 12-8 Getting Output from Information/Management Output Destinations............................................... 13-1 Print Output Destination Specification................................. 13-1 Report Output Destination Specification................................ 13-2 Routing Output to SYSOUT......................................... 13-2 Routing Output to DSNAME......................................... 13-3 Routing Output to DDNAME......................................... 13-3 Production of Output.............................................. 13-3 Output from a Database.......................................... 13-3 Output from TSPs and TSXs....................................... 13-4 Output from Panels............................................. 13-4 Quick Reference Table for Output.................................... 13-4 Your Organization s Procedures Getting Started................................................... A-1 Numbering a Record............................................... A-1 Data-Entry Conventions............................................. A-2 Deleting a Record................................................. A-4 Printing a Record................................................. A-5 P-Word Lists by Record Type Privilege Class Records............................................. B-2 Stored Response Chain (SRC) Records.................................. B-2 Validation Records................................................ B-2 viii Version 1.1
Contents Problem Records................................................. B-2 Change Records.................................................. B-4 Activity Records.................................................. B-5 Configuration Records.............................................. B-6 Hardware Component Records....................................... B-6 Hardware Connection Records....................................... B-6 Hardware Feature Records......................................... B-7 Hardware Subcomponent Records.................................... B-7 Model Hardware Component Records.................................. B-7 Model Hardware Feature Records..................................... B-8 Model Hardware Subcomponent Records................................ B-8 Software Component Records....................................... B-8 Software Connection Records....................................... B-9 Software Feature Records.......................................... B-9 Model Software Component Records.................................. B-10 Model Software Feature Records.................................... B-10 Hardware Financial Records....................................... B-10 Software Financial Records........................................ B-11 System Records............................................... B-11 Service Records............................................... B-11 Data Center Records............................................ B-12 Rules Records................................................ B-12 Relating Publications to Specific Tasks Typical Tasks.................................................... C-1 Where to Find More Information The Information/Management Library.................................... D-1 Information/Management Courses Education Offerings................................................ E-1 United States.................................................. E-1 United Kingdom................................................. E-1 Bibliography Glossary Index User s Guide ix
Contents x Version 1.1
Preface This book is intended to help you learn how to use Information/Management. It contains training exercises to teach you how to perform end-use tasks. The first part of this book presents a series of exercises that teach you some specific tasks that the Information/Management program can help you perform. If you are a beginning user, do these exercises first. Before you can begin the exercises, the database you use must contain a set of training records that have been created by your program administrator. After you finish the exercises, you should be ready to use other books in the Information/Management library that apply more directly to the tasks you perform every day. You can find these books listed in the Prerequisite section of this book. Who Should Read This Guide This guide is for users of Information/Management who need to learn how to copy, update, print, create, delete records; how to enter commands; or how to search an Information/Management database. To use the User s Guide, you should understand how to use applications on your MVS/ESA operating system. You do not have to know anything about the Information/Management program. Related Publications The library for Information/Management Version 1.1 consists of these publications. For a description of each, see The Information/Management Library on page D-1. Application Program Interface Guide, SC34-4592-00 Client Installation and User s Guide, SC34-4593-00 Diagnosis Guide, SC34-4594-00 General Information, GC34-4595-00 Integration Facility Guide, SC34-4596-00 Licensed Program Specification, GC34-4597-00 Master Index, Glossary, and Bibliography, SC34-4598-00 Messages and Codes, GC34-4599-00 NetView and TME 10 Interfaces Reference, SC34-4613-00 Operation and Maintenance Reference, SC34-4601-00 Panel Modification Facility Guide, SC34-4602-00 Planning and Installation Guide and Reference, SC34-4603-00 User s Guide xi
Preface Problem, Change, and Configuration Management, SC34-4604-00 Program Administration Guide and Reference, SC34-4605-00 Reference Summary, SC34-4607-00 Report Format Facility Guide and Reference, SC34-4608-00 Terminal Simulator Guide and Reference, SC34-4609-00 User s Guide, SC34-4610-00 World Wide Web Interface Guide, SC34-4570-00 A subscription to the Information/Management customer newsletter, The Structured Word, is available to you free of charge. Send your complete mailing address to: Tivoli Systems The Structured Word Dept. X7GA/Bldg. 503 P.O. Box 12195 3039 Cornwallis Road Research Triangle Park, NC 27709-2195 USA What This Guide Contains Chapters 1 through 13 help you learn about Information/Management. Use the training records to step through the exercises in this part of the book. The exercises teach you how to use Information/Management program commands and line commands to copy, update, print, create, and delete records. You can learn how to create a search argument and how to use the search argument to generate reports. You can also learn how to use Information/Management help facilities when you need assistance. Once you have mastered the basics, you can use this part of the book to obtain more detailed information about the tasks you perform every day with Information/Management. For example, you can learn about creating effective search arguments to retrieve information from a database. Chapter 7 and the Appendixes contain reference information. Using Commands on page 7-1 provides complete descriptions of and syntax for the Information/Management program and line commands. Use this chapter in conjunction with the Reference Summary when you need to look up information about a particular command. Your Organization s Procedures on page A-1 is a convenient place for you to make notes about how your organization performs certain tasks (for example, entering data and numbering records) with the Information/Management program. If you are a program administrator, you can use this chapter to detail operating procedures all users in your organization should follow. P-Word Lists by Record Type on page B-1 lists prefixes and the fields with which they are associated. xii Version 1.1
Preface Character Set Support This product is enabled for DBCS support. As a result, this book uses the following terms: DBCS (double-byte character set) SBCS (single-byte character set) Mixed data. The term mixed data refers to data strings that can contain only DBCS data, only SBCS data, or any combination of DBCS and SBCS data. SBCS data is the same as EBCDIC data. The term mixed case data refers to data strings that can contain uppercase, lowercase, or a combination of uppercase and lowercase SBCS data. For more information, see the glossary. Typeface Conventions This guide uses several typeface conventions for special terms and actions. These conventions have the following meaning: Bold Italics Monospace Entries that you must use literally, choices, or options that you select appear in bold. Variables and values that you must provide appear in italics. New terms also appear in italics. Code examples appear in monospace font. The panels as presented in this book are not meant to be exact replicas of the way a panel might appear on the screen. The information on the panels is correct, but the spacing is not always exact. Commands, such as END, CONTROL, RESUME, or DOWN, appear in all capital letters in text. Although not commands, the user responses YES and NO also appear in capital letters. The Use of Panel Style in This Book With Information/Management, you may see changes in the way Information/Management panels are displayed. Two panel styles are available: the standard panel style and the enhanced panel style. The style of panel does not affect the data that must be entered from it. Except where noted, this book uses the Information/Management standard panel style when showing you how a panel looks. For more information about the enhanced panel style, refer to the Program Administration Guide and Reference, the Planning and Installation Guide and Reference, and Information/Management Panel Styles on page 1-1 in this book. User s Guide xiii
Preface Contacting Customer Support We are very interested in hearing from you about your experience with the products and documentation in the TME 10 Information/Management environment. We welcome your suggestions for improvements. To contact Tivoli for support, call IBM Support Services at any time. IBM Support Services provides telephone assistance for problem diagnosis and resolution in the United States and Puerto Rico. The number to call is (800) 237-5511. Outside the United States and Puerto Rico, contact your country's local IBM support organization. You can fax comments on this publication to (919) 254-0206. When you send information to Tivoli, you grant Tivoli a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. You can also order publications by phone or fax. IBM Software Manufacturing Solutions takes publication orders between 8:30 a.m. and 7:00 p.m. eastern standard time (EST). The phone number is (800) 879-2755. The fax number is (800) 445-9269 (attention fax department). xiv Version 1.1
1 Information/Management Panel Styles Panel Styles Information/Management provides the following panel styles: The standard panel style, which was the only style available prior to Information/Management Version 6.1. See Standard Panel Style on page 1-2 for an illustration. The enhanced panel style, which adds to the standard panel by providing an action bar, pull-down menus, and context-specific function keys. See Enhanced Panel Style for an illustration. Two Panel Styles for Information/Management This section introduces you to the format of the enhanced panel style. It also explains the differences between the two styles and how to use the enhanced panel style. The next two sections show the different appearances of the standard panel style and the enhanced panel style. Note: The examples shown in later chapters of this book use the standard panel style when showing you how a panel looks. Enhanced Panel Style The action bar appears on the top line of panels using the enhanced panel style. Placing the cursor on an action item and pressing Enter displays the pull-down menu for that action item. The context-specific function keys appear at the bottom of the panel. User s Guide 1-1
Two Panel Styles for Information/Management Environment Dialog Record Window Options Help ------------------------------------------------------------------------------ ===> BLGEN2 --- PRIMARY OPTIONS MENU --- APPLICATION: MANAGEMENT OPTIONS: 1. OVERVIEW...Display general information and product enhancements. 2. PROFILE...Display or alter invocation or session defaults. 3. APPLICATION...Change application, list available applications. 4. CLASS...Change current class, list available classes. 5. ENTRY...Create a record. 6. INQUIRY...Search for records. 7. UTILITY...Copy, display, print, delete, and update records. 8. GLOSSARY...Display a list of searchable words in the database. 9. PMF...Modify or create Information/Management panels. Select an option, enter a command, or type QUIT to exit. Information/Management Version 1 Release 1 5648-142 (C) Copyright Tivoli Systems Inc., an IBM Company, 1997 F1=Help F2=Set 2 F3=End F4=Split F5=Back F6=Suspend F7=Up F8=Down F9=Recall F1=Actions F11=Init F12=Cancel Standard Panel Style The standard panel style is the panel style shipped with Information/Management. BLGEN2 --- PRIMARY OPTIONS MENU --- APPLICATION: MANAGEMENT OPTIONS: 1. OVERVIEW...Display general information and product enhancements. 2. PROFILE...Display or alter invocation or session defaults. 3. APPLICATION...Change application, list available applications. 4. CLASS...Change current class, list available classes. 5. ENTRY...Create a record. 6. INQUIRY...Search for records. 7. UTILITY...Copy, display, print, delete, and update records. 8. GLOSSARY...Display a list of searchable words in the database. 9. PMF...Modify or create Information/Management panels. Select an option, enter a command, or type QUIT to exit. Information/Management Version 1 Release 1 5648-142 (C) Copyright Tivoli Systems Inc., an IBM Company, 1997 ===> 1-2 Version 1.1
Two Panel Styles for Information/Management Selecting a Panel Style Information/Management provides the WINDOW command to enable you to change the panel style you are using. The WINDOW command also lets you select which window to use for the enhanced panel style. A window is a specific set of action bars, pull-down menus, and context-specific function keys used to display Information/Management panels. If you use the enhanced panel style, you can choose between automatic window selection and manual window selection. You can temporarily switch to the standard panel style by issuing the following command: WINDOW STANDARD Panel Styles To return to the enhanced panel style, issue the following command: WINDOW ENHANCED Also, when using the enhanced panel style as the default panel style, you can change the default panel style to the standard panel style by issuing the following commands: WINDOW STANDARD WINDOW SAVE For more information on the WINDOW command, see page 7-45. Using the Enhanced Panel Style To make Information/Management more familiar to users of Common User Access (CUA) compliant interfaces, the Information/Management panels can appear with an action bar at the top, pull-down menus, and context-specific function keys. If your program administrator made changes to the panels in your installation of Information/Management, the panels may appear different from those shown in this book. Using Pull-Down Menus The action bar containing action items appears at the top of an Information/Management panel using the enhanced panel style. To choose an action: 1. Use your mouse or the tab key to move the cursor to the action item you want. 2. Press Enter; a pull-down menu appears in a box below the chosen action item. Each pull-down choice corresponds to a command that you can choose. 3. Type the number of the selection you want to the left of the first selection in the menu. The following example shows the Primary Options Menu panel in the enhanced panel style with the pull-down menu for the Environment action item displayed. User s Guide 1-3
Using the Enhanced Panel Style Environment Dialog Record Window Options Help ----------------------------------------- MORE: + _ 1.User profile... PRIMARY OPTIONS MENU --- APPLICATION: MANAGEMENT 2. Suspend 3. Resume 4. Initialize 5. Quit/Exit splay general information and product enhancements. splay or alter invocation or session defaults. 3. APPLICATION...Change application, list available applications. 4. CLASS...Change current class, list available classes. 5. ENTRY...Create a record. 6. INQUIRY...Search for records. 7. UTILITY...Copy, display, print, delete, and update records. 8. GLOSSARY...Display a list of searchable words in the database. 9. PMF...Modify or create Information/Management panels. Select an option, enter a command, or type QUIT to exit. Information/Management Version 1 Release 1 5648-142 (C) Copyright Tivoli Systems Inc., an IBM Company, 1997 F1=Help F2=Set 2 F3=End F4=Split F5=Back F6=Suspend F7=Up F8=Down F9=Recall F1=Actions F11=Init F12=Cancel Pull-Down Menus, PF Keys, and Command Line Entries Generally, commands selected from pull-down menus are treated the same as commands entered with PF keys. Commands selected from pull-down menus are used to prefix data on the command line if your PROFILE, SESSION, PF KEY DATA is set to PREFIX. For example, to update record 00000002, enter R 2 on the command line, and select UPDATE from the Record pull-down menu. The record is updated the same as if you had entered UPDATE R 2 on the command line and pressed Enter. Using a Display with More than 26 Lines The following example shows the Information/Management default Primary Options Menu panel using the enhanced panel style on a display with more than 26 lines and with the function keys showing. 1-4 Version 1.1
Using a Display with More than 26 Lines Environment Dialog Record Window Options Help ------------------------------------------------------------------------------ ===> BLGEN2 --- PRIMARY OPTIONS MENU --- APPLICATION: MANAGEMENT OPTIONS: 1. OVERVIEW...Display general information and product enhancements. 2. PROFILE...Display or alter invocation or session defaults. 3. APPLICATION...Change application, list available applications. 4. CLASS...Change current class, list available classes. 5. ENTRY...Create a record. 6. INQUIRY...Search for records. 7. UTILITY...Copy, display, print, delete, and update records. 8. GLOSSARY...Display a list of searchable words in the database. 9. PMF...Modify or create Information/Management panels. Panel Styles Select an option, enter a command, or type QUIT to exit. Information/Management Version 1 Release 1 5648-142 (C) Copyright Tivoli Systems Inc., an IBM Company, 1997 F1=Help F2=Set 2 F3=End F4=Split F5=Back F6=Suspend F7=Up F8=Down F9=Recall F1=Actions F11=Init F12=Cancel Using a Display with Fewer than 26 Lines If your screen displays fewer than 26 lines, the enhanced panel appears like the next one. The MORE: + designation at the end of the line separating the action bar from the rest of the panel means that there are lines on the panel that do not appear on your screen. The + indicates that you must scroll down to see the hidden lines. You can use the function keys shown at the bottom of the screen or the Information/Management UP and DOWN commands to scroll a panel. If you use the Information/Management UP and DOWN commands, remember that the operands for these commands are valid only on table display panels. The operands for the UP and DOWN commands are ignored on non-table display panels. Note: A table display panel is one that has LINE of in the upper right-hand corner. User s Guide 1-5
Using a Display with Fewer than 26 Lines Environment Dialog Record Window Options Help ---------------------------------------------------------------- MORE: + ===> BLGEN2 --- PRIMARY OPTIONS MENU --- APPLICATION: MANAGEMENT OPTIONS: 1. OVERVIEW...Display general information and product enhancements. 2. PROFILE...Display or alter invocation or session defaults. 3. APPLICATION...Change application, list available applications. 4. CLASS...Change current class, list available classes. 5. ENTRY...Create a record. 6. INQUIRY...Search for records. 7. UTILITY...Copy, display, print, delete, and update records. 8. GLOSSARY...Display a list of searchable words in the database. 9. PMF...Modify or create Information/Management panels. Select an option, enter a command, or type QUIT to exit. F1=Help F2=Set 2 F3=End F4=Split F5=Back F6=Suspend F7=Up F8=Down F9=Recall F1=Actions F11=Init F12=Cancel After you scroll down to see the hidden lines, the MORE: + notation changes to MORE. This still means that there are lines on the panel that do not appear on your screen. The indicates that you must scroll up to see the hidden lines. Environment Dialog Record Window Options Help ---------------------------------------------------------------- MORE: - ===> OPTIONS: 1. OVERVIEW...Display general information and product enhancements. 2. PROFILE...Display or alter invocation or session defaults. 3. APPLICATION...Change application, list available applications. 4. CLASS...Change current class, list available classes. 5. ENTRY...Create a record. 6. INQUIRY...Search for records. 7. UTILITY...Copy, display, print, delete, and update records. 8. GLOSSARY...Display a list of searchable words in the database. 9. PMF...Modify or create Information/Management panels. Select an option, enter a command, or type QUIT to exit. Information/Management Version 1 Release 1 5648-142 (C) Copyright Tivoli Systems Inc., an IBM Company, 1997 F1=Help F2=Set 2 F3=End F4=Split F5=Back F6=Suspend F7=Up F8=Down F9=Recall F1=Actions F11=Init F12=Cancel If MORE: + appears at the end of the line separating the action bar from the rest of the screen, you can scroll up or down to see hidden lines. 1-6 Version 1.1
Using a Display with Fewer than 26 Lines Other Considerations for Processing Enhanced Panel Style Panels You process enhanced panel style panels the same as you do standard panel style panels. However, keep the following considerations in mind when you use the enhanced panel style panels: When using the enhanced panel style, if you: Select the last item of a list Completely fill a command line Completely fill the last field on a panel the cursor automatically moves to the first action item on the action bar at the top of the screen. Leaving the cursor on the action bar and pressing Enter causes the pull-down menu for that action item to appear. To prevent the pull-down menu from appearing, use your mouse or the tab key to move the cursor to the command line. You can then process the panel. The definitions of the function keys in the enhanced panel style differ from the definitions in the standard panel style. The definitions of the function keys in the enhanced panel style differ among the following windows: BLGISPFE The primary window BLGISPFA The administration window The action bar items are not protected fields. You can type over them, but no harm occurs if you do. To clear any text you accidentally type over an action bar item, move your cursor to the command line, type end and press Enter. The action bar item reappears, replacing the text you typed. The ISPF PFSHOW command affects which PF keys are shown. Refer to the ISPF Dialog Management Guide and Reference for more information. Panel Styles For ISPF Version 3.5 users: The fields on the ISPF Terminal Characteristics panel determine how many lines are displayable. Refer to the ISPF Dialog Management Guide and Reference for more information. For ISPF Version 4.1 (and later) users: The Screen format field on the ISPF Settings panel determines how many lines are displayable. Refer to the ISPF User s Guide for more information. If you use a terminal with a 24-line screen, you must scroll up or down to see all the text on the panel. Note: Your user profile has settings that also control the number of lines and columns that are displayed. User s Guide 1-7
1-8 Version 1.1
2 Information/Management Graphical User Interface This chapter describes the graphical user interface that is available if you are using ISPF Version 4.1 or higher. Graphical User Interface Using the Graphical User Interface Controls If you use ISPF Version 4.1 or higher with Information/Management, you can view Information/Management panels as workstation windows. Graphical user interface controls, such as sizable, movable, and scrollable windows, push button function keys, action bars, and pull-down menus, are automatically available when you run in ISPF s graphical user interface (GUI) mode. For information on starting Information/Management in GUI mode, refer to the Planning and Installation Guide and Reference. For more information on running in GUI mode, refer to the ISPF User s Guide. Your Information/Management program administrator can enable the following additional GUI features for Information/Management: Push buttons Mnemonic choice selections Accelerator keys Separator bars Unavailable pull-down choices. If these features do not appear automatically when you use Information/Management in ISPF s GUI mode, contact your Information/Management program administrator. Figure 1 on page 2-2 shows the Information/Management Primary Options Menu displayed in GUI mode. User s Guide 2-1
Using the Graphical User Interface Controls Figure 1. Information/Management Primary Options Menu Displayed in ISPF GUI Mode Push Buttons This feature enables you to make certain Information/Management selections, such as selecting a number on an options panel, by using the mouse to click on a push button point-and-shoot field. The push button appears graphically as a three-dimensional rectangle. You can move the mouse pointer to any point on the push button and then click. Pressing the push button can result in one of five actions, depending on the push button that is selected. The following sections describe the five uses of the push buttons. Selection Numbers These push buttons appear where a selection number normally appears on selections, options, and data-entry panels. When you press the push button, Information/Management enters the number and performs the associated action. The option numbers on the Information/Management Primary Options Menu (see Figure 1) are examples of these push buttons. 2-2 Version 1.1
Using the Graphical User Interface Controls Note: If you already typed other values on the command line, Information/Management appends the selection number to the command line using the handling method that you specified in the PF key data field of your user profile. Assisted-Entry Panel Plus Signs (+) All assisted-entry panels contain text within a box. The box corners are represented by the plus sign (+) character. When you run Information/Management in GUI mode, the plus signs become push buttons. Pressing any one of the plus signs opens the associated Validation Help panel. Figure 2 shows an assisted-entry panel with plus sign push buttons. Graphical User Interface Figure 2. Information/Management Assisted-Entry Panel with Plus Sign and Literal Value Push Buttons Literal Values A literal value is any group of characters in an assisted-entry panel or a Validation Help panel that is delimited by a less than (<) symbol and a greater than (>) symbol when you run in 3270 mode (see Figure 3 on page 2-4). When you run in GUI mode, the symbols disappear, and you see a push button instead. When you press a literal value push button, the value on the button is returned to the assisted-entry panel. The INITIAL, OPEN, and CLOSED push buttons in Figure 2 are examples of literal value push buttons. User s Guide 2-3
Using the Graphical User Interface Controls Environment Dialog Record Window Options Help ------------------------------------------------------------------- MORE: + ===> + BLG6STAT --------------- CURRENT STATUS ------------------ STAC/-+ USE...Specify the problem, change, or activity record status. NOTE...Any commands issued here must be preceded by a ';'. REPLY: <INITIAL>...The record has been entered. <OPEN>...The record has been assigned or opened. <CLOSED>...The record has been closed or completed. +----------------------- REPLY AS DEFINED -------------------------+ F1=Help F2=Set 2 F3=End F4=Split F5=Back F6=Suspend F7=Up F8=Down F9=Recall F1=Actions F11=Init F12=Cancel Figure 3. Information/Management Assisted-Entry Panel Displayed in 3270 Mode Table Panel Values An Information/Management table panel contains columns of fields and rows of data. The first column of each row of the table panel, which is usually the record number ID, appears as a push button. Pressing one of these push buttons moves that row of data to the top of the display and selects it. Figure 4 on page 2-5 shows a search results list, which is displayed in a table panel. The values in the RECORD ID field are push buttons. 2-4 Version 1.1
Using the Graphical User Interface Controls Graphical User Interface Figure 4. Information/Management Table Panel (Search Results List) Displayed in ISPF GUI Mode Table Panel Line Commands The line commands that are listed on a table panel become push buttons when you use Information/Management in GUI mode. The push buttons are located on the panel following Line Cmds:. Pressing a line command push button is the same as entering LINECMD x on the Information/Management command line, where x is the first letter on the push button. For example, if you want to update the sixth record in a search results list containing 3357 records (see Figure 4 on page 2-5), do the following: 1. Press the push button that represents the record ID for the sixth row in the list. Information/Management selects that row and moves it to the top of the displayed list. 2. Press the Update push button, and Information/Management opens the record for update. Mnemonic Choice Selections This feature enables you to select an action bar or pull-down menu choice by pressing the letter that is underscored in the choice text. Before you can use a mnemonic, you must first select the action bar or pull-down menu. For example, to use mnemonics to choose Change to Inquiry window, do the following: 1. Press the ALT key once to select the action bar. User s Guide 2-5
Using the Graphical User Interface Controls 2. Press W to select the Window pull-down menu. 3. Press I to select Change to Inquiry window. Figure 5 shows the Window pull-down menu. Figure 5. A Pull-Down Menu with Mnemonic Selections and Unavailable Choices Unavailable Pull-Down Choices This feature prevents you from selecting a choice that is not currently valid from a pull-down menu. The choice is highlighted and disabled. For example, in Figure 5 on page 2-6, you are using the enhanced panel style, so the Change to Enhanced window choice is highlighted in gray in the Window pull-down menu. If you attempt to select Change to Enhanced window, no action occurs. 2-6 Version 1.1
Using the Graphical User Interface Controls Accelerator Keys This feature enables users of ISPF Version 4.2 to press a combination of keys to start a function from a pull-down menu. If an action item on a pull-down menu has an accelerator defined, you can start that action by using the accelerator even if you have not switched to the action bar or displayed the pull-down menu. Figure 6 shows the Options pull-down menu that appears when you use ISPF Version 4.2. Notice that to the right of both the Settings and Configure tool integration choices, there are accelerator keys defined: Ctrl+S for the Settings... option Ctrl+W for the Configure tool integration... option. Graphical User Interface Figure 6. A Pull-Down Menu with Accelerator Keys User s Guide 2-7
Using the Graphical User Interface Controls Separator Bars This feature provides users of ISPF Version 4.2 with a visual distinction between adjacent areas within a pull-down menu. Figure 6 on page 2-7 shows two separator bars and divides the pull-down menu into three visually distinct parts. Using Your Workstation Editor If your organization is using ISPF Version 4.2 or higher, you can choose to use a workstation editor, rather than a host editor, to edit freeform text in Information/Management records. There are two things you must do to enable Information/Management to use your workstation editor: 1. Update your user profile and specify WS as your editor selection. See Modifying Your User Profile on page 4-7 for help with this step. 2. Select Configure tool integration from the Options pull-down menu. Enter the information about your workstation editor on the ISPF Tool Integration panel. Then return to Information/Management. When you select to edit freeform text in a record, your workstation editor is started. When you finish and close your editor, the data you entered is filed with the record on the host (not on your workstation). If you specify WS in your user profile but you are not using ISPF Version 4.2 or higher GUI, Information/Management uses the ISPF/PDF editor instead. If you need to use your workstation editor when you are in 3270 mode, contact your Information/Management program administrator to specify the NOGUIDSP parameter of the ISPSTART command. For information on starting Information/Management, refer to the Planning and Installation Guide and Reference. Using ISPF Split Screens When you use the ISPF split screen function in GUI mode, you see two separate workstation windows. To split the screens, you can do one of the following: Select the Split function key push button Type the ISPF SPLIT command on the command line, and press Enter. If you use the Information/Management enhanced panel style, you also can split the screen by selecting Open new window from the Window pull-down menu. To toggle between the two windows, you can do one of the following: Click the mouse on the second window Type the ISPF SWAP command on the command line, and press Enter. If you use the Information/Management enhanced panel style, you also can toggle between windows by selecting Next open window from the Window pull-down menu. 2-8 Version 1.1
Using ISPF Split Screens Each window is independently sizable, movable, and scrollable. However, when you press Enter in the current window, transactions in the second window wait for transactions in the current window to complete. Graphical User Interface User s Guide 2-9
2-10 Version 1.1
3 Before You Begin This chapter shows you: How to respond to various kinds of panels How to enter data three ways How to use PF keys How to get help. Before You Begin Responding to Different Panel Types When you work with Information/Management, you respond to various panels to accomplish tasks. Different types of panels help you perform different tasks. Your response to a panel depends on what kind of panel it is. Most panels prompt you for the type of response required: entering data, making a selection, or typing a command. The following panels are examples of those that you use when working with Information/Management. Included with the panels are explanations of the panel contents and how you respond to each panel. Primary Options Menu Displays a list of numbered options, each of which begins a task. To select an option, type the number on the command line and press Enter. User s Guide 3-1
Responding to Different Panel Types BLGEN2 --- PRIMARY OPTIONS MENU --- APPLICATION: MANAGEMENT OPTIONS: 1. OVERVIEW...Display general information and product enhancements. 2. PROFILE...Display or alter invocation or session defaults. 3. APPLICATION...Change application, list available applications. 4. CLASS...Change current class, list available classes. 5. ENTRY...Create a record. 6. INQUIRY...Search for records. 7. UTILITY...Copy, display, print, delete, and update records. 8. GLOSSARY...Display a list of searchable words in the database. 9. PMF...Modify or create Information/Management panels. Select an option, enter a command, or type QUIT to exit. Information/Management Version 1 Release 1 5648-142 (C) Copyright Tivoli Systems Inc., an IBM Company, 1997 ===> Selection Panel Displays a list of numbered items. To select an option, type the selection number on the command line and press Enter. + BLG11 ----------- SYSTEM RECORD INQUIRY -------------- 1 OF 1-+ USE...Identify the type of records to include in the inquiry. 1.CLASS...Include privilege class records in inquiry. 2.SRC...Include SRC records in the inquiry. 3.MAP...Include mapping records in inquiry. +------------------------- SELECT ITEM ----------------------------+ ===> 3-2 Version 1.1
Responding to Different Panel Types Data-Entry Panel Enables you to enter data in a number of data fields. See Three Data-Entry Methods on page 3-7 BLGB1 PROBLEM REPORTER ENTRY PROBLEM: Enter problem reporter data; cursor placement or input line entry allowed. 1. Reported by...<r> 13. Problem type... 2. Reporter dept... 14. Problem status...<r> 3. Reporter phone... 15. User problem number.. 4. Date occurred... 16. Initial priority... 5. Time occurred... 17. Outage... 6. Network name... 18. Rerun time... 7. System name... 19. Network impact... 8. Program name... 2. System impact... 9. Device name... 21. Program impact... 1. Key item affected... 22. Device impact... 11. Date fix required... 23. User form number... 12. Time fix required... 24. Location code... 26. Outage type... Before You Begin 25. Description...<R> When you finish, type END to save or CANCEL to discard any changes. ===> User s Guide 3-3