IBM zPDT Guide and Reference

IBM zPDT Guide and Reference

by Bill Ogden
Released December 2017
Publisher(s): IBM Redbooks
ISBN: 9780738442891

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

Abstract

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 changes
  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 zPDT differences
    8. 2.8 zPDT releases
      1. 2.8.1 Version 1 Release 8 (December 2017)
      2. 2.8.2 Version 1 Release 7 (March 2017)
      3. 2.8.3 Version 1 Release 6 (March 2015)
      4. 2.8.4 Version 1 Release 5 (February 2014)
      5. 2.8.5 Version 1 Release 4, and fix pack 1 (December 2012, May 2013)
      6. 2.8.6 Version 1 Release 3 (March 2012)
      7. 2.8.7 Version 1 Release 2 (June 2011)
      8. 2.8.8 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_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 hckd2ckd and hfba2fba commands
      33. 4.1.33 The interrupt command
      34. 4.1.34 The ipl command
      35. 4.1.35 The ipl_dvd command
      36. 4.1.36 The ldk_server_config command
      37. 4.1.37 The listVtoc command
      38. 4.1.38 The loadparm command
      39. 4.1.39 The managelogs command
      40. 4.1.40 The memld command
      41. 4.1.41 The mount_dvd command
      42. 4.1.42 The msgInfo command
      43. 4.1.43 The oprmsg command
      44. 4.1.44 The pdsUtil command
      45. 4.1.45 The query command
      46. 4.1.46 The query_license command
      47. 4.1.47 The rassummary command
      48. 4.1.48 The ready command
      49. 4.1.49 The restart command
      50. 4.1.50 The scsi2tape command
      51. 4.1.51 The SecureUpdateUtility command
      52. 4.1.52 The SecureUpdate_authority command
      53. 4.1.53 The senderrdata command
      54. 4.1.54 The serverconfig command
      55. 4.1.55 The serverconfig_cli command
      56. 4.1.56 The settod command
      57. 4.1.57 The snapdump command
      58. 4.1.58 The st command
      59. 4.1.59 The start command
      60. 4.1.60 The stop command
      61. 4.1.61 The storestatus command
      62. 4.1.62 The storestop command
      63. 4.1.63 The stpserverstart command
      64. 4.1.64 The stpserverstop command
      65. 4.1.65 The stpserverquery command
      66. 4.1.66 The sys_reset command
      67. 4.1.67 The tape2file command
      68. 4.1.68 The tape2scsi command
      69. 4.1.69 The tape2tape command
      70. 4.1.70 The tapeCheck command
      71. 4.1.71 The tapePrint command
      72. 4.1.72 The token command
      73. 4.1.73 The txt2card command
      74. 4.1.74 The uimcheck command
      75. 4.1.75 The uimreset command
      76. 4.1.76 The uimserverstart command
      77. 4.1.77 The uimserverstop command
      78. 4.1.78 The Z1090_ADCD_install and Z1091_ADCD_install commands
      79. 4.1.79 The Z1090_token_update and Z1091_token_update commands
      80. 4.1.80 The Z1090_removall command
      81. 4.1.81 The z1090instcheck command
      82. 4.1.82 The z1090term command
      83. 4.1.83 The z1090ver and z1091ver command
      84. 4.1.84 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 TN3270e clients
      1. 5.3.1 x3270 keyboard maps
    4. 5.4 Installing zPDT software
      1. 5.4.1 Alter Linux files
    5. 5.5 Token activation and zPDT serial numbers
    6. 5.6 Starting your new zPDT system
    7. 5.7 Installing a different zPDT release
    8. 5.8 IBM OpenClient special case
  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 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
    6. 7.6 Performance problems
      1. 7.6.1 Jumbo frames
      2. 7.6.2 Investigating lan performance problems
    7. 7.7 Wireless connections
    8. 7.8 Telnet to z/OS UNIX system services
    9. 7.9 Choices
    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 Shared Ethernet adapters
    15. 7.15 Base Linux LAN notes
    16. 7.16 Ethernet SNA
    17. 7.17 NFS and SMB
  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 Gen1 token activation and renewal
      1. 8.11.1 Overview of Gen1 token updates
      2. 8.11.2 Gen1 token license update details (1090 tokens)
    12. 8.12 Summary of relevant zPDT commands and files
    13. 8.13 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
    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 Maintenance for AD-CD z/OS systems
    2. 12.2 z/OS CP and memory display
    3. 12.3 Excessive Health Checker messages
    4. 12.4 z/OS spin loop timeouts
    5. 12.5 Larger 3270 display
    6. 12.6 z/OS disk STORAGE space
    7. 12.7 Stand-alone z/OS dump
      1. 12.7.1 Generating a stand-alone dump program
      2. 12.7.2 Stand-alone dump output dataset
      3. 12.7.3 Operating a stand-alone z/OS dump
    8. 12.8 Moving 3390 volumes
      1. 12.8.1 Create a source dump
      2. 12.8.2 Send dump to Linux
      3. 12.8.3 Receive dump
    9. 12.9 IODF Changes with zPDT
    10. 12.10 Local printing
      1. 12.10.1 Setup
      2. 12.10.2 Operational technique
    11. 12.11 SYS1.LOGREC full
    12. 12.12 Lost MVS console
    13. 12.13 Unable to start ISPF
    14. 12.14 Customized Offering Driver (COD)
      1. 12.14.1 TCP/IP connection
    15. 12.15 WLM and AD-CD
    16. 12.16 RMF Monitor III
    17. 12.17 OTELNET
    18. 12.18 Compressing PARMLIB
    19. 12.19 Burning 3390 volumes on CD
    20. 12.20 Delete logstreams
    21. 12.21 SMF
    22. 12.22 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 Read-only and shared DASD
      1. 13.4.1 Shared read-only volumes
    5. 13.5 Very large PC memory
    6. 13.6 Token dates and times
    7. 13.7 Typing OPRMSG too many times
    8. 13.8 Important Linux command window
    9. 13.9 Linux “out of memory”
    10. 13.10 The crontab and sudo entries
    11. 13.11 Dynamic configuration changes
    12. 13.12 Security exposures
      1. 13.12.1 Reducing root usage
      2. 13.12.2 Linux suid use
      3. 13.12.3 Gen1 token server monitoring
    13. 13.13 z1090instcheck
    14. 13.14 zPDT build information
    15. 13.15 CKD versioning
    16. 13.16 1090 messages
    17. 13.17 TCP/UDP ports
    18. 13.18 Remote operation
    19. 13.19 Many zPDT devices
    20. 13.20 Startup scripts
    21. 13.21 Suspend and Hibernation
    22. 13.22 Channel connections
    23. 13.23 x3270 scripting
    24. 13.24 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.4.5 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 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: December 2017
  • Publisher(s): IBM Redbooks
  • ISBN: 9780738442891