O'Reilly logo

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

IBM zPDT Guide and Reference: System z Personal Development Tool

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. Now you can become a published author, too!
    3. Comments welcome
    4. 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
    4. 1.4 Quick start (GA7)
  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 7 (March 2017)
      2. 2.8.2 Version 1 Release 6 (March 2015)
      3. 2.8.3 Version 1 Release 5 (February 2014)
      4. 2.8.4 Version 1 Release 4, and fix pack 1 (December 2012, May 2013)
      5. 2.8.5 Version 1 Release 3 (March 2012)
      6. 2.8.6 Version 1 Release 2 (June 2011)
      7. 2.8.7 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 STP 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 Ordering requirements
    2. 5.2 Installation overview
      1. 5.2.1 Disk planning
    3. 5.3 Linux installation
      1. 5.3.1 Other Linux notes
    4. 5.4 TN3270e clients
      1. 5.4.1 x3270 keyboard maps
    5. 5.5 Installing zPDT software
      1. 5.5.1 Alter Linux files
    6. 5.6 Token activation and zPDT serial numbers
    7. 5.7 Starting your new zPDT system
    8. 5.8 Installing a different zPDT release
    9. 5.9 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
      9. 7.5.9 Performance problems
      10. 7.5.10 Addressing lan 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 z/OS networking commands
    10. 7.10 Non-QDIO operation
    11. 7.11 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
    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 Starting all over
      2. 8.7.2 Backup license servers
      3. 8.7.3 Firewalls
      4. 8.7.4 Disk and Linux changes
      5. 8.7.5 Cloning zPDT
      6. 8.7.6 Removing functions
      7. 8.7.7 License expiration notification
    8. 8.8 Scenarios
      1. 8.8.1 Local to remote server
      2. 8.8.2 Temporarily switch from server to local
      3. 8.8.3 Remote server to local
      4. 8.8.4 Using zPDT on the license/UIM server (Gen1)
      5. 8.8.5 Switch tokens (Gen1)
      6. 8.8.6 Change from single token to multiple tokens (Gen1)
      7. 8.8.7 Display serial number assignments
      8. 8.8.8 Security
      9. 8.8.9 Resetting UIM
      10. 8.8.10 SafeNet module restarts
      11. 8.8.11 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.3 system
      1. 9.4.1 zPDT devmap
    5. 9.5 IPL and logon
      1. 9.5.1 Shutdown
    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. 9.13 Installing z/VM 6.4 from distribution media
      1. 9.13.1 Using another z/VM 6.4
    14. 9.14 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 Restrictions
    2. 11.2 Sample z/VM script
    3. 11.3 z/OS use
      1. 11.3.1 Sample z/OS program for awscmd
  15. Chapter 12. Minor z/OS notes
    1. 12.1 Disabled wait delay
    2. 12.2 IEBCOPY problems
    3. 12.3 Maintenance for AD-CD z/OS systems
    4. 12.4 z/OS CP and memory display
    5. 12.5 Excessive Health Checker messages
    6. 12.6 z/OS spin loop timeouts
    7. 12.7 Larger 3270 display
    8. 12.8 z/OS disk space
    9. 12.9 Stand-alone z/OS dump
      1. 12.9.1 Generating a stand-alone dump program
      2. 12.9.2 Stand-alone dump output
      3. 12.9.3 Operating a stand-alone z/OS dump
    10. 12.10 Moving 3390 volumes
      1. 12.10.1 Create a source dump
      2. 12.10.2 Send dump to Linux
      3. 12.10.3 Receive dump
    11. 12.11 IODF Changes with zPDT
    12. 12.12 Local printing
      1. 12.12.1 Background
      2. 12.12.2 Using a PC printer
      3. 12.12.3 Setup
      4. 12.12.4 Operational technique
    13. 12.13 SYS1.LOGREC full
    14. 12.14 Lost MVS console
    15. 12.15 Unable to start ISPF
    16. 12.16 Health Checker
    17. 12.17 WLM and AD-CD
    18. 12.18 RMF Monitor III
    19. 12.19 OTELNET
    20. 12.20 Compressing PARMLIB
    21. 12.21 Burning 3390 volumes on CD
    22. 12.22 Delete log streams
    23. 12.23 SMF
    24. 12.24 Disabled waits
  16. Chapter 13. Additional zPDT notes
    1. 13.1 Read-only and shared DASD
      1. 13.1.1 Shared read-only volumes
    2. 13.2 Very large PC memory
    3. 13.3 Token dates and times
    4. 13.4 Typing OPRMSG too many times
    5. 13.5 Important Linux command window
    6. 13.6 Linux “out of memory”
    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 Gen1 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 Many zPDT devices
    18. 13.18 Startup scripts
    19. 13.19 Suspend and Hibernation
    20. 13.20 Channel connections
    21. 13.21 x3270 scripting
    22. 13.22 Premounted tape
  17. Chapter 14. Tape drives and tapes
    1. 14.1 The awsscsi device manager
      1. 14.1.1 Determine st and sg numbers
      2. 14.1.2 Permissions
      3. 14.1.3 Block counts
    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
      1. 15.8.1 Linux volumes
      2. 15.8.2 Multiple TCP/IP stacks
      3. 15.8.3 Typical client usage
      4. 15.8.4 Migrating a list of volumes
  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
      2. 16.2.2 Description
  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 License servers
    2. 18.2 Disk configurations
    3. 18.3 Performance
  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
      1. 19.5.1 Special problem-related commands
    6. 19.6 Linux monitoring
  23. Chapter 20. Server Time Protocol
    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