z/OS Version 2 Release 3 TSO/E User's Guide IBM SA32-0971-30 Note Before using this information and the product it supports, read the information in “Notices” on page 213. This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-02-16 © Copyright International Business Machines Corporation 1988, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures....................................................................................................... ix List of Tables........................................................................................................ xi About this document...........................................................................................xiii Who should use this document.................................................................................................................xiii How this document is organized............................................................................................................... xiii How to use this document.........................................................................................................................xiii Where to find more information................................................................................................................ xiii How to send your comments to IBM......................................................................xv If you have a technical problem.................................................................................................................xv Summary of changes...........................................................................................xvi Summary of changes for z/OS Version 2 Release 3 (V2R3)..................................................................... xvi z/OS Version 2 Release 1 summary of changes....................................................................................... xvi Part 1. General TSO/E Functions............................................................................ 1 Chapter 1. Beginning a TSO/E Session........................................................................................................3 Learning About Your Terminal................................................................................................................3 Logging On With the LOGON Command.................................................................................................3 Issuing the LOGON Command..........................................................................................................3 Interacting With TSO/E...........................................................................................................................5 Messages...........................................................................................................................................5 Interrupting a Process...................................................................................................................... 7 Ending a TSO/E Session..........................................................................................................................8 Chapter 2. Basic Concepts.........................................................................................................................11 Communicating With MVS....................................................................................................................11 Using TSO/E Commands...................................................................................................................... 12 Using Command Operands.............................................................................................................12 Abbreviating Commands and Keyword Operands......................................................................... 13 Separating Words in a Command................................................................................................... 14 Continuing a Command on Another Line........................................................................................14 Including Comments...................................................................................................................... 15 Using Subcommands...................................................................................................................... 15 Issuing TSO/E Commands..............................................................................................................16 Getting Help for Commands........................................................................................................... 17 Listing All TSO/E Commands.......................................................................................................... 17 List of TSO/E Commands................................................................................................................ 19 Using Data Sets.................................................................................................................................... 20 TSO/E Data Set Naming Rules and Conventions............................................................................20 Entering Data Set Names................................................................................................................22 Chapter 3. Communicating With Other Users...........................................................................................25 Sending Short Messages - SEND Command........................................................................................25 Sending a Message to Specific Users.............................................................................................25 Specifying When a User Will Receive a Message........................................................................... 26 Sending a Message to the Master Console Operator.....................................................................27 Sending Messages to a Specific Operator or Operator Console....................................................27 Security Considerations When Sending Messages........................................................................ 28 Displaying System Messages - LISTBC Command..............................................................................28 iii Sending Messages with the TRANSMIT Command.............................................................................29 Transmitting a Message..................................................................................................................29 Transmitting to More than One Person.......................................................................................... 30 Using Nicknames and the Names Data Set......................................................................................... 30 Example of a Names Data Set........................................................................................................ 32 Receiving Transmitted Messages with the RECEIVE Command.........................................................33 Storing Transmitted Data in a Log........................................................................................................34 Part 2. Using Data Sets........................................................................................ 37 Chapter 4. Allocating Data Sets.................................................................................................................39 What is Allocation?...............................................................................................................................39 Security Considerations When Allocating Data Sets..................................................................... 39 Deallocating Data Sets....................................................................................................................39 Explicit and Implicit Allocation.......................................................................................................40 Using the ALLOCATE Command...........................................................................................................40 Providing Input to a Program..........................................................................................................40 Accessing an Existing Data Set.......................................................................................................41 Accessing More Than One Data Set - Concatenation.................................................................... 42 Allocating and Accessing UNIX Files..............................................................................................44 Directing Output From a Program.................................................................................................. 46 Creating a Non-VSAM Data Set.......................................................................................................48 Example of Allocating Data Sets to a Utility Program....................................................................51 Using ISPF/PDF to Allocate Data Sets................................................................................................. 53 Specifying a Data Set Name..........................................................................................................