Operating

crqeb13
timer Asked: Feb 15th, 2018

Question Description

so that we talked about and if there anythings let me know

it should be included with assignments..


Thank you..

Unformatted Attachment Preview

ASSINGMENT 2 HANDSON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM J. Packy Laverty packylaverty@gmail.com ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Contents Recommended Prerequisites ............................................................................................................................... 5 z Systems Hands-on Tutorial 1 Requirements ............................................................................................... 5 Z System Tutorial – 2 ISPF and File System Objectives ................................................................................... 5 Tutorial Recommendations .................................................................................................................................. 6 Hands-on is the Best Way to Learn ................................................................................................................. 6 Handling Common Errors submitting a JCL Job, using ISPF and SDSF .................................................... 6 Recommended Videos ...................................................................................................................................... 6 Requirement 1. Introduction to the Functions of File Systems ........................................................................ 8 1.1 Naming Files or Datasets ........................................................................................................................... 8 1.1.1 Naming files in the Windows NTFSv5 file system............................................................................ 8 1.1.2 Naming z System Data sets ................................................................................................................ 9 1.2 What is a data set? ...................................................................................................................................... 9 1.3 Managing the Content of a File or Data set .............................................................................................. 9 1.4 Organizing Files or Data sets ................................................................................................................... 10 1.4.1 Organizing by Physical Disks (DASDs) and Disk Volume Storage .............................................. 10 1.4.2 VTOC (Volume Table of Contents) ................................................................................................... 10 1.4.3 Organizing by Files/Folders (Windows, UNIX or Linux Hierarchical File System) ..................... 10 1.4.4 Organizing by Partitioned Data Sets (z System Flat File System) ................................................ 10 1.5 Creating New Files, Folders or Data sets ............................................................................................... 11 1.6. File System Security ................................................................................................................................ 11 Requirement 2.0 ISPF Navigation between ISPF Menus or Panels................................................................ 12 2.1 ISPF Primary Option Menu panel ............................................................................................................ 13 2.2 Utility Selection Panel ............................................................................................................................... 14 2.2.1 Documenting Utility Selection Panel ............................................................................................... 14 2.3 Userids and High Level Qualifier (HLQ) .................................................................................................. 15 2.4 Windows 7 and Linux User Folders and z System User Catalogs ....................................................... 16 2.5 DSLIST Panel ............................................................................................................................................. 16 2.5.1 You have no data sets displayed. .................................................................................................... 18 2.5.2 Questions – Userids, User Catalogs and HLQ ............................................................................... 18 2.6 Submit a JOB to z/OS Using ISPF to install your Tutorial Data Sets ................................................... 19 2.6.1 Enter the TSO SUBMIT Command ................................................................................................... 19 2.6.2 Press the right-ctrl key to execute the JCL JOB ............................................................................ 20 2.6.3 Press the RIGHT-CTRL key to Continue After seeing the three asterisks *** ............................. 20 2.6.4 MAXCC=0000 ..................................................................................................................................... 20 2.6.5 Questions - JCL and Submitting JCL Jobs .................................................................................... 21 2.7 Quick Navigation to the Dataset List (DLIST) Panel =3.4 ...................................................................... 22 2.8 Questions and Documenting your DSLIST Panel .................................................................................. 23 2.9 Comparing DSLIST to Windows Explorer and the DIR command ....................................................... 23 P a g e 2 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.10 Questions - ISPF Navigation .................................................................................................................. 25 Requirement 3.0 Using ISPF and the z/OS File System .................................................................................. 26 3.1 ISPF Function Keys, Primary and Line Commands .............................................................................. 26 3.1.1 ISPF Function Keys ........................................................................................................................... 26 3.1.2 Questions - ISPF Function Keys ...................................................................................................... 27 3.1.3 ISPF Primary Commands .................................................................................................................. 28 3.1.4 Questions - ISPF Primary Commands ............................................................................................. 28 3.1.3 ISPF Line Commands ........................................................................................................................ 28 3.1.4 Problems using ISPF Line Commands ........................................................................................... 29 3.2 Introduction to z System Volumes, VTOCs and Catalogs .................................................................... 30 3.2.1 z System Volumes and VTOCs......................................................................................................... 30 3.2.2 z System User Catalogs .................................................................................................................... 31 3.2.3 Comparing z/OS VTOC with Windows Root Directories ............................................................... 32 3.2.4 Questions - File Systems, Data sets, Volumes and Catalogs ....................................................... 34 3.3 Document Data Set Size ........................................................................................................................... 36 3.3 z/OS Data Set Organization (or File Type) .............................................................................................. 38 3.3.1 Sequential, Partitioned or Partitioned-Extended Data Set Organization ..................................... 38 3.3.2 DSORG is conceptually similar to a Window’s file type. ............................................................... 39 3.4 How does a Partitioned Data Set Work? ................................................................................................. 40 3.5 Questions and Document Dataset Organization (DSORG) ................................................................... 40 3.6 Document Date Created (allocated) and Last Accessed (Referred) .................................................... 43 3.7 Comparing Window’s File and Folder Properties to z/OS .................................................................... 44 3.8 Data Sets Listed by User Catalog ............................................................................................................ 45 3.9 Document Data Sets Listed by Volume .................................................................................................. 46 3.10 Document Data Sets Listed by Sorted Order - ISPF SORT ................................................................ 47 3.11 Document Information stored in the VTOC (Volume Table of Contents) .......................................... 48 Requirement 4.0 Comparing ISPF Utilities to Windows Explorer Utilties. .................................................. 50 4.1 Utility Selection Panel ............................................................................................................................... 50 4.2 Questions - Comparing Windows and ISPF .......................................................................................... 52 Requirement 5.0 ISPF MOVE/COPY, DATASET and LIBRARY Utility Panels ............................................... 53 5.1 Document the Move/Copy Utility Panel .................................................................................................. 53 5.2 Document the Data Set Utility Panel ....................................................................................................... 54 5.3 Document Library Utility Panel ................................................................................................................ 54 5.4 Allocate a Data Set – What does this mean?.......................................................................................... 55 5.5 Questions - Data Set Allocation ............................................................................................................... 56 Requirement 6.0 More Uses of the DSLIST Utility Panel ................................................................................. 56 6.1 DSLIST Utility Panel - Getting Detailed Information about a Dataset or Member .............................. 56 6.1.1 Document Detailed Information for the XXXXXX.COBOL data set DSLIST I Command ............ 57 6.1.2 Document Detailed Information for the XXXXXX.DATA.ACCOUNTS data set. ........................... 58 6.2 DSLIST Utility Panel - Browsing a Data Set or PDS Member ................................................................ 59 P a g e 3 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.2.1 Browsing the XXXXXX.COBOL partitioned data set ...................................................................... 59 6.2.2 Browsing the XXXXXX.COBOL partitioned data set member named CBL0001 .......................... 60 6.2.3 Browsing the XXXXXX.DATA.ACCOUNTS data set. ...................................................................... 62 6.3 DSLIST Utility Panel - Editing a Data Set or PDS Member .................................................................... 63 6.3.1 Browsing the XXXXXX.COBOL(CBL0001) partitioned data set member ..................................... 63 6.3.2 ISPF Primary command RESET ....................................................................................................... 64 6.3.3 ISPF Over-type Edit Mode and Insert Edit Mode ............................................................................ 64 6.3.4. Document the CHANGED AUTHOR NAME .................................................................................... 65 6.3.5 Questions - ISPF Line Commands ................................................................................................... 65 6.3 DSLIST Utility Panel - Editing a XXXXXX.DATA.ACCOUNTS Sequential Data Set............................. 66 6.3.1 Edit Entry Panel – Warn of First Data Change ................................................................................ 66 6.3.2 Sequential z/OS Data Sets and Records ......................................................................................... 68 6.3.3 Document columns 72 through 145 your XXXXX.DATA.ACCOUNTS sequential data set ........ 69 6.3.4 Press F12 to Exit a ISPF Panel without Saving any Changes ....................................................... 69 Requirement 7.0 LOGGING OFF From ISPF and TSO ..................................................................................... 70 7.1 The =X ISPF Command ............................................................................................................................. 70 7.2. Specify Disposition of the LOG Data Set ............................................................................................... 70 7.3 TSO Ready Prompt and LOGOFF Command ......................................................................................... 71 7.4 Restaring ISPF from TSO Ready Prompt ................................................................................................ 71 P a g e 4 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Enter your Name Here  Recommended Prerequisites Z System Tutorial – 2 assumes that you have completed the hands-on requirements for z System Tutorial – 1 Logon z Systems Hands-on Tutorial 1 Requirements ▪ ▪ ▪ ▪ ▪ ▪ ▪ Access to a 3270-Client, Assigned TSO UserId and Password LOGON to TSO (z/OS) and change Initial TSO Password Reviewed Common TSO Logon Problems Reviewed ISPF Primary Option Menu Moved ISPF Option Line using the ISPF Settings Panel Exit ISPF and LOGOFF from TSO Completed testing of the TSO Password Change - LOGON to TSO (z/OS) and LOGOFF Z System Tutorial – 2 ISPF and File System Objectives 1. Students will be introduced and will compare basic z/OS, Windows and Linux file system concepts. 2. Students will be introduced to the role of z/OS DASD (Direct Access Storage Devices), Volumes, VTOC (Volume Table of Content) and User Catalogs used to store and organize data. 3. Students will navigate between ISPF panels, and use function key, primary and line commands. 4. Students will SUBMIT and JCL Job to setup tutorial data sets. 5. Students will use the ISPF Data Set List Panel to browse or edit user cataloged data sets, data set properties, or VTOC information. 6. Students will compare DSLIST to Window Explorer. 7. Students will compare sequential, and partitioned data set organization to popular Windows file types and folders. 8. Students will be introduced to the concept of z/OS data set allocation. 9. Student will review ISPF MOVE/COPY, DATASET and LIBRARY Utility Panels. P a g e 5 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Tutorial Recommendations Hands-on is the Best Way to Learn It is recommended that students logon to z/OS and should attempt the hands-on demonstration examples while **reading this tutorial". The best way to learn z/OS is simply to read the directions and complete the hands-on requirements. The student should avoid getting distracted or becoming overwhelmed by a few technical concepts. If the student follows the hands-on directions, the technical concepts may be easier to understand after you have completed these hands-on requirements. Handling Common Errors submitting a JCL Job, using ISPF and SDSF Z ISPF and File System Tutorial – 2 includes explanations and possible solutions for common errors using ISPF. It is RECOMMENDED for a student to read these problem solving recommendations and attempt to resolve your specific problem BEFORE you ask your instructor for assistance. This tutorial is designed to introduce common ISPF troubleshooting strategies. If after you have read and attempted to apply these troubleshooting suggestions and you still need assistance, DO ASK YOUR INTRUCTOR FOR ASSISTANCE. It is important that your personal experience using the fastest commercial computer in the world will be a success for you. Recommended Videos Your instructor may decide to demonstrate this tutorial. You may also view the ISPF and COBOL and other videos listed below. You are NOT required to view these videos, but you may find that these videos are an excellent supplement to your instructor's demonstration or this z System Tutorial - 2. ISPF and COBOL Video - http://youtu.be/ozXKLwRwuOo Dr. Packy Laverty's demonstration and presentation of the initial z System logon process, using ISPF, submitting a sample JCL job to set up tutorial data sets, submitting a JCL job to compile, link, and execute a sample COBOL program, and using SDSF to review the COBOL job output. Rated for beginners. Video ISPF Productivity Tool Overview Part 1- https://www.youtube.com/watch?v=fhkms6ozen4 Video ISPF Productivity Tool Overview Part 2 -https://www.youtube.com/watch?v=y7L-VpZdLg0 ISPF http://en.wikipedia.org/wiki/ISPF Mainframe - Using TSO and ISPF - http://answers.uchicago.edu/page.php?id=19482 TSO/ISPF - Features and Setup Instructions - http://www.upenn.edu/computing/admin/mvs/ispf.html What is ISPF? http://publib.boulder.ibm.com/infocenter/zos/basics/index.jsp?topic=/com.ibm.zos.zconcepts/zconc_wh atisbatch.htm What is JES? http://publib.boulder.ibm.com/infocenter/zos/basics/index.jsp?topic=/com.ibm.zos.zconcepts/zconc_wh atisbatch.htm Main Features of ISPF http://publib.boulder.ibm.com/infocenter/zos/basics/topic/com.ibm.zos.zcourses/zcourses_ispfmain_bo ok.pdf P a g e 6 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM ISPF Primary menu and Datasets http://publib.boulder.ibm.com/infocenter/zos/basics/topic/com.ibm.zos.zcourses/zcourses_ispfpdf_book .pdf ISPF Data Sets http://publib.boulder.ibm.com/infocenter/zos/basics/topic/com.ibm.zos.zcourses/zcourses_ispfdsbasics _book.pdf P a g e 7 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Requirement 1. Introduction to the Functions of File Systems A File System is a collection of operating system programs that control the manner in which files are named, are created (Allocated), stored (Saved), retrieved (Opened), and managed. Most operating system support one or more file systems. While most file systems are similar, the rules to use each file system varies. Each file system varies by degree of content flexibility, organization, storage efficient and performance. Previous mainframe file systems introduced in the 1950/1960s were designed during a time period when the cost of a single 30-megabyte disk drive (DASD) exceeded $18,000, and the internal disk management processor and data transfer rates were very slow. During this period there were no Word documents, sound and video files, or other modern stored content. The personal computer or desktop applications did not exist. The z File system was designed for storage and processing performance and offered almost no content flexibility. While we may prefer user-friendly, content flexible file system like Windows NTFSv5 or Linux ext-4, neither of these file systems are as storage or performance efficient as the IBM z File system for large-scale transaction processing. If you need more user-friendly, content flexible file system, then it is recommended to use the zUnix or Linux for z System operating systems or directly use a Windows or Linux server system. 1.1 Naming Files or Datasets 1.1.1 Naming files in the Windows NTFSv5 file system. A Window's file or folder may contain up to 255 characters, embedded spaces, and will retain the case of letters in a file name, but the use of upper and lower-case does not make the file or folder name unique. For example, PACKY.DOCX is the same file name as packy.docx. A fully-qualified NTFSv4 file has three major components. C:\LOCATION FOLDER\LOCATION FOLDER\FILE NAME. FILE EXTENSION C:\USERS\LAVERTY\MY DOCUMENTS\PACKY.DOCX If you do not specify the device or parent folders (the location of the file), Windows NTSFv5 assumes that the file will be stored or located in the current folder. Backward slashes are used to separate storage location information from the file name. A period is used to separate the file name for the File Extension (.DOCX) from the file name. The File Extension is used by the Windows file system to specify which application understands the content of the file. P a g e 8 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 1.1.2 Naming z System Data sets A Window file is similar to a z File System data set. A Data Set name cannot be longer than 44 characters, may not contain embedded spaces, the first character must be a letter, and can be letters, numbers, special characters (only #, @, or $), or a hyphen (-). All lower-case characters will be converted and stored as upper-case characters. The following is data set name, which will be used as an example in this tutorial. RMUI001.DATA.ACCOUNTS A z/FS data set name can contain have several SEGMENTS. Each segment is separated by a period. The first segment is the High-Level-Qualifier, or HLQ. Though the HLQ appears similar to your logon userid, it specifies your private user catalog name. The HLQ is somewhat similar to your My Documents folder in Windows, which is also used to find your data files. In this example, RMUI001 is the data set High-Level-Qualifier, or catalog name. The segments that appear to the right of HLQ are called Low-Level-Qualifiers (LLQ). It is recommended that the LLQ be descriptive of the content stored in the file. Can you access data set outside your HLQ or your Window's personal folder My Documents? As long has you have been authorized to access files or folders outside your personal folder or catalog, you may access anything. 1.2 What is a data set? A Data Set is z/OS's file system name for a file. Windows, UNIX and Linux (Mac OS) stores data and programs on a storage device as a file. IBM stores data and programs on a storage device as a data set. The Data Set List Utility will display your datasets in a similar manner that Windows Explorer will display your files. Windows describes a Word document as a file. On the other hand, z/OS would describe any document as a data set or data set member. In z/OS terminology one would edit or browse a data set. Windows would describe this process as opening a file. 1.3 Managing the Content of a File or Data set Windows files and z/OS data sets are simple storage containers that may store unstructured information (bytes) or structured information (records). The file system does not understand the details of the content of a file or data set. The applications, e.g., Word, a COBOL Program, etc. that stores the data or content in the file container will understand the structure of the content, not the operating system or file system. Records contain structured information such as the employee name, address, and phone number of an employee information file. Files and z/OS records may also contain unstructured information as a collection or bytes (characters); such as graphic, audio and video files. Most Windows file extensions are published on the Internet and are well-known. For example, the .DOCX file extension indicates that the Word application understands the content of the file; whereas, the .XLSX file extension indicates that the EXCEL application understands the content of the file. P a g e 9 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 1.4 Organizing Files or Data sets 1.4.1 Organizing by Physical Disks (DASDs) and Disk Volume Storage All file systems conceptually start with a physical disk and a disk volume. In older and large-scaled storage systems the physical storage unit was first method to store, organize and separate data by function. Every file system has structure that organizes files and improves the efficiency to find and locate files within and between physical storage devices. Most modern hard disk or solid state drives (DASD) may individual store billions of files and the files system may organize files across thousands of distributed hard drives. I can't remember which drawer I put (stored) my socks. Can you imagine the complexity of organizing files in today's modern file systems? 1.4.2 VTOC (Volume Table of Contents) Each physical disk may have more than one disk volume. The starting point of a file system is called a VTOC (Volume Table of Contents), or a Windows or Linux root directory. While VTOCs and root directories store information about data sets and files within its physical storage boundaries, this system may get very complicated when there are thousands of VTOCs or volumes. (To resolve this problem, IBM created the concept of a Catalog. A system or user catalog provides an alternative method to finding data sets that use the VTOC. This will be demonstrated and discussed later in this tutorial.) 1.4.3 Organizing by Files/Folders (Windows, UNIX or Linux Hierarchical File System) Windows, UNIX and Linux organize files by storing them in a file folder or directory. A file folder or directory is similar to the old-fashion card catalog of a library. The library card catalog contains the name of book and provides information concerning the location of the book in the library or located at other libraries. Today we simple use Google to find a location of the restaurant. Windows, UNIX, and Linux use a hierarchical file system. Within a hierarchical file system a file folder may contain a subfolder, and a subfolder will contain lower-level subfolders. 1.4.4 Organizing by Partitioned Data Sets (z System Flat File System) IBM's z/OS is a flat file system, and it is not hierarchical. The closet thing that z/OS has to a folder is a Partition Data Set (PDS) - to be discussed later. While a z/OS PDS organizes and contains members, a PDS dataset can only contain sequential members, but cannot contain another sub-PDS. Hierarchical files systems can organize files at multiple levels, but a flat file system can at best organize files (data sets) at one level. While a hierarchical file system can better organize a large number of files better, the performance to locate a file is slower than the z/OS. When z/OS needs to organize a large number of files one can use the z System UNIX System Services. The z/OS and UNIX files systems can be interchangeable depending on the storage objectives, e.g., performance versus organization. P a g e 10 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 1.5 Creating New Files, Folders or Data sets File systems specify rules for creating a file or data set. In Windows NTFSv5, a NEW file will be automatically created when you select SAVE for the first time. When created, a file must be uniquely named, a file type must be assigned, a stored location is selected, storage space is allocated to the file or data set container, and the data content is then stored in the file container, e.g., the content of a Word document is stored in a file of the type named .DOCX. In the z File System, you must first ALLOCATE (create) a data set BEFORE accessing or using the data set. In simpler terms, you cannot just SAVE a New file. The details of data set allocation will be presented later. The importance to separate the processing of creating and authorizing a new data set from using the data set when the cost of a single 30-megabyte disk drive (DASD) exceeded $18,000 may be somewhat obvious. If you were saving hundreds of video and sound files, would you pay an extra $18,000 to store these files? Aren't you glad to live in a time when Google and Dropbox will give you gigabytes of free storage for FREE! 1.6. File System Security Windows, Linux and UNIX file systems contain file security data stored in folders/subdirectories or the properties of file. The z/OS does not directly store security data within the file system. RACF, the z/OS security server, will store and process a dataset based on security data using the HLQ. More details later.) P a g e 11 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Requirement 2.0 ISPF Navigation between ISPF Menus or Panels ISPF will display a hierarchical set of customized, configurable display panels. In this tutorial we will navigate between the ISPF Primary Option Menu, the Utility Selection panel, the Data Set List Utility panel, and the DSLIST Panel. There are three concepts, which are important to understand. First, ISPF calls a menu display a “panel”. Second, the Option or Command line may be used to enter navigation commands to navigate between menu panels. Third, the Option or Command line may be used to enter ISPF Primary commands and command options. The Option = = => or Command = = => line unprotected area which is underlined. This means that you can type one of the menu options. By default the cursor will appear at the first character of the underline area. If the cursor does not appear in the underline area, use the arrow keys to move the cursor. DO NOT TYPE OUTSIDE THIS UNDERLINE AREA. This is called a protected field error. P a g e 12 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.1 ISPF Primary Option Menu panel To navigate between panels simply type the number of the panel. For example, by typing 3 and pressing the right-ctrl key one will navigate to the Utilities panel. On the other hand, if you type SD one would navigate to the System Display and Search Facility (SDSF) panel. There are two areas displayed in the following ISPF Primary Options Menu panel. The numbered options will be displayed in the upper area of the panel. These menu options displays navigation commands to ISPF panels 0, 1, 2, and forth which will navigate to a standard ISPF panel. The Other Install Products menu area will display one or 2 character short-cut commands which will navigate to more advanced utilities or subsystems, e.g., SD - SDSF, D2 - DB2, R - RACF, SM SMP/E. OE - OEDIT, etc. These utilities or subsystems will be covered in this tutorial. To review, these navigation identifiers are represented by one or two characters. While a student may be initially overwhelmed by the list of other Installed Products, these topics will be covered in other tutorial or courses. However, one should be impressed with millions of dollars of hardware, software and middleware that IBM have made available to students, faculty and universities. P a g e 13 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Let's try an ISPF example to navigate between panels. Type the number 3 on the Option command line and press the right-ctrl key to execute. 2.2 Utility Selection Panel After entering the navigation command 3 or selecting menu 3 (the Utility Selection Panel), several sub panels will be listed. These first four submenu selections are, 1 Library, 2 Data set, 3 Move/Copy, and 4 Dslist. To exit any ISPF panel or menu, press the F3 key 2.2.1 Documenting Utility Selection Panel Use a graphical snipping tool to document your Utility Selection Panel. P a g e 14 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM The options found in the Subpanels will provide functions which you will be familiar in Windows Explorer. Let's review Option 4 Dslist first. Type the navigation command 4 in the Option = = > line of the Utility Selection Panel and press the right-CTRL key to execute this navigation command. 2.3 Userids and High Level Qualifier (HLQ) Your UserID is used to logon, or authenticate to z/OS. For example you may have been assigned a userid similar to RMUI001. Your UserID HLQ is used to group data sets together in a user catalog. Think of a user catalog or HLQ as being a special folder or subdirectory that z/OS administrators use to organize data sets and apply security, no matter which disk volume these data sets are stored. One function of the Data Set List Utility menu is to display a list of data sets that belong to a particular UserID or user catalog (to be discussed later). The following example demonstrates a sample UserID of RMUI001. In Windows we would use Document or My Document folder to organize a user's files. In Linux, the userid would be used to create a personal subdirectory under the /home folder. One may enter a userid on the DSANAME level line to view all data sets that belong to them. If you accidentally enter the sample UserID or another student's UserID - a not authorized error message will be displayed by RACF, the IBM Security Server. Your unauthorized attempt to access another user's private catalog will be logged in the z/OS system log (SYSLOG) as a security breach. On the RMU server, we can also type RMU instead of yoru userid. The RMU catalog was created and secured as a public folder, where instructors can distribute or share data sets among other userids. P a g e 15 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.4 Windows 7 and Linux User Folders and z System User Catalogs Where does Windows 7 automatically store (by default) your personal files and provide automatic security to prevent other users from accessing your files? Most popular answer: C:\Users\MyName, where MyName is your Windows logon name. The C:\Users\MyName folder will also contain subfolders to organize your of Documents, Videos, Pictures, Music, and other customized folders that you have created. Windows also automatically creates a Public folder which all Windows users may share. On the other hand, Linux uses the subdirectory named /home/MyName to store the logon user's files and provides security to prevent other users from viewing these files. The following example displays a list of data sets stored in the RMUI001 catalog. These data sets will NOT appear in you type your userID or HLQ, e.g., RMUI001. If you have not initialized your data sets for this tutorial, your user catalog will not list many data sets or may be empty. The next set of directions will require you to submit a JOB to z/OS to set up your tutorial data sets. 2.5 DSLIST Panel The following is an example of DSLIST Panel, which will NOT appear the same as your DSLIST list. This is only an example! The DLIST (Dataset List) panel is a text-based utility that will display information similar to Windows Explorer. We are all comfortable with the concepts of Windows files and folders. The z/OS file system uses the term z/OS data sets to refer to a concept which is similar file or folder. Notice that all data sets names start with our userid. In this example, the useriD is RMUI001. Yours will be different. Later we will review the detailed concepts of a user catalog or folder presented in the z System Theory document. For now, let's review the DSLIST which will initially be displayed for this workshop. P a g e 16 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM If you notice all data sets displayed in the DSLIST panel for a user's catalog has a High Level Qualifier which matches their userid. In this example, all listed data set names have a HLQ of RMUI001 In summary your userid provides three functions • • • Your UserID is used to logon, or authenticate to z/OS. Your UserID is the name of a user catalog used to group data sets that belong to a user together. Your USERID is your user catalog name. Think of a user catalog as being a special folder or subdirectory that z/OS administrators use to organize data sets and apply security, no matter which disk volume these data sets are stored. Your UserID may also be used as a High Level Qualifier (HLQ), which specifies that a particular data set may be stored in a user's data set. P a g e 17 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.5.1 You have no data sets displayed. Assume that your UserID is RMU0303 and you have no data sets displayed. I have no data sets. What is the problem? The following directions will require you to submit a special program called a z/OS JOB. A z/OS JOB is a z/OS work request and is written in JCL (Job Control Language). As an analogy a z/OS job is similar to your boss, spouse or parent sending you an email message requesting you to perform some specific work request. In z/OS we don't send email, we will use the TSO SUBMIT command. 2.5.2 Questions – Userids, User Catalogs and HLQ 1. List three functions that a userid, e.g., RMU0303, may provide in z/OS. Answer: . 2. If your userid is RMU0303, what will be the name of user catalog? Answer: . 3. What is the function of a z/OS userid? Answer: . 4. What is the function of a HLQ in a z/OS data set name? Answer: . 4. What is the function of a LLQ in a z/OS data set name? Answer: . P a g e 18 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.6 Submit a JOB to z/OS Using ISPF to install your Tutorial Data Sets z/OS uses a JCL job to execute (run) and manage system and application programs. One may compare the process of submitting a JCL JOB to execute programs as similar to right-clicking on an icon to start executing a Window's application. In this example we will execute this prewritten JCL program to set up your data sets so that you may complete this tutorial. To execute the program we will use the SUBMIT command. (Sorry, there will be no mouse clicking to start programs in this tutorial.) The JCL instructions to setup your data sets for this hands-on tutorial is stored in RMU.PUBLIC.JCL(LAB). This JCL program will copy data sets from a public library (folder) into your personal user catalog. Your private user catalog name is based on your userID or HLQ segment, such as RMU001. You need to only execute this tutorial data set setup job once. If you incorrectly type the following command, there will be little evidence to help debug your typing error. So be careful to type in the following SUBMIT command carefully. Complete the following steps if you have no tutorial data sets. 2.6.1 Enter the TSO SUBMIT Command On the ISPF option (Option === > or Command == = >) line type the following and press the rightctrl key to execute . ➢ When one prefixes a command with the keyword TSO in ISPF, this means that the following command is executed by TSO, not ISPF. The prefix TSO means to temporarily shell to the TSO command prompt and execute the following SUBMIT command. It is important to notice that TSO is executing the command, not ISPF. Windows uses the CMD command to shell to the Windows command line interface. ➢ After the TSO command, type at least one space followed by the SUBMIT command. ➢ After following the SUBMIT command with at least one space, then type a single-quote followed by the data set or data set member name to be executed. This command line will end with a closing single-quote. The single quote character is located near the ENTER key on your PC keyboard). ➢ z/OS commands are not case-sensitive. However, these commands will require the correct spacing, a proper data set name or data set member name and punctuation. If you incorrectly type this command you will get an error code. Interpreting this error code requires a little more experience then presented now. Try to be careful when typing this command. P a g e 19 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.6.2 Press the right-ctrl key to execute the JCL JOB Double-check that you have correctly typed the single quotes and did not use double quotes. Now press the right-ctrl key to execute. For example: This example illustrates the execution of this TSO command at the ISPF Primary Option Menu panel. You may execute this job using any ISPF panel option or command line. 2.6.3 Press the RIGHT-CTRL key to Continue After seeing the three asterisks *** After seeing the three asterisks ***, TSO has completed executing your SUBMIT command. At this point we will not be able to determine if the JCL JOB was successful or if it failed. Every time you see the three asterisks, which means "more information to be displayed", press the right-ctrl key to continue. 2.6.4 MAXCC=0000 The display will clear and you will see a message similar to the following. Notice that the Job Entry System assigned a unique JOB number to identify your job, i.e., JOB02629. Each JES job is assigned a unique number. The name of the JOB is LAB. Most importantly the MAXCC=0000. MAXCC is the job error code. A value of 0000 means that the job executed successfully. If you encounter an error code other than 0000, this means you either incorrectly typed the previous command, or this command was executed twice. You should only execute the LAB job once. If you encounter a non-zero error return code, try correcting your typographical error. Details concerning this error code will be discussed later in the course. What does a MAXCC=0000 really mean? MAXCC is an acronym to describe the Maximum Error Condition. A MAXCC=0000 value means no JCL or application program syntax error, no z/OS system error or data set errors, or z/OS system problem. In a previous hands-on tutorial you will be required to compile and execute a rewritten COBOL program. If you were compiling a COBOL program a MAXCC=0000 does NOT mean that you didn't have any logic errors. To discover the details for errors and batch program output, one frequently has to use the System Display and Search Facility (SDSF). Later we will use SDSF. P a g e 20 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM For now, you expected to carefully type the TSO SUBMIT command correctly, hence there will be no errors. While the 'RMU.PUBLIC.JCL(LAB) job may have successfully executed, unlike Windows or a Mac OS, z/OS will NOT "automatically" display the copied new data sets. The next set of directions will restart the Dataset List Utility, but you can press the PAUSE key to refresh the display. 2.6.5 Questions - JCL and Submitting JCL Jobs 1. What is the purpose of z/OS JCL (Job Control Language)? Answer: . 2. What is a JCL Job? Answer: . 3. What is the purpose of using the z/OS SUBMIT command? Answer: . 4. After your SUBMIT a JCL job the MAXCC=0000 may be displayed. What is the function or information provided by the MAXCC value? Answer: . 5. Which Windows concept is similar to submitting a JCL Job? Answer: . P a g e 21 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.7 Quick Navigation to the Dataset List (DLIST) Panel =3.4 The DLIST (Dataset List) panel is a text-based utility that will display information similar to Windows Explorer. Assuming that you had previously successfully executed the tutorial data set setup job, return to the Data Set List Utility. In a previous demonstration, we navigated through several ISPF panels, one at a time. As you gain experience with ISPF, you will quickly know how to jump directly to the ISPF panel you want. On the Option or command line type =3.4 The leading equal sign (=) means to navigate directly to the designated panel, i.e., 3.4. If you would have omitted the leading equal sign (=) you would have seen an error message. In the ISPF Primary Option Menu panel, there is no 3.4 panel. There is a 3 panel, labeled Utilities, but no 3.4 panel. The =3.4 navigation command is a popular shortcut to the Dataset List Panel. Memorize it. Type =3.4 and press the right-ctrl key to continue. Do not enter the sample userID RMUI001. Type your userID. Press to right-ctrl key to open your user catalog to view your copied tutorial data sets. Opening a user catalog is similar to using Windows Explorer to view your C:\Users\MyName folder or for Linux to view your /home/MyName subdirectory. Your DSLIST panel (the DSLIST title is displayed in the upper right-hand corner) will open and the contents or your cataloged data sets will be displayed. P a g e 22 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 2.8 Questions and Documenting your DSLIST Panel 1. ISPF DSLIST, similar to Windows Explorer, displays data sets organized by z/OS user catalog or volume. Which ISPF short-cut, primary command (hint: the one prefixed with an equal sign) can be used to quickly navigate to DSLIST from any ISPF Panel or utility? Answer: 2. The ISPF Panels, Lists, or Editor are limited to display a line width of 80 characters at a time? Which ISPF function key may be used to scroll to the right, similar to Windows, to view more ISPF content? Answer: . Use a graphical snipping tool to document the view of your Data Sets below. You should see tutorial setup data sets. 2.9 Comparing DSLIST to Windows Explorer and the DIR command The previous requirement had simply displayed a list of data sets stored in your user catalog, similar to using Windows Explorer to display your folders and files in your My Documents Folder. The following is an example of using Windows Explorer to provide a list of Windows files and folders under my Documents folder. P a g e 23 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM P a g e 24 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM The following is an example of using the DIR line command to list files and folders under my Documents folder. You can access the Windows command line interface by entering CMD on the Run text box. The most important thing to remember is that what you can do with Windows Explorer, you can probably do with DSLIST. Can you open a data set to be edited in DSLIST like I can open a Word document in Windows Explorer? Yes. Can I start and run a load module (executable program) in DSLIST like I can click on an icon in Windows? Yes. The bottom line is that you can get any data set information or perform any file system task in DSLIST that you can perform in Windows Explorer. You can open, rename, delete, move or copy any data set. You just have to learn how to use DLIST. 2.10 Questions - ISPF Navigation 1. How does one navigate FROM the ISPF Primary Option Menu TO the Utility Selection Panel? Answer: . 2. If one types SD on the ISPF Primary Option Menu option line, e.g., Option = = = >, what will happen next? Answer: . 3. If one types SD on the ISPF Primary Option Menu option line, e.g., Option = = = >, and then press the right-ctrl key (3270 Enter key) what will happen? Answer: . P a g e 25 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Requirement 3.0 Using ISPF and the z/OS File System 3.1 ISPF Function Keys, Primary and Line Commands You can use ISPF command interfaces to perform a wide range of functions, such as navigating between panels, coping data sets, saving a data set, editing source code, etc., by using one of three methods: Function Keys, Primary and Line Commands. While these command interfaces may be more confusing than clicking on a Window's mouse, it is important to remember that both ISPF and Windows often perform the similar functions. The command interface may be different, not the command. 3.1.1 ISPF Function Keys ISPF Function Keys are the most easiest to use and understand. ISPF function keys will normally be displayed at the bottom of your ISPF panel, similar to the following. A Function Key command automatically executes without pressing the right-ctrl key. Many Function Key commands will be introduced in this tutorial. Function Key(s) F1=Help F3=Exit F12=Cancel F7=UP F8=DOWN F10=Left F11=Right Description Pressing F1 in the DSLIST panel, it will display context-sensitive help and assistance for only the DSLIST panel. Windows also context-sensitive help when you press F1. Linux provides text-based help using man pages. However, z/OS, Windows and Linux "Help" provides little detailed information to teach you to use a command. You may find better tutorial and help assistance by searching Google or YouTube. Pressing F3 will exit an ISPF panel and will return to the previously visited ISPF panel, like revisiting a previously visited web page. If you are editing a data set, program source or JCL code, pressing F3 will automatically save your edit changes or work. If you DO NOT want to automatically save your work, Press F12=Cancel or enter the ISPF Primary command CANCEL. Similar to Windows, ISPF will display information that must be displayed on multiple displays or panels. By default, ISPF can only display 24 lines per panel. Pressing F7 is similar to Windows scrolling toward the beginning of a document. The ISPF Primary command TOP will automatically move to the beginning of an ISPF panel or data set. Similar to Windows, ISPF will display information that must be displayed on multiple displays or panels. By default, ISPF can only display 24 lines per panel. Pressing F7 is similar to Windows scrolling toward the end of a document. The ISPF Primary command BOTTOM will automatically move to the end of an ISPF panel or data set. Similar to Windows, ISPF will display information that cannot be displayed within the width of the screen. By default, ISPF can only display 80 characters per line. ISPF cannot change font size. Pressing F10 is similar to Windows scrolling toward the left of a document, e.g., column 1. Similar to Windows, ISPF will display information that cannot be displayed within the width of the screen. By default, ISPF can only display 80 characters per line. ISPF cannot change font size. Pressing F11 is similar to Windows scrolling toward the right of a document, e.g., beyond column 72. P a g e 26 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.1.2 Questions - ISPF Function Keys 1. Describe the differences between using the ISPF F3 key and the ISPF F12 key. Answer: . 2. How does one find context-sensitive help when using ISPF? Answer: . 3. If you cannot understand the provided ISPF Help directions or ISPF or TSO error messages, what may be recommended alternatives to get more user-friendly z System information? Answer: . 4. The ISPF Panels, Lists, or Editor are limited to display 24 text lines at a time. Which ISPF function key may be used to scroll down, similar to Windows, to view more ISPF content? Answer: . P a g e 27 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.1.3 ISPF Primary Commands ISPF Commands must be typed on the Command or Option prompt. These primary command lines may be located at either the bottom (by default) or top of the ISPF panel. You may choose to change the position of this the Primary command line using the Setup option presented in the Logon Tutorial. After typing an ISPF Primary Command you must press the right-ctrl key to execute the Primary command. If you incorrectly type an ISPF primary command an ISPF or TSO error message will appear in the upper right-hand corner of the panel. A few ISPF Primary Commands will introduced in this tutorial. You may learn more about ISPF Primary commands by pressing F1 which will list ISPF Primary Command assistance. 3.1.4 Questions - ISPF Primary Commands 1. Where does one enter on the ISPF panel and execute an ISPF primary command? Answer: . 2. Which ISPF primary command is useful to find large data sets? Answer: . 3. Which ISPF primary command will hide ISPF messages and warnings when using the ISPF editor? Answer: 3.1.3 ISPF Line Commands ISPF Line Commands must be started under the Command Column. ISPF line commands are normally used for a single data set or in special cases a block (range) of data sets. The following example will demonstrate the "I" line command to display detailed data set information for the RMUI001.CICS.BMS. You will be required to use the "I" line command in a later requirement of this tutorial. P a g e 28 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM After typing the "I" command on the selected data set line, must press the right-ctrl key to execute the line command. If you incorrectly type an ISPF line command an ISPF or TSO error message will appear in the upper right-hand corner of the panel. A few ISPF Line Commands will introduced in this tutorial. ISPF Edit Line commands are very powerful and will be introduced in a later tutorial. You may learn more about ISPF Line commands by pressing F1 which will list ISPF Line Command assistance. 3.1.4 Problems using ISPF Line Commands 1. You cannot type an ISPF Line command under the Command column while in the ISPF INSERT mode, e.g., pressing the Insert Key. While using the ISPF INSERT mode the cursor will appear as a block rather than an underline character. 2. Most ISPF Line commands will affect only one data set or one edit line. In those situations where you either enter a Primary command and a Line command or enter two or more conflicting Line commands, an error message may be displayed in the upper-right corner of your ISPF panel AFTER you press the right-ctrl key to execute. To continue, you must erase the Primary or Line command(s) which may be causing the problem, BEFORE pressing the right-ctrl key again. It is recommended not to use Primary and Line commands simultaneously or to execute more than one Line command at a time. P a g e 29 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.2 Introduction to z System Volumes, VTOCs and Catalogs 3.2.1 z System Volumes and VTOCs All file systems conceptually starts with a physical disk and a volume. After a physical disk has been identified to the computer hardware and operating system a volume or a partition must be created. In order to store data sets a z/OS disk volume and a file system must be created using the ICKDSF utility. All operating systems support various utility programs that may be used to create a disk volume. Windows uses the FDISK utility or Disk Management. Linux uses either the fdisk or lvm utilities. During the process of creating a file system volume, a root directory is also created. While the technical details of the structure of the z/OS, Windows, UNIX and Linux root directory may vary, there is always a structure that represents the starting point of the file system. The starting point of a z/OS file system is called a VTOC (Volume Table of Contents). A z/OS VTOC is similar to a Windows or Linux root directory. A VTOC stores a list of data sets or files stored on the physical volume and the starting storage location of the data sets on the disk, e.g., cylinder and track. A VTOC simply finds the locations where datasets are stored in a volume. A VTOC may contain pointers to storage locations of datasets owned by multiple different userIDs or subsystems. While VTOCs and root directories store information about data sets and files within its physical storage boundaries, this system get very complicated when there are thousands of VTOCs or volumes. To resolve this problem, IBM created the concept of a Catalog. A system or user catalog provides an alternative method to finding data sets that use the VTOC. A user catalog permits one to organize and find datasets across data sets. Windows, UNIX and Linux use subdirectories to organize and access files. Subdirectories are primarily designed to organize files by storage device and volume location. User catalogs are primarily designed to organized data sets by other criteria besides storage location. User Catalogs can provide a hierarchical system similar to subdirectories, but are easier to search. Searching across multiple Windows, UNIX and LINUX subdirectories will rely of the PATH command. Most z/OS file systems will automatically catalog data sets to organize, apply RACF security policies, and provide easier access to user catalog data sets. While one may believe that using a catalog should be the rule, rather than the exception, the use of a catalog will increase the overhead and storage requirements of a file system, when data sets are frequently allocated or quickly deleted, e.g., compile programs and temporary files. Hence, the z/OS file system provides a choice to balance the advantages and disadvantages of cataloged data sets, i.e., cataloged or un-cataloged. The Windows, Linux and Unix PATH statement does not provide a choice for individual data sets. In the previous graphic notice of the column labeled Volume. A z/OS volume is a subdivision of space on a Direct Access Storage Device (DASD), or a physical disk. The amount of physical storage space P a g e 30 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM is frequently measured in cylinders which may or may not be spread over multiple DASDs (disk drives). All z/OS data sets are physically stored in a DASD (disk) volume. The maximum storage space allocated to a DASD volume is limited and cannot be dynamically increased. 3.2.2 z System User Catalogs A User Catalog, e.g., RMUI001, is logical structure which makes it easier to organize, group, and secure data sets stored across one or more DASD (disk) volumes. A User Catalog has NOTHING to do where data sets are physically stored or which or which volumes your data sets are stored. Consider an analogy. Assume that you live in a one physical house, which will represent a physical disk (DASD). The house contains multiple rooms (volumes) labeled ROOM 1, ROOM 2 and ROOM 3. Further assume that you have three video game cartridges (which represents data sets). You place one cartridge in each ROOM, i.e., one video game cartridge for ROOM 1, ROOM 2, and ROOM 3. If your enter ROOM 1, you would expect to find only one game cartridge since the other cartridges are placed (or stored) in a different physical room. This makes sense. But, you could create a “location list” for your game cartridges to make it easier to find your video game cartridges. You may even be able to find that game cartridge that you loaned to a friend, who never return. (Thank goodness for online gaming.) Notice that the displayed cataloged data sets listed below are physically stored across multiple volumes, e.g., VPWRKZ, VPWRKA, VPWRKB, VPWRKC, VPWRKT, etc. This is similar to the analogy of storing game cartridges across multiple rooms. A benefit of user catalogs is to organize data sets. In this example, all cataloged data sets are displayed no matter which volume they are stored. For a Fortune 500 company these cataloged data sets could be physically stored on a DASD devices and volumes located across the world. If your Data set list is too long, you may press F8 Down to continue to the next page, or press F7 to continue to the previous page. (Actually the scroll value will determine whether your will scroll by a page, half page or other increment.) P a g e 31 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM A DASD volume may be used to organize, group, and secure data sets stored within ONE volume. A volume label will normally be descriptive of the contents of the data sets stored in the volume. For example, a volume named INVAPP may store inventory applications. The maximum storage space allocated to a DASD volume is limited and cannot be easily increased. For example, once your bedroom cloth’s closet is full you have to add a second cloth’s closet. Likewise, additional volumes may be required to store more additional applications or data. When comparing z/OS volumes to Windows, a Windows disk volume may be assigned a volume name or label, but also may be assigned a drive letter, e.g., U: drive. 3.2.3 Comparing z/OS VTOC with Windows Root Directories Compare the differences between previous z/OS VTOC information and the following Windows NTFS file system information in the following graphic Since Windows NTFS is a byte-oriented file system, the unit of storage is listed in units of bytes, as compared to previous z/OS VTOC listing using storage units of tracks and records. Since Windows NTFS automatically allocates directory and data storage, there is no need separate directory and storage space as compared to a z/OS VTOC. P a g e 32 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM P a g e 33 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.2.4 Questions - File Systems, Data sets, Volumes and Catalogs 4. What are the functions a File System? Answer: . 5. List several file system functions which are common to z/OS, Window's NTFS and Linux file systems. Answer: 6. A Windows or Linux file is most similar to which z System file system concept? Answer: . 7. Windows (file) Explorer is most similar to which ISPF panel? Answer: . 8. A popular Windows storage device is a hard disk drive. Disk storage devices are often classified by the electronic method that they use to store data, e.g., magnetic or solid state. Which acronym is used describe a z/OS hard disk storage device? Answer: . 9. Describe the functions of a z/OS Volume. Answer: . 10. Describe the functions of a z/OS User Catalog. Answer: . 11. Describe the differences between a z/OS User Catalog and a z/OS Volume. Answer: P a g e 34 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM . 12. Which Windows or Linux concepts are similar to a z/OS User Catalog? Answer: . 13. What is the function of the z/OS Volume Table Contents (VTOC)? Answer: 14. Which Windows or Linux file concept is more similar to the z/OS Volume Table Contents (VTOC)? Answer: P a g e 35 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.3 Document Data Set Size You may have noticed that the previous Windows Explorer example displayed file size and file types. To display the amount of space used by your data sets using Dslist press the F11 key to scroll your display to the right. The F10 key will move the ISPF display to the left. The following information concerning that number of tracks, percentage of space displayed, and the number of extents used will be displayed. While Windows and Linux will display the file size, z/OS allocates disk space by tracks and cylinders. P a g e 36 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Use a graphical snipping tool to document the storage space allocated (used) by your data sets below. It is required to see your HLQ (userID) displayed. P a g e 37 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.3 z/OS Data Set Organization (or File Type) To display the data set type using DSLIST press the F11 key until you see something similar to the following. You will see the following extra columns displayed in the DSLIST view. This requirement introduces the concept of data set organization, or more commonly referred as DSORG. 3.3.1 Sequential, Partitioned or Partitioned-Extended Data Set Organization A data set is a container. The manner in which z/OS structures the internal content of the data set is called the data set organization. JCL uses the attribute DSORG to specify the data set organization. There are two popular types of z/OS data set organizations: Sequential Data Sets (PS organization), Partitioned Data Set (PO organization), or Partitioned Data Set –Extended (PO-E organization). ➢ A sequential data set is a collection of records written and read in sequential order from beginning to end. Records contain structured information such as the employee name, address, and phone number of an employee information file. Files and File systems specify rules for creating a file or data set. z/OS’s sequential data sets will be displayed with a label of PS (physical sequential) under the DSORG column. ➢ A Partitioned Data Set (PO organization) contains a directory structure and sequential members. In a Windows or Linux file System, one generally organizes files by using folders of directories. The z File System organizes related members (comparable to a file) together in a partition data set. From an organizational point of view a Windows folder is similar to a Partitioned dataset (PDS), except a PDS cannot contain a subfolder or PDS. Folders contain many related files. A PDS contains many related members. z/OS partition data sets will be displayed with a label of PO (partitioned organization) under the DSORG column. ➢ A Partitioned Data Set – Extended (PO-E organization) is a modern version of the older partitioned dataset organization. To avoid confusion, the PO-E organization is also called a LIBRARY. While both PO and PO-E organizations are both similar to Windows and Linux subdirectories or folders, the older PO organization requires extra maintenance. For example, when one deleted a member in older partitioned data set organization the freed space could not be reclaimed or re-used. Hence, Partitioned Data Set – Extended (PO-E organization) is P a g e 38 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM much more popular. A z/OS partition data set – extended will be displayed with a label of POE under the DSORG column. 3.3.2 DSORG is conceptually similar to a Window’s file type. When using the Window’s file system NTFSv5 a file will be automatically created, assigned a file name and file type when you SAVE it for the first time. During this initial “Saving” process a storage location in a volume and folder is selected. Storage space must first be allocated (reserved) for the file container, then the data content is stored in the file container. For example, when a Word document is stored as a file type and extension of .DOCX, which will use sequential organization and the rules to store the internal structure of a Word document. Comparing the concept of a Word document type to z/OS, a DOCX file would be similar to the z/OS concept of Data Set Organization. P a g e 39 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.4 How does a Partitioned Data Set Work? How does the PDS then keep track of its members? A Partitioned Dataset (PDS) includes a directory structure similar to Windows and Linux. The members of a PDS can be scattered anywhere in the storage space. z/OS can consult the PDS directory information to find the names and location of the members stored in the partitioned data set. Similar to a book index, the index contains a list of keywords you are looking for and the page no. where the keywords may be found. Thus, the directory maintains the list of member names and storage pointers to the actual physical allocation a stored PDS member. To review, a PDS is similar to a Windows or Linux subdirectory/subfolder, and a member is similar to a file store in the subdirectory/subfolder. 3.5 Questions and Document Dataset Organization (DSORG) Use a graphical snipping tool to document the Dataset Organization of your cataloged Data sets below. It is required that your HLQ is displayed. P a g e 40 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 1. What is function of z System Dataset Organization (DSORG)? Answer: . 2. List the three major types of z System Dataset Organizations. Answer: 3. Which Windows or Linux file system concept is similar to the concept of z/OS Data set Organization (DSORG)? Answer: . 4. Explain the structure and practical use of a sequential dataset. Answer: . 5. Explain the structure of a z/OS partitioned data set. Answer: . 6. Explain the main advantage of using a z/OS partitioned data set. Answer: . 7. What is the purpose of a z/OS partitioned data set MEMBER? Answer: 8. Which Windows or Linux file system concept is similar to concept of a z/OS partitioned data set? Answer: P a g e 41 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 9. List the advantages of z/OS Partitioned Dataset – Extended (PO-E or Library) Organization as compared to the older Partitioned Dataset (PO) Organization. Answer: P a g e 42 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.6 Document Date Created (allocated) and Last Accessed (Referred) To display the data created, date last referred, and other information concerning your catalog dataset file press the F11 key (scroll to the right) until you see the column named “Created” and “Referred.” Use a graphical snipping tool to document the Date Created, Referred and other information (properties) of your data sets below. It is required that your HLQ is displayed. P a g e 43 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.7 Comparing Window’s File and Folder Properties to z/OS All operating systems and file systems provide commands or utilities to view the characteristics or properties of a data set or file. A data set simply contains bytes or records. For example, a Word document contains a collection of bytes stored in a sequential file using the content structure rules of Word document. The user determines the content of a file or data set. On the other hand the operating system maintains information about the internal structure of a file's content, its size, its storage location, its creator, date last accessed, and so forth. (A special note: The internal structure of a Word document since version 2007 uses a XML encoding scheme.) Before continuing, use Windows Explorer to display the file properties for any of your Word Documents. Right-click on the Word Document and select Properties. Then select Details. Notice the Location: of this file specifies the drive letter C: (a vlume Use the snipping tool to document the properties and details a Word document stored in your Windows operating system or other operating system specified by your instructor below. P a g e 44 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.8 Data Sets Listed by User Catalog In a previous section and requirement, you list your data sets by HLQ or catalog. The following was a example of the data set listed by the UserID (HLQ) or catalog named RMUI001. You were previously required to use your UserID to list the data sets. Review the following and notice that your catalog listed data sets stored many different volumes, e.g., VPWRKZ, VPWRKA, VPWRKB, or VPWRKC. Enter =3.4 on the Command or Option Line to navigate to the Data Set Utility Panel. The result should appear similar to the following. ISPF always remember the last values that you entered in a panel no matter how you navigated through the file system or logoff. P a g e 45 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.9 Document Data Sets Listed by Volume Now erase the Dsname Level entry and type VPWRKC in the Volume Serial (or Volume Name) entry and press right-ctrl to execute. Only the datasets stored on Volume VPWRKC will be displayed. When a faculty member UserID executes this option, all data sets stored on Volume VPWRKC will be displayed no matter who owns or which user catalog contains the data sets. When a student userID executes the "Dsname Levell" using a student's userID, they will only view their personal data sets or the datasets stored in the user catalog. When displaying data sets by volume, your data sets may be different from the following example. Use a graphical snipping tool to document to display ALL datasets stored on VPWRKA below. Do NOT use the VPWRKC volume specified in the previous example. P a g e 46 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 3.10 Document Data Sets Listed by Sorted Order - ISPF SORT Assume that you want to display the datasets order by size so that you can determine which data sets are taking up more storage space than others. This a popular z/OS administrative task to perform when you are running out of volume space and you may want to know which datasets may be better candidates for deletion. On the Command = = > line, enter the Primary command SORT SIZE and press the right-ctrl to execute. The SORT command may take a little time to execute. View the TSO clock at the bottom lefthand corner of the panel. The appearance of the TSO clock means that z/OS is busy performing your requested command. When the soring process has been completed press F3 Do not press F3 too soon since you may exit from the panel before you the sorted results are displayed. If necessary press F11 key - Right to scroll to the right to display the size information. Beside the SIZE parameter, the ISPF SORT command can sort by any DSLIST column. Review the sample list of SORT options that may be used as SORT Parameters listed in the right table above. Windows Explorer may easily sort folders and data file list by simply clicking on the appropriate header. The Windows and Linux sort command line is similar to the ISPF SORT utility, since the folders and data files list must be piped to the sort command. P a g e 47 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Use a graphical snipping tool to document ALL data sets stored on VPWRKC sorted by Date Created (use the CREATE key word) below. Do NOT sort these data sets by SIZE. 3.11 Document Information stored in the VTOC (Volume Table of Contents) ISPF provides a summary report of information stored in the VTOC of a given volume. On the Option = = > line type V to Display the VTOC information. Then specify the volume serial (volume name) to be displayed. Enter right-ctrl to execute the command option. Review the following example. A display similar to the following will be displayed. Notice that the first two columns displays the Volume Data statistics and the second column display the VTOC Data statistics. In a previous discussion of partitioned data sets, the analogy of a library was used; i.e., books and the card catalog. The card catalog provides information concerning the location to find library books. Applying this analogy to the VTOC, a library card catalog is also conceptually similar to the function of the z/OS VTOC. The actual books represent the data to be stored. In the following example, the volume data storage is 69% full, and the VTOC data storage (directory storage) is 28% full. If either the Volume Data or VTOC table was 100% used, no one would be able to store any more data sets. A volume full error message will be displayed in the upper-right corner of ISPF. MOST Z/OS ERRORS ARE DISPLAYED IN THE UPPER-RIGHT CORNER OF ISPF. When a Volume is created (allocated) the initial physical amount of the volume data and VTOC data storage space will be specified. Allocating too much storage to VTOC data may result in less storage P a g e 48 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM space being available to volume data, e.g. your data sets. On the other hand, if the business requirement was to store many small data sets, the system may exhaust it VTOC (or card catalog) space to locate additional data sets (or books). The system programmer must balance both objectives. While most modern operating systems will automatically adjust physical directory and data storage space, the z/OS file system was designed almost three decades previously to these other operating systems. Before the mid-1990s, disk storage space was very expensive. Someone in an organization had be responsible for high cost. Over the last decade, the cost of disk storage has fallen dramatically and we now even have free cloud storage. But, the performance of file system automatic allocation and cloud storage is NOT acceptable for many large-scale transaction processing requirements. Use a graphical snipping tool to document VTOC Information option for Volume VPWRKZ. Which volume, i.e., VPWRKC or VPWRKZ, has more free space available to store your data sets? Your answer is P a g e 49 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Requirement 4.0 Comparing ISPF Utilities to Windows Explorer Utilties. 4.1 Utility Selection Panel Now type =3 on the Option = = > line to navigate directly to the Utility Selection Panel that we reviewed earlier. There are two ways to navigate through ISPF and the maze of panels. Type the panel number of name and use the F3 to return and exit, or use the = equal ISPF operator. The equal operator means go directly to that panel, i.e., ISPF panel number 3. Enter right-ctrl to execute the command option. The = operator may be used to directly navigate from any panel in ISPF. You may not be using the Data Set Utility panel at this point, but the =3 will work anywhere in ISPF. The Utility Selection (Number 3) Panel will most likely be our most frequently used ISPF panel. This panel is displayed next. We have previously introduced the DSLIST option, but let's summarize the following options and compare these options to how one uses Windows Explorer. P a g e 50 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Utility option Functions 6 Command Permits one to execute a TSO line command without exiting ISPF 4 DSLIST Displays data sets similar to Windows Explorer detailed list view. ISPF DSLIST can be used to edit, rename, delete data set lists and open and execute JCL to start programs. 3 Move/ Copy Move or copy data sets or data set members. ISPF does not support the drag-and drop features. This option requires one to know the data set name, whereas the DSLIST can look it up. 2 Data Set Can rename, delete, catalog or uncatalog a dataset. May be used to allocate or create a new sequential or partitioned data set. Similar to Windows In order to execute a Window line command, one would use cmd command. A library is another name of a partitioned data set – extended (POE). A PDS is similar to a Windows folder or directory. To create, rename, or delete a PDS one must first use option 2 - data set. 1 Library A Windows folder or directory contains files. A PDS contains members, which is similar to a file in a directory. But, all members must have the same record length. Libraries may be used to organize program or JCL source code, or executable programs (load modules). This option with create PDS members, not partitioned data sets P a g e 51 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 4.2 Questions - Comparing Windows and ISPF 1. In Windows one create a new folder or subdirectory by using the line command MKDIR or click on the New Folder Button. Which ISPF Utility Selection Panel may be used to create a new folder or partitioned data set? Answer: 2. Which ISPF Utility Selection Panel option may be used to create a new data set member inside a partitioned data set? Answer: 3. Which ISPF Utility Selection Panel option may be to execute TSO commands similar to the Windows cmd command? Answer: 4. Which ISPF Utility Selection Panel option may be used to copy data sets similar to a Windows copy-and-paste command? Answer: 5. Which ISPF Utility Selection Panel option may be used to delete a sequential or partitioned data similar to a Windows delete file command? Answer: 6. Which ISPF Utility Selection Panel option may be used to delete or rename a partitioned data member? Answer: P a g e 52 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Requirement 5.0 ISPF MOVE/COPY, DATASET and LIBRARY Utility Panels 5.1 Document the Move/Copy Utility Panel Navigate to Option 3 – Move/Copy Utility Panel. ▪ Move or copy data sets or data set members. ▪ ISPF does not support the drag-and drop features. This option requires one to manually enter the data set name, whereas the DSLIST panel displays the names of data sets and can be more easily moved or copied Use a graphical snipping tool to document the Move/Copy Utility below. Return to the previous panel by pressing F3 when finished. For now, let's just navigate to get a preview of the panel. But to use this panel one must use the command option "M" to move a data set or member (similar to Window's cut-and-paste) or "C" to copy a data set or member (similar to Window's copy-and paste). Then you must complete the FROM location and the TO location parameters before pressing the right-ctrl key parameter. Other ISPF utility panels will require one to enter command options and parameters. For example, you can enter the letter "D" to delete a dataset or member, "R" to rename a dataset or member, or an "A" to allocate a data set. . P a g e 53 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 5.2 Document the Data Set Utility Panel Navigate to Option 2 – Data Set Utility Panel ▪ Can rename, delete, catalog or un-catalog a dataset. ▪ May be used to allocate or create a data set. (Allocating a data set will be presented next.) Use a graphical snipping tool to document the Data Set Utility Panel below. Return to the previous panel by pressing F3 when finished. 5.3 Document Library Utility Panel Navigate to Option 1 – Library Utility Panel ▪ A library is another name of a partitioned data set – extended (PO-E). A PDS is similar to a Windows folder or directory. To create, rename, or delete a PDS one must first use option 2 data set. ▪ A Windows folder or directory contains files. A PDS contains members, which is similar to the concept of a Windows a file stored in a directory. All members must have the same record length. ▪ Libraries may be used to organize program (RMUXXXX.COBOL) source code or JCL source code (RMUXXXX.JCL), or executable programs or load modules (RMUXXXX.LOAD). Use a graphical snipping tool to document the Library Utility Panel below. Return to the previous panel by pressing F3 when finished. P a g e 54 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 5.4 Allocate a Data Set – What does this mean? To allocate a file will be new to those of us who are familiar with Windows, Mac OS, or Linux. But, concept of allocating space to files and data set allocation is NOT new to ALL file systems. Let's use the following analogy. Assume that you want to store your class notes and texts for some point to be re-used in the future. First, you would find a box big enough to store your notes and texts. This "big enough box" concept illustrates the process or reserving or allocating storage space for data sets. Then secondly you would place (save) your notes and texts (data) into this selected box. In summary, find and reserve a box for storage, then save the content into the box. When you will initially save a Word document in Windows, Windows automatically allocates a default storage box for you to save the electronic contents of your document. Modern operating systems rarely require one to allocate the storage area before you actually save the content. When the z/OS file system was introduced in the 1950s: 1. Disk space was very expensive, 2. The amount of disk storage space had to be charged to someone (just like you must pay data transmission and storage on your cell phone each month), and 3. Data storage must be secured from those not authorized to allocate disk space. To allocate a z/OS data set one is required to: 1. 2. 3. 4. 5. Be appropriately authorized, Specify the department who is responsible for the cost, Request and plan the amount of storage required for initial storage, Specify how disk space allocation will be increased in units called extents), and Limit the maximum of data storage that you are willing to pay for a data set. As a point of interest, notice how cell phone companies will permit you to exceed your limits and charge you either penalty costs or scares you into purchasing excess capacity. In z/OS you pay in advance. When a data set is initially allocated you specify the size and number of extents a data set can use. A data set extent is the customized size of storage space that a data set may grow. If the size for the size of an extent is two (2) tracks, and the maximum number of extents that is permitted is five (5), then the maximum size of the data set is limited or 10 extents (or tracks), or 5 times 2. Assume you initially save a Word document, then added more content, and then re-saved the document. How does Windows NTFS allocate extra file space? When you need extra storage space Windows permits the file to grow up to the limit of volume size or a user quota. In the Windows file system, there is nothing to stop a user from saving a Word document that uses up all of the space of a given volume and thus denying others from saving any more files without using quotas. When data sets are allocated, a system programmer will plan to ensure that space limitations of a volume will not be exceeded. But, on our system we do have a slight problem. In future tutorials the instructor will recommend certain properties to allocate a data set. But, sometimes students and instructors will make an error and the volume data is 100% used. In the real world this would never happen in z/OS since space allocation is closely monitored and charged. But, this is an academic class, and there will be occasional allocation errors in which students cannot allocate any additional P a g e 55 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM data sets. Contact you instructor if this occurs. Later you will be provided the procedure to select a different volume which has free space to allocate your data sets. 5.5 Questions - Data Set Allocation 1. What does mean to allocate a z/OS data set? Answer: 2. How does Windows create or allocate a new dataset? Answer: Requirement 6.0 More Uses of the DSLIST Utility Panel 6.1 DSLIST Utility Panel - Getting Detailed Information about a Dataset or Member Enter =3.4 on the Command or Option Line to navigate to the Data Set Utility Panel. Make sure that your user catalog name (userid) is display in the Dsname Level and then press the right-ctrl key to execute. Your result should appear similar to the following. ISPF always remembers the last values that you had previously entered in a panel no matter how you have navigated through the file system or logoff. Press the right-ctrl key (a second time) to display your data sets listed in your user catalog. P a g e 56 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.1.1 Document Detailed Information for the XXXXXX.COBOL data set DSLIST I Command Look at the upper left-hand corner of the ISPF. It will display something similar to DSLIST- Data Sets Matching XXXXX where XXXXXX will be your userID, or more precisely your personal user catalog. The Top Line of any ISPF Panel is very important for the following reasons. ➢ ISPF Top Line left-hand corner will specify which ISPF utility or function to currently being used. In this example DSLIST is displayed. In other examples, this upper left-corner may display EDIT, when you are using ISPF data set or member editor. The ISPF editor is similar to Notepad. If the upper left-hand corner displays DSLIST, then this is a display of data sets comparable to Windows Explorer. ➢ ISPF Top Line middle area may display the Title of the current ISPF Panel or the Name of a Data set. In this example, no title or data set name is being displayed. ➢ ISPF Top Line right-hand corner will display confirmation messages that an operation was completed or error messages will be displayed. In this example, no message is being displayed. To display detailed information for the XXXXXX.COBOL data set, type an "I" (Information) line command under the COMMAND column on the same line of data set in the DSLIST panel you wish to display detailed data set information. The Data Set Information panel will be displayed similar to the following. Notice that Data set organization for RMUXXXXX.COBOL data set is PO (partitioned data set). The descriptive word COBOL is this data set name implies that this a PDS may contain multiple COBOL source code members, similar to a folder contains multiple files. The record length is 80 characters P a g e 57 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM will be the length used to store ALL COBOL programs. When the Data set name type is LIBRARY, the newer partitioned data set - extended structure is being used. When the Data set name type is blank, the older partitioned data set is being used. Now you try it. Use a graphical snipping tool to document Detailed Information about your XXXXXX.COBOL data set (where XXXXXX is userID) below. Press the F3 key to exit the Data Set Information Panel. After exiting the DSLIST panel will display an "Info – I" message indicating the last operation perform. 6.1.2 Document Detailed Information for the XXXXXX.DATA.ACCOUNTS data set. To display detailed information for the XXXXXX.DATA.ACCOUNTS data set, type an "I" (Information) line command under the COMMAND column on the same line of data set in the DSLIST panel you wish to display detailed dataset information, e.g., RMUXXXX.DATA.ACCOUNTS. The Data Set Information panel will be displayed similar to the following. P a g e 58 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM Notice that Data set organization of the RMUI001.DATA.ACCOUNTS dataset is PS (physical sequential data set). Physical sequential data sets are frequently used to store data to be processed by batch processing applications. Normally, batch input data is NOT stored in a partitioned data set since each sequential data set may vary by record length and content. The data set name, i.e., DATA.ACCOUNTS, seems to imply that the input data may store customer account information. It is logical to assume that a different sequential input dataset used to store either inventory or employee information may not have 170 characters record length. The actual record length will vary by the type of information stored in the data set. The content details of the customer account information will be reviewed later this tutorial. Now you try it. Use the snipping tool to document Detailed Information about your XXXXXX.DATA.ACCOUNTS data set below. Press the F3 key to exit the Data Set Information Panel. 6.2 DSLIST Utility Panel - Browsing a Data Set or PDS Member Enter =3.4 on the Command or Option Line to navigate to the Data Set Utility Panel. Make sure that your user catalog name (userid) is displayed in the Dsname Level and then press the right-ctrl key to execute. 6.2.1 Browsing the XXXXXX.COBOL partitioned data set A previous example provided information that XXXXXX.COBOL data set was organized as a partitioned data set similar to a Windows folder. To open a Window's folder we click on the folder icon to view the folder's content. There are two line commands that can be similarly use to open a partitioned data set: "B" to browse (do not change) or "E" to edit the partitioned data set. In this example, we will open the XXXXX.COBOL partitioned data set in the Browse Mode. Type a "B" (Browse) command under the COMMAND column on the same line of the data set in the DSLIST panel you wish to browse. Press the right-ctrl key to execute. P a g e 59 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.2.2 Browsing the XXXXXX.COBOL partitioned data set member named CBL0001 After the XXXXX.COBOL partitioned data set has been opened in the Browse Mode a list of PDS members will be displayed similar to the following. Type a "B" (Browse) line command under the COMMAND column on the same line of data set member in the DSLIST panel you wish to browse. In this case Browse the COBOL program named CBL0001. Press the right-ctrl key to execute. After the XXXXX.COBOL(CBL0001) data set member has been opened, we can view the contents of the COBOL program syntax, but we cannot edit the program. P a g e 60 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM In this example case, the full name of the dataset and member name of the COBOL source code is RMUI001.COBOL (CBL0001). The format of a data set member name is: DATA SET NAME (MEMBER NAME) The name inside the parenthesis is the member name. The name outside the parenthesis is the data set name. Therefore the PDS data set name (folder name) is RMUI001.COBOL and the PDS member name is CBL0001. Important Rule of thumb! If you see a set or parentheses in a data set name you are most likely dealing with a partitioned data set member. A set or parentheses always implies a PDS or folder. If the set or parentheses are missing you are working with data sets. How do we know that we are in the Browse mode? Easy always look at the upper left-hand corner. ISPF will display a message, e.g., BROWSE, in the upper left-hand corner. Use a graphical snipping tool to document the BROWSE for a section of the contents for your XXXXXX.COBOL(CBL0001) data set below. Press the F3 key to exit the Data Set BROWSE Panel. P a g e 61 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.2.3 Browsing the XXXXXX.DATA.ACCOUNTS data set. Enter =3.4 on the Command or Option Line to navigate to the Data Set Utility Panel. Make sure that your user catalog name (userid) is display in the Dsname Level and then press the right-ctrl key to execute. Type a "B" (Browse) line command under the COMMAND column on the same line of data set in the DSLIST panel you wish to browse. Press the right-ctrl key to execute. Use a graphical snipping tool to document the BROWSE for a section of the contents for your XXXXXX.DATA.ACCOUNTS data set. Press the F3 key to exit the Data Set BROWSE Panel. P a g e 62 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.3 DSLIST Utility Panel - Editing a Data Set or PDS Member 6.3.1 Browsing the XXXXXX.COBOL(CBL0001) partitioned data set member Enter =3.4 on the Command or Option Line to navigate to the Data Set Utility Panel. Make sure that your user catalog name (userid) is display in the Dsname Level and then press the right-ctrl key to execute. After the XXXXX.COBOL partitioned data set in opened in the EDIT Mode a list of PDS members are displayed similar to the following. Type an "E" (Browse) command under the COMMAND column on the same line of data set in the DSLIST panel you wish to browse. In this case, we will EDIT the COBOL program named CBL0001. Press the right-ctrl key to execute. The "E" line command opens a data set member, in this case the COBOL source code, using the ISPF editor. The ISPF editor is roughly similar (and I mean roughly similar) to Notepad. Notice the Label EDIT is displayed at the left upper corner of the screen. When you see the key word EDIT, you will be using the ISPF Editor. P a g e 63 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.3.2 ISPF Primary command RESET Let's introduce our first ISPF Editing Primary command. At the left-hand column there are several ==MSG> Caution and Warning messages that ISPF wants you to read before you start editing or changing this COBOL program. For now, we will ignore these messages and will execute the REST primary command to clean up these messages. Type the ISPF Primary command RESET in the command line and press the right-ctrl key to execute. 6.3.3 ISPF Over-type Edit Mode and Insert Edit Mode After executing the RESET Primary command use the arrow keys to move the cursor to Line 500, e.g., AUTHOR…..and replace "Otto B. Fun." with your name. When you type in ISPF you will either be in the over-type edit mode or the insert edit mode by toggling the Insert key. When using the over-type editing mode, the cursor will be flat and whatever you overtype will erase the original characters. When using the insert editing mode, the cursor will be similar to a flat rectangle and whatever you type will not erase push the original characters to the right. If your review the previous information of this XXXXX.COBOL PDS each member had a maximum record length of 80 characters, which means you cannot type or push characters beyond column 80. ISPF Top Line left-hand corner will specify which ISPF utility or function to currently being used. In this example EDIT is displayed. In other examples when you are using ISPF data set or member editor. ISPF Top Line middle area may display the Title of the current ISPF Panel or the Name of a Data set. In this example, RMUI0001.COBOL(CBL0001) data set member name is being displayed. ISPF Top Line right-hand corner will display confirmation messages that an operation was completed or error messages will be displayed. In this example, Columns 00001 through 00072 message is being displayed. P a g e 64 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.3.4. Document the CHANGED AUTHOR NAME Use a graphical snipping tool to document the CHANGED AUTHOR NAME in your XXXXX.COBOL(CBL0001) data set member. After making any editing change press the F3 key which will exit the panel and automatically save any editing changes. If you do not want to save any changes, type the ISPF Editing Primary command CANCEL of PK12=Cancel. The CANCEL command will exit but not save. There are many ISPF primary commands. For now relax and practice. In other future tutorials we will get into more details. 6.3.5 Questions - ISPF Line Commands Given the following ISPF DSLIST Panel 1. In the DSLIST panel where does one enter and execute an ISPF line command? Answer: . 2. Which ISPF line command with provide detailed information concerning an ISPF data set, e.g.., volume location, data set organization, current allocation, etc. ? Answer: . 3. Which ISPF line command can you view the contents of a data set, but will not modify the contents of the data set? Answer: . 4. Which ISPF line command can you edit or modify the contents of the data set? Answer: . 5. Which ISPF line command can you edit or modify the contents (members) of a partitioned data set? Answer: P a g e 65 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM 6.3 DSLIST Utility Panel - Editing a XXXXXX.DATA.ACCOUNTS Sequential Data Set Enter =3.4 on the Command or Option Line to navigate to the Data Set Utility Panel. Make sure that your user catalog name (userid) is display in the Dsname Level and then press the right-ctrl key to execute. 6.3.1 Edit Entry Panel – Warn of First Data Change Type "E" line command under the Command column to edit the XXXXX.DATA.ACCOUNTS sequential data set press the right-ctrl key to continue. The following Edit Entry Panel may be displayed. The Edit Entry Panel is a warning panel. Review the forward slash that proceeds the Warn on First Data Change Option. The forward slash means that this Warning option has been selected. This forward slash is similar to checking on a Windows check box. If you erase the forward your will not be warning the next time you open this data set. The Warn on First Data Change simply asks you if you "really" do want to change the XXXXX.DATA.ACCOUNTS sequential dataset? It is only a warning message. If your answer is NO, press F3 to exit. If you answer is NO it will probably be safer to view the contents of this sequential data set using the Browse mode. If you answer is "yes" I want to make changes to this data set then press the right-ctrl key to continue in this tutorial example. For now simply press the right-ctrl key to continue. (We are going to live a little dangerously.) Your EDIT panel for XXXXXX.DATA.ACCOUNTS should be displayed similar to the following. P a g e 66 | 71 ASSINGMENT 2 HANDS-ON PART – 2 SETUP, ISPF AND Z/OS FILE SYSTEM To clean ==MSG> Warning message type the ISPF Primary command RESET on the command line and press the right-ctrl key to execute. To label the data with columns type the ISPF Primary command COLS on the command line and press the right-ctrl key to execute. Your EDIT panel for XXXXXX...
User generated content is uploaded by users for the purposes of learning and should be used following Studypool's honor code & terms of service.

This question has not been answered.

Create a free account to get help with this and any other question!

Similar Content

Related Tags

Brown University





1271 Tutors

California Institute of Technology




2131 Tutors

Carnegie Mellon University




982 Tutors

Columbia University





1256 Tutors

Dartmouth University





2113 Tutors

Emory University





2279 Tutors

Harvard University





599 Tutors

Massachusetts Institute of Technology



2319 Tutors

New York University





1645 Tutors

Notre Dam University





1911 Tutors

Oklahoma University





2122 Tutors

Pennsylvania State University





932 Tutors

Princeton University





1211 Tutors

Stanford University





983 Tutors

University of California





1282 Tutors

Oxford University





123 Tutors

Yale University





2325 Tutors