Transcription
IBM VSE/Enterprise Systems ArchitectureVSE Central Functions VSE/ICCF User’s GuideVersion 6 Release 4SC33-6739-01
IBM VSE/Enterprise Systems ArchitectureVSE Central Functions VSE/ICCF User’s GuideVersion 6 Release 4SC33-6739-01
Note!Before using this information and the product it supports, be sure to read the general information under “Notices” onpage xi.Third Edition (September 2003)This edition applies to Version 6 Release 4 of the IBM Virtual Storage Extended/Interactive Computing and ControlFacility (VSE/ICCF), which is part of VSE Central Functions, Program Number 5686-066, and to all subsequentreleases and modifications until otherwise indicated in new editions.Order publications through your IBM representative or the IBM branch office serving your locality. Publications arenot stocked at the addresses given below.A form for readers’ comments is provided at the back of this publication. If the form has been removed, addressyour comments to:IBM Deutschland Entwicklung GmbHDepartment 3248Schoenaicher Strasse 220D-71032 BoeblingenFederal Republic of GermanyYou may also send your comments by FAX or via the Internet:Internet: s390id@de.ibm.comFAX (Germany): 07031-16-3456FAX (other countries): ( 49) 7031-16-3456When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in anyway it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1984, 2003. All rights reserved.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.
ContentsFigures . . . . . . . . . . . . . . . ixNotices . . . . . . . . . . . . . . . xiProgramming Interface Information . . . . . . xiTrademarks and Service Marks . . . . . . . xiiiAbout This Book . . . . . . . . . . xvWho Should Use This Book . . .How to Use This Book . . . .Where to Find More Information . xv. xv. xvSummary of Changes . . . . . . . . xviiChanges for Third Edition (September 2003) .Changes for Second Edition (June 1999) . . xvii. xviiChapter 1. Introduction . . . . . . . . 1The HELP Facility . . . . . . . . .Modes of Operation . . . . . . . . .The Command Language . . . . . . .Foreground Versus Background . . . . .Asynchronous Execution Mode . . . . .The VSE/ICCF Library File . . . . . .Types of User Library . . . . . . .Public versus Private Libraries . . . .Shared versus Owned Libraries . . . .The Alternate Library . . . . . . .Public versus Private Data . . . . . .Generation Member Group . . . . .Common Data and the Common Library .Library Efficiency . . . . . . . . .Temporary Storage Areas . . . . . .Languages Supported . . . . . . . .Writing an Interactive Program . . . . .The LINKNGO Program . . . . . . .The Include Facility . . . . . . . .VSE/ICCF Job Streams . . . . . . .The User Profile . . . . . . . . . .Access Control . . . . . . . . . .Dynamic Space Allocation . . . . . .Job Execution Under VSE/POWER . . .Message Transmission Facilities. . . . .The Editors . . . . . . . . . . .Procedures and Macros . . . . . . .Utility Programs . . . . . . . . . .Debugging Facilities . . . . . . . .Print-Type Members . . . . . . . .DBCS Support . . . . . . . . . .Display and Hardcopy Facilities . . . . 1. 1. 2. 3. 4. 4. 5. 5. 5. 6. 6. 6. 6. 7. 7. 8. 9. 9. 10. 10. 11. 12. 13. 13. 14. 15. 16. 17. 17. 18. 18. 19Chapter 2. Terminal Considerations . . 21The IBM 2740 (or 3767 in 2740Terminal Setup . . . .Data Entry. . . . . .The IBM 3270. . . . . .Mode). . . . . . . Copyright IBM Corp. 1984, 2003.21212122Terminal Setup . . . . . . . . .Data Entry. . . . . . . . . . .IBM 3270-Specific Functions . . . . .Logging On and Off . . . . . . . .Proceeding through Logon . . . . .Getting Acquainted with Your VSE/ICCFProblems During Logon . . . . . .Logging Off . . . . . . . . . .Terminal Input . . . . . . . . . .Prompting . . . . . . . . . . . .Tabbing. . . . . . . . . . . . .Multiple Line Input. . . . . . . . .Input of Hexadecimal Data . . . . . .Escape Character . . . . . . . . .ENTER Key in Execution Mode . . . .Continuous Output Mode . . . . . .Output Compression and Truncation . . .IBM 3270 Program Function Keys . . . .IBM 3270 Screen Format . . . . . . .IBM 3270 Split Screen Use . . . . . .2222232425252526262626272828292929303132Chapter 3. System Commands,Procedures and Macros . . . . . . . 35Command Syntax . . . . .Passwords . . . . . . . .Reading the Examples . . . .Summary of System Commands,Macros . . . . . . . . . Command . . . . . . .ASSEMBLE Procedure . . . .Examples . . . . . . ./ASYNCH Command . . . .Example . . . . . . ./ATTEN Command . . . .Example . . . . . . ./CANCEL Command . . . .Example . . . . . . ./COMPRES Command . . .Example . . . . . . ./CONNECT Command . . .Example . . . . . . ./CONTINU Command . . .Example . . . . . . .COPYFILE Macro . . . . .Example . . . . . . .COPYMEM Procedure . . . .Example . . . . . . ./COUNT Command . . . ./CP Command . . . . . .CPYLIB and MVLIB ProceduresExample . . . . . . .[/]CTL Command . . . . ./CTLP and /CP Commands. .Examples . . . . . . ./DELETE Command . . . . . . . . . . . . .Procedures,. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .and. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36. 36. 253535354iii
/DISPC and /DISPLAY Commands .Example . . . . . . . . ./DQ Command . . . . . . . .Examples . . . . . . . . .[/]ECHO Command . . . . . .Example . . . . . . . . .ED Macro . . . . . . . . . ./EDIT Command . . . . . . .Example . . . . . . . . .EDPRT and EDPUN Macros . . . ./END Command . . . . . . .Example . . . . . . . . ./ENDRUN Command . . . . . .Example . . . . . . . . ./EP and /ERASEP Commands . . .Example . . . . . . . . ./EXEC Command . . . . . . .FORTRAN Procedure . . . . . .Examples . . . . . . . . .GETL Procedure . . . . . . . .Examples . . . . . . . . .GETP Procedure . . . . . . . .Examples . . . . . . . . .GETR Procedure. . . . . . . ./GROUP Command . . . . . .Examples . . . . . . . . .[/]HARDCPY Command . . . . .Example . . . . . . . . .HC Macro . . . . . . . . . .Examples . . . . . . . . .HELP Macro . . . . . . . . .Example . . . . . . . . ./INPUT Command . . . . . . .Example . . . . . . . . ./INSERT Command . . . . . .Example . . . . . . . . ./LIBC Command . . . . . . .[/]LIBRARY Command . . . . .Examples . . . . . . . . .LIBRC Macro . . . . . . . . .Example . . . . . . . . .LIBRL Macro . . . . . . . . .Example . . . . . . . . .LIBRP Macro . . . . . . . . .Example . . . . . . . . ./LIST Command . . . . . . ./LISTC Command . . . . . . ./LISTP Command . . . . . . .Examples . . . . . . . . .LISTX Command . . . . . . .LOAD Procedure . . . . . . .Examples . . . . . . . . ./LOCP Command. . . . . . .Examples . . . . . . . . ./LOGOFF Command. . . . . ./LOGON Command . . . . . .Example . . . . . . . . ./LP Command . . . . . . . ./MAIL Command . . . . . . .Example . . . . . . . . .[/]MSG Command . . . . . .ivVSE/ICCF: User’s Guide. 55. 56. 57. 58. 60. 60. 61. 62. 62. 63. 64. 64. 65. 65. 66. 67. 68. 70. 70. 71. 73. 74. 75. 76. 78. 79. 81. 82. 84. 84. 85. 85. 86. 87. 88. 88. 89. 89. 90. 92. 93. 94. 95. 96. 96. 97. 99. 99. 101. 102. 102. 102. 103. 103. 104. 105. 105. 106. 106. 106. 107Example . . . . . . . . . .MVLIB Procedure . . . . . . . ./PASSWRD Command . . . . . .Example . . . . . . . . . .[/] PFnn Command . . . . . . .Examples . . . . . . . . . .PRINT Macro . . . . . . . . ./PROMPT Command . . . . . .Example . . . . . . . . . ./PROTECT Command . . . . . .Examples . . . . . . . . . ./PURGE Command . . . . . . .Example . . . . . . . . . .RELIST Macro . . . . . . . . ./RENAME Command . . . . . .Example . . . . . . . . . ./RENUM Command . . . . . . .[/]REPLACE Command . . . . . .Example . . . . . . . . . ./RESEQ Command . . . . . . .Examples . . . . . . . . . ./RETRIEV Command . . . . . .Example . . . . . . . . . ./RETURN Command . . . . . ./ROUTEP Command. . . . . . .Example . . . . . . . . . ./RP Command . . . . . . . . .RPGIAUTO Procedure . . . . . .Examples . . . . . . . . . .RPGII Procedure . . . . . . . .Examples . . . . . . . . . .RPGIXLTR Procedure. . . . . . .Examples . . . . . . . . . .RSEF Procedure . . . . . . . ./RUN or Command . . . . . .Examples . . . . . . . . . .[/]SAVE Command . . . . . . .Examples . . . . . . . . . .SCRATCH Procedure . . . . . . .Examples . . . . . . . . . .SDSERV Procedure . . . . . . .Examples . . . . . . . . . ./SEND Command. . . . . . . .Example . . . . . . . . . .[/]SET Command . . . . . . . .To Set Control Characters . . . .To Set VSE/ICCF Features . . . .To Set the Editor Autoinsert Feature .To Set System Control Features . .To Set the IBM 3270 Screen Features ./SETIME Command . . . . . . .Examples . . . . . . . . . ./SHIFT Command . . . . . . .[/]SHOW Command . . . . . . .Example . . . . . . . . . ./SKIP Command . . . . . . . .Example . . . . . . . . . .SORT Procedure . . . . . . . .Examples . . . . . . . . . ./SP Command . . . . . . . . . SPACE Procedure . . . . . . 3158158160161162163165166166167167
Example . . . ./SQUEEZE CommandExample . . . .[/]STATUS . . . ./STATUSP CommandExample . . . .STORE Macro . . .SUBMIT Procedure ./SUMRY Command .Example . . . ./SWITCH Command.Example . . . ./SYNCH Command .Example . . . .[/]TABSET Command/TIME Command . .Example . . . ./USERS Command .Examples . . . 80181181Chapter 4. General Information aboutthe Editor . . . . . . . . . . . . . 183Capabilities and Characteristics . . . .Screen Layout and Formatting. . . .Types of Editor Commands. . . . .Order of Input Processing . . . . .Operating Modes . . . . . . . .Character Translation . . . . . . .String Arguments . . . . . . . .Using Special Control Keys for Editing .Entering Multiple Commands . . . .Repeating Commands . . . . . .184184189189189190190190191191Chapter 5. Working with the Editor193Invoking the Editor . . . . . . . . . .Creating a New File . . . . . . . . . .Intermediate Saving of a File . . . . . . .Displaying and Changing a File . . . . . .Positioning the Line Pointer . . . . . .Limiting Editor Operations to Certain ColumnsGlobal Changes . . . . . . . . . .Shifting Data Within Lines . . . . . . .Adding or Deleting Lines . . . . . . .Copying or Moving Lines . . . . . . .Using the Line Command Area . . . . .Inserting Data via GETFILE . . . . . .Using the Editor Stack . . . . . . . . .Using Tab Stops for Column-Oriented Editing .Editing Two Areas of One File Simultaneously .Editing Two Logically Related Files . . . . .Recursive Editing . . . . . . . . . .Creating a New File through Recursive EditingSplit Screen Editing . . . . . . . . .Saving Your Data and Ending the Session . . .Special Applications and Techniques . . . .Difficult Global Changes . . . . . . .Line-Number Editing . . . . . . . . .Flagging Changes . . . . . . . . . .Editing All 80 Columns . . . . . . . .File-Type Dependent Setting of Editor 205207207209210212213213214217217219Indexed Editing for Large Members . .Special Views of Data . . . . . .Hexadecimal Editing . . . . . . .Editing Mixed Data . . . . . . .Maintaining Multiple Change Levels of aMember . . . . . . . . . . .Logging . . . . . . . . . . . .Temporarily Leaving Full-Screen Display .220220220220. 221. 221. 222Chapter 6. Editor Commands andMacros . . . . . . . . . . . . . . 223ADD Command . . . .Example . . . . . .ALIGN Command. . . .Example . . . . . .ALTER Command . . . .Example . . . . . .BACKWARD Command. .Examples . . . . . .BLANK Command . . .Example . . . . . .BOTTOM Command . . .Example . . . . . .CANCEL Command . . .Example . . . . . .CASE Command . . . .CENTER Command . . .Example . . . . . .CHANGE Command . . .Examples . . . . . .@COPY and @MOVE EditorExamples . . . . . .CTL Command . . . . .CURSOR Command . . .Examples . . . . . .DELETE Command . . .Examples . . . . . .DELIM Command. . . .Example . . . . . .DOWN Command . . .DUP Command . . . .Example . . . . . .ECHO Command . . . .END Command . . . .ENTER Command. . . .Example . . . . . .FILE Command . . . .Example . . . . . .FIND Command . . . .Examples . . . . . .FLAG Command . . . .Example . . . . . .FORMAT Command . . .Examples . . . . . .FORWARD Command . .Examples . . . . . .@FSEDPF Editor Macro . .GETFILE Command . . .Example . . . . . .HARDCPY Command . .INDEX Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Macros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Contentsv
Example . . . . . . . . . . . .INPUT Command . . . . . . . . . .INSERT Command . . . . . . . . .Examples . . . . . . . . . . . .JUSTIFY Command . . . . . . . . .LADD Command . . . . . . . . . .LEFT Command . . . . . . . . . .Example . . . . . . . . . . . .LIBRARY Command . . . . . . . . .LINEMODE Command . . . . . . . .Examples . . . . . . . . . . . .LOCATE, LOCNOT, and LOCUP CommandsExamples . . . . . . . . . . . .@MOVE Editor Macro . . . . . . . .MSG Command . . . . . . . . . .NEXT Command . . . . . . . . . .OVERLAY, OVERLAYX, and OX Commands .Examples . . . . . . . . . . . .PF Command . . . . . . . . . . .PFnn Command . . . . . . . . . .POINT Command . . . . . . . . . .Examples . . . . . . . . . . . .PRINT, PF, PRINTFWD, and TYPE CommandsExamples . . . . . . . . . . . .PROMPT Command . . . . . . . . .Example . . . . . . . . . . . .QUIT Command . . . . . . . . . .RENUM Command . . . . . . . . .Example . . . . . . . . . . . .REPEAT Command . . . . . . . . .Example . . . . . . . . . . . .REPLACE Command . . . . . . . . .Example . . . . . . . . . . . .RESTORE Command . . . . . . . . .RIGHT Command . . . . . . . . . .RPT Command . . . . . . . . . . .SAVE Command . . . . . . . . . .Example . . . . . . . . . . . .SCREEN Command . . . . . . . . .Example . . . . . . . . . . . .SEARCH Command . . . . . . . . .Examples . . . . . . . . . . . .SET Command . . . . . . . . . . .SHIFT Command . . . . . . . . . .Example . . . . . . . . . . . .SHOW Command . . . . . . . . . .Example . . . . . . . . . . . .SPLIT Command . . . . . . . . . .Example . . . . . . . . . . . .STACK Command. . . . . . . . . .Example . . . . . . . . . . . .STATUS Command . . . . . . . . .TABSET Command . . . . . . . . .TOP Command. . . . . . . . . . .TYPE Command . . . . . . . . . .UP Command . . . . . . . . . . .Example . . . . . . . . . . . .VERIFY Command . . . . . . . . .VIEW Command . . . . . . . . . .Examples . . . . . . . . . . . .ZONE Command . . . . . . . . . .viVSE/ICCF: User’s 308309310312312312313313313314315316319Examples . . . . . .nn Command . . . . .Example . . . . . .Editor Line Commands . .Line Command Area . .Entering Line CommandsCommand Descriptions .320323324325325325326Chapter 7. Job Entry Statements . . . 331Length of a Job Entry Statement . . . . . .Job Stream and Job Step . . . . . . . . ./ASSGN Job Entry Statement . . . . . . .Example . . . . . . . . . . . . ./COMMENT Job Entry Statement . . . . ./DATA Job Entry Statement . . . . . . .Example . . . . . . . . . . . . ./FILE Job Entry Statement . . . . . . . .Operands of the File Statement . . . . .Defining a File in Dynamic Space . . . .Defining a Normal VSE File or a VSE/VSAMFile . . . . . . . . . . . . . . .Defining a VSE/ICCF Member File . . . .Examples . . . . . . . . . . . . ./FORCE Job Entry Statement . . . . . . .Example . . . . . . . . . . . . ./INCLUDE Job Entry Statement . . . . . .Example . . . . . . . . . . . . ./LOAD Job Entry Statement . . . . . . .Example . . . . . . . . . . . . ./OPTION Job Entry Statement . . . . . .Example . . . . . . . . . . . . ./PAUSE Job Entry Statement . . . . . . .Example . . . . . . . . . . . . ./RESET Job Entry Statement . . . . . . ./TYPE Job Entry Statement . . . . . . .Example . . . . . . . . . . . . ./UPSI Job Entry Statement . . . . . . . .Examples . . . . . . . . . . . . 349350351352358359359360361361362362Chapter 8. Dump Commands. . . . . 365Summary of Dump CommandsADD Command . . . . .Example . . . . . . .BACKWARD Command. . .Example . . . . . . .CANCEL Command . . . .Example . . . . . . .DA Command . . . . . .DC Command . . . . . .DEC Command . . . . .Examples . . . . . . .DF Command . . . . . .DIN Command. . . . . .DISPACT Command . . . .DISPCHAR Command . . .DISPFWD Command . . . .DISPIND Command . . . .Example . . . . . . .DISPLAY Command . . . .Examples . . . . . . 73373374376
DUMP Command . .Example . . . .END Command . .EOJ Command . . .Example . . . .FORWARD CommandExample . . . .HEX Command . .Example . . . .LOCATE Command .Example . . . .ORIGIN Command .Example . . . .POINT Command . .Example . . . .SAVE Command . .Examples . . . .SEARCH Command .SHOW Command . .STATUS Command .Examples . . . .SUB Command . . .Example . . . .TOP Command. . .Example . . . 85386387387387389389390390Chapter 9. Writing a Procedure or aMacro. . . . . . . . . . . . . . . 391General Characteristics . . . . . . .Rules for Calling Procedures and Macros .Implied Execute Function for ProceduresRerunning a Procedure . . . . . .Macros in Edit or Command Mode . .Input Area . . . . . . . . . .Writing Your Own Procedures and MacrosSpacing and Delimiters . . . . . .Passwords . . . . . . . . . .Operand Limitations . . . . . . .Writing a Procedure . . . . . . .Procedure-Processor Orders . . . .Writing a Macro . . . . . . . .391392392392392393393393393393393401410Chapter 10. Utility Programs . . . . . 415DTSAUDIT Utility. . . . . .Invoking the DTSAUDIT UtilityCommands . . . . . . .DTSBATCH Utility . . . . .Control Commands . . . .DTSBATCH Utility Examples .DTSCOPY Utility . . . . . .Control Command . . . .DTSCOPY Utility Examples .DTSDUMMY Utility . . . . .DTSDUMMY Utility ExamplesDTSSORT Utility . . . . . .Default Sort . . . . . . .DTSSORT Utility Examples . .LINKNGO Utility . . . . . .Control Statements . . . .LINKNGO Utility Examples 31OBJECT Utility . . . . .OBJECT Utility ExamplesSubroutines . . . . . .Subroutine DTSSNAP .DTSPGMCK Subroutine .433433435435436Chapter 11. Job Entry Considerations437General Considerations . . . . . . . . .Interactive Partitions . . . . . . . . .GETVIS Area . . . . . . . . . . .Time-Sliced Execution . . . . . . . .Job Streams . . . . . . . . . . . .Job Entry Commands. . . . . . . . .The Input Area . . . . . . . . . . .The Punch Area . . . . . . . . . .Input/Output . . . . . . . . . . . .Permanent Disk Files . . . . . . . . . .Overall Job Restrictions . . . . . . . . .End of Job . . . . . . . . . . . . .Assembler and Compiler Considerations . . .Program Linkage . . . . . . . . . .Assembler Considerations . . . . . . .Full Screen Macro (DTSWRTRD) . . . . .Macro to Identify Terminal Characteristics(DTSSCRN) . . . . . . . . . . . .FORTRAN Compiler Considerations . . .RPG II Compiler Considerations . . . . .Submit-to-Batch Capability . . . . . . . .What Jobs May be Submitted . . . . . .How to Submit a Job . . . . . . . . .Submitting a Job for Output on the Printer .Submitting and Viewing of Output at aTerminal . . . . . . . . . . . . .Submitting a Job for Transmission to AnotherNode . . . . . . . . . . . . . .Receiving of List Output from Another NodeHelpful Commands, Macros, and 442444447.453455456458458458459. 459. 460460462Appendix A. Interactive JobRestrictions . . . . . . . . . . . . 465Access Methods and File Definitions .Librarian and Linkage Editor . . . .Sort/Merge Program . . . . . . .Considerations for Interactive PartitionsSupervisor Services . . . . . . .Analysis of CCWs for Unit Record I/O.465466467467468470Appendix B. Context Editor . . . . . 473Invoking the Context Editor . . . .Editing Modes . . . . . . . . .Response Modes . . . . . . .Summary of Editor Commands ValidEditing . . . . . . . . . .Specifics About Context Editing . .SHOW Command . . . . . . .VERIFY Command . . . . . . . . . 474. . . . 474. . . . 474in Context. . . . 475. . . . 478. . . . 481. . . . 481Appendix C. Understanding SyntaxDiagrams . . . . . . . . . . . . . 485Contentsvii
Index . . . . . . . . . . . . . . . 489viiiVSE/ICCF: User’s Guide
Figures1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.Default PF Key Settings in List and SpoolMode . . . . . . . . . . . . .Program Function Hierarchy . . . . .Basic Screen Layout . . . . . . . .Screen Layout with Two Logical ScreensScreen Layout with Two Format AreasCreating a New File . . . . . . . .Vertical Line Positioning CommandsUsing the Cnn Suffix . . . . . . . .Global Change Commands . . . . . .Shift Commands . . . . . . . . .Use of REPEAT and CENTER CommandsAdd and Delete Commands . . . . .Copy and Move Commands/MacrosUsing Tab Stops for Column-Oriented InputUsing Tab Stops in Editor Commands Copyright IBM Corp. 1984, 2003. 31. 110. 185187188. 194196. 197. 198. 199200. 20020120520516.17.18.19.20.21.22.23.24.25.26.Using the FORMAT Command . . . . .Alternate Editing of Two Files (ENTER OLD)Alternate Editing of Two Files (Return toNEW) . . . . . . . . . . . . . .Simultaneous Editing of Two Files UsingThree Format Areas . . . . . . . . .Incorrect Application of the ZONE CommandUse of the ZONE Command for ComplexGlobal Changes . . . . . . . . . . .Line-Number Editing (Input) . . . . . .Line-Number Editing (Extension) . . . . .Screen Format Using Two Lines for EachRecord . . . . . . . . . . . . . .Screen Format for Viewing 79 ColumnsEditor Commands in Context Editing207208209211213214216217218219476ix
xVSE/ICCF: User’s Guide
NoticesReferences in this publication to IBM products, programs, or services do not implythat IBM intends to make these available in all countries in which IBM operates.Any reference to an IBM product, program, or service is not intended to state orimply that only that IBM product, program, or service may be used. Anyfunctionally equivalent product, program, or service that does not infringe any ofthe intellectual property rights of IBM may be used instead of the IBM product,program, or service. The evaluation and verification of operation in conjunctionwith other products, except those expressly designated by IBM, are theresponsibility of the user.IBM may have patents or pending patent applications covering subject matter inthis document. The furnishing of this document does not give you any license tothese patents. You can send license inquiries, in writing, to the IBM Director ofLicensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785, U.S.A.Any pointers in this publication to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement. IBM acceptsno responsibility for the content or use of non-IBM Web sites specificallymentioned in this publication or accessed through an IBM Web site that ismentioned in this publication.Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:IBM Deutschland Informationssysteme GmbHDepartment 0215Pascalstr. 10070569 StuttgartGermanySuch information may be available, subject to appropriate terms and conditions,including in some cases payment of a fee.Programming Interface InformationThis publication describes the support available to a terminal user who works withthe IBM Virtual Storage Extended/Interactive Computing and Control Facility(VSE/ICCF). It shows how to use VSE/ICCF as an editing tool and as a tool foraccessing system services from a display station.This publication primarily documents information that is NOT intended to be usedas a Programming Interface of VSE/ICCF.This publication also documents intended Programming Interfaces that allow thecustomer to write programs to obtain the services of VSE/ICCF.Programming Interface Information is identified in the chapters it occurs by thefollowing marking: Copyright IBM Corp. 1984, 2003xi
Programming Interface InformationEnd of Programming Interface InformationxiiVSE/ICCF: User’s Guide
Trademarks and Service MarksThe following terms are trademarks of International Business MachinesCorporation in the United States, or other countries, or both:CICSESAIBMVSE/ESAVTAMNoticesxiii
xivVSE/ICCF: User’s Guide
About This BookThis manual describes the support available to a terminal user who works with theIBM Virtual Storage Extended/Interactive Computing and Control Facility(VSE/ICCF for short). It shows how to use VSE/ICCF as a data editing tool and asa tool for accessing system services (such as the submission of a job for processingby VSE/POWER) from a display station.Who Should Use This BookThis manual is intended primarily to assist the program developer in building andtesting a program.The manual can also be used by other skilled personnel, for example by the systemadministrator as a supplementary source of information. The administrator’s tasksare described in detail in the IBM manual VSE/ICCF Administration and Operation.How to Use This BookPlease refer to “Contents” on page iii to find the major topics of this manual. Youare also encouraged to use the index in the back to quickly locate particular itemsof interest to you.This manual includes information about the double-byte character support. Thissupport is used primarily with equipment such as the IBM 5550, which may nothave been announced as available in your country.Where to Find More InformationThe companion manual for this manual is VSE/ICCF Administration and Operationwhich provides further details on VSE/ICCF.The latest information on VSE/ESA can be found on the VSE/ESA home page:VSE/ESA Home PageVSE/ESA has a home page on the World Wide Web, which offers up-to-dateinformation about VSE-related products and services, new VSE/ESAfunctions, and other items of interest to VSE users.You can find the VSE/ESA home page se/ Copyright IBM Corp. 1984, 2003xv
xviVSE/ICCF: User’s Guide
Summary of ChangesChanges for Third Edition (September 2003)The third edition of this manual contains these changes, which were first includedin VSE/ESA Version 2 Release 5:v VSE/ICCF has been enhanced to improve the access to VSE/POWER queueentries by providing direct access to queue entries, access to active queue entries,and access to in-creation queue entries. For this purpose the VSE/ICCFcommands /LISTP (described on page 99) and /SKIP (described on page 163)have been changed.v Program DTSGETQ (which is used to access the VSE/POWER queue entries)has been modified. As a result, procedures GETL (described on page 71), GETP(described on page 74), and GETR (described on page 76), have a new operandQN (queue number). This operand can be used to specify the VSE/POWERqueue entry number.v The manual has been updated with other minor corrections resulting fromAPARs.Changes for Second Edition (June 1999)The second edition of this manual, which was published as VSE/ICCF Version 6Release 4 first became available, contained these changes:v The f
IBM VSE/Enterprise Systems Architecture VSE Central Functions VSE/ICCF User's Guide Version6Release4 SC33-6739-01
