3 Contributing AuthorsThanks to the following individuals, for assisting with this document:Reginaldo Barosa/IBMChris Sellers/TSYS
4 Overview Audience Prerequisites These Cheat Sheets are designed for application developers who have learned or programmed in COBOL, and who need to do z/OS Traditional Development and Maintenance as well as build leading-edge applications using COBOL and Rational Developer for System z.PrerequisitesThese Cheat Sheets assume that you have learned and have used RDz, and that RDz is setup and working in your company, both:RDz Client – on your workstationRDz Server – on your z/OS mainframeFurther, we assume on your part:A basic understanding and knowledge of software computing technologies, and general data processing terms, concepts and vocabulary, as well as a working knowledge of COBOL and z/OS.Knowledge of SQL (Structured Query Language) is assumed for database access is assumed as well.Basic PC and mouse-driven development skills, terms and concepts are also assumed.
5 Table of Contents Basic Development Techniques: Accessing Source and Data SetsProgram Quick Fix (Trivial Edit)Program Maintenance (Non-Trivial Edit)Program Compile (build)Testing your programsEditing QSAM and VSAM Data SetsWorking with DB2 and SQLAccess and Manage Batch JobsISPF 3.x Utilities (data set allocation, delete, copy, etc.)Advanced Development Techniques:Development techniquesDB2 / SQL TechniquesDebugging TechniquesRDz Client Configuration and AdministrationConnecting to your mainframeConnecting to DB2Mapping z/OS Files to RDzSetting up Property GroupsCustomizing RDz Client Workspace DefaultsWorking with Views and PerspectivesTerms and Vocabulary
6 Basic Development Techniques UNITBasic Development TechniquesTopics:Accessing source and data setsAnalyzing your programsProgram "quick fix" (Trivial Edit)Program maintenance (Non-Trivial Edit)Program compile and linkTesting your programsEditing QSAM and VSAM data setsWorking with DB2 and SQLAccess and manage batch jobsISPF 3.x Utilities (Data Set allocation, delete, copy, etc.)
7 Accessing Source and Data Sets 1. Connect - See RDz Setup and Customization Cheat Sheet, for steps on connecting to your mainframe2. Access a data set in Remote Systems Explorer (RSE):Files that belong to you (with your TSO ID as the high-level qualifier) are in "My Datasets"Scroll through the list of libraries under MVS Files / My DatasetsIf you have RDz version or later installed, use the "Locate" option (Ctrl+L) to find a specific member within a library…or… Expand the PDS and find the source member you wish to editFiles that don't belong to you are accessed through Filters or Retrieve Data Sets (DSLIST)To use Retrieve Data Sets – right-click over MVS Files and select Retrieve Data SetsEnter your Data Set search string - literals and the * wildcard character – like ISPF 3.4Press EnterOpen an existing Filter in your connection, or to create a new Filter for files that aren't defined to your high-level qualifier:Right-click over MVS Files and select New > Filter...Enter the z/OS file-spec with or without wildcards in the Filter string, and click NextName the Filter and click OKOnce you define a Filter you can modify the Filter patterns by right-clicking over the filter, and selecting PropertiesTo add a second (or third) string pattern to an existing Filter – from the Filter's properties select: New filter stringAccess files through your Source Control Management System's RDz interfaceSearch for the data set or library member you needSelect one or more libraries (press the Ctrl key while clicking to select multiple PDSs)Click Remote SearchEnter the Search criteria (wildcards can be used in the search pattern):Search for text inside the members and search on member namesClick SearchDouble-click entries the Search Results view, to open the file and position the cursor at the found lineFAQWhat if I don't see Remote Systems Explorer? See Cheat Sheet on resetting your perspectiveWhat if I want to edit a data file (VSAM or QSAM file)? See section on editing VSAM/QSAM filesWhat if the file I need is on some other LPAR? See Cheat Sheet on connecting to your mainframeHow do I transfer a file from my PC to the mainframe? Drag and Drop the file to a PDS, or Copy and PasteWhat if the correct editor isn't opened for a file (no colorization, etc) See Cheat Sheet on File System MappingHow do I know who has a file locked? Right-click over a dataset, select Monitor and scroll right, to see Lock OwnerSee: for File Manager product installation and documentation
8 Program Analysis 1. Access your source 2. Understand the code before making source changes. Here are some RDz key features:Navigate within your source:ISPF Commands: top, bottom, enter a line # to go immediately to that line. (Easier) use the scroll bars for positioningPF7/PF8, PgUp/PgDn – Ctrl+PgUp, Ctrl+PgDn, Ctrl+Home, Ctrl+EndVisual analysis – Maximize your program understanding through optimal use of window/screen "real estate"Split screen – Press Ctrl+2.Double-click the editor tab to maximize your source view. Double-click the tab a 2nd time to restore the WorkbenchOpen the program's copybooks alongside the program in a multi-source viewSelect the copy statements copybook or include name. Right-click and browse or open the copybookDrag the editor tab to the right (or to the bottom) to create a multi-source viewHover (mouse over) a variable or section name – Displays the variable declaration or paragraphs within the sectionFilter the source to isolate program contentRight-click in the editor. Select: Filter view > Outline, or Code (filters out comments), or Comments (filters out code)Control Flow analysis - How is the program structured?Use the Perform Hierarchy – See Cheat Sheet for detailsDependency analysis - What copybooks and includes does this program use?From Remote Systems Explorer – Right-click, select Show DependenciesData Flow analysis – How does a data value move from field to field within the program?Ctrl/F search with Regular expressions - See Cheat Sheet for detailsUse the Search sub-menu and Pin the results- See Cheat Sheet for detailsVersion analysis – What are the differences between this program and the last version?From Remote Systems Explorer - Select both source files. Right-click and select: Compare With3. Close the File or continue with program source modificationFAQWhat if the Perform Hierarchy is grayed out?Ensure that there are no validation and syntax errors. Make sure you have selected the Paragraph nameWhat if I can't browse a copybook?Ensure that Property Group settings for Copy Libraries are correct - See Cheat Sheet on Property GroupsSee: for File Manager product installation and documentation
9 Program "Quick Fix" (short or, trivial edit session) Access your source – see prior Cheat Sheet "Accessing Source and Data Sets"Double-click to open the file - Right-click and select Browse to open the file Read-OnlyPerform Quick Fix edit:Find the statement(s):Scroll through the source, use the Outline view or use ISPF "Find" commandsChange the code, as per your requirements:Type or use Content Assist (Ctrl+Spacebar) for Intelli-sense editing of new statementsCheck for Validation errorsOptionally perform a Remote Syntax Check:Press Ctrl+Alt+R, or Right-click inside the source and from the Context menu select:Syntax Check > RemoteOpen the Remote Error List view, and check the results.Double-click on an error to position your cursor on the line in the editorSave (Ctrl+S) and Close the fileFAQWhat if my source is not colorized? - See z/OS File System Mapping Cheat SheetWhat if I closed a view (like the Outline view)? – See Cheat Sheet on working with views and perspectivesSee: for File Manager product installation and documentation
10 Program Maintenance (non-trivial edit session) 1. Access your source2. Understand the code and your source changes:3. Modify the code:Use your ISPF editing skills (Prefix area and Command line commands) – supplemented by RDz editing features:Ctrl+2 to split screen - Edit in either side of the split screen. Copy/paste from one side to the otherUse the Context Menu (Right-Click) to:Refactor (rename) a field, paragraph or section – Select the variable. Right-click and select: Refactor > RenameHex edit a lineNote that if you need to make a change in Hex - Select the line. Right-click and select Hex edit line, and from the CP037 (bottom) row, Change the EBDCIC Hex value and press <Enter>Select a variable, paragraph or section name and press PF3 to access its declaration. Even if the field is in a copybookClick the left (Back) arrow icon on the toolbar (top of the workbench) to return to your previous source positionComment out (or un-comment) one or more linesSelect the linesRight-click and select Source > Comment or UncommentSelect source andCopy/PasteChange the selected source lines to upper or lower caseOpen copybooks – Select the copybook name. Right-click and select: Open or Browse Copy MemberRemote Syntax Check.From the Remote Error List – double-click an error line to navigate to the syntax error in the sourceAs you type, check for Validation (syntax) errors (little yellow triangle icons in the left-hand border of the file)Use Content Assist (Press Ctrl+Spacebar) - Intelli-sense editing for:KeywordsVariables and paragraph namesCustom code templates – Press Ctrl+Spacebar to bring up the list of customized code templates4. Save and Close the FileFAQWhat if Content Assist or Refactor doesn't work?Ensure that there are no validation and syntax errors – and ensure that your Property Group file is correctSee: for File Manager product installation and documentation
11 Compile Your ProgramTo compile your program in order to create .OBJ and .EXE (Load Modules) use your Source Control Management System's build function ...or...Access/Open your JCL Library in RSESelect the member to compile your program.Right-click and select: Submit...or...Select the source file in the libraryRight-click and select Generate JCL – for Compile, or Compile/LinkSubmit the generated JCLFrom the JES icon, verify your compile resultsFAQHow do I know if my build worked?Access JES – and open the output spool for the COBOL and/or Link Edit stepsWhat if there are JCL errorsCheck your Properties Group file for correct COBOL PROC entries – see Cheat Sheet on this topicWhat is Local Syntax Check?A function of RDz that allows you to syntax check your program on your workstation (locally) using the Enterprise COBOL version 4 compilerDoes Remote Syntax Check compile a program?No, it only syntax checks your code on the mainframe. Use one of the above methods to compile/link your codeWhat is the difference between LOCAL and Remote Syntax checking?Local Syntax Check uses your workstation and the Enterprise COBOLV4 compiler to find syntax errorsRemote Syntax Check usesWhy could Local Syntax Checking display if the program is correct ?My property group for LOCAL Workstation project syntax checking is incorrect – see Cheat Sheet on Property GroupsI'm editing an OSVS/COBOL program, that has statements not compatible with Enterprise COBOL V4I am using special includes or COBOL statements not recognized by Enterprise COBOL V4 (example: TRANSFORM)My program contains EXEC CICS but have not installed TXSeries - or have not specified CICS in my Local Property groupMy program has EXEC SQL but have not specified SQL in my Local Property GroupSee: for File Manager product installation and documentation
12 Access and Manage Batch Jobs Submit a batch job:From Remote Systems Explorer:Open your JCL LibraryRight-Click over the run-stream JCL file, and select: SubmitFrom a JCL file open in the editor:Right-click, and from the context-menu, select: SubmitFrom the command-line, type:sub - to submit the job to the LPAR the file resides inSub <ConnectionName> - to submit the job to a specific connection (which could be to a different LPAR)Note that your JCL file can reside in a Local Workstation project, and you can submit to any LPAR you are connected toOpen your Job from the JES queue:Jobs that you submitted will be found under My Jobs – a Filter for <HLQ>.*Jobs submitted by others can be accessed through Filters:Right-click over JES and select: New > JES Job Filter…Enter the Filter criteria (typically on Job Owner or Job Name Prefix)Expand the Job spool files and double-click to open:Output for the entire jobOutput for any given job stepTo see your jobs in a table (so you can arrange/re-sort them):Right-click and select Show in TableTo re-run any job:Right-click over the job and select: Show JCL(SJ)To cancel a running job:Right-click over the job and select cancelTo Purge a job:Right click over the job, select PurgeFAQWhat if there is no: My Jobs filter under JES? Define a new Filter as: <HLQ>.* Take all of the defaults for Filter definitionWhat if my JCL isn't colorized? See Cheat Sheet on File System MappingSee: for File Manager product installation and documentation
13 Program Testing (Requires Debug Tool to be installed) Compile your program with Debug Tool required: DD card for SYSDEBUG and compile optionsDebug a program:First, from the Debug Perspective discover your I/P address and listener port - by clicking the downward-pointing triangle, immediately to the right of the Debug UI daemon iconDebugging a batch application:Substitute the I/P address in the JCL //CEEOPTS DD cardSubmit the jobDebug your code:Click F8 to run to a breakpoint, F5 to step (execute) your statements one line at a timeTo view the content of a variable - Hover over a field or look in the Variables or Monitors viewUse the Context Menu to:Set break pointsAdd variable watch monitorsRun or unconditionally branch to a given line in your programTerminate the session when finished - by clicking the red Terminate icon on the toolbarDebugging an Online ProgramSetup the DTCN properties for debugging an online transaction – See Cheat SheetFrom CICS or IMS DC (green screen) launch the transactionDebug your codeFAQWhat happens if my job ABENDs?You will be given the option to terminate or continue debuggingWhat happens when an online application returns to CICS or IMS DC (Message Switch)?The 3270 data stream/screen (BMS or MFS map) is displayed. Upon <Enter> or PF-Key you can continue to debugCan I backtrack (reverse the program execution flow)?As of RDz v8.0 this feature is not available (it's only available with Green-Screen Debug Tool (running under TSO)See: for File Manager product installation and documentation
14 Working with DB2 and SQL1. Connect to DB2 (double-click on a connection) – see the Cheat Sheets to learn how to define a new DB2 connection2. Explore your tables/views and their relationships:Use the Data Source explorer to drill-down into your tablesStart from the Schema folder and drill-down (expand) folders for tables, views, etc.Use the Overview diagram to see how your tables relateRight-click over the Schema, and select Overview DiagramFrom the Overview Diagram - select the tablesClick Go3. Code and test SQL:Right-click over the connection, and select SQL editorCode your SQL using Content Assist (Ctrl+Spacebar)Press F5 (or Right-click over the statement and select Run SQL)Check out results in the Results tab4. Analyze and Edit your DB2 test table values:Right-click over the tableSelect Sample Contents to see the value...or...Code SQL (see above) to filter the tableRight-click over the table, select EditChange valuesPress Ctrl+S to saveView your saved table changes using SQL or Sample ValuesSee: for File Manager product installation and documentation
15 Working with VSAM/QSAM Test Data (Requires File Manager to be installed) Access your fileYour ID – scroll to the bottom of the connection entriesA file created by someone else – Setup a Filter access the fileDouble-click to open, or Right-click and select browse and use File Manager to edit the fileNavigate throughout the file:Step (scroll) through the records in the fileJump to a particular record – or to the top and bottom of the fileRe-sort the file – click the Sort iconModify record content:Formatted view – Use the Browse button to associate a template file or copybook with a data fileMulti-row mode – Shows multiple records in the editor windowSingle view – Shows one record (the current or selected record) at a timeCharacter view – the Character tab treats the records like rowsView the records in Hex – Click the Hex iconSearch – Right-click over a record and select: Find/Replace:Search the file through logical fields within the records – using an associated copybook or templateSearch throughout the entire file – search all bytes in each record by De-Selecting all fields in Find/ReplaceCreate a subset extract – see the File Manager Viewlet on the IBM Education AssistantFAQWhen I double-click on a VSAM nothing seems to happen.This type of behavior usually signifies that either File Manager is not installed/configured on your z/OS – or File Manager not at the proper release level to work with the version of RDz you are usingSee: for File Manager product installation and documentation
16 ISPF 3.X Utilities - Working with Data Sets From Remote Systems Explorer, the Context Menu (Right-click) has the following options:Allocate Like - Creates a new data set using an existing Dataset's DCB and SPACE attributes Select a data set and Right-click to Allocate Like a new:Library (PDS)Sequential Data SetVSAM filesTo create new data sets from scratch – without basing them on an existing Data Set's DCB click: Specify characteristics (Advanced Allocation)Rename, Delete, Compress, SearchSelect one or more data sets - hold down the Ctrl key and left click to select multipleRight-click, and from the Context Menu select your optionCreate new PDS MemberSelect the library you want to create a new (empty) PDS member inRight-click, and from the Context Menu select Create NewSearch - through one or more librariesSelect one or more data sets - hold down the Ctrl key. Left click to select multiple. The libraries can be in the same or in different LPARsRight-click, and from the Context Menu select Search…Use wildcard search patterns and/or Regular expressions (the | character allows you to logically "OR" multiple search criteria)You can save your search query by clicking the small flashlight icon in the Remote z/OS Search viewClone an existing PDS Member – Create a new PDS member from another PDS member in the same libraryExpand the library you want to create a new PDS member inSelect the existing PDS member you wish to use as the new PDS memberRight-click, and from the Context Menu select CopyRight-click on the library again. Select Paste – and rename the PDS memberCompare two source filesExpand the libraries that contain the source members you wish to compare - The libraries can be in the same or in different LPARsSelect the existing PDS member you compare. Right-click and select: Compare With > Each OtherDefine a new GDG ModelSelect the MVS Files iconRight-click, and from the Context Menu select: New > Define Generation Data Group…FAQWhat if a Context Menu option does not appear – example, I Right-click over a PDS and don't see Compress?RDz will only provide allowable functions on a dataset. Your library is most likely a PDSE – and can't (doesn't need to be compressed)See: for File Manager product installation and documentation
17 Advanced Development Techniques UNITAdvanced Development TechniquesTopics:Control Flow AnalysisData Flow AnalysisReverse Engineering SQLEditing Large DB2 Tables
18 Program Control Flow Analysis Forward flow analysis (understand the Perform Chain starting from a given paragraph, and flowing forward in the PROCEDURE DIVISION)Select your starting paragraph name inside the editor (anywhere in the Procedure Division)Right-click and select: Open Perform HierarchyNote that, the Perform Hierarchy view can be moved to the top-right quadrant in RDz. This provides more vertical "screen real estate" and is better for large programsUse the Perform Hierarchy view, to understand the Perform ChainPerform nesting is shown as indented, hyper-linked paragraph namesTo read the code in Performed paragraphs:Use the Outline viewOr select the paragraph name (in the editor) and press F3Backward flow analysis (Answering the question: "How did I get here, in my code?")Click the small (Show Performer Hierarchy) icon on the top right of the view Use the Perform Hierarchy view, to understand what Perform and GO TO statements drive execution into your selected paragraphNote that Show Performer Hierarchy, and the icon next to it - Show Performee Hierarchy) toggle between backward and forward flow analysis. This toggle persists (so you will need to click it – between modes of Control Flow analysisFAQWhat if Perform Hierarchy is grayed out (disabled)?This can happen if you have not (yet) selected a paragraph, or if your program contains enough syntax errors that the RDz parser can't understand your Procedure Division.See: for File Manager product installation and documentation
19 Program Data Flow – or Impact Analysis Data Flow Analysis refers to the processing of tracing values as they flow through program variables, in MOVE statements, Math, I/O, etc.RDz provides two alternative methods that you may find efficient in doing these kinds of tasks:Use multiple search windowsFind and then select your starting variable in the sourceOpen the Search menu and select: Search > Text > FileFrom the Search view:Double-click a hyper-linked reference to see and position your cursor on the statementWhen you find a statement that references a new variable that you must analyze:Pin the current variable's search view, so that it persists Select the next variable in your sourceReturn to step 2 and iterateUse a single search window and Regular ExpressionsPress Ctrl+F to open the Find/Replace menu panelMake sure Regular expression is checkedEnter the variable name and press the All button – to find all instancesReview and analyze the returned statements – compressed in the source viewIf it turns out that another additional variables participate in the Data Flow:Return to Step 5 and Add the additional variable names into the Find box, separated by | charactersIterate from steps 5 7Analyze resultsSee: for File Manager product installation and documentation
20 Reverse Engineer an SQL Statement You can produce a visual diagram of SQL statements using the RDz Data ToolsAccess and open a DB2 embedded SQL programUse the Context menu (Right-click) and select: Filter view > Embedded SQL/CICS/DL1 to isolate your SQL statementsSelect and copy one your SQL statements – typically a cursor DECLAREOpen the Data PerspectiveIn the Data Project view – either create use an existing, or create a new Data Development ProjectRight-click inside the view and select: New > Data DevelopmentName the project (or leave the default name) and click: Next >Select your connection and click: FinishExpand the new project icon.Right-click over: SQL Scripts, and select: New > SQL or XQuery ScriptFrom the wizard select:SQL Query BuilderStatement type: SELECTPaste your previously copied embedded SQL statement into the top panelClick into the panel and edit the code:Remove host variablesA graphical view of your statement should appear in the middle panelNote that, even though RDz's Data Tools support host-variables, there are number of COBOL embedded SQL constructs that are not supportedYou may also test your SQL:From the Context MenuSelect Run SQLSee: for File Manager product installation and documentation
21 Editing Large DB2 Tables If your DB2 test table is too large to edit directly, you can use the following technique to modify row values:Run a SQL Script to create a Result set that you wish to use as the basis for your editing and new valuesExport the Results as: Plain Text (*.txt) and Comma SeparatedEdit the text file produced:Notepad works. Don't use any editor that adds special charactersDelete the column names headerYour new values will have to pass all of the standard DB2 (relational) data integrity checks:Data type/Length and max value (for numeric columns)/Primary key uniqueness/Foreign key (referential integrity) checksSave your new/edited tables valuesFrom the Data Source ExplorerSelect your tableRight-click and select: Data > Load…From the Load wizard select:File name (exported data)Comma delimiter: CommaCharacter string delimiter: NoneUn-check: Replace dataClick Finish and check the Load status MessageView your new table data valuesUse a SQL Script (Select statement) to verify yourSee: for File Manager product installation and documentation
22 Part III – RDz Setup and Customization UNITPart III – RDz Setup and CustomizationTopics:RDz Wizards, Setup and ConfigurationCustomize your Workspace Preferences
23 Setup a connection to your mainframe (z/OS) From Remote Systems ExplorerExpand the New Connections icon and Double-Click z/OS…Enter your host I/P address – or the logical name that resolves to an I/P address on your network. Example: zserveros.demos.ibm.comName the Connection and click Next >Note that connection names must be uniqueEnter your host port# for z/OS Unix files and click Next >This is a value that typically a systems programming staff who installed RDz would give youEnter your host port# for MVS files and click FinishThis is also a value that typically a systems programming staff would give youNote that this only creates a connection. To connect (for the first time)Right-click over your new connection and select ConnectEnter your TSO UserID and PasswordClick Connect - After this first connection, you only need to expand your connectionFAQWhen I try to connect what kinds of errors could I get?Three basic kinds:Authentication errors – due to wrong ID/PWDConnectivity errors – either your port settings are wrong, or there are network problems getting to z/OSRDz listener failures – the RDz mainframe components may be offline. You will need to contact your systems programming staff, and ask that they be restartedSee: for File Manager product installation and documentation
24 Setup a connection to DB2 on z/OS From the Data Perspective (from Remote Systems Explorer)Right-click over Database ConnectionsSelect: DB2 for z/OS as the database manager and enter Properties for your connection:Location:TCP/IP Location of the DB2 Server on z/OS (obtain from your DBA or Systems Programmer)Host:The IP Address of the z/OS mainframe for your DB2 systemPort:The port number for DB2 on your z/OS mainframeDo NOT check: Retrieve objects created by this user onlyUser name/PasswordYour TSO logon credentialsClick Next and from the Filter wizardUncheck: Disable filter - and:From the Drop Down box:- Select a search pattern- and enter a text stringOr check the Selection radio button, and check one ore more high-level Schema name(s) you wish to add to your ConnectionFAQWhen I try to connect what kinds of errors could I get?Two basic kinds:Authentication errors – due to wrong ID/PWDConnectivity errors – either your port settings are wrong or there are network problems getting to z/OSSee: for File Manager product installation and documentation
25 Create a filter (ISPF 3.4 Functionality) Create a filter for datasets:Filters are similar to ISPF 3.4 (DSLIST) functionality. They allow you to access files not "owned" by your TSO IDTo create a new filter:Right-click over MVS Files or My Data SetsSelect: New > Filter…Specify the search pattern for the Filter (like ISPF 3.4 – a combination of text strings and the asterisk * as a wildcard. Example: DDS0001.TEST.CO*Enter a name for the filter – note that the named filter will appear in Remote Systems ExplorerTo modify a filter – Extending it to additional datasets or changing its wildcard textSelect the filterRight-click and select: Properties – then select Filter StringTo change the existing filter string – overtype its wildcard textTo add an additional filter string (whose results are concatenated with other Filter string results):Select New filter stringSpecify the wildcard textClick OKCreate a filter for batch jobs – to allow you to view results for batch jobs you did not submit:Right-click over the JES icon and select: New JES Job Filter…Specify the JES Job filtering patternFAQWhat rights do I have to datasets I didn't create accessed through filters?The same rights you have when accessing the same datasets through TSO – all access privileges are governed by your authentication software: RACF, ACF-2 or Top SecretIf I delete a filter does it delete the underlying datasets? NOSee: for File Manager product installation and documentation
26 Setup a Local Property Group A Property Group is a collection of specifications (mostly compile/link properties like SYSLIB, whether to preprocess for DB2, CICS, etc.) used by RDz to provide z/OS functionality (syntax checking, opening Copybooks, etc.)To Setup or configure a Property Group for Local Workstation ProjectsFrom the Property Group Manager view:Expand LOCALDouble-click the Property Group you wish to configureTypically you will use the file produced by RDz when you create a new Local Workstation project. It's called: COBOL Sample Property GroupSelect the language (either PL/I or COBOL), and from the language tab:Specify SYSLIB:Enter the fully-qualified directory in which your copy code is storedTo concatenate multiple directories separate each by a semi-colonSpecify EXEC SQL options – if your programs access DB2:Check: Source contains SQL statementsSelect the connection to the DB2 system you wish to use- Note that if you wish to connect from a Local Project to DB2 on z/OS you will need to install andconfigure DB2 Connect. This is beyond the scope of these Cheat SheetsSpecify any SQL preprocessing optionsSpecify CICS options – if your source contains EXEC CICS statements:Check the: Source contains EXEC CICS statements boxNote that you must have IBM's TXSeries installed locally (on your workstation) in order to use this featureSee: for File Manager product installation and documentation
27 Setup a Property Group for z/OS (Remote) Assets Property Groups for mainframe (remote z/OS) assets are more sophisticated than for Local Workstation projects. To configure them use these 3 steps:Import a Property Group file as the default settings for a z/OS connection:From the Property Group Manager view:Select the Connection you want to work withRight-click and browse to the Property Group file you wish to use – note that you could have more than oneCustomize/Modify Property Group settings:Specify the Categories you want to configureClick the tab for your language (ex. COBOL, or PL/I) and from Settings tab check the Runtime Environments you wish to configure for (Example – does your program code contain: EXEC CICS or EXEC SQL statements)?Still from the Settings tab, Click: Procedures and Steps. Expand the bottom PROC name – and select the step name (PL/I or COBOL). From this window specify:Compile Option over-rides – typically you don't enter anything hereListing Output Data Set – A listing dataset PDS (133 LRECL, etc) for compile listings to be placed inDebug Data Set – A special PDS for members created for Debug Tool (LRECL=1024,BLKSIZE=27648)Object Deck Data set – Your Object library (output from successful compile)Copy Libraries – Your copybook and include libraries. Separate multiple by a spaceData Set Qualifier for Compile Errors – Enter a valid 8-byte MVS dataset name. Ex. ERRORCOB, ERRORPLI)Additional JCL – typically you don't enter anythingDatabase Request Module Location (DBRM) – DBRMLIB PDS for your DBRMs (only shows if you checked DB2 runtime)From the JCL tab:Specify any custom JOB card propertiesSpecify your JCL Library – Where RDz will generate JCL to (this is an RSE Context Menu option for programs)From the Link tab:Linkage Editor Option over-rides – typically you don't enter anything hereLink Libraries – Your Object library – and any other Object or Load Libraries for static includesLoad Module Location – Named Load Library RDz generated JCL will point to inside Compile/Link JCLAssociate your Property Group with your MVS files in RSERight-click over MVS Files, or at the level of a PDS and select: Property Group > Associate Property Group…FAQWhat does <HLQ> stand for? It stands for (resolves to) your high-level qualifier (TSO-ID) from your connectionSee: for File Manager product installation and documentation
28 Change Default Workspace Properties and Settings You may want to modify your shop's default RDz Workspace Properties This is similar to ISPF Option 0 – settings for TSO workAccess Preferences from:Window menuPreferencesFrom Preferences you can find and over-ride the following (commonly customized settings):ISPF Editor (default selection)Other LPEX editor preferences:TabsCOBOL number and column preferencesColors - ISPF style editor colors vs. white backgroundFind Text - most guys prefer Incremental find dialog as a defaultAdditional Parser AssociationsColumn line indicatorBMS or MVS Map Editor PreferencesLarge PDS Page (expansion) sizeDTCN View setup defaultsDebug tool configuration:Listener daemon portCICS Debug configuration, etc.File Manager - Editor data window size/stepSQL WORK:Results and Table editor row maxSQL and XQuery editor templatesSQL editor templatesCOBOL:New boiler-plate program codeStatement templates (v8.0 and higher)General (Eclipse settings):Custom Key mappingsHow long to keep Workspace Local HistoryCustomized perspectivesCustomized view colors,See: for File Manager product installation and documentation
29 Reset or Change Your RDz Perspective Perspectives are logical groupings of Views - and Views are like a single ISPF panel – a single-purpose function.Just as on the mainframe where ISPF groups panels with similar functions under a high-level menu, RDz groups views that go together into a "Perspective" (Debug, Data, z/OS Projects, etc.)To switch to a given Perspective from your current Perspective:Pull down the Window menuSelect Open PerspectiveChoose a Perspective from the list – or click: Other… and choose a PerspectiveNote that you can check Show all – to see a complete listTo reset your current Perspective to the IBM installation defaults – (useful if you've closed several views and want return all of them at once)Select Reset PerspectiveFAQWhat if I can't see a certain Perspective?From the above, check Show all – to see the complete list of RDz's perspectivesIf the Perspective you're looking for is on that comes with a 3rd Party product, work with your I/T group, to be sure that the product is installed/configured correctly on your machineSee: for File Manager product installation and documentation
30 Open and work with Views Views are like a single ISPF panel – a single-purpose function such as: Outline, Remote Systems Explorer, etc. Views are organized in Perspectives (previous topic)Occasionally you may inadvertently close a view – or? You may want to open a view for the first time. To do this - from your current Perspective:Pull down the Window menuSelect Show View >Choose a View from the list, or:Type a few characters of the View name – this will filter the view listFAQWhat if I can't see a certain View?If the View you're looking for is on that comes with a 3rd Party product – or simply is not part of the base RDz installation, work with your I/T group to be sure that the product is installed/configured correctly on your machineHow do I close a View? Click the X on the right-hand side of the View tabHow do I maximize a View? Double-click the View tab, or, Right-click over the View tab and select Maximize, or, Click the Maximize iconHow do I restore a maximized View (so I can see all of RDz's tools)? Double-click the View tab (this action toggles the view between maxi, or, Right-click over the View tab and select Maximize, or, Click the Maximize iconSee: for File Manager product installation and documentation
31 Terms and VocabularyWorkspace – the highest-level folder on your workstation that holds all of all of your RDz preferences, workbench "state" information and any locally-stored filesPerspective – a collection of related Views for a particular task, such as: z/OS Projects, Debugging, Fault Analysis, CICS System work, etc. Perspectives are similar to ISPF higher level menus, such as =3 UtilitiesView – a single tabbed window that represents one single development function (Perform Hierarchy, Program Outline, z/OS File Mapping, etc.). A view is similar to a single ISPF panel – such as 3.4 (DSLIST), 3.8 Outlist, etc.Property Group – an ASCII file used by RDz that contains specifications for z/OS compile and link JCL (Library names, concatenation order for SYSLIB) etc. Property Groups allow you to do Syntax checking (Remote and Local) as well as opening Copybook members in the editor, etc.z/OS File System Mapping – an ASCII file used by RDz that associates dataset names – and possibly member names within a data set to a given type of Workstation file (COBOL, Assembler, BMS, MFS, JCL, etc.). RDz uses z/OS File System Mapping to "know" which editor should be launched for any given z/OS fileFilter – A list of datasets that conform to a given search pattern, similar to ISPF 3.4 – except that RDz Filters persist, and can be a subset or superset of TSO files.See: for File Manager product installation and documentation
33 RDz – Mainframe Comparison Chart ("Cheat Sheet") TSO/ISPFRDz – Integrated Development EnvironmentMainframe – z/OSPC – Windows – where the code is being developedJCLJCL. If doing offloading from z/OS, shell scripts – on AIX machinesManually analyze codeRAA iEdit Code - ISPFLPEX or ISPF mode editorCompile/Compiler OptionsSyntax Check – and/or Build Application – Compiler options under RDzSubmit JobEdit JCL and submit job, or just use the Context menu and SubmitUnit Test – DISPLAY/READY Trace, XpeditorDebug Perspective – Local ProjectIntegration Test – XpeditorRemote Systems – z/OS Debug Tool IntegrationQA – Regression Test - WinRunnerRemote Systems Testing – and utilizing Rational Function TesterABEND-AID/IBM Fault AnalyzerRDz – Integrated Fault AnalyzerFile-Aid/IBM File ManagerRDz – Integrated File ManagerPDS (library)Project – or Folder SetJESRemote System / JESEndevor/ChangeMan – or Your SCLM3rd Party SCM utilizing RDz's CARMA feature; ClearCase utilizing native integration; SCLM utilizing the SCLM DT Perspective and/or Local HistoryISPF Option 0PreferencesISPF Option 1 and Option 2LPEX EditorISPF Option 3.1 (Library Utilities)Remote Systems ExplorerISPF Option 3.2 (Dataset Utilities)ISPF Option 3.3 (Move and Copy)ISPF Option 3.4 (DSList)Filters and Context Menu in Remote Systems Explorer and LPEX EditorISPF Option 3.8 (Outlist)Remote Systems Explorer – JES – My JobsISPF Option 3.11 3.15 (Extended Search)Search menuISPF Option 4 (Foreground)RunISPF Option 6TSO Command Shell – with some functional limitations (e.g. cannot issue Host Execs)ISHELLRemote Systems Explorer - USS files/filters + Context menuOMVSUSS Command ShellSPUFI/QMFData Perspective
34 RDz – ISPF Comparison Chart – PF-Keys ISPF EditorLPEX EditorPF 1 = HelpF1, Help MenuPF 2 = Split: Split the session (lets you use two functions of TSO at the same time.)Ctrl/2 or Context Menu – Open New View – can open unlimited # of viewsPF 3 = EndCtrl+F4 / Ctrl + 0, or close the Content AreaPF 4 = ReturnClose the Content AreaPF 5 = RFind (repeat last find )Ctrl/F – and /<text> from LPEX commandPF = 6 RChange (repeat lst change)Ctrl/NPF = 7 Move BackwardPgUp key – or slider in windowPF = 8 Move forwardPgDn key – or slider in windowPF = 9 Switch between screens during a split session; goes with PF 2Mouse – or Alt + Shift + Right/LeftPF = 10 Move leftHome key, or slider in windowPF = 11 Move rightEnd key, or slider in WindowPF = 12 RetrieveFor LPEX commands, the Up ArrowUse ISPF Option 0 to customize PF-KeysUse Preferences to customize and extend Function key behaviorThe LPEX Context Menu can be accessed from the Right-mouse button – and from the Windows Menu key (on the keyboard between the right Alt & Ctrl keys)It should be noted that with the LPEX editor, it is not necessary for most of the above functions to actually press Ctrl/Key combinations, as the functionality is available from a context menu (right-mouse)In LPEX F1 gives you language-sensitive help (pressing F1 while the cursor is on a COBOL keyword will display help for that keyword).To get LPEX help, enter the help command from the LPEX command line.
35 RDz – ISPF Comparison Chart – Primary Edit Commands ISPF EditorLPEX EditorHome key – Jump to the Command LineEscape key – jumps to the LPEX command lineAUTOSAVE/RECPrompt for Save on exit, and Autosave (Preferences), and the asterisk – next to unsaved file namesBOTtomLPEX command: bottom / Ctrl+EndCANcelIf have not saved, Close Content Area w/Save noCHANGE – All – NEXT, CHARS, X, ALL PREFIX, FIRST, SUFFIX, LAST, WORD, PREV, [col-1] [col-2]Supported using replaceText, Ctrl+F or the Search window: Change All, Next, PREV, Prefix and Suffix (with wildcards), Prev, Word, [col-1][col-2], PCopy Member NameLPEX command: Get filenameCREATESave file as…, or use Snippets ViewFIND – NEXT, CHARS, X, ALL PREFIX, FIRST, SUFFIX, LAST, WORD, PREV, [col-1] [col-2]Supported using findText, Ctrl+F, or the Search window: Find All, Next, PREV, Prefix and Suffix (with wildcards), Prev, Word, [col-1][col-2], PNot supported: First, LastHEX – Displays all lines in HexadecimalDisplay one individual lines in HexISPF MacrosNot available – but can be re-written using Java for LPEX. Also, note that with the LPEX functionality some macro functionality may not be necessaryLOCATEOn the command line, type in the line number (no "L"), or use the Outline ViewMODELSnippets and Templates (both options)MOVE Member NameLPEX Get command, in a different way, the Snippets ViewNUMBERLPEX command: number std (columns 7380), or number cobPRINT – from ISPF 3.4LPEX command: print, or Ctrl+PPROFILE – are the changes made to your profilePreferencesReplace Member NameSnippets functionalityRESetLPEX command: expandAll, or: action showAll, or Ctrl+WSaveCtrl/S or LPEX Save commandSortLPEX command: sortSTATS – updates statisticsWindows updates file statisticsautomaticallySUBmitLPEX command: Submit, or edit JCL/Context Menu/Submit, or use Context Menu/Submit optionTABSCan set margins in PreferencesTOPLPEX command: top / Ctrl+HomeTSO SUBLPEX command: submit, and edit JCL/Context Menu/Submit, or use Context Menu/Submit optionUNNUMLPEX command: unnum***Changes to Preferences are persistent, even if they are changed via LPEX commands.Also you can write/modify User Profiles which customize LPEX settings (but this requires writing a Java class and a plug-in).
36 RDz – ISPF Comparison Chart – Edit Line Commands ISPF EditorLPEX Editor – ISPF ModeA, An – AfterA, AnB, Bn – BeforeB, BnCOLS – show columnsColumns always shownC, Cn, CC – CopyC, Cn, CCD, Dn, DDF, Fn – First (used with eXclude)F,I, In – Insert linesI, InL, Ln – Last (used with eXclude)N - Find excludes lines of codeM, Mn, MM – MoveContext menuR, Rn, RR, RRn – Repeat linesS, Sn – Show (used with eXclude)FilterTABS – used with TAB OnSet with PreferencesX, Xn, XX eXcludeX, Xn, XXO, On, OO – OverlayO, On, OOTS, TSn – Text SplitCtrl+<Enter><, <n, <<N Shift Data Left<, <n, <<n>, >n, >>n Shift Data right>, >n, >>n(, (n, ((, ((N – columns left – Used with COBOL(, (n, ((n), )n, )), ))n – Columns Right), )n, ))nI don't know what all the supported line commands are off the top of my head, but see the following help page: Developing > Developing COBOL, PL/I, Assembler, and C++ applications > Language Editors > System z LPEX Editor > z/OS extensions to the base LPEX editor > System z LPEX commands > ISPF LPEX commands.The ISPF commands come from a number of different products/development teams, so the documentation is a bit convoluted, but the above page contains links to all the relevant documentation.
37 RDz – ISPF Comparison Chart – LPEX Editing Operations – 1 of 2 LPEX EditorISPF EditorRefactor – Remove Noise Words: - IS, THEN, PROCEED TON/AMultiple Line Comment/UncommentPersistent virtual margins – in the editorCode completion (Content Assist)Open CopybookOpen Declaration – of variable or PERFORM'd paragraph from anywhere in the Procedure DivisionPerform HierarchyRefactor – wizard for intelligent variable name changesOutline ViewFilter View – Show only Divisions, SQL,CICS,DL/I, Code (no comments), etc.COBOL, PL/I and HLASM keyword / language helpShow lines that have been changed during edit (before save)Find and Change against multiple file typesBlock Marking (Ctrl+Down, Ctrl+Up, Ctrl+Home, Ctrl+End)Virtual 'A' and 'B' Column lines in the source codeAllocate LikeRemote System FiltersSide-by-side Compare and/or Restore from Local HistoryClose all split screens in one operation (context menu)See file attributes and statistics at all times (in a View)
38 RDz – ISPF Comparison Chart – LPEX Editing Operations - 2 of 2 LPEX EditorISPF EditorWizard-driven approach to creating Web Services (WSDL files) from: CICS and IMS TM applicationsN/AWizard-driven approach to creating, testing and deploying DB2 Stored ProceduresCopy files from one LPAR to anotherEdit/Compile/Unit Test if the mainframe is offlineSyntax error – automatically select line with problemSee 46 76 lines of source at onceTemplatized program developmentRegular expression searches – including across Filtered files of different file typesKeystroke recorder (useful for repetitive tasks and online testing)Bookmark and Tasks (both lines of source and filtered views)Find "Last Changed" line of source code / Ctrl+JMark lines – including individual namesFind Marked Lines / Find named Marked LinesSyntax errors as you typeSyntax check in the editor
39 Hot-Key Combinations – Part 1 RDz Hot KeysDescriptionISPF EquivalentCtrl+HomeTop of fileMax PF7Ctrl+EndBottom of fileMax PF8Ctrl+2Open same program in split-screen viewPF2 - then open the source memberCtrl+0 (zero) …or… Ctrl+F4Close edit sessionPF3 (or CAN on the command line)Ctrl+SSave edit sessionSaveCtrl+PPrint current fileN/ACtrl+TMake current line top line in the editorPF7/PF8 with CSR as your paging optionPgUpPage up one physical page of source at a timePF7PgDnPage down one page of source at a timePF8PF7/PF8Page up/down one page of source at a timeUp/Down –Right/Left ArrowsScroll one character at a time through your source:Up/Down – Right/LeftUp/Down/Right/Left ArrowsCtrl+PgDnPage RightPF11Ctrl+PgUpPage LeftPF10Ctrl+LOpen Line Number featureCtrl+GFilters out all COBOL code except the four divisionsPrefix area excludeCtrl+WShow all filtered linesRESShift+F10Show the Context (popup) menuCtrl+Shift+LShow the list of all Hot-Key CombinationsEscapeCursor jumps to the command line
40 Hot-Key Combinations – Part 2 RDz Hot KeysDescriptionISPF EquivalentCtrl+FOpens Find/Replace DialogFind/Change ISPF CommandsCtrl+ZUndo last changeUNDO (if Recovery On)Ctrl+YRedo last changeN/AShift+Down ArrowSelect text from the current cursor position downward in the source filePrefix Area Command: CC … CC PF7Shift+Up ArrowSelect text from the current cursor position upward in the source fileCtrl+Shift+Right ArrowSelect wordShift+EndSelect text from cursor position to end of lineShift+HomeSelect text from cursor position to beginning of lineCtrl+ASelect all text in the source filePrefix Area Command: C99999Alt+UUnselect selected textCtrl+CCopy currently selected source linesPrefix Area Command: C or CCCtrl+XCut currently selected source linesPrefix Area Command: M or MMCtrl+VPaste currently copied source linesPrefix Area Command: A or BCtrl+JFind previous edit changeCtrl+RightLocates cursor at the beginning of the next COBOL wordCtrl+BackspaceDelete Current linePrefix Area Command: DCtrl+DRepeat Current linePrefix Area Command: RCtrl+/ or Ctrl+\Comment or Uncomment current lineCtrl+EnterInsert new linePrefix Area Command: TS or ICtrl+DeleteDelete (Truncate) to end of lineErase (EOF) keyF5 and F6Find and Repeat Find, Change and Repeat ChangePF5 / PF6F2Delete COBOL word to the right of the cursor position
Your consent to our cookies if you continue to use this website.