IBM zPDT Guide and Reference

IBM zPDT Guide and Reference

by Bill Ogden
Released May 2019
Publisher(s): IBM Redbooks
ISBN: 9780738457703

Read it now on the O’Reilly learning platform with a 10-day free trial.

O’Reilly members get unlimited access to books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial

Book description

This IBM® Redbooks® publication provides both introductory information and technical details about 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®) can be run on it. zPDT provides the basic System z architecture and emulated IBM 3390 disk drives, 3270 interfaces, OSA interfaces, and so on.

The systems that are discussed in this document are complex. They have 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. The reader is assumed to be 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.

Table of contents

  1. Front cover
  2. Notices
    1. Trademarks
  3. Preface
    1. Authors
    2. Comments welcome
    3. Stay connected to IBM Redbooks
  4. Chapter 1. Introduction
    1. 1.1 General architecture
    2. 1.2 zPDT security, integrity, and RAS concepts
    3. 1.3 Terminology
    4. 1.4 PC choices
    5. 1.5 Installation and operation
  5. Chapter 2. Function, releases, content
    1. 2.1 z System characteristics
      1. 2.1.1 Architecture levels
    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 z System 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 ISV zPDT and zD&T differences
    8. 2.8 zPDT releases
      1. 2.8.1 Version 1 Release 9 (1Q2019)
      2. 2.8.2 Version 1 Release 8 (December 2017)
      3. 2.8.3 Version 1 Release 7 (March 2017)
      4. 2.8.4 Version 1 Release 6 (March 2015)
      5. 2.8.5 Version 1 Release 5 (February 2014)
      6. 2.8.6 Version 1 Release 4, and fix pack 1 (December 2012, May 2013)
      7. 2.8.7 Version 1 Release 3 (March 2012)
      8. 2.8.8 Version 1 Release 2 (June 2011)
      9. 2.8.9 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.2.3 zEDC 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_destroy command
      6. 4.1.6 The ap_query command
      7. 4.1.7 The ap_von and ap_voff commands
      8. 4.1.8 The ap_vpd command
      9. 4.1.9 The ap_zeroize command
      10. 4.1.10 The attn command
      11. 4.1.11 The aws_bashrc and aws_sysctl commands
      12. 4.1.12 The aws_findlinuxtape command
      13. 4.1.13 The aws_tapeInit command
      14. 4.1.14 The aws_tapeInsp command
      15. 4.1.15 The awsckmap command
      16. 4.1.16 The awsin command
      17. 4.1.17 The awsmount command
      18. 4.1.18 The awsstart command
      19. 4.1.19 The awsstat command
      20. 4.1.20 The awsstop command
      21. 4.1.21 The card2tape command
      22. 4.1.22 The card2txt command
      23. 4.1.23 The ckdPrint command
      24. 4.1.24 The clientconfig command
      25. 4.1.25 The clientconfig_authority command
      26. 4.1.26 The clientconfig_cli command
      27. 4.1.27 The cpu command
      28. 4.1.28 The d command
      29. 4.1.29 The display_gen2_acclog command
      30. 4.1.30 The fbaPrint command
      31. 4.1.31 The find_io command
      32. 4.1.32 The gen2_init command
      33. 4.1.33 The hckd2ckd and hfba2fba commands
      34. 4.1.34 The interrupt command
      35. 4.1.35 The ipl command
      36. 4.1.36 The ipl_dvd command
      37. 4.1.37 The ldk_server_config command
      38. 4.1.38 The listVtoc command
      39. 4.1.39 The loadparm command
      40. 4.1.40 The managelogs command
      41. 4.1.41 The memld command
      42. 4.1.42 The mount_dvd command
      43. 4.1.43 The msgInfo command
      44. 4.1.44 The oprmsg command
      45. 4.1.45 The pdsUtil command
      46. 4.1.46 The query command
      47. 4.1.47 The query_license command
      48. 4.1.48 The rassummary command
      49. 4.1.49 The ready command
      50. 4.1.50 The request_license command
      51. 4.1.51 The restart command
      52. 4.1.52 The scsi2tape command
      53. 4.1.53 The SecureUpdateUtility command
      54. 4.1.54 The SecureUpdate_authority command
      55. 4.1.55 The senderrdata command
      56. 4.1.56 The serverconfig command
      57. 4.1.57 The serverconfig_cli command
      58. 4.1.58 The settod command
      59. 4.1.59 The snapdump command
      60. 4.1.60 The st command
      61. 4.1.61 The start command
      62. 4.1.62 The stop command
      63. 4.1.63 The storestatus command
      64. 4.1.64 The storestop command
      65. 4.1.65 The stpserverstart command
      66. 4.1.66 The stpserverstop command
      67. 4.1.67 The stpserverquery command
      68. 4.1.68 The sys_reset command
      69. 4.1.69 The tape2file command
      70. 4.1.70 The tape2scsi command
      71. 4.1.71 The tape2tape command
      72. 4.1.72 The tapeCheck command
      73. 4.1.73 The tapePrint command
      74. 4.1.74 The token command
      75. 4.1.75 The txt2card command
      76. 4.1.76 The uimcheck command
      77. 4.1.77 The uimreset command
      78. 4.1.78 The uimserverstart command
      79. 4.1.79 The uimserverstop command
      80. 4.1.80 The update_license command
      81. 4.1.81 The Z1090_ADCD_install and Z1091_ADCD_install commands
      82. 4.1.82 The Z1090_token_update and Z1091_token_update commands
      83. 4.1.83 The Z1090_removall command
      84. 4.1.84 The z1090instcheck command
      85. 4.1.85 The z1090term command
      86. 4.1.86 The z1090ver and z1091ver command
      87. 4.1.87 The zpdtSecureUpdate command
  8. Chapter 5. zPDT installation
    1. 5.1 Installation overview
      1. 5.1.1 Disk planning
    2. 5.2 Linux installation
      1. 5.2.1 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 Starting your new zPDT system
    6. 5.6 TN3270e clients
      1. 5.6.1 x3270 keyboard maps
    7. 5.7 Installing a different zPDT release
  9. Chapter 6. AD-CD installation
    1. 6.1 General principles
    2. 6.2 z System operating systems
      1. 6.2.1 Media
    3. 6.3 Installing a z/OS AD-CD system
      1. 6.3.1 Specific installation instructions
      2. 6.3.2 IODF device numbers
      3. 6.3.3 zPDT control files
      4. 6.3.4 IPL and operation
      5. 6.3.5 Shutting down
      6. 6.3.6 Startup messages
      7. 6.3.7 Local volumes
    4. 6.4 Multiple operating systems
  10. Chapter 7. LANs
    1. 7.1 Overview of LAN usage
      1. 7.1.1 Three 3270 interfaces
    2. 7.2 OSA paths
    3. 7.3 Scenarios
    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 Investigating lan problems
    6. 7.6 Performance problems
      1. 7.6.1 Jumbo frames
    7. 7.7 Local connections to z/OS TCPIP
    8. 7.8 Choices
    9. 7.9 Automatic configuration
    10. 7.10 Useful z/OS networking commands
    11. 7.11 Non-QDIO operation
    12. 7.12 More complete QDIO example
    13. 7.13 VLAN usage
    14. 7.14 Base Linux LAN notes
    15. 7.15 Ethernet SNA
    16. 7.16 NFS and SMB
    17. 7.17 Conflicts with z/VM
  11. Chapter 8. zPDT licenses
    1. 8.1 Basic Concepts
      1. 8.1.1 Types of tokens and licenses
    2. 8.2 Using a local zPDT system
    3. 8.3 UIM usage details
    4. 8.4 General zPDT client and server details
    5. 8.5 Client Installation and configuration for remote servers
      1. 8.5.1 Gen1 client configuration
      2. 8.5.2 Gen2 client configuration
      3. 8.5.3 Client UIM configuration
    6. 8.6 Server installation and configuration
      1. 8.6.1 UIM server
      2. 8.6.2 Gen1 License server
      3. 8.6.3 Gen2 License server
    7. 8.7 General Notes
      1. 8.7.1 Firewalls
      2. 8.7.2 Disk and Linux changes
      3. 8.7.3 Backup servers
      4. 8.7.4 Cloning zPDT
      5. 8.7.5 Removing functions
      6. 8.7.6 License expiration notification
    8. 8.8 Scenarios
      1. 8.8.1 Display serial number assignments
      2. 8.8.2 Security
      3. 8.8.3 Resetting UIM
      4. 8.8.4 SafeNet module restarts
      5. 8.8.5 Gen2 servers
    9. 8.9 Server search
    10. 8.10 Numbers
    11. 8.11 Dedicated key server
    12. 8.12 Gen1 token activation and renewal
      1. 8.12.1 Overview of Gen1 token updates
      2. 8.12.2 Gen1 token license update details (1090 tokens)
    13. 8.13 Summary of relevant zPDT commands and files
    14. 8.14 License manager glossary
  12. Chapter 9. Other System z Operating Systems
    1. 9.1 z/VSE
    2. 9.2 Linux for z Systems
    3. 9.3 z/VM
    4. 9.4 Installing the AD-CD z/VM 6.4 system
      1. 9.4.1 zPDT devmap
      2. 9.4.2 zPDT sensitivity
    5. 9.5 IPL and logon
    6. 9.6 Quick z/VM review
      1. 9.6.1 CMS
      2. 9.6.2 User MAINT
      3. 9.6.3 Minidisks and files
      4. 9.6.4 Inspecting your disks
      5. 9.6.5 XEDIT
      6. 9.6.6 z/VM directory
      7. 9.6.7 Spool contents
      8. 9.6.8 Simple system queries
      9. 9.6.9 zIIPs and zAAPs
      10. 9.6.10 Paging
      11. 9.6.11 Simple network adjustments
    7. 9.7 z/TPF
  13. Chapter 10. Multiple instances and guests
    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 How much storage for z/OS?
    2. 12.2 zEDC emulation
    3. 12.3 Maintenance for AD-CD z/OS systems
    4. 12.4 z/OS CP and memory display
    5. 12.5 Java performance
    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 STORAGE space
    10. 12.10 Stand-alone z/OS dump
      1. 12.10.1 Generating a stand-alone dump program
      2. 12.10.2 Stand-alone dump output dataset
      3. 12.10.3 Operating a stand-alone z/OS dump
    11. 12.11 Moving 3390 volumes
      1. 12.11.1 Create a source dump
      2. 12.11.2 Send dump to Linux
      3. 12.11.3 Receive dump
    12. 12.12 IODF Changes with zPDT
    13. 12.13 Many COBOL Compilations
    14. 12.14 Local printing
      1. 12.14.1 Setup
      2. 12.14.2 Operational technique
    15. 12.15 SYS1.LOGREC full
    16. 12.16 Lost MVS console
    17. 12.17 Unable to start ISPF
    18. 12.18 Customized Offering Driver (COD)
      1. 12.18.1 TCP/IP connection
    19. 12.19 WLM and AD-CD
    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 Free zIIPs”
    2. 13.2 PC Hyper-Threading
    3. 13.3 cpuopt statement
    4. 13.4 Copying DASD volumes
    5. 13.5 Read-only and shared DASD
      1. 13.5.1 Shared read-only volumes
    6. 13.6 zPDT log files
    7. 13.7 Very large PC memory
    8. 13.8 Token dates and times
    9. 13.9 Typing OPRMSG too many times
    10. 13.10 Important Linux command window
    11. 13.11 Linux “out of memory”
    12. 13.12 The crontab and sudo entries
    13. 13.13 Dynamic configuration changes
    14. 13.14 Security exposures
      1. 13.14.1 Reducing root usage
      2. 13.14.2 Linux suid use
      3. 13.14.3 Gen1 token server monitoring
    15. 13.15 z1090instcheck
    16. 13.16 zPDT build information
    17. 13.17 CKD versioning
    18. 13.18 zPDT messages
    19. 13.19 TCP/UDP ports
    20. 13.20 Remote operation
    21. 13.21 Many zPDT devices
    22. 13.22 Startup scripts
    23. 13.23 Suspend and Hibernation
    24. 13.24 Channel connections
    25. 13.25 Channel measurement blocks
    26. 13.26 x3270 scripting
    27. 13.27 Scenarios for awstape
      1. 13.27.1 Create a new labelled tape volume
      2. 13.27.2 Quick SL volume creation
      3. 13.27.3 Use an existing labelled tape
      4. 13.27.4 Automatically premount existing labelled tape
      5. 13.27.5 Use special CCWs to manipulate tape volume
      6. 13.27.6 Premounted tape
  17. Chapter 14. Tape drives and tapes
    1. 14.1 The awsscsi device manager
    2. 14.2 Parallel SCSI adapters
      1. 14.2.1 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
      1. 14.5.1 awstape utilities
    6. 14.6 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 CSF
    5. 17.5 Very basic dataset encryption example
      1. 17.5.1 z/VM usage
  21. Chapter 18. Virtualization
  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 Special problem-related commands
    7. 19.7 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. Appendix A. FAQ
  25. Related publications
    1. IBM Redbooks
    2. Other References
    3. Help from IBM
  26. Back cover

Product information

  • Title: IBM zPDT Guide and Reference
  • Author(s): Bill Ogden
  • Release date: May 2019
  • Publisher(s): IBM Redbooks
  • ISBN: 9780738457703