You are previewing IBM zPDT Guide and Reference: System z Personal Development Tool.
O'Reilly logo
IBM zPDT Guide and Reference: System z Personal Development Tool

Book Description

This IBM® Redpaper Redbooks® publication provides both introductory information and technical details for the IBM System z® Personal Development Tool (IBM zPDT®), which produces a small System z environment suitable for application development. zPDT is a PC Linux application. When zPDT is installed (on Linux), normal System z Operating Systems (such as IBM z/OS®) may be run on it. zPDT provides the basic System z architecture and provides emulated IBM 3390 disk drives, 3270 interfaces, OSA interfaces, and so forth.

This current document merges four separate previous Redbooks publications into this single book. The primary reason for this merger is to provide simpler zPDT documentation usage when viewing or searching the documentation onscreen.

The systems that are discussed in this document are complex, with elements of Linux (for the underlying PC machine), IBM z/Architecture® (for the core zPDT elements), System z I/O functions (for emulated I/O devices), z/OS (the most common System z operating system), and various applications and subsystems under z/OS. We assume that the reader is familiar with general concepts and terminology of System z hardware and software elements, and with basic PC Linux characteristics.

This book provides the primary documentation for zPDT and includes basic system overview, installation, operation, z/OS distribution, FAQs.

Table of Contents

  1. Front cover
  2. Notices
    1. Trademarks
  3. Preface
    1. Authors
    2. Now you can become a published author, too!
    3. Comments welcome
    4. Stay connected to IBM Redbooks
  4. Chapter 1. Introduction
    1. 1.1 Quick start (GA5 or GA6)
  5. Chapter 2. Function, releases, content
    1. 2.1 System z characteristics
    2. 2.2 Hardware token
      1. 2.2.1 Emulated I/O
      2. 2.2.2 Concurrent PC workloads
    3. 2.3 Operational overview
      1. 2.3.1 Linux userids
      2. 2.3.2 zPDT instances
      3. 2.3.3 zPDT console
      4. 2.3.4 Performance
    4. 2.4 Base configurations
      1. 2.4.1 Hardware and software levels
    5. 2.5 Using older System z architectures
    6. 2.6 zPDT Components
      1. 2.6.1 zPDT elements
      2. 2.6.2 Memory
      3. 2.6.3 Disk space
      4. 2.6.4 LAN adapters
      5. 2.6.5 Device maps
      6. 2.6.6 Linux directory structure
      7. 2.6.7 zPDT control structure
    7. 2.7 1090 and 1091 differences
    8. 2.8 zPDT releases
      1. 2.8.1 Version 1 Release 6 (March 2015)
      2. 2.8.2 Version 1 Release 5 (February 2014)
      3. 2.8.3 Version 1 Release 4, and fix pack 1 (December 2012, May 2013)
      4. 2.8.4 Version 1 Release 3 (March 2012)
      5. 2.8.5 Version 1 Release 2 (June 2011)
      6. 2.8.6 Version 1 Release 1
  6. Chapter 3. Devmaps
    1. 3.1 Device maps
    2. 3.2 System stanza
      1. 3.2.1 Adjunct-processor stanza
      2. 3.2.2 System timer protocol stanza
    3. 3.3 Manager stanzas
      1. 3.3.1 The awsckd device manager
      2. 3.3.2 The awsfba device manager
      3. 3.3.3 The aws3274 device manager
      4. 3.3.4 The awstape device manager
      5. 3.3.5 The awsosa device manager
      6. 3.3.6 The awsrdr device manager
      7. 3.3.7 The awsprt device manager
      8. 3.3.8 The awscmd device manager
      9. 3.3.9 The awsscsi device manager
      10. 3.3.10 The aws3215 device manager
      11. 3.3.11 The awsoma device manager
      12. 3.3.12 The awsctc device manager
  7. Chapter 4. zPDT commands
    1. 4.1 The commands with examples
      1. 4.1.1 The adstop command
      2. 4.1.2 The alcckd command
      3. 4.1.3 The alcfba command
      4. 4.1.4 The ap_create command
      5. 4.1.5 The ap_query command
      6. 4.1.6 The ap_von and ap_voff commands
      7. 4.1.7 The ap_vpd command
      8. 4.1.8 The ap_zeroize command
      9. 4.1.9 The attn command
      10. 4.1.10 The aws_bashrc and aws_sysctl commands
      11. 4.1.11 The aws_findlinuxtape command
      12. 4.1.12 The awsckmap command
      13. 4.1.13 The awsin command
      14. 4.1.14 The awsmount command
      15. 4.1.15 The awsstart command
      16. 4.1.16 The awsstat command
      17. 4.1.17 The awsstop command
      18. 4.1.18 The card2tape command
      19. 4.1.19 The card2txt command
      20. 4.1.20 The ckdPrint command
      21. 4.1.21 The clientconfig command
      22. 4.1.22 The clientconfig_authority command
      23. 4.1.23 The cpu command
      24. 4.1.24 The d command
      25. 4.1.25 The fbaPrint command
      26. 4.1.26 The find_io command
      27. 4.1.27 The hckd2ckd, hfba2fba, and htape2tape commands
      28. 4.1.28 The interrupt command
      29. 4.1.29 The ipl command
      30. 4.1.30 The ipl_dvd command
      31. 4.1.31 The listVtoc command
      32. 4.1.32 The loadparm command
      33. 4.1.33 The managelogs command
      34. 4.1.34 The memld command
      35. 4.1.35 The mount_dvd command
      36. 4.1.36 The msgInfo command
      37. 4.1.37 The oprmsg command
      38. 4.1.38 The pdsUtil command
      39. 4.1.39 The query command
      40. 4.1.40 The rassummary command
      41. 4.1.41 The ready command
      42. 4.1.42 The restart command
      43. 4.1.43 The scsi2tape command
      44. 4.1.44 The SecureUpdateUtility command
      45. 4.1.45 The SecureUpdate_authority command
      46. 4.1.46 The senderrdata command
      47. 4.1.47 The settod command
      48. 4.1.48 The snapdump command
      49. 4.1.49 The st command
      50. 4.1.50 The start command
      51. 4.1.51 The stop command
      52. 4.1.52 The storestatus command
      53. 4.1.53 The storestop command
      54. 4.1.54 The stpserverstart command
      55. 4.1.55 The stpserverstop command
      56. 4.1.56 The stpserverquery command
      57. 4.1.57 The sys_reset command
      58. 4.1.58 The tape2file command
      59. 4.1.59 The tape2scsi command
      60. 4.1.60 The tape2tape command
      61. 4.1.61 The tapeCheck command
      62. 4.1.62 The tapePrint command
      63. 4.1.63 The token command
      64. 4.1.64 The txt2card command
      65. 4.1.65 The uimcheck command
      66. 4.1.66 The uimreset command
      67. 4.1.67 The uimserverstart command
      68. 4.1.68 The uimserverstop command
      69. 4.1.69 The Z1090_ADCD_install and Z1091_ADCD_install commands
      70. 4.1.70 The Z1090_token_update and Z1091_token_update commands
      71. 4.1.71 The Z1090_removall command
      72. 4.1.72 The z1090instcheck command
      73. 4.1.73 The z1090term command
      74. 4.1.74 The z1090ver and z1091ver command
      75. 4.1.75 The zpdtSecureUpdate command
    2. 4.2 Command summary
  8. Chapter 5. zPDT installation
    1. 5.1 Disk planning
    2. 5.2 Linux installation
      1. 5.2.1 x3270 keyboard maps
      2. 5.2.2 Other Linux notes
    3. 5.3 Installing zPDT software
      1. 5.3.1 Alter Linux files
    4. 5.4 Token activation and zPDT serial numbers
    5. 5.5 Installing a new zPDT release
  9. Chapter 6. AD-CD installation
    1. 6.1 General principles
    2. 6.2 System z Operating Systems
      1. 6.2.1 Media
    3. 6.3 Packages for zPDT
    4. 6.4 Installing an AD-CD system
      1. 6.4.1 Specific installation instructions
      2. 6.4.2 IODF device numbers
      3. 6.4.3 zPDT control files
      4. 6.4.4 IPL and operation
      5. 6.4.5 Shutting down
      6. 6.4.6 Startup messages
      7. 6.4.7 Local volumes
    5. 6.5 z/OS parameters
    6. 6.6 Multiple operating systems
  10. Chapter 7. LANs
    1. 7.1 OSA CHPIDs
    2. 7.2 Scenarios
    3. 7.3 Overview of LAN usage
      1. 7.3.1 Three 3270 interfaces
    4. 7.4 Basic QDIO setup for z/OS
    5. 7.5 Five scenarios
      1. 7.5.1 Scenario 1
      2. 7.5.2 Scenario 2
      3. 7.5.3 Scenario 3
      4. 7.5.4 Scenario 4
      5. 7.5.5 Scenario 5
      6. 7.5.6 Scenario comparison
      7. 7.5.7 z/OS resolver
      8. 7.5.8 Local router LAN setups
      9. 7.5.9 Performance problems
    6. 7.6 Wireless connections
    7. 7.7 Telnet to z/OS UNIX system services
    8. 7.8 Choices
    9. 7.9 Useful networking commands
    10. 7.10 Non-QDIO operation
    11. 7.11 More complete QDIO example
    12. 7.12 Large or jumbo packets
    13. 7.13 VLAN usage
    14. 7.14 Shared Ethernet adapters
    15. 7.15 Base Linux LAN notes
    16. 7.16 Ethernet SNA
  11. Chapter 8. License server
    1. 8.1 Methodology
    2. 8.2 Installation and configuration
      1. 8.2.1 Client configuration
      2. 8.2.2 Remote server configurations
    3. 8.3 Notes
    4. 8.4 Scenarios
      1. 8.4.1 Display hostname assignments
      2. 8.4.2 Security
      3. 8.4.3 Resetting everything
      4. 8.4.4 SafeNet module restarts
    5. 8.5 License manager glossary
  12. Chapter 9. Other System z Operating Systems
    1. 9.1 z/VSE
    2. 9.2 Linux for System z
    3. 9.3 z/VM
    4. 9.4 Installing the AD-CD z/VM 6.3 system
      1. 9.4.1 zPDT devmap
    5. 9.5 IPL and logon
    6. 9.6 CMS
      1. 9.6.1 User MAINT
    7. 9.7 Minidisks and files
      1. 9.7.1 Inspecting your disks
      2. 9.7.2 XEDIT
    8. 9.8 z/VM directory
    9. 9.9 Spool contents
    10. 9.10 Simple system queries
    11. 9.11 zIIPs and zAAPs
    12. 9.12 Paging
  13. Chapter 10. Multiple instances
    1. 10.1 Multiple instances or guests
    2. 10.2 Multiple guests in one instance
    3. 10.3 Independent instances
    4. 10.4 Instances with shared I/O
    5. 10.5 Additional shared functions
  14. Chapter 11. The awscmd command
    1. 11.1 Sample z/VM script
    2. 11.2 z/OS use
      1. 11.2.1 Sample z/OS program for awscmd
  15. Chapter 12. Minor z/OS notes
    1. 12.1 Read-only DASD volumes
    2. 12.2 Disabled wait delay
    3. 12.3 IEBCOPY problems
    4. 12.4 Maintenance for AD-CD z/OS systems
    5. 12.5 z/OS CP and memory display
    6. 12.6 Excessive Health Checker messages
    7. 12.7 z/OS spin loop timeouts
    8. 12.8 Larger 3270 display
    9. 12.9 z/OS disk space
    10. 12.10 Java and WebSphere Application Server startup
    11. 12.11 Stand-alone z/OS dump
      1. 12.11.1 Generating a stand-alone dump program
      2. 12.11.2 Operating a stand-alone z/OS dump
    12. 12.12 Moving 3390 volumes
      1. 12.12.1 Create a source dump
      2. 12.12.2 Send dump to Linux
      3. 12.12.3 Receive dump
      4. 12.12.4 Stand-alone restore
    13. 12.13 IODF Changes with zPDT
    14. 12.14 Local printing
      1. 12.14.1 Setup
      2. 12.14.2 Operational technique
    15. 12.15 Enabling TSO users for OMVS
    16. 12.16 SYS1.LOGREC full
    17. 12.17 Lost MVS console
    18. 12.18 Unable to start ISPF
    19. 12.19 Health Checker
    20. 12.20 RMF Monitor III
    21. 12.21 OTELNET
    22. 12.22 Compressing PARMLIB
    23. 12.23 Burning 3390 volumes on CD
    24. 12.24 Delete logstreams
    25. 12.25 SMF
    26. 12.26 Disabled waits
  16. Chapter 13. Additional zPDT notes
    1. 13.1 Token activation and renewal
      1. 13.1.1 Files sent from license processing function
      2. 13.1.2 Overview of token updates
      3. 13.1.3 Token license update details
    2. 13.2 Read-only and shared DASD
      1. 13.2.1 Shared read-only volumes
    3. 13.3 Very large PC memory
    4. 13.4 Token dates and times
    5. 13.5 Typing OPRMSG too many times
    6. 13.6 Important Linux command window
    7. 13.7 The crontab and sudo entries
    8. 13.8 Dynamic configuration changes
    9. 13.9 Security exposures
      1. 13.9.1 Reducing root usage
      2. 13.9.2 Linux suid use
      3. 13.9.3 Token server monitoring
    10. 13.10 z1090instcheck
    11. 13.11 zPDT build information
    12. 13.12 CPs, processors, threads, and tokens
    13. 13.13 CKD versioning
    14. 13.14 1090 messages
    15. 13.15 TCP/UDP ports
    16. 13.16 Remote operation
    17. 13.17 x3270 cursor position
    18. 13.18 Devices, memory, msgmni, ulimit, sem
    19. 13.19 Startup scripts
    20. 13.20 Multiple users and 3270 sessions
      1. 13.20.1 Methods to connect multiple 3270 sessions
      2. 13.20.2 Multiple user configurations
  17. Chapter 14. Tape drives and tapes
    1. 14.1 The awsscsi device manager
    2. 14.2 Parallel SCSI adapters
      1. 14.2.1 Parallel SCSI drives and interfaces
      2. 14.2.2 Specific hardware tested
    3. 14.3 zPDT 359x Tape Support
      1. 14.3.1 The FCP Adapters
      2. 14.3.2 3590/3592 Tape drives
    4. 14.4 zPDT SCSI utilities
    5. 14.5 Linux SCSI tape utilities
    6. 14.6 awstape utilities
    7. 14.7 Practical advice
  18. Chapter 15. DASD volume migration
    1. 15.1 Warnings
    2. 15.2 Operational characteristics of the migration utility
    3. 15.3 Installation of the migration utility for z/OS
      1. 15.3.1 Server installation
      2. 15.3.2 RACF requirements
    4. 15.4 Operation of the server under z/OS
    5. 15.5 Installation of the server under z/VM
    6. 15.6 Operation of server under z/VM
    7. 15.7 The client commands
    8. 15.8 Additional notes
  19. Chapter 16. Channel-to-channel
    1. 16.1 z/OS use example
    2. 16.2 Multiple instances and z/VM
      1. 16.2.1 Devmaps
  20. Chapter 17. Cryptographic usage
    1. 17.1 Background information
    2. 17.2 Devmap specification
    3. 17.3 Initial ICSF startup
    4. 17.4 Operational notes
      1. 17.4.1 Multiple zPDT instances
      2. 17.4.2 Coprocessor control commands
      3. 17.4.3 New z/OS releases
      4. 17.4.4 Programming with ICSF
      5. 17.4.5 z/VM usage
  21. Chapter 18. Virtualization
    1. 18.1 VMware
      1. 18.1.1 Usage notes
    2. 18.2 zEnterprise BladeCenter Extension
    3. 18.3 Security and control
    4. 18.4 Performance
      1. 18.4.1 Open notes
  22. Chapter 19. Problem handling
    1. 19.1 Problems starting zPDT operation
    2. 19.2 Problems during zPDT operation
    3. 19.3 Core images
    4. 19.4 Logs
    5. 19.5 Emulated volume problems
    6. 19.6 Linux monitoring
  23. Chapter 20. Server Time Protocol (STP)
    1. 20.1 CCT uses
    2. 20.2 Configuration
    3. 20.3 Additional details
      1. 20.3.1 Leap seconds
  24. Chapter 21. Sysplex
    1. 21.1 General introduction
      1. 21.1.1 High-level concepts
      2. 21.1.2 IBM coupling facility use
      3. 21.1.3 Hardware
      4. 21.1.4 Performance
    2. 21.2 Sysplex goals
      1. 21.2.1 General system characteristics
    3. 21.3 Implementation overview
    4. 21.4 Detailed setup steps
      1. 21.4.1 Create new volumes
      2. 21.4.2 Configure z/VM guests
      3. 21.4.3 Create S0W2 specific data sets
      4. 21.4.4 Create couple data sets
      5. 21.4.5 Coupling facility structures for parallel sysplex
      6. 21.4.6 SMS changes
      7. 21.4.7 HFS and zFS file systems
      8. 21.4.8 Define coupling facility structures
      9. 21.4.9 Define LOGR operation for basic sysplex
      10. 21.4.10 PJES2 MAS configuration
      11. 21.4.11 Create new PARMLIB members
      12. 21.4.12 Create new PROCLIB members
      13. 21.4.13 Create new TCPPARMS
      14. 21.4.14 Create new VTAMLST members
      15. 21.4.15 Create new SYS1.IPLPARM members
    5. 21.5 Parallel Sysplex operation
      1. 21.5.1 Devmap
      2. 21.5.2 IPL parameters
      3. 21.5.3 Operational notes
      4. 21.5.4 Shutdown
      5. 21.5.5 Rebuilding coupling data sets
      6. 21.5.6 Adding 3390 volumes (Parallel Sysplex)
      7. 21.5.7 Adding more 3270 terminals (Parallel Sysplex)
      8. 21.5.8 Scaling up (Parallel Sysplex)
    6. 21.6 Basic sysplex operation
      1. 21.6.1 Before starting zPDT
      2. 21.6.2 Devmap and Starting zPDT
      3. 21.6.3 IPL the systems
      4. 21.6.4 Shutdown
      5. 21.6.5 Rebuild couple data sets
      6. 21.6.6 Alternate configuration for basic sysplex
    7. 21.7 Base AD-CD system under z/VM
    8. 21.8 Useful commands
  25. Appendix A. FAQ
  26. Appendix B. AD-CD z/OS 2.1 notes
  27. Appendix C. Rational Development and Test Environment for System z
    1. Getting started with RD&T
  28. Related publications
    1. IBM Redbooks
    2. Other References
    3. Help from IBM
  29. Back cover
  30. IBM System x Reference Architecture for Hadoop: IBM InfoSphere BigInsights Reference Architecture
    1. Introduction
    2. Business problem and business value
    3. Reference architecture use
    4. Requirements
    5. InfoSphere BigInsights predefined configuration
    6. InfoSphere BigInsights HBase predefined configuration
    7. Deployment considerations
    8. Customizing the predefined configurations
    9. Predefined configuration bill of materials
    10. References
    11. The team who wrote this paper
    12. Now you can become a published author, too!
    13. Stay connected to IBM Redbooks
  31. Notices
    1. Trademarks