Time Sharing Option

Embed Size (px)

Citation preview

  • 7/31/2019 Time Sharing Option

    1/471

    z/OS

    TSO/E

    Command Reference

    SA22-7782-12

  • 7/31/2019 Time Sharing Option

    2/471

  • 7/31/2019 Time Sharing Option

    3/471

    z/OS

    TSO/E

    Command Reference

    SA22-7782-12

  • 7/31/2019 Time Sharing Option

    4/471

    Note

    Before using this information and the product it supports, be sure to read the general information under Notices on page419.

    Thirteenth Edition, April 2010

    This edition applies to Version 1, Release 11 of z/OS (5694-A01) and to all subsequent releases and modificationsuntil otherwise indicated in new editions.

    This is a major revision of SA22-7782-11.

    IBM welcomes your comments. A form for readers' comments may be provided at the back of this document, or youmay address your comments to the following address:

    International Business Machines CorporationMHVRCFS, Mail Station P1812455 South RoadPoughkeepsie, NY 12601-5400United States of America

    FAX (United States & Canada): 1+845+432-9405FAX (Other Countries):

    Your International Access Code +1+845+432-9405

    IBMLink (United States customers only): IBMUSM10(MHVRCFS)Internet e-mail: [email protected] Wide Web: http://www.ibm.com/systems/z/os/zos/webqs.html

    If you would like a reply, be sure to include your name, address, telephone number, or FAX number.

    Make sure to include the following in your comment or note:v Title and order number of this document

    v Page number or topic related to your comment

    When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in anyway it believes appropriate without incurring any obligation to you.

    Copyright IBM Corporation 1988, 2010.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

    http://www.ibm.com/systems/z/os/zos/webqs.htmlhttp://www.ibm.com/systems/z/os/zos/webqs.html
  • 7/31/2019 Time Sharing Option

    5/471

    Contents

    Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

    Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

    About this document . . . . . . . . . . . . . . . . . . . . . xviiWho should use this document. . . . . . . . . . . . . . . . . . . xviiHow this document is organized . . . . . . . . . . . . . . . . . . xviiWhere to find more information . . . . . . . . . . . . . . . . . . xviiThe z/OS Basic Skills Information Center. . . . . . . . . . . . . . . xviiiHow to read syntax diagrams . . . . . . . . . . . . . . . . . . . xviii

    Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . xviiiSyntax items . . . . . . . . . . . . . . . . . . . . . . . . xviiiSyntax examples . . . . . . . . . . . . . . . . . . . . . . . xix

    Summary of changes . . . . . . . . . . . . . . . . . . . . . . xxi

    Chapter 1. TSO/E commands and subcommands . . . . . . . . . . . 1

    Using a TSO/E command . . . . . . . . . . . . . . . . . . . . . 16Positional operands . . . . . . . . . . . . . . . . . . . . . . 16Keyword operands . . . . . . . . . . . . . . . . . . . . . . 16

    How to read the TSO/E command syntax . . . . . . . . . . . . . . . 17Abbreviating keyword operands. . . . . . . . . . . . . . . . . . 19Comments . . . . . . . . . . . . . . . . . . . . . . . . . 19Line continuation . . . . . . . . . . . . . . . . . . . . . . . 20Delimiters . . . . . . . . . . . . . . . . . . . . . . . . . . 20

    Using the HELP command . . . . . . . . . . . . . . . . . . . . 21Explanations of commands . . . . . . . . . . . . . . . . . . . 21Syntax interpretation of HELP information . . . . . . . . . . . . . . 21Explanations of subcommands . . . . . . . . . . . . . . . . . . 21

    Using commands for VSAM and Non-VSAM data sets . . . . . . . . . . 21TSO/E commands and subcommands . . . . . . . . . . . . . . . . 22Summary of TSO/E commands . . . . . . . . . . . . . . . . . . . 22ALLOCATE command . . . . . . . . . . . . . . . . . . . . . . 24

    Data sets with SMS . . . . . . . . . . . . . . . . . . . . . . 24Allocating non-SMS-managed data sets. . . . . . . . . . . . . . . 25Allocating z/OS UNIX data sets . . . . . . . . . . . . . . . . . . 26ALLOCATE command syntax . . . . . . . . . . . . . . . . . . 26ALLOCATE command operands . . . . . . . . . . . . . . . . . 29ALLOCATE command return codes . . . . . . . . . . . . . . . . 57ALLOCATE command examples . . . . . . . . . . . . . . . . . 57

    ALTLIB command . . . . . . . . . . . . . . . . . . . . . . . . 62Search order for libraries . . . . . . . . . . . . . . . . . . . . 62

    Using ALTLIB with most applications . . . . . . . . . . . . . . . . 63Using ALTLIB with concurrent applications . . . . . . . . . . . . . . 63Using ALTLIB in ISPF . . . . . . . . . . . . . . . . . . . . . 63Using ALTLIB in the IPCS dialog . . . . . . . . . . . . . . . . . 64Stacking Application-Level library requests. . . . . . . . . . . . . . 65ALTLIB command syntax . . . . . . . . . . . . . . . . . . . . 65ALTLIB command operands . . . . . . . . . . . . . . . . . . . 66ALTLIB command return codes . . . . . . . . . . . . . . . . . . 69ALTLIB command examples . . . . . . . . . . . . . . . . . . . 69

    ATTRIB command. . . . . . . . . . . . . . . . . . . . . . . . 69ATTRIB command syntax . . . . . . . . . . . . . . . . . . . . 70

    Copyright IBM Corp. 1988, 2010 iii

  • 7/31/2019 Time Sharing Option

    6/471

    ATTRIB command operands . . . . . . . . . . . . . . . . . . . 71ATTRIB command return codes. . . . . . . . . . . . . . . . . . 76ATTRIB command examples . . . . . . . . . . . . . . . . . . . 76

    CALL command . . . . . . . . . . . . . . . . . . . . . . . . 77CALL command in the background . . . . . . . . . . . . . . . . 77CALL command syntax . . . . . . . . . . . . . . . . . . . . . 78CALL command operands . . . . . . . . . . . . . . . . . . . . 78

    CALL command return codes . . . . . . . . . . . . . . . . . . 79CALL command examples. . . . . . . . . . . . . . . . . . . . 80

    CANCEL command . . . . . . . . . . . . . . . . . . . . . . . 81CANCEL command syntax . . . . . . . . . . . . . . . . . . . 81CANCEL command operands . . . . . . . . . . . . . . . . . . 81CANCEL command return codes . . . . . . . . . . . . . . . . . 82CANCEL command examples . . . . . . . . . . . . . . . . . . 82

    DELETE command . . . . . . . . . . . . . . . . . . . . . . . 83DELETE command syntax. . . . . . . . . . . . . . . . . . . . 83DELETE command operands . . . . . . . . . . . . . . . . . . 84DELETE command return codes . . . . . . . . . . . . . . . . . 86DELETE command example . . . . . . . . . . . . . . . . . . . 86

    EDIT command. . . . . . . . . . . . . . . . . . . . . . . . . 87

    EDIT command syntax . . . . . . . . . . . . . . . . . . . . . 87EDIT command operands . . . . . . . . . . . . . . . . . . . . 88EDIT command return codes . . . . . . . . . . . . . . . . . . . 93EDIT command examples . . . . . . . . . . . . . . . . . . . . 93EDIT subcommands (overview) . . . . . . . . . . . . . . . . . . 94EDITALLOCATE subcommand . . . . . . . . . . . . . . . . . 95EDITATTRIB subcommand . . . . . . . . . . . . . . . . . . 95EDITBOTTOM subcommand . . . . . . . . . . . . . . . . . . 96EDITCHANGE subcommand . . . . . . . . . . . . . . . . . . 96EDITCKPOINT subcommand . . . . . . . . . . . . . . . . . 100EDITCOPY subcommand. . . . . . . . . . . . . . . . . . . 101EDITDELETE subcommand . . . . . . . . . . . . . . . . . . 107

    EDITDOWN subcommand . . . . . . . . . . . . . . . . . . 109EDITEND subcommand . . . . . . . . . . . . . . . . . . . 109EDITEXEC subcommand . . . . . . . . . . . . . . . . . . . 110EDITFIND subcommand . . . . . . . . . . . . . . . . . . . 110EDITFREE subcommand . . . . . . . . . . . . . . . . . . . 111EDITHELP subcommand . . . . . . . . . . . . . . . . . . . 111EDITINPUT subcommand. . . . . . . . . . . . . . . . . . . 111EDITINSERT subcommand . . . . . . . . . . . . . . . . . . 113EDITinsert/replace/delete function. . . . . . . . . . . . . . . . 114EDITLIST subcommand . . . . . . . . . . . . . . . . . . . 116EDITMOVE subcommand. . . . . . . . . . . . . . . . . . . 117EDITPROFILE subcommand . . . . . . . . . . . . . . . . . 122EDITRENUM subcommand . . . . . . . . . . . . . . . . . . 122

    EDITRUN subcommand . . . . . . . . . . . . . . . . . . . 124EDITSAVE subcommand . . . . . . . . . . . . . . . . . . . 126EDITSCAN subcommand . . . . . . . . . . . . . . . . . . . 128EDITSEND subcommand . . . . . . . . . . . . . . . . . . . 130EDITSUBMIT subcommand . . . . . . . . . . . . . . . . . . 130EDITTABSET subcommand . . . . . . . . . . . . . . . . . . 133EDITTOP subcommand . . . . . . . . . . . . . . . . . . . 135EDITUNNUM subcommand . . . . . . . . . . . . . . . . . . 135EDITUP subcommand . . . . . . . . . . . . . . . . . . . . 135EDITVERIFY subcommand . . . . . . . . . . . . . . . . . . 136

    END command . . . . . . . . . . . . . . . . . . . . . . . . 137

    iv z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    7/471

    END command syntax. . . . . . . . . . . . . . . . . . . . . 137END command return code . . . . . . . . . . . . . . . . . . . 137

    EXEC command . . . . . . . . . . . . . . . . . . . . . . . . 137Using EXEC as a subcommand . . . . . . . . . . . . . . . . . 137EXEC command syntax . . . . . . . . . . . . . . . . . . . . 138EXEC command operands . . . . . . . . . . . . . . . . . . . 139Using the explicit form of the EXEC command . . . . . . . . . . . . 142

    Using the (extended) implicit form of the EXEC command . . . . . . . 144Considerations for passing quotation marks . . . . . . . . . . . . . 145EXEC command return codes . . . . . . . . . . . . . . . . . . 146EXEC command examples . . . . . . . . . . . . . . . . . . . 146

    EXECUTIL command . . . . . . . . . . . . . . . . . . . . . . 149Additional considerations for using EXECUTIL . . . . . . . . . . . . 150EXECUTIL command syntax . . . . . . . . . . . . . . . . . . 150EXECUTIL command operands . . . . . . . . . . . . . . . . . 151EXECUTIL command return codes . . . . . . . . . . . . . . . . 155EXECUTIL command examples . . . . . . . . . . . . . . . . . 155

    FREE command . . . . . . . . . . . . . . . . . . . . . . . . 156FREE command syntax . . . . . . . . . . . . . . . . . . . . 156FREE command operands . . . . . . . . . . . . . . . . . . . 157

    FREE command return codes . . . . . . . . . . . . . . . . . . 160FREE command examples . . . . . . . . . . . . . . . . . . . 160

    HELP command . . . . . . . . . . . . . . . . . . . . . . . . 161Information available through HELP. . . . . . . . . . . . . . . . 161HELP command syntax . . . . . . . . . . . . . . . . . . . . 164HELP command operands . . . . . . . . . . . . . . . . . . . 164HELP command return codes . . . . . . . . . . . . . . . . . . 165HELP command examples . . . . . . . . . . . . . . . . . . . 165

    LINK command . . . . . . . . . . . . . . . . . . . . . . . . 166LINK command syntax . . . . . . . . . . . . . . . . . . . . 166LINK command operands . . . . . . . . . . . . . . . . . . . 168LINK command return codes . . . . . . . . . . . . . . . . . . 179

    LINK command examples . . . . . . . . . . . . . . . . . . . 179LISTALC command . . . . . . . . . . . . . . . . . . . . . . . 180LISTALC command syntax . . . . . . . . . . . . . . . . . . . 180LISTALC command operands . . . . . . . . . . . . . . . . . . 180LISTALC command return codes . . . . . . . . . . . . . . . . . 181LISTALC command examples . . . . . . . . . . . . . . . . . . 181

    LISTBC command . . . . . . . . . . . . . . . . . . . . . . . 183LISTBC command syntax . . . . . . . . . . . . . . . . . . . 184LISTBC command operands . . . . . . . . . . . . . . . . . . 184LISTBC command return codes . . . . . . . . . . . . . . . . . 184LISTBC command examples . . . . . . . . . . . . . . . . . . 185

    LISTCAT command . . . . . . . . . . . . . . . . . . . . . . . 185LISTCAT command syntax . . . . . . . . . . . . . . . . . . . 186

    LISTCAT command operands . . . . . . . . . . . . . . . . . . 186LISTCAT command return codes . . . . . . . . . . . . . . . . . 189

    LISTDS command . . . . . . . . . . . . . . . . . . . . . . . 189LISTDS command syntax . . . . . . . . . . . . . . . . . . . 190LISTDS command operands . . . . . . . . . . . . . . . . . . 190LISTDS command return codes . . . . . . . . . . . . . . . . . 191LISTDS command examples . . . . . . . . . . . . . . . . . . 191

    LOADGO command . . . . . . . . . . . . . . . . . . . . . . 192LOADGO command syntax . . . . . . . . . . . . . . . . . . . 192LOADGO command operands . . . . . . . . . . . . . . . . . . 193LOADGO command return codes . . . . . . . . . . . . . . . . 199

    Contents v

    ||

  • 7/31/2019 Time Sharing Option

    8/471

    LOADGO command examples . . . . . . . . . . . . . . . . . . 199LOGOFF command. . . . . . . . . . . . . . . . . . . . . . . 199

    LOGOFF command syntax . . . . . . . . . . . . . . . . . . . 200LOGOFF command operands . . . . . . . . . . . . . . . . . . 200LOGOFF command return codes. . . . . . . . . . . . . . . . . 200LOGOFF command examples . . . . . . . . . . . . . . . . . . 200

    LOGON command . . . . . . . . . . . . . . . . . . . . . . . 200

    Full-Screen LOGON versus line mode LOGON . . . . . . . . . . . 201Full-Screen LOGON processing . . . . . . . . . . . . . . . . . 201LOGON command syntax . . . . . . . . . . . . . . . . . . . 202LOGON command operands . . . . . . . . . . . . . . . . . . 202LOGON command return codes . . . . . . . . . . . . . . . . . 204LOGON command examples . . . . . . . . . . . . . . . . . . 205

    MVSSERV command . . . . . . . . . . . . . . . . . . . . . . 205MVSSERV command syntax . . . . . . . . . . . . . . . . . . 206MVSSERV command operands . . . . . . . . . . . . . . . . . 206MVSSERV command return codes . . . . . . . . . . . . . . . . 206MVSSERV command examples . . . . . . . . . . . . . . . . . 206

    OUTDES command. . . . . . . . . . . . . . . . . . . . . . . 207OUTDES command syntax . . . . . . . . . . . . . . . . . . . 207

    OUTDES command operands . . . . . . . . . . . . . . . . . . 209Coding rules . . . . . . . . . . . . . . . . . . . . . . . . 218OUTDES command return codes. . . . . . . . . . . . . . . . . 219OUTDES command examples . . . . . . . . . . . . . . . . . . 219

    OUTPUT command. . . . . . . . . . . . . . . . . . . . . . . 221OUTPUT command syntax . . . . . . . . . . . . . . . . . . . 222OUTPUT command operands . . . . . . . . . . . . . . . . . . 222Output sequence. . . . . . . . . . . . . . . . . . . . . . . 224Subcommands for the OUTPUT command . . . . . . . . . . . . . 225Checkpointed data set. . . . . . . . . . . . . . . . . . . . . 225OUTPUT command return codes. . . . . . . . . . . . . . . . . 226OUTPUT command examples . . . . . . . . . . . . . . . . . . 226

    OUTPUT subcommands (overview) . . . . . . . . . . . . . . . . . 227OUTPUTCONTINUE subcommand . . . . . . . . . . . . . . . . 227OUTPUTCONTINUE subcommand syntax . . . . . . . . . . . . 227OUTPUTCONTINUE subcommand operands . . . . . . . . . . . 227OUTPUTCONTINUE subcommand examples . . . . . . . . . . . 228

    OUTPUTEND subcommand . . . . . . . . . . . . . . . . . . . 228OUTPUTEND subcommand syntax . . . . . . . . . . . . . . . 228

    OUTPUTHELP subcommand . . . . . . . . . . . . . . . . . . 228OUTPUTSAVE subcommand . . . . . . . . . . . . . . . . . . 228

    OUTPUTSAVE subcommand syntax. . . . . . . . . . . . . . . 228OUTPUTSAVE subcommand operand . . . . . . . . . . . . . . 228OUTPUTSAVE subcommand examples . . . . . . . . . . . . . 229

    PRINTDS command . . . . . . . . . . . . . . . . . . . . . . 229

    Process for the input data set or file . . . . . . . . . . . . . . . 229Output for a data set or file . . . . . . . . . . . . . . . . . . . 230PRINTDS command syntax . . . . . . . . . . . . . . . . . . . 230PRINTDS command operands . . . . . . . . . . . . . . . . . . 232Default values for PRINTDS . . . . . . . . . . . . . . . . . . 240Mutually exclusive operands on PRINTDS . . . . . . . . . . . . . 242PRINTDS command return codes . . . . . . . . . . . . . . . . 242PRINTDS command examples . . . . . . . . . . . . . . . . . 242

    PROFILE command . . . . . . . . . . . . . . . . . . . . . . 244PROFILE command syntax . . . . . . . . . . . . . . . . . . . 245PROFILE command operands . . . . . . . . . . . . . . . . . . 245

    vi z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    9/471

    PROFILE language setting notes . . . . . . . . . . . . . . . . . 248PROFILE foreground/background processing differences . . . . . . . . 248PROFILE command return codes . . . . . . . . . . . . . . . . 250PROFILE command examples . . . . . . . . . . . . . . . . . . 250

    PROTECT command . . . . . . . . . . . . . . . . . . . . . . 251PROTECT command syntax . . . . . . . . . . . . . . . . . . 252PROTECT command operands . . . . . . . . . . . . . . . . . 252

    Passwords . . . . . . . . . . . . . . . . . . . . . . . . . 253Types of access . . . . . . . . . . . . . . . . . . . . . . . 253Password data set . . . . . . . . . . . . . . . . . . . . . . 254PROTECT command return codes . . . . . . . . . . . . . . . . 254PROTECT command examples . . . . . . . . . . . . . . . . . 254

    RECEIVE command . . . . . . . . . . . . . . . . . . . . . . 255RECEIVE command syntax . . . . . . . . . . . . . . . . . . . 255RECEIVE command operands . . . . . . . . . . . . . . . . . . 256RECEIVE command prompt parameters . . . . . . . . . . . . . . 257RECEIVE command prompt parameter syntax . . . . . . . . . . . . 257RECEIVE command prompt parameters . . . . . . . . . . . . . . 258RECEIVE command return codes . . . . . . . . . . . . . . . . 260Receiving data . . . . . . . . . . . . . . . . . . . . . . . 261

    Data set organization . . . . . . . . . . . . . . . . . . . . . 261Receiving PDSE data sets . . . . . . . . . . . . . . . . . . . 261Receiving protected data sets . . . . . . . . . . . . . . . . . . 262Receiving enciphered data . . . . . . . . . . . . . . . . . . . 262Receiving data sets and messages with security labels . . . . . . . . 263RECEIVE command examples . . . . . . . . . . . . . . . . . 263

    RENAME command . . . . . . . . . . . . . . . . . . . . . . 266RENAME command syntax . . . . . . . . . . . . . . . . . . . 266RENAME command operands . . . . . . . . . . . . . . . . . . 266RENAME command return codes . . . . . . . . . . . . . . . . 267RENAME command examples . . . . . . . . . . . . . . . . . . 267

    RUN command . . . . . . . . . . . . . . . . . . . . . . . . 267

    RUN command syntax . . . . . . . . . . . . . . . . . . . . 267RUN command operands . . . . . . . . . . . . . . . . . . . 269Determining compiler type . . . . . . . . . . . . . . . . . . . 271RUN command return codes . . . . . . . . . . . . . . . . . . 271RUN command examples . . . . . . . . . . . . . . . . . . . 271

    SEND command . . . . . . . . . . . . . . . . . . . . . . . . 271SEND command syntax . . . . . . . . . . . . . . . . . . . . 273SEND command operands . . . . . . . . . . . . . . . . . . . 273SEND command return codes . . . . . . . . . . . . . . . . . . 275SEND command examples . . . . . . . . . . . . . . . . . . . 275

    SMCOPY command . . . . . . . . . . . . . . . . . . . . . . 276SMCOPY command syntax . . . . . . . . . . . . . . . . . . . 276SMCOPY command operands . . . . . . . . . . . . . . . . . . 277

    SMCOPY command return codes . . . . . . . . . . . . . . . . 279SMCOPY command examples. . . . . . . . . . . . . . . . . . 279

    SMFIND command . . . . . . . . . . . . . . . . . . . . . . . 279SMFIND command syntax . . . . . . . . . . . . . . . . . . . 279SMFIND command operands . . . . . . . . . . . . . . . . . . 280SMFIND command return codes . . . . . . . . . . . . . . . . . 281SMFIND command examples . . . . . . . . . . . . . . . . . . 281

    SMPUT command . . . . . . . . . . . . . . . . . . . . . . . 281SMPUT command syntax . . . . . . . . . . . . . . . . . . . 281SMPUT command operands . . . . . . . . . . . . . . . . . . 281SMPUT command return codes . . . . . . . . . . . . . . . . . 282

    Contents vii

  • 7/31/2019 Time Sharing Option

    10/471

    SMPUT command examples . . . . . . . . . . . . . . . . . . 282STATUS command . . . . . . . . . . . . . . . . . . . . . . . 282

    STATUS command syntax . . . . . . . . . . . . . . . . . . . 282STATUS command operand . . . . . . . . . . . . . . . . . . 283STATUS command return codes . . . . . . . . . . . . . . . . . 283

    SUBMIT command . . . . . . . . . . . . . . . . . . . . . . . 283SUBMIT command syntax . . . . . . . . . . . . . . . . . . . 284

    SUBMIT command operands . . . . . . . . . . . . . . . . . . 284SUBMIT command return codes . . . . . . . . . . . . . . . . . 287SUBMIT command examples . . . . . . . . . . . . . . . . . . 287

    TERMINAL command . . . . . . . . . . . . . . . . . . . . . . 287TERMINAL command syntax . . . . . . . . . . . . . . . . . . 288TERMINAL command operands . . . . . . . . . . . . . . . . . 288TERMINAL command return codes . . . . . . . . . . . . . . . . 291TERMINAL command examples . . . . . . . . . . . . . . . . . 291

    TEST command . . . . . . . . . . . . . . . . . . . . . . . . 292TEST command syntax . . . . . . . . . . . . . . . . . . . . 293TEST command operands . . . . . . . . . . . . . . . . . . . 293TEST command return codes . . . . . . . . . . . . . . . . . . 295TEST command examples . . . . . . . . . . . . . . . . . . . 295

    TEST subcommands (overview) . . . . . . . . . . . . . . . . . . 297TESTALLOCATE command . . . . . . . . . . . . . . . . . . . 299TESTAND subcommand . . . . . . . . . . . . . . . . . . . . 299

    TESTAND subcommand syntax . . . . . . . . . . . . . . . . 299TESTAND subcommand operands . . . . . . . . . . . . . . . 300TESTAND subcommand examples . . . . . . . . . . . . . . . 301

    Assignment of values function of TEST . . . . . . . . . . . . . . . 302Syntax of values function of TEST . . . . . . . . . . . . . . . . 302Operands of values function of TEST . . . . . . . . . . . . . . . 302Examples of values function of TEST . . . . . . . . . . . . . . . 305

    TESTAT subcommand . . . . . . . . . . . . . . . . . . . . . 306TESTAT subcommand syntax . . . . . . . . . . . . . . . . . 307

    TESTAT subcommand operands . . . . . . . . . . . . . . . . 307TESTAT subcommand examples . . . . . . . . . . . . . . . . 308TESTATTRIB command . . . . . . . . . . . . . . . . . . . . 310TESTCALL subcommand . . . . . . . . . . . . . . . . . . . . 310

    TESTCALL subcommand syntax . . . . . . . . . . . . . . . . 310TESTCALL subcommand operands . . . . . . . . . . . . . . . 310TESTCALL subcommand examples . . . . . . . . . . . . . . . 311

    TESTCANCEL command . . . . . . . . . . . . . . . . . . . . 312TESTCOPY subcommand . . . . . . . . . . . . . . . . . . . 312

    TESTCOPY subcommand syntax. . . . . . . . . . . . . . . . 312TESTCOPY subcommand operands. . . . . . . . . . . . . . . 312TESTCOPY subcommand examples . . . . . . . . . . . . . . 314

    TESTDELETE subcommand . . . . . . . . . . . . . . . . . . 315

    TESTDELETE subcommand syntax . . . . . . . . . . . . . . . 315TESTDELETE subcommand operand . . . . . . . . . . . . . . 315TESTDELETE subcommand examples. . . . . . . . . . . . . . 315

    TESTDROP subcommand . . . . . . . . . . . . . . . . . . . 315TESTDROP subcommand syntax. . . . . . . . . . . . . . . . 316TESTDROP subcommand operand . . . . . . . . . . . . . . . 316TESTDROP subcommand examples . . . . . . . . . . . . . . 316

    TESTEND subcommand . . . . . . . . . . . . . . . . . . . . 316TESTEND subcommand syntax . . . . . . . . . . . . . . . . 316

    TESTEQUATE subcommand . . . . . . . . . . . . . . . . . . 317TESTEQUATE subcommand syntax. . . . . . . . . . . . . . . 317

    viii z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    11/471

    TESTEQUATE subcommand operands. . . . . . . . . . . . . . 317TESTEQUATE subcommand examples . . . . . . . . . . . . . 318

    TESTEXEC command . . . . . . . . . . . . . . . . . . . . . 319TESTFREEMAIN subcommand . . . . . . . . . . . . . . . . . 319

    TESTFREEMAIN subcommand syntax . . . . . . . . . . . . . . 319TESTFREEMAIN subcommand operands. . . . . . . . . . . . . 319TESTFREEMAIN subcommand examples. . . . . . . . . . . . . 320

    TESTGETMAIN subcommand . . . . . . . . . . . . . . . . . . 320TESTGETMAIN subcommand syntax . . . . . . . . . . . . . . 321TESTGETMAIN subcommand sperands . . . . . . . . . . . . . 321TESTGETMAIN subcommand examples . . . . . . . . . . . . . 321

    TESTGO subcommand . . . . . . . . . . . . . . . . . . . . 322TESTGO subcommand syntax . . . . . . . . . . . . . . . . . 322TESTGO subcommand operands. . . . . . . . . . . . . . . . 322TESTGO subcommand examples. . . . . . . . . . . . . . . . 323

    TESTHELP command . . . . . . . . . . . . . . . . . . . . . 323TESTLINK command . . . . . . . . . . . . . . . . . . . . . 323TESTLIST subcommand . . . . . . . . . . . . . . . . . . . . 323

    TESTLIST subcommand syntax . . . . . . . . . . . . . . . . 323TESTLIST subcommand operands . . . . . . . . . . . . . . . 324

    TESTLIST subcommand examples . . . . . . . . . . . . . . . 327TESTLISTALC command . . . . . . . . . . . . . . . . . . . . 329TESTLISTBC command . . . . . . . . . . . . . . . . . . . . 329TESTLISTCAT command . . . . . . . . . . . . . . . . . . . . 329TESTLISTDCB subcommand . . . . . . . . . . . . . . . . . . 330

    TESTLISTDCB subcommand syntax . . . . . . . . . . . . . . 330TESTLISTDCB subcommand operands . . . . . . . . . . . . . 330TESTLISTDCB subcommand examples . . . . . . . . . . . . . 331

    TESTLISTDEB subcommand . . . . . . . . . . . . . . . . . . 331TESTLISTDEB subcommand syntax. . . . . . . . . . . . . . . 331TESTLISTDEB subcommand operands . . . . . . . . . . . . . 332TESTLISTDEB subcommand examples . . . . . . . . . . . . . 332

    TESTLISTDS command . . . . . . . . . . . . . . . . . . . . 333TESTLISTMAP subcommand . . . . . . . . . . . . . . . . . . 333TESTLISTMAP subcommand syntax . . . . . . . . . . . . . . 333TESTLISTMAP subcommand sperands . . . . . . . . . . . . . 333TESTLISTMAP subcommand examples . . . . . . . . . . . . . 334

    TESTLISTPSW subcommand . . . . . . . . . . . . . . . . . . 334TESTLISTPSW subcommand syntax . . . . . . . . . . . . . . 334TESTLISTPSW subcommand operands . . . . . . . . . . . . . 334TESTLISTPSW subcommand examples . . . . . . . . . . . . . 335

    TESTLISTTCB subcommand . . . . . . . . . . . . . . . . . . 335TESTLISTTCB subcommand syntax. . . . . . . . . . . . . . . 335TESTLISTTCB subcommand operands . . . . . . . . . . . . . 336TESTLISTTCB subcommand examples . . . . . . . . . . . . . 336

    TESTLISTVP subcommand . . . . . . . . . . . . . . . . . . . 337TESTLISTVP subcommand syntax . . . . . . . . . . . . . . . 337TESTLISTVP subcommand examples . . . . . . . . . . . . . . 337

    TESTLISTVSR subcommand . . . . . . . . . . . . . . . . . . 337TESTLISTVSR subcommand syntax. . . . . . . . . . . . . . . 337TESTLISTVSR subcommand operands . . . . . . . . . . . . . 338TESTLISTVSR subcommand examples . . . . . . . . . . . . . 338

    TESTLOAD subcommand . . . . . . . . . . . . . . . . . . . 339TESTLOAD subcommand syntax . . . . . . . . . . . . . . . . 339TESTLOAD subcommand operands . . . . . . . . . . . . . . . 339TESTLOAD subcommand examples. . . . . . . . . . . . . . . 339

    Contents ix

  • 7/31/2019 Time Sharing Option

    12/471

    TESTOFF subcommand . . . . . . . . . . . . . . . . . . . . 340TESTOFF subcommand syntax . . . . . . . . . . . . . . . . 340TESTOFF subcommand operands . . . . . . . . . . . . . . . 340TESTOFF subcommand examples . . . . . . . . . . . . . . . 340

    TESTOR subcommand . . . . . . . . . . . . . . . . . . . . 341TESTOR subcommand syntax . . . . . . . . . . . . . . . . . 341TESTOR subcommand operands . . . . . . . . . . . . . . . . 341

    TESTOR subcommand examples. . . . . . . . . . . . . . . . 343TESTPROFILE command . . . . . . . . . . . . . . . . . . . 344TESTPROTECT command . . . . . . . . . . . . . . . . . . . 344TESTQUALIFY subcommand . . . . . . . . . . . . . . . . . . 344

    TESTQUALIFY subcommand syntax . . . . . . . . . . . . . . 344TESTQUALIFY subcommand operands . . . . . . . . . . . . . 344TESTQUALIFY subcommand examples . . . . . . . . . . . . . 345

    TESTRENAME command . . . . . . . . . . . . . . . . . . . 346TESTRUN subcommand . . . . . . . . . . . . . . . . . . . . 346

    TESTRUN subcommand syntax . . . . . . . . . . . . . . . . 346TESTRUN subcommand operands . . . . . . . . . . . . . . . 347TESTRUN subcommand examples . . . . . . . . . . . . . . . 347

    TESTSEND command . . . . . . . . . . . . . . . . . . . . . 348

    TESTSETVSR subcommand . . . . . . . . . . . . . . . . . . 348TESTSETVSR subcommand syntax. . . . . . . . . . . . . . . 348TESTSETVSR subcommand operands. . . . . . . . . . . . . . 348TESTSETVSR subcommand examples. . . . . . . . . . . . . . 348

    TESTSTATUS command . . . . . . . . . . . . . . . . . . . . 349TESTSUBMIT command . . . . . . . . . . . . . . . . . . . . 349TESTTERMINAL command . . . . . . . . . . . . . . . . . . . 349TESTUNALLOC command . . . . . . . . . . . . . . . . . . . 349TESTWHERE subcommand . . . . . . . . . . . . . . . . . . . 349

    TESTWHERE subcommand syntax . . . . . . . . . . . . . . . 349TESTWHERE subcommand operands . . . . . . . . . . . . . . 350TESTWHERE subcommand examples . . . . . . . . . . . . . . 350

    TIME command . . . . . . . . . . . . . . . . . . . . . . . . 351TIME command syntax . . . . . . . . . . . . . . . . . . . . 352TIME command return code . . . . . . . . . . . . . . . . . . 352

    TRANSMIT command . . . . . . . . . . . . . . . . . . . . . . 352TRANSMIT command syntax . . . . . . . . . . . . . . . . . . 352TRANSMIT command operands . . . . . . . . . . . . . . . . . 353TRANSMIT command return codes . . . . . . . . . . . . . . . . 357Transmitting data sets . . . . . . . . . . . . . . . . . . . . . 358Transmitting data sets as messages . . . . . . . . . . . . . . . 358Transmitting messages . . . . . . . . . . . . . . . . . . . . 358Transmitting enciphered data . . . . . . . . . . . . . . . . . . 359Transmitting data sets and messages with security labels. . . . . . . . 359Logging function of TRANSMIT and RECEIVE . . . . . . . . . . . . 359

    NAMES data set function . . . . . . . . . . . . . . . . . . . 361Control section tags . . . . . . . . . . . . . . . . . . . . . 361Nicknames section tags . . . . . . . . . . . . . . . . . . . . 363TRANSMIT command examples . . . . . . . . . . . . . . . . . 364

    TSOEXEC command . . . . . . . . . . . . . . . . . . . . . . 367TSOEXEC command syntax . . . . . . . . . . . . . . . . . . 367TSOEXEC command operand . . . . . . . . . . . . . . . . . . 367TSOEXEC command return codes . . . . . . . . . . . . . . . . 367TSOEXEC command examples . . . . . . . . . . . . . . . . . 368

    TSOLIB command . . . . . . . . . . . . . . . . . . . . . . . 368Search order for load modules. . . . . . . . . . . . . . . . . . 369

    x z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    13/471

    Further considerations . . . . . . . . . . . . . . . . . . . . . 369Command usage. . . . . . . . . . . . . . . . . . . . . . . 370Stacking load module and program object library requests . . . . . . . 370TSOLIB command syntax . . . . . . . . . . . . . . . . . . . 371TSOLIB command operands . . . . . . . . . . . . . . . . . . 371TSOLIB command return codes . . . . . . . . . . . . . . . . . 373TSOLIB command examples . . . . . . . . . . . . . . . . . . 374

    VLFNOTE command . . . . . . . . . . . . . . . . . . . . . . 377Changing data associated with a partitioned data set . . . . . . . . . 378VLFNOTE command syntax (partitioned data set) . . . . . . . . . . 378VLFNOTE command operands (partitioned data set) . . . . . . . . . 378VLFNOTE command examples (partitioned data set) . . . . . . . . . 378Changing non-PDS data . . . . . . . . . . . . . . . . . . . . 379VLFNOTE command syntax (non-PDS) . . . . . . . . . . . . . . 379VLFNOTE command operands (non-PDS) . . . . . . . . . . . . . 379VLFNOTE command examples (non-PDS) . . . . . . . . . . . . . 379VLFNOTE command return codes . . . . . . . . . . . . . . . . 380

    WHEN command . . . . . . . . . . . . . . . . . . . . . . . 380WHEN command syntax . . . . . . . . . . . . . . . . . . . . 380WHEN command operands . . . . . . . . . . . . . . . . . . . 380

    WHEN command return code . . . . . . . . . . . . . . . . . . 381WHEN command examples . . . . . . . . . . . . . . . . . . . 381

    Chapter 2. Session Manager commands . . . . . . . . . . . . . . 383Entering Session Manager commands. . . . . . . . . . . . . . . . 385Command format . . . . . . . . . . . . . . . . . . . . . . . 385Session Manager Command syntax. . . . . . . . . . . . . . . . . 386Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . 386Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . 386Session Manager Command summary. . . . . . . . . . . . . . . . 387CHANGE.CURSOR command . . . . . . . . . . . . . . . . . . . 388

    CHANGE.CURSOR command syntax . . . . . . . . . . . . . . . 388

    CHANGE.CURSOR command operands . . . . . . . . . . . . . . 388CHANGE.CURSOR command return codes. . . . . . . . . . . . . 389CHANGE.CURSOR command examples . . . . . . . . . . . . . . 389CHANGE.FUNCTION command . . . . . . . . . . . . . . . . . 389CHANGE.MODE command . . . . . . . . . . . . . . . . . . . 392CHANGE.PFK command. . . . . . . . . . . . . . . . . . . . 393CHANGE.STREAM command . . . . . . . . . . . . . . . . . . 394CHANGE.TERMINAL command . . . . . . . . . . . . . . . . . 395CHANGE.WINDOW command. . . . . . . . . . . . . . . . . . 396DEFINE.WINDOW command . . . . . . . . . . . . . . . . . . 399DELETE.WINDOW command . . . . . . . . . . . . . . . . . . 402END command . . . . . . . . . . . . . . . . . . . . . . . 402FIND command . . . . . . . . . . . . . . . . . . . . . . . 403

    PUT command . . . . . . . . . . . . . . . . . . . . . . . 405QUERY command . . . . . . . . . . . . . . . . . . . . . . 406RESET command . . . . . . . . . . . . . . . . . . . . . . 409RESTORE command . . . . . . . . . . . . . . . . . . . . . 409SAVE command . . . . . . . . . . . . . . . . . . . . . . . 411SCROLL command . . . . . . . . . . . . . . . . . . . . . . 412SNAPSHOT command . . . . . . . . . . . . . . . . . . . . 415UNLOCK command. . . . . . . . . . . . . . . . . . . . . . 415

    Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . 417Using assistive technologies . . . . . . . . . . . . . . . . . . . 417

    Contents xi

  • 7/31/2019 Time Sharing Option

    14/471

    Keyboard navigation of the user interface. . . . . . . . . . . . . . . 417z/OS information . . . . . . . . . . . . . . . . . . . . . . . . 417

    Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . 419Policy for unsupported hardware . . . . . . . . . . . . . . . . . . 421Trademarks. . . . . . . . . . . . . . . . . . . . . . . . . . 421

    Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . 423TSO/E Publications . . . . . . . . . . . . . . . . . . . . . . . 423Related Publications . . . . . . . . . . . . . . . . . . . . . . 423

    Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

    xii z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    15/471

    Figures

    1. Allocating and creating input data sets in the background . . . . . . . . . . . . . . . . 782. Information available through the HELP command . . . . . . . . . . . . . . . . . . 163

    Copyright IBM Corp. 1988, 2010 xiii

  • 7/31/2019 Time Sharing Option

    16/471

    xiv z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    17/471

    Tables

    1. Syntax examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix2. Commands preferred for VSAM/Non-VSAM data sets . . . . . . . . . . . . . . . . . 213. Summary of the TSO/E commands . . . . . . . . . . . . . . . . . . . . . . . . 224. ALLOCATE command return codes . . . . . . . . . . . . . . . . . . . . . . . . 575. Library search order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636. ALTLIB command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 697. ATTRIB command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 768. CALL command return codes . . . . . . . . . . . . . . . . . . . . . . . . . . 799. CANCEL Command Return Codes . . . . . . . . . . . . . . . . . . . . . . . . 82

    10. DELETE Command Return Codes . . . . . . . . . . . . . . . . . . . . . . . . 8611. EDIT command: default values for LINE or LRECL and BLOCK or BLKSIZE operands . . . . . 9312. EDIT command return codes . . . . . . . . . . . . . . . . . . . . . . . . . . 9313. Subcommands and functions of the EDIT command . . . . . . . . . . . . . . . . . . 9514. Default tab settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13315. Library search order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14416. EXEC command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 146

    17. EXECUTIL command return codes . . . . . . . . . . . . . . . . . . . . . . . . 15518. FREE command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 16019. HELP command return codes. . . . . . . . . . . . . . . . . . . . . . . . . . 16520. LINK command return codes . . . . . . . . . . . . . . . . . . . . . . . . . . 17921. LISTALC command return codes . . . . . . . . . . . . . . . . . . . . . . . . 18122. LISTBC command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 18423. LISTBC command return codes (installation-defined user log data set) . . . . . . . . . . 18424. LISTCAT command return codes . . . . . . . . . . . . . . . . . . . . . . . . 18925. LISTDS command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 19126. LOADGO command return codes . . . . . . . . . . . . . . . . . . . . . . . . 19927. LOGOFF command return codes . . . . . . . . . . . . . . . . . . . . . . . . 20028. LOGON command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 20429. MVSSERV command return codes . . . . . . . . . . . . . . . . . . . . . . . . 206

    30. OUTDES command return codes . . . . . . . . . . . . . . . . . . . . . . . . 21931. OUTPUT command return codes . . . . . . . . . . . . . . . . . . . . . . . . 22632. Subcommands and functions of the OUTPUT command . . . . . . . . . . . . . . . . 22733. Valid machine printer carriage control characters . . . . . . . . . . . . . . . . . . 23434. Summary of default values for the PRINTDS command . . . . . . . . . . . . . . . . 24035. Mutually exclusive operands on the PRINTDS command. . . . . . . . . . . . . . . . 24236. PRINTDS command return codes . . . . . . . . . . . . . . . . . . . . . . . . 24237. System defaults for control characters . . . . . . . . . . . . . . . . . . . . . . 24438. UPT/PSCB initialization table in the background . . . . . . . . . . . . . . . . . . . 24939. PROFILE command return codes . . . . . . . . . . . . . . . . . . . . . . . . 25040. PROTECT command return codes . . . . . . . . . . . . . . . . . . . . . . . . 25441. RECEIVE command return codes . . . . . . . . . . . . . . . . . . . . . . . . 26042. Combinations of source and target data sets . . . . . . . . . . . . . . . . . . . . 262

    43. RENAME command return codes . . . . . . . . . . . . . . . . . . . . . . . . 26744. Source statement/licensed program relationship . . . . . . . . . . . . . . . . . . . 26745. RUN command return codes . . . . . . . . . . . . . . . . . . . . . . . . . . 27146. SEND command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 27547. SEND command return codes (installation-defined user log data set) . . . . . . . . . . . 27548. SMCOPY command return codes . . . . . . . . . . . . . . . . . . . . . . . . 27949. SMFIND command return codes. . . . . . . . . . . . . . . . . . . . . . . . . 28150. SMPUT command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 28251. STATUS command return codes. . . . . . . . . . . . . . . . . . . . . . . . . 28352. SUBMIT command return codes. . . . . . . . . . . . . . . . . . . . . . . . . 28753. TERMINAL command return codes. . . . . . . . . . . . . . . . . . . . . . . . 291

    Copyright IBM Corp. 1988, 2010 xv

  • 7/31/2019 Time Sharing Option

    18/471

    54. TEST Command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 29555. Subcommands and functions of the TEST command . . . . . . . . . . . . . . . . . 29756. TRANSMIT command return codes . . . . . . . . . . . . . . . . . . . . . . . 35757. TSOEXEC command return codes . . . . . . . . . . . . . . . . . . . . . . . . 36758. TSOLIB command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 37359. VLFNOTE command return codes . . . . . . . . . . . . . . . . . . . . . . . . 38060. Summary of the Session Manager commands . . . . . . . . . . . . . . . . . . . 387

    61. CHANGE.CURSOR command return codes . . . . . . . . . . . . . . . . . . . . 38962. CHANGE.FUNCTION command return codes. . . . . . . . . . . . . . . . . . . . 39163. CHANGE.MODE command return codes . . . . . . . . . . . . . . . . . . . . . 39264. CHANGE.PFK command return codes . . . . . . . . . . . . . . . . . . . . . . 39465. CHANGE.STREAM command return codes . . . . . . . . . . . . . . . . . . . . 39566. CHANGE.TERMINAL command return codes . . . . . . . . . . . . . . . . . . . . 39667. CHANGE.WINDOW command return codes . . . . . . . . . . . . . . . . . . . . 39868. DEFINE.WINDOW command return codes . . . . . . . . . . . . . . . . . . . . . 40169. DELETE.WINDOW command return codes. . . . . . . . . . . . . . . . . . . . . 40270. FIND command return codes . . . . . . . . . . . . . . . . . . . . . . . . . . 40471. PUT command return codes . . . . . . . . . . . . . . . . . . . . . . . . . . 40572. QUERY command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 40773. RESET command return codes . . . . . . . . . . . . . . . . . . . . . . . . . 409

    74. RESTORE command return codes . . . . . . . . . . . . . . . . . . . . . . . . 41075. SAVE command return codes. . . . . . . . . . . . . . . . . . . . . . . . . . 41276. SCROLL command return codes . . . . . . . . . . . . . . . . . . . . . . . . 41477. SHAPSHOT command return codes . . . . . . . . . . . . . . . . . . . . . . . 41578. UNLOCK command return codes . . . . . . . . . . . . . . . . . . . . . . . . 416

    xvi z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    19/471

    About this document

    This document supports z/OS (5694A01).

    This document describes the syntax and function of the commands andsubcommands of the TSO/E command language and Session Manager. It providesonly reference material and assumes you are experienced in the use of TSO/E andSession Manager.

    If you are not familiar with TSO/E, first read z/OS TSO/E User's Guide. If you havelittle or no knowledge of the use of TSO/E commands, z/OS TSO/E User's Guide,provides the prerequisite information for using this document. The guide explainshow to:v Enter and execute commandsv Name and create specific types of data setsv Edit, rename, list, copy, free, and delete data setsv Send and receive data setsv Print data sets on a JES printerv

    Run programs in the foreground or backgroundv Use TSO/E through ISPF/PDFv Use Session Manager

    Notes:

    1. System programming commands are described in z/OS TSO/E SystemProgramming Command Reference.

    2. When you see the term JESPLEX in this publication, understand it to meaneither a logical grouping of JES2 systems that share the same multi-accessspool (MAS) or a logical grouping of JES3 systems (each JES3 systemconsisting of one global JES3 system and some number of local JES3systems).

    Who should use this documentAnyone who uses TSO/E and Session Manager commands.

    How this document is organized

    The major chapters in this document are:

    v Chapter 1, TSO/E commands and subcommands, on page 1 contains generalinformation needed to use TSO/E commands. It describes the syntax notation indiagrams that accompany each command, positional and keyword operands,delimiters, line continuation, comments, and subcommands.

    This document presents commands in alphabetical order. The subcommands are

    alphabetized under their commands. For example, all TEST subcommands arealphabetized under the TEST command. Examples are included.

    v Chapter 2, Session Manager commands, on page 383 describes the syntax andfunction of each Session Manager command. It presents the commands inalphabetical order and includes examples.

    Where to find more information

    See z/OS Information Roadmap for an overview of the documentation associatedwith z/OS, including the documentation available for z/OS TSO/E.

    Copyright IBM Corp. 1988, 2010 xvii

    http://ikj4c240.pdf/http://ikj4c240.pdf/http://ikj4c240.pdf/http://ikj4c240.pdf/http://ikj4c440.pdf/http://ikj4c440.pdf/http://ikj4c440.pdf/http://e0z2c1a0.pdf/http://e0z2c1a0.pdf/http://ikj4c440.pdf/http://ikj4c440.pdf/http://ikj4c240.pdf/http://ikj4c240.pdf/
  • 7/31/2019 Time Sharing Option

    20/471

    Introductory information about how to use TSO/E is described in z/OS TSO/EUser's Guide.

    The z/OS Basic Skills Information Center

    The z/OS Basic Skills Information Center is a Web-based information resourceintended to help users learn the basic concepts of z/OS, the operating system that

    runs most of the IBM mainframe computers in use today. The Information Center isdesigned to introduce a new generation of Information Technology professionals tobasic concepts and help them prepare for a career as a z/OS professional, such asa z/OS system programmer.

    Specifically, the z/OS Basic Skills Information Center is intended to achieve thefollowing objectives:

    v Provide basic education and information about z/OS without charge

    v Shorten the time it takes for people to become productive on the mainframe

    v Make it easier for new people to learn z/OS.

    To access the z/OS Basic Skills Information Center, open your Web browser to the

    following Web site, which is available to all users (no login required):http://publib.boulder.ibm.com/infocenter/zoslnctr/v1r7/index.jsp

    How to read syntax diagrams

    This section describes how to read syntax diagrams. It defines syntax diagramsymbols, items that may be contained within the diagrams (keywords, variables,delimiters, operators, fragment references, operands) and provides syntax examplesthat contain these items.

    Syntax diagrams pictorially display the order and parts (options and arguments) thatcomprise a command statement. They are read from left to right and from top tobottom, following the main path of the horizontal line.

    SymbolsThe following symbols may be displayed in syntax diagrams:

    Symbol Definition

    Indicates the beginning of the syntax diagram.

    Indicates that the syntax diagram is continued to the next line.

    Indicates that the syntax is continued from the previous line.

    Indicates the end of the syntax diagram.

    Syntax itemsSyntax diagrams contain many different items. Syntax items include:

    v Keywords - a command name or any other literal information.

    v Variables - variables are italicized, appear in lowercase, and represent the nameof values you can supply.

    v Delimiters - delimiters indicate the start or end of keywords, variables, oroperators. For example, a left parenthesis is a delimiter.

    v Operators - operators include add (+), subtract (-), multiply (*), divide (/), equal(=), and other mathematical operations that may need to be performed.

    xviii z/OS V1R11.0 TSO/E Command Reference

    http://ikj4c240.pdf/http://ikj4c240.pdf/http://ikj4c240.pdf/http://publib.boulder.ibm.com/infocenter/zoslnctr/v1r7/index.jsphttp://publib.boulder.ibm.com/infocenter/zoslnctr/v1r7/index.jsphttp://ikj4c240.pdf/http://ikj4c240.pdf/
  • 7/31/2019 Time Sharing Option

    21/471

    v Fragment references - a part of a syntax diagram, separated from the diagram toshow greater detail.

    v Separators - a separator separates keywords, variables or operators. Forexample, a comma (,) is a separator.

    Note: If a syntax diagram shows a character that is not alphanumeric (for example,parentheses, periods, commas, equal signs, a blank space), enter the

    character as part of the syntax.

    Keywords, variables, and operators may be displayed as required, optional, ordefault. Fragments, separators, and delimiters may be displayed as required oroptional.

    Item type Definition

    Required Required items are displayed on the main path of the horizontalline.

    Optional Optional items are displayed below the main path of the horizontalline.

    Default Default items are displayed above the main path of the horizontalline.

    Syntax examplesThe following table provides syntax examples.

    Table 1. Syntax examples

    Item Syntax example

    Required item.

    Required items appear on the main path of thehorizontal line. You must specify these items.

    KEYWORD required_item

    Required choice.

    A required choice (two or more items) appearsin a vertical stack on the main path of thehorizontal line. You must choose one of theitems in the stack.

    KEYWORD required_choice1required_choice2

    Optional item.

    Optional items appear below the main path ofthe horizontal line.

    KEYWORDoptional_item

    Optional choice.

    An optional choice (two or more items) appearsin a vertical stack below the main path of thehorizontal line. You may choose one of theitems in the stack.

    KEYWORDoptional_choice1optional_choice2

    Default.

    Default items appear above the main path ofthe horizontal line. The remaining items(required or optional) appear on (required) orbelow (optional) the main path of the horizontalline. The following example displays a defaultwith optional items.

    default_choice1

    KEYWORDoptional_choice2optional_choice3

    Variable.

    Variables appear in lowercase italics. Theyrepresent names or values.

    KEYWORD variable

    About this document xix

  • 7/31/2019 Time Sharing Option

    22/471

    Table 1. Syntax examples (continued)

    Item Syntax example

    Repeatable item.

    An arrow returning to the left above the mainpath of the horizontal line indicates an item thatcan be repeated.

    A character within the arrow means you mustseparate repeated items with that character.

    An arrow returning to the left above a group ofrepeatable items indicates that one of the itemscan be selected,or a single item can berepeated.

    KEYWORD repeatable_item

    ,

    KEYWORD repeatable_item

    Fragment.

    The fragment symbol indicates that a labeledgroup is described below the main syntaxdiagram. Syntax is occasionally broken intofragments if the inclusion of the fragment wouldoverly complicate the main syntax diagram.

    KEYWORD fragment

    fragment:

    ,required_choice1,default_choice

    ,required_choice2,optional_choice

    xx z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    23/471

    Summary of changes

    Summary of changesfor SA22-7782-12z/OS Version 1 Release 11as updated April 2010

    This book contains information previously presented in z/OS TSO/E CommandReference, SA22-7782-11, which supports z/OS Version 1 Release 11.

    New information

    A new operand for the Allocate command, EATTR, has been added to ALLOCATEcommand syntax on page 26 with its description on page 56.

    This document contains terminology, maintenance, and editorial changes, includingchanges to improve consistency and retrievability.

    Summary of changesfor SA22-7782-11z/OS Version 1 Release 11

    This book contains information previously presented in z/OS TSO/E CommandReference, SA22-7782-10, which supports z/OS Version 1 Release 10.

    New information

    A new option for the Link command, SIGN/NOSIGN, has been added to LINKcommand syntax on page 166 and LINK command operands on page 168.

    Changed information

    v The description of LIKE operand for the ALLOCATE command has been updatedon page 39.

    v The LINK command syntax on page 166 and the LINK command operands onpage 168 have been updated in terms of the format.

    v The description of RECONNECT operand for the LOGON command has beenupdated on page 204.

    v The description of WTPMSG operand for the PROFILE command has beenupdated on page 248.

    Deleted information

    References to the following obsolete program products have been deleted from

    Table 44 on page 267 for the Run command and RUN command operands onpage 269. In each case, a more current version of the compiler is listed.

    v Assembler Prompter

    v COBOL Prompter

    v FORTRAN Prompter

    v PL/I Prompter

    This document contains terminology, maintenance, and editorial changes, includingchanges to improve consistency and retrievability.

    Copyright IBM Corp. 1988, 2010 xxi

  • 7/31/2019 Time Sharing Option

    24/471

    xxii z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    25/471

    Chapter 1. TSO/E commands and subcommands

    Using a TSO/E command . . . . . . . . . . . . . . . . . . . . . 16Positional operands . . . . . . . . . . . . . . . . . . . . . . 16Keyword operands . . . . . . . . . . . . . . . . . . . . . . 16

    How to read the TSO/E command syntax . . . . . . . . . . . . . . . 17Abbreviating keyword operands. . . . . . . . . . . . . . . . . . 19Comments . . . . . . . . . . . . . . . . . . . . . . . . . 19Line continuation . . . . . . . . . . . . . . . . . . . . . . . 20Delimiters . . . . . . . . . . . . . . . . . . . . . . . . . . 20

    Using the HELP command . . . . . . . . . . . . . . . . . . . . 21Explanations of commands . . . . . . . . . . . . . . . . . . . 21Syntax interpretation of HELP information . . . . . . . . . . . . . . 21Explanations of subcommands . . . . . . . . . . . . . . . . . . 21

    Using commands for VSAM and Non-VSAM data sets . . . . . . . . . . 21TSO/E commands and subcommands . . . . . . . . . . . . . . . . 22Summary of TSO/E commands . . . . . . . . . . . . . . . . . . . 22ALLOCATE command . . . . . . . . . . . . . . . . . . . . . . 24

    Data sets with SMS . . . . . . . . . . . . . . . . . . . . . . 24SMS classes. . . . . . . . . . . . . . . . . . . . . . . . 25Allocating non-SMS-managed data sets. . . . . . . . . . . . . . . 25Allocating z/OS UNIX data sets . . . . . . . . . . . . . . . . . . 26ALLOCATE command syntax . . . . . . . . . . . . . . . . . . 26ALLOCATE command operands . . . . . . . . . . . . . . . . . 29ALLOCATE command return codes . . . . . . . . . . . . . . . . 57ALLOCATE command examples . . . . . . . . . . . . . . . . . 57

    Example 1: Allocate your terminal as a temporary input data set. . . . . 57Example 2: Allocate an existing cataloged data set . . . . . . . . . 57Example 3: Allocate an existing data set that is not cataloged. . . . . . 57Example 4: Allocate a new data set with the attributes of an existing model

    data set. . . . . . . . . . . . . . . . . . . . . . . . . 57

    Example 5: Allocate a new data set that differs from an existing modeldata set only in its space allocation . . . . . . . . . . . . . . 57

    Example 6: Allocate a new sequential data set with space allocated intracks . . . . . . . . . . . . . . . . . . . . . . . . . 57

    Example 7: Allocate a new partitioned data set with space allocated inblocks . . . . . . . . . . . . . . . . . . . . . . . . . 58

    Example 8: Allocate a new sequential data set with default spacequantities . . . . . . . . . . . . . . . . . . . . . . . . 58

    Example 9: Allocate a new sequential data set using an attribute list . . . 58Example 10: Allocate a new sequential data set with space allocated in

    blocks and using an attribute list . . . . . . . . . . . . . . . 58Example 11: Allocate a new sequential data set with default space

    quantities and using an attribute list . . . . . . . . . . . . . . 58

    Example 12: Allocate a new data set to contain the output from a program 59Example 13: Allocate an existing multi-volume data set to SYSDA, with

    one device mounted for each volume . . . . . . . . . . . . . . 59Example 14: Allocate an existing data set as the second file of a

    standard-label tape . . . . . . . . . . . . . . . . . . . . 59Example 15: Allocate an output data set using the FCB and COPIES

    operands to request formatted copies of an output data set. . . . . . 59Example 16: Allocate a new tape data set using the PROTECT operand to

    request RACF protection . . . . . . . . . . . . . . . . . . 59Example 17: Allocate a new DASD data set using the PROTECT operand

    to request RACF protection . . . . . . . . . . . . . . . . . 59

    Copyright IBM Corp. 1988, 2010 1

  • 7/31/2019 Time Sharing Option

    26/471

    Example 18: Concatenate some data sets . . . . . . . . . . . . . 60Example 19: Allocate a data set, defined by a DD statement, as a

    SYSOUT data set with output descriptors to be printed on a specificprint form . . . . . . . . . . . . . . . . . . . . . . . . 60

    Example 20: Allocate a SYSOUT data set specifying the member name ofan installation-written program that is to write the data set . . . . . . 60

    Example 21: Allocate a SYSOUT data set to be printed in a specific

    character set or print font . . . . . . . . . . . . . . . . . . 60Example 22: Allocate a SYSOUT data set to make it available for printing

    immediately after deallocation . . . . . . . . . . . . . . . . 60Example 23: Allocate a SYSOUT data set specifying the number of pages

    to print . . . . . . . . . . . . . . . . . . . . . . . . . 60Example 24: Allocate a SYSOUT data set to be routed to a user at a

    remote destination . . . . . . . . . . . . . . . . . . . . . 61Example 25: Allocate an OBJECT PDS with a data class of OBJ . . . . 61Example 26: Override the data class, storage class, management class

    operands by explicitly specifying them on the ALLOCATE command . . 61Example 27: Allocate three data sets using the REUSE operand . . . . 61Example 28: Allocate a new DASD data set using a system-determined

    block size and request space in a quantity of logical records . . . . . 62

    Example 29: Allocate an output file, creating it if it does not exist . . . . 62ALTLIB command . . . . . . . . . . . . . . . . . . . . . . . . 62

    Search order for libraries . . . . . . . . . . . . . . . . . . . . 62Using ALTLIB with most applications . . . . . . . . . . . . . . . . 63Using ALTLIB with concurrent applications . . . . . . . . . . . . . . 63Using ALTLIB in ISPF . . . . . . . . . . . . . . . . . . . . . 63Using ALTLIB in the IPCS dialog . . . . . . . . . . . . . . . . . 64Stacking Application-Level library requests. . . . . . . . . . . . . . 65ALTLIB command syntax . . . . . . . . . . . . . . . . . . . . 65ALTLIB command operands . . . . . . . . . . . . . . . . . . . 66ALTLIB command return codes . . . . . . . . . . . . . . . . . . 69ALTLIB command examples . . . . . . . . . . . . . . . . . . . 69

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 69Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 69Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 69

    ATTRIB command. . . . . . . . . . . . . . . . . . . . . . . . 69ATTRIB command syntax . . . . . . . . . . . . . . . . . . . . 70ATTRIB command operands . . . . . . . . . . . . . . . . . . . 71ATTRIB command return codes. . . . . . . . . . . . . . . . . . 76ATTRIB command examples . . . . . . . . . . . . . . . . . . . 76

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 76Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 77

    CALL command . . . . . . . . . . . . . . . . . . . . . . . . 77CALL command in the background . . . . . . . . . . . . . . . . 77CALL command syntax . . . . . . . . . . . . . . . . . . . . . 78

    CALL command operands . . . . . . . . . . . . . . . . . . . . 78CALL command return codes . . . . . . . . . . . . . . . . . . 79CALL command examples. . . . . . . . . . . . . . . . . . . . 80

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 80Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 80Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 80Example 4 . . . . . . . . . . . . . . . . . . . . . . . . 80Example 5 . . . . . . . . . . . . . . . . . . . . . . . . 80Example 6 . . . . . . . . . . . . . . . . . . . . . . . . 80Example 7 . . . . . . . . . . . . . . . . . . . . . . . . 81

    CANCEL command . . . . . . . . . . . . . . . . . . . . . . . 81

    2 z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    27/471

    CANCEL command syntax . . . . . . . . . . . . . . . . . . . 81CANCEL command operands . . . . . . . . . . . . . . . . . . 81CANCEL command return codes . . . . . . . . . . . . . . . . . 82CANCEL command examples . . . . . . . . . . . . . . . . . . 82

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 82Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 82

    DELETE command . . . . . . . . . . . . . . . . . . . . . . . 83

    DELETE command syntax. . . . . . . . . . . . . . . . . . . . 83DELETE command operands . . . . . . . . . . . . . . . . . . 84DELETE command return codes . . . . . . . . . . . . . . . . . 86DELETE command example . . . . . . . . . . . . . . . . . . . 86

    Example . . . . . . . . . . . . . . . . . . . . . . . . . 86EDIT command. . . . . . . . . . . . . . . . . . . . . . . . . 87

    EDIT command syntax . . . . . . . . . . . . . . . . . . . . . 87EDIT command operands . . . . . . . . . . . . . . . . . . . . 88EDIT command return codes . . . . . . . . . . . . . . . . . . . 93EDIT command examples . . . . . . . . . . . . . . . . . . . . 93

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 93Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 94Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 94

    Example 4 . . . . . . . . . . . . . . . . . . . . . . . . 94EDIT subcommands (overview) . . . . . . . . . . . . . . . . . . 94EDITALLOCATE subcommand . . . . . . . . . . . . . . . . . 95EDITATTRIB subcommand . . . . . . . . . . . . . . . . . . 95EDITBOTTOM subcommand . . . . . . . . . . . . . . . . . . 96

    EDITBOTTOM subcommand syntax . . . . . . . . . . . . . . 96EDITCHANGE subcommand . . . . . . . . . . . . . . . . . . 96

    EDITCHANGE subcommand syntax . . . . . . . . . . . . . . 96EDITCHANGE subcommand operands . . . . . . . . . . . . . 96Quoted-String notation . . . . . . . . . . . . . . . . . . . . 97Combinations of operands . . . . . . . . . . . . . . . . . . . 98EDITCHANGE subcommand examples . . . . . . . . . . . . . 98

    EDITCKPOINT subcommand . . . . . . . . . . . . . . . . . 100EDITCKPOINT subcommand syntax. . . . . . . . . . . . . . 100EDITCKPOINT subcommand operand . . . . . . . . . . . . . 100EDITCKPOINT subcommand examples . . . . . . . . . . . . 101

    EDITCOPY subcommand . . . . . . . . . . . . . . . . . . . 101EDITCOPY subcommand syntax . . . . . . . . . . . . . . . 102EDITCOPY subcommand operands . . . . . . . . . . . . . . 102EDITCOPY subcommand examples . . . . . . . . . . . . . . 103

    EDITDELETE subcommand . . . . . . . . . . . . . . . . . . 107EDITDELETE subcommand syntax . . . . . . . . . . . . . . 107EDITDELETE subcommand operands . . . . . . . . . . . . . 107EDITDELETE subcommand examples . . . . . . . . . . . . . 108

    EDITDOWN subcommand . . . . . . . . . . . . . . . . . . 109

    EDITDOWN subcommand syntax. . . . . . . . . . . . . . . 109EDITDOWN subcommand operand . . . . . . . . . . . . . . 109EDITDOWN subcommand examples . . . . . . . . . . . . . 109

    EDITEND subcommand . . . . . . . . . . . . . . . . . . . 109EDITEND subcommand syntax . . . . . . . . . . . . . . . 109EDITEND subcommand operands . . . . . . . . . . . . . . 110

    EDITEXEC subcommand . . . . . . . . . . . . . . . . . . . 110EDITFIND subcommand . . . . . . . . . . . . . . . . . . . 110

    EDITFIND subcommand syntax . . . . . . . . . . . . . . . 110EDITFIND subcommand operands . . . . . . . . . . . . . . 110EDITFIND subcommand examples . . . . . . . . . . . . . . 111

    Chapter 1. TSO/E commands and subcommands 3

  • 7/31/2019 Time Sharing Option

    28/471

    EDITFREE subcommand . . . . . . . . . . . . . . . . . . . 111EDITHELP subcommand . . . . . . . . . . . . . . . . . . . 111EDITINPUT subcommand. . . . . . . . . . . . . . . . . . . 111

    EDITINPUT subcommand syntax . . . . . . . . . . . . . . . 111EDITINPUT subcommand operands . . . . . . . . . . . . . . 112EDITINPUT subcommand examples. . . . . . . . . . . . . . 112

    EDITINSERT subcommand . . . . . . . . . . . . . . . . . . 113

    EDITINSERT subcommand syntax . . . . . . . . . . . . . . 113EDITINSERT subcommand operand. . . . . . . . . . . . . . 113EDITINSERT subcommand examples . . . . . . . . . . . . . 113

    EDITinsert/replace/delete function. . . . . . . . . . . . . . . . 114EDITinsert/replace/delete function syntax . . . . . . . . . . . . 115EDITinsert/replace/delete function operands . . . . . . . . . . . 115How the system interprets the operands . . . . . . . . . . . . . 115EDITinsert/replace/delete function examples . . . . . . . . . . . 115

    EDITLIST subcommand . . . . . . . . . . . . . . . . . . . 116EDITLIST subcommand syntax. . . . . . . . . . . . . . . . 116EDITLIST subcommand operands . . . . . . . . . . . . . . 116EDITLIST subcommand examples . . . . . . . . . . . . . . 117

    EDITMOVE subcommand. . . . . . . . . . . . . . . . . . . 117

    EDITMOVE subcommand syntax . . . . . . . . . . . . . . . 117EDITMOVE subcommand operands . . . . . . . . . . . . . . 117EDITMOVE subcommand examples . . . . . . . . . . . . . . 119

    EDITPROFILE subcommand . . . . . . . . . . . . . . . . . 122EDITRENUM subcommand . . . . . . . . . . . . . . . . . . 122

    EDITRENUM subcommand syntax . . . . . . . . . . . . . . 123EDITRENUM subcommand operands . . . . . . . . . . . . . 123EDITRENUM subcommand examples . . . . . . . . . . . . . 124

    EDITRUN subcommand . . . . . . . . . . . . . . . . . . . 124EDITRUN subcommand syntax . . . . . . . . . . . . . . . 124EDITRUN subcommand operands . . . . . . . . . . . . . . 125EDITRUN subcommand examples . . . . . . . . . . . . . . 126

    EDITSAVE subcommand . . . . . . . . . . . . . . . . . . . 126EDITSAVE subcommand syntax . . . . . . . . . . . . . . . 127EDITSAVE subcommand operands . . . . . . . . . . . . . . 127EDITSAVE subcommand examples . . . . . . . . . . . . . . 128

    EDITSCAN subcommand . . . . . . . . . . . . . . . . . . . 128EDITSCAN subcommand syntax . . . . . . . . . . . . . . . 129EDITSCAN subcommand operands . . . . . . . . . . . . . . 129EDITSCAN Subcommand Examples. . . . . . . . . . . . . . 129

    EDITSEND subcommand . . . . . . . . . . . . . . . . . . . 130EDITSUBMIT subcommand . . . . . . . . . . . . . . . . . . 130

    EDITSUBMIT subcommand syntax . . . . . . . . . . . . . . 130EDITSUBMIT subcommand operands . . . . . . . . . . . . . 130EDITSUBMIT subcommand examples . . . . . . . . . . . . . 133

    EDITTABSET subcommand . . . . . . . . . . . . . . . . . . 133EDITTABSET subcommand syntax . . . . . . . . . . . . . . 134EDITTABSET subcommand operands . . . . . . . . . . . . . 134EDITTABSET subcommand examples . . . . . . . . . . . . . 134

    EDITTOP subcommand . . . . . . . . . . . . . . . . . . . 135EDITTOP subcommand syntax. . . . . . . . . . . . . . . . 135EDITTOP subcommand examples . . . . . . . . . . . . . . 135

    EDITUNNUM subcommand . . . . . . . . . . . . . . . . . . 135EDITUNNUM subcommand syntax . . . . . . . . . . . . . . 135EDITUNNUM subcommand examples . . . . . . . . . . . . . 135

    EDITUP subcommand . . . . . . . . . . . . . . . . . . . . 135

    4 z/OS V1R11.0 TSO/E Command Reference

  • 7/31/2019 Time Sharing Option

    29/471

    EDITUP subcommand syntax . . . . . . . . . . . . . . . . 135EDITUP subcommand operands . . . . . . . . . . . . . . . 136EDITUP subcommand examples . . . . . . . . . . . . . . . 136

    EDITVERIFY subcommand . . . . . . . . . . . . . . . . . . 136EDITVERIFY subcommand syntax . . . . . . . . . . . . . . 136EDITVERIFY subcommand operands . . . . . . . . . . . . . 136EDITVERIFY subcommand examples . . . . . . . . . . . . . 136

    END command . . . . . . . . . . . . . . . . . . . . . . . . 137END command syntax. . . . . . . . . . . . . . . . . . . . . 137END command return code . . . . . . . . . . . . . . . . . . . 137

    EXEC command . . . . . . . . . . . . . . . . . . . . . . . . 137Using EXEC as a subcommand . . . . . . . . . . . . . . . . . 137EXEC command syntax . . . . . . . . . . . . . . . . . . . . 138EXEC command operands . . . . . . . . . . . . . . . . . . . 139Using the explicit form of the EXEC command . . . . . . . . . . . . 142

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 142Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 143Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 143Example 4 . . . . . . . . . . . . . . . . . . . . . . . . 144

    Using the (extended) implicit form of the EXEC command . . . . . . . 144

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 145Considerations for passing quotation marks . . . . . . . . . . . . . 145EXEC command return codes . . . . . . . . . . . . . . . . . . 146EXEC command examples . . . . . . . . . . . . . . . . . . . 146

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 146Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 146Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 147Example 4 . . . . . . . . . . . . . . . . . . . . . . . . 147Example 5 . . . . . . . . . . . . . . . . . . . . . . . . 148Example 6 . . . . . . . . . . . . . . . . . . . . . . . . 148Example 7 . . . . . . . . . . . . . . . . . . . . . . . . 148Example 8 . . . . . . . . . . . . . . . . . . . . . . . . 149

    EXECUTIL command . . . . . . . . . . . . . . . . . . . . . . 149Additional considerations for using EXECUTIL . . . . . . . . . . . . 150EXECUTIL command syntax . . . . . . . . . . . . . . . . . . 150EXECUTIL command operands . . . . . . . . . . . . . . . . . 151EXECUTIL command return codes . . . . . . . . . . . . . . . . 155EXECUTIL command examples . . . . . . . . . . . . . . . . . 155

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 155Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 155Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 155Example 4 . . . . . . . . . . . . . . . . . . . . . . . . 156

    FREE command . . . . . . . . . . . . . . . . . . . . . . . . 156FREE command syntax . . . . . . . . . . . . . . . . . . . . 156FREE command operands . . . . . . . . . . . . . . . . . . . 157

    FREE command return codes . . . . . . . . . . . . . . . . . . 160FREE command examples . . . . . . . . . . . . . . . . . . . 160Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 160Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 160Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 160Example 4 . . . . . . . . . . . . . . . . . . . . . . . . 160Example 5 . . . . . . . . . . . . . . . . . . . . . . . . 160Example 6 . . . . . . . . . . . . . . . . . . . . . . . . 161Example 7 . . . . . . . . . . . . . . . . . . . . . . . . 161Example 8 . . . . . . . . . . . . . . . . . . . . . . . . 161

    HELP command . . . . . . . . . . . . . . . . . . . . . . . . 161

    Chapter 1. TSO/E commands and subcommands 5

  • 7/31/2019 Time Sharing Option

    30/471

    Information available through HELP. . . . . . . . . . . . . . . . 161HELP command syntax . . . . . . . . . . . . . . . . . . . . 164HELP command operands . . . . . . . . . . . . . . . . . . . 164HELP command return codes . . . . . . . . . . . . . . . . . . 165HELP command examples . . . . . . . . . . . . . . . . . . . 165

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 165Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 165

    Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 165Example 4 . . . . . . . . . . . . . . . . . . . . . . . . 165Example 5 . . . . . . . . . . . . . . . . . . . . . . . . 166Example 6 . . . . . . . . . . . . . . . . . . . . . . . . 166

    LINK command . . . . . . . . . . . . . . . . . . . . . . . . 166LINK command syntax . . . . . . . . . . . . . . . . . . . . 166LINK command operands . . . . . . . . . . . . . . . . . . . 168LINK command return codes . . . . . . . . . . . . . . . . . . 179LINK command examples . . . . . . . . . . . . . . . . . . . 179

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 179Example 2 . . . . . . . . . . . . . . . . . . . . . . . . 179Example 3 . . . . . . . . . . . . . . . . . . . . . . . . 179

    LISTALC command . . . . . . . . . . . . . . . . . . . . . . . 180

    LISTALC command syntax . . . . . . . . . . . . . . . . . . . 180LISTALC command operands . . . . . . . . . . . . . . . . . . 180LISTALC command return codes . . . . . . . . . . . . . . . . . 181LISTALC command examples . . . . . . . . . . . . . . . . . . 181

    Example 1 . . . . . . . . . . . . . . . . . . . . . . . . 181Example 2 . . . .