cics user’s handbook - freetesta.roberta.free.fr/my books/mainframe/cics/ibm - cics...

503
CICS Transaction Server for OS/390 IBM CICS User’s Handbook Release 3 SX33-6104-02

Upload: tranthuan

Post on 16-May-2018

329 views

Category:

Documents


4 download

TRANSCRIPT

Page 1: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CICS Transaction Server for OS/390

IBM

CICS User’s HandbookRelease 3

SX33-6104-02

Page 2: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390
Page 3: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CICS Transaction Server for OS/390

IBM

CICS User’s HandbookRelease 3

SX33-6104-02

Page 4: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Note!

Before using this information and the product it supports, be sure to readthe general information under “Notices” on page v.

Third edition (March 1999)

This edition applies to Release 3 of CICS Transaction Server for OS/390,program number 5655-147, and to all subsequent versions, releases, andmodifications until otherwise indicated in new editions. Make sure you are usingthe correct edition for the level of the product.

This edition replaces and makes obsolete the previous edition, SX33-6104-00.The technical changes for this edition are summarized under "Summary ofchanges" and are indicated by a vertical bar to the left of a change.

Order publications through your IBM representative or the IBM branch officeserving your locality. Publications are not stocked at the address given below.

At the back of this publication is a page entitled “Sending your comments toIBM”. If you want to make comments, but the methods described are notavailable to you, please address them to:

IBM United Kingdom Laboratories, Information Development,Mail Point 095, Hursley Park, Winchester, Hampshire, England, SO21 2JN.

When you send information to IBM, you grant IBM a nonexclusive right to useor distribute the information in any way it believes appropriate without incurringany obligation to you.

Copyright International Business Machines Corporation 1989, 1999. Allrights reserved.US Government Users Restricted Rights – Use, duplication or disclosurerestricted by GSA ADP Schedule Contract with IBM Corp.

Page 5: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vProgramming interface information . . . . . . . . . . . . . . . . . . . . viTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixWhat this handbook is about . . . . . . . . . . . . . . . . . . . . . . . ix

Who this handbook is for . . . . . . . . . . . . . . . . . . . . . . . ixWhat you need to know to understand this handbook . . . . . . . . ix

Handbook structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiiiCICS Transaction Server for OS/390 . . . . . . . . . . . . . . . . . . . xiii

CICS books for CICS Transaction Server for OS/390 . . . . . . . . xiiiCICSPlex SM books for CICS Transaction Server for OS/390 . . . . xvOther CICS books . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Determining if a publication is current . . . . . . . . . . . . . . . . . . xv

Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . xviiChanges made for CICS Transaction Server for OS/390 Release 3 . xviiChanges made for CICS Transaction Server for OS/390 Release 2 . xviiChanges made for CICS/ESA 4.1 edition . . . . . . . . . . . . . . . xvii

Chapter 1. Command-level application programming . . . . . . . . 1General format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Restrictions for distributed program link (DPL) . . . . . . . . . . . . . . 2API command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Chapter 2. SPI command syntax . . . . . . . . . . . . . . . . . . . 91

Chapter 3. CICS-Supplied Transaction . . . . . . . . . . . . . . . 167

Chapter 4. Resource definition online . . . . . . . . . . . . . . . 197

Chapter 5. DFHCSDUP commands . . . . . . . . . . . . . . . . . 205

Chapter 6. Front End Programming Interface command reference 211FEPI application programming . . . . . . . . . . . . . . . . . . . . . 211FEPI system programming . . . . . . . . . . . . . . . . . . . . . . . 218

Chapter 7. CICS-value data areas used by all commands . . . . 225CVDAs and numeric values in alphabetic sequence . . . . . . . . . . 225CVDAs and numeric values in numeric sequence . . . . . . . . . . . 233

Copyright IBM Corp. 1989, 1999 iii

Page 6: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA values for the DEVICE option . . . . . . . . . . . . . . . . . . 240

Chapter 8. EXEC interface block (EIB) . . . . . . . . . . . . . . . 243EIB field names and descriptions . . . . . . . . . . . . . . . . . . . 243EIBFN codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244EIBRCODE values . . . . . . . . . . . . . . . . . . . . . . . . . . . 249RESP values and conditions . . . . . . . . . . . . . . . . . . . . . . 254

Chapter 9. RESP2 values and their meanings . . . . . . . . . . . 257

Chapter 10. EXEC interface block (EIB) response and functioncodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

Response codes of EXEC CICS commands . . . . . . . . . . . . . . 397Function codes of EXEC CICS commands . . . . . . . . . . . . . . 399

Chapter 11. DFH messages . . . . . . . . . . . . . . . . . . . . . 407Message Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 407Format of information . . . . . . . . . . . . . . . . . . . . . . . . . . 411MVS user abend codes . . . . . . . . . . . . . . . . . . . . . . . . . 415

Chapter 12. Transaction abend codes . . . . . . . . . . . . . . . 419Format of information . . . . . . . . . . . . . . . . . . . . . . . . . . 420

Chapter 13. Transaction abend codes . . . . . . . . . . . . . . . 421

Chapter 14. 1xxx-9xxx (COBOL II) abend codes . . . . . . . . . . 463

Chapter 15. VTAM-associated errors . . . . . . . . . . . . . . . . 465VTAM terminal error codes and CICS message numbers . . . . . . . 465

Chapter 16. System sense codes received . . . . . . . . . . . . . 471Action flag settings and default actions ˚˚˚˚˚ . . . 474

Chapter 17. VTAM submodule identifiers . . . . . . . . . . . . . . 475

Chapter 18. AP domain storage classes . . . . . . . . . . . . . . 479

Sending your comments to IBM . . . . . . . . . . . . . . . . . . . 481

iv CICS User’s Handbook

Page 7: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Notices

This information was developed for products and services offered in theU.S.A. IBM may not offer the products, services, or features discussed inthis document in other countries. Consult your local IBM representative forinformation on the products and services currently available in your area.Any reference to an IBM product, program, or service is not intended to stateor imply that only that IBM product, program, or service may be used. Anyfunctionally equivalent product, program, or service that does not infringeany IBM intellectual property right may be used instead. However, it is theuser's responsibility to evaluate and verify the operation of any non-IBMproduct, program, or service.

IBM may have patents or pending patent applications covering subjectmatter described in this document. The furnishing of this document does notgive you any license to these patents. You can send license inquiries, inwriting, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact theIBM Intellectual Property Department in your country or send inquiries, inwriting, to:

IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106, Japan

The following paragraph does not apply in the United Kingdom or anyother country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDESTHIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND,EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. Somestates do not allow disclaimer of express or implied warranties in certaintransactions, therefore this statement may not apply to you.

This publication could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will

Copyright IBM Corp. 1989, 1999 v

Page 8: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

be incorporated in new editions of the publication. IBM may makeimprovements and/or changes in the product(s) and/or the program(s)described in this publication at any time without notice.

Licensees of this program who wish to have information about it for thepurpose of enabling: (i) the exchange of information between independentlycreated programs and other programs (including this one) and (ii) the mutualuse of the information which has been exchanged, should contact IBMUnited Kingdom Laboratories, MP151, Hursley Park, Winchester, Hampshire,England, SO21 2JN. Such information may be available, subject toappropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM CustomerAgreement, IBM International Programming License Agreement, or anyequivalent agreement between us.

Programming interface informationThis book is intended to help you refer quickly to CICS systemadministration and operating information.

This book also documents General-use Programming Interface andAssociated Guidance Information, Product-sensitive Programming Interfaceand Associated Guidance Information, and Diagnosis, Modification or TuningInformation provided by CICS.

General-use programming interfaces allow the customer to write programsthat obtain the services of CICS.

General-use Programming Interface and Associated Guidance Information isidentified where it occurs, by an introductory statement to a chapter orsection.

Product-sensitive programming interfaces allow the customer installation toperform tasks such as diagnosing, modifying, monitoring, repairing, tailoring,or tuning of CICS. Use of such interfaces creates dependencies on thedetailed design or implementation of the IBM software product.Product-sensitive programming interfaces should be used only for thesespecialized purposes. Because of their dependencies on detailed designand implementation, it is to be expected that programs written to suchinterfaces may need to be changed in order to run with new productreleases or versions, or as a result of service.

vi CICS User’s Handbook

Page 9: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Product-sensitive Programming Interface and Associated GuidanceInformation is identified where it occurs, by an introductory statement to achapter or section.

Diagnosis, Modification or Tuning Information is provided to help youdiagnose problems in a CICS system.

Attention: Do not use this Diagnosis, Modification or Tuning Information asa programming interface.

Diagnosis, Modification or Tuning Information is identified where it occurs, byan introductory statement to a chapter or section.

TrademarksThe following terms are trademarks of International Business MachinesCorporation in the United States, or other countries, or both:

Other company, product, and service names may be trademarks or servicemarks of others.

ACF/VTAMCICSCICS OS/2CICS/ESA

CICS/MVSCICS/VSEC/370DB2IBMIBMLink

MVS/ESARACFVSE/ESAVTAM

Notices vii

Page 10: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

viii CICS User’s Handbook

Page 11: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Preface

What this handbook is aboutThis book helps you refer quickly to topics you are already familiar with. Itprovides a summary of information contained elsewhere in the CICS library.

Who this handbook is forThis book is for:

� System programmers� CICS or system operators

� Application programmers.

What you need to know to understand this handbookYou need to have a good understanding of how CICS works. This assumesfamiliarity with most, if not all, of the books in the CICS library, together withadequate practical experience of running a CICS system.

Copyright IBM Corp. 1989, 1999 ix

Page 12: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Handbook structureChapter 1, “Command-level application programming” on page 1

Gives a summary of command-level application programming commands inCICS Transaction Server for OS/390. For programming information, see theCICS Application Programming Reference.

Chapter 2, “SPI command syntax” on page 91

Gives a summary of command-level system programming commands. Forprogramming information, see the CICS System Programming Referencemanual.

Chapter 3, “CICS-Supplied Transaction” on page 167

Gives a summary of the CICS-supplied transactions. For more detailedinformation, see the CICS Supplied Transactions.

Chapter 4, “Resource definition online” on page 197

Gives a summary of the syntax for resource definition online. For moredetailed information, see the CICS Resource Definition Guide.

Chapter 6, “Front End Programming Interface command reference” onpage 211

Gives a summary of the syntax for front end programming interfacecommand references. For more detailed information, see the CICS FrontEnd Programming Interface User's Guide.

Chapter 7, “CICS-value data areas used by all commands” onpage 225

Gives a table of CVDA values. For programming information, see the CICSSystem Programming Reference manual.

Chapter 8, “EXEC interface block (EIB)” on page 243

Gives information about EIB fields, and gives the meanings of EIBFN,EIBRCODE, RESP, and RESP2 values. For programming information, seethe CICS Application Programming Reference.

Chapter 10, “EXEC interface block (EIB) response and function codes”on page 397

x CICS User’s Handbook

Page 13: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Gives information about EIB response and function codes. For more detailedinformation, see the CICS System Programming Reference and the CICSProblem Determination Guide.

Chapter 11, “DFH messages” on page 407

Gives a summary of the terminal error messages and codes. For moredetailed information, see the CICS Messages and Codes.

Chapter 12, “Transaction abend codes” on page 419

Gives a summary of CICS transaction abend codes. For more detailedinformation, see the CICS Messages and Codes.

Chapter 15, “VTAM-associated errors” on page 465

Gives a summary of VTAM errors and associated CICS messages. For moredetailed information, see the CICS Messages and Codes.

Chapter 17, “VTAM submodule identifiers” on page 475

Gives information about the product-sensitive product interface.

Chapter 18, “AP domain storage classes” on page 479

Shows the valid AP domain storage classes.

Preface xi

Page 14: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

xii CICS User’s Handbook

Page 15: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Bibliography

CICS Transaction Server for OS/390CICS Transaction Server for OS/390: Planning for Installation GC33-1789CICS Transaction Server for OS/390 Release Guide GC34-5352CICS Transaction Server for OS/390 Migration Guide GC34-5353CICS Transaction Server for OS/390 Installation Guide GC33-1681CICS Transaction Server for OS/390 Program Directory GI10-2506CICS Transaction Server for OS/390 Licensed ProgramSpecification

GC33-1707

CICS books for CICS Transaction Server for OS/390

Copyright IBM Corp. 1989, 1999 xiii

Page 16: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

GeneralCICS Master Index SC33-1704CICS User's Handbook SX33-6104CICS Transaction Server for OS/390 Glossary (softcopy only) GC33-1705

AdministrationCICS System Definition Guide SC33-1682CICS Customization Guide SC33-1683CICS Resource Definition Guide SC33-1684CICS Operations and Utilities Guide SC33-1685CICS Supplied Transactions SC33-1686

ProgrammingCICS Application Programming Guide SC33-1687CICS Application Programming Reference SC33-1688CICS System Programming Reference SC33-1689CICS Front End Programming Interface User's Guide SC33-1692CICS C++ OO Class Libraries SC34-5455CICS Distributed Transaction Programming Guide SC33-1691CICS Business Transaction Services SC34-5268

DiagnosisCICS Problem Determination Guide GC33-1693CICS Messages and Codes GC33-1694CICS Diagnosis Reference LY33-6088CICS Data Areas LY33-6089CICS Trace Entries SC34-5446CICS Supplementary Data Areas LY33-6090

CommunicationCICS Intercommunication Guide SC33-1695CICS Family: Interproduct Communication SC33-0824CICS Family: Communicating from CICS on System/390 SC33-1697CICS External Interfaces Guide SC33-1944CICS Internet Guide SC34-5445

Special topicsCICS Recovery and Restart Guide SC33-1698CICS Performance Guide SC33-1699CICS IMS Database Control Guide SC33-1700CICS RACF Security Guide SC33-1701CICS Shared Data Tables Guide SC33-1702CICS Transaction Affinities Utility Guide SC33-1777CICS DB2 Guide SC33-1939

xiv CICS User’s Handbook

Page 17: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CICSPlex SM books for CICS Transaction Server forOS/390General

CICSPlex SM Master Index SC33-1812CICSPlex SM Concepts and Planning GC33-0786CICSPlex SM User Interface Guide SC33-0788CICSPlex SM View Commands Reference Summary SX33-6099

Administration and ManagementCICSPlex SM Administration SC34-5401CICSPlex SM Operations Views Reference SC33-0789CICSPlex SM Monitor Views Reference SC34-5402CICSPlex SM Managing Workloads SC33-1807CICSPlex SM Managing Resource Usage SC33-1808CICSPlex SM Managing Business Applications SC33-1809

ProgrammingCICSPlex SM Application Programming Guide SC34-5457CICSPlex SM Application Programming Reference SC34-5458

DiagnosisCICSPlex SM Resource Tables Reference SC33-1220CICSPlex SM Messages and Codes GC33-0790CICSPlex SM Problem Determination GC33-0791

Other CICS books

If you have any questions about the CICS Transaction Server for OS/390library, see CICS Transaction Server for OS/390: Planning for Installationwhich discusses both hardcopy and softcopy books and the ways that thebooks can be ordered.

CICS Application Programming Primer (VS COBOL II) SC33-0674CICS Application Migration Aid Guide SC33-0768CICS Family: API Structure SC33-1007CICS Family: Client/Server Programming SC33-1435CICS Family: General Information GC33-0155CICS 4.1 Sample Applications Guide SC33-1173CICS/ESA 3.3 XRF Guide SC33-0661

Determining if a publication is currentIBM regularly updates its publications with new and changed information.When first published, both hardcopy and BookManager softcopy versions ofa publication are usually in step. However, due to the time required to printand distribute hardcopy books, the BookManager version is more likely tohave had last-minute changes made to it before publication.

Bibliography xv

Page 18: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Subsequent updates will probably be available in softcopy before they areavailable in hardcopy. This means that at any time from the availability of arelease, softcopy versions should be regarded as the most up-to-date.

For CICS Transaction Server books, these softcopy updates appearregularly on the Transaction Processing and Data Collection Kit CD-ROM,SK2T-0730-xx. Each reissue of the collection kit is indicated by an updatedorder number suffix (the -xx part). For example, collection kit SK2T-0730-06is more up-to-date than SK2T-0730-05. The collection kit is also clearlydated on the cover.

Updates to the softcopy are clearly marked by revision codes (usually a “#”character) to the left of the changes.

xvi CICS User’s Handbook

Page 19: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

''

Summary of changes

Changes made for CICS Transaction Server for OS/390Release 3Trace entries have been moved to the Trace Entries manual SC34-5446-02.

Changes made for CICS Transaction Server for OS/390Release 2This handbook includes information about the new or enhanced facilitiesintroduced by CICS Transaction Server for OS/390 Release 3.

VTAM terminal error codes are now shown in CICS message order.

Tables of CVDA values are now shown in hexadecimal and decimal format.

Changes made for CICS/ESA 4.1 editionThe commands for application programming and system programming areshown in alphabetic order.

In the section Chapter 7, “CICS-value data areas used by all commands” onpage 225, tables of CVDA values have been added.

Syntax boxes for EXEC CICS commands are replaced with “railroad”diagrams. For an explanation of these diagrams, see the CICS ApplicationProgramming Reference manual.

Trace has been removed from this handbook and has been moved into theCICS Diagnosis Reference manual.

Front end programming interface (FEPI) commands have been added.

Copyright IBM Corp. 1989, 1999 xvii

Page 20: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

''

xviii CICS User’s Handbook

Page 21: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Application Programming

Chapter 1. Command-level application programming

This chapter contains General-use Programming Interface information.

General formatThe format of a CICS command, which can be coded in a COBOL, C/370,PL/I, or assembler application program, is as follows:

COBOL:

EXEC CICS function[option[(arg)]]... END-EXEC

C:

EXEC CICS function[option[(arg)]]... ;

PL/I:

EXEC CICS function[option[(arg)]]... ;

Assembler:

EXEC CICS function[option[(arg)]]...

DL/I command formatThe format of a DL/I command, which can be coded only in a COBOL,C/370, or PL/I application program, is as follows:

EXEC DLI function[option[(arg)]]...

For multiple segment commands, options are repeated for each segment.

RPG II command formatThe format of a CICS command in an RPG II application program consists ofan EXEC statement, followed optionally by one or more ELEM statements,coded on an RPG calculation specification form (the C-spec).

Copyright IBM Corp. 1989, 1999 1

Page 22: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Application Programming

Restrictions for distributed program link (DPL)The following commands are not supported in a program running in aresource region in response to a distributed program link command:

Table 1. Restricted API commands

ADDRESS ....ALLOCATEASSIGN ....CONNECT PROCESSCONVERSEEXTRACT PROCESSFREE CONVIDHANDLE AID

ISSUE ....PURGE MESSAGERECEIVE ....ROUTESEND ....SIGNOFFSIGNONWAIT TERMINAL

2 CICS User’s Handbook

Page 23: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

API command syntax

ABEND

55─ ──ABEND ──┬ ┬────────────── ── ──┬ ┬──────── ── ──┬ ┬──────── ─5%└ ┘──ABCODE(name) └ ┘─CANCEL─ └ ┘─NODUMP─

ADDRESS

55─ ──ADDRESS ──┬ ┬─────────────── ──┬ ┬─────────────────── ──┬ ┬────────────── ───5└ ┘──ACEE(ptr-ref) └ ┘──COMMAREA(ptr-ref) └ ┘──CWA(ptr-ref)

5─ ──┬ ┬────────────── ──┬ ┬──────────────── ──┬ ┬────────────── ─5%└ ┘──EIB(ptr-ref) └ ┘──TCTUA(ptr-ref) └ ┘──TWA(ptr-ref)

ADDRESS SET

55─ ──ADDRESS ──┬ ┬──SET(data-area) ──USING(ptr-ref) ─5% └ ┘──SET(ptr-ref) ──USING(data-area)

ALLOCATE (APPC)

55─ ──ALLOCATE ──┬ ┬──SYSID(systemname) ──┬ ┬─────────────── ──┬ ┬───────── ───────5│ │└ ┘──PROFILE(name) └ ┘ ─NOQUEUE─└ ┘──PARTNER(name) ───────────────────────

5─ ──┬ ┬───────────── ─5%└ ┘──STATE(cvda)

Conditions: CBIDERR, INVREQ, NETNAMEIDERR, PARTNERIDERR,SYSBUSY, SYSIDERR

Chapter 1. Command-level application programming 3

Page 24: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ALLOCATE (LUTYPE6.1)

55─ ──ALLOCATE ──┬ ┬──SESSION(name) ──── ──┬ ┬─────────────── ──┬ ┬───────── ─5%└ ┘──SYSID(systemname) └ ┘──PROFILE(name) └ ┘ ─NOQUEUE─

Conditions: CBIDERR, EOC, INVREQ, SESSBUSY, SESSIONERR,SYSBUSY, SYSIDERR

ALLOCATE (MRO)

55─ ──ALLOCATE ──SYSID(systemname) ──┬ ┬───────── ──┬ ┬───────────── ─5% └ ┘─NOQUEUE─ └ ┘──STATE(cvda)

Conditions: INVREQ, SYSBUSY, SYSIDERR

ASKTIME

55─ ──ASKTIME ──┬ ┬──────────────────── ─5%└ ┘──ABSTIME(data-area)

4 CICS User’s Handbook

Page 25: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ASSIGN

┌ ┐───────────────────────────── ┌ ┐─────────────────────────────55─ ──ASSIGN ───

6┴┬ ┬───────────────────────── ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──ABCODE(data-area) ────── ├ ┤──MAPWIDTH(data-area) ────├ ┤──ABDUMP(data-area) ────── ├ ┤──MSRCONTROL(data-area) ──├ ┤──ABPROGRAM(data-area) ─── ├ ┤──NATLANGINUSE(data-area)

| ├ ┤──ACTIVITY(data-area) ──── ├ ┤──NETNAME(data-area) ─────| ├ ┤──ACTIVITYID(data-area) ── ├ ┤──NEXTTRANSID(data-area) ─

├ ┤──ALTSCRNHT(data-area) ─── ├ ┤──NUMTAB(data-area) ──────├ ┤──ALTSCRNWD(data-area) ─── ├ ┤──OPCLASS(data-area) ─────├ ┤──APLKYBD(data-area) ───── ├ ┤──OPERKEYS(data-area) ────├ ┤──APLTEXT(data-area) ───── ├ ┤──OPID(data-area) ────────├ ┤──APPLID(data-area) ────── ├ ┤──OPSECURITY(data-area) ──├ ┤──ASRAINTRPT(data-area) ── ├ ┤──ORGABCODE(data-area) ───

? ├ ┤──ASRAKEY(cvda) ────────── ├ ┤──OUTLINE(data-area) ─────├ ┤──ASRAPSW(data-area) ───── ├ ┤──PAGENUM(data-area) ─────├ ┤──ASRAREGS(data-area) ──── ├ ┤──PARTNPAGE(data-area) ───├ ┤──ASRASPC(cvda) ────────── ├ ┤──PARTNS(data-area) ──────

? ├ ┤──ASRASTG(cvda) ────────── ├ ┤──PARTNSET(data-area) ────├ ┤──BRIDGE(data-area) ────── ├ ┤──PRINSYSID(data-area) ───

| ├ ┤──BTRANS(data-area) ────── ├ ┤──PROCESS(data-area) ─────| ├ ┤──CMDSEC(data-area) ────── ├ ┤──PROCESSTYPE(data-area) ─

├ ┤──COLOR(data-area) ─────── ├ ┤──PROGRAM(data-area) ─────├ ┤──CWALENG(data-area) ───── ├ ┤──PS(data-area) ──────────├ ┤──DEFSCRNHT(data-area) ─── ├ ┤──QNAME(data-area) ───────├ ┤──DEFSCRNWD(data-area) ─── ├ ┤──RESSEC(data-area) ──────├ ┤──DELIMITER(data-area) ─── ├ ┤──RESTART(data-area) ─────├ ┤──DESTCOUNT(data-area) ─── ├ ┤──RETURNPROG(data-area) ──├ ┤──DESTID(data-area) ────── ├ ┤──SCRNHT(data-area) ──────├ ┤──DESTIDLENG(data-area) ── ├ ┤──SCRNWD(data-area) ──────├ ┤──DSSCS(data-area) ─────── ├ ┤──SIGDATA(data-area) ─────├ ┤──DS327ð(data-area) ────── ├ ┤──SOSI(data-area) ────────├ ┤──EWASUPP(data-area) ───── ├ ┤──STARTCODE(data-area) ───├ ┤──EXTDS(data-area) ─────── ├ ┤──STATIONID(data-area) ───├ ┤──FACILITY(data-area) ──── ├ ┤──SYSID(data-area) ───────├ ┤──FCI(data-area) ───────── ├ ┤──TASKPRIORITY(data-area)├ ┤──GCHARS(data-area) ────── ├ ┤──TCTUALENG(data-area) ───├ ┤──GCODES(data-area) ────── ├ ┤──TELLERID(data-area) ────├ ┤──GMMI(data-area) ──────── ├ ┤──TERMCODE(data-area) ────├ ┤──HILIGHT(data-area) ───── ├ ┤──TERMPRIORITY(data-area)

? ├ ┤──INITPARM(data-area) ──── ├ ┤──TEXTKYBD(data-area) ────? ├ ┤──INITPARMLEN(data-area) ─ ├ ┤──TEXTPRINT(data-area) ───

├ ┤──INPARTN(data-area) ───── ├ ┤──TRANPRIORITY(data-area)├ ┤──INVOKINGPROG(data-area) ├ ┤──TWALENG(data-area) ─────├ ┤──KATAKANA(data-area) ──── ├ ┤──UNATTEND(data-area) ────

? ├ ┤──LANGINUSE(data-area) ─── ├ ┤──USERID(data-area) ──────├ ┤──LDCMNEM(data-area) ───── ├ ┤──USERNAME(data-area) ────├ ┤──LDCNUM(data-area) ────── ├ ┤──USERPRIORITY(data-area)├ ┤──MAPCOLUMN(data-area) ─── └ ┘──VALIDATION(data-area) ──├ ┤──MAPHEIGHT(data-area) ───└ ┘──MAPLINE(data-area) ─────

Condition: INVREQ

Chapter 1. Command-level application programming 5

Page 26: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

BIF DEEDIT

55─ ──BIF DEEDIT ──FIELD(data-area) ──┬ ┬──────────────────── ─5%└ ┘──LENGTH(data-value)

Condition: LENGERR

BUILD ATTACH (LUTYPE6.1)

55─ ──BUILD ATTACH ──ATTACHID(name) ──┬ ┬─────────────── ──┬ ┬──────────────── ───5└ ┘──PROCESS(name) └ ┘──RESOURCE(name)

5─ ──┬ ┬──────────────── ──┬ ┬───────────────── ──┬ ┬───────────── ───────────────5└ ┘──RPROCESS(name) └ ┘──RRESOURCE(name) └ ┘──QUEUE(name)

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──IUTYPE(data-value) └ ┘──DATASTR(data-value)

5─ ──┬ ┬─────────────────── ─5%└ ┘──RECFM(data-value)

BUILD ATTACH (MRO)

55─ ──BUILD ATTACH ──ATTACHID(name) ──┬ ┬─────────────── ──┬ ┬──────────────── ───5└ ┘──PROCESS(name) └ ┘──RESOURCE(name)

5─ ──┬ ┬──────────────── ──┬ ┬───────────────── ──┬ ┬───────────── ───────────────5└ ┘──RPROCESS(name) └ ┘──RRESOURCE(name) └ ┘──QUEUE(name)

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──IUTYPE(data-value) └ ┘──DATASTR(data-value)

5─ ──┬ ┬─────────────────── ─5%└ ┘──RECFM(data-value)

CANCEL

55─ ──CANCEL ──┬ ┬─────────────────────────────────────────────────────── ─5% └ ┘──REQID(name) ──┬ ┬─────────────────── ──┬ ┬───────────────

└ ┘──SYSID(systemname) └ ┘──TRANSID(name)

Conditions: ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR

6 CICS User’s Handbook

Page 27: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CHANGE PASSWORD

55─ ──CHANGE PASSWORD(data-value) ──NEWPASSWORD(data-value) ──────────────────5

5─ ──USERID(data-value) ──┬ ┬────────────────────── ──┬ ┬──────────────────── ─5%└ ┘──ESMREASON(data-area) └ ┘──ESMRESP(data-area)

Conditions: INVREQ, NOTAUTH, USERIDERR

CHANGE TASK

55─ ──CHANGE TASK ──┬ ┬────────────────────── ─5%└ ┘──PRIORITY(data-value)

Condition: INVREQ

CONNECT PROCESS (APPC)

55─ ──CONNECT PROCESS ──┬ ┬──CONVID(name) ─ ────────────────────────────────────5└ ┘──SESSION(name)

5─ ──┬ ┬──PROCNAME(data-area) ──┬ ┬──────────────────────── ────────────────────5│ │└ ┘──PROCLENGTH(data-value)

? └ ┘──PARTNER(name) ──────────────────────────────────

5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──PIPLIST(data-area) ──┬ ┬───────────────────────

└ ┘──PIPLENGTH(data-value)

5─ ──SYNCLEVEL(data-value) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

? Conditions: INVREQ, LENGERR, NOTALLOC, PARTNERIDERR,TERMERR

Chapter 1. Command-level application programming 7

Page 28: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (APPC)

55─ ──CONVERSE ──┬ ┬────────────── ──FROM(data-area) ───────────────────────────5 └ ┘──CONVID(name)

5─ ──┬ ┬──FROMLENGTH(data-value) ─ ──┬ ┬──INTO(data-area) ───────────────────────5└ ┘──FROMFLENGTH(data-value) └ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ───────────────────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─

└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ──┬ ┬───────────── ─5%? └ ┘─NOTRUNCATE─ └ ┘──STATE? (cvda)

Conditions: EOC, INVREQ, LENGERR, NOTALLOC, SIGNAL,TERMERR

CONVERSE (default)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘──DEST(name)└ ┘──MAXFLENGTH(data-value)

Conditions: LENGERR

8 CICS User’s Handbook

Page 29: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (LUTYPE2/LUTYPE3)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ────────────────────────────────────────────────────5└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────────────────5 │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────

5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬───────── ────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─DEFRESP─

└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ── ──┬ ┬────── ─5% └ ┘─NOTRUNCATE─ └ ┘─ASIS─

Conditions: EOC, LENGERR, TERMERR

CONVERSE (LUTYPE4)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─

5─ ──┬ ┬──────────────────────── ── ──┬ ┬───── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─FMH─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, IGREQCD, INBFMH, LENGERR, SIGNAL,TERMERR

Chapter 1. Command-level application programming 9

Page 30: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (LUTYPE6.1)

55─ ──CONVERSE ──┬ ┬─────────────────────────────────────────────────────── ───5 └ ┘──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ──┬ ┬─────

└ ┘──FROMFLENGTH(data-value) └ ┘─FMH─

5─ ──┬ ┬─────────────── ──┬ ┬──────────────── ──┬ ┬──INTO(data-area) ─────────────5├ ┤──CONVID(name) ─ └ ┘──ATTACHID(name) └ ┘──SET(ptr-ref) ───└ ┘──SESSION(name)

5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ───────────────────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─

└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ── ──┬ ┬───────── ─5% └ ┘─NOTRUNCATE─ └ ┘─DEFRESP─

Conditions: CBIDERR, EOC, INBFMH, LENGERR, NOTALLOC,SIGNAL, TERMERR

CONVERSE (MRO)

55─ ──CONVERSE ──┬ ┬─────────────── ──┬ ┬──────────────── ───────────────────────5├ ┤──CONVID(name) ─ └ ┘──ATTACHID(name)└ ┘──SESSION(name)

5─ ──┬ ┬─────────────────────────────────────────────────────── ──────────────5 └ ┘──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ──┬ ┬─────

└ ┘──FROMFLENGTH(data-value) └ ┘─FMH─

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬───────── ────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─DEFRESP─└ ┘──MAXFLENGTH(data-value)

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE? (cvda)

Conditions: CBIDERR, EOC, INBFMH, LENGERR, NOTALLOC,TERMERR

10 CICS User’s Handbook

Page 31: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (SCS)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬───────── ── ──┬ ┬────────── ──────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─DEFRESP─ └ ┘─STRFIELD─└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─

Conditions: LENGERR, TERMERR

CONVERSE (System/3)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──┬ ┬──────────── ───────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘──DEST(name)└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─

Conditions: LENGERR

CONVERSE (System/7)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────── ──────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘──DEST(name)

5─ ── ──┬ ┬────── ── ──┬ ┬─────────── ─5% └ ┘─ASIS─ └ ┘─PSEUDOBIN─

Condition: LENGERR

Chapter 1. Command-level application programming 11

Page 32: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (2260)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───────────────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

5─ ──┬ ┬───────────────────── ──┬ ┬────────────────────── ──┬ ┬──────────── ──────5└ ┘──CTLCHAR(data-value) └ ┘──LINEADDR(data-value) └ ┘──DEST(name)

5─ ── ──┬ ┬───────── ─5% └ ┘─LEAVEKB─

Condition: LENGERR

CONVERSE (2741)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘──DEST(name)└ ┘──MAXFLENGTH(data-value)

Conditions: LENGERR, RDATT, WRBRK

12 CICS User’s Handbook

Page 33: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (3270 display)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───────────────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

5─ ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────────────────5 │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────

5─ ──┬ ┬──────────── ── ──┬ ┬────── ─5%└ ┘──DEST(name) └ ┘─ASIS─

Condition: LENGERR

CONVERSE (3270 logical)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ────────────────────────────────────────────────────5└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────────────────5 │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────

5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬───────── ────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─DEFRESP─

└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ── ──┬ ┬────── ─5% └ ┘─NOTRUNCATE─ └ ┘─ASIS─

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming 13

Page 34: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (3600 BTAM)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)

Condition: LENGERR

CONVERSE (3600-3601)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬─────────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) ├ ┤──LDC(name)

└ ┘─FMH───────

5─ ── ──┬ ┬───────── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─DEFRESP─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, LENGERR, SIGNAL, TERMERR

CONVERSE (3600-3614)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: LENGERR, TERMERR

14 CICS User’s Handbook

Page 35: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (3650 interpreter)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─

5─ ── ──┬ ┬───── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─FMH─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, LENGERR, TERMERR

CONVERSE (3650-3270)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬───────────────────── ──┬ ┬────────────────────── ── ──┬ ┬───────── ───────5└ ┘──CTLCHAR(data-value) └ ┘ ─ERASE─ ──┬ ┬─────────── └ ┘─DEFRESP─

├ ┤─DEFAULT─── └ ┘─ALTERNATE─

5─ ── ──┬ ┬───── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─FMH─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

Conditions: LENGERR, TERMERR

CONVERSE (3650-3653)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, LENGERR, TERMERR

Chapter 1. Command-level application programming 15

Page 36: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (3650-3680)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───── ───────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─FMH─

5─ ── ──┬ ┬───────── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─DEFRESP─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

Conditions: LENGERR, TERMERR

CONVERSE (3735)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)

Conditions: EOF, LENGERR

CONVERSE (3740)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)

Condition: LENGERR

16 CICS User’s Handbook

Page 37: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (3767)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, LENGERR, SIGNAL, TERMERR

CONVERSE (3770)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─

5─ ── ──┬ ┬───── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─FMH─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, LENGERR, SIGNAL, TERMERR

CONVERSE (3790 full-function or inquiry)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───── ───────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─FMH─

5─ ── ──┬ ┬───────── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─DEFRESP─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, LENGERR, SIGNAL, TERMERR

Chapter 1. Command-level application programming 17

Page 38: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

CONVERSE (3790 3270-display)

55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─

5─ ──┬ ┬───────────────────── ────────────────────────────────────────────────5└ ┘──CTLCHAR(data-value)

5─ ──┬ ┬────────────────────────────────────────────────────────────────── ─5% └ ┘ ─ERASE─ ──┬ ┬─────────── ──┬ ┬──────────────────────── ──┬ ┬────────────

├ ┤─DEFAULT─── ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘─ALTERNATE─ └ ┘──MAXFLENGTH(data-value)

Conditions: LENGERR, TERMERR

DELAY

┌ ┐──INTERVAL(ð) ─────────────────────55─ ──DELAY ──┼ ┼────────────────────────────────── ──┬ ┬───────────── ─5%

├ ┤ ─ ─INTERVAL(hhmmss) ──────────────── └ ┘──REQID(name)├ ┤──TIME(hhmmss) ────────────────────

│ │┌ ┐───────────────────────── ├ ┤─FOR─ ───

6┴┬ ┬──HOURS(data-value) ── ──

│ │├ ┤──MINUTES(data-value)│ │└ ┘──SECONDS(data-value)

│ │┌ ┐───────────────────────── └ ┘─UNTIL─ ───

6┴┬ ┬──HOURS(data-value) ──

├ ┤──MINUTES(data-value) └ ┘──SECONDS(data-value)

Conditions: EXPIRED, INVREQ

18 CICS User’s Handbook

Page 39: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DELETE

55─ ──DELETE ──FILE(filename) ──┬ ┬──────────────────────────────────────── ────5 ├ ┤──TOKEN(data-area) ────────────────────── └ ┘──RIDFLD(data-area) ──┬ ┬─────────────────

└ ┘───┤ keylength ├─

5─ ──┬ ┬─────────────────── ──┬ ┬─────────── ──┬ ┬───── ─5% └ ┘──SYSID(systemname) └ ┘ ─NOSUSPEND─ ├ ┤ ─RBA─ └ ┘ ─RRN─

keylength:├─ ──KEYLENGTH(data-value) ──┬ ┬───────────────────────────────── ─┤ └ ┘ ─GENERIC─ ──┬ ┬──────────────────── └ ┘──NUMREC(data-value)

| Conditions: CHANGED DISABLED, DUPKEY, FILENOTFOUND,ILLOGIC, INVREQ, IOERR, ISCINVREQ, LOADING, LOCKED,NOTAUTH, NOTFND, NOTOPEN, RECORDBUSY, SYSIDERR

DELETEQ TD

55─ ──DELETEQ TD ──QUEUE(name) ──┬ ┬─────────────────── ─5%└ ┘──SYSID(systemname)

Conditions: DISABLED, INVREQ, ISCINVREQ, LOCKED, NOTAUTH,QIDERR, SYSIDERR

DELETEQ TS

55─ ──DELETEQ TS ──┬ ┬──QUEUE(name) ──┬ ┬─────────────────── ─5%└ ┘──QNAME(name) └ ┘──SYSID(systemname)

Conditions: INVREQ, ISCINVREQ, LOCKED, NOTAUTH, QIDERR,SYSIDERR

Chapter 1. Command-level application programming 19

Page 40: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DEQ

55─ ──DEQ ──RESOURCE(data-area) ──┬ ┬──────────────────── ──────────────────────5└ ┘──LENGTH(data-value)

? ┌ ┐─UOW───────────────5─ ──┼ ┼─────────────────── ─5%

? ├ ┤──MAXLIFETIME(cvda)? └ ┘─TASK──────────────

Conditions: INVREQ, LENGERR

20 CICS User’s Handbook

Page 41: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DFHMDF (1 of 2)

55─ ── ──┬ ┬───── ──DFHMDF ─5% └ ┘─fld─

┌ ┐─,─────────────────────────────────────────5─ ───

6┴┬ ┬───────────────────────────────────────── ───────────────5

├ ┤──POS= ──┬ ┬─number──────── ────────────────│ │└ ┘──(line,column)├ ┤──LENGTH=number ──────────────────────────├ ┤──JUSTIFY=( ──┬ ┬─────── ──┬ ┬────────────── )

│ │├ ┤─LEFT── └ ┘──, ──┬ ┬─BLANK─│ │└ ┘─RIGHT─ └ ┘─ZERO──├ ┤──┬ ┬──INITIAL='char-data' ────── ──────────│ │├ ┤──XINIT=hex-data ───────────│ │└ ┘──GINIT='DBCS-characters'──(1)

├ ┤──ATTRB=(─┤ att1 ├──┤ att2 ├─) ─────────── │ │┌ ┐─DEFAULT─

├ ┤──COLOR= ──┼ ┼───────── ──────────────────── │ │└ ┘─color─── │ │┌ ┐─BASE─

└ ┘──PS= ──┼ ┼────── ────────────────────────── └ ┘─psid─

att1: ┌ ┐─ASKIP────────────├─ ──┼ ┼────────────────── ────────────────────────────────────────┤ ├ ┤─PROT───────────── └ ┘ ─UNPROT─ ──┬ ┬──────

└ ┘──,NUM

att2:├─ ──┬ ┬────────────────────────── ────────────────────────────────┤ │ │┌ ┐─────────── └ ┘──, ──┬ ┬─BRT── ───

6┴┬ ┬───────

├ ┤─NORM─ ├ ┤──,DET ─└ ┘─DRK── ├ ┤──,IC ──

└ ┘──,FSET

Notes:1 DBCS characters start with a shift-out character X'0E' and end with a

shift-in character X'0F'.

Chapter 1. Command-level application programming 21

Page 42: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DFHMDF (2 of 2)

┌ ┐─,───────────────────────────────55─ ───

6┴┬ ┬─────────────────────────────── ─5%

│ │┌ ┐─,───────────├ ┤──VALIDN=( ───

6┴┬ ┬─────────── ) ───

│ │├ ┤─MUSTFILL── │ │├ ┤─MUSTENTER─ │ │└ ┘─TRIGGER───

├ ┤──GRPNAME=group-name ───────────├ ┤──OCCURS=number ────────────────├ ┤──PICIN='value' ────────────────├ ┤──PICOUT='value' ───────────────├ ┤──OUTLINE= ──┬ ┬─BOX─────────────

│ ││ │┌ ┐─,─────── │ │└ ┘──( ───

6┴┬ ┬─────── )

│ │├ ┤─LEFT── │ │├ ┤─RIGHT─ │ │├ ┤─OVER── │ │└ ┘─UNDER─ │ │┌ ┐─NO──

├ ┤──SOSI= ──┼ ┼───── ─────────────── │ │└ ┘─YES─ │ │┌ ┐─YES─

├ ┤──TRANSP= ──┼ ┼───── ───────────── │ │└ ┘─NO──

└ ┘──CASE=MIXED ───────────────────

Minimum BMS:

22 CICS User’s Handbook

Page 43: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DFHMDI

55─ ──map ──DFHMDI ───────────────────────────────────────────────────────────────5

┌ ┐─,───────────────────────── ┌ ┐─,───────────────────────────────5─ ───

6┴┬ ┬───────────────────────── ───

6┴┬ ┬─────────────────────────────── ─5%

├ ┤──SIZE=(line,column) ───── ├ ┤──PS= ──┬ ┬─BASE─ ────────────────├ ┤──TERM=type ────────────── │ │└ ┘─psid─

│ │┌ ┐─,──────── │ │┌ ┐─,───────────├ ┤──CTRL=( ───

6┴┬ ┬──────── ) ── ├ ┤──VALIDN= ───

6┴┬ ┬─────────── ─────

│ │├ ┤─PRINT── │ │├ ┤─MUSTFILL── │ │├ ┤─length─ │ │├ ┤─MUSTENTER─ │ │├ ┤─FREEKB─ │ │└ ┘─TRIGGER───

│ │├ ┤─ALARM── ├ ┤──COLUMN=number ────────────────│ │└ ┘─FRSET── ├ ┤──LINE=number ──────────────────│ │┌ ┐─NO────── ├ ┤──FIELDS=NO ────────────────────├ ┤──EXTATT= ──┼ ┼───────── ─── │ │┌ ┐─,────────────│ │├ ┤─MAPONLY─ ├ ┤───

6┴MAPATTS=(attr) ─────────────

│ │└ ┘─YES───── │ │┌ ┐─,───────────│ │┌ ┐─DEFAULT─ ├ ┤───

6┴DSATTS=(attr) ──────────────

├ ┤──COLOR= ──┼ ┼───────── ──── ├ ┤──OUTLINE= ──┬ ┬─BOX───────────── │ │└ ┘─color─── │ ││ │┌ ┐─,─────── │ │┌ ┐─NO── │ │└ ┘──( ───

6┴┬ ┬─────── )

├ ┤──CURSLOC= ──┼ ┼───── ────── │ │├ ┤─LEFT── │ │└ ┘─YES─ │ │├ ┤─RIGHT─ │ │┌ ┐─OFF─────── │ │├ ┤─OVER──

└ ┘──HILIGHT= ──┼ ┼─────────── │ │└ ┘─UNDER─ ├ ┤─BLINK───── │ │┌ ┐─NO──

├ ┤─REVERSE─── ├ ┤──SOSI= ──┼ ┼───── ─────────────── └ ┘─UNDERLINE─ │ │└ ┘─YES─ │ │┌ ┐─YES─

├ ┤──TRANSP= ──┼ ┼───── ───────────── │ │└ ┘─NO──

└ ┘──JUSTIFY=BOTTOM ───────────────

Standard BMS:

DFHMDI

┌ ┐─,───────────────────────────────55─ ───

6┴┬ ┬─────────────────────────────── ─5%

├ ┤──PARTN=(name) ──┬ ┬───────────── │ │└ ┘ ─,──ACTIVATE─

├ ┤──OBFMT= ──┬ ┬─YES─ ────────────── │ │└ ┘─NO── │ │┌ ┐─FIELD─

├ ┤──DATA= ──┼ ┼─────── ───────────── │ │└ ┘─BLOCK─ │ │┌ ┐─NO──

├ ┤──TIOAPFX= ──┼ ┼───── ──────────── │ │└ ┘─YES─

└ ┘──FLDSEP= ──┬ ┬─char──────── ─────└ ┘──X'hex-char'

Chapter 1. Command-level application programming 23

Page 44: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

Full BMS:

DFHMDI

┌ ┐─,─────────────────────55─ ───

6┴┬ ┬───────────────────── ─5%

│ │┌ ┐─SAME───├ ┤──COLUMN= ──┼ ┼────────

│ │├ ┤─number─ │ │└ ┘─NEXT─── │ │┌ ┐─NEXT───

├ ┤──LINE= ──┼ ┼──────── ── │ │├ ┤─number─ │ │└ ┘─SAME───

├ ┤──JUSTIFY=(─┤ jst ├─)├ ┤──HEADER=YES ─────────└ ┘──TRAILER=YES ────────

jst: ┌ ┐─LEFT──├─ ──┼ ┼─────── ──┬ ┬────────────── ─┤ └ ┘─RIGHT─ └ ┘──, ──┬ ┬─FIRST─ └ ┘─LAST──

DFHMDX

55─ ──DFHMDX ──MAPSET= ──┬ ┬─name─ ──┬ ┬────────────── ──,MAP= ──┬ ┬─name─ ──────────5└ ┘─\──── └ ┘──,MODULE=name └ ┘─\────

5─ ──┬ ┬─────────────────────────────────────────── ──────────────────────────5└ ┘──,DOCTYPE= ──┬ ┬─'-//W3C//DTD HTML 3.2//EN'─

└ ┘─doctype────────────────────

5─ ──┬ ┬───────────────────── ──┬ ┬────────────────────────────────────── ──────5└ ┘──,TITLE='title-text' └ ┘──,MASTHEAD=url ──┬ ┬───────────────────

└ ┘──,'alternate-text'

5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ──┬ ┬─────────────────── ───5└ ┘──,BACKGROUND=url └ ┘──,BGCOLOR=─┤ color ├─ └ ┘──,TEXT=─┤ color ├─

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──,LINK=─┤ color ├─ └ ┘──,VLINK=─┤ color ├─

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────────────── ────────────────5└ ┘──,ALINK=─┤ color ├─ │ │┌ ┐─,────────────────────

└ ┘──, ───6

┴─┤ key ├─=─┤ button ├─

5─ ──┬ ┬───────────────────────────────── ──┬ ┬───────────────────── ───────────5 │ │┌ ┐─,──────────────────────── │ │┌ ┐─YES────

└ ┘──, ───6

┴─┤ bmscolor ├─=─┤ color ├─ └ ┘──,RESET= ──┼ ┼─NO─────└ ┘──'text'

5─ ──┬ ┬───────────────────────────────────────────────── ────────────────────5 │ │┌ ┐─,───────

└ ┘──,SUPPRESS=( ───6

┴(row,col) ──┬ ┬─────── ──┬ ┬─────── )└ ┘──,HEAD └ ┘──,FOOT

5─ ──┬ ┬──────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ─5%└ ┘──,ONLOAD='text' └ ┘──,ONUNLOAD='text' │ │┌ ┐─NO──

└ ┘──,PROPFONT= ──┴ ┴─YES─

Minimum BMS:

24 CICS User’s Handbook

Page 45: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DFHMSD

55─ ──mapset ──DFHMSD ──TYPE= ──┬ ┬─DSECT─ ──────────────────────────────────────5 ├ ┤─MAP─── └ ┘─FINAL─

┌ ┐─,─────────────────────── ┌ ┐─,───────────────────────────────5─ ───

6┴┬ ┬─────────────────────── ───

6┴┬ ┬─────────────────────────────── ─5%

│ │┌ ┐─OUT─── │ │┌ ┐─NO──├ ┤──MODE= ──┼ ┼─────── ───── ├ ┤──CURSLOC= ──┼ ┼───── ────────────

│ │├ ┤─IN──── │ │└ ┘─YES─ │ │└ ┘─INOUT─ │ │┌ ┐─OFF───────

│ │┌ ┐─LOWER─ ├ ┤──HILIGHT= ──┼ ┼─────────── ──────├ ┤──FOLD= ──┼ ┼─────── ───── │ │├ ┤─BLINK─────

│ │└ ┘─UPPER─ │ │├ ┤─REVERSE─── │ │┌ ┐─NO── │ │└ ┘─UNDERLINE─

├ ┤──TRIGRAPH= ──┼ ┼───── ─── ├ ┤──PS= ──┬ ┬─BASE─ ──────────────── │ │└ ┘─YES─ │ │└ ┘─psid─ │ │┌ ┐─ASM──── │ │┌ ┐─,───────────

├ ┤──LANG= ──┼ ┼──────── ──── ├ ┤──VALIDN= ───6

┴┬ ┬─────────── ───── │ │├ ┤─COBOL── │ │├ ┤─MUSTFILL── │ │├ ┤─COBOL2─ │ │├ ┤─MUSTENTER─ │ │├ ┤─PLI──── │ │├ ┤─TRIGGER───

| │ │└ ┘─C────── │ │└ ┘─USEREXIT──├ ┤──┬ ┬────────────── ───── ├ ┤──┬ ┬──TERM=type ────────────────│ │├ ┤──STORAGE=AUTO │ │└ ┘──SUFFIX=n ─│ │└ ┘──BASE=name ─── │ │┌ ┐─NO──│ │┌ ┐─,──────── ├ ┤──TIOAPFX= ──┼ ┼───── ────────────├ ┤──CTRL=( ───

6┴┬ ┬──────── ) │ │└ ┘─YES─

│ │├ ┤─PRINT── │ │┌ ┐─,────────────│ │├ ┤─length─ ├ ┤───

6┴MAPATTS=(attr) ─────────────

│ │├ ┤─FREEKB─ │ │┌ ┐─,───────────│ │├ ┤─ALARM── ├ ┤───

6┴DSATTS=(attr) ──────────────

│ │└ ┘─FRSET── ├ ┤──OUTLINE= ──┬ ┬─BOX───────────── │ │┌ ┐─NO────── │ ││ │┌ ┐─,───────

├ ┤──EXTATT= ──┼ ┼───────── ─ │ │└ ┘──( ───6

┴┬ ┬─────── ) │ │├ ┤─MAPONLY─ │ │├ ┤─LEFT── │ │└ ┘─YES───── │ │├ ┤─RIGHT─ │ │┌ ┐─DEFAULT─ │ │├ ┤─OVER──

├ ┤──COLOR= ──┼ ┼───────── ── │ │└ ┘─UNDER─ │ │└ ┘─color─── │ │┌ ┐─NO──

| │ │┌ ┐─ADS── ├ ┤──SOSI= ──┼ ┼───── ───────────────| └ ┘──DSECT= ──┼ ┼────── ───── │ │└ ┘─YES─| └ ┘─ADSL─ │ │┌ ┐─YES─

└ ┘──TRANSP= ──┼ ┼───── ───────────── └ ┘─NO──

Standard BMS:

Chapter 1. Command-level application programming 25

Page 46: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DFHMSD

┌ ┐─,───────────────────────────────55─ ───

6┴┬ ┬─────────────────────────────── ─5%

├ ┤──PARTN=(name) ──┬ ┬───────────── │ │└ ┘ ─,──ACTIVATE─

├ ┤──LDC=mnemonic ───────────────── │ │┌ ┐─NO──

├ ┤──OBFMT= ──┼ ┼───── ────────────── │ │└ ┘─YES─ │ │┌ ┐─,─────

├ ┤──HTAB= ───6

┴─ ──tab─ ───────────── │ │┌ ┐─,─────

├ ┤──VTAB= ───6

┴─ ──tab─ ───────────── │ │┌ ┐─FIELD─

├ ┤──DATA= ──┼ ┼─────── ───────────── │ │└ ┘─BLOCK─

└ ┘──FLDSEP= ──┬ ┬─char──────── ─────└ ┘──X'hex-char'

DFHPDI

55─ ── ──┬ ┬─────── ──DFHPDI ──VIEWPOS=(lines,columns) ──────────────────────────5 └ ┘─partn─

┌ ┐─,────────────────────────5─ ──,VIEWSZE=(lines,columns) ───

6┴┬ ┬──────────────────────── ─5%

├ ┤──BUFSZE=(lines,columns)├ ┤──CHARSZE=(vpels,hpels) ─├ ┤──MAPSFX=mapset-suffix ──└ ┘ ─ ─ATTRB=ERROR ───────────

DFHPSD

┌ ┐─,─────────────────────────55─ ──partnset DFHPSD ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──SUFFIX=user-suffix ─────├ ┤──ALTSCRN=(lines,columns)└ ┘──CHARSZE=(vpels,hpels) ──

26 CICS User’s Handbook

Page 47: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DFHWBOUT

55─ ──DFHWBOUT ──'text' ──┬ ┬───────────────────── ─5% │ │┌ ┐─NO── └ ┘─,──SOSI──=─ ──┴ ┴─YES─

DOCUMENT CREATE

55─ ──DOCUMENT ──CREATE ──DOCTOKEN(data-area) ─────────────────────────────────5

5─ ──┬ ┬───────────────────────────────────────────────── ────────────────────5 └ ┘── ──┬ ┬──┬ ┬──FROM(data-area) ── ──LENGTH(data-value)

│ │├ ┤──TEXT(data-area) ──│ │└ ┘──BINARY(data-area)├ ┤──FROMDOC(data-area) ───────────────────────└ ┘──TEMPLATE(name) ───────────────────────────

5─ ──┬ ┬───────────────────────────────────────────── ────────────────────────5 └ ┘──SYMBOLLIST(data-area)LISTLENGTH(data-value)

5─ ──┬ ┬──────────────────── ──┬ ┬──────────────────── ─5%└ ┘──DOCSIZE(data-area) └ ┘──HOSTCODEPAGE(name)

Conditions: INVREQ, NOTFND, SYMBOLERR, TEMPLATERR

DOCUMENT INSERT

55─ ──DOCUMENT ──INSERT ──DOCTOKEN(data-area) ─────────────────────────────────5

5─ ──┬ ┬──┬ ┬──TEXT(data-area) ── ──LENGTH(data-value) ──────────────────────────5│ │├ ┤──BINARY(data-area)│ │└ ┘──FROM(data-area) ──├ ┤──SYMBOL(name) ─────────────────────────────├ ┤──TEMPLATE(name) ───────────────────────────├ ┤──FROMDOC(data-area) ───────────────────────└ ┘──BOOKMARK(name) ───────────────────────────

5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5└ ┘──DOCSIZE(data-value) └ ┘──HOSTCODEPAGE(name)

5─ ──┬ ┬──────────────────────── ─5% └ ┘──AT(name) ──┬ ┬──────────

└ ┘──TO(name)

Conditions: DUPREC, INVREQ, NOTFND, TEMPLATERR

Chapter 1. Command-level application programming 27

Page 48: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

DOCUMENT RETRIEVE

55─ ──DOCUMENT ──RETRIEVE ──DOCTOKEN(data-area) ──INTO(data-area) ──────────────5

5─ ──LENGTH(data-value) ──MAXLENGTH(data-value) ──┬ ┬──────────────────── ──────5└ ┘──CLNTCODEPAGE(name)

5─ ──┬ ┬────────── ─5% └ ┘──DATAONLY

Conditions: LENGERR, NOTFND

DOCUMENT SET

55─ ──DOCUMENT ──SET ──DOCTOKEN(data-area) ────────────────────────────────────5

5─ ──┬ ┬──SYMBOL(name) ──VALUE(data-area) ──LENGTH(data-value) ─5%└ ┘──SYMBOLLIST(data-area) ─────────

Conditions: NOTFND, SYMBOLERR

DUMP TRANSACTION

55─ ──DUMP TRANSACTION ──DUMPCODE(name) ──────────────────────────────────────5

5─ ──┬ ┬────────────────────────────────────────── ── ──┬ ┬────────── ───────────5 └ ┘──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ └ ┘─COMPLETE─

└ ┘──FLENGTH(data-value)

5─ ── ──┬ ┬───── ──────────────────────────────────────────────────────────────5 └ ┘─TRT─

5─ ──┬ ┬──────────────────────────────────────────────────────────────── ─────5 └ ┘─┤ segmentlist ├─ ──LENGTHLIST(data-area) ──NUMSEGMENTS(data-area)

5─ ── ──┬ ┬────── ── ──┬ ┬───────── ── ──┬ ┬───────── ── ──┬ ┬────────── ───────────────5 └ ┘─TASK─ └ ┘─STORAGE─ └ ┘─PROGRAM─ └ ┘─TERMINAL─

5─ ── ──┬ ┬──────── ── ──┬ ┬───── ── ──┬ ┬───── ── ──┬ ┬───── ── ──┬ ┬───── ── ──┬ ┬───── ────5└ ┘─TABLES─ └ ┘─DCT─ └ ┘─FCT─ └ ┘─PCT─ └ ┘─PPT─ └ ┘─SIT─

5─ ── ──┬ ┬───── ──┬ ┬─────────────────── ─5%└ ┘─TCT─ └ ┘──DUMPID(data-area)

segmentlist:├─ ──SEGMENTLIST(data-area) ─┤

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTOPEN,OPENERR, SUPPRESSED

28 CICS User’s Handbook

Page 49: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ENDBR

55─ ──ENDBR ──FILE(filename) ──┬ ┬─────────────────── ──┬ ┬─────────────────── ─5%└ ┘──REQID(data-value) └ ┘──SYSID(systemname)

Conditions: FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ,NOTAUTH, SYSIDERR

ENQ

55─ ──ENQ ──RESOURCE(data-area) ──┬ ┬──────────────────── ──────────────────────5└ ┘──LENGTH(data-value)

┌ ┐─UOW───────────────5─ ──┼ ┼─────────────────── ── ──┬ ┬─────────── ─5%

? ├ ┤──MAXLIFETIME(cvda) └ ┘─NOSUSPEND─ └ ┘─TASK──────────────

Conditions: ENQBUSY, INVREQ, LENGERR

ENTER TRACENUM

55─ ──ENTER TRACENUM(data-value) ────────────────────────────────────────────5

5─ ──┬ ┬──────────────────────────────────────────── ──┬ ┬──────────────── ─────5 └ ┘──FROM(data-area) ──┬ ┬─────────────────────── └ ┘──RESOURCE(name)

? └ ┘──FROMLENGTH(data-area)

5─ ── ──┬ ┬─────────── ─5% └ ┘─EXCEPTION─

? Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming 29

Page 50: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

EXTRACT ATTACH (LUTYPE6.1)

55─ ──EXTRACT ATTACH ──┬ ┬──────────────── ──┬ ┬──────────────────── ────────────5├ ┤──ATTACHID(name) └ ┘──PROCESS(data-area)├ ┤──CONVID(name) ──└ ┘──SESSION(name) ─

5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──RESOURCE(data-area) └ ┘──RPROCESS(data-area)

5─ ──┬ ┬────────────────────── ──┬ ┬────────────────── ─────────────────────────5└ ┘──RRESOURCE(data-area) └ ┘──QUEUE(data-area)

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──┬ ┬────────────────── ─5%└ ┘──IUTYPE(data-area) └ ┘──DATASTR(data-area) └ ┘──RECFM(data-area)

Conditions: CBIDERR, INVREQ, NOTALLOC

EXTRACT ATTACH (MRO)

55─ ──EXTRACT ATTACH ──┬ ┬──────────────── ──┬ ┬──────────────────── ────────────5├ ┤──ATTACHID(name) └ ┘──PROCESS(data-area)├ ┤──CONVID(name) ──└ ┘──SESSION(name) ─

5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──RESOURCE(data-area) └ ┘──RPROCESS(data-area)

5─ ──┬ ┬────────────────────── ──┬ ┬────────────────── ─────────────────────────5└ ┘──RRESOURCE(data-area) └ ┘──QUEUE(data-area)

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──┬ ┬────────────────── ─5%└ ┘──IUTYPE(data-area) └ ┘──DATASTR(data-area) └ ┘──RECFM(data-area)

Conditions: CBIDERR, INVREQ, NOTALLOC

EXTRACT ATTRIBUTES (APPC)

55─ ──EXTRACT ATTRIBUTES ──┬ ┬────────────── ──STATE(cvda) ─5%└ ┘──CONVID(name)

Conditions: INVREQ, NOTALLOC

30 CICS User’s Handbook

Page 51: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

EXTRACT ATTRIBUTES (MRO)

55─ ──EXTRACT ATTRIBUTES ──┬ ┬─────────────── ──STATE(cvda) ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)

Conditions: INVREQ, NOTALLOC

EXTRACT CERTIFICATE

55─ ──EXTRACT CERTIFICATE(ptr-ref) ──┬ ┬─────────────────── ───────────────────5└ ┘──LENGTH(data-area)

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────────── ────────────────────5└ ┘──SERIALNUM(ptr-ref) └ ┘──SERIALNUMLEN(data-area)

┌ ┐─OWNER──5─ ──┬ ┬───────────────── ──┼ ┼──────── ──┬ ┬───────────────────── ───────────────5

└ ┘──USERID(ptr-ref) └ ┘─ISSUER─ └ ┘──COMMONNAME(ptr-ref)

5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────── ──────────────────────5└ ┘──COMMONNAMLEN(data-area) └ ┘──COUNTRY(ptr-ref)

5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────── ──────────────────────────5└ ┘──COUNTRYLEN(data-area) └ ┘──STATE(ptr-ref)

5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ─────────────────────────5└ ┘──STATELEN(data-area) └ ┘──LOCALITY(ptr-ref)

5─ ──┬ ┬──────────────────────── ──┬ ┬─────────────────────── ──────────────────5└ ┘──LOCALITYLEN(data-area) └ ┘──ORGANIZATION(ptr-ref)

5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────── ──────────────────────5└ ┘──ORGANIZATLEN(data-area) └ ┘──ORGUNIT(ptr-ref)

5─ ──┬ ┬─────────────────────── ─5%└ ┘──ORGUNITLEN(data-area)

Conditions: INVREQ, LENGERR

EXTRACT LOGONMSG

55─ ──EXTRACT LOGONMSG ──┬ ┬──INTO(data-area) ──LENGTH(data-area) ─5%└ ┘──SET(ptr-ref) ───

? Condition: NOTALLOC

Chapter 1. Command-level application programming 31

Page 52: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

EXTRACT PROCESS (APPC)

55─ ──EXTRACT PROCESS ───────────────────────────────────────────────────────5

5─ ──┬ ┬──────────────────────────────────────────────────────────── ─────────5 └ ┘──PROCNAME(data-area) ──PROCLENGTH(data-area) ─┤ maxproclen ├─

5─ ──┬ ┬────────────── ──┬ ┬────────────────────── ─────────────────────────────5└ ┘──CONVID(name) └ ┘──SYNCLEVEL(data-area)

5─ ──┬ ┬──────────────────────────────────────── ─5% └ ┘──PIPLIST(ptr-ref) ──PIPLENGTH(data-area)

maxproclen:├─ ──┬ ┬──────────────────────── ─┤

? └ ┘──MAXPROCLEN(data-value)

? Conditions: INVREQ, LENGERR, NOTALLOC

EXTRACT TCT

55─ ──EXTRACT TCT ──NETNAME(name) ──┬ ┬─────────────────── ─5%├ ┤──SYSID(systemname)└ ┘──TERMID(data-area)

? Condition: INVREQ, NOTALLOC

32 CICS User’s Handbook

Page 53: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

FORMATTIME

55─ ──FORMATTIME ──ABSTIME(data-area) ──┬ ┬───────────────── ───────────────────5└ ┘──DATE(data-area)

5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──FULLDATE(data-area) └ ┘──DATEFORM(data-area)

5─ ──┬ ┬─────────────────────────── ──┬ ┬───────────────────── ─────────────────5 └ ┘─DATESEP─ ──┬ ┬────────────── └ ┘──DAYCOUNT(data-area) └ ┘──(data-value)

5─ ──┬ ┬─────────────────────── ──┬ ┬────────────────────── ────────────────────5└ ┘──DAYOFMONTH(data-area) └ ┘──DAYOFWEEK(data-area)

5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ─────────────────────────5└ ┘──DDMMYY(data-area) └ ┘──DDMMYYYY(data-area)

5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ─────────────────────────5└ ┘──MMDDYY(data-area) └ ┘──MMDDYYYY(data-area)

5─ ──┬ ┬──────────────────────── ─────────────────────────────────────────────5└ ┘──MONTHOFYEAR(data-area)

5─ ──┬ ┬──────────────────────────────────────────────── ─────────────────────5 └ ┘──TIME(data-area) ──┬ ┬─────────────────────────── └ ┘ ─TIMESEP─ ──┬ ┬──────────────

└ ┘──(data-value)

5─ ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ───────5└ ┘──YEAR(data-area) └ ┘──YYDDD(data-area) └ ┘──YYDDMM(data-area)

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──YYMMDD(data-area) └ ┘──YYYYDDD(data-area)

5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ─5%└ ┘──YYYYDDMM(data-area) └ ┘──YYYYMMDD(data-area)

Condition: INVREQ

FREE

55─ ──FREE ─5%

Condition: NOTALLOC

FREE (APPC)

55─ ──FREE ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)

Conditions: INVREQ, NOTALLOC

Chapter 1. Command-level application programming 33

Page 54: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

FREE (LUTYPE6.1)

55─ ──FREE ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)

Conditions: INVREQ, NOTALLOC

FREE (MRO)

55─ ──FREE ──┬ ┬─────────────── ──┬ ┬───────────── ─5%? ├ ┤──CONVID(name) ─ └ ┘──STATE(cvda)

└ ┘──SESSION(name)

Conditions: INVREQ, NOTALLOC

FREEMAIN

55─ ──FREEMAIN ──┬ ┬──DATA(data-area) ─────── ─5%└ ┘──DATAPOINTER(ptr-value)

Condition: INVREQ

GDS ALLOCATE (APPC basic)

55─ ──GDS ALLOCATE ──┬ ┬──SYSID(systemname) ──┬ ┬──────────────── ───────────────5│ │└ ┘──MODENAME(name)

? └ ┘──PARTNER(name) ────────────────────────

5─ ──CONVID(data-area) ──RETCODE(data-area) ── ──┬ ┬───────── ───────────────────5 └ ┘─NOQUEUE─

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

34 CICS User’s Handbook

Page 55: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

GDS ASSIGN (APPC basic)

55─ ──GDS ASSIGN ──┬ ┬─────────────────────── ──┬ ┬────────────────────── ───────5└ ┘──PRINCONVID(data-area) └ ┘──PRINSYSID(data-area)

5─ ──RETCODE(data-area) ─5%

GDS CONNECT PROCESS (APPC basic)

55─ ──GDS CONNECT PROCESS ──CONVID(name) ─────────────────────────────────────5

5─ ──┬ ┬──PROCNAME(name) ──┬ ┬──────────────────────── ─────────────────────────5│ │└ ┘──PROCLENGTH(data-value)

? └ ┘──PARTNER(name) ─────────────────────────────

5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──PIPLIST(data-area) ──┬ ┬───────────────────────

└ ┘──PIPLENGTH(data-value)

5─ ──SYNCLEVEL(data-value) ──CONVDATA(data-area) ──RETCODE(data-area) ─────────5

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS EXTRACT ATTRIBUTES (APPC basic)

55─ ──GDS EXTRACT ATTRIBUTES ──CONVID(name) ──┬ ┬───────────── ─────────────────5└ ┘──STATE(cvda)

5─ ──CONVDATA(data-area) ──RETCODE(data-area) ─5%

GDS EXTRACT PROCESS (APPC basic)

55─ ──GDS EXTRACT PROCESS ──CONVID(name) ─────────────────────────────────────5

5─ ──┬ ┬──────────────────────────────────────────────────────────── ─────────5 └ ┘──PROCNAME(data-area) ──PROCLENGTH(data-area) ─┤ maxproclen ├─

5─ ──┬ ┬────────────────────── ───────────────────────────────────────────────5└ ┘──SYNCLEVEL(data-area)

5─ ──┬ ┬──────────────────────────────────────────── ──RETCODE(data-area) ─5% └ ┘──PIPLIST(pointer-ref) ──PIPLENGTH(data-area)

maxproclen:├─ ──┬ ┬──────────────────────── ─┤

? └ ┘──MAXPROCLEN(data-value)

Chapter 1. Command-level application programming 35

Page 56: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

GDS FREE (APPC basic)

55─ ──GDS FREE ──CONVID(name) ──CONVDATA(data-area) ──RETCODE(data-area) ───────5

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS ISSUE ABEND (APPC basic)

55─ ──GDS ISSUE ABEND ──CONVID(name) ──CONVDATA(data-area) ────────────────────5

5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS ISSUE CONFIRMATION (APPC basic)

55─ ──GDS ISSUE CONFIRMATION ──CONVID(name) ──CONVDATA(data-area) ─────────────5

5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS ISSUE ERROR (APPC basic)

55─ ──GDS ISSUE ERROR ──CONVID(name) ──CONVDATA(data-area) ────────────────────5

5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS ISSUE PREPARE (APPC basic)

55─ ──GDS ISSUE PREPARE ──CONVID(name) ──CONVDATA(data-area) ──────────────────5

5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

36 CICS User’s Handbook

Page 57: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

GDS ISSUE SIGNAL (APPC basic)

55─ ──GDS ISSUE SIGNAL ──CONVID(name) ──CONVDATA(data-area) ───────────────────5

5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS RECEIVE (APPC basic)

55─ ──GDS RECEIVE ──CONVID(name) ──┬ ┬──INTO(data-area) ─ ──FLENGTH(data-area) ───5└ ┘──SET(pointer-ref)

5─ ──┬ ┬──────────────────────── ──┬ ┬─BUFFER─ ──CONVDATA(data-area) ────────────5└ ┘──MAXFLENGTH(data-value) └ ┘─LLID───

5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS SEND (APPC basic)

55─ ──GDS SEND ──CONVID(name) ──┬ ┬────────────────────────────────────── ──────5 └ ┘──FROM(data-area) ──FLENGTH(data-value)

5─ ──┬ ┬──────── ──┬ ┬───────── ──CONVDATA(data-area) ──RETCODE(data-area) ───────5 ├ ┤─INVITE─ ├ ┤─CONFIRM─ └ ┘─LAST─── └ ┘─WAIT────

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

GDS WAIT (APPC basic)

55─ ──GDS WAIT ──CONVID(name) ──CONVDATA(data-area) ──RETCODE(data-area) ───────5

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

Chapter 1. Command-level application programming 37

Page 58: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

GETMAIN

55─ ──GETMAIN ──SET(ptr-ref) ──┬ ┬──FLENGTH(data-value) ──┬ ┬─────── ─────────────5 │ │└ ┘─BELOW─

└ ┘──LENGTH(data-value) ────────────

5─ ──┬ ┬───────────────────── ── ──┬ ┬──────── ── ──┬ ┬─────────── ─────────────────5└ ┘──INITIMG(data-value) └ ┘─SHARED─ └ ┘─NOSUSPEND─

5─ ──┬ ┬───────────── ─5%? ├ ┤─USERDATAKEY─? └ ┘─CICSDATAKEY─

Conditions: LENGERR, NOSTG

HANDLE ABEND

┌ ┐─CANCEL────────55─ ──HANDLE ABEND ──┼ ┼─────────────── ─5%

├ ┤──PROGRAM(name)├ ┤──LABEL(label) ─

└ ┘─RESET─────────

? Conditions: NOTAUTH, PGMIDERR (PROGRAM only)

HANDLE AID

┌ ┐───────────────────────────55─ ──HANDLE AID ───

6┴┬ ┬─────────────────────── ─5%

├ ┤ ─ANYKEY─ ──┬ ┬───────── ──│ │└ ┘──(label)

├ ┤ ─CLEAR─ ──┬ ┬───────── ───│ │└ ┘──(label)

├ ┤ ─CLRPARTN─ ──┬ ┬─────────│ │└ ┘──(label)

├ ┤ ─ENTER─ ──┬ ┬───────── ───│ │└ ┘──(label)

├ ┤ ─LIGHTPEN─ ──┬ ┬─────────│ │└ ┘──(label)

├ ┤ ─OPERID─ ──┬ ┬───────── ──│ │└ ┘──(label)

├ ┤ ─PA1-PA3─ ──┬ ┬───────── ─│ │└ ┘──(label)

├ ┤ ─PF1-PF24─ ──┬ ┬─────────│ │└ ┘──(label)

└ ┘ ─TRIGGER─ ──┬ ┬───────── ─└ ┘──(label)

Condition: INVREQ

38 CICS User’s Handbook

Page 59: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

HANDLE CONDITION

┌ ┐──────────────────────────55─ ──HANDLE CONDITION ───

6┴─condition─ ──┬ ┬───────── ─5%

└ ┘──(label)

IGNORE CONDITION

┌ ┐─────────────55─ ──IGNORE CONDITION ───

6┴─condition─ ─5%

ISSUE ABEND (APPC)

55─ ──ISSUE ABEND ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ABORT

55─ ──ISSUE ABORT ──┬ ┬──────────────────────────────────────────────── ───────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────

│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─

5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────

└ ┘──VOLUMELENG(data-value)

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

Chapter 1. Command-level application programming 39

Page 60: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ISSUE ADD

55─ ──ISSUE ADD ──DESTID(data-value) ──┬ ┬──────────────────────── ─────────────5└ ┘──DESTIDLENG(data-value)

5─ ──VOLUME(data-value) ──┬ ┬──────────────────────── ──FROM(data-area) ────────5└ ┘──VOLUMELENG(data-value)

5─ ──┬ ┬──────────────────── ──┬ ┬──────────────────── ── ──┬ ┬───────── ──────────5└ ┘──LENGTH(data-value) └ ┘──NUMREC(data-value) └ ┘─DEFRESP─

5─ ── ──┬ ┬──────── ──┬ ┬──────────────────────── ─5% └ ┘─NOWAIT─ └ ┘──RIDFLD(data-area) ─RRN─

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE CONFIRMATION (APPC)

55─ ──ISSUE CONFIRMATION ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE COPY (3270 display)

55─ ──ISSUE COPY ──TERMID(name) ──┬ ┬───────────────────── ── ──┬ ┬────── ─5%└ ┘──CTLCHAR(data-value) └ ┘─WAIT─

? Condition: NOTALLOC, TERMIDERR

ISSUE COPY (3270 logical)

55─ ──ISSUE COPY ──TERMID(name) ──┬ ┬───────────────────── ── ──┬ ┬────── ─5%└ ┘──CTLCHAR(data-value) └ ┘─WAIT─

? Conditions: LENGERR, NOTALLOC, TERMERR

40 CICS User’s Handbook

Page 61: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ISSUE DISCONNECT (default)

55─ ──ISSUE DISCONNECT ─5%

Conditions: SIGNAL, TERMERR

ISSUE DISCONNECT (LUTYPE6.1)

55─ ──ISSUE DISCONNECT ──┬ ┬─────────────── ─5%└ ┘──SESSION(name)

Conditions: NOTALLOC, TERMERR

ISSUE END

55─ ──ISSUE END ──┬ ┬──────────────────────────────────────────────── ─────────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────

│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─

5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────

└ ┘──VOLUMELENG(data-value)

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ENDFILE

55─ ──ISSUE ENDFILE ── ──┬ ┬─────────── ─5% └ ┘─ENDOUTPUT─

? Condition: INVREQ, NOTALLOC

Chapter 1. Command-level application programming 41

Page 62: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ISSUE ENDOUTPUT

55─ ──ISSUE ENDOUTPUT ── ──┬ ┬───────── ─5% └ ┘─ENDFILE─

? Condition: INVREQ, NOTALLOC

ISSUE EODS

55─ ──ISSUE EODS ─5%

? Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ERASE

55─ ──ISSUE ERASE ──DESTID(data-value) ──┬ ┬──────────────────────── ───────────5└ ┘──DESTIDLENG(data-value)

5─ ──VOLUME(data-value) ──┬ ┬──────────────────────── ──RIDFLD(data-area) ──────5└ ┘──VOLUMELENG(data-value)

5─ ──┬ ┬──KEYLENGTH(data-value) ──┬ ┬─────────────────────── ───────────────────5│ │└ ┘──KEYNUMBER(data-value)

└ ┘─RRN──────────────────────────────────────────────

5─ ──┬ ┬──────────────────── ── ──┬ ┬───────── ── ──┬ ┬──────── ─5%└ ┘──NUMREC(data-value) └ ┘─DEFRESP─ └ ┘─NOWAIT─

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ERASEAUP

55─ ──ISSUE ERASEAUP ── ──┬ ┬────── ─5% └ ┘─WAIT─

? Conditions: INVREQ, NOTALLOC, TERMERR

42 CICS User’s Handbook

Page 63: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ISSUE ERROR (APPC)

55─ ──ISSUE ERROR ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE LOAD

55─ ──ISSUE LOAD ──PROGRAM(name) ── ──┬ ┬────────── ─5% └ ┘─CONVERSE─

? Conditions: NONVAL, NOTALLOC, NOSTART, TERMERR

ISSUE NOTE

55─ ──ISSUE NOTE ──DESTID(data-value) ──┬ ┬──────────────────────── ────────────5└ ┘──DESTIDLENG(data-value)

5─ ──VOLUME(data-value) ──┬ ┬──────────────────────── ──RIDFLD(data-area) ──────5└ ┘──VOLUMELENG(data-value)

5─ ──RRN ─5%

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE PASS

55─ ──ISSUE PASS ──LUNAME(name) ──┬ ┬───────────────────────────────────── ─────5 └ ┘──FROM(data-area) ──LENGTH(data-value)

5─ ──┬ ┬───────────────────── ── ──┬ ┬─────────── ─5%? ├ ┤──LOGMODE(data-value) └ ┘─NOQUIESCE─? └ ┘─LOGONLOGMODE────────

? Conditions: INVREQ, LENGERR, NOTALLOC

Chapter 1. Command-level application programming 43

Page 64: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ISSUE PREPARE (APPC)

55─ ──ISSUE PREPARE ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)

? Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE PRINT

55─ ──ISSUE PRINT ─5%

? Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE QUERY

55─ ──ISSUE QUERY ──DESTID(data-value) ──┬ ┬──────────────────────── ───────────5└ ┘──DESTIDLENG(data-value)

5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────

└ ┘──VOLUMELENG(data-value)

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE RECEIVE

55─ ──ISSUE RECEIVE ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ─5%└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)

Conditions: DSSTAT, EOC, EODS, INVREQ, LENGERR, UNEXPIN

44 CICS User’s Handbook

Page 65: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ISSUE REPLACE

55─ ──ISSUE REPLACE ──DESTID(data-value) ──┬ ┬──────────────────────── ─────────5└ ┘──DESTIDLENG(data-value)

5─ ──┬ ┬──────────────────────────────────────────────── ──FROM(data-area) ────5 └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────

└ ┘──VOLUMELENG(data-value)

5─ ──┬ ┬──────────────────── ──┬ ┬──────────────────── ──RIDFLD(data-area) ──────5└ ┘──LENGTH(data-value) └ ┘──NUMREC(data-value)

5─ ──┬ ┬──KEYLENGTH(data-value) ──┬ ┬─────────────────────── ── ──┬ ┬───────── ────5│ │└ ┘──KEYNUMBER(data-value) └ ┘─DEFRESP─

└ ┘─RRN──────────────────────────────────────────────

5─ ── ──┬ ┬──────── ─5% └ ┘─NOWAIT─

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE RESET

55─ ──ISSUE RESET ─5%

Condition: INVREQ, NOTALLOC

ISSUE SEND

55─ ──ISSUE SEND ──┬ ┬──────────────────────────────────────────────── ────────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────

│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─

5─ ──┬ ┬──────────────────────────────────────────────── ──FROM(data-area) ────5 └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────

└ ┘──VOLUMELENG(data-value)

5─ ──┬ ┬──────────────────── ── ──┬ ┬──────── ── ──┬ ┬───────── ─5%└ ┘──LENGTH(data-value) └ ┘─NOWAIT─ └ ┘─DEFRESP─

Conditions: FUNCERR, IGREQCD, INVREQ, SELNERR, UNEXPIN

Chapter 1. Command-level application programming 45

Page 66: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ISSUE SIGNAL (APPC)

55─ ──ISSUE SIGNAL ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)

? Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE SIGNAL (LUTYPE6.1)

55─ ──ISSUE SIGNAL ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)

Conditions: NOTALLOC, TERMERR

ISSUE WAIT

55─ ──ISSUE WAIT ──┬ ┬──────────────────────────────────────────────── ────────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────

│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─

5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────

└ ┘──VOLUMELENG(data-value)

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

46 CICS User’s Handbook

Page 67: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

LINK

55─ ──LINK ──PROGRAM(name) ──┬ ┬────────────────────────────────── ─────────────5 └ ┘──COMMAREA(data-area) ─┤ lengths ├─

5─ ──┬ ┬ ──┬ ┬─────────────────── ──┬ ┬────────────── ──┬ ┬─────────────── ─5% │ │└ ┘──SYSID(systemname) └ ┘ ─SYNCONRETURN─ └ ┘──TRANSID(name) └ ┘──INPUTMSG(data-area) ──┬ ┬───────────────────────── ────────── └ ┘──INPUTMSGLEN(data-value)

lengths:├─ ──┬ ┬──────────────────── ──┬ ┬─────────────────────── ─┤ └ ┘──LENGTH(data-value) └ ┘──DATALENGTH(data-area)

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR,ROLLEDBACK, SYSIDERR, TERMERR

LOAD

55─ ──LOAD ──PROGRAM(name) ──┬ ┬────────────── ──┬ ┬──────────────────── ─────────5└ ┘──SET(ptr-ref) ├ ┤──LENGTH(data-area) ─

└ ┘──FLENGTH(data-area)

5─ ──┬ ┬──────────────── ── ──┬ ┬────── ─5%└ ┘──ENTRY(ptr-ref) └ ┘─HOLD─

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR

MONITOR

55─ ──MONITOR ──POINT(data-value) ──┬ ┬────────────────── ──────────────────────5└ ┘──DATA1(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%└ ┘──DATA2(data-area) └ ┘──ENTRYNAME(data-area)

Condition: INVREQ

Chapter 1. Command-level application programming 47

Page 68: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

POINT

55─ ──POINT ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)

Condition: NOTALLOC

POP HANDLE

55─ ──POP HANDLE ─5%

Condition: INVREQ

POST

┌ ┐──INTERVAL(ð) ─────────────────────55─ ──POST ──┼ ┼────────────────────────────────── ──SET(ptr-ref) ──────────────5 ├ ┤──INTERVAL(hhmmss) ──────────────── ├ ┤──TIME(hhmmss) ──────────────────── │ │┌ ┐───────────────────────── ├ ┤ ─AFTER─ ───

6┴┬ ┬──HOURS(data-value) ──

│ │├ ┤──MINUTES(data-value) │ │└ ┘──SECONDS(data-value) │ │┌ ┐───────────────────────── └ ┘ ─AT─ ───

6┴┬ ┬──HOURS(data-value) ── ───

├ ┤──MINUTES(data-value) └ ┘──SECONDS(data-value)

5─ ──┬ ┬───────────── ─5% └ ┘──REQID(name)

Conditions: EXPIRED, INVREQ

PURGE MESSAGE

55─ ──PURGE MESSAGE ─5%

Conditions: Full BMS: INVREQ, TSIOERR

48 CICS User’s Handbook

Page 69: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

PUSH HANDLE

55─ ──PUSH HANDLE ─5%

QUERY SECURITY

55─ ──QUERY SECURITY ──┬ ┬──RESTYPE(data-value) ────────────────────────── ─────5 └ ┘──RESCLASS(data-value) ──RESIDLENGTH(data-value)

5─ ──RESID(data-value) ──┬ ┬────────────────── ──┬ ┬──────────── ────────────────5└ ┘──LOGMESSAGE(cvda) └ ┘──READ(cvda)

5─ ──┬ ┬────────────── ──┬ ┬─────────────── ──┬ ┬───────────── ─5%└ ┘──UPDATE(cvda) └ ┘──CONTROL(cvda) └ ┘──ALTER(cvda)

Conditions: INVREQ, LENGERR, NOTFND, QIDERR

READ

┌ ┐─UNCOMMITTED──────────────────55─ ──READ ──FILE(filename) ──┼ ┼────────────────────────────── ────────────────5 ├ ┤─CONSISTENT─────────────────── ├ ┤─REPEATABLE─────────────────── └ ┘ ─UPDATE─ ──┬ ┬──────────────────

└ ┘──TOKEN(data-area)

5─ ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ──RIDFLD(data-area) ──────────5└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)

5─ ──┬ ┬──────────────────────────────────── ──┬ ┬─────────────────── ──────────5 └ ┘──KEYLENGTH(data-value) ──┬ ┬───────── └ ┘──SYSID(systemname) └ ┘─GENERIC─

┌ ┐─EQUAL─5─ ──┬ ┬──────── ──┼ ┼─────── ──┬ ┬─────────── ─5% ├ ┤─RBA──── └ ┘─GTEQ── └ ┘─NOSUSPEND─ ├ ┤─RRN──── ├ ┤─DEBKEY─ └ ┘─DEBREC─

Conditions: DISABLED, DUPKEY, FILENOTFOUND, ILLOGIC,INVREQ, IOERR, ISCINVREQ, LENGERR, LOADING, LOCKED,NOTAUTH, NOTFND, NOTOPEN, RECORDBUSY, SYSIDERR

Chapter 1. Command-level application programming 49

Page 70: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

READNEXT

55─ ──READNEXT ──FILE(filename) ──┬ ┬──INTO(data-area) ─────────────────────────5└ ┘──SET(ptr-ref) ───

┌ ┐─UNCOMMITTED──────────────5─ ──┼ ┼────────────────────────── ──┬ ┬─────────────────── ────────────────────5

├ ┤─CONSISTENT─────────────── └ ┘──LENGTH(data-area) ├ ┤─REPEATABLE─────────────── └ ┘─UPDATE─ ──TOKEN(data-area)

5─ ──RIDFLD(data-area) ──┬ ┬─────────────────────── ──┬ ┬─────────────────── ────5└ ┘──KEYLENGTH(data-value) └ ┘──REQID(data-value)

5─ ──┬ ┬─────────────────── ──┬ ┬───── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA─ └ ┘─NOSUSPEND─

└ ┘─RRN─

Conditions: DUPKEY, ENDFILE, FILENOTFOUND, ILLOGIC, INVREQ,| IOERR, ISCINVREQ, LENGERR, LOADING, LOCKED, NOTAUTH,

NOTFND, RECORDBUSY, SYSIDERR

READPREV

55─ ──READPREV ──FILE(filename) ──┬ ┬──INTO(data-area) ─────────────────────────5└ ┘──SET(ptr-ref) ───

┌ ┐─UNCOMMITTED──────────────5─ ──┼ ┼────────────────────────── ──┬ ┬─────────────────── ────────────────────5

├ ┤─CONSISTENT─────────────── └ ┘──LENGTH(data-area) ├ ┤─REPEATABLE─────────────── └ ┘─UPDATE─ ──TOKEN(data-area)

5─ ──RIDFLD(data-area) ──┬ ┬─────────────────────── ──┬ ┬─────────────────── ────5└ ┘──KEYLENGTH(data-value) └ ┘──REQID(data-value)

5─ ──┬ ┬─────────────────── ──┬ ┬───── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA─ └ ┘─NOSUSPEND─

└ ┘─RRN─

Conditions: DUPKEY, ENDFILE, FILENOTFOUND, ILLOGIC, INVREQ,IOERR, ISCINVREQ, LENGERR, LOCKED, NOTAUTH, NOTFND,RECORDBUSY, SYSIDERR

50 CICS User’s Handbook

Page 71: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

READQ TD

55─ ──READQ TD ──QUEUE(name) ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ─────5└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)

5─ ──┬ ┬─────────────────── ── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) └ ┘─NOSUSPEND─

Conditions: DISABLED, INVREQ, IOERR, ISCINVREQ, LENGERR,LOCKED, NOTAUTH, NOTOPEN, QBUSY, QIDERR, QZERO,SYSIDERR

READQ TS

55─ ──READQ TS ──┬ ┬──QUEUE(name) ──┬ ┬──INTO(data-area) ────────────────────────5└ ┘──QNAME(name) └ ┘──SET(ptr-ref) ───

┌ ┐─NEXT─────────────5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ──┼ ┼────────────────── ───5

└ ┘──LENGTH(data-area) └ ┘──NUMITEMS(data-area) └ ┘──ITEM(data-value)

5─ ──┬ ┬─────────────────── ─5%└ ┘──SYSID(systemname)

Conditions: INVREQ, IOERR, ISCINVREQ, ITEMERR, LENGERR,NOTAUTH, QIDERR, SYSIDERR

RECEIVE (APPC)

55─ ──RECEIVE ──┬ ┬────────────── ──┬ ┬──INTO(data-area) ────────────────────────5└ ┘──CONVID(name) └ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──LENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───5└ ┘──FLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

Conditions: EOC, INVREQ, LENGERR, NOTALLOC, SIGNAL,TERMERR

Chapter 1. Command-level application programming 51

Page 72: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (default)

55─ ──RECEIVE ──┬ ┬───────────────── ──────────────────────────────────────────5 ├ ┤──INTO(data-area) └ ┘──SET(ptr-ref) ───

5─ ──LENGTH(data-value) ──FLENGTH(data-value) ──┬ ┬────────────────────── ──────5 └ ┘──MAXLENGTH(data-area)

5─ ─NOTRUNCATE──5%

Conditions: INVREQ, LENGERR, NOTALLOC

RECEIVE (LUTYPE2/LUTYPE3)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬────── ── ──┬ ┬──────── ───────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─ASIS─ └ ┘─BUFFER─└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─

Conditions: EOC, INVREQ, LENGERR, TERMERR

RECEIVE (LUTYPE4)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR

52 CICS User’s Handbook

Page 73: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (LUTYPE6.1)

55─ ──RECEIVE ──┬ ┬─────────────── ──┬ ┬──INTO(data-area) ───────────────────────5└ ┘──SESSION(name) └ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──LENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘──FLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, INBFMH, INVREQ, LENGERR, NOTALLOC,SIGNAL, TERMERR

RECEIVE (MRO)

55─ ──RECEIVE ──┬ ┬─────────────── ──┬ ┬──INTO(data-area) ───────────────────────5└ ┘──SESSION(name) └ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──LENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───5└ ┘──FLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─

└ ┘──MAXFLENGTH(data-value)

5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

Conditions: EOC, INBFMH, INVREQ, LENGERR, NOTALLOC,TERMERR

RECEIVE (System/3)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming 53

Page 74: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (System/7)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ── ──┬ ┬─────────── ── ──┬ ┬────── ─5% └ ┘─PSEUDOBIN─ └ ┘─ASIS─

Conditions: INVREQ, LENGERR

RECEIVE (2260)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬───────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─LEAVEKB─└ ┘──MAXFLENGTH(data-value)

Conditions: INVREQ, LENGERR

RECEIVE (2741)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: INVREQ, LENGERR, RDATT

54 CICS User’s Handbook

Page 75: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (2980)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──PASSBK ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: INVREQ, LENGERR, NOPASSBKRD

RECEIVE (3270 display)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ───────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────── ─5% └ ┘─BUFFER─

Conditions: INVREQ, LENGERR

RECEIVE (3270 logical)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬────── ── ──┬ ┬──────── ───────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─ASIS─ └ ┘─BUFFER─└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming 55

Page 76: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (3600 BTAM)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: INVREQ, LENGERR

RECEIVE (3600 pipeline)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: INVREQ, LENGERR, NOTALLOC

RECEIVE (3600-3601)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR

56 CICS User’s Handbook

Page 77: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (3600-3614)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE (3650)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, TERMERR

RECEIVE (3735)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOF, INVREQ, LENGERR

Chapter 1. Command-level application programming 57

Page 78: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (3740)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOF, ENDINPT, INVREQ, LENGERR

RECEIVE (3767)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, INVREQ, LENGERR, SIGNAL, TERMERR

RECEIVE (3770)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR

58 CICS User’s Handbook

Page 79: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE (3790 full-function or inquiry)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)

Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR

RECEIVE (3790 3270-display)

55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)

└ ┘──SET(ptr-ref) ───

5─ ──┬ ┬──────────────────────── ── ──┬ ┬────── ── ──┬ ┬──────── ───────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─ASIS─ └ ┘─BUFFER─└ ┘──MAXFLENGTH(data-value)

5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming 59

Page 80: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RECEIVE MAP

55─ ──RECEIVE MAP(name) ──┬ ┬────────────── ──┬ ┬───────────────── ──────────────5└ ┘──MAPSET(name) ├ ┤──INTO(data-area)

└ ┘──SET(ptr-ref) ───

┌ ┐─TERMINAL────────────────────────────────5─ ──┼ ┼───────────────────────────────────────── ─5% ├ ┤──FROM(data-area) ──┬ ┬────────────────────

│ │└ ┘──LENGTH(data-value) └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬─────────────── ──

└ ┘─ASIS─ └ ┘──INPARTN(name)

Conditions: EOC, EODS, INVMPSZ, INVPARTN, INVREQ, MAPFAIL,PARTNFAIL, RDATT, UNEXPIN

Note: INPARTN is supported by Standard and full BMS

RECEIVE MAP MAPPINGDEV

55─ ──RECEIVE MAP(name) ──MAPPINGDEV(data-value) ──FROM(data-area) ────────────5

5─ ──┬ ┬──────────────────── ──┬ ┬────────────── ──┬ ┬───────────────── ─5%└ ┘──LENGTH(data-value) └ ┘──MAPSET(name) ├ ┤──INTO(data-area)

└ ┘──SET(ptr-ref) ───

Conditions: INVMPSZ, INVREQ, MAPFAIL,

RECEIVE PARTN

55─ ──RECEIVE PARTN(data-area) ─5%

Standard and full BMS:

RECEIVE PARTN

55─ ──┬ ┬──INTO(data-area) ──LENGTH(data-value) ── ──┬ ┬────── ─5%└ ┘──SET(ptr-ref) ─── └ ┘─ASIS─

Conditions: EOC, EODS, INVPARTN, INVREQ, LENGERR

60 CICS User’s Handbook

Page 81: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RELEASE

55─ ──RELEASE ──PROGRAM(name) ─5%

Conditions: INVREQ, NOTAUTH, PGMIDERR

RESETBR

55─ ──RESETBR ──FILE(filename) ──RIDFLD(data-area) ────────────────────────────5

5─ ──┬ ┬──────────────────────────────────── ──┬ ┬─────────────────── ──────────5 └ ┘──KEYLENGTH(data-value) ──┬ ┬───────── └ ┘──REQID(data-value) └ ┘─GENERIC─

┌ ┐─GTEQ──5─ ──┬ ┬─────────────────── ──┼ ┼─────── ──┬ ┬───── ─5%

└ ┘──SYSID(systemname) └ ┘─EQUAL─ ├ ┤─RBA─ └ ┘─RRN─

Conditions: FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ,NOTAUTH, NOTFND, SYSIDERR

RETRIEVE

55─ ──RETRIEVE ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ──────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)

5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5└ ┘──RTRANSID(data-area) └ ┘──RTERMID(data-area)

5─ ──┬ ┬────────────────── ── ──┬ ┬────── ─5%└ ┘──QUEUE(data-area) └ ┘─WAIT─

Conditions: ENDDATA, ENVDEFERR, INVREQ, IOERR, LENGERR,NOTFND

Chapter 1. Command-level application programming 61

Page 82: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

RETURN

55─ ──RETURN ──┬ ┬──────────────────────────────────────────────── ────────────5 └ ┘──TRANSID(name) ──┬ ┬────────────── ──┬ ┬───────────

└ ┘─┤ commarea ├─ └ ┘ ─IMMEDIATE─

5─ ──┬ ┬────────────────────────────────────────────────── ───────────────────5 └ ┘──INPUTMSG(data-area) ──┬ ┬───────────────────────── └ ┘──INPUTMSGLEN(data-value)

5─ ──┬ ┬───────────── ─5%| └ ┘| ─ENDACTIVITY─

commarea:├─ ──COMMAREA(data-area) ──┬ ┬──────────────────── ─┤ └ ┘──LENGTH(data-value)

Conditions: INVREQ, LENGERR

REWRITE

55─ ──REWRITE ──FILE(filename) ──┬ ┬────────────────── ──FROM(data-area) ────────5└ ┘──TOKEN(data-area)

5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ── ──┬ ┬─────────── ─5%└ ┘──LENGTH(data-value) └ ┘──SYSID(systemname) └ ┘─NOSUSPEND─

| Conditions: CHANGED, DUPREC, FILENOTFOUND, ILLOGIC,INVREQ, IOERR, ISCINVREQ, LENGERR, LOCKED, NOSPACE,NOTAUTH, NOTFND, RECORDBUSY, SYSIDERR

62 CICS User’s Handbook

Page 83: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

ROUTE

┌ ┐──INTERVAL(ð) ─────────────────────55─ ──ROUTE ──┼ ┼────────────────────────────────── ──┬ ┬───────────────────── ──5

├ ┤ ─ ─INTERVAL(hhmmss) ──────────────── └ ┘ ─ERRTERM─ ──┬ ┬────────├ ┤──TIME(hhmmss) ──────────────────── └ ┘──(name)

│ │┌ ┐───────────────────────── ├ ┤─AFTER─ ───

6┴┬ ┬──HOURS(data-value) ──

│ │├ ┤──MINUTES(data-value)│ │└ ┘──SECONDS(data-value)

│ │┌ ┐───────────────────────── └ ┘─AT─ ───

6┴┬ ┬──HOURS(data-value) ── ───

├ ┤──MINUTES(data-value)└ ┘──SECONDS(data-value)

5─ ──┬ ┬────────────────── ──┬ ┬───────────────── ──┬ ┬──────────────────── ──────5└ ┘──TITLE(data-area) └ ┘──LIST(data-area) └ ┘──OPCLASS(data-area)

5─ ──┬ ┬───────────── ──┬ ┬─────────── ── ──┬ ┬─────── ─5%└ ┘──REQID(name) └ ┘──LDC(name) └ ┘─NLEOM─

Conditions: IGREQID, INVERRTERM, INVLDC, INVREQ, RTEFAIL,RTESOME

SEND (APPC)

55─ ──SEND ──┬ ┬────────────── ──┬ ┬────────────────────────────────────────── ──5└ ┘──CONVID(name) └ ┘──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─

└ ┘──FLENGTH(data-value)

5─ ──┬ ┬──────── ──┬ ┬───────── ──┬ ┬───────────── ─5%? ├ ┤─INVITE─ ├ ┤─CONFIRM─ └ ┘──STATE(cvda)

└ ┘─LAST─── └ ┘─WAIT────

Conditions: INVREQ, LENGERR, NOTALLOC, SIGNAL, TERMERR

SEND (default)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)

5─ ── ──┬ ┬────── ─5% └ ┘─WAIT─

Conditions: INVREQ, LENGERR, NOTALLOC

Chapter 1. Command-level application programming 63

Page 84: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (LUTYPE2/LUTYPE3)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────5 ├ ┤─INVITE─ │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) └ ┘─LAST─── │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────

5─ ── ──┬ ┬───────── ─5% └ ┘─DEFRESP─

Conditions: INVREQ, LENGERR, TERMERR

SEND (LUTYPE4)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, IGREQCD, LENGERR, SIGNAL, TERMERR

SEND (LUTYPE6.1)

55─ ──SEND ──┬ ┬─────────────── ── ──┬ ┬────── ──┬ ┬──────── ──┬ ┬──────────────── ───5└ ┘──SESSION(name) └ ┘─WAIT─ ├ ┤─INVITE─ └ ┘──ATTACHID(name)

└ ┘─LAST───

5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ── ──┬ ┬───── ────────────────5└ ┘──FROM(data-area) ├ ┤──LENGTH(data-value) ─ └ ┘─FMH─

└ ┘──FLENGTH(data-value)

5─ ── ──┬ ┬───────── ─5% └ ┘─DEFRESP─

Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, SIGNAL,TERMERR

64 CICS User’s Handbook

Page 85: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (MRO)

55─ ──SEND ──┬ ┬─────────────── ── ──┬ ┬────── ──┬ ┬──────── ──┬ ┬──────────────── ───5└ ┘──SESSION(name) └ ┘─WAIT─ ├ ┤─INVITE─ └ ┘──ATTACHID(name)

└ ┘─LAST───

5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ── ──┬ ┬───── ────────────────5└ ┘──FROM(data-area) ├ ┤──LENGTH(data-value) ─ └ ┘─FMH─

└ ┘──FLENGTH(data-value)

5─ ── ──┬ ┬───────── ──┬ ┬───────────── ─5%? └ ┘─DEFRESP─ └ ┘──STATE(cvda)

Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, TERMERR

SEND (SCS)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬────────── ── ──┬ ┬───── ─5%├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─STRFIELD─ └ ┘─FMH─

└ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, TERMERR

SEND (System/3)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)

5─ ── ──┬ ┬────── ── ──┬ ┬────── ── ──┬ ┬─────────── ─5% └ ┘─WAIT─ └ ┘─ASIS─ └ ┘─CNOTCOMPL─

Conditions: INVREQ, LENGERR

SEND (System/7)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)

5─ ── ──┬ ┬────── ── ──┬ ┬─────────── ── ──┬ ┬────── ─5% └ ┘─WAIT─ └ ┘─PSEUDOBIN─ └ ┘─ASIS─

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming 65

Page 86: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (2260)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)

5─ ──┬ ┬───────────────────── ──┬ ┬──────────── ──┬ ┬────────────────────── ──────5└ ┘──CTLCHAR(data-value) └ ┘──DEST(name) └ ┘──LINEADDR(data-value)

5─ ── ──┬ ┬────── ── ──┬ ┬───────── ─5% └ ┘─WAIT─ └ ┘─LEAVEKB─

Conditions: INVREQ, LENGERR

SEND (2741)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)

5─ ── ──┬ ┬────── ─5% └ ┘─WAIT─

Conditions: INVREQ, LENGERR, WRBRK

SEND (2980)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)

5─ ──┬ ┬─PASSBK─ ─5% └ ┘─CBUFF──

Conditions: INVREQ, LENGERR, NOPASSBKWR

SEND (3270 display)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)

5─ ── ──┬ ┬────── ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ─5% └ ┘─WAIT─ │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────

Conditions: INVREQ, LENGERR

66 CICS User’s Handbook

Page 87: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (3270 logical)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────5 ├ ┤─INVITE─ │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) └ ┘─LAST─── │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────

5─ ── ──┬ ┬───────── ─5% └ ┘─DEFRESP─

Conditions: INVREQ, LENGERR, TERMERR

SEND (3600 BTAM)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─

Conditions: INVREQ, LENGERR

SEND (3600 pipeline)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ─5%└ ┘──FLENGTH(data-value) └ ┘─WAIT─

Conditions: INVREQ, LENGERR, TERMERR

SEND (3600-3601)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬─────────── ─────────5└ ┘──FLENGTH(data-value) ├ ┤──LDC(name)

└ ┘─FMH───────

5─ ── ──┬ ┬────── ──┬ ┬──────── ──┬ ┬─────────── ─5% └ ┘─WAIT─ ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

Chapter 1. Command-level application programming 67

Page 88: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (3600-3614)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650 interpreter)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ── ──┬ ┬───────── ── ──┬ ┬───── ─5%├ ┤─INVITE─ └ ┘─DEFRESP─ └ ┘─FMH─

└ ┘─LAST───

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3270)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)

5─ ──┬ ┬───────────────────── ── ──┬ ┬────── ──┬ ┬────────────────────── ──────────5└ ┘──CTLCHAR(data-value) └ ┘─WAIT─ └ ┘ ─ERASE─ ──┬ ┬───────────

├ ┤─DEFAULT─── └ ┘─ALTERNATE─

5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, TERMERR

68 CICS User’s Handbook

Page 89: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (3650-3653)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3680)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, TERMERR

SEND (3735)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─

Conditions: INVREQ, LENGERR

SEND (3740)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming 69

Page 90: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (3767)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3770)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3790 full-function or inquiry)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3790 SCS)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─

5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───

Conditions: INVREQ, LENGERR, TERMERR

70 CICS User’s Handbook

Page 91: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND (3790 3270-display)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)

5─ ──┬ ┬───────────────────── ── ──┬ ┬────── ──┬ ┬────────────────────── ──────────5└ ┘──CTLCHAR(data-value) └ ┘─WAIT─ └ ┘ ─ERASE─ ──┬ ┬───────────

├ ┤─DEFAULT─── └ ┘─ALTERNATE─

5─ ──┬ ┬──────── ── ──┬ ┬───────── ─5% ├ ┤─INVITE─ └ ┘─DEFRESP─ └ ┘─LAST───

Conditions: INVREQ, LENGERR, TERMERR

SEND (3790 3270-printer)

55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)

5─ ──┬ ┬───────────────────── ── ──┬ ┬────── ──┬ ┬────────────────────── ──────────5└ ┘──CTLCHAR(data-value) └ ┘─WAIT─ └ ┘ ─ERASE─ ──┬ ┬───────────

├ ┤─DEFAULT─── └ ┘─ALTERNATE─

5─ ──┬ ┬──────── ── ──┬ ┬───────── ─5% ├ ┤─INVITE─ └ ┘─DEFRESP─ └ ┘─LAST───

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming 71

Page 92: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND CONTROL

55─ ──SEND CONTROL ─5%

Minimum BMS:

SEND CONTROL

55─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ──────────────────────────5 └ ┘ ─CURSOR─ ──┬ ┬────────────── └ ┘─FORMFEED─ └ ┘──(data-value)

5─ ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ───────5 ├ ┤ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─ERASEAUP─────────────

5─ ── ──┬ ┬─────── ─5% └ ┘─FRSET─

Standard BMS:

SEND CONTROL

55─ ──┬ ┬───────────────── ──┬ ┬ ──┬ ┬──────────────── ──┬ ┬──────────────── ─5%└ ┘──MSR(data-value) │ │└ ┘──OUTPARTN(name) └ ┘──ACTPARTN(name)

└ ┘──LDC(name) ─────────────────────────────

Full BMS:

72 CICS User’s Handbook

Page 93: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND CONTROL

┌ ┐─TERMINAL─────────────────────55─ ── ──┬ ┬─────── ──┼ ┼────────────────────────────── ──┬ ┬───────────── ────────5

└ ┘─ACCUM─ ├ ┤──SET(ptr-ref) ──────────────── └ ┘──REQID(name) ├ ┤─PAGING─────────────────────── └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─

┌ ┐─HONEOM─5─ ──┼ ┼──────── ─5% ├ ┤─L4ð──── ├ ┤─L64──── └ ┘─L8ð────

Conditions: IGREQCD, IGREQID, INVLDC, INVPARTN, INVREQ,RETPAGE, TSIOERR, WRBRK

Chapter 1. Command-level application programming 73

Page 94: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND MAP

55─ ──SEND MAP(name) ─5%

Minimum BMS:

SEND MAP

55─ ──┬ ┬────────────── ──────────────────────────────────────────────────────5└ ┘──MAPSET(name)

5─ ──┬ ┬ ──┬ ┬───────────────── ──┬ ┬────────── ──┬ ┬──────────────────── ──────────5│ │└ ┘──FROM(data-area) └ ┘─DATAONLY─ └ ┘──LENGTH(data-value)

└ ┘─MAPONLY───────────────────────────────────────────────────

5─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ───────────────────────────5 └ ┘ ─CURSOR─ ──┬ ┬────────────── └ ┘─FORMFEED─

└ ┘──(data-value)

5─ ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ───────5 ├ ┤ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─ERASEAUP─────────────

5─ ── ──┬ ┬─────── ─5% └ ┘─FRSET─

Standard BMS:

SEND MAP

55─ ── ──┬ ┬─────── ──┬ ┬───────────────── ──┬ ┬─────────────── ───────────────────5└ ┘─NLEOM─ └ ┘──MSR(data-value) └ ┘──FMHPARM(name)

5─ ──┬ ┬ ──┬ ┬──────────────── ──┬ ┬──────────────── ─5%│ │└ ┘──OUTPARTN(name) └ ┘──ACTPARTN(name)└ ┘──LDC(name) ─────────────────────────────

Full BMS:

74 CICS User’s Handbook

Page 95: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND MAP

┌ ┐─TERMINAL─────────────────────55─ ── ──┬ ┬─────── ──┼ ┼────────────────────────────── ──┬ ┬───────────── ────────5

└ ┘─ACCUM─ ├ ┤──SET(ptr-ref) ──────────────── └ ┘──REQID(name) ├ ┤─PAGING─────────────────────── └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─

┌ ┐─HONEOM─5─ ── ──┬ ┬───────── ──┼ ┼──────── ─5% └ ┘─NOFLUSH─ ├ ┤─L4ð──── ├ ┤─L64──── └ ┘─L8ð────

Conditions: IGREQCD, IGREQID, INVLDC, INVMPSZ, INVPARTN,INVREQ, OVERFLOW, RETPAGE, TSIOERR, WRBRK

Minimum BMS:

SEND MAP

55─ ──SEND MAP(name) ──MAPPINGDEV(data-value) ──SET(ptr-ref) ──────────────────5

5─ ──┬ ┬────────────── ───────────────────────────────────────────────────────5└ ┘──MAPSET(name)

5─ ──┬ ┬ ──┬ ┬───────────────── ──┬ ┬────────── ──┬ ┬──────────────────── ──────────5│ │└ ┘──FROM(data-area) └ ┘─DATAONLY─ └ ┘──LENGTH(data-value)

└ ┘─MAPONLY───────────────────────────────────────────────────

5─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ──┬ ┬────────── ─────────────5 └ ┘ ─CURSOR─ ──┬ ┬────────────── └ ┘─FORMFEED─ ├ ┤─ERASE────

└ ┘──(data-value) └ ┘─ERASEAUP─

5─ ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ── ──┬ ┬─────── ─5% └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ └ ┘─FRSET─

Conditions: INVMPSZ, INVREQ

Chapter 1. Command-level application programming 75

Page 96: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND PAGE

55─ ──SEND PAGE ──┬ ┬ ─RELEASE─ ──┬ ┬─────────────── ──┬ ┬──────────────────── ─────5│ │└ ┘──TRANSID(name) └ ┘──TRAILER(data-area)

└ ┘─RETAIN─────────────────────

5─ ──┬ ┬────────────── ──┬ ┬─────────────────────── ── ──┬ ┬─────────── ───────────5└ ┘──SET(ptr-ref) ├ ┤ ─AUTOPAGE─ ──┬ ┬───────── └ ┘─OPERPURGE─

│ │├ ┤─CURRENT─ │ │└ ┘─ALL───── └ ┘─NOAUTOPAGE────────────

5─ ──┬ ┬─────────────── ── ──┬ ┬────── ─5%└ ┘──FMHPARM(name) └ ┘─LAST─

Conditions: IGREQCD, INVREQ, RETPAGE, TSIOERR, WRBRK

SEND PARTNSET

55─ ─SEND PARTNSET─ ──┬ ┬──────── ─5%└ ┘──(name)

Conditions: INVPARTNSET, INVREQ

SEND TEXT

55─ ──SEND TEXT ─5%

Standard BMS:

SEND TEXT

55─ ──FROM(data-area) ──┬ ┬──────────────────── ──┬ ┬──────────────────── ───────5└ ┘──LENGTH(data-value) └ ┘──CURSOR(data-value)

5─ ── ──┬ ┬────────── ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ────5 └ ┘─FORMFEED─ └ ┘ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ ├ ┤─DEFAULT─── └ ┘─ALTERNATE─

5─ ── ──┬ ┬─────── ── ──┬ ┬─────── ──┬ ┬─────────────── ────────────────────────────5└ ┘─ALARM─ └ ┘─NLEOM─ └ ┘──FMHPARM(name)

5─ ──┬ ┬ ──┬ ┬──────────────── ──┬ ┬──────────────── ──┬ ┬───────────────── ─5%│ │└ ┘──OUTPARTN(name) └ ┘──ACTPARTN(name) └ ┘──MSR(data-value)└ ┘──LDC(name) ─────────────────────────────

76 CICS User’s Handbook

Page 97: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

Full BMS:

SEND TEXT

┌ ┐─TERMINAL─────────────────────55─ ──┼ ┼────────────────────────────── ──┬ ┬───────────── ─────────────────────5

├ ┤──SET(ptr-ref) ──────────────── └ ┘──REQID(name) ├ ┤─PAGING─────────────────────── └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──HEADER(data-area) └ ┘──TRAILER(data-area)

┌ ┐─HONEOM─5─ ──┬ ┬───────────────────── ── ──┬ ┬─────── ──┼ ┼──────── ─5%

├ ┤──JUSTIFY(data-value) └ ┘─ACCUM─ ├ ┤─L4ð──── ├ ┤─JUSFIRST──────────── ├ ┤─L64──── └ ┘─JUSLAST───────────── └ ┘─L8ð────

Conditions: IGREQCD, IGREQID, INVLDC, INVPARTN, INVREQ,LENGERR, RETPAGE, TSIOERR, WRBRK

SEND TEXT MAPPED

55─ ──SEND TEXT MAPPED ──FROM(data-area) ──┬ ┬──────────────────── ─────────────5└ ┘──LENGTH(data-value)

┌ ┐─TERMINAL─────────────────────5─ ──┼ ┼────────────────────────────── ──┬ ┬───────────── ─5%

├ ┤─PAGING─────────────────────── └ ┘──REQID(name) └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─

Conditions: IGREQCD, IGREQID, INVREQ, TSIOERR, WRBRK

Chapter 1. Command-level application programming 77

Page 98: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SEND TEXT NOEDIT

55─ ──SEND TEXT NOEDIT ──FROM(data-area) ──┬ ┬──────────────────── ─────────────5└ ┘──LENGTH(data-value)

5─ ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ───────5 └ ┘ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ ├ ┤─DEFAULT─── └ ┘─ALTERNATE─

┌ ┐─TERMINAL─────────────────────5─ ──┬ ┬──────────────── ──┼ ┼────────────────────────────── ───────────────────5

└ ┘──OUTPARTN(name) ├ ┤ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── │ │└ ┘─WAIT─ └ ┘─LAST─ └ ┘─PAGING───────────────────────

┌ ┐─HONEOM─5─ ──┬ ┬───────────── ──┼ ┼──────── ─5%

└ ┘──REQID(name) ├ ┤─L4ð──── ├ ┤─L64──── └ ┘─L8ð────

Conditions: IGREQCD, IGREQID, INVREQ, INVPARTN, TSIOERR,WRBRK

SIGNOFF

55─ ──SIGNOFF ─5%

Condition: INVREQ

SIGNON

55─ ──SIGNON ──USERID(data-value) ──┬ ┬────────────────────── ──────────────────5└ ┘──ESMREASON(data-area)

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──ESMRESP(data-area) └ ┘──GROUPID(data-value)

5─ ──┬ ┬────────────────────────── ──┬ ┬────────────────────── ─────────────────5├ ┤──LANGUAGECODE(data-value) └ ┘──LANGINUSE(data-area)└ ┘──NATLANG(data-value) ─────

5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────────── ──────────────────5└ ┘──NATLANGINUSE(data-area) └ ┘──PASSWORD(data-value)

5─ ──┬ ┬───────────────────────── ──┬ ┬───────────────────── ─5%└ ┘──NEWPASSWORD(data-value) └ ┘──OIDCARD(data-value)

Conditions: INVREQ, NOTAUTH, USERIDERR

78 CICS User’s Handbook

Page 99: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SPOOLCLOSE TOKEN

┌ ┐─────────────────────55─ ──SPOOLCLOSE ──TOKEN(data-area) ──┬ ┬──────── ───

6┴┬ ┬─NOHANDLE──────── ─5%

├ ┤─KEEP─── └ ┘ ─RESP─ ──┬ ┬─────── └ ┘─DELETE─ └ ┘─RESP2─

Conditions: ALLOCERR, INVREQ, NOSPOOL, NOSTG, NOTFND,NOTOPEN, STRELERR

SPOOLOPEN INPUT

55─ ──SPOOLOPEN INPUT ──TOKEN(data-area) ──USERID(data-value) ─────────────────5

┌ ┐─────────────────────5─ ──┬ ┬─────────────────── ───

6┴┬ ┬─NOHANDLE──────── ─5%

└ ┘──CLASS(data-value) └ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─

Conditions: ALLOCERR, ILLOGIC, INVREQ, NOSPOOL, NOSTG,NOTAUTH, NOTFND, NOTOPEN, OPENERR, SPOLBUSY, SPOLERR,STRELERR

SPOOLOPEN OUTPUT

55─ ──SPOOLOPEN OUTPUT ──TOKEN(data-area) ──USERID(data-value) ────────────────5

5─ ──NODE(data-value) ──┬ ┬─────────────────── ──┬ ┬─────────────────── ─────────5└ ┘──CLASS(data-value) └ ┘──OUTDESCR(ptr-ref)

┌ ┐─NOCC─ ┌ ┐─PRINT───────────────────────────────5─ ──┼ ┼────── ──┼ ┼───────────────────────────────────── ──────────────────────5 ├ ┤─ASA── ├ ┤ ─PRINT─ ──┬ ┬──────────────────────────

└ ┘─MCC── │ │└ ┘──RECORDLENGTH(data-value) └ ┘─PUNCH───────────────────────────────

┌ ┐─────────────────────5─ ───

6┴┬ ┬─NOHANDLE──────── ─5%

└ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─

Conditions: ALLOCERR, ILLOGIC, INVREQ, LENGERR, NODEIDERR,NOSPOOL, NOSTG, NOTFND, NOTOPEN, OPENERR,OUTDESCERR, SPOLBUSY, STRELERR

Chapter 1. Command-level application programming 79

Page 100: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

SPOOLREAD

55─ ──SPOOLREAD ──TOKEN(data-area) ──INTO(data-area) ──────────────────────────5

5─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ───────────────────5└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)

┌ ┐─────────────────────5─ ───

6┴┬ ┬─NOHANDLE──────── ─5%

└ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─

Conditions: ALLOCERR, ENDFILE, ILLOGIC, INVREQ, LENGERR,NOSPOOL, NOSTG, NOTFND, NOTOPEN, SPOLBUSY, SPOLERR,STRELERR

SPOOLWRITE

55─ ──SPOOLWRITE ──TOKEN(data-area) ──FROM(data-area) ─────────────────────────5

┌ ┐─LINE─ ┌ ┐─────────────────────5─ ──┬ ┬───────────────────── ──┼ ┼────── ───

6┴┬ ┬─NOHANDLE──────── ─5%

└ ┘──FLENGTH(data-value) └ ┘─PAGE─ └ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─

Conditions: ALLOCERR, INVREQ, LENGERR, NOSPOOL, NOSTG,NOTOPEN, SPOLBUSY, SPOLERR, STRELERR

80 CICS User’s Handbook

Page 101: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

START

┌ ┐──INTERVAL(ð) ─────────────────────55─ ──START ──TRANSID(name) ──┼ ┼────────────────────────────────── ────────────5

├ ┤ ─ ─INTERVAL(hhmmss) ────────────────├ ┤──TIME(hhmmss) ────────────────────

│ │┌ ┐───────────────────────── ├ ┤─AFTER─ ───

6┴┬ ┬──HOURS(data-value) ──

│ │├ ┤──MINUTES(data-value)│ │└ ┘──SECONDS(data-value)

│ │┌ ┐───────────────────────── └ ┘─AT─ ───

6┴┬ ┬──HOURS(data-value) ── ───

├ ┤──MINUTES(data-value)└ ┘──SECONDS(data-value)

5─ ──┬ ┬───────────── ──┬ ┬────────────────────────────────────────────── ──────5└ ┘──REQID(name) └ ┘──FROM(data-area) ──LENGTH(data-value) ──┬ ┬─────

└ ┘─FMH─

5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ──────5├ ┤──TERMID(name) ────── └ ┘──SYSID(systemname) └ ┘──RTRANSID(name)└ ┘──USERID(data-value)

5─ ──┬ ┬─────────────── ──┬ ┬───────────── ── ──┬ ┬───────── ── ──┬ ┬───────── ─5%└ ┘──RTERMID(name) └ ┘──QUEUE(name) └ ┘─NOCHECK─ └ ┘─PROTECT─

Conditions: INVREQ, IOERR, ISCINVREQ, LENGERR, NOTAUTH,SYSIDERR, TERMIDERR, TRANSIDERR, USERIDERR

START ATTACH

55─ ──START ATTACH ──TRANSID(name) ──┬ ┬───────────────────────────────────── ─5% └ ┘──FROM(data-area) ──LENGTH(data-value)

Conditions: INVREQ, LENGERR, NOTAUTH, TRANSIDERR

START BREXIT

55─ ──START ──┬ ┬─BREXIT─────── ──TRANSID(name) ────────────────────────────────5└ ┘──BREXIT(name)

5─ ──┬ ┬───────────────────────────────────────────── ────────────────────────5 └ ┘──BRDATA(data-area) ──BRDATALENGTH(data-value)

5─ ──┬ ┬──────────────────── ─5%└ ┘──USERID(data-value)

Conditions: INVREQ,LENGERR, NOTAUTH, PGMIDERR,TRANSIDERR, USERIDERR

Chapter 1. Command-level application programming 81

Page 102: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

STARTBR

55─ ──STARTBR ──FILE(filename) ──RIDFLD(data-area) ────────────────────────────5

5─ ──┬ ┬──────────────────────────────────── ──┬ ┬─────────────────── ──────────5 └ ┘──KEYLENGTH(data-value) ──┬ ┬───────── └ ┘──REQID(data-value) └ ┘─GENERIC─

5─ ──┬ ┬─────────────────── ──┬ ┬──────── ──┬ ┬─────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA──── ├ ┤─GTEQ──

├ ┤─RRN──── └ ┘─EQUAL─ ├ ┤─DEBKEY─ └ ┘─DEBREC─

Conditions: DISABLED, FILENOTFOUND, ILLOGIC, INVREQ, IOERR,ISCINVREQ, LOADING, NOTAUTH, NOTFND, NOTOPEN, SYSIDERR

SUSPEND

55─ ──SUSPEND ─5%

SYNCPOINT

55─ ──SYNCPOINT ─5%

Conditions: INVREQ, ROLLEDBACK

SYNCPOINT ROLLBACK

55─ ──SYNCPOINT ──ROLLBACK ─5%

Condition: INVREQ

82 CICS User’s Handbook

Page 103: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

EXTRACT TCPIP

55─ ──EXTRACT ──TCPIP ──┬ ┬─────────────────────────────────────────────── ─────5 └ ┘──CLIENTNAME(data-area) ──CNAMELENGTH(data-area)

5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──SERVERNAME(data-area) ──SNAMELENGTH(data-area)

5─ ──┬ ┬──CLIENTADDR(data-area) ──CADDRLENGTH(data-area) ──┬ ┬─────────────── ───5├ ┤──CLIENTADDRNU(data-area) ────────────────────── └ ┘──SSLTYPE(cvda)

├ ┤──SERVERADDR(data-area) ──SADDRLENGTH(data-area)└ ┘──SERVERADDRNU(data-area) ──────────────────────

5─ ──┬ ┬───────────────────────── ──┬ ┬─────────────────────── ─────────────────5└ ┘──TCPIPSERVICE(data-area) └ ┘──PORTNUMBER(data-area)

5─ ──┬ ┬────────────────────── ─5%└ ┘──PORTNUMNU(data-area)

Conditions: INVREQ, LENGERR

UNLOCK

55─ ──UNLOCK ──FILE(filename) ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5% └ ┘──TOKEN(data-area) └ ┘──SYSID(systemname)

Conditions: DISABLED, FILENOTFOUND, ILLOGIC, INVREQ, IOERR,ISCINVREQ, NOTAUTH, NOTOPEN, SYSIDERR

VERIFY PASSWORD

55─ ──VERIFY PASSWORD(data-value) ──USERID(data-value) ───────────────────────5

5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────── ─────────────────────5└ ┘──CHANGETIME(data-area) └ ┘──DAYSLEFT(data-area)

5─ ──┬ ┬────────────────────── ──┬ ┬──────────────────── ───────────────────────5└ ┘──ESMREASON(data-area) └ ┘──ESMRESP(data-area)

5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────────── ─────────────────5└ ┘──EXPIRYTIME(data-area) └ ┘──INVALIDCOUNT(data-area)

5─ ──┬ ┬──────────────────────── ─5%└ ┘──LASTUSETIME(data-area)

Conditions: INVREQ, NOTAUTH, USERIDERR

Chapter 1. Command-level application programming 83

Page 104: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

WAIT CONVID (APPC)

55─ ──WAIT CONVID(name) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)

Conditions: INVREQ, NOTALLOC

WAIT EVENT

55─ ──WAIT EVENT ──ECADDR(ptr-value) ──┬ ┬──────────── ─5%? └ ┘──NAME(name)

Condition: INVREQ

WAIT EXTERNAL

55─ ──WAIT EXTERNAL ──ECBLIST(ptr-value) ──NUMEVENTS(data-value) ──────────────5

┌ ┐─PURGEABLE──────────5─ ──┼ ┼──────────────────── ──┬ ┬──────────── ─5%

? ├ ┤──PURGEABILITY(cvda) └ ┘──NAME(name) └ ┘─NOTPURGEABLE───────

Condition: INVREQ

WAIT JOURNALNAME

55─ ──WAIT JOURNALNAME(data-value) ──┬ ┬─────────────────── ─5%└ ┘──REQID(data-value)

Conditions: INVREQ, IOERR, JIDERR, NOTOPEN

84 CICS User’s Handbook

Page 105: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

WAIT SIGNAL

55─ ──WAIT SIGNAL ─5%

Conditions: NOTALLOC, SIGNAL, TERMERR

WAIT TERMINAL

55─ ──WAIT TERMINAL ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)

Conditions: INVREQ, NOTALLOC, SIGNAL

WAITCICS

55─ ──WAITCICS ──ECBLIST(ptr-value) ──NUMEVENTS(data-value) ───────────────────5

┌ ┐─PURGEABLE──────────5─ ──┼ ┼──────────────────── ──┬ ┬──────────── ─5%

? ├ ┤──PURGEABILITY(cvda) └ ┘──NAME(name) └ ┘─NOTPURGEABLE───────

Condition: INVREQ

WEB ENDBROWSE

55─ ──WEB ──ENDBROWSE ──HTTPHEADER ─5%

Conditions: INVREQ

Chapter 1. Command-level application programming 85

Page 106: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

WEB EXTRACT

55─ ──WEB ──EXTRACT ──┬ ┬──────────────────────────────────────────────── ──────5 └ ┘──HTTPMETHOD(data-area) ──METHODLENGTH(data-area)

5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──HTTPVERSION(data-area) ──VERSIONLEN(data-area)

5─ ──┬ ┬──────────────────────────────────────── ──┬ ┬─────────────────── ─5% └ ┘──PATH(data-area) ──PATHLENGTH(data-area) └ ┘──REQUESTTYPE(cvda)

Conditions: INVREQ, LENGERR

WEB READ

55─ ──WEB ──READ ──HTTPHEADER(data-area) ──NAMELENGTH(data-value) ──────────────5

5─ ──VALUE(data-area) ──VALUELENGTH(data-area) ─5%

Conditions: INVREQ, LENGERR, NOTFND

WEB READNEXT

55─ ──WEB ──READNEXT ──HTTPHEADER(data-area) ──NAMELENGTH(data-area) ───────────5

5─ ──VALUE(data-area) ──VALUELENGTH(data-area) ─5%

Conditions: ENDFILE, INVREQ, LENGERR

WEB RECEIVE

55─ ──WEB ──RECEIVE ──┬ ┬──INTO(data-area) ──LENGTH(data-area) ──────────────────5└ ┘──SET(ptr-ref) ───

5─ ──MAXLENGTH(data-value) ──┬ ┬──────────── ──┬ ┬──────────── ──────────────────5└ ┘──TYPE(cvda) └ ┘──NOTRUNCATE

5─ ──┬ ┬──────────────────────────────────────── ─5% └ ┘──CLNTCODEPAGE(name) ──HOSTCODEPAGE(name)

Conditions: INVREQ, LENGERR

86 CICS User’s Handbook

Page 107: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

WEB RETRIEVE

55─ ──WEB ──RETRIEVE ──DOCTOKEN(data-area) ─5%

Conditions: INVREQ

WEB SEND

55─ ──WEB ──SEND ──DOCTOKEN(name) ──┬ ┬──────────────────── ─────────────────────5└ ┘──CLNTCODEPAGE(name)

5─ ──┬ ┬──────────────────────── ─────────────────────────────────────────────5└ ┘──STATUSCODE(data-value)

5─ ──┬ ┬─────────────────────────────────────────── ─5% └ ┘──STATUSTEXT(data-area) ──LENGTH(data-value)

Conditions: INVREQ, NOTFND

WEB STARTBROWSE

55─ ──WEB ──STARTBROWSE ──HTTPHEADER ─5%

Conditions: INVREQ

WEB WRITE

55─ ──WEB ──WRITE ──HTTPHEADER(data-area) ──NAMELENGTH(data-value) ─────────────5

5─ ──VALUE(data-area) ──VALUELENGTH(data-value) ─5%

Conditions: INVREQ

Chapter 1. Command-level application programming 87

Page 108: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

WRITE

55─ ──WRITE ──FILE(filename) ── ──┬ ┬──────────── ──FROM(data-area) ──────────────5 └ ┘─MASSINSERT─

5─ ──┬ ┬──────────────────── ──RIDFLD(data-area) ──┬ ┬─────────────────────── ───5└ ┘──LENGTH(data-value) └ ┘──KEYLENGTH(data-value)

5─ ──┬ ┬─────────────────── ──┬ ┬───── ── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA─ └ ┘─NOSUSPEND─

└ ┘─RRN─

Conditions: DISABLED, DUPREC, FILENOTFOUND, ILLOGIC,INVREQ, IOERR, ISCINVREQ, LENGERR, LOADING, LOCKED,NOSPACE, NOTAUTH, NOTOPEN, RECORDBUSY, SUPPRESSED,SYSIDERR

WRITE JOURNALNAME

55─ ──WRITE JOURNALNAME(data-value) ──JTYPEID(data-value) ──FROM(data-area) ───5

5─ ──┬ ┬───────────────────── ──┬ ┬────────────────── ──────────────────────────5└ ┘──FLENGTH(data-value) └ ┘──REQID(data-area)

5─ ──┬ ┬───────────────────────────────────────────── ── ──┬ ┬────── ────────────5 └ ┘──PREFIX(data-value) ──┬ ┬───────────────────── └ ┘─WAIT─

└ ┘──PFXLENG(data-value)

5─ ── ──┬ ┬─────────── ─5% └ ┘─NOSUSPEND─

Conditions: INVREQ, IOERR, JIDERR, LENGERR, NOJBUFSP,NOTAUTH, NOTOPEN

88 CICS User’s Handbook

Page 109: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

WRITE OPERATOR

55─ ──WRITE OPERATOR ──TEXT(data-value) ──┬ ┬─────────────────────── ───────────5 └ ┘──TEXTLENGTH(data-area)

5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──ROUTECODES(data-value) ──NUMROUTES(data-value)

┌ ┐ ─EVENTUAL───────────────────────────────────────────────5─ ──┼ ┼──────────────────────────────────────────────────────── ─5% ├ ┤──ACTION(cvda) ────────────────────────────────────────── ├ ┤ ─CRITICAL─────────────────────────────────────────────── ├ ┤ ─IMMEDIATE────────────────────────────────────────────── └ ┘──REPLY(data-area) ─┤ lengths ├─ ──┬ ┬───────────────────── └ ┘──TIMEOUT(data-value)

lengths:├─ ──MAXLENGTH(data-area) ──┬ ┬──────────────────────── ─┤ └ ┘──REPLYLENGTH(data-area)

Conditions: EXPIRED, INVREQ, LENGERR

WRITEQ TD

55─ ──WRITEQ TD ──QUEUE(name) ──FROM(data-area) ──┬ ┬──────────────────── ───────5└ ┘──LENGTH(data-value)

5─ ──┬ ┬─────────────────── ─5%└ ┘──SYSID(systemname)

Conditions: DISABLED, INVREQ, IOERR, ISCINVREQ, LENGERR,LOCKED, NOSPACE, NOTAUTH, NOTOPEN, QIDERR, SYSIDERR

WRITEQ TS

55─ ──WRITEQ TS ──┬ ┬──QUEUE(name) ──FROM(data-area) ──┬ ┬──────────────────── ───5└ ┘──QNAME(name) └ ┘──LENGTH(data-value)

5─ ──┬ ┬────────────────────────────── ──┬ ┬─────────────────── ────────────────5├ ┤──NUMITEMS(data-area) ───────── └ ┘──SYSID(systemname)

└ ┘──ITEM(data-area) ──┬ ┬───────── └ ┘─REWRITE─

┌ ┐─AUXILIARY─5─ ──┼ ┼─────────── ── ──┬ ┬─────────── ─5% └ ┘─MAIN────── └ ┘─NOSUSPEND─

Conditions: INVREQ, IOERR, ISCINVREQ, ITEMERR, LENGERR,LOCKED, NOSPACE, NOTAUTH, QIDERR, SYSIDERR

Chapter 1. Command-level application programming 89

Page 110: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

API syntax

XCTL

55─ ──XCTL ──PROGRAM(name) ──┬ ┬───────────────────────────────────────────── ──5 └ ┘──COMMAREA(data-area) ──┬ ┬────────────────────

└ ┘──LENGTH(data-value)

5─ ──┬ ┬────────────────────────────────────────────────── ─5% └ ┘──INPUTMSG(data-area) ──┬ ┬─────────────────────────

└ ┘──INPUTMSGLEN(data-value)

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR

90 CICS User’s Handbook

Page 111: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

Chapter 2. SPI command syntax

This chapter contains General-use Programming Interface information.

ACQUIRE TERMINAL

55─ ──ACQUIRE TERMINAL(data-value) ──┬ ┬────────────────────── ────────────────5 ├ ┤─NOQUEUE────────────── ├ ┤ ─QALL─ ──┬ ┬──────── ──── │ │└ ┘─RELREQ─ ├ ┤ ─QNOTENAB───────────── └ ┘ ─QSESSLIM─ ──┬ ┬──────── └ ┘─RELREQ─

5─ ──┬ ┬─────────────────────────────────────────────────── ─5% └ ┘──USERDATA(data-value) ──┬ ┬─────────────────────────

└ ┘──USERDATALEN(data-value)

Conditions: INVREQ, LENGERR, NOTAUTH, TERMIDERR

Copyright IBM Corp. 1989, 1999 91

Page 112: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

COLLECT STATISTICS

55─ ──COLLECT STATISTICS SET(ptr-ref) ──┬ ┬────────────────────── ─────────────5├ ┤──LASTRESET(data-area)└ ┘─┤ COL3 ├─────────────

5─ ──┬ ┬─AUTOINSTALL────────────────────────────── ─5%├ ┤──CONNECTION(data-value) ──────────────────

├ ┤─DB2CONN──────────────────────────────────├ ┤ ─ ─DB2ENTRY(data-value) ────────────────────

├ ┤─DISPATCHER─────────────────────────────── ├ ┤─ENQUEUE──────────────────────────────────

├ ┤──FILE(data-value) ────────────────────────├ ┤──JOURNALNAME(data-value) ─────────────────├ ┤──JOURNALNUM(data-value) ──────────────────├ ┤──LSRPOOL(data-value) ─────────────────────

├ ┤ ──MONITOR ──┬ ┬────────────── ───────────────│ │└ ┘──(data-value)

├ ┤──NODE(data-value) ──TARGET(data-value) ──── ├ ┤──POOL(data-value) ──┬ ┬────────────────────

│ │└ ┘──TARGET(data-value) ├ ┤─PROGAUTO───────────────────────────────── ├ ┤ ──PROGRAM ──┬ ┬────────────── ───────────────

│ │└ ┘──(data-value) ├ ┤─RECOVERY───────────────────────────────── ├ ┤ ──STORAGE ──┬ ┬────────────── ───────────────

│ │└ ┘──(data-value)├ ┤──STREAMNAME(data-value) ──────────────────

├ ┤ ──SYSDUMPCODE ──┬ ┬────────────── ───────────│ │└ ┘──(data-value)

├ ┤─TABLEMGR─────────────────────────────────├ ┤──TCLASS(data-value) ──────────────────────

| ├ ┤──TCPIPSERVICE(data-value) ──────────────── ├ ┤ ──TDQUEUE ──┬ ┬────────────── ───────────────

│ │└ ┘──(data-value)├ ┤ ─ ─TERMINAL(data-value) ────────────────────├ ┤──TRANCLASS(data-value) ───────────────────

├ ┤ ──TRANDUMPCODE ──┬ ┬────────────── ──────────│ │└ ┘──(data-value)

├ ┤ ──TRANSACTION ──┬ ┬────────────── ───────────│ │└ ┘──(data-value)

├ ┤─TSQUEUE────────────────────────────────── └ ┘─VTAM─────────────────────────────────────

COL3:├──┤ COL4 ├─ ──LASTRESETMIN(data-area) ──LASTRESETSEC(data-area) ─┤

COL4:├─ ──LASTRESETHRS(data-area) ─┤

Conditions: INVREQ, IOERR, NOTAUTH, NOTFND

92 CICS User’s Handbook

Page 113: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE CONNECTION

55─ ──CREATE CONNECTION(data-value) ─────────────────────────────────────────5

5─ ──┬ ┬──ATTRIBUTES(data-value)ATTRLEN(data-value) ─5% ├ ┤──COMPLETE ───────────────────────────────── └ ┘──DISCARD ──────────────────────────────────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE CONNECTION

CONNECTION attributes: ┌ ┐─ACCESSMETHOD(VTAM)───── ┌ ┐─ATTACHSEC(LOCAL)──────├─ ──┼ ┼──────────────────────── ──┼ ┼─────────────────────── ──────────────────5 ├ ┤─ACCESSMETHOD(INDIRECT)─ ├ ┤─ATTACHSEC(IDENTIFY)─── ├ ┤─ACCESSMETHOD(IRC)────── ├ ┤─ATTACHSEC(MIXIDPE)──── └ ┘─ACCESSMETHOD(XM)─────── ├ ┤─ATTACHSEC(PERSISTENT)─ └ ┘─ATTACHSEC(VERIFY)─────

┌ ┐─AUTOCONNECT(NO)── ┌ ┐─BINDSECURITY(NO)── ┌ ┐─CONNTYPE(SPECIFIC)─5─ ──┼ ┼────────────────── ──┼ ┼─────────────────── ──┼ ┼──────────────────── ────5 ├ ┤─AUTOCONNECT(ALL)─ └ ┘─BINDSECURITY(YES)─ └ ┘─CONNTYPE(GENERIC)── └ ┘─AUTOCONNECT(YES)─

┌ ┐─DATASTREAM(USER)─────5─ ──┼ ┼────────────────────── ──┬ ┬───────────────────── ──┬ ┬─────────────── ───5

├ ┤─DATASTREAM(LMS)────── └ ┘──DESCRIPTION(char58) └ ┘──INDSYS(char4) ├ ┤─DATASTREAM(SCS)────── ├ ┤─DATASTREAM(STRFIELD)─ └ ┘─DATASTREAM(327ð)─────

┌ ┐─INSERVICE(YES)─ ┌ ┐─MAXQTIME(NO)─────5─ ──┼ ┼──────────────── ──┼ ┼────────────────── ──┬ ┬──────────────── ───────────5

└ ┘─INSERVICE(NO)── └ ┘──MAXQTIME(ð-9999) └ ┘──NETNAME(char8)

┌ ┐─PSRECOVERY(SYSDEFAULT)─5─ ──┬ ┬──────────────── ──┼ ┼──────────────────────── ─────────────────────────5 ├ ┤─PROTOCOL(APPC)─ └ ┘─PSRECOVERY(NONE)─────── ├ ┤─PROTOCOL(EXCI)─ └ ┘─PROTOCOL(LU61)─

┌ ┐─QUEUELIMIT(NO)───── ┌ ┐─RECORDFORMAT(U)──5─ ──┼ ┼──────────────────── ──┼ ┼────────────────── ───────────────────────────5

└ ┘──QUEUELIMIT(ð-9999) └ ┘─RECORDFORMAT(VB)─

5─ ──┬ ┬───────────────────── ────────────────────────────────────────────────5└ ┘──REMOTESYSNET(char8)

5─ ──┬ ┬──────────────────────────────────────────── ─────────────────────────5└ ┘──REMOTESYSTEM(char4) ──┬ ┬───────────────────

└ ┘──REMOTENAME(char4)

┌ ┐─SINGLESESS(NO)── ┌ ┐─USEDFLTUSER(NO)──5─ ──┬ ┬───────────────────── ──┼ ┼───────────────── ──┼ ┼────────────────── ─────5

└ ┘──SECURITYNAME(char8) └ ┘─SINGLESESS(YES)─ └ ┘─USEDFLTUSER(YES)─

┌ ┐─XLNACTION(KEEP)──5─ ──┼ ┼────────────────── ─┤ └ ┘─XLNACTION(FORCE)─

Chapter 2. SPI command syntax 93

Page 114: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE DB2CONN

55─ ──CREATE DB2CONN(data-value) ────────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DB2CONN

DB2CONN attributes:┌ ┐──CONNECTERROR(sqlcode)

├─ ──┬ ┬───────────────────── ──┼ ┼─────────────────────── ──┬ ┬────────────── ───5└ ┘──DESCRIPTION(char58) └ ┘──CONNECTERROR(abend) ── └ ┘──DB2ID(char4)

┌ ┐──MSGQUEUE1(CDB2) ─5─ ──┼ ┼────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ───────5

└ ┘──MSGQUEUE1(char4) └ ┘──MSGQUEUE2(char4) └ ┘──MSGQUEUE3(char4)

┌ ┐──NONTERMREL(yes) ┌ ┐──PURGECYCLE(ð,3ð) ─────5─ ──┼ ┼───────────────── ──┼ ┼─────────────────────── ──┬ ┬─────────────── ──────5

└ ┘──NONTERMREL(no) ─ └ ┘──PURGECYCLE(ð-59,ð-59) └ ┘──SIGNID(char8)

┌ ┐──STANDBYMODE(reconnect) ┌ ┐──STATSQUEUE(CDB2) ─5─ ──┼ ┼──────────────────────── ──┼ ┼─────────────────── ──────────────────────5

├ ┤──STANDBYMODE(noconnect) └ ┘──STATSQUEUE(char4)└ ┘──STANDBYMODE(connect) ──

┌ ┐──TCBLIMIT(12) ──── ┌ ┐──THREADERROR(n9ð6d) ┌ ┐──ACCOUNTREC(none)5─ ──┼ ┼────────────────── ──┼ ┼──────────────────── ──┼ ┼────────────────── ─────5

└ ┘──TCBLIMIT(4-2ððð) ├ ┤──THREADERROR(abend) ├ ┤──ACCOUNTREC(uow) ─└ ┘──THREADERROR(n9ð6) ─ ├ ┤──ACCOUNTREC(task)

└ ┘──ACCOUNTREC(txid)

┌ ┐──AUTHTYPE(userid) ┌ ┐──DROLLBACK(yes)5─ ──┬ ┬─────────────── ──┼ ┼────────────────── ──┼ ┼──────────────── ────────────5

└ ┘──AUTHID(char8) ├ ┤──AUTHTYPE(group) ─ └ ┘──DROLLBACK(no) ─├ ┤──AUTHTYPE(signid)├ ┤──AUTHTYPE(term) ──├ ┤──AUTHTYPE(txid) ──└ ┘──AUTHTYPE(opid) ──

┌ ┐──PLANEXITNAME(DSNCUEXT) ┌ ┐──PRIORITY(high) ─5─ ──┬ ┬───────────── ──┼ ┼──────────────────────── ──┼ ┼───────────────── ───────5

└ ┘──PLAN(char8) └ ┘──PLANEXITNAME(char8) ─── ├ ┤──PRIORITY(equal)└ ┘──PRIORITY(low) ──

┌ ┐──THREADLIMIT(3) ───── ┌ ┐──THREADWAIT(yes)5─ ──┼ ┼───────────────────── ──┼ ┼───────────────── ──┬ ┬────────────────── ─────5

└ ┘──THREADLIMIT(3-2ððð) └ ┘──THREADWAIT(no) ─ └ ┘──COMAUTHID(char8)

┌ ┐──COMAUTHTYPE(userid) ┌ ┐──COMTHREADLIM(1) ─────5─ ──┼ ┼───────────────────── ──┼ ┼────────────────────── ─┤

├ ┤──COMAUTHTYPE(group) ─ └ ┘──COMTHREADLIM(ð-2ððð)├ ┤──COMAUTHTYPE(signid)├ ┤──COMAUTHTYPE(term) ──├ ┤──COMAUTHTYPE(txid) ──└ ┘──COMAUTHTYPE(user) ──

94 CICS User’s Handbook

Page 115: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE DB2ENTRY

55─ ──CREATE DB2ENTRY(data-value) ───────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DB2ENTRY

DB2ENTRY attributes:┌ ┐──ACCOUNTREC(none)

├─ ──┬ ┬───────────────────── ──┬ ┬──────────────── ──┼ ┼────────────────── ──────5└ ┘──DESCRIPTION(char58) └ ┘──TRANSID(char4) ├ ┤──ACCOUNTREC(uow) ─

├ ┤──ACCOUNTREC(task)└ ┘──ACCOUNTREC(txid)

┌ ┐──AUTHTYPE(userid) ┌ ┐──DROLLBACK(yes)5─ ──┬ ┬─────────────── ──┼ ┼────────────────── ──┼ ┼──────────────── ────────────5

└ ┘──AUTHID(char8) ├ ┤──AUTHTYPE(group) ─ └ ┘──DROLLBACK(no) ─├ ┤──AUTHTYPE(signid)├ ┤──AUTHTYPE(term) ──├ ┤──AUTHTYPE(txid) ──└ ┘──AUTHTYPE(opid) ──

┌ ┐──PLANEXITNAME(DSNCUEXT) ┌ ┐──PRIORITY(high) ─5─ ──┬ ┬───────────── ──┼ ┼──────────────────────── ──┼ ┼───────────────── ───────5

└ ┘──PLAN(char8) └ ┘──PLANEXITNAME(char8) ─── ├ ┤──PRIORITY(equal)└ ┘──PRIORITY(low) ──

┌ ┐──PROTECTNUM(ð) ───── ┌ ┐──THREADLIMIT(ð) ─────5─ ──┼ ┼──────────────────── ──┼ ┼───────────────────── ────────────────────────5

└ ┘──PROTECTNUM(ð-2ððð) └ ┘──THREADLIMIT(ð-2ððð)

┌ ┐──THREADWAIT(pool)5─ ──┼ ┼────────────────── ─┤

├ ┤──THREADWAIT(yes) ─└ ┘──THREADWAIT(no) ──

CREATE DB2TRAN

55─ ──CREATE DB2TRAN(data-value) ────────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax 95

Page 116: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE DB2TRAN

DB2TRAN attributes:├─ ──┬ ┬───────────────────── ──ENTRY(char8) ──┬ ┬──────────────── ─┤

└ ┘──DESCRIPTION(char58) └ ┘──TRANSID(char4)

CREATE DOCTEMPLATE

55─ ──CREATE DOCTEMPLATE(data-value) ────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DOCTEMPLATE

DOCTEMPLATE attributes: ┌ ┐─APPENDCRLF(YES)─├─ ──┼ ┼───────────────── ──┬ ┬───────────────────── ───────────────────────────5

└ ┘─APPENDCRLF(NO)── └ ┘──DESCRIPTION(char58)

5─ ──┬ ┬──FILE(char8) ─────────────────────────── ──┬ ┬────────────────────── ─┤├ ┤──TSQUEUE(char16) ─────────────────────── └ ┘──TEMPLATENAME(char48)├ ┤──TDQUEUE(char4) ────────────────────────├ ┤──PROGRAM(char8) ────────────────────────├ ┤──EXITPGM(char8) ────────────────────────

│ │┌ ┐─DDNAME(DFHHTML)─└ ┘──MEMBERNAME(char8) ──┼ ┼─────────────────

└ ┘──DDNAME(char8) ──

| CREATE ENQMODEL|

| 55─ ──CREATE ENQMODEL(data-value) ───────────────────────────────────────────5

| 5─ ─── ───| ATTRIBUTES(data-value)| ATTRLEN(data-value) ─5%

| Conditions: INVREQ, LENGERR, NOTAUTH

96 CICS User’s Handbook

Page 117: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

| CREATE ENQMODEL|

| ENQMODEL attributes:| ├─ ──┬ ┬───────────────────── ──ENQNAME(char1-255) ──┬ ┬───────────────── ───────5| └ ┘──DESCRIPTION(char58) └ ┘──ENQSCOPE(char4)

| ┌ ┐─STATUS(ENABLED)──| 5─ ──┼ ┼────────────────── ─┤| └ ┘─STATUS(DISABLED)─

CREATE FILE

55─ ──CREATE FILE(data-value) ─── ───ATTRIBUTES(data-value) ───────────────────5

5─ ──ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE FILE

FILE attributes (1/2): ┌ ┐─ADD(NO)── ┌ ┐─BACKUPTYPE(STATIC)── ┌ ┐─BROWSE(NO)──├─ ──┼ ┼────────── ──┼ ┼───────────────────── ──┼ ┼───────────── ─────────────────5 └ ┘─ADD(YES)─ └ ┘─BACKUPTYPE(DYNAMIC)─ └ ┘─BROWSE(YES)─

┌ ┐─DATABUFFERS(2)─────── ┌ ┐─DELETE(NO)──5─ ──┬ ┬───────────────── ──┼ ┼────────────────────── ──┼ ┼───────────── ─────────5

| └ ┘──CFDTPOOL(char8) └ ┘──DATABUFFERS(2-32767) └ ┘─DELETE(YES)─

┌ ┐─DISPOSITION(SHARE)─5─ ──┬ ┬───────────────────── ──┼ ┼──────────────────── ──┬ ┬──────────────── ────5

└ ┘──DESCRIPTION(char58) └ ┘─DISPOSITION(OLD)─── └ ┘──DSNAME(char44)

┌ ┐─DSNSHARING(ALLREQS)──── ┌ ┐─FWDRECOVLOG(NO)───5─ ──┼ ┼──────────────────────── ──┼ ┼─────────────────── ──────────────────────5

└ ┘─DSNSHARING(MODIFYREQS)─ └ ┘──FWDRECOVLOG(1-99)

┌ ┐─INDEXBUFFERS(1)─────── ┌ ┐─JNLADD(NONE)───5─ ──┼ ┼─────────────────────── ──┼ ┼──────────────── ──────────────────────────5

└ ┘──INDEXBUFFERS(1-32767) ├ ┤─JNLADD(AFTER)── ├ ┤─JNLADD(ALL)──── └ ┘─JNLADD(BEFORE)─

┌ ┐─JNLREAD(NONE)─────── ┌ ┐─JNLSYNCREAD(NO)── ┌ ┐─JNLSYNCWRITE(YES)─5─ ──┼ ┼───────────────────── ──┼ ┼────────────────── ──┼ ┼─────────────────── ───5 ├ ┤─JNLREAD(ALL)──────── └ ┘─JNLSYNCREAD(YES)─ └ ┘─JNLSYNCWRITE(NO)── ├ ┤─JNLREAD(READONLY)─── └ ┘─JNLREAD(UPDATEONLY)─

┌ ┐─JNLUPDATE(NO)── ┌ ┐─JOURNAL(NO)───5─ ──┼ ┼──────────────── ──┼ ┼─────────────── ─┤

└ ┘─JNLUPDATE(YES)─ └ ┘──JOURNAL(1-99)

Chapter 2. SPI command syntax 97

Page 118: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE FILE

FILE attributes (2/2):| ┌ ┐─LOAD(NO)──

├─ ──┬ ┬──────────────────────────────── ──┼ ┼─────────── ──────────────────────5| └ ┘──KEYLENGTH(1-255|1-16 for CFDT) └ ┘─LOAD(YES)─

| ┌ ┐─LSRPOOLID(1)──── ┌ ┐─MAXNUMRECS(NOLIMIT)────────5─ ──┼ ┼───────────────── ──┼ ┼──────────────────────────── ────────────────────5 ├ ┤─LSRPOOLID(NONE)─ └ ┘──┬ ┬────────────────────────

| └ ┘──LSRPOOLID(1-8) ─ └ ┘──MAXNUMRECS(1-99999999)

┌ ┐─OPENTIME(FIRSTREF)─5─ ──┬ ┬───────────────── ──┼ ┼──────────────────── ──┬ ┬───────────────── ───────5

└ ┘──NSRGROUP(char8) └ ┘─OPENTIME(STARTUP)── └ ┘──PASSWORD(char8)

┌ ┐─READ(YES)─ ┌ ┐─READINTEG(UNCOMMITTED)─ ┌ ┐─RECORDFORMAT(V)─5─ ──┼ ┼─────────── ──┼ ┼──────────────────────── ──┼ ┼───────────────── ─────────5 └ ┘─READ(NO)── ├ ┤─READINTEG(CONSISTENT)── └ ┘─RECORDFORMAT(F)─ └ ┘─READINTEG(REPEATABLE)──

┌ ┐─RECOVERY(NONE)────────5─ ──┬ ┬───────────────────── ──┼ ┼─────────────────────── ─────────────────────5

└ ┘──RECORDSIZE(1-32767) ├ ┤─RECOVERY(ALL)───────── └ ┘─RECOVERY(BACKOUTONLY)─

┌ ┐─RLSACCESS(NO)──5─ ──┬ ┬──────────────────────────────────────────── ──┼ ┼──────────────── ─────5

└ ┘──REMOTESYSTEM(char4) ──┬ ┬─────────────────── └ ┘─RLSACCESS(YES)─└ ┘──REMOTENAME(char8)

┌ ┐─STATUS(ENABLED)─── ┌ ┐─STRINGS(1)───── ┌ ┐─TABLE(NO)───5─ ──┼ ┼─────────────────── ──┼ ┼──────────────── ──┼ ┼───────────── ─────────────5

| ├ ┤─STATUS(DISABLED)── └ ┘──STRINGS(1-255) ├ ┤─TABLE(CF)─── └ ┘─STATUS(UNENABLED)─ ├ ┤─TABLE(CICS)─ └ ┘─TABLE(USER)─

| ┌ ┐─UPDATE(NO)── ┌ ┐─UPDATEMODEL(LOCKING)────5─ ──┬ ┬────────────────── ──┼ ┼───────────── ──┼ ┼───────────────────────── ─┤

| └ ┘──TABLENAME(char8) └ ┘─UPDATE(YES)─ └ ┘─UPDATEMODEL(CONTENTION)─

CREATE JOURNALMODEL

55─ ──CREATE JOURNALMODEL(data-value) ───────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

98 CICS User’s Handbook

Page 119: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE JOURNALMODEL

JOURNALMODEL attributes:├─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5

└ ┘──DESCRIPTION(char58) └ ┘──JOURNALNAME(char8)

┌ ┐──STREAMNAME(&USERID..&APPLID..&JNAME;) ┌ ┐─TYPE(MVS)───5─ ──┼ ┼─────────────────────────────────────── ──┼ ┼───────────── ─┤

└ ┘──STREAMNAME(char26) ─────────────────── ├ ┤─TYPE(DUMMY)─ └ ┘─TYPE(SMF)───

CREATE LSRPOOL

55─ ──CREATE LSRPOOL(data-value) ──ATTRIBUTES(data-value) ────────────────────5

5─ ──ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax 99

Page 120: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE LSRPOOL

LSRPOOL attributes:├─ ──┬ ┬────────────────── ──┬ ┬───────────────── ──┬ ┬───────────────── ─────────5

└ ┘──DATA512(3-32767) └ ┘──DATA1K(3-32767) └ ┘──DATA2K(3-32767)

5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┬ ┬────────────────── ─────────5└ ┘──DATA4K(3-32767) └ ┘──DATA8K(3-32767) └ ┘──DATA12K(3-32767)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ───────5└ ┘──DATA16K(3-32767) └ ┘──DATA2ðK(3-32767) └ ┘──DATA24K(3-32767)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ────5└ ┘──DATA28K(3-32767) └ ┘──DATA32K(3-32767) └ ┘──DESCRIPTION(char58)

5─ ──┬ ┬────────────────────── ──┬ ┬────────────────────── ─────────────────────5└ ┘──HSDATA4K(ð-16777215) └ ┘──HSDATA8K(ð-16777215)

5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSDATA12K(ð-16777215) └ ┘──HSDATA16K(ð-16777215)

5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSDATA2ðK(ð-16777215) └ ┘──HSDATA24K(ð-16777215)

5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSDATA28K(ð-16777215) └ ┘──HSDATA32K(ð-16777215)

5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSINDEX4K(ð-16777215) └ ┘──HSINDEX8K(ð-16777215)

5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─────────────────5└ ┘──HSINDEX12K(ð-16777215) └ ┘──HSINDEX16K(ð-16777215)

5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─────────────────5└ ┘──HSINDEX2ðK(ð-16777215) └ ┘──HSINDEX24K(ð-16777215)

5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─────────────────5└ ┘──HSINDEX28K(ð-16777215) └ ┘──HSINDEX32K(ð-16777215)

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ──────5└ ┘──INDEX512(3-32767) └ ┘──INDEX1K(3-32767) └ ┘──INDEX2K(3-32767)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ──────5└ ┘──INDEX4K(3-32767) └ ┘──INDEX8K(3-32767) └ ┘──INDEX12K(3-32767)

5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┬ ┬─────────────────── ────5└ ┘──INDEX16K(3-32767) └ ┘──INDEX2ðK(3-32767) └ ┘──INDEX24K(3-32767)

┌ ┐─LSRPOOLID(1)───5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┼ ┼──────────────── ───────5

└ ┘──INDEX28K(3-32767) └ ┘──INDEX32K(3-32767) └ ┘──LSRPOOLID(1-8)

┌ ┐─SHARELIMIT(5ð)────5─ ──┬ ┬───────────────────── ──┼ ┼─────────────────── ──┬ ┬──────────────── ─┤

└ ┘──MAXKEYLENGTH(ð-255) └ ┘──SHARELIMIT(1-1ðð) └ ┘──STRINGS(1-255)

CREATE MAPSET

55─ ──CREATE MAPSET(data-value) ─────────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

100 CICS User’s Handbook

Page 121: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE MAPSET

MAPSET attributes: ┌ ┐─RESIDENT(NO)── ┌ ┐─STATUS(ENABLED)──├─ ──┬ ┬───────────────────── ──┼ ┼─────────────── ──┼ ┼────────────────── ───────5

└ ┘──DESCRIPTION(char58) └ ┘─RESIDENT(YES)─ └ ┘─STATUS(DISABLED)─

┌ ┐─USAGE(NORMAL)──── ┌ ┐─USELPACOPY(NO)──5─ ──┼ ┼────────────────── ──┼ ┼───────────────── ─┤ └ ┘─USAGE(TRANSIENT)─ └ ┘─USELPACOPY(YES)─

CREATE PARTITIONSET

55─ ──CREATE PARTITIONSET(data-value) ───────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PARTITIONSET

PARTITIONSET attributes: ┌ ┐─RESIDENT(NO)── ┌ ┐─STATUS(ENABLED)──├─ ──┬ ┬───────────────────── ──┼ ┼─────────────── ──┼ ┼────────────────── ───────5

└ ┘──DESCRIPTION(char58) └ ┘─RESIDENT(YES)─ └ ┘─STATUS(DISABLED)─

┌ ┐─USAGE(NORMAL)──── ┌ ┐─USELPACOPY(NO)──5─ ──┼ ┼────────────────── ──┼ ┼───────────────── ─┤ └ ┘─USAGE(TRANSIENT)─ └ ┘─USELPACPOY(YES)─

CREATE PARTNER

55─ ──CREATE PARTNER(data-value) ────────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax 101

Page 122: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE PARTNER

PARTNER attributes:├─ ──┬ ┬───────────────────── ──NETNAME(char8) ──┬ ┬──────────────── ────────────5

└ ┘──DESCRIPTION(char58) └ ┘──NETWORK(char8)

┌ ┐─PROFILE(DFHCICSA)─5─ ──┼ ┼─────────────────── ──┬ ┬──TPNAME(char64) ─ ─┤

└ ┘──PROFILE(char8) ─── └ ┘──XTPNAME(hex128)

CREATE PROCESSTYPE

55─ ──CREATE PROCESSTYPE(data-value) ──ATTRIBUTES(data-value) ────────────────5

5─ ──ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PROCESSTYPE

PROCESSTYPE attributes:├─ ──┬ ┬───────────────────── ──FILE(char8) ──┬ ┬───────────────── ──────────────5

└ ┘──DESCRIPTION(char58) └ ┘──AUDITLOG(char8)

┌ ┐─AUDITLEVEL(OFF)────── ┌ ┐─STATUS(ENABLED)──5─ ──┼ ┼────────────────────── ──┼ ┼────────────────── ─┤ ├ ┤─AUDITLEVEL(ACTIVITY)─ └ ┘─STATUS(DISABLED)─ ├ ┤─AUDITLEVEL(FULL)───── └ ┘─AUDITLEVEL(PROCESS)──

CREATE PROFILE

55─ ──CREATE PROFILE(data-value) ────────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

102 CICS User’s Handbook

Page 123: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE PROFILE

PROFILE attributes: ┌ ┐─CHAINCONTROL(NO)── ┌ ┐─DVSUPRT(ALL)─────├─ ──┼ ┼─────────────────── ──┬ ┬───────────────────── ──┼ ┼────────────────── ───5

└ ┘─CHAINCONTROL(YES)─ └ ┘──DESCRIPTION(char58) ├ ┤─DVSUPRT(NONVTAM)─ └ ┘─DVSUPRT(VTAM)────

┌ ┐─INBFMH(NO)─── ┌ ┐─JOURNAL(NO)─── ┌ ┐─LOGREC(NO)──5─ ──┼ ┼────────────── ──┼ ┼─────────────── ──┼ ┼───────────── ───────────────────5

├ ┤─INBFMH(ALL)── └ ┘──JOURNAL(1-99) └ ┘─LOGREC(YES)─ ├ ┤─INBFMH(DIP)── └ ┘─INBFMH(EODS)─

┌ ┐─MSGINTEG(NO)── ┌ ┐─MSGJRNL(NO)─────5─ ──┬ ┬───────────────── ──┼ ┼─────────────── ──┼ ┼───────────────── ────────────5

└ ┘──MODENAME(char8) └ ┘─MSGINTEG(YES)─ ├ ┤─MSGJRNL(INOUT)── ├ ┤─MSGJRNL(INPUT)── └ ┘─MSGJRNL(OUTPUT)─

┌ ┐─NEPCLASS(ð)───── ┌ ┐─ONEWTE(NO)── ┌ ┐─PRINTERCOMP(NO)──5─ ──┼ ┼───────────────── ──┼ ┼───────────── ──┼ ┼────────────────── ─────────────5

└ ┘──NEPCLASS(ð-255) └ ┘─ONEWTE(YES)─ └ ┘─PRINTERCOMP(YES)─

┌ ┐─PROTECT(NO)── ┌ ┐─RAQ(NO)── ┌ ┐─RTIMOUT(NO)─────5─ ──┼ ┼────────────── ──┼ ┼────────── ──┼ ┼───────────────── ────────────────────5

└ ┘─PROTECT(YES)─ └ ┘─RAQ(YES)─ └ ┘──RTIMOUT(1-7ððð)

┌ ┐─SCRNSIZE(DEFAULT)─── ┌ ┐─UCTRAN(NO)──5─ ──┼ ┼───────────────────── ──┼ ┼───────────── ─┤ └ ┘─SCRNSIZE(ALTERNATE)─ └ ┘─UCTRAN(YES)─

CREATE PROGRAM

55─ ──CREATE PROGRAM(data-value) ────────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax 103

Page 124: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE PROGRAM

PROGRAM attributes: ┌ ┐─CEDF(YES)─ ┌ ┐─CONCURRENCY(QUASIRENT)── ┌ ┐─DATALOCATION(BELOW)─├─ ──┼ ┼─────────── ──┼ ┼───────────────────────── ──┼ ┼───────────────────── ────5 └ ┘─CEDF(NO)── └ ┘─CONCURRENCY(THREADSAFE)─ └ ┘─DATALOCATION(ANY)───

┌ ┐─EXECKEY(USER)─5─ ──┬ ┬───────────────────── ──┼ ┼─────────────── ─────────────────────────────5

└ ┘──DESCRIPTION(char58) └ ┘─EXECKEY(CICS)─

| ┌ ┐─EXECUTIONSET(FULLAPI)─── ┌ ┐─JVM(NO)────5─ ──┼ ┼───────────────────────── ──┬ ┬─────────────────── ──┼ ┼──────────── ─────5

| └ ┘─EXECUTIONSET(DPLSUBSET)─ └ ┘──JVMCLASS(char255) ├ ┤─JVM(DEBUG)─| └ ┘─JVM(YES)───

┌ ┐─RELOAD(NO)──5─ ──┬ ┬───────────────────── ──┼ ┼───────────── ───────────────────────────────5 ├ ┤─LANGUAGE(ASSEMBLER)─ └ ┘─RELOAD(YES)─ ├ ┤─LANGUAGE(C)───────── ├ ┤─LANGUAGE(COBOL)───── ├ ┤─LANGUAGE(LE37ð)───── └ ┘─LANGUAGE(PLI)───────

┌ ┐─RESIDENT(NO)──5─ ──┬ ┬──────────────────────────────────────────── ──┼ ┼─────────────── ──────5

└ ┘──REMOTESYSTEM(char4) ──┬ ┬─────────────────── └ ┘─RESIDENT(YES)─└ ┘──REMOTENAME(char8)

┌ ┐─STATUS(ENABLED)── ┌ ┐─USAGE(NORMAL)────5─ ──┼ ┼────────────────── ──┬ ┬──────────────── ──┼ ┼────────────────── ─────────5

└ ┘─STATUS(DISABLED)─ └ ┘──TRANSID(char4) └ ┘─USAGE(TRANSIENT)─

┌ ┐─USELPACOPY(NO)──5─ ──┼ ┼───────────────── ─┤ └ ┘─USELPACOPY(YES)─

CREATE REQUESTMODEL

55─ ──CREATE REQUESTMODEL(data-value) ───────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE REQUESTMODEL

REQUESTMODEL attributes:├─ ──┬ ┬───────────────────── ──OMGMODULE(char58) ──OMGINTERFACE(char31) ───────5

└ ┘──DESCRIPTION(char58)

5─ ──OMGOPERATION(char31) ──TRANSID(char4) ─┤

104 CICS User’s Handbook

Page 125: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE SESSIONS

55─ ──CREATE SESSIONS(data-value) ───────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE SESSIONS

SESSIONS attributes: ┌ ┐─AUTOCONNECT(NO)── ┌ ┐─BUILDCHAIN(YES)─├─ ──┼ ┼────────────────── ──┼ ┼───────────────── ──CONNECTION(char4) ───────────5 ├ ┤─AUTOCONNECT(ALL)─ └ ┘─BUILDCHAIN(NO)── └ ┘─AUTOCONNECT(YES)─

┌ ┐─DISCREQ(NO)──5─ ──┬ ┬───────────────────── ──┼ ┼────────────── ──────────────────────────────5

└ ┘──DESCRIPTION(char58) └ ┘─DISCREQ(YES)─

┌ ┐─IOAREALEN(ð,ð)───────────── ┌ ┐─MAXIMUM(1,ð)─────────5─ ──┼ ┼──────────────────────────── ──┼ ┼────────────────────── ───────────────5

└ ┘──IOAREALEN(ð-32767,ð-32767) └ ┘──MAXIMUM(ð-999,ð-999)

┌ ┐─NEPCLASS(ð)─────5─ ──┬ ┬───────────────── ──┼ ┼───────────────── ──┬ ┬───────────────── ──────────5

└ ┘──MODENAME(char8) └ ┘──NEPCLASS(ð-255) └ ┘──NETNAMEQ(char8)

┌ ┐─PROTOCOL(APPC)─5─ ──┼ ┼──────────────── ──┬ ┬───────────────────── ──┬ ┬─────────────────── ─────5

├ ┤─PROTOCOL(LU61)─ └ ┘──RECEIVECOUNT(1-999) └ ┘──RECEIVEPFX(char2) └ ┘─PROTOCOL(EXCI)─

┌ ┐─RECEIVESIZE(4ð96)──── ┌ ┐─RECOVOPTION(SYSDEFAULT)──5─ ──┼ ┼────────────────────── ──┼ ┼────────────────────────── ─────────────────5

└ ┘──RECEIVESIZE(1-3ð72ð) ├ ┤─RECOVOPTION(CLEARCONV)─── ├ ┤─RECOVOPTION(NONE)──────── ├ ┤─RECOVOPTION(RELEASESESS)─ └ ┘─RECOVOPTION(UNCONDREL)───

┌ ┐─RELREQ(NO)──5─ ──┼ ┼───────────── ──┬ ┬────────────────── ──┬ ┬──────────────── ──────────────5

└ ┘─RELREQ(YES)─ └ ┘──SENDCOUNT(1-999) └ ┘──SENDPFX(char2)

┌ ┐─SENDSIZE(4ð96)──── ┌ ┐─SESSPRIORITY(ð)─────5─ ──┼ ┼─────────────────── ──┬ ┬───────────────── ──┼ ┼───────────────────── ────5

└ ┘──SENDSIZE(1-3ð72ð) └ ┘──SESSNAME(char4) └ ┘──SESSPRIORITY(ð-255)

┌ ┐─USERAREALEN(ð)─────5─ ──┼ ┼──────────────────── ──┬ ┬─────────────── ─┤

└ ┘──USERAREALEN(ð-255) └ ┘──USERID(char8)

Chapter 2. SPI command syntax 105

Page 126: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE TCPIPSERVICE

55─ ──CREATE TCPIPSERVICE(data-value) ───────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TCPIPSERVICE

TCPIPSERVICE attributes:┌ ┐──BACKLOG(ð) ──────

├─ ──┼ ┼────────────────── ──┬ ┬───────────────────── ──────────────────────────5└ ┘──BACKLOG(ð-32767) └ ┘──CERTIFICATE(char44)

5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ──┬ ┬───────────────── ────5└ ┘──DESCRIPTION(char58) └ ┘──IPADDRESS(char15) └ ┘──KEYFILE(char44)

┌ ┐─SSL(NO)───────── ┌ ┐─STATUS(OPEN)───5─ ──PORTNUMBER(1-32767) ──┼ ┼───────────────── ──┼ ┼──────────────── ───────────5 ├ ┤─SSL(YES)──────── └ ┘─STATUS(CLOSED)─ └ ┘─SSL(CLIENTAUTH)─

5─ ──TRANSACTION(char4) ──┬ ┬────────────────── ──┬ ┬──────────── ─┤└ ┘──TSQPREFIX(char6) └ ┘──URM(char8)

CREATE TDQUEUE

55─ ──CREATE TDQUEUE(data-value) ────────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

106 CICS User’s Handbook

Page 127: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

TDQUEUE attributes for extra-partition queues:├─ ──TYPE(EXTRA) ──┬ ┬──────────────────────── ─────────────────────5 ├ ┤─BLOCKFORMAT(BLOCKED)─── └ ┘─BLOCKFORMAT(UNBLOCKED)─

┌ ┐─BLOCKSIZE(ð)─────── ┌ ┐─DATABUFFERS(1)─────5─ ──┼ ┼──────────────────── ──┼ ┼──────────────────── ──────────────5

└ ┘──BLOCKSIZE(ð-32767) └ ┘──DATABUFFERS(1-255)

5─ ──DDNAME(char8) ──┬ ┬───────────────────── ──────────────────────5└ ┘──DESCRIPTION(char58)

┌ ┐─DISPOSITION(SHR)─5─ ──┼ ┼────────────────── ──┬ ┬──────────────── ────────────────────5 ├ ┤─DISPOSITION(OLD)─ ├ ┤─DSNAME(DUMMY)──

└ ┘─DISPOSITION(MOD)─ └ ┘──DSNAME(char44)

┌ ┐─ERROROPTION(IGNORE)─ ┌ ┐─OPENTIME(INITIAL)──5─ ──┼ ┼───────────────────── ──┼ ┼──────────────────── ─────────────5 └ ┘─ERROROPTION(SKIP)─── └ ┘─OPENTIME(DEFERRED)─

5─ ──┬ ┬───────────────── ──┬ ┬──────────────────────── ─────────────5 ├ ┤─PRINTCONTROL(A)─ ├ ┤─RECORDFORMAT(FIXED)──── └ ┘─PRINTCONTROL(M)─ └ ┘─RECORDFORMAT(VARIABLE)─

┌ ┐─RECORDSIZE(ð)───────5─ ──┼ ┼───────────────────── ─────────────────────────────────────5

└ ┘──RECORDSIZE(ð-32767)

5─ ──┬ ┬────────────────────────────────────────────────── ────────5 │ │┌ ┐───────────────────────────

└ ┘──REMOTESYSTEM(char4) ───6

┴┬ ┬───────────────────────├ ┤──REMOTELENGTH(ð-32767)└ ┘──REMOTENAME(char4) ────

┌ ┐─SYSOUTCLASS(\)─────5─ ──┬ ┬──────────────── ──┼ ┼──────────────────── ──────────────────5

├ ┤─REWIND(LEAVE)── └ ┘──SYSOUTCLASS(char1) └ ┘─REWIND(REREAD)─

┌ ┐─TYPEFILE(INPUT)──5─ ──┼ ┼────────────────── ────────────────────────────────────────┤ ├ ┤─TYPEFILE(OUTPUT)─ └ ┘─TYPEFILE(RDBACK)─

Chapter 2. SPI command syntax 107

Page 128: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

TDQUEUE attributes for intra-partition queues: ┌ ┐─ATIFACILITY(TERMINAL)─├─ ──TYPE(INTRA) ──┼ ┼─────────────────────── ──────────────────────5 ├ ┤─ATIFACILITY(FILE)───── └ ┘─ATIFACILITY(SYSTEM)───

5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ──────────────5└ ┘──DESCRIPTION(char58) └ ┘──FACILITYID(char4)

┌ ┐─RECOVSTATUS(NO)───────5─ ──┼ ┼─────────────────────── ───────────────────────────────────5 ├ ┤─RECOVSTATUS(LOGICAL)── └ ┘─RECOVSTATUS(PHYSICAL)─

5─ ──┬ ┬────────────────────────────────────────────────── ────────5 │ │┌ ┐───────────────────────────

└ ┘──REMOTESYSTEM(char4) ───6

┴┬ ┬───────────────────────├ ┤──REMOTELENGTH(ð-32767)└ ┘──REMOTENAME(char4) ────

┌ ┐─TRIGGERLEVEL(1)───────5─ ──┬ ┬──────────────── ──┼ ┼─────────────────────── ───────────────5

└ ┘──TRANSID(char4) └ ┘──TRIGGERLEVEL(ð-32767)

┌ ┐─WAIT(YES)─ ┌ ┐─WAITACTION(REJECT)─5─ ──┬ ┬─────────────── ──┼ ┼─────────── ──┼ ┼──────────────────── ────┤

└ ┘──USERID(char8) └ ┘─WAIT(NO)── └ ┘─WAITACTION(QUEUE)──

TDQUEUE attributes for indirect queues:├─ ──TYPE(INDIRECT) ──┬ ┬───────────────────── ─────────────────────5

└ ┘──DESCRIPTION(char58)

5─ ──INDIRECTNAME(char4) ─────────────────────────────────────────5

5─ ──┬ ┬────────────────────────────────────────────────── ────────┤ │ │┌ ┐───────────────────────────

└ ┘──REMOTESYSTEM(char4) ───6

┴┬ ┬───────────────────────├ ┤──REMOTELENGTH(ð-32767)└ ┘──REMOTENAME(char4) ────

108 CICS User’s Handbook

Page 129: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

TDQUEUE attributes for remote queues of unspecified TYPE:├─ ──┬ ┬───────────────────── ──┬ ┬─────────────────────── ──────────5

└ ┘──DESCRIPTION(char58) └ ┘──REMOTELENGTH(ð-32767)

5─ ──┬ ┬─────────────────── ──REMOTESYSTEM(char4) ──────────────────┤└ ┘──REMOTENAME(char4)

CREATE TERMINAL

55─ ──CREATE TERMINAL(data-value) ───────────────────────────────────────────5

5─ ──┬ ┬──ATTRIBUTES(data-value)ATTRLEN(data-value) ─5% ├ ┤─COMPLETE────────────────────────────────── └ ┘─DISCARD───────────────────────────────────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax 109

Page 130: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE TERMINAL

TERMINAL attributes: ┌ ┐─ALTPRINTCOPY(NO)──├─ ──┼ ┼─────────────────── ──┬ ┬─────────────────── ───────────────────────────5

└ ┘─ALTPRINTCOPY(YES)─ └ ┘──ALTPRINTER(char4)

┌ ┐─ATTACHSEC(LOCAL)────── ┌ ┐─AUTINSTMODEL(NO)───5─ ──┼ ┼─────────────────────── ──┼ ┼──────────────────── ──────────────────────5 ├ ┤─ATTACHSEC(IDENTIFY)─── ├ ┤─AUTINSTMODEL(ONLY)─ ├ ┤─ATTACHSEC(MIXIDPE)──── └ ┘─AUTINSTMODEL(YES)── ├ ┤─ATTACHSEC(PERSISTENT)─ └ ┘─ATTACHSEC(VERIFY)─────

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──AUTINSTNAME(char8) └ ┘──BINDPASSWORD(hex16)

┌ ┐─BINDSECURITY(NO)── ┌ ┐─CONSOLE(NO)─────5─ ──┼ ┼─────────────────── ──┼ ┼───────────────── ──┬ ┬───────────────────── ────5

└ ┘─BINDSECURITY(YES)─ ├ ┤──CONSOLE(ð-25ð) ─ └ ┘──DESCRIPTION(char58)└ ┘──CONSNAME(char8)

┌ ┐─INSERVICE(YES)─5─ ──┼ ┼──────────────── ──┬ ┬───────────────── ──┬ ┬──────────── ────────────────5

└ ┘─INSERVICE(NO)── └ ┘──MODENAME(char8) ├ ┤─NATLANG(E)─ └ ┘─NATLANG(K)─

5─ ──┬ ┬──────────────── ──┬ ┬───────────── ──┬ ┬──────────────── ────────────────5└ ┘──NETNAME(char8) └ ┘──POOL(char8) └ ┘──PRINTER(char4)

┌ ┐─PRINTERCOPY(NO)──5─ ──┼ ┼────────────────── ──┬ ┬───────────────────── ──────────────────────────5

└ ┘─PRINTERCOPY(YES)─ └ ┘──REMOTESYSNET(char8)

5─ ──┬ ┬──────────────────────────────────────────── ─────────────────────────5└ ┘──REMOTESYSTEM(char4) ──┬ ┬───────────────────

└ ┘──REMOTENAME(char4)

┌ ┐─TASKLIMIT(NO)──────5─ ──┬ ┬───────────────────── ──┼ ┼──────────────────── ────────────────────────5

└ ┘──SECURITYNAME(char8) └ ┘──TASKLIMIT(1-32767)

┌ ┐─TERMPRIORITY(ð)─────5─ ──┼ ┼───────────────────── ──┬ ┬──────────────────── ──TYPETERM(char8) ───────5

└ ┘──TERMPRIORITY(ð-255) └ ┘──TRANSACTION(char4)

5─ ──┬ ┬─────────────── ─┤└ ┘──USERID(char8)

CREATE TRANCLASS

55─ ──CREATE TRANCLASS(data-value) ──────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

110 CICS User’s Handbook

Page 131: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE TRANCLASS

TRANCLASS attributes:├─ ──┬ ┬───────────────────── ──MAXACTIVE(ð-999) ──────────────────────────────5

└ ┘──DESCRIPTION(char58)

┌ ┐─PURGETHRESH(NO)────────5─ ──┼ ┼──────────────────────── ─┤

└ ┘──PURGETHRESH(1-1ðððððð)

CREATE TRANSACTION

55─ ──CREATE TRANSACTION(data-value) ────────────────────────────────────────5

5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax 111

Page 132: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE TRANSACTION

TRANSACTION attributes: ┌ ┐─ACTION(BACKOUT)─├─ ──┼ ┼───────────────── ──┬ ┬────────────── ──┬ ┬─────────────── ───────────────5

└ ┘─ACTION(COMMIT)── └ ┘──ALIAS(char4) └ ┘──BREXIT(char8)

┌ ┐─CMDSEC(NO)── ┌ ┐─CONFDATA(NO)──5─ ──┼ ┼───────────── ──┼ ┼─────────────── ──┬ ┬───────────────────── ────────────5

└ ┘─CMDSEC(YES)─ └ ┘─CONFDATA(YES)─ └ ┘──DESCRIPTION(char58)

┌ ┐─DTIMOUT(NO)───── ┌ ┐─DUMP(YES)─ ┌ ┐─DYNAMIC(NO)──5─ ──┼ ┼───────────────── ──┼ ┼─────────── ──┼ ┼────────────── ───────────────────5

└ ┘──DTIMOUT(1-68ðð) └ ┘─DUMP(NO)── └ ┘─DYNAMIC(YES)─

┌ ┐─INDOUBT(BACKOUT)─ ┌ ┐─ISOLATE(YES)─ ┌ ┐─LOCALQ(NO)──5─ ──┼ ┼────────────────── ──┼ ┼────────────── ──┼ ┼───────────── ────────────────5 ├ ┤─INDOUBT(COMMIT)── └ ┘─ISOLATE(NO)── └ ┘─LOCALQ(YES)─ └ ┘─INDOUBT(WAIT)────

┌ ┐─PRIORITY(1)───── ┌ ┐─PROFILE(DFHCICST)─5─ ──┬ ┬───────────────────── ──┼ ┼───────────────── ──┼ ┼─────────────────── ────5

├ ┤──PARTITIONSET(char8) └ ┘──PRIORITY(ð-255) └ ┘──PROFILE(char8) ─── ├ ┤─PARTITIONSET(KEEP)── └ ┘─PARTITIONSET(OWN)───

┌ ┐─RESSEC(NO)──5─ ──┬ ┬──PROGRAM(char8) ──────────────────────────── ──┼ ┼───────────── ────────5

└ ┘──REMOTESYSTEM(char4) ──┬ ┬─────────────────── └ ┘─RESSEC(YES)─└ ┘──REMOTENAME(char8)

┌ ┐─RESTART(NO)── ┌ ┐─RUNAWAY(SYSTEM)──── ┌ ┐─SHUTDOWN(DISABLED)─5─ ──┼ ┼────────────── ──┼ ┼──────────────────── ──┼ ┼──────────────────── ───────5

└ ┘─RESTART(YES)─ └ ┘──RUNAWAY(ð-27ððððð) └ ┘─SHUTDOWN(ENABLED)──

┌ ┐─SPURGE(NO)── ┌ ┐─STATUS(ENABLED)── ┌ ┐─STORAGECLEAR(NO)──5─ ──┼ ┼───────────── ──┼ ┼────────────────── ──┼ ┼─────────────────── ───────────5 └ ┘─SPURGE(YES)─ └ ┘─STATUS(DISABLED)─ └ ┘─STORAGECLEAR(YES)─

┌ ┐─TASKDATAKEY(USER)─ ┌ ┐─TASKDATALOC(BELOW)─5─ ──┼ ┼─────────────────── ──┼ ┼──────────────────── ──┬ ┬───────────────── ─────5 └ ┘─TASKDATAKEY(CICS)─ └ ┘─TASKDATALOC(ANY)─── ├ ┤─TASKREQ(LPA)──── ├ ┤─TASKREQ(MSRE)─── ├ ┤─TASKREQ(OPID)───

├ ┤──TASKREQ(PA1-3) ─└ ┘──TASKREQ(PF1-24)

┌ ┐─TPURGE(NO)── ┌ ┐─TRACE(YES)─5─ ──┬ ┬───────────────── ──┼ ┼───────────── ──┼ ┼──────────── ───────────────────5

├ ┤──TPNAME(char64) ─ └ ┘─TPURGE(YES)─ └ ┘─TRACE(NO)──└ ┘──XTPNAME(hex128)

┌ ┐─TRANCLASS(DFHTCLðð)─ ┌ ┐─TRPROF(DFHCICSS)─ ┌ ┐─TWASIZE(ð)───────5─ ──┼ ┼───────────────────── ──┼ ┼────────────────── ──┼ ┼────────────────── ────5

└ ┘──TRANCLASS(char8) ─── └ ┘──TRPROF(char8) ─── └ ┘──TWASIZE(ð-32767)

┌ ┐─WAIT(YES)─ ┌ ┐─WAITTIME(ð,ð,ð)──────────5─ ──┼ ┼─────────── ──┼ ┼────────────────────────── ──┬ ┬─────────────── ─┤

└ ┘─WAIT(NO)── └ ┘──WAITTIME(ð-99,ð-23,ð-59) └ ┘──XTRANID(hex8)

112 CICS User’s Handbook

Page 133: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

| CREATE TSMODEL|

| 55─ ──CREATE TSMODEL(data-value) ────────────────────────────────────────────5

| 5─ ─── ───| ATTRIBUTES(data-value)| ATTRLEN(data-value) ─5%

| Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

| CREATE TSMODEL|

| TSMODEL attributes:| ┌ ┐─LOCATION(AUXILIARY)─| ├─ ──┬ ┬───────────────────── ──┼ ┼───────────────────── ───────────────────────5| └ ┘──DESCRIPTION(char58) └ ┘─LOCATION(MAIN)──────

| ┌ ┐─RECOVERY(NO)──| 5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┼ ┼─────────────── ────────────5| └ ┘──POOLNAME(char8) ├ ┤──PREFIX(char16) ─ └ ┘─RECOVERY(YES)─| └ ┘──XPREFIX(char32)

| ┌ ┐─SECURITY(NO)──| 5─ ──┬ ┬─────────────────────────────────────────────── ──┼ ┼─────────────── ─┤| └ ┘──REMOTESYSTEM(char4) ──┬ ┬────────────────────── └ ┘─SECURITY(YES)─| ├ ┤──REMOTEPREFIX(char16)| └ ┘──XREMOTEPFX(char32) ──

CREATE TYPETERM

55─ ──CREATE TYPETERM(data-value) ──ATTRIBUTES(data-value) ───────────────────5

5─ ──ATTRLEN(data-value) ─5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax 113

Page 134: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE TYPETERM

TYPETERM attributes (1/3): ┌ ┐─ALTPAGE(ð,ð)─────────├─ ──┼ ┼────────────────────── ──┬ ┬──────────────────────── ───────────────────5

└ ┘──ALTPAGE(ð-999,ð-999) └ ┘──ALTSCREEN(ð-999,ð-999)

┌ ┐─APLKYBD(NO)── ┌ ┐─APLTEXT(NO)──5─ ──┬ ┬────────────────── ──┼ ┼────────────── ──┼ ┼────────────── ───────────────5

└ ┘──ALTSUFFIX(char1) └ ┘─APLKYBD(YES)─ └ ┘─APLTEXT(YES)─

┌ ┐─ASCII(NO)─ ┌ ┐─ATI(NO)── ┌ ┐─AUDIBLEALARM(NO)──5─ ──┼ ┼─────────── ──┼ ┼────────── ──┼ ┼─────────────────── ─────────────────────5 ├ ┤─ASCII(7)── └ ┘─ATI(YES)─ └ ┘─AUDIBLEALARM(YES)─ └ ┘─ASCII(8)──

┌ ┐─AUTOCONNECT(NO)── ┌ ┐─BACKTRANS(NO)──5─ ──┼ ┼────────────────── ──┬ ┬─────────────── ──┼ ┼──────────────── ────────────5 ├ ┤─AUTOCONNECT(ALL)─ ├ ┤─AUTOPAGE(NO)── └ ┘─BACKTRANS(YES)─ └ ┘─AUTOCONNECT(YES)─ └ ┘─AUTOPAGE(YES)─

┌ ┐─BRACKET(YES)─ ┌ ┐─BUILDCHAIN(NO)── ┌ ┐─CGCSGID(ð,ð)─────────────5─ ──┼ ┼────────────── ──┼ ┼───────────────── ──┼ ┼────────────────────────── ────5

└ ┘─BRACKET(NO)── └ ┘─BUILDCHAIN(YES)─ └ ┘──CGCSGID(ð-65535,ð-65535)

┌ ┐─COLOR(NO)── ┌ ┐─COPY(NO)── ┌ ┐─CREATESESS(NO)──5─ ──┼ ┼──────────── ──┼ ┼─────────── ──┼ ┼───────────────── ─────────────────────5 └ ┘─COLOR(YES)─ └ ┘─COPY(YES)─ └ ┘─CREATESESS(YES)─

┌ ┐─DEFSCREEN(ð,ð)─────────5─ ──┼ ┼──────────────────────── ──┬ ┬───────────────────── ──DEVICE(char8) ─────5

└ ┘──DEFSCREEN(ð-999,ð-999) └ ┘──DESCRIPTION(char58)

┌ ┐─DISCREQ(YES)─ ┌ ┐─DUALCASEKYBD(NO)── ┌ ┐─ERRCOLOR(NO)────────5─ ──┼ ┼────────────── ──┼ ┼─────────────────── ──┼ ┼───────────────────── ───────5 └ ┘─DISCREQ(NO)── └ ┘─DUALCASEKYBD(YES)─ ├ ┤─ERRCOLOR(BLUE)────── ├ ┤─ERRCOLOR(GREEN)───── ├ ┤─ERRCOLOR(NEUTRAL)─── ├ ┤─ERRCOLOR(PINK)────── ├ ┤─ERRCOLOR(RED)─────── ├ ┤─ERRCOLOR(TURQUOISE)─ └ ┘─ERRCOLOR(YELLOW)────

┌ ┐─ERRHILIGHT(NO)──────── ┌ ┐─ERRINTENSIFY(NO)──5─ ──┼ ┼─────────────────────── ──┼ ┼─────────────────── ───────────────────────5 ├ ┤─ERRHILIGHT(BLINK)───── └ ┘─ERRINTENSIFY(YES)─ ├ ┤─ERRHILIGHT(REVERSE)─── └ ┘─ERRHILIGHT(UNDERLINE)─

┌ ┐─ERRLASTLINE(NO)── ┌ ┐─EXTENDEDDS(NO)── ┌ ┐─FMHPARM(NO)──5─ ──┼ ┼────────────────── ──┼ ┼───────────────── ──┼ ┼────────────── ────────────5 └ ┘─ERRLASTLINE(YES)─ └ ┘─EXTENDEDDS(YES)─ └ ┘─FMHPARM(YES)─

┌ ┐─FORMFEED(NO)── ┌ ┐─HILIGHT(NO)── ┌ ┐─HORIZFORM(NO)──5─ ──┼ ┼─────────────── ──┼ ┼────────────── ──┼ ┼──────────────── ────────────────5 └ ┘─FORMFEED(YES)─ └ ┘─HILIGHT(YES)─ └ ┘─HORIZFORM(YES)─

┌ ┐─IOAREALEN(ð,ð)───────────── ┌ ┐─KATAKANA(NO)──5─ ──┼ ┼──────────────────────────── ──┼ ┼─────────────── ─┤

└ ┘──IOAREALEN(ð-32767,ð-32767) └ ┘─KATAKANA(YES)─

114 CICS User’s Handbook

Page 135: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE TYPETERM

TYPETERM attributes (2/3): ┌ ┐─LIGHTPEN(NO)──├─ ──┬ ┬──────────────── ──┼ ┼─────────────── ──┬ ┬──────────────── ──────────────5

└ ┘──LDCLIST(char8) └ ┘─LIGHTPEN(YES)─ ├ ┤──LOGMODE(char8) └ ┘─LOGMODE(ð)─────

┌ ┐─LOGONMSG(NO)── ┌ ┐─MSRCONTROL(NO)── ┌ ┐─NEPCLASS(ð)─────5─ ──┼ ┼─────────────── ──┼ ┼───────────────── ──┼ ┼───────────────── ────────────5

└ ┘─LOGONMSG(YES)─ └ ┘─MSRCONTROL(YES)─ └ ┘──NEPCLASS(ð-255)

┌ ┐─OBFORMAT(NO)── ┌ ┐─OBOPERID(NO)── ┌ ┐─OUTLINE(NO)──5─ ──┼ ┼─────────────── ──┼ ┼─────────────── ──┼ ┼────────────── ─────────────────5 └ ┘─OBFORMAT(YES)─ └ ┘─OBOPERID(YES)─ └ ┘─OUTLINE(YES)─

┌ ┐─PAGESIZE(24,8ð)─────── ┌ ┐─PARTITIONS(NO)──5─ ──┼ ┼─────────────────────── ──┼ ┼───────────────── ─────────────────────────5

└ ┘──PAGESIZE(ð-999,ð-999) └ ┘─PARTITIONS(YES)─

┌ ┐─PRINTADAPTER(NO)── ┌ ┐─PROGSYMBOLS(NO)── ┌ ┐─QUERY(NO)───5─ ──┼ ┼─────────────────── ──┼ ┼────────────────── ──┼ ┼───────────── ───────────5 └ ┘─PRINTADAPTER(YES)─ └ ┘─PROGSYMBOLS(YES)─ ├ ┤─QUERY(ALL)── └ ┘─QUERY(COLD)─

┌ ┐─RECEIVESIZE(256)───── ┌ ┐─RECOVNOTIFY(NONE)────────5─ ──┼ ┼────────────────────── ──┼ ┼────────────────────────── ─────────────────5

└ ┘──RECEIVESIZE(ð-3ð72ð) ├ ┤─RECOVNOTIFY(MESSAGE)───── └ ┘─RECOVNOTIFY(TRANSACTION)─

┌ ┐─RECOVOPTION(SYSDEFAULT)── ┌ ┐─RELREQ(NO)──5─ ──┼ ┼────────────────────────── ──┼ ┼───────────── ──────────────────────────5 ├ ┤─RECOVOPTION(CLEARCONV)─── └ ┘─RELREQ(YES)─ ├ ┤─RECOVOPTION(NONE)──────── ├ ┤─RECOVOPTION(RELEASESESS)─ └ ┘─RECOVOPTION(UNCONDREL)───

┌ ┐─SENDSIZE(ð)───────5─ ──┬ ┬────────────────────── ──┼ ┼─────────────────── ────────────────────────5

├ ┤─ROUTEDMSGS(ALL)────── └ ┘──SENDSIZE(ð-3ð72ð) ├ ┤─ROUTEDMSGS(NONE)───── └ ┘─ROUTEDMSGS(SPECIFIC)─

┌ ┐─SHIPPABLE(NO)── ┌ ┐─SIGNOFF(YES)────5─ ──┬ ┬──────────────────── ──┼ ┼──────────────── ──┼ ┼───────────────── ────────5

└ ┘──SESSIONTYPE(char8) └ ┘─SHIPPABLE(YES)─ ├ ┤─SIGNOFF(NO)───── └ ┘─SIGNOFF(LOGOFF)─

┌ ┐─SOSI(NO)── ┌ ┐─TEXTKYBD(NO)──5─ ──┼ ┼─────────── ──┬ ┬────────────── ──┼ ┼─────────────── ─────────────────────5 └ ┘─SOSI(YES)─ ├ ┤─TERMMODEL(1)─ └ ┘─TEXTKYBD(YES)─ └ ┘─TERMMODEL(2)─

┌ ┐─TEXTPRINT(NO)── ┌ ┐─TTI(YES)─ ┌ ┐─UCTRAN(NO)─────5─ ──┼ ┼──────────────── ──┼ ┼────────── ──┼ ┼──────────────── ───────────────────5 └ ┘─TEXTPRINT(YES)─ └ ┘─TTI(NO)── ├ ┤─UCTRAN(TRANID)─ └ ┘─UCTRAN(YES)────

┌ ┐─USERAREALEN(ð)───── ┌ ┐─VALIDATION(NO)──5─ ──┼ ┼──────────────────── ──┼ ┼───────────────── ─┤

└ ┘──USERAREALEN(ð-255) └ ┘─VALIDATION(YES)─

Chapter 2. SPI command syntax 115

Page 136: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

CREATE TYPETERM

TYPETERM attributes (3/3): ┌ ┐─VERTICALFORM(NO)── ┌ ┐─XRFSIGNOFF(NOFORCE)─├─ ──┼ ┼─────────────────── ──┼ ┼───────────────────── ─┤ └ ┘─VERTICALFORM(YES)─ └ ┘─XRFSIGNOFF(FORCE)───

DISABLE PROGRAM

55─ ──DISABLE PROGRAM(data-value) ──┬ ┬─────────────────────── ────────────────5└ ┘──ENTRYNAME(data-value)

5─ ──┬ ┬────────────────── ── ──┬ ┬─────────── ── ──┬ ┬────────── ── ──┬ ┬───── ───────5├ ┤──EXIT(data-value) └ ┘─FORMATEDF─ └ ┘─SHUTDOWN─ └ ┘─SPI─

└ ┘─EXITALL──────────

5─ ── ──┬ ┬────── ── ──┬ ┬─────────── ─5% └ ┘─STOP─ └ ┘─TASKSTART─

Conditions: INVEXITREQ, NOTAUTH

DISCARD AUTINSTMODEL

55─ ──DISCARD AUTINSTMODEL(data-value) ─5%

Conditions: INVREQ, MODELIDERR, NOTAUTH

DISCARD CONNECTION

55─ ──DISCARD CONNECTION(data-value) ─5%

Conditions: INVREQ, NOTAUTH, SYSIDERR

DISCARD DB2CONN

55─ ──DISCARD DB2CONN ─5%

Conditions: INVREQ, NOTAUTH, NOTFND

116 CICS User’s Handbook

Page 137: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

DISCARD DB2ENTRY

55─ ──DISCARD DB2ENTRY(data-value) ─5%

Conditions: NOTFND, INVREQ, NOTAUTH

DISCARD DB2TRAN

55─ ──DISCARD DB2TRAN(data-value) ─5%

Conditions: NOTFND, NOTAUTH

DISCARD DOCTEMPLATE

55─ ──DISCARD DOCTEMPLATE(data-value) ─5%

Conditions: NOTAUTH, NOTFND

| DISCARD ENQMODEL|

| 55─ ──DISCARD ENQMODEL(data-value) ─5%

| Conditions: NOTAUTH, NOTFND

DISCARD FILE

55─ ──DISCARD FILE(data-value) ─5%

Conditions: FILENOTFOUND, INVREQ, NOTAUTH

Chapter 2. SPI command syntax 117

Page 138: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

DISCARD JOURNALMODEL

55─ ──DISCARD ──JOURNALMODEL(data-value) ─5%

Conditions: NOTAUTH, NOTFND

DISCARD JOURNALNAME

55─ ──DISCARD ──JOURNALNAME(data-value) ─5%

Conditions: INVREQ, JIDERR, NOTAUTH

DISCARD PARTNER

55─ ──DISCARD PARTNER(data-value) ─5%

Conditions: INVREQ, NOTAUTH, PARTNERIDERR

DISCARD PROCESSTYPE

55──DISCARD─ ──PROCESSTYPE(data-value) ─5%

Conditions: INVREQ, NOTAUTH, PROCESSERR

DISCARD PROFILE

55─ ──DISCARD PROFILE(data-value) ─5%

Conditions: INVREQ, NOTAUTH, PROFILEIDERR

118 CICS User’s Handbook

Page 139: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

DISCARD PROGRAM

55─ ──DISCARD PROGRAM(data-value) ─5%

Conditions: INVREQ, NOTAUTH, PGMIDERR

DISCARD REQUESTMODEL

55─ ──DISCARD ──REQUESTMODEL(data-value) ─5%

Conditions: NOTAUTH, NOTFND

DISCARD TCPIPSERVICE

55─ ──DISCARD TCPIPSERVICE(data-value) ─5%

Conditions: INVREQ, NOTAUTH, NOTFND

DISCARD TDQUEUE

55─ ──DISCARD TDQUEUE(data-value) ─5%

Conditions: INVREQ, NOTAUTH, QIDERR

DISCARD TERMINAL

55─ ──DISCARD TERMINAL(data-value) ─5%

Conditions: INVREQ, NOTAUTH, TERMIDERR

Chapter 2. SPI command syntax 119

Page 140: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

DISCARD TRANCLASS

55─ ──DISCARD TRANCLASS(data-value) ─5%

Conditions: INVREQ, NOTAUTH, TCIDERR

DISCARD TRANSACTION

55─ ──DISCARD TRANSACTION(data-value) ─5%

Conditions: INVREQ, NOTAUTH, TRANSIDERR

| DISCARD TSMODEL|

| 55─ ──DISCARD TSMODEL(data-value) ─5%

| Conditions: INVREQ, NOTAUTH, NOTFND

ENABLE PROGRAM

┌ ┐─────────────────────────────────55─ ──ENABLE PROGRAM(data-value) ───

6┴┬ ┬───────────────────────────── ─5%

├ ┤──ENTRY(ptr-ref) ─────────────├ ┤──ENTRYNAME(data-value) ──────├ ┤──EXIT(data-value) ───────────

├ ┤─FORMATEDF───────────────────├ ┤──┬ ┬──GALENGTH(data-value) ───│ │└ ┘──GAENTRYNAME(data-value)

├ ┤─INDOUBTWAIT───────────────── ├ ┤─LINKEDITMODE────────────────

| ├ ┤──┬ ┬─QUASIRENT───────────────| │ │├ ┤| ─THREADSAFE─ ──┬ ┬─────────| │ ││ │└ ┘| ─OPENAPI─| │ │└ ┘─OPENAPI─────────────────

├ ┤─SHUTDOWN──────────────────── ├ ┤─SPI───────────────────────── ├ ┤─START───────────────────────

├ ┤──TALENGTH(data-value) ─────── └ ┘─TASKSTART───────────────────

Conditions: INVEXITREQ, NOTAUTH

120 CICS User’s Handbook

Page 141: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

EXTRACT EXIT

55─ ──EXTRACT EXIT PROGRAM(data-value) ──┬ ┬─────────────────────── ───────────5└ ┘──ENTRYNAME(data-value)

5─ ──GALENGTH(data-area) ──GASET(ptr-ref) ─5%

Conditions: INVEXITREQ, NOTAUTH

INQUIRE AUTINSTMODEL

55─ ──INQUIRE AUTINSTMODEL(data-value) ─5%

Conditions: END, ILLOGIC, MODELIDERR, NOTAUTH

INQUIRE AUTOINSTALL

┌ ┐────────────────────────55─ ──INQUIRE AUTOINSTALL ───

6┴┬ ┬──────────────────── ─5%

| ├ ┤──CONSOLES(cvda) ────├ ┤──CURREQS(data-area)├ ┤──ENABLESTATUS(cvda)├ ┤──MAXREQS(data-area)└ ┘──PROGRAM(data-area)

| Conditions: NOTAUTH

INQUIRE CFDTPOOL

55─ ──INQUIRE CFDTPOOL(data-value) ──┬ ┬────────────────── ─5%└ ┘──CONNSTATUS(cvda)

Conditions: END, ILLOGIC, NOTAUTH, POOLERR

Chapter 2. SPI command syntax 121

Page 142: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE CONNECTION

┌ ┐─────────────────────────────55─ ──INQUIRE CONNECTION(data-value) ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──ACCESSMETHOD(cvda) ─────├ ┤──ACQSTATUS(cvda) ────────├ ┤──AUTOCONNECT(cvda) ──────├ ┤──CONNSTATUS(cvda) ───────├ ┤──CONNTYPE(cvda) ─────────

| ├ ┤──CQP(cvda) ──────────────├ ┤──EXITTRACING(cvda) ──────├ ┤──GRNAME(data-area) ──────├ ┤──LINKSYSTEM(data-area) ──├ ┤──MEMBERNAME(data-area) ──├ ┤──NETNAME(data-area) ─────├ ┤──PENDSTATUS(cvda) ───────├ ┤──PROTOCOL(cvda) ─────────├ ┤──RECEIVECOUNT(data-area)├ ┤──RECOVSTATUS(cvda) ──────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSNET(data-area)├ ┤──REMOTESYSTEM(data-area)├ ┤──SENDCOUNT(data-area) ───├ ┤──SERVSTATUS(cvda) ───────├ ┤──XLNSTATUS(cvda) ────────└ ┘──ZCPTRACING(cvda) ───────

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

122 CICS User’s Handbook

Page 143: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE DB2CONN

55─ ──INQUIRE DB2CONN ───────────────────────────────────────────────────────5

┌ ┐───────────────────────────── ┌ ┐─────────────────────────────5─ ───

6┴┬ ┬───────────────────────── ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── ├ ┤──DB2ID(data-area) ───────│ │├ ┤─UOW────────────── ├ ┤──DB2RELEASE(data-area) ──│ │├ ┤─TASK───────────── ├ ┤──┬ ┬──DROLLBACK(cvda) ────

│ │├ ┤─TXID───────────── │ │├ ┤─ROLLBACK──────── │ │└ ┘─NONE───────────── │ │└ ┘─NOROLLBACK──────

├ ┤──AUTHID(data-area) ────── ├ ┤──MSGQUEUE1(data-area) ───├ ┤──┬ ┬──AUTHTYPE(cvda) ───── ├ ┤──MSGQUEUE2(data-area) ───│ │├ ┤─GROUP────────── ├ ┤──MSGQUEUE3(data-area) ───│ │├ ┤─SIGN─────────── ├ ┤──┬ ┬──NONTERMREL(cvda) ───

│ │├ ┤─TERM─────────── │ │├ ┤─RELEASE────────── │ │├ ┤─TX───────────── │ │└ ┘─NORELEASE────────

│ │├ ┤─OPID─────────── ├ ┤──PLAN(data-area) ────────│ │└ ┘─USERID───────── ├ ┤──PLANEXITNAME(data-area)├ ┤──COMAUTHID(data-area) ─── ├ ┤──┬ ┬──PRIORITY(cvda) ─────├ ┤──┬ ┬──COMAUTHTYPE(cvda) ── │ │├ ┤─HIGH───────────

│ │├ ┤─CGROUP──────────── │ │├ ┤─EQUAL────────── │ │├ ┤─CSIGN───────────── │ │└ ┘─LOW────────────

│ │├ ┤─CTERM───────────── ├ ┤──PURGECYCLEM(data-area) ─│ │├ ┤─CTX─────────────── ├ ┤──PURGECYCLES(data-area) ─│ │├ ┤─COPID───────────── ├ ┤──SIGNID(data-area) ──────│ │└ ┘─CUSERID─────────── ├ ┤──┬ ┬──STANDBYMODE(cvda) ──├ ┤──COMTHREADLIM(data-area) │ │├ ┤─NOCONNECT─────────├ ┤──COMTHREADS(data-area) ── │ │├ ┤─CONNECT───────────├ ┤──┬ ┬──CONNECTERROR(cvda) ─ │ │└ ┘─RECONNECT─────────│ │├ ┤─ABEND────────────── ├ ┤──STATSQUEUE(data-area) ──│ │└ ┘─SQLCODE──────────── ├ ┤──TCBLIMIT(data-area) ────└ ┘──┬ ┬──CONNECTST(cvda) ──── ├ ┤──TCBs(data-area) ────────├ ┤─CONNECTED─────── ├ ┤──THREADS(data-area) ─────├ ┤─CONNECTING────── ├ ┤──┬ ┬──THREADERROR(cvda) ──

├ ┤─DISCONNING────── │ │├ ┤─ABEND───────────── └ ┘─NOTCONNECTED──── │ │├ ┤─N9ð6D───────────── │ │└ ┘─N9ð6──────────────

├ ┤──THREADLIMIT(data-area) ─└ ┘──┬ ┬──THREADWAIT(cvda) ───

├ ┤─TWAIT──────────── └ ┘─NOTWAIT──────────

Conditions: NOTAUTH, NOTFND

Chapter 2. SPI command syntax 123

Page 144: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE DB2ENTRY

55─ ──INQUIRE DB2ENTRY(data-value) ──┬ ┬────────────────── ────────────────────5├ ┤──ACCOUNTREC(cvda)

├ ┤─UOW────────────── ├ ┤─TASK───────────── ├ ┤─TXID───────────── └ ┘─NONE─────────────

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────── ──┬ ┬─────────────────── ───────5└ ┘──AUTHID(data-area) ├ ┤──AUTHTYPE(cvda) ├ ┤──DISABLEDACT(cvda)

├ ┤─GROUP────────── ├ ┤─ABEND───────────── ├ ┤─SIGN─────────── ├ ┤─SQLCODE─────────── ├ ┤─TERM─────────── └ ┘─POOL────────────── ├ ┤─TX───────────── ├ ┤─OPID─────────── └ ┘─USERID─────────

5─ ──┬ ┬───────────────── ──┬ ┬──────────────────── ──┬ ┬───────────────── ───────5├ ┤──DROLLBACK(cvda) ├ ┤──ENABLESTATUS(cvda) └ ┘──PLAN(data-area)

├ ┤─ROLLBACK──────── ├ ┤─ENABLED──────────── └ ┘─NOROLLBACK────── ├ ┤─DISABLED─────────── └ ┘─DISABLING──────────

5─ ──┬ ┬───────────────────────── ──┬ ┬──────────────── ────────────────────────5└ ┘──PLANEXITNAME(data-area) ├ ┤──PRIORITY(cvda)

├ ┤─HIGH─────────── ├ ┤─EQUAL────────── └ ┘─LOW────────────

5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────── ─────────────────────5└ ┘──PROTECTNUM(data-area) └ ┘──PTHREADS(data-area)

5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─────────────────────5└ ┘──THREADLIMIT(data-area) └ ┘──THREADS(data-area)

5─ ──┬ ┬────────────────── ─5%├ ┤──THREADWAIT(cvda)

├ ┤─TWAIT──────────── ├ ┤─NOTWAIT────────── └ ┘─TPOOL────────────

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

INQUIRE DB2TRAN

55─ ─INQUIRE DB2TRAN─ ──┬ ┬────────────── ──┬ ┬───────────────────── ────────────5└ ┘──(data-value) └ ┘──DB2ENTRY(data-area)

5─ ──┬ ┬──────────────────── ─5%└ ┘──TRANSID(data-area)

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

124 CICS User’s Handbook

Page 145: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE DELETSHIPPED

55─ ──INQUIRE DELETSHIPPED ──────────────────────────────────────────────────5

5─ ──┬ ┬────────────────────────────────────────────────────────────── ───────5├ ┤──IDLE(data-area) ─────────────────────────────────────────────

└ ┘──IDLEHRS(data-area) ──IDLEMINS(data-area) ──IDLESECS(data-area)

5─ ──┬ ┬────────── ─5%├ ┤─┤ INQ7 ├─└ ┘─┤ INQ8 ├─

INQ7:├─ ──INTERVAL(data-area) ─┤

INQ8:├──┤ INQ9 ├─ ──INTERVALMINS(data-area) ──INTERVALSECS(data-area) ─┤

INQ9:├─ ──INTERVALHRS(data-area) ─┤

Conditions: NOTAUTH

INQUIRE DOCTEMPLATE

┌ ┐─────────────────────────────55─ ──INQUIRE DOCTEMPLATE(data-value) ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──APPENDCRLF(cvda) ───────├ ┤──DDNAME(data-area) ──────├ ┤──DSNAME(data-area) ──────├ ┤──EXITPGM(data-area) ─────├ ┤──FILE(data-area) ────────├ ┤──MEMBER(data-area) ──────├ ┤──PROGRAM(data-area) ─────├ ┤──TDQUEUE(data-area) ─────├ ┤──TEMPLATENAME(data-area)├ ┤──TEMPLATETYPE(cvda) ─────├ ┤──TSQUEUE(data-area) ─────└ ┘──TYPE(cvda) ─────────────

Conditions: END, ILLOGIC, NOTFND, NOTAUTH

Chapter 2. SPI command syntax 125

Page 146: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE DSNAME

┌ ┐────────────────────────────55─ ──INQUIRE DSNAME(data-value) ───

6┴┬ ┬──────────────────────── ─5%

├ ┤──ACCESSMETHOD(cvda) ────├ ┤──AVAILABILITY(cvda) ────├ ┤──BACKUPTYPE(cvda) ──────├ ┤──BASEDSNAME(data-area) ─├ ┤──FILECOUNT(data-area) ──├ ┤──FWDRECOVLOG(data-area)├ ┤──FWDRECOVLSN(data-area)├ ┤──OBJECT(cvda) ──────────├ ┤──LOSTLOCKS(cvda) ───────├ ┤──QUIESCESTATE(cvda) ────├ ┤──RECOVSTATUS(cvda) ─────├ ┤──RETLOCKS(cvda) ────────└ ┘──VALIDITY(cvda) ────────

Conditions: DSNNOTFOUND, END, ILLOGIC, IOERR, NOTAUTH

INQUIRE DUMPDS

┌ ┐───────────────────────────55─ ──INQUIRE DUMPDS ───

6┴┬ ┬─────────────────────── ─5%

├ ┤──CURRENTDDS(data-area)├ ┤──INITIALDDS(data-area)├ ┤──OPENSTATUS(cvda) ─────└ ┘──SWITCHSTATUS(cvda) ───

Conditions: NOTAUTH

126 CICS User’s Handbook

Page 147: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

| INQUIRE ENQ|

| 55─ ──INQUIRE ENQ ──┬ ┬──ENQSCOPE(data-value) ────────────────── ───────────────5| ├ ┤──| RESOURCE(data-value)| RESLEN(data-value)| └ ┘──UOW(data-value) ───────────────────────

| ┌ ┐──────────────────────────| 5─ ───

6┴┬ ┬────────────────────── ─5%

| ├ ┤──DURATION(data-area) ─| ├ ┤──ENQFAILS(data-area) ─| ├ ┤──NETUOWID(data-area) ─| ├ ┤──QUALIFIER(data-area)| ├ ┤──QUALLEN(data-area) ──| ├ ┤──RELATION(cvda) ──────| ├ ┤──RESLEN(data-area) ───| ├ ┤──RESOURCE(data-area) ─| ├ ┤──STATE(cvda) ─────────| ├ ┤──TASKID(data-area) ───| ├ ┤──TRANSID(data-area) ──| ├ ┤ ─ ─TYPE(cvda) ──────────| └ ┘──UOW(data-area) ──────

| Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

| INQUIRE ENQMODEL|

| ┌ ┐─────────────────────────| 55─ ──INQUIRE ENQMODEL(data-value) ───

6┴┬ ┬───────────────────── ─5%

| ├ ┤──ENQSCOPE(data-area)| ├ ┤──ENQNAME(data-area) ─| └ ┘──STATUS(cvda) ───────

| Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE EXCI

55─ ──INQUIRE EXCI ──┬ ┬────────────────── ─5% ├ ┤──TASK(data-value) └ ┘──URID(data-value)

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax 127

Page 148: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE EXITPROGRAM

┌ ┐──────────────────────────────55─ ──INQUIRE EXITPROGRAM(data-value) ───

6┴┬ ┬────────────────────────── ─5%

├ ┤──EXIT(data-value) ────────├ ┤──ENTRYNAME(data-value) ───

| ├ ┤──APIST(data-value) ───────| ├ ┤──CONCURRENTST(data-value)

├ ┤──CONNECTST(cvda) ─────────├ ┤──ENTRY(data-area) ────────├ ┤──FORMATEDFST(cvda) ───────├ ┤──GAENTRYNAME(data-area) ──├ ┤──GALENGTH(data-area) ─────├ ┤──GAUSECOUNT(data-area) ───├ ┤──INDOUBTST(cvda) ─────────├ ┤──NUMEXITS(data-area) ─────├ ┤──QUALIFIER(data-area) ────├ ┤──SHUTDOWNST(cvda) ────────├ ┤──SPIST(cvda) ─────────────├ ┤──STARTSTATUS(cvda) ───────├ ┤──TALENGTH(data-area) ─────└ ┘──TASKSTARTST(cvda) ───────

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, PGMIDERR

128 CICS User’s Handbook

Page 149: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE FILE

┌ ┐─────────────────────────────55─ ──INQUIRE FILE(data-value) ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──ACCESSMETHOD(cvda) ─────├ ┤──ADD(cvda) ──────────────├ ┤──BASEDSNAME(data-area) ──├ ┤──BLOCKFORMAT(cvda) ──────├ ┤──BLOCKKEYLEN(data-area) ─├ ┤──BLOCKSIZE(data-area) ───├ ┤──BROWSE(cvda) ───────────

| ├ ┤──CFDTPOOL(data-area) ────├ ┤──DELETE(cvda) ───────────├ ┤──DISPOSITION(cvda) ──────├ ┤──DSNAME(data-area) ──────├ ┤──EMPTYSTATUS(cvda) ──────├ ┤──ENABLESTATUS(cvda) ─────├ ┤──EXCLUSIVE(cvda) ────────├ ┤──FWDRECSTATUS(cvda) ─────├ ┤──JOURNALNUM(data-area) ──├ ┤──KEYLENGTH(data-area) ───├ ┤──KEYPOSITION(data-area) ─

| ├ ┤──LOADTYPE(cvda) ─────────├ ┤──LSRPOOLID(data-area) ───├ ┤──MAXNUMRECS(data-area) ──├ ┤──OBJECT(cvda) ───────────├ ┤──OPENSTATUS(cvda) ───────├ ┤──READ(cvda) ─────────────├ ┤──READINTEG(cvda) ────────├ ┤──RECORDFORMAT(cvda) ─────├ ┤──RECORDSIZE(data-area) ──├ ┤──RECOVSTATUS(cvda) ──────├ ┤──RELTYPE(cvda) ──────────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSTEM(data-area)

| ├ ┤──REMOTETABLE(cvda) ──────├ ┤──RLSACCESS(cvda) ────────├ ┤──STRINGS(data-area) ─────├ ┤──TABLE(cvda) ────────────

| ├ ┤──TABLENAME(data-area) ───├ ┤──TYPE(cvda) ─────────────├ ┤──UPDATE(cvda) ───────────

| └ ┘──UPDATEMODEL(cvda) ──────

Conditions: END, FILENOTFOUND, ILLOGIC, NOTAUTH

INQUIRE IRC

55─ ──INQUIRE IRC ──┬ ┬────────────────── ─5%└ ┘──OPENSTATUS(cvda)

Conditions: NOTAUTH

Chapter 2. SPI command syntax 129

Page 150: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE JOURNALMODEL

55─ ──INQUIRE JOURNALMODEL(data-value) ──┬ ┬──────────────────────── ──────────5└ ┘──JOURNALNAME(data-area)

5─ ──┬ ┬─────────────────────── ──┬ ┬──────────── ─5%└ ┘──STREAMNAME(data-area) └ ┘──TYPE(cvda)

Conditions : END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE JOURNALNAME

┌ ┐───────────────────────────55─ ──INQUIRE JOURNALNAME(data-value) ───

6┴┬ ┬─────────────────────── ─5%

├ ┤──STATUS(cvda) ─────────├ ┤──STREAMNAME(data-area)└ ┘──TYPE(cvda) ───────────

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

INQUIRE MODENAME

55─ ──INQUIRE MODENAME(data-value) ──CONNECTION(data-value) ──────────────────5

┌ ┐───────────────────────────5─ ───

6┴┬ ┬─────────────────────── ─5%

├ ┤──ACTIVE(data-area) ────├ ┤──AUTOCONNECT(cvda) ────├ ┤──AVAILABLE(data-area) ─├ ┤──MAXIMUM(data-area) ───└ ┘──MAXWINNERS(data-area)

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

130 CICS User’s Handbook

Page 151: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE MONITOR

┌ ┐─────────────────────────────────────────────────55─ ──INQUIRE MONITOR ───

6┴┬ ┬───────────────────────────────────────────── ─5%

├ ┤──CONVERSEST(cvda) ───────────────────────────├ ┤──EVENTCLASS(cvda) ───────────────────────────├ ┤──EXCEPTCLASS(cvda) ──────────────────────────├ ┤──┬ ┬──FREQUENCY(data-area) ───────────────────

│ │└ ┘─┤ freqhrs ├──┤ freqmins ├──┤ freqsecs ├─├ ┤──PERFCLASS(cvda) ────────────────────────────├ ┤──STATUS(cvda) ───────────────────────────────├ ┤──SUBSYSTEMID(data-area) ─────────────────────├ ┤──SYNCPOINTST(cvda) ──────────────────────────└ ┘──TIME(cvda) ─────────────────────────────────

freqhrs:├─ ──FREQUENCYHRS(data-area) ─┤

freqmins:├─ ──FREQUENCYMIN(data-area) ─┤

freqsecs:├─ ──FREQUENCYSEC(data-area) ─┤

Conditions: NOTAUTH

INQUIRE TERMINAL/NETNAME

55─ ──INQUIRE NETNAME(data-value) ──┬ ┬───────────────────── ─5%└ ┘──TERMINAL(data-area)

Conditions: NOTAUTH, TERMIDERR

INQUIRE PARTNER

┌ ┐──────────────────────────55─ ──INQUIRE PARTNER(data-value) ───

6┴┬ ┬────────────────────── ─5%

├ ┤──NETWORK(data-area) ──├ ┤──NETNAME(data-area) ──├ ┤──PROFILE(data-area) ──├ ┤──TPNAME(data-area) ───└ ┘──TPNAMELEN(data-area)

Conditions: END, ILLOGIC, NOTAUTH, PARTNERIDERR

Chapter 2. SPI command syntax 131

Page 152: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE PROCESSTYPE

55──INQUIRE─ ──PROCESSTYPE(data-value) ──┬ ┬───────────────── ─────────────────5└ ┘──FILE(data-area)

5─ ──┬ ┬───────────────────── ──┬ ┬────────────────── ──┬ ┬────────────── ─5%└ ┘──AUDITLOG(data-area) └ ┘──AUDITLEVEL(cvda) └ ┘──STATUS(cvda)

Conditions: NOTAUTH, PROCESSERR

INQUIRE PROFILE

55─ ──INQUIRE PROFILE(data-value) ─5%

Conditions: END, ILLOGIC, NOTAUTH, PROFILEIDERR

INQUIRE PROGRAM

┌ ┐───────────────────────────────────────55─ ──INQUIRE PROGRAM(data-value) ───

6┴┬ ┬─────────────────────────────────── ─5%

├ ┤──CEDFSTATUS(cvda) ─────────────────├ ┤──COBOLTYPE(cvda) ──────────────────├ ┤──COPY(cvda) ───────────────────────

| ├ ┤──CONCURRENCY(cvda) ────────────────├ ┤──DATALOCATION(cvda) ───────────────

| ├ ┤──DYNAMSTATUS(cvda) ────────────────├ ┤──ENTRYPOINT(ptr-ref) ──────────────├ ┤──EXECKEY(cvda) ────────────────────├ ┤──EXECUTIONSET(cvda) ───────────────├ ┤──HOLDSTATUS(cvda) ─────────────────

| ├ ┤──JVMCLASS(255-character data-area)| ├ ┤──JVMDEBUG(cvda) ───────────────────

├ ┤──LANGDEDUCED(cvda) ────────────────├ ┤──LANGUAGE(cvda) ───────────────────├ ┤──LENGTH(data-area) ────────────────├ ┤──LOADPOINT(ptr-ref) ───────────────├ ┤──LPASTATUS(cvda) ──────────────────├ ┤──PROGTYPE(cvda) ───────────────────├ ┤──REMOTENAME(data-area) ────────────├ ┤──REMOTESYSTEM(data-area) ──────────├ ┤──RESCOUNT(data-area) ──────────────

| ├ ┤──RUNTIME(cvda) ────────────────────├ ┤──SHARESTATUS(cvda) ────────────────├ ┤──STATUS(cvda) ─────────────────────├ ┤──TRANSID(data-area) ───────────────└ ┘──USECOUNT(data-area) ──────────────

Conditions: END, ILLOGIC, NOTAUTH, PGMIDERR

132 CICS User’s Handbook

Page 153: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE REQID

55─ ──INQUIRE REQID(data-value) ──┬ ┬─────────────── ──────────────────────────5└ ┘──REQTYPE(cvda)

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──TERMID(data-area) └ ┘──TRANSID(data-area)

5─ ──┬ ┬───────────────────────────────────────────────────────────────── ────5├ ┤──INTERVAL(data-area) ────────────────────────────────────────────├ ┤──TIME(data-area) ────────────────────────────────────────────────

├ ┤─AFTER─ ──HOURS(data-area) ──MINUTES(data-area) ──SECONDS(data-area) └ ┘─AT─ ──HOURS(data-area) ──MINUTES(data-area) ──SECONDS(data-area) ───

5─ ──┬ ┬────────────────────────────────────────────────────── ───────────────5 └ ┘──SET(ptr-ref) ──LENGTH(data-area) ──┬ ┬─────────────────

└ ┘──FMHSTATUS(cvda)

5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5└ ┘──RTRANSID(data-area) └ ┘──RTERMID(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5%└ ┘──QUEUE(data-area) └ ┘──USERID(data-area)

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, NOTFND

INQUIRE REQUESTMODEL

┌ ┐─────────────────────────────55─ ──INQUIRE REQUESTMODEL(data-value) ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──OMGINTERFACE(data-area)├ ┤──OMGMODULE(data-area) ───├ ┤──OMGOPERATION(data-area)└ ┘──TRANSID(data-value) ────

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

INQUIRE RRMS

55─ ──INQUIRE RRMS ──┬ ┬────────────────── ─5% └ ┘──OPENSTATUS(cvda)

Conditions:

Chapter 2. SPI command syntax 133

Page 154: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE STATISTICS

55─ ──INQUIRE STATISTICS ──┬ ┬────────────────────────────────────── ──────────5├ ┤──ENDOFDAY(data-area) ─────────────────

└ ┘─┤ endhrs ├──┤ endmins ├──┤ endsecs ├─

5─ ──┬ ┬─────────────────────────────────── ──────────────────────────────────5├ ┤──INTERVAL(data-area) ──────────────

└ ┘─┤ inhrs ├──┤ inmins ├──┤ insecs ├─

5─ ──┬ ┬─────────────────────────────────── ──┬ ┬───────────────── ─5%├ ┤──NEXTTIME(data-area) ────────────── └ ┘──RECORDING(cvda)

└ ┘─┤ nxhrs ├──┤ nxmins ├──┤ nxsecs ├─

endhrs:├─ ──ENDOFDAYHRS(data-area) ─┤

endmins:├─ ──ENDOFDAYMINS(data-area) ─┤

endsecs:├─ ──ENDOFDAYSECS(data-area) ─┤

inhrs:├─ ──INTERVALHRS(data-area) ─┤

inmins:├─ ──INTERVALMINS(data-area) ─┤

insecs:├─ ──INTERVALSECS(data-area) ─┤

nxhrs:├─ ──NEXTTIMEHRS(data-area) ─┤

nxmins:├─ ──NEXTTIMEMINS(data-area) ─┤

nxsecs:├─ ──NEXTTIMESECS(data-area) ─┤

Conditions: NOTAUTH

134 CICS User’s Handbook

Page 155: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE STORAGE

55─ ──INQUIRE STORAGE ───────────────────────────────────────────────────────5

5─ ──┬ ┬──ADDRESS(ptr-value) ──┬ ┬────────────────── ──┬ ┬──────────────────── ─5%│ │└ ┘──ELEMENT(ptr-ref) └ ┘──FLENGTH(data-area)

└ ┘──NUMELEMENTS(data-area) ─┤ elist ├──┤ llist ├──┤ task ├───────────

elist:├─ ──┬ ┬────────────────────── ─┤

└ ┘──ELEMENTLIST(ptr-ref)

llist:├─ ──┬ ┬───────────────────── ─┤

└ ┘──LENGTHLIST(ptr-ref)

task:├─ ──┬ ┬────────────────── ─┤

└ ┘──TASK(data-value)

Conditions: NOTAUTH, TASKIDERR

INQUIRE STREAMNAME

┌ ┐─────────────────────────55─ ──INQUIRE STREAMNAME(data-value) ───

6┴┬ ┬───────────────────── ─5%

├ ┤──STATUS(cvda) ───────├ ┤──SYSTEMLOG(cvda) ────└ ┘──USECOUNT(data-area)

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE SYSDUMPCODE

┌ ┐────────────────────────55─ ──INQUIRE SYSDUMPCODE(data-value) ───

6┴┬ ┬──────────────────── ─5%

├ ┤──CURRENT(data-area)├ ┤──DAEOPTION(cvda) ───├ ┤──DUMPSCOPE(cvda) ───├ ┤──MAXIMUM(data-area)├ ┤──SHUTOPTION(cvda) ──└ ┘──SYSDUMPING(cvda) ──

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

Chapter 2. SPI command syntax 135

Page 156: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE SYSTEM

┌ ┐──────────────────────────────────────────────55─ ──INQUIRE SYSTEM ───

6┴┬ ┬────────────────────────────────────────── ─5%

| ├ ┤──ACTOPENTCBS(data-area) ──────────────────├ ┤──AKP(data-area) ──────────────────────────├ ┤──CDSASIZE(data-area) ─────────────────────├ ┤──CICSSTATUS(cvda) ────────────────────────├ ┤──CICSSYS(data-area) ──────────────────────├ ┤──CICSTSLEVEL(data-area) ──────────────────├ ┤──CMDPROTECT(cvda) ────────────────────────├ ┤──COLDSTATUS(cvda) ────────────────────────├ ┤──DB2CONN(data-area) ──────────────────────├ ┤──DFLTUSER(data-area) ─────────────────────├ ┤──DSALIMIT(data-area) ─────────────────────

| ├ ┤──DSRTPROGRAM(data-area) ──────────────────├ ┤──DTRPROGRAM(data-area) ───────────────────├ ┤──DUMPING(cvda) ───────────────────────────├ ┤ ─ ─ECDSASIZE(data-area) ────────────────────├ ┤ ─ ─EDSALIMIT(data-area) ────────────────────├ ┤ ─ ─ERDSASIZE(data-area) ────────────────────├ ┤ ─ ─ESDSASIZE(data-area) ────────────────────├ ┤ ─ ─EUDSASIZE(data-area) ────────────────────

| ├ ┤──FORCEQR(cvda) ─────────────────────────── ├ ┤──GMMTEXT(data-area) ──GMMLENGTH(data-area)

├ ┤ ─ ─GMMTRANID(data-area) ────────────────────├ ┤──INITSTATUS(cvda) ────────────────────────├ ┤──JOBNAME(data-area) ──────────────────────

| ├ ┤──LOGDEFER(data-area) ─────────────────────| ├ ┤──MAXOPENTCBS(data-area) ──────────────────

├ ┤──MAXTASKS(data-area) ─────────────────────├ ┤──MROBATCH(data-area) ─────────────────────├ ┤──OPREL(data-area) ────────────────────────├ ┤──OPSYS(data-area) ────────────────────────

| ├ ┤──OSLEVEL(data-area) ──────────────────────├ ┤──PROGAUTOCTLG(cvda) ──────────────────────├ ┤──PROGAUTOEXIT(data-area) ─────────────────├ ┤──PROGAUTOINST(cvda) ──────────────────────├ ┤ ─ ─PRTYAGING(data-area) ────────────────────├ ┤──RDSASIZE(data-area) ─────────────────────├ ┤──REENTPROTECT(cvda) ──────────────────────├ ┤──RELEASE(data-area) ──────────────────────├ ┤──RLSSTATUS(cvda) ─────────────────────────├ ┤──RUNAWAY(data-area) ──────────────────────├ ┤ ─ ─SCANDELAY(data-area) ────────────────────├ ┤──SDSASIZE(data-area) ─────────────────────├ ┤──SDTRAN(data-area) ───────────────────────├ ┤──SECURITYMGR(cvda) ───────────────────────├ ┤──SHUTSTATUS(cvda) ────────────────────────├ ┤──SOSSTATUS(cvda) ─────────────────────────├ ┤──STARTUP(cvda) ───────────────────────────├ ┤──STARTUPDATE(data-area) ──────────────────├ ┤──STOREPROTECT(cvda) ──────────────────────├ ┤──TIME(data-area) ─────────────────────────├ ┤──TRANISOLATE(cvda) ───────────────────────├ ┤──UDSASIZE(data-area) ─────────────────────└ ┘──XRFSTATUS(cvda) ─────────────────────────

Condition: NOTAUTH

136 CICS User’s Handbook

Page 157: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE TASK

┌ ┐─────────────────────────────────55─ ──INQUIRE TASK(data-value) ───

6┴┬ ┬───────────────────────────── ─5%

| ├ ┤──ACTIVITY(data-area) ────────| ├ ┤──ACTIVITYID(data-area) ──────

├ ┤──ATTACHTIME(data-area) ──────├ ┤──BRIDGE(data-area) ──────────├ ┤──CMDSEC(cvda) ───────────────├ ┤──DB2PLAN(data-area) ─────────├ ┤──DTIMEOUT(data-area) ────────├ ┤──DUMPING(cvda) ──────────────├ ┤──FACILITY(data-area) ────────├ ┤──FACILITYTYPE(cvda) ─────────├ ┤──IDENTIFIER(data-area) ──────├ ┤──INDOUBT(cvda) ──────────────├ ┤──INDOUBTMINS(data-area) ─────├ ┤──INDOUBTWAIT(cvda) ──────────├ ┤──ISOLATEST(cvda) ────────────├ ┤──PRIORITY(data-area) ────────

| ├ ┤──PROCESS(data-area) ─────────| ├ ┤──PROCESSTYPE(data-area) ─────

├ ┤──PROFILE(data-area) ─────────├ ┤──PROGRAM(data-area) ─────────├ ┤──PURGEABILITY(cvda) ─────────├ ┤──REMOTENAME(data-area) ──────├ ┤──REMOTESYSTEM(data-area) ────├ ┤──RESSEC(cvda) ───────────────├ ┤──ROUTING(cvda) ──────────────├ ┤──RTIMEOUT(data-area) ────────├ ┤──RUNAWAY(data-area) ─────────├ ┤──RUNSTATUS(cvda) ────────────├ ┤──SCRNSIZE(cvda) ─────────────├ ┤──STARTCODE(data-area) ───────├ ┤──STORAGECLEAR(cvda) ─────────├ ┤──SUSPENDTIME(data-area) ─────├ ┤──SUSPENDTYPE(data-area) ─────├ ┤──┬ ┬──SUSPENDVALUE(data-area)

| │ │└ ┘──RESNAME(data-area) ─────├ ┤──TASKDATAKEY(cvda) ──────────├ ┤──TASKDATALOC(cvda) ──────────├ ┤──TCB(cvda) ──────────────────├ ┤──┬ ┬──TRANCLASS(data-area) ───│ │└ ┘──TCLASS(data-area) ───├ ┤──TRACING(cvda) ──────────────├ ┤──TRANPRIORITY(data-area) ────├ ┤──TRANSACTION(data-area) ─────├ ┤──TRPROF(data-area) ──────────├ ┤──TWASIZE(data-area) ─────────├ ┤──UOW(data-area) ─────────────└ ┘──USERID(data-area) ──────────

Conditions: NOTAUTH, TASKIDERR

Chapter 2. SPI command syntax 137

Page 158: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE TASK LIST

55─ ──INQUIRE TASK LIST ──LISTSIZE(data-area) ── ──┬ ┬────────────── ────────────5 └ ┘─DISPATCHABLE─

5─ ── ──┬ ┬───────── ── ──┬ ┬─────────── ─────────────────────────────────────────5 └ ┘─RUNNING─ └ ┘─SUSPENDED─

5─ ──┬ ┬─────────────────────────────────────── ─5% └ ┘──SET(ptr-ref) ──┬ ┬─────────────────────

└ ┘──SETTRANSID(ptr-ref)

Condition: NOTAUTH

INQUIRE TCLASS

┌ ┐────────────────────────55─ ──INQUIRE TCLASS(data-value) ───

6┴┬ ┬──────────────────── ─5%

├ ┤──CURRENT(data-area)└ ┘──MAXIMUM(data-area)

Conditions: NOTAUTH, TCIDERR

INQUIRE TCPIP

55─ ──INQUIRE TCPIP ──OPENSTATUS(cvda) ─5%

Conditions: INVREQ, NOTAUTH

138 CICS User’s Handbook

Page 159: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE TCPIPService

┌ ┐─────────────────────────────55─ ──INQUIRE TCPIPSERVICE(data-value) ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──BACKLOG(data-area) ─────├ ┤──CLOSETIMEOUT(data-area)├ ┤──CONNECTIONS(data-area) ─├ ┤──IPADDRESS(data-area) ───├ ┤──OPENSTATUS(cvda) ───────├ ┤──PORT(data-area) ────────├ ┤──SOCKETCLOSE(cvda) ──────├ ┤──SSLTYPE(cvda) ──────────├ ┤──TRANSID(data-area) ─────├ ┤──TSQPREFIX(data-area) ───└ ┘──URM(data-area) ─────────

Conditions: INVREQ, NOTAUTH , NOTFND

INQUIRE TDQUEUE

┌ ┐─────────────────────────────55─ ──INQUIRE TDQUEUE(data-value) ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──ATIFACILITY(cvda) ──────├ ┤──ATITERMID(data-area) ───├ ┤──ATITRANID(data-area) ───├ ┤──ATIUSERID(data-area) ───├ ┤──BLOCKFORMAT(cvda) ──────├ ┤──BLOCKSIZE(data-area) ───├ ┤──DATABUFFERS(data-area) ─├ ┤──DDNAME(data-area) ──────├ ┤──DISPOSITION(cvda) ──────├ ┤──DSNAME(data-area) ──────├ ┤──EMPTYSTATUS(cvda) ──────├ ┤──ENABLESTATUS(cvda) ─────├ ┤──ERROROPTION(cvda) ──────├ ┤──INDIRECTNAME(data-area)├ ┤──INDOUBT(cvda) ──────────├ ┤──INDOUBTWAIT(cvda) ──────├ ┤──IOTYPE(cvda) ───────────

| ├ ┤──MEMBER(data-area) ──────├ ┤──NUMITEMS(data-area) ────├ ┤──OPENSTATUS(cvda) ───────├ ┤──PRINTCONTROL(cvda) ─────├ ┤──RECORDFORMAT(cvda) ─────├ ┤──RECORDLENGTH(data-area)├ ┤──RECOVSTATUS(cvda) ──────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSTEM(data-area)├ ┤──REWIND(cvda) ───────────├ ┤──SYSOUTCLASS(cvda) ──────├ ┤──TRIGGERLEVEL(data-area)└ ┘──TYPE(cvda) ─────────────

Conditions: ENDCOND, ILLOGIC, NORMAL, NOTAUTH, QIDERR

Chapter 2. SPI command syntax 139

Page 160: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE TERMINAL/NETNAME

55─ ──INQUIRE TERMINAL(data-value) ──┬ ┬──────────────────── ─5%└ ┘──NETNAME(data-area)

The following options apply to both the INQUIRE TERMINAL and theINQUIRE NETNAME command.

INQUIRE TERMINAL

┌ ┐───────────────────────────55─ ───

6┴┬ ┬─────────────────────── ─5%

├ ┤──ACCESSMETHOD(cvda) ───├ ┤──ACQSTATUS(cvda) ──────├ ┤──ALTPAGEHT(data-area) ─├ ┤──ALTPAGEWD(data-area) ─├ ┤──ALTPRINTER(data-area)├ ┤──ALTPRTCOPYST(cvda) ───├ ┤──ALTSCRNHT(data-area) ─├ ┤──ALTSCRNWD(data-area) ─├ ┤──ALTSUFFIX(data-area) ─├ ┤──APLKYBDST(cvda) ──────├ ┤──APLTEXTST(cvda) ──────├ ┤──ASCII(cvda) ──────────├ ┤──ATISTATUS(cvda) ──────├ ┤──AUDALARMST(cvda) ─────├ ┤──AUTOCONNECT(cvda) ────├ ┤──BACKTRANSST(cvda) ────├ ┤──COLORST(cvda) ────────

| ├ ┤──CONSOLE(data-area) ───├ ┤──COPYST(cvda) ─────────├ ┤──CORRELID(data-area) ──├ ┤──CREATESESS(cvda) ─────├ ┤──DATASTREAM(cvda) ─────├ ┤──DEFPAGEHT(data-area) ─├ ┤──DEFPAGEWD(data-area) ─├ ┤──DEFSCRNHT(data-area) ─├ ┤──DEFSCRNWD(data-area) ─├ ┤──DEVICE(cvda) ─────────├ ┤──DISCREQST(cvda) ──────├ ┤──DUALCASEST(cvda) ─────├ ┤──EXITTRACING(cvda) ────├ ┤──EXTENDEDDSST(cvda) ───├ ┤──FMHPARMST(cvda) ──────├ ┤──FORMFEEDST(cvda) ─────├ ┤──GCHARS(data-area) ────├ ┤──GCODES(data-area) ────├ ┤──HFORMST(cvda) ────────├ ┤──HILIGHTST(cvda) ──────├ ┤──KATAKANAST(cvda) ─────├ ┤──LIGHTPENST(cvda) ─────├ ┤──LINKSYSTEM(data-area)├ ┤──MAPNAME(data-area) ───└ ┘──MAPSETNAME(data-area)

140 CICS User’s Handbook

Page 161: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE TERMINAL

┌ ┐─────────────────────────────55─ ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──MODENAME(data-area) ────├ ┤──MSRCONTROLST(cvda) ─────├ ┤──NATLANG(data-area) ─────├ ┤──NATURE(cvda) ───────────├ ┤──NEXTTRANSID(data-area) ─├ ┤──OBFORMATST(cvda) ───────├ ┤──OBOPERIDST(cvda) ───────├ ┤──OPERID(data-area) ──────├ ┤──OUTLINEST(cvda) ────────├ ┤──PAGEHT(data-area) ──────├ ┤──PAGESTATUS(cvda) ───────├ ┤──PAGEWD(data-area) ──────├ ┤──PARTITIONSST(cvda) ─────├ ┤──PRINTADAPTST(cvda) ─────├ ┤──PRINTER(data-area) ─────├ ┤──PROGSYMBOLST(cvda) ─────├ ┤──PRTCOPYST(cvda) ────────├ ┤──QUERYST(cvda) ──────────├ ┤──RELREQST(cvda) ─────────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSNET(data-area)├ ┤──REMOTESYSTEM(data-area)├ ┤──SCRNHT(data-area) ──────├ ┤──SCRNWD(data-area) ──────├ ┤──SECURITY(cvda) ─────────├ ┤──SERVSTATUS(cvda) ───────├ ┤──SESSIONTYPE(cvda) ──────├ ┤──SIGNONSTATUS(cvda) ─────├ ┤──SOSIST(cvda) ───────────├ ┤──TASKID(data-area) ──────├ ┤──TCAMCONTROL(data-area) ─├ ┤──TERMMODEL(data-area) ───├ ┤──TERMPRIORITY(data-area)├ ┤──TERMSTATUS(cvda) ───────├ ┤──TEXTKYBDST(cvda) ───────├ ┤──TEXTPRINTST(cvda) ──────├ ┤──TRACING(cvda) ──────────├ ┤──TRANSACTION(data-area) ─├ ┤──TTISTATUS(cvda) ────────├ ┤──UCTRANST(cvda) ─────────├ ┤──USERAREA(ptr-ref) ──────├ ┤──USERAREALEN(data-area) ─├ ┤──USERID(data-area) ──────├ ┤──USERNAME(data-area) ────├ ┤──VALIDATIONST(cvda) ─────├ ┤──VFORMST(cvda) ──────────└ ┘──ZCPTRACING(cvda) ───────

Conditions: END, ILLOGIC, NOTAUTH, TERMIDERR

Chapter 2. SPI command syntax 141

Page 162: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE TRACEDEST

┌ ┐──────────────────────────55─ ──INQUIRE TRACEDEST ───

6┴┬ ┬────────────────────── ─5%

├ ┤──AUXSTATUS(cvda) ─────├ ┤──CURAUXDS(data-area) ─├ ┤──GTFSTATUS(cvda) ─────├ ┤──INTSTATUS(cvda) ─────├ ┤──SWITCHSTATUS(cvda) ──└ ┘──TABLESIZE(data-area)

Conditions: NOTAUTH

INQUIRE TRACEFLAG

┌ ┐────────────────────────55─ ──INQUIRE TRACEFLAG ───

6┴┬ ┬──────────────────── ─5%

├ ┤──SINGLESTATUS(cvda)├ ┤──SYSTEMSTATUS(cvda)├ ┤──TCEXITSTATUS(cvda)└ ┘──USERSTATUS(cvda) ──

Conditions: NOTAUTH

INQUIRE TRACETYPE

┌ ┐───────────────────────55─ ──INQUIRE TRACETYPE ──┬ ┬─STANDARD─ ───

6┴┬ ┬─────────────────── ─5%

└ ┘─SPECIAL── └ ┘──COMPID(data-area)

Conditions: NOTAUTH, NOTFND

INQUIRE TRANCLASS

┌ ┐────────────────────────────55─ ──INQUIRE TRANCLASS(data-value) ───

6┴┬ ┬──────────────────────── ─5%

├ ┤──ACTIVE(data-area) ─────├ ┤──MAXACTIVE(data-area) ──├ ┤──PURGETHRESH(data-area)└ ┘──QUEUED(data-area) ─────

Conditions: INVREQ, NOTAUTH, TCIDERR

142 CICS User’s Handbook

Page 163: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE TRANDUMPCODE

┌ ┐────────────────────────55─ ──INQUIRE TRANDUMPCODE(data-value) ───

6┴┬ ┬──────────────────── ─5%

├ ┤──CURRENT(data-area)├ ┤──DUMPSCOPE(cvda) ───├ ┤──MAXIMUM(data-area)├ ┤──SHUTOPTION(cvda) ──├ ┤──SYSDUMPING(cvda) ──└ ┘──TRANDUMPING(cvda) ─

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TRANSACTION

┌ ┐──────────────────────────────55─ ──INQUIRE TRANSACTION(data-value) ───

6┴┬ ┬────────────────────────── ─5%

├ ┤──BREXIT(data-area) ───────├ ┤ ─ ─CMDSEC(cvda) ────────────├ ┤──DTIMEOUT(data-area) ─────├ ┤──DUMPING(cvda) ───────────├ ┤──FACILITYLIKE(data-area) ─├ ┤──INDOUBT(cvda) ───────────├ ┤──INDOUBTMINS(data-area) ──├ ┤──INDOUBTWAIT(cvda) ───────├ ┤──ISOLATEST(cvda) ─────────├ ┤──PRIORITY(data-area) ─────├ ┤──PROFILE(data-area) ──────├ ┤──PROGRAM(data-area) ──────├ ┤──PURGEABILITY(cvda) ──────├ ┤──REMOTENAME(data-area) ───├ ┤──REMOTESYSTEM(data-area) ─├ ┤ ─ ─RESSEC(cvda) ────────────├ ┤──ROUTING(cvda) ───────────

| ├ ┤──ROUTESTATUS(cvda) ───────├ ┤──RTIMEOUT(data-area) ─────├ ┤──RUNAWAY(data-area) ──────├ ┤──RUNAWAYTYPE(cvda) ───────├ ┤──SCRNSIZE(cvda) ──────────├ ┤──SHUTDOWN(cvda) ──────────├ ┤ ─ ─STATUS(cvda) ────────────├ ┤──STORAGECLEAR(cvda) ──────├ ┤──TASKDATAKEY(cvda) ───────├ ┤──TASKDATALOC(cvda) ───────├ ┤──┬ ┬──TCLASS(data-area) ───│ │└ ┘──TRANCLASS(data-area)├ ┤──TRACING(cvda) ───────────├ ┤──TRPROF(data-area) ───────└ ┘──TWASIZE(data-area) ──────

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, TRANSIDERR

Chapter 2. SPI command syntax 143

Page 164: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

| INQUIRE TSMODEL|

| ┌ ┐─────────────────────────────| 55─ ──INQUIRE ──TSMODEL(data-value) ───

6┴┬ ┬───────────────────────── ─5%

| ├ ┤──LOCATION(cvda) ─────────| ├ ┤──POOLNAME(data-area) ────| ├ ┤──PREFIX(data-area) ──────| ├ ┤──RECOVSTATUS(cvda) ──────| ├ ┤──REMOTEPREFIX(data-area)| ├ ┤──REMOTESYSTEM(data-area)| └ ┘──SECURITYST(cvda) ───────

| Conditions: END, ILLOGIC, NOTAUTH, NOTFND

| INQUIRE TSPOOL|

| 55─ ──INQUIRE ──TSPOOL(data-value) ──┬ ┬────────────────── ─5%| └ ┘──CONNSTATUS(cvda)

| Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TSQUEUE

55─ ──INQUIRE ──┬ ┬──TSQUEUE(data-value) ──┬ ┬────────────────────── ───────────5| └ ┘──TSQNAME(data-value) ├ ┤──POOLNAME(data-value)| └ ┘──SYSID(data-value) ───

┌ ┐────────────────────────────5─ ───

6┴┬ ┬──────────────────────── ─5%

├ ┤──FLENGTH(data-area) ────├ ┤──LASTUSEDINT(data-area)├ ┤──LOCATION(cvda) ────────├ ┤──MAXITEMLEN(data-area) ─├ ┤──MINITEMLEN(data-area) ─├ ┤──NUMITEMS(data-area) ───

| ├ ┤──RECOVSTATUS(cvda) ─────└ ┘──TRANSID(data-area) ────

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, POOLERR, QIDERR,SYSIDERR

144 CICS User’s Handbook

Page 165: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE UOW

┌ ┐─────────────────────────55─ ──INQUIRE UOW(data-area) ───

6┴┬ ┬───────────────────── ─5%

├ ┤──AGE(data-area) ─────├ ┤──LINK(data-area) ────├ ┤──NETNAME(data-area) ─├ ┤──NETUOWID(data-area)├ ┤──SYSID(data-area) ───├ ┤──TASKID(data-area) ──├ ┤──TERMID(data-area) ──├ ┤──TRANSID(data-area) ─├ ┤──UOWSTATE(cvda) ─────├ ┤──USERID(data-area) ──├ ┤──WAITCAUSE(cvda) ────└ ┘──WAITSTATE(cvda) ────

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE UOWDSNFAIL

55─ ──INQUIRE UOWDSNFAIL ──┬ ┬───────────── ──DSNAME(data-area) ────────────────5└ ┘──CAUSE(cvda)

5─ ──┬ ┬──────────────────── ──┬ ┬────────────── ──┬ ┬───────────────── ──────────5└ ┘──NETNAME(data-area) └ ┘──REASON(cvda) └ ┘──RLSACCESS(cvda)

5─ ──┬ ┬────────────────── ──UOW(data-area) ─5%└ ┘──SYSID(data-area)

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax 145

Page 166: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE UOWENQ

| ┌ ┐────────────────────────────────────────────55─ ──INQUIRE UOWENQ ───

6┴┬ ┬──────────────────────────────────────── ──────────5

| ├ ┤──ENQSCOPE(data-value) ──────────────────| ├ ┤──| RESOURCE(data-value)| RESLEN(data-value)| └ ┘──UOW(data-value) ───────────────────────

┌ ┐──────────────────────────5─ ───

6┴┬ ┬────────────────────── ─5%

| ├ ┤──DURATION(data-area) ─├ ┤──ENQFAILS(data-area) ─├ ┤──NETUOWID(data-area) ─├ ┤──QUALIFIER(data-area)├ ┤──QUALLEN(data-area) ──├ ┤──RELATION(cvda) ──────├ ┤──RESLEN(data-area) ───├ ┤──RESOURCE(data-area) ─├ ┤──STATE(cvda) ─────────├ ┤──TASKID(data-area) ───├ ┤──TRANSID(data-area) ──├ ┤ ─ ─TYPE(cvda) ──────────└ ┘──UOW(data-area) ──────

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE UOWLINK

55─ ──INQUIRE UOWLINK(data-area) ──┬ ┬───────────────── ───────────────────────5 └ ┘──LINK(data-area)

5─ ──┬ ┬───────────────────── ──┬ ┬──────────────── ──┬ ┬──────────────────── ────5 └ ┘──NETUOWID(data-area) ├ ┤──PROTOCOL(cvda) ├ ┤──RESYNCSTATUS(cvda) ├ ┤─APPC─────────── ├ ┤─COLD─────────────── ├ ┤─IRC──────────── ├ ┤─NOTAPPLIC────────── ├ ┤─LU61─────────── ├ ┤─OK───────────────── ├ ┤─NOTAPPLIC────── ├ ┤─STARTING───────────

| └ ┘─RRMS─────────── ├ ┤─UNAVAILABLE──────── └ ┘─UNCONNECTED────────

5─ ──┬ ┬─────────────────── ──┬ ┬───────────── ──┬ ┬────────────────── ───────────5 └ ┘──RMIQFY(data-area) ├ ┤──ROLE(cvda) ─ └ ┘──SYSID(data-area) ├ ┤─COORDINATOR─ ├ ┤─SUBORDINATE─ └ ┘─UNKNOWN─────

5─ ──┬ ┬──────────── ──┬ ┬──────────────── ──┬ ┬───────────────── ─5%| ├ ┤──TYPE(cvda) └ ┘──| UOW(data-area) └ ┘──| URID(data-area)| ├ ┤─CFTABLE────

├ ┤─CONNECTION─ └ ┘─RMI────────

Conditions: END, ILLOGIC, NOTAUTH, UOWLNOTFOUND,UOWNOTFOUND

146 CICS User’s Handbook

Page 167: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

INQUIRE VTAM

┌ ┐─────────────────────────────────────────────────55─ ──INQUIRE VTAM ───

6┴┬ ┬───────────────────────────────────────────── ─5%

├ ┤──GRNAME(data-area) ──────────────────────────├ ┤──GRSTATUS(cvda) ─────────────────────────────├ ┤──OPENSTATUS(cvda) ───────────────────────────└ ┘──┬ ┬──PSDINTERVAL(data-area) ─────────────────

└ ┘─┤ psinhrs ├──┤ psinmins ├──┤ psinsecs ├─

psinhrs:├─ ──PSDINTHRS(data-area) ─┤

psinmins:├─ ──PSDINTMINS(data-area) ─┤

psinsecs:├─ ──PSDINTSECS(data-area) ─┤

Conditions: INVREQ, NOTAUTH

INQUIRE WEB

┌ ┐───────────────────────────55─ ──INQUIRE WEB(data-area) ───

6┴┬ ┬─────────────────────── ─5%

├ ┤──GARBAGEINT(data-area)└ ┘──TIMEOUTINT(data-area)

Conditions: NOTAUTH

PERFORM DELETSHIPPED

55─ ──PERFORM DELETSHIPPED ─5%

Conditions: NOTAUTH

Chapter 2. SPI command syntax 147

Page 168: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

PERFORM DUMP

55─ ──PERFORM DUMP DUMPCODE(data-value) ─────────────────────────────────────5

5─ ──┬ ┬─────────────────────────────────────────── ──────────────────────────5 └ ┘──TITLE(data-area) ──TITLELENGTH(data-value)

5─ ──┬ ┬────────────────────────────────────────────── ───────────────────────5 └ ┘──CALLER(data-value) ──CALLERLENGTH(data-value)

5─ ──┬ ┬──────────────────── ─5%└ ┘──DUMPID(data-value)

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH,SUPPRESSED, SYSBUSY

PERFORM ENDAFFINITY

55─ ──PERFORM ENDAFFINITY ──NETNAME(data-value) ──┬ ┬─────────────────── ─5%└ ┘──NETID(data-value)

Conditions: INVREQ

PERFORM RESETTIME

55─ ──PERFORM RESETTIME ─5%

Conditions: INVREQ, NOTAUTH

PERFORM SECURITY REBUILD

55─ ──PERFORM SECURITY REBUILD ──┬ ┬──────────────────── ─5%└ ┘──ESMRESP(data-area)

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSBUSY

148 CICS User’s Handbook

Page 169: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

PERFORM SHUTDOWN

55─ ──PERFORM SHUTDOWN ── ──┬ ┬────── ──┬ ┬────────────────────────────── ─5% └ ┘─DUMP─ ├ ┤─IMMEDIATE──────────────────── │ │┌ ┐──────────────────────────── └ ┘───

6┴┬ ┬────────────────────────

├ ┤──PLT(data-value) ───────├ ┤──┬ ┬──SDTRAN(data-value)

│ │└ ┘─NOSDTRAN───────────├ ┤──XLT(data-value) ───────

└ ┘─TAKEOVER───────────────

Conditions: INVREQ, NOTAUTH, TRANSIDERR

PERFORM STATISTICS RECORD

┌ ┐───────────────────────55─ ──PERFORM STATISTICS RECORD ───

6┴┬ ┬─────────────────── ─5%

├ ┤ ─ALL─ ──┬ ┬────────── │ │└ ┘─RESETNOW─ ├ ┤─AUTOINSTALL─────── ├ ┤─CONNECTION──────── ├ ┤─DB2─────────────── ├ ┤─DISPATCHER──────── ├ ┤─ENQUEUE─────────── ├ ┤─FEPI────────────── ├ ┤─FILE────────────── ├ ┤──┬ ┬─JOURNALNAME─ ── │ │└ ┘─JOURNALNUM── ├ ┤─LSRPOOL─────────── ├ ┤─MONITOR─────────── ├ ┤─PROGAUTO────────── ├ ┤─PROGRAM─────────── ├ ┤─RECOVERY────────── ├ ┤─STATS───────────── ├ ┤─STORAGE─────────── ├ ┤─STREAMNAME──────── ├ ┤─SYSDUMP─────────── ├ ┤─TABLEMGR──────────

| ├ ┤─TCPIPSERVICE────── ├ ┤─TDQUEUE─────────── ├ ┤─TERMINAL────────── ├ ┤──┬ ┬─TRANCLASS─ ──── │ │└ ┘─TCLASS──── ├ ┤─TRANDUMP────────── ├ ┤─TRANSACTION─────── ├ ┤─TSQUEUE─────────── └ ┘─VTAM──────────────

Conditions: IOERR, NOTAUTH, NOTFND

Chapter 2. SPI command syntax 149

Page 170: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

RESYNC ENTRYNAME

55─ ──RESYNC ENTRYNAME(data-value) ──┬ ┬─────────────────────── ───────────────5└ ┘──QUALIFIER(data-value)

5─ ──┬ ┬────────────────────────────────────────────────── ──┬ ┬───────── ─5% └ ┘──IDLIST(data-value) ──┬ ┬────────────────────────── └ ┘──PARTIAL

└ ┘──IDLISTLENGTH(data-value)

Conditions: NOTAUTH

SET AUTOINSTALL

55─ ──SET AUTOINSTALL ──┬ ┬──────────────── ──┬ ┬───────────────────── ──────────5| └ ┘──CONSOLES(cvda) └ ┘──MAXREQS(data-value)

5─ ──┬ ┬───────────────────── ─5%└ ┘──PROGRAM(data-value)

Conditions: INVREQ, NOTAUTH, PGMIDERR

SET CONNECTION

55─ ──SET CONNECTION(data-value) ──┬ ┬────────────────── ──┬ ┬──────────────── ──5├ ┤──ACQSTATUS(cvda) ─ ├ ┤──AFFINITY(cvda)├ ┤──CONNSTATUS(cvda) └ ┘─ENDAFFINITY────

├ ┤─ACQUIRED───────── └ ┘─RELEASED─────────

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────── ───────5├ ┤──EXITTRACING(cvda) ├ ┤──PENDSTATUS(cvda) ├ ┤──PURGETYPE(cvda)

├ ┤─EXITTRACE───────── └ ┘─NOTPENDING─────── ├ ┤─CANCEL────────── └ ┘─NOEXITTRACE─────── ├ ┤─FORCECANCEL───── ├ ┤─FORCEPURGE────── └ ┘─PURGE───────────

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────── ───────5├ ┤──RECOVSTATUS(cvda) ├ ┤──SERVSTATUS(cvda) ├ ┤──UOWACTION(cvda)

└ ┘─NORECOVDATA─────── ├ ┤─INSERVICE──────── ├ ┤─BACKOUT───────── └ ┘─OUTSERVICE─────── ├ ┤─COMMIT────────── ├ ┤─FORCE─────────── └ ┘─RESYNC──────────

5─ ──┬ ┬────────────────── ─5%├ ┤──ZCPTRACING(cvda)

├ ┤─NOZCPTRACE─────── └ ┘─ZCPTRACE─────────

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSIDERR

150 CICS User’s Handbook

Page 171: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET DB2CONN

55─ ──SET DB2CONN ───────────────────────────────────────────────────────────5

┌ ┐───────────────────────────── ┌ ┐─────────────────────────────5─ ───

6┴┬ ┬───────────────────────── ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── ├ ┤──DB2ID(data-area) ───────│ │├ ┤─UOW────────────── ├ ┤──MSGQUEUE1(data-area) ───│ │├ ┤─TASK───────────── ├ ┤──MSGQUEUE2(data-area) ───│ │├ ┤─TXID───────────── ├ ┤──MSGQUEUE3(data-area) ───│ │└ ┘─NONE───────────── ├ ┤──┬ ┬──NONTERMREL(cvda) ───├ ┤──AUTHID(data-area) ────── │ │├ ┤─RELEASE──────────├ ┤──┬ ┬──AUTHTYPE(cvda) ───── │ │└ ┘─NORELEASE────────│ │├ ┤─GROUP────────── ├ ┤──PLAN(data-area) ────────│ │├ ┤─SIGN─────────── ├ ┤──PLANEXITNAME(data-area)│ │├ ┤─TERM─────────── ├ ┤──┬ ┬──PRIORITY(cvda) ─────

│ │├ ┤─TX───────────── │ │├ ┤─HIGH─────────── │ │├ ┤─OPID─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─USERID───────── │ │└ ┘─LOW────────────

├ ┤──┬ ┬──BUSY(cvda) ───────── ├ ┤──PURGECYCLEM(data-area) ─│ │├ ┤─WAIT─────── ├ ┤──PURGECYCLES(data-area) ─│ │├ ┤─NOWAIT───── ├ ┤──SECURITY(REBUILD) ──────│ │└ ┘─FORCE────── ├ ┤──SIGNID(data-area) ──────├ ┤──COMAUTHID(data-area) ─── ├ ┤──┬ ┬──STANDBYMODE(cvda) ──├ ┤──┬ ┬──COMAUTHTYPE(cvda) ── │ │├ ┤─NOCONNECT─────────

│ │├ ┤─CGROUP──────────── │ │├ ┤─CONNECT─────────── │ │├ ┤─CSIGN───────────── │ │└ ┘─RECONNECT─────────

│ │├ ┤─CTERM───────────── ├ ┤──STATSQUEUE(data-area) ──│ │├ ┤─CTX─────────────── ├ ┤──TCBLIMIT(data-area) ────│ │├ ┤─COPID───────────── ├ ┤──THREADLIMIT(data-area) ─│ │└ ┘─CUSERID─────────── └ ┘──┬ ┬──THREADWAIT(cvda) ───├ ┤──COMTHREADLIM(data-area) ├ ┤─TWAIT────────────├ ┤──┬ ┬──CONNECTERROR(cvda) ─ ├ ┤─NOTWAIT──────────

│ │├ ┤─ABEND────────────── └ ┘─N9ð6───────────── │ │└ ┘─SQLCODE────────────

└ ┘──┬ ┬──CONNECTST(cvda) ──── ├ ┤─CONNECTED─────── └ ┘─NOTCONNECTED────

Conditions: NORMAL, NOTAUTH, NOTFND, INVREQ

Chapter 2. SPI command syntax 151

Page 172: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

55─ ─SET DB2ENTRY─ ──┬ ┬───────────── ──────────────────────────────5└ ┘──(data-area)

┌ ┐─────────────────────────────5─ ───

6┴┬ ┬───────────────────────── ──────────────────────────────5%

├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── │ │├ ┤─UOW────────────── │ │├ ┤─TASK───────────── │ │├ ┤─TXID───────────── │ │└ ┘─NONE─────────────

├ ┤──AUTHID(data-area) ──────├ ┤──┬ ┬──AUTHTYPE(cvda) ─────

│ │├ ┤─GROUP────────── │ │├ ┤─SIGN─────────── │ │├ ┤─TERM─────────── │ │├ ┤─TX───────────── │ │├ ┤─OPID─────────── │ │└ ┘─USERID─────────

├ ┤──┬ ┬──BUSY(cvda) ───────── │ │├ ┤─WAIT─────── │ │├ ┤─NOWAIT───── │ │└ ┘─FORCE──────

├ ┤──┬ ┬──DISABLEDACT(cvda) ── │ │├ ┤─ABEND───────────── │ │├ ┤─SQLCODE─────────── │ │└ ┘─POOL──────────────

├ ┤──┬ ┬──ENABLESTATUS(cvda) ─ │ │├ ┤─ENABLED──────────── │ │└ ┘─DISABLED───────────

├ ┤──PLAN(data-area) ────────├ ┤──PLANEXITNAME(data-area)├ ┤──┬ ┬──PRIORITY(cvda) ─────

│ │├ ┤─HIGH─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─LOW────────────

├ ┤──PROTECTNUM(data-area) ──├ ┤──THREADLIMIT(data-area) ─└ ┘──┬ ┬──THREADWAIT(cvda) ───

├ ┤─TWAIT──────────── ├ ┤─NOWAIT─────────── └ ┘─TPOOL────────────

Conditions: NOTAUTH, NOTFND, INVREQ

152 CICS User’s Handbook

Page 173: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

┌ ┐─────────────────────────55─ ──SET DB2TRAN ───

6┴┬ ┬───────────────────── ────────────────────5%

├ ┤──DB2ENTRY(data-area)└ ┘──TRANSID(data-area) ─

Conditions: NOTAUTH, NOTFND, INVREQ

SET DELETSHIPPED

55─ ──SET DELETSHIPPED ──┬ ┬──────────────────────────── ──────────────────────5├ ┤──IDLE(data-value) ──────────

│ │┌ ┐────────────────────────── └ ┘───

6┴┬ ┬──────────────────────

├ ┤──IDLEHRS(data-value) ─├ ┤──IDLEMINS(data-value)└ ┘──IDLESECS(data-value)

5─ ──┬ ┬──────────────────────────────── ─5%├ ┤──INTERVAL(data-value) ──────────

│ │┌ ┐────────────────────────────── └ ┘───

6┴┬ ┬──────────────────────────

├ ┤──INTERVALHRS(data-value) ─├ ┤──INTERVALMINS(data-value)└ ┘──INTERVALSECS(data-value)

Conditions: INVREQ, NOTAUTH

SET DSNAME

55─ ──SET DSNAME(data-value) ──┬ ┬────────────── ──┬ ┬──────────────────── ──────5├ ┤──ACTION(cvda) ├ ┤──AVAILABILITY(cvda)

├ ┤─REMOVE─────── ├ ┤─AVAILABLE────────── ├ ┤─RECOVERED──── └ ┘─UNAVAILABLE──────── ├ ┤─RESETLOCKS─── └ ┘─RETRY────────

┌ ┐─WAIT───────5─ ──┬ ┬─────────────────── ──┼ ┼──────────── ──┬ ┬───────────────── ─5%

├ ┤──QUESCESTATE(cvda) ├ ┤──BUSY(cvda) ├ ┤──UOWACTION(cvda) ├ ┤─QUIESCED────────── └ ┘─NOWAIT───── ├ ┤─BACKOUT───────── ├ ┤─IMMQUIESCED─────── ├ ┤─COMMIT────────── └ ┘─UNQUIESCED──────── └ ┘─FORCE───────────

Conditions: DSNNOTFOUND, INVREQ, IOERR,NOTAUTH, SUPPRESSED

Chapter 2. SPI command syntax 153

Page 174: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET DUMPDS

55─ ──SET DUMPDS ──┬ ┬──────────────────────── ──┬ ┬────────────────── ──────────5└ ┘──INITIALDDS(data-value) ├ ┤──OPENSTATUS(cvda)

├ ┤─CLOSED─────────── ├ ┤─OPEN───────────── └ ┘─SWITCH───────────

5─ ──┬ ┬──────────────────── ─5%├ ┤──SWITCHSTATUS(cvda)

├ ┤─NOSWITCH─────────── └ ┘─SWITCHNEXT─────────

Conditions: INVREQ, IOERR, NOTAUTH

| SET ENQMODEL|

| 55─ ──SET ENQMODEL(data-value) ──┬ ┬──STATUS(cvda) ─5%| ├ ┤─DISABLED─────| └ ┘─ENABLED──────

| Conditions: INVREQ, NOTAUTH, NOTFND

SET FILE

55─ ──┬ ┬──SET FILE(data-value) ─── ─── ───ATTRIBUTES(data-value) ─5%└ ┘──SET DATASET(data-value)

Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

154 CICS User’s Handbook

Page 175: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET FILE

FILE attributes: ┌ ┐─WAIT───────├─ ──┬ ┬──────────── ──┬ ┬────────────── ──┼ ┼──────────── ───────────────────────5

├ ┤──ADD(cvda) ─ ├ ┤──BROWSE(cvda) ├ ┤──BUSY(cvda) ├ ┤─ADDABLE──── ├ ┤─BROWSABLE──── ├ ┤─FORCE────── └ ┘─NOTADDABLE─ └ ┘─NOTBROWSABLE─ └ ┘─NOWAIT─────

5─ ──┬ ┬────────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────── ──────5| └ ┘──CFDTPOOL(data-value) ├ ┤──DELETE(cvda) ├ ┤──DISPOSITION(cvda)

├ ┤─DELETABLE──── ├ ┤─OLD─────────────── └ ┘─NOTDELETABLE─ └ ┘─SHARE─────────────

5─ ──┬ ┬──────────────────────── ──┬ ┬─────────────────── ──────────────────────5├ ┤──DSNAME(data-value) ──── ├ ┤──EMPTYSTATUS(cvda)└ ┘──OBJECTNAME(data-value) ├ ┤─EMPTY─────────────

├ ┤─EMPTYREQ────────── └ ┘─NOEMPTYREQ────────

┌ ┐────────────────────────────────5─ ───

6┴┬ ┬──────────────────────────── ──┬ ┬───────────────── ──────────────────5

└ ┘──┬ ┬──┬ ┬──ENABLESTATUS(cvda) ├ ┤──EXCLUSIVE(cvda) │ │├ ┤─DISABLED─────────── ├ ┤─EXCTL─────────── │ │└ ┘─ENABLED──────────── └ ┘─NOEXCTL─────────

└ ┘──┬ ┬──OPENSTATUS(cvda) ── ├ ┤─CLOSED─────────── └ ┘─OPEN─────────────

5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────── ──────────────────────────5| └ ┘──KEYLENGTH(data-value) ├ ┤──LOADTYPE(cvda)| ├ ┤─LOAD───────────| └ ┘─NOLOAD─────────

5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────────── ──────────────────5└ ┘──LSRPOOLID(data-value) └ ┘──MAXNUMRECS(data-value)

5─ ──┬ ┬───────────── ──┬ ┬──────────────────────── ──┬ ┬───────────────── ───────5| ├ ┤──READ(cvda) ─ └ ┘──RECORDSIZE(data-value) ├ ┤──READINTEG(cvda)

├ ┤─NOTREADABLE─ ├ ┤─UNCOMMITTED───── └ ┘─READABLE──── ├ ┤─CONSISTENT────── └ ┘─REPEATABLE──────

5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ──┬ ┬───────────── ──────────5├ ┤──RLSACCESS(cvda) └ ┘──STRINGS(data-value) ├ ┤──TABLE(cvda)

| ├ ┤─RLS───────────── ├ ┤─CFTABLE───── ├ ┤─NOTAPPLIC─────── ├ ┤─CICSTABLE─── └ ┘─NOTRLS────────── ├ ┤─NOTTABLE──── └ ┘─USERTABLE───

5─ ──┬ ┬─────────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────── ─┤| └ ┘──TABLENAME(data-value) ├ ┤──UPDATE(cvda) ├ ┤──UPDATEMODEL(cvda)| ├ ┤─NOTUPDATABLE─ ├ ┤─CONTENTION────────| └ ┘─UPDATABLE──── └ ┘─LOCKING───────────

Chapter 2. SPI command syntax 155

Page 176: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET IRC

55─ ──SET IRC ──┬ ┬────────────────── ─5%├ ┤──OPENSTATUS(cvda)

├ ┤─CLOSED─────────── ├ ┤─IMMCLOSE───────── └ ┘─OPEN─────────────

Conditions: INVREQ, IOERR, NOSTG, NOTAUTH

SET JOURNALNAME

55─ ──SET JOURNALNAME(data-value) ──┬ ┬──ACTION(cvda) ──┬ ┬──STATUS(cvda) ─5% ├ ┤─FLUSH──────── ├ ┤─DISABLED───── └ ┘─RESET──────── └ ┘─ENABLED──────

Conditions: INVREQ, IOERR, JIDERR, NOTAUTH

SET MODENAME

55─ ──SET MODENAME(data-value) ──CONNECTION(data-value) ──────────────────────5

5─ ──┬ ┬──────────────────────────────────────────── ─5% ├ ┤──AVAILABLE(data-value) ──┬ ┬─────────────────

│ │├ ┤──ACQSTATUS(cvda) │ │└ ┘─ACQUIRED────────

└ ┘──┬ ┬──ACQSTATUS(cvda) ─────────────────────── └ ┘─CLOSED──────────

Conditions: INVREQ, NOTAUTH, SYSIDERR

156 CICS User’s Handbook

Page 177: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET MONITOR

55─ ──SET MONITOR ──┬ ┬────────────────── ──┬ ┬────────────────── ───────────────5├ ┤──CONVERSEST(cvda) ├ ┤──EVENTCLASS(cvda)

├ ┤─CONVERSE───────── ├ ┤─EVENT──────────── └ ┘─NOCONVERSE─────── └ ┘─NOEVENT──────────

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────────────────────── ────────────5├ ┤──EXCEPTCLASS(cvda) ├ ┤──FREQUENCY(data-value) ───────────

├ ┤─EXCEPT──────────── │ │┌ ┐──────────────────────────────── └ ┘─NOEXCEPT────────── └ ┘───

6┴──┬ ┬──────────────────────────

├ ┤──FREQUENCYHRS(data-value)| ├ ┤──FREQUENCYMIN| (data-value)| └ ┘──FREQUENCYSEC(data-value)

5─ ──┬ ┬───────────────── ──┬ ┬────────────── ──┬ ┬─────────────────── ─5%├ ┤──PERFCLASS(cvda) ├ ┤──STATUS(cvda) ├ ┤──SYNCPOINTST(cvda)

├ ┤─PERF──────────── ├ ┤─ON─────────── ├ ┤─SYNCPOINT───────── └ ┘─NOPERF────────── └ ┘─OFF────────── └ ┘─NOSYNCPOINT───────

Conditions: INVREQ, NOTAUTH

SET NETNAME

55─ ──SET NETNAME(data-value) ──┬ ┬─────────────────── ─5%├ ┤──EXITTRACING(cvda)

├ ┤─EXITTRACE───────── └ ┘─NOEXITTRACE───────

Conditions: INVREQ, NOTAUTH

SET PROCESSTYPE

55──SET─ ──PROCESSTYPE(data-value) ──┬ ┬────────────── ──┬ ┬────────────────── ─5%├ ┤──STATUS(cvda) ├ ┤──AUDITLEVEL(cvda)

├ ┤─DISABLED───── ├ ┤─ACTIVITY───────── └ ┘─ENABLED────── ├ ┤─FULL───────────── ├ ┤─OFF────────────── └ ┘─PROCESS──────────

Conditions: INVREQ, NOTAUTH, PROCESSERR

Chapter 2. SPI command syntax 157

Page 178: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET PROGRAM

55─ ──SET PROGRAM(data-value) ──┬ ┬────────────────── ──┬ ┬──────────── ─────────5├ ┤──CEDFSTATUS(cvda) ├ ┤──COPY(cvda)

├ ┤─CEDF───────────── ├ ┤─NEWCOPY──── └ ┘─NOCEDF─────────── └ ┘─PHASEIN────

5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ──────────────────────────5├ ┤──EXECUTIONSET(cvda) ├ ┤──SHARESTATUS(cvda)

├ ┤─DPLSUBSET────────── ├ ┤─PRIVATE─────────── └ ┘─FULLAPI──────────── └ ┘─SHARED────────────

5─ ──┬ ┬─────────────────────────────────── ──┬ ┬──────────────── ──────────────5| └ ┘──JVMCLASS(255-character data-area) ├ ┤──JVMDEBUG(cvda)| ├ ┤─DEBUG──────────| └ ┘─NODEBUG────────

5─ ──┬ ┬─────────────── ──┬ ┬────────────── ──┬ ┬─────────────── ─5%| ├ ┤──RUNTIME(cvda) ├ ┤──STATUS(cvda) └ ┘──VERSION(cvda)| ├ ┤─JVM─────────── ├ ┤─DISABLED─────| └ ┘─NOJVM───────── └ ┘─ENABLED──────

Conditions: INVREQ, IOERROR, NOTAUTH, PGMIDERR

SET STATISTICS

55─ ──SET STATISTICS ──┬ ┬──────────────────────────────── ────────────────────5├ ┤──ENDOFDAY(data-value) ──────────

│ │┌ ┐────────────────────────────── └ ┘───

6┴┬ ┬──────────────────────────

├ ┤──ENDOFDAYHRS(data-value) ─├ ┤──ENDOFDAYMINS(data-value)└ ┘──ENDOFDAYSECS(data-value)

5─ ──┬ ┬──────────────────────────────── ─────────────────────────────────────5├ ┤──INTERVAL(data-value) ──────────

│ │┌ ┐────────────────────────────── └ ┘───

6┴┬ ┬──────────────────────────

├ ┤──INTERVALHRS(data-value) ─├ ┤──INTERVALMINS(data-value)└ ┘──INTERVALSECS(data-value)

5─ ──┬ ┬────────────────────────────────────────────────── ─5% └ ┘──┬ ┬──RECORDING(cvda) ──┬ ┬─────────── ──┬ ┬────────── ├ ┤─ON────────────── └ ┘─RECORDNOW─ └ ┘─RESETNOW─ └ ┘─OFF─────────────

Conditions: INVREQ, NOTAUTH

158 CICS User’s Handbook

Page 179: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET SYSDUMPCODE

55─ ──SET SYSDUMPCODE(data-value) ──┬ ┬────────────── ──┬ ┬───────────────── ────5├ ┤──ACTION(cvda) ├ ┤──DAEOPTION(cvda)

├ ┤─ADD────────── ├ ┤─DAE───────────── ├ ┤─REMOVE─────── └ ┘─NODAE─────────── └ ┘─RESET────────

5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ──┬ ┬────────────────── ─────5├ ┤──DUMPSCOPE(cvda) └ ┘──MAXIMUM(data-value) ├ ┤──SHUTOPTION(cvda)

├ ┤─LOCAL─────────── ├ ┤─NOSHUTDOWN─────── └ ┘─RELATED───────── └ ┘─SHUTDOWN─────────

5─ ──┬ ┬────────────────── ─5%├ ┤──SYSDUMPING(cvda)

├ ┤─NOSYSDUMP──────── └ ┘─SYSDUMP──────────

Conditions: DUPREC, INVREQ, IOERR, NOSPACE, NOTAUTH,NOTFND

SET SYSTEM

┌ ┐──────────────────────────────────────────────────────55─ ──SET SYSTEM ───

6┴┬ ┬────────────────────────────────────────────────── ─5%

├ ┤──AKP(data-value) ─────────────────────────────────├ ┤──DSALIMIT(data-value) ────────────────────────────

| ├ ┤──DSRTPROGRAM(data-value) ─────────────────────────├ ┤──DTRPROGRAM(data-value) ──────────────────────────├ ┤──┬ ┬──DUMPING(cvda) ───────────────────────────────

│ │├ ┤─NOSYSDUMP───── │ │└ ┘─SYSDUMP───────

├ ┤──EDSALIMIT(data-value) ───────────────────────────| ├ ┤──FORCEQR(cvda) ───────────────────────────────────

├ ┤──GMMTEXT(data-value) ──┬ ┬─────────────────────── ──│ │└ ┘──GMMLENGTH(data-value)

| ├ ┤──LOGDEFER(data-area) ─────────────────────────────| ├ ┤──MAXOPENTCBS(data-value) ─────────────────────────

├ ┤──MAXTASKS(data-value) ──┬ ┬────────────────────────│ │└ ┘──NEWMAXTASKS(data-area)├ ┤──MROBATCH(data-value) ────────────────────────────├ ┤──┬ ┬──PROGAUTOCTLG(cvda) ──────────────────────────

│ │├ ┤─CTLGALL──────────── │ │├ ┤─CTLGMODIFY───────── │ │└ ┘─CTLGNONE───────────

├ ┤ ─ ─PROGAUTOEXIT(data-value) ────────────────────────├ ┤──┬ ┬──PROGAUTOINST(cvda) ──────────────────────────

│ │├ ┤─AUTOACTIVE───────── │ │└ ┘─AUTOINACTIVE───────

├ ┤──PRTYAGING(data-value) ───────────────────────────├ ┤──RUNAWAY(data-value) ─────────────────────────────├ ┤──SCANDELAY(data-value) ───────────────────────────└ ┘──TIME(data-value) ────────────────────────────────

Conditions: INVREQ, LENGERR, NOSTG, NOTAUTH

Chapter 2. SPI command syntax 159

Page 180: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET TASK

55─ ──SET TASK(data-value) ──┬ ┬────────────────────── ──┬ ┬───────────────── ─5%└ ┘──PRIORITY(data-value) ├ ┤──PURGETYPE(cvda)

├ ┤─FORCEPURGE────── └ ┘─PURGE───────────

Conditions: INVREQ, NOTAUTH, TASKIDERR

SET TCLASS

55─ ──SET TCLASS(data-value) ──┬ ┬───────────────────── ─5%└ ┘──MAXIMUM(data-value)

Conditions: INVREQ, NOTAUTH, TCIDERR

SET TCPIP

55─ ──SET TCPIP ──┬ ┬──STATUS(data-value) ─5% ├ ┤─CLOSE────────────── ├ ┤─IMMCLOSE─────────── └ ┘─OPEN───────────────

Conditions: INVREQ, IOERR, NOTAUTH

SET TCPIPSERVICE

55─ ──SET TCPIPSERVICE(data-value) ──┬ ┬────────────── ──┬ ┬───────────────── ─5%├ ┤──STATUS(cvda) └ ┘──URM(data-value)

├ ┤─CLOSE──────── ├ ┤─IMMCLOSE───── └ ┘─OPEN─────────

Conditions: INVREQ, NOTAUTH, NOTFND

160 CICS User’s Handbook

Page 181: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET TDQUEUE

55─ ──SET TDQUEUE(data-value) ──┬ ┬─────────────────── ────────────────────────5├ ┤──ATIFACILITY(cvda)

├ ┤─NOTERMINAL──────── └ ┘─TERMINAL──────────

5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──ATITERMID(data-value) └ ┘──ATITRANID(data-value)

5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────── ──────────────────────5└ ┘──ATIUSERID(data-value) ├ ┤──ENABLESTATUS(cvda)

├ ┤─DISABLED─────────── └ ┘─ENABLED────────────

5─ ──┬ ┬────────────────── ──┬ ┬────────────────────────── ─5%├ ┤──OPENSTATUS(cvda) └ ┘──TRIGGERLEVEL(data-value)

├ ┤─CLOSED─────────── └ ┘─OPEN─────────────

Conditions: INVREQ, IOERR, NOTAUTH, QIDERR, USERIDERR

Chapter 2. SPI command syntax 161

Page 182: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET TERMINAL

55─ ──SET TERMINAL(data-value) ──┬ ┬────────────────── ────────────────────────5├ ┤──ACQSTATUS(cvda) ─├ ┤──TERMSTATUS(cvda)

├ ┤─ACQUIRED───────── ├ ┤─COLDACQ────────── └ ┘─RELEASED─────────

5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─────────────────────5└ ┘──ALTPRINTER(data-value) ├ ┤──ALTPRTCOPYST(cvda)

├ ┤─ALTPRTCOPY───────── └ ┘─NOALTPRTCOPY───────

5─ ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬───────────────── ─────────5├ ┤──ATISTATUS(cvda) ├ ┤──CREATESESS(cvda) ├ ┤──DISCREQST(cvda)

├ ┤─ATI───────────── ├ ┤─CREATE─────────── ├ ┤─DISCREQ───────── └ ┘─NOATI─────────── └ ┘─NOCREATE───────── └ ┘─NODISCREQ───────

5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ─────────────────────────5├ ┤──EXITTRACING(cvda) └ ┘──MAPNAME(data-value)

├ ┤─EXITTRACE───────── └ ┘─NOEXITTRACE───────

5─ ──┬ ┬──────────────────────── ──┬ ┬───────────────────────── ────────────────5└ ┘──MAPSETNAME(data-value) └ ┘──NEXTTRANSID(data-value)

5─ ──┬ ┬────────────────── ──┬ ┬──────────────────── ──┬ ┬────────────────── ─────5├ ┤──OBFORMATST(cvda) └ ┘──OPERID(data-value) ├ ┤──PAGESTATUS(cvda)

├ ┤─OBFORMAT───────── ├ ┤─AUTOPAGEABLE───── └ ┘─NOOBFORMAT─────── └ ┘─PAGEABLE─────────

5─ ──┬ ┬───────────────────── ──┬ ┬───────────────── ──┬ ┬────────────────── ─────5└ ┘──PRINTER(data-value) ├ ┤──PRTCOPYST(cvda) ├ ┤──PURGETYPE(cvda) ─

├ ┤─PRTCOPY───────── ├ ┤─FORCEPURGE─────── └ ┘─NOPRTCOPY─────── ├ ┤ ─PURGE─ ──┬ ┬─────── │ │└ ┘─FORCE─ └ ┘─CANCEL───────────

5─ ──┬ ┬──────────────── ──┬ ┬────────────────── ───────────────────────────────5├ ┤──RELREQST(cvda) ├ ┤──SERVSTATUS(cvda)

├ ┤─RELREQ───────── ├ ┤─INSERVICE──────── └ ┘─NORELREQ─────── └ ┘─OUTSERVICE───────

5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────────────── ──────────────5└ ┘──TCAMCONTROL(data-value) └ ┘──TERMPRIORITY(data-value)

5─ ──┬ ┬─────────────── ──┬ ┬───────────────── ──┬ ┬──────────────── ─────────────5├ ┤──TRACING(cvda) ├ ┤──TTISTATUS(cvda) ├ ┤──UCTRANST(cvda)

├ ┤─SPECTRACE───── ├ ┤─NOTTI─────────── ├ ┤─UCTRAN───────── └ ┘─STANTRACE───── └ ┘─TTI───────────── ├ ┤─NOUCTRAN─────── └ ┘─TRANIDONLY─────

5─ ──┬ ┬────────────────── ─5%├ ┤──ZCPTRACING(cvda)

├ ┤─NOZCPTRACE─────── └ ┘─ZCPTRACE─────────

Conditions: INVREQ, NORMAL, NOTAUTH, TERMIDERR

162 CICS User’s Handbook

Page 183: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET TRACEDEST

55─ ──SET TRACEDEST ──┬ ┬───────────────── ──┬ ┬───────────────── ───────────────5├ ┤──AUXSTATUS(cvda) ├ ┤──GTFSTATUS(cvda)

├ ┤─AUXPAUSE──────── ├ ┤─GTFSTART──────── ├ ┤─AUXSTART──────── └ ┘─GTFSTOP───────── └ ┘─AUXSTOP─────────

5─ ──┬ ┬───────────────── ──┬ ┬──────────────────── ──┬ ┬──────────────────── ────5├ ┤──INTSTATUS(cvda) ├ ┤──SWITCHACTION(cvda) ├ ┤──SWITCHSTATUS(cvda)

├ ┤─INTSTART──────── └ ┘─SWITCH───────────── ├ ┤─NOSWITCH─────────── └ ┘─INTSTOP───────── ├ ┤─SWITCHALL────────── └ ┘─SWITCHNEXT─────────

5─ ──┬ ┬─────────────────────── ─5%└ ┘──TABLESIZE(data-value)

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH

SET TRACEFLAG

55─ ──SET TRACEFLAG ──┬ ┬──────────────────── ──┬ ┬──────────────────── ─────────5├ ┤──SINGLESTATUS(cvda) ├ ┤──SYSTEMSTATUS(cvda)

├ ┤─SINGLEOFF────────── ├ ┤─SYSTEMOFF────────── └ ┘─SINGLEON─────────── └ ┘─SYSTEMON───────────

5─ ──┬ ┬──────────────────── ──┬ ┬────────────────── ─5%├ ┤──TCEXITSTATUS(cvda) ├ ┤──USERSTATUS(cvda)

├ ┤─TCEXITALL────────── ├ ┤─USEROFF────────── ├ ┤─TCEXITALLOFF─────── └ ┘─USERON─────────── ├ ┤─TCEXITNONE───────── └ ┘─TCEXITSYSTEM───────

Conditions: INVREQ, NOTAUTH

SET TRACETYPE

┌ ┐────────────────────────55─ ──SET TRACETYPE ──┬ ┬─STANDARD─ ───

6┴┬ ┬──────────────────── ─5%

└ ┘─SPECIAL── └ ┘──COMPID(data-value)

Conditions: NOTAUTH, NOTFND

Chapter 2. SPI command syntax 163

Page 184: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET TRANCLASS

55─ ──SET TRANCLASS(data-value) ──┬ ┬─────────────────────── ──────────────────5└ ┘──MAXACTIVE(data-value)

5─ ──┬ ┬───────────────────────── ─5%└ ┘──PURGETHRESH(data-value)

Conditions: INVREQ, NOTAUTH, TCIDERR

SET TRANDUMPCODE

55─ ──SET TRANDUMPCODE(data-value) ──┬ ┬────────────── ──┬ ┬───────────────── ───5├ ┤──ACTION(cvda) ├ ┤──DUMPSCOPE(cvda)

├ ┤─ADD────────── ├ ┤─LOCAL─────────── ├ ┤─REMOVE─────── └ ┘─RELATED───────── └ ┘─RESET────────

5─ ──┬ ┬───────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ────5└ ┘──MAXIMUM(data-value) ├ ┤──SHUTOPTION(cvda) ├ ┤──SYSDUMPING(cvda)

├ ┤─NOSHUTDOWN─────── ├ ┤─NOSYSDUMP──────── └ ┘─SHUTDOWN───────── └ ┘─SYSDUMP──────────

5─ ──┬ ┬─────────────────── ─5%├ ┤──TRANDUMPING(cvda)

├ ┤─NOTRANDUMP──────── └ ┘─TRANDUMP──────────

Conditions: DUPREC, INVREQ, IOERR, NOSPACE,NOTAUTH, NOTFND

164 CICS User’s Handbook

Page 185: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET TRANSACTION

55─ ──SET TRANSACTION(data-value) ──┬ ┬─────────────── ────────────────────────5├ ┤──DUMPING(cvda)

├ ┤─TRANDUMP────── └ ┘─NOTRANDUMP────

5─ ──┬ ┬────────────────────── ──┬ ┬──────────────────── ───────────────────────5└ ┘──PRIORITY(data-value) ├ ┤──PURGEABILITY(cvda)

├ ┤─NOTPURGEABLE─────── └ ┘─PURGEABLE──────────

5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ─────5└ ┘──RUNAWAY(data-value) ├ ┤──RUNAWAYTYPE(cvda) ├ ┤──SHUTDOWN(cvda)

├ ┤─SYSTEM──────────── ├ ┤─SHUTDISABLED─── └ ┘─USER────────────── └ ┘─SHUTENABLED────

5─ ──┬ ┬────────────── ──┬ ┬─────────────────────── ──┬ ┬─────────────── ─5%├ ┤──STATUS(cvda) ├ ┤──TCLASS(data-value) ─── ├ ┤──TRACING(cvda)├ ┤─DISABLED───── └ ┘──TRANCLASS(data-value) ├ ┤─SPECTRACE─────

└ ┘─ENABLED────── ├ ┤─SPRSTRACE───── └ ┘─STANTRACE─────

Conditions: INVREQ, NOTAUTH, TRANSIDERR

| SET TSQUEUE|

| 55─ ──SET ──┬ ┬──TSQUEUE(data-value) ──┬ ┬────────────────────── ───────────────5| └ ┘──TSQNAME(data-value) ├ ┤──SYSID(data-value) ───| └ ┘──POOLNAME(data-value)

| 5─ ──┬ ┬─────────────────────────────────────────── ─5%| ├ ┤──ACTION(cvda) ──┬ ┬─────────────────────────| │ │└ ┘──LASTUSEDINT(data-value)| └ ┘─DELETE────────────────────────────────────

| Conditions: INVREQ, NOTAUTH, NOTFND, POOLERR, QIDERR,| SYSIDERR

SET UOW

55─ ──SET UOW(data-value) ──┬ ┬──UOWSTATE(cvda) ─5% ├ ┤─COMMIT───────── ├ ┤─BACKOUT──────── └ ┘─FORCE──────────

Conditions: INVREQ, NOTAUTH, UOWNOTFOUND

Chapter 2. SPI command syntax 165

Page 186: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

SPI syntax

SET UOWLINK

55─ ──SET UOWLINK(data-value) ──┬ ┬────────────── ─5%├ ┤──ACTION(cvda)

└ ┘─DELETE───────

Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND

SET VTAM

55─ ──SET VTAM ──┬ ┬────────────────── ──┬ ┬────────────────────────────── ──────5├ ┤──OPENSTATUS(cvda) ├ ┤──PSDINTERVAL(data-value) ─────

├ ┤─CLOSED─────────── │ │┌ ┐──────────────────────────── ├ ┤─FORCECLOSE─────── └ ┘───

6┴┬ ┬────────────────────────

├ ┤─IMMCLOSE───────── ├ ┤──PSDINTHRS(data-value) ─└ ┘─OPEN───────────── ├ ┤──PSDINTMINS(data-value)

└ ┘──PSDINTSECS(data-value)

5─ ──┬ ┬────────────── ─5% └ ┘──DEREGISTERED

Conditions: INVREQ, IOERR, NOTAUTH

SET WEB

55─ ──SET WEB ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─5%└ ┘──GARBAGEINT(data-value) └ ┘──TIMEOUTINT(data-value)

Conditions: INVREQ, IOERR, NOTAUTH

166 CICS User’s Handbook

Page 187: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

Chapter 3. CICS-Supplied Transaction

Some CICS-supplied transactions are menu driven, while others can beentered on the command line. Menus are provided wherever the transactionname appears on its own in the syntax descriptions on the pages that follow.

CEBT INQUIRE AUXTRACE

55─ ──CEBT Inquire Auxtrace ─5%

CEBT INQUIRE DUMP

55─ ──CEBT Inquire Dump ─5%

CEBT INQUIRE INTTRACE

55─ ──CEBT Inquire Inttrace ─5%

CEBT INQUIRE GTFTRACE

55─ ──CEBT Inquire Gtftrace ─5%

CEBT INQUIRE SURVEILLANCE

55─ ──CEBT Inquire Surveillance ─5%

CEBT PERFORM SHUTDOWN

55─ ──CEBT Perform SHutdown ──Dump ──Immediate ─5%

CEBT PERFORM SNAP

55─ ──CEBT Perform SNap ─5%

CEBT PERFORM TAKEOVER

55─ ──CEBT Perform Takeover ──Dump ─5%

CEBT SET AUXTRACE

55─ ──CEBT Set Auxtrace ──┬ ┬─────── ──┬ ┬────────── ──SWitch ─5% ├ ┤─STArt─ ├ ┤─NOswitch─ ├ ┤─Pause─ ├ ┤─NExt───── └ ┘─STOp── └ ┘─All──────

Copyright IBM Corp. 1989, 1999 167

Page 188: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEBT SET DUMP

55─ ──CEBT Set Dump ──┬ ┬──────── ──┬ ┬────────────── ─5% ├ ┤─Open─── ├ ┤─Autoswitch─── ├ ┤─CLosed─ └ ┘─Noautoswitch─ └ ┘─Switch─

CEBT SET GTFTRACE

55─ ──CEBT Set Gtftrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──

CEBT SET INTTRACE

55─ ──CEbt Set Inttrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──

CEBT SET SURVEILLANCE

55─ ──CEBT Set Surveillance ──┬ ┬───── ─5% ├ ┤─OFf─ └ ┘─ON──

CEBT SET TAKEOVER

55─ ──CEBT Set Takeover ──┬ ┬─────────── ─5% ├ ┤─Automatic─ ├ ┤─Command─── └ ┘─Manual────

168 CICS User’s Handbook

Page 189: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

55─ ──CEDA ──┬ ┬─ADD──GROUP──LIST─ ──┬ ┬──────── ───────────────────────────────────────── ───5% │ │├ ┤─AFTER── │ │└ ┘─BEFORE─ ├ ┤─ALTER──┤ Resource type ├────────────────────────────────────────────── ├ ┤─APPEND──LIST──TO────────────────────────────────────────────────────── ├ ┤ ─CHECK─ ──┬ ┬─GROUP─ ──┬ ┬────────────── ─────────────────────────────────── │ │└ ┘─LIST── └ ┘─REMOTESYSTEM─ │ │┌ ┐─ALL─────────────── ├ ┤ ─COPY─ ──┼ ┼─────────────────── ─GROUP─ ──┬ ┬─AS─── ──┬ ┬───────── ────────────

│ │└ ┘─┤ Resource type ├─ ├ ┤─TO─── ├ ┤─REPLACE─│ │└ ┘──ASTO └ ┘─MERGE───

├ ┤─DEFINE──┤ Resource type ├──GROUP──┤ attribute list ├────(1) ────────────── ├ ┤ ─DELETE─ ──┬ ┬─ALL─────────────── ──┬ ┬─GROUP─ ──┬ ┬──────── ─────────────────

│ │└ ┘─┤ Resource type ├─ └ ┘─LIST── └ ┘─REMOVE─ ├ ┤ ─DISPLAY─ ──┬ ┬─LIST─ ──┬ ┬─────── ───────────────────────── ──────────────── │ ││ │└ ┘──GROUP │ │└ ┘ ─GROUP─ ──┬ ┬─────────────────── ──┬ ┬──────── │ │├ ┤─ALL─────────────── └ ┘─RENAME─

│ │└ ┘─┤ Resource type ├─ ├ ┤ ─EXPAND─ ──┬ ┬─LIST─ ──┬ ┬─────── ───────────────────────── ───────────────── │ ││ │└ ┘──GROUP │ │└ ┘ ─GROUP─ ──┬ ┬─────────────────── ──┬ ┬──────── │ │├ ┤─ALL─────────────── └ ┘─RENAME─

│ │└ ┘─┤ Resource type ├─ ├ ┤ ─INSTALL─ ──┬ ┬─────────────────── ──┬ ┬─GROUP─ ──────────────────────────── │ │├ ┤─ALL─────────────── └ ┘─LIST──

│ │└ ┘─┤ Resource type ├─ ├ ┤ ─LOCK─ ──┬ ┬─GROUP─ ────────────────────────────────────────────────────── │ │└ ┘─LIST── │ │┌ ┐─ALL─────────────── ├ ┤ ─MOVE─ ──┼ ┼─────────────────── ─GROUP─ ──┬ ┬─AS─── ──┬ ┬───────── ──┬ ┬────────

│ │└ ┘─┤ Resource type ├─ ├ ┤─TO─── ├ ┤─REPLACE─ └ ┘─REMOVE─│ │└ ┘──ASTO └ ┘─MERGE───

├ ┤─REMOVE──GROUP──LIST─────────────────────────────────────────────────── ├ ┤ ─RENAME─ ──┬ ┬─────────────────── ──┬ ┬─────── ──┬ ┬──── ──┬ ┬──── ──┬ ┬──────── ─ │ │├ ┤─ALL─────────────── └ ┘─GROUP─ └ ┘─AS─ └ ┘─TO─ └ ┘─REMOVE─

│ │└ ┘─┤ Resource type ├─ ├ ┤ ─UNLOCK─ ──┬ ┬─GROUP─ ──────────────────────────────────────────────────── │ │└ ┘─LIST── ├ ┤─USERDEFINE──┤ Resource type ├──GROUP──┤ attribute list ├────(1) ────────── └ ┘ ─VIEW──GROUP─ ──┬ ┬─────────────────── ─────────────────────────────────── ├ ┤─ALL───────────────

└ ┘─┤ Resource type ├─

Note:1 Consult the CICS Resource Definition Guide. for information about the

attributes applicable to each resource type.

Chapter 3. CICS-Supplied Transaction 169

Page 190: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

Resource type:├─ ──┬ ┬─CONNECTION───── ──────────────────────────────────────────────────────────────────┤ ├ ┤─DB2CONN──────── ├ ┤─DB2ENTRY─────── ├ ┤─DB2TRAN────────

| ├ ┤─DOCTEMPLATE──── ├ ┤── ──┬ ┬──────────

| │ │└ ┘─ENQMODEL─ ├ ┤─FILE─────────── ├ ┤─JOURNALMODEL─── ├ ┤─LSRPOOL──────── ├ ┤─MAPSET───────── ├ ┤─PARTITIONSET─── ├ ┤─PARTNER────────

| ├ ┤─PROCESSTYPE──── ├ ┤─PROFILE──────── ├ ┤─PROGRAM────────

| ├ ┤─REQUESTMODEL─── ├ ┤─SESSIONS───────

| ├ ┤─TCPIPSERVICE─── ├ ┤─TDQUEUE──────── ├ ┤─TERMINAL─────── ├ ┤─TRANCLASS────── ├ ┤─TRANSACTION────

| ├ ┤─TSMODEL──────── └ ┘─TYPETERM───────

CEDF

┌ ┐─,ON──55─ ──CEDF ──┬ ┬─────────── ──┼ ┼────── ─5% ├ ┤─termid──── └ ┘─,OFF─ ├ ┤─sysid───── └ ┘─sessionid─

CEDX

┌ ┐─,ON──55─ ──CEDX ──tranid ──┼ ┼────── ─5% └ ┘─,OFF─

170 CICS User’s Handbook

Page 191: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT DISCARD

┌ ┐─────────────────────────55─ ──CEMT Discard ───

6┴┬ ┬───────────────────── ─5%

├ ┤──Autinstmodel(value)├ ┤──Connection(value) ──

├ ┤──DB2Conn ────────────├ ┤──DB2Entry(value) ────├ ┤──DB2TRAN(value) ─────

| ├ ┤──Doctemplate(value) ─| ├ ┤──Enqmodel(value) ────

├ ┤──FENode(value) ──────├ ┤──FEPool(value) ──────├ ┤──FEPropset(value) ───├ ┤──FETarget(value) ────├ ┤──FIle(value) ────────├ ┤──JModel(value) ──────├ ┤──JOurnalname(value) ─├ ┤──PArtner(value) ─────

| ├ ┤──PROCesstype(value) ─├ ┤──PROFile(value) ─────├ ┤──PROGram(value) ─────

| ├ ┤──Requestmodel(value)├ ┤──TClass(value) ──────

| ├ ┤──TCPIPservice(value)├ ┤──TDqueue(value) ─────├ ┤──TErminal(value) ────├ ┤──TRansaction(value) ─

| └ ┘──TSmodel(name) ──────

CEMT INQUIRE AUTOINSMODEL

55─ ──CEMT Inquire AUTInstmodel ── ──┬ ┬───── ─5% └ ┘─All─

CEMT INQUIRE AUTOINSTALL

55─ ──CEMT Inquire AUTOinstall ─5%

CEMT INQUIRE AUXTRACE

55─ ──CEMT Inquire AUXtrace ─5%

Chapter 3. CICS-Supplied Transaction 171

Page 192: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE CONNECTION

55─ ──CEMT Inquire Connection ──┬ ┬──(value) ──┬ ┬──────────────── ──┬ ┬──────────── ──5└ ┘─ALl───── └ ┘──NEtname(value) ├ ┤─NOTPending─

└ ┘─PEnding────

5─ ──┬ ┬──────────── ──┬ ┬─────────── ──┬ ┬────────────── ──┬ ┬───────────── ───────────5| ├ ┤─INService── ├ ┤─ACquired── ├ ┤─NOTSupported─ ├ ┤─Vtam────────| └ ┘─OUtservice─ ├ ┤─RELeased── ├ ┤─Unattempted── ├ ┤─IRc─────────| ├ ┤─OBtaining─ ├ ┤─COMPlete───── ├ ┤─XM──────────| ├ ┤─FReeing─── └ ┘─Failed─────── ├ ┤─INDirect────

└ ┘─AVailable─ ├ ┤─XCf───────── └ ┘─RConnection─

5─ ──┬ ┬────── ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬─────────────── ─────────────────5├ ┤─EXci─ ├ ┤─XOk────── ├ ┤─RECovdata─── └ ┘──Grname(value)

├ ┤─APpc─ └ ┘─XNotdone─ ├ ┤─NORecovdata─ └ ┘─Lu61─ └ ┘─NRs─────────

5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ──┬ ┬────────────── ───────────5└ ┘──Membername(value) └ ┘──REMotesystem(value) └ ┘──RNAme(value)

5─ ──┬ ┬───────────────── ─5%└ ┘──RNEtname(value)

CEMT INQUIRE DB2CONN

55─ ──CEMT Inquire DB2Conn ─5%

172 CICS User’s Handbook

Page 193: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

55─ ──CEMT Inquire DB2Entry(data-area) ──┬ ┬─────────────── ──┬ ┬─────── ──────────5└ ┘──AT(data-area) ├ ┤─START─

├ ┤─END─── └ ┘─NEXT──

5─ ──┬ ┬────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ──────────5├ ┤──ACCOUNTREC(cvda) └ ┘──AUTHID(data-area) ├ ┤──AUTHTYPE(cvda)

├ ┤─UOW────────────── ├ ┤─GROUP────────── ├ ┤─TASK───────────── ├ ┤─SIGN─────────── ├ ┤─TXID───────────── ├ ┤─TERM─────────── └ ┘─NONE───────────── ├ ┤─TX───────────── ├ ┤─OPID─────────── └ ┘─USERID─────────

5─ ──┬ ┬─────────────────── ──┬ ┬───────────────── ──┬ ┬──────────────────── ───────5├ ┤──DISABLEDACT(cvda) ├ ┤──DROLLBACK(cvda) ├ ┤──ENABLESTATUS(cvda)

├ ┤─ABEND───────────── ├ ┤─ROLLBACK──────── ├ ┤─ENABLED──────────── ├ ┤─SQLCODE─────────── └ ┘─NOROLLBACK────── ├ ┤─DISABLED─────────── └ ┘─POOL────────────── └ ┘─DISABLING──────────

5─ ──┬ ┬───────────────── ──┬ ┬───────────────────────── ──┬ ┬──────────────── ─────5└ ┘──PLAN(data-area) └ ┘──PLANEXITNAME(data-area) ├ ┤──PRIORITY(cvda)

├ ┤─HIGH─────────── ├ ┤─EQUAL────────── └ ┘─LOW────────────

5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──PROTECTNUM(data-area) └ ┘──PTHREADS(data-area)

5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ───────────────────────5└ ┘──THREADLIMIT(data-area) └ ┘──THREADS(data-area)

5─ ──┬ ┬────────────────── ────────────────────────────────────────────────────5%├ ┤──THREADWAIT(cvda)

├ ┤─TWAIT──────────── ├ ┤─NOTWAIT────────── └ ┘─TPOOL────────────

CEMT INQUIRE DB2TRAN

55──CEMT Inquire DB2Tran─ ──┬ ┬───────────── ──┬ ┬───────────────────── ────────────5└ ┘──(data-area) └ ┘──DB2Entry(data-area)

5─ ──┬ ┬──────────────────── ─5%└ ┘──Transid(data-area)

CEMT INQUIRE DELETSHIPPED

55─ ──CEMT Inquire DEletshipped ──┬ ┬───────────── ──┬ ┬───────────────── ─5%└ ┘──IDle(value) └ ┘──INterval(value)

Chapter 3. CICS-Supplied Transaction 173

Page 194: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE DOCTEMPLATE

55─ ──CEMT Inquire DOctemplate ──┬ ┬───────── ──┬ ┬──────────── ──┬ ┬────────── ───────5├ ┤─TSq───── └ ┘──Name(name) ├ ┤─Append───

├ ┤─TDq───── └ ┘─Noappend─ ├ ┤─File──── ├ ┤─EXitpgm─ └ ┘─Member──

5─ ──┬ ┬──────── ──┬ ┬──────────────────── ──┬ ┬────────────────────────── ───────────5├ ┤─Ebcdic─ └ ┘──Templatename(name) └ ┘─Templatename──(──name──)─

└ ┘─Binary─

5─ ──┬ ┬──────── ─5% ├ ┤─DDname─ └ ┘─DSname─

CEMT INQUIRE DSAS

55─ ──CEMT Inquire DSAs ─5%

CEMT INQUIRE DSNAME

┌ ┐─ALl────────────────55─ ──CEMT Inquire DSName ──┼ ┼──────────────────── ─5%

├ ┤──(value) ─────────── ├ ┤──┬ ┬─VSam─ ────────── │ │└ ┘─BDam─

├ ┤──FIlecount(value) ── ├ ┤──┬ ┬─VAlid─── ─────── │ │└ ┘─INvalid─ ├ ┤──┬ ┬─Path─ ────────── │ │└ ┘─BASE─ ├ ┤──┬ ┬─FWDRECOVAble─ ── │ │├ ┤─NOTrecovable─ │ │├ ┤─RECOVERAble── │ │└ ┘─UNDetermined─ ├ ┤──┬ ┬─Static─────── ── │ │├ ┤─Dynamic────── │ │└ ┘─UNDetermined─

├ ┤──FRlog(value) ────── ├ ┤──┬ ┬─AVailable─── ─── │ │└ ┘─UNAvailable─ ├ ┤──┬ ┬─NOLostlocks── ── │ │├ ┤─REMLostlocks─ │ │└ ┘─RECOVERLocks─ ├ ┤──┬ ┬─RETAined─── ──── │ │└ ┘─NORetained─ ├ ┤──┬ ┬─Quiesced─── ──── │ │└ ┘─UNQuiesced─

├ ┤──BASEDsname(value) ─└ ┘──FWDRECOVLsn(value)

CEMT INQUIRE DUMPDS

55─ ──CEMT Inquire DUmpds ─5%

174 CICS User’s Handbook

Page 195: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

| CEMT INQUIRE ENQ|

| 55─ ──CEMT Inquire Enq ──┬ ┬──────────── ──┬ ┬──────────────── ──┬ ┬─────────────── ───5| └ ┘──Uow(value) └ ┘──TRansid(value) └ ┘──TAskid(value)

| 5─ ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬──────── ──┬ ┬───────────────── ─────────────5| ├ ┤─ACtive─── ├ ┤─Dataset───── ├ ┤─Owner── └ ┘──Netuowid(value)| └ ┘─RETained─ ├ ┤─File──────── └ ┘─Waiter─| ├ ┤─EXecenq─────| ├ ┤─ADdrexecenq─| ├ ┤─TDq─────────| └ ┘─TSq─────────

| 5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┬ ┬───────────── ──────────────────5| └ ┘──ENqfails(value) └ ┘──RESource(value) └ ┘──RLen(value)

| 5─ ──┬ ┬────────────────── ──┬ ┬───────────── ─5%| └ ┘──QUalifier(value) └ ┘──QLen(value)

| CEMT INQUIRE ENQMODEL|

| 55─ ──CEMT Inquire ENQModel ──┬ ┬──(value) ──────── ──┬ ┬────────── ─5%| ├ ┤──ENQSCOPE(value) ├ ┤─DISABLED─| └ ┘──ENQNAME(value) ─ ├ ┤─ENABLED──| └ ┘─WAITING──

CEMT INQUIRE EXCI

55─ ──CEMT Inquire Exci ──┬ ┬────────────── ─5%├ ┤──Task(number)

| └ ┘──Urid(value) ─

CEMT INQUIRE FILE

┌ ┐─ALl─────55─ ──CEMT Inquire FIle ──┼ ┼───────── ──┬ ┬──────── ──┬ ┬──────── ──┬ ┬─────────── ─────5

└ ┘──(value) ├ ┤─Vsam─── ├ ┤─OPen─── ├ ┤─ENabled─── ├ ┤─BDam─── └ ┘─CLosed─ ├ ┤─UNenabled─ └ ┘─REMote─ └ ┘─DIsabled──

5─ ──┬ ┬──────── ──┬ ┬────────── ──┬ ┬─────────── ──┬ ┬────────── ──┬ ┬────────── ────────5 ├ ┤─REAd─── ├ ┤─UPdate─── ├ ┤─ADdable─── ├ ┤─BRowse─── ├ ┤─DElete─── └ ┘─NORead─ └ ┘─NOUpdate─ └ ┘─NOAddable─ └ ┘─NOBrowse─ └ ┘─NODelete─

5─ ──┬ ┬───────────── ──┬ ┬─────── ──┬ ┬──────── ──┬ ┬──────────── ─────────────────────5 ├ ┤─EXclusive─── ├ ┤─OLd─── ├ ┤─RLs──── ├ ┤─EMptyreq─── └ ┘─NOEXclusive─ └ ┘─Share─ └ ┘─NOTRls─ └ ┘─NOEMptyreq─

5─ ──┬ ┬─────────────── ──┬ ┬─────────── ──┬ ┬──────── ──┬ ┬───────────────── ──────────5| └ ┘──DSname(value) ├ ┤─NOTTable── ├ ┤─LOAd─── └ ┘──CFDtpool(value)| ├ ┤─CIcstable─ └ ┘─NOLoad─| ├ ┤─USertable─| └ ┘─CFTable───

5─ ──┬ ┬────────────────── ──┬ ┬──────────── ──┬ ┬─────────────────── ────────────────5| └ ┘──Tablename(value) ├ ┤─LOCKING──── └ ┘──Maxnumrecs(value)| └ ┘─COntention─

5─ ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5%| └ ┘──Keylength(value) └ ┘──RECordsize(value)

CEMT INQUIRE GTFTRACE

55─ ──CEMT Inquire Gtftrace ─5%

Chapter 3. CICS-Supplied Transaction 175

Page 196: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE INTTRACE

55─ ──CEMT Inquire INttrace ─5%

CEMT INQUIRE IRC

55─ ──CEMT Inquire IRc ─5%

CEMT INQUIRE JMODEL

┌ ┐─All─────55─ ──CEMT Inquire JModel ──┼ ┼───────── ──┬ ┬──────────────────── ──┬ ┬─────── ───────5

└ ┘──(value) └ ┘──(Journalnamevalue) ├ ┤─Mvs─── ├ ┤─SMf─── └ ┘─Dummy─

5─ ──┬ ┬─────────────────── ─5%└ ┘──STreamname(value)

CEMT INQUIRE JOURNALNAME

┌ ┐─All─────55─ ──CEMT Inquire JOurnalname ──┴ ┴──(value) ──┬ ┬─────── ──┬ ┬────────── ────────────5 ├ ┤─Mvs─── ├ ┤─Enabled── ├ ┤─SMf─── ├ ┤─DIsabled─ └ ┘─DUmmy─ └ ┘─FAiled───

5─ ──┬ ┬─────────────────── ─5%└ ┘──STreamname(value)

CEMT INQUIRE LINE

55─ ──CEMT Inquire Line ──(value) ──┬ ┬─────────────── ──┬ ┬──────────────── ─────────5└ ┘──NUmber(value) └ ┘──NEgpoll(value)

5─ ──┬ ┬──────────── ─5% ├ ┤─Inservice── └ ┘─Outservice─

CEMT INQUIRE MODENAME

┌ ┐─ALl─55─ ──CEMT Inquire MODename ── ──┴ ┴───── ──┬ ┬───────── ──┬ ┬─────────────────── ──────5

└ ┘──(value) └ ┘──COnnection(value)

5─ ──┬ ┬──────────────── ──┬ ┬────────────────── ──┬ ┬─────────────── ─5%└ ┘──Maximum(value) └ ┘──AVailable(value) └ ┘──ACTive(value)

CEMT INQUIRE MONITOR

55─ ──CEMT Inquire MONitor ──┬ ┬─────── ──┬ ┬──────────────────── ─5%├ ┤─Gmt─── └ ┘──SUbsystemid(value)

└ ┘─Local─

176 CICS User’s Handbook

Page 197: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE NETNAME

┌ ┐─ALl─────55─ ──CEMT Inquire Netname ──┼ ┼───────── ──┬ ┬──────────────────── ─────────────────5

└ ┘──(value) └ ┘──TRansaction(value)

5─ ──┬ ┬───────────────── ──┬ ┬────────────── ──┬ ┬──────────── ──┬ ┬─────── ───────────5└ ┘──PRiority(value) ├ ┤─PAgeable───── ├ ┤─Inservice── ├ ┤─ATi───

└ ┘─AUtopageable─ └ ┘─Outservice─ └ ┘─NOAti─

5─ ──┬ ┬─────── ──┬ ┬─────────── ──┬ ┬───────────────── ──┬ ┬────────── ────────────────5├ ┤─TTi─── ├ ┤─RTerminal─ └ ┘──TErminal(value) ├ ┤─ACquired─

└ ┘─NOTti─ ├ ┤─RSession── ├ ┤─COldacq── ├ ┤─Session─── └ ┘─RELeased─ └ ┘─Local─────

5─ ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬───────────────────── ──┬ ┬────────────── ───5├ ┤─CReate─── └ ┘──TAsk(value) └ ┘──REMotesystem(value) └ ┘──RNAme(value)

└ ┘─NOCreate─

5─ ──┬ ┬───────────────── ──┬ ┬──────────── ── ──┬ ┬──────── ─5%└ ┘──RNEtname(value) └ ┘──CId(value) └ ┘─Userid─

CEMT INQUIRE PARTNER

┌ ┐─All─────55─ ──CEMT Inquire PArtner ──┼ ┼───────── ──┬ ┬──────────────── ─────────────────────5

└ ┘──(value) └ ┘──NETWork(value)

5─ ──┬ ┬──────────────── ──┬ ┬──────────────── ──┬ ┬──────────────── ─────────────────5└ ┘──NETName(value) └ ┘──Profile(value) └ ┘──Ltpname(value)

5─ ──┬ ┬─────────────── ─5%└ ┘──Tpname(value)

CEMT INQUIRE PROCESSTYPE

┌ ┐─ALl─────55─ ──CEMT Inquire PROCesstype ──┼ ┼───────── ──┬ ┬───────────── ────────────────────5

└ ┘──(value) └ ┘──FIle(value)

5─ ──┬ ┬───────────────── ──┬ ┬────────── ──┬ ┬────────── ─5% └ ┘──AUditlog(value) ├ ┤─ACtivity─ ├ ┤─Enabled── ├ ┤─FUll───── └ ┘─Disabled─ ├ ┤─Off────── └ ┘─Process──

CEMT INQUIRE PROFILE

┌ ┐─All─────55─ ──CEMT Inquire PROFile ──┼ ┼───────── ─5%

└ ┘──(value)

Chapter 3. CICS-Supplied Transaction 177

Page 198: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE PROGRAM

┌ ┐─ALl──────────55─ ──CEMT Inquire PROGram ──┼ ┼────────────── ──┬ ┬─────────────── ─────────────────5

├ ┤──(value) ───── └ ┘──LENgth(value)└ ┘──CLass(value)

┌ ┐─PRIvate─5─ ──┬ ┬──────────── ──┬ ┬────────────── ──┬ ┬────────── ──┼ ┼───────── ────────────────5 ├ ┤─PLi──────── ├ ┤─PROgram────── ├ ┤─Enabled── └ ┘─Shared── ├ ┤─CObol────── ├ ┤─Mapset─────── └ ┘─DIsabled─ ├ ┤─C────────── └ ┘─PArtitionset─ ├ ┤─LE37ð────── ├ ┤─ASsembler── ├ ┤─NOTDEfined─

| └ ┘─JAVA───────

5─ ──┬ ┬───────────── ──┬ ┬──────── ──┬ ┬──────────── ──┬ ┬───────────────── ───────────5| ├ ┤─REQuired──── ├ ┤─CEDf─── ├ ┤─DYnamic──── └ ┘──REScount(value)| └ ┘─NOTRequired─ └ ┘─NOCedf─ └ ┘─NOTDYnamic─

5─ ──┬ ┬───────────────── ──┬ ┬─────── ──┬ ┬────────── ──┬ ┬─────────── ────────────────5└ ┘──USecount(value) ├ ┤─ANy─── ├ ┤─CEXeckey─ ├ ┤─DPlsubset─

└ ┘─Below─ └ ┘─UExeckey─ └ ┘─Fullapi───

5─ ──┬ ┬──────────── ──┬ ┬───────────────────── ──┬ ┬────────── ──┬ ┬───────── ─────────5| ├ ┤─Quasirent── └ ┘──REMotesystem(value) ├ ┤─JVM────── ├ ┤─DEBug───| └ ┘─Threadsafe─ ├ ┤─LE37ð──── └ ┘─NODebug─| ├ ┤─NONLE37ð─| └ ┘─UNKNOWN──

5─ ──┬ ┬───────────────── ─5%| └ ┘──JVMClass(value)

CEMT INQUIRE STATISTICS

55─ ──CEMT Inquire STAtistics ─5%

CEMT INQUIRE STREAMNAME

┌ ┐─ALl─55─ ──CEMT Inquire STReamname ── ──┴ ┴───── ─── ───(value) ──┬ ┬───────────────── ──────5

└ ┘──Usecount(value)

5─ ──┬ ┬──────── ──┬ ┬────────── ─5% ├ ┤─Failed─ ├ ┤─Syslog─── └ ┘─Ok───── └ ┘─Nosyslog─

CEMT INQUIRE SYDUMPCODE

┌ ┐─ALl─────55─ ──CEMT Inquire SYDumpcode ──┼ ┼───────── ──┬ ┬─────────── ──┬ ┬───────── ──────────5

└ ┘──(value) ├ ┤─SYsdump─── ├ ┤─RELated─ └ ┘─NOSYsdump─ └ ┘─Local───

5─ ──┬ ┬──────────── ──┬ ┬──────────────── ──┬ ┬──────────────── ──┬ ┬─────── ─5%├ ┤─SHutdown─── └ ┘──Maximum(value) └ ┘──Current(value) ├ ┤─Dae───

└ ┘─NOSHutdown─ └ ┘─NODae─

CEMT INQUIRE SYSTEM

55─ ──CEMT Inquire SYStem ─5%

178 CICS User’s Handbook

Page 199: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE TASK

┌ ┐─ALl───────────55─ ──CEMT Inquire TAsk ──┼ ┼─────────────── ──┬ ┬─────────────── ───────────────────5

├ ┤──(value) ────── └ ┘──TRanid(value)└ ┘──TClass(value)

5─ ──┬ ┬───────────────── ──┬ ┬────────────── ──┬ ┬────── ──┬ ┬───────────────── ───────5└ ┘──FAcility(value) ├ ┤─Running────── ├ ┤─TAsk─ └ ┘──PRiority(value)

├ ┤─DIspatchable─ ├ ┤─TErm─ └ ┘─SUspended──── └ ┘─DEst─

5─ ──┬ ┬────────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ────────────────────5└ ┘──STartcode(value) └ ┘──USerid(value) └ ┘──UOw(value)

5─ ──┬ ┬────────────── ──┬ ┬─────────────── ──┬ ┬────────────── ──┬ ┬───────── ─────────5└ ┘──HTYpe(value) └ ┘──HValue(value) └ ┘──HTIme(value) ├ ┤─Backout─

└ ┘─Commit──

5─ ──┬ ┬─────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────────── ───────────5└ ┘──BRidge(value) └ ┘──IDentifier(value) └ ┘──Indoubtmins(value)

5─ ──┬ ┬──────── ──┬ ┬──────────────── ──┬ ┬─────────────────── ──────────────────────5| ├ ┤─Nowait─ └ ┘──DB2plan(value) └ ┘──ACTIVITYId(value)

└ ┘─Wait───

5─ ──┬ ┬───────────────── ──┬ ┬──────────────── ──┬ ┬──────────────────── ─5%| └ ┘──ACTIVITY(value) └ ┘──PROCESS(value) └ ┘──PROCESSType(value)

CEMT INQUIRE TCLASS

┌ ┐─ALl─────55─ ──CEMT Inquire TClass ──┼ ┼───────── ──┬ ┬────────────────── ────────────────────5

└ ┘──(value) └ ┘──Maxactive(value)

5─ ──┬ ┬─────────────── ──┬ ┬──────────────────── ──┬ ┬─────────────── ─5%└ ┘──ACtive(value) └ ┘──Purgethresh(value) └ ┘──Queued(value)

CEMT INQUIRE TCPIPSERVICE

55─ ──INQUIRE TCPIPSERVICE(value) ──┬ ┬──────────────── ──┬ ┬───────────────────── ──5└ ┘──Backlog(value) └ ┘──CLOsetimeout(value)

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ─────────5└ ┘──Connection(value) └ ┘──IPaddress(value) ├ ┤──OPENSTATUS(value)

├ ┤─OPEN────────────── ├ ┤─CLOSING─────────── ├ ┤─CLOSED──────────── └ ┘─IMMCLOSING────────

5─ ──┬ ┬───────────── ──┬ ┬──────────────── ──┬ ┬──────────────────── ────────────────5└ ┘──Port(value) ├ ┤──SSLTYPE(value) ├ ┤──SOcketclose(value)

├ ┤─NO───────────── ├ ┤─Wait─────────────── ├ ┤─YES──────────── └ ┘─TImeout──────────── └ ┘─CLIENTAUTH─────

5─ ──┬ ┬───────────────────── ──┬ ┬──────────────── ──┬ ┬────────────────── ──────────5└ ┘──TCPIPService(value) └ ┘──TRansid(value) └ ┘──TSqprefix(value)

5─ ──┬ ┬──────────── ─5%└ ┘──URM(value)

Chapter 3. CICS-Supplied Transaction 179

Page 200: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE TDQUEUE

┌ ┐─All─────55─ ──CEMT Inquire TDqueue ──┼ ┼───────── ──┬ ┬───────────────────── ──┬ ┬────────── ──5

└ ┘──(value) └ ┘──TRIggerlevel(value) ├ ┤─INDirect─ ├ ┤─EXtra──── ├ ┤─INTra──── └ ┘─REMote───

5─ ──┬ ┬──────────────── ──┬ ┬────────── ──┬ ┬──────── ──┬ ┬─────────────── ────────────5└ ┘──NAmeind(value) ├ ┤─ENabled── ├ ┤─OPen─── └ ┘──TErmid(value)

└ ┘─DIsabled─ └ ┘─Closed─

5─ ──┬ ┬─────────────── ──┬ ┬─────────────── ──┬ ┬───── ──┬ ┬──────── ──┬ ┬──────── ──────5└ ┘──TRAnid(value) └ ┘──Userid(value) ├ ┤─Shr─ ├ ┤─INPut── ├ ┤─Queue──

├ ┤─OLd─ ├ ┤─OUtput─ └ ┘─REJect─ └ ┘─Mod─ └ ┘─RDback─

5─ ──┬ ┬──────── ──┬ ┬──────────────────── ──┬ ┬─────────────── ──┬ ┬─────────────── ─5%├ ┤─Wait─── └ ┘──DAtabuffers(value) └ ┘──DDname(value) └ ┘──DSname(value)

└ ┘─NOwait─

CEMT INQUIRE TERMINAL

┌ ┐─ALl──────────55─ ──CEMT Inquire TErminal ──┼ ┼────────────── ──┬ ┬──────────────────── ───────────5

├ ┤──(value) ───── └ ┘──TRansaction(value)└ ┘──CLass(value)

5─ ──┬ ┬──────────────── ──┬ ┬───────────────── ──┬ ┬────────────── ──────────────────5| └ ┘──COnsole(value) └ ┘──PRiority(value) ├ ┤─PAgeable─────

└ ┘─AUtopageable─

5─ ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬─────── ──┬ ┬─────────── ──┬ ┬──────────────── ────5├ ┤─Inservice── ├ ┤─ATi─── ├ ┤─TTi─── ├ ┤─RTerminal─ └ ┘──NEtname(value)

└ ┘─Outservice─ └ ┘─NOAti─ └ ┘─NOTti─ ├ ┤─RSession── ├ ┤─Session─── └ ┘─Local─────

5─ ──┬ ┬────────── ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬───────────────────── ───────5├ ┤─ACquired─ ├ ┤─CReate─── └ ┘──TAsk(value) └ ┘──REMotesystem(value)

└ ┘─RELeased─ └ ┘─NOCreate─

5─ ──┬ ┬────────────── ──┬ ┬───────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ─5%└ ┘──RNAme(value) └ ┘──RNEtname(value) └ ┘──Userid(value) └ ┘──CId(value)

180 CICS User’s Handbook

Page 201: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE TRANSACTION

┌ ┐─ALl──────────55─ ──CEMT Inquire TRAnsaction ──┼ ┼────────────── ──┬ ┬───────────────── ───────────5

├ ┤──(value) ───── └ ┘──PRIority(value)└ ┘──CLass(value)

5─ ──┬ ┬──────────────── ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬────────────── ──────5└ ┘──PROgram(value) └ ┘──TClass(value) ├ ┤─Enabled── ├ ┤─PUrgeable────

└ ┘─Disabled─ └ ┘─NOTPurgeable─

5─ ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬─────── ──┬ ┬─────────── ──────────────────5└ ┘──PRFile(value) ├ ┤─CDatakey─ ├ ┤─ANy─── ├ ┤─ISolate───

└ ┘─Udatakey─ └ ┘─BElow─ └ ┘─NOIsolate─

5─ ──┬ ┬─────────────── ──┬ ┬───────── ──┬ ┬─────────────── ──────────────────────────5└ ┘──TRprof(value) ├ ┤─BAckout─ └ ┘──BRexit(value)

└ ┘─COmmit──

5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ──┬ ┬──────── ────────────────5└ ┘──FAcilitylike(value) └ ┘──INdoubtmins(value) ├ ┤─NOWait─

└ ┘─Wait───

5─ ──┬ ┬───────────── ─5%| ├ ┤─Routable────| └ ┘─NOTRoutable─

CEMT INQUIRE TRDUMPCODE

┌ ┐─ALl─────55─ ──CEMT Inquire TRDumpcode ──┼ ┼───────── ──┬ ┬──────────── ──┬ ┬─────────── ───────5

└ ┘──(value) ├ ┤─Trandump─── ├ ┤─SYsdump─── └ ┘─NOTrandump─ └ ┘─NOSYsdump─

5─ ──┬ ┬──────────── ──┬ ┬───────── ──┬ ┬──────────────── ──┬ ┬──────────────── ─5%├ ┤─SHutdown─── ├ ┤─RELated─ └ ┘──Maximum(value) └ ┘──Current(value)

└ ┘─NOSHutdown─ └ ┘─Local───

| CEMT INQUIRE TSMODEL|

| ┌ ┐─ALl───── ┌ ┐─────────────────────────────| 55─ ──CEMT Inquire TSModel ──┼ ┼───────── ───

6┴┬ ┬───────────────────────── ─5%

| └ ┘──(value) ├ ┤──LOCATION(value) ────────| ├ ┤──POOLNAME(data-area) ────| ├ ┤──PREFIX(data-area) ──────| ├ ┤──RECOVSTATUS(value) ─────| ├ ┤──REMOTEPREFIX(data-area)| ├ ┤──REMOTESYSTEM(data-area)| └ ┘──SECURITYST(value) ──────

| CEMT INQUIRE TSPOOL|

| ┌ ┐─ALl─────| 55─ ──CEMT Inquire TSPool ──┼ ┼───────── ──┬ ┬────────────────── ─5%| └ ┘──(value) └ ┘──CONNSTATUS(cvda)

Chapter 3. CICS-Supplied Transaction 181

Page 202: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE TSQNAME

┌ ┐─ALl─────55─ ──CEMT Inquire TSqname ──┼ ┼───────── ──┬ ┬────────────── ──┬ ┬───────────────── ──5

└ ┘──(value) └ ┘──Sysid(value) └ ┘──Numitems(value)

5─ ──┬ ┬──────────────────── ──┬ ┬─────────────── ──┬ ┬─────────── ───────────────────5└ ┘──LAstusedint(value) └ ┘──LEngth(value) ├ ┤─MAIn──────

└ ┘─AUxiliary─

5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ─5%└ ┘──MAXitemlen(value) └ ┘──MInitemlen(value) └ ┘──Transid(value)

CEMT INQUIRE TSQUEUE

┌ ┐─ALl─────| 55─ ──CEMT Inquire TSQueue ──┼ ┼───────── ──┬ ┬───────────────── ────────────────────5| └ ┘──(value) ├ ┤──SYSID(value) ───| └ ┘──POOLNAME(value)

5─ ──┬ ┬───────────────── ──┬ ┬──────────────────── ──┬ ┬─────────────── ─────────────5└ ┘──Numitems(value) └ ┘──LAstusedint(value) └ ┘──LEngth(value)

5─ ──┬ ┬─────────── ──┬ ┬─────────────────── ──┬ ┬─────────────────── ────────────────5├ ┤─MAIn────── └ ┘──MAXitemlen(value) └ ┘──MInitemlen(value)

└ ┘─AUxiliary─

| 5─ ──RECOVSTATUS(value) ──┬ ┬──────────────── ─5%└ ┘──Transid(value)

CEMT INQUIRE UOW

┌ ┐─ALl─────55─ ──CEMT Inquire UOW ──┼ ┼───────── ──┬ ┬────────── ──┬ ┬───────── ──────────────────5

└ ┘──(value) ├ ┤─Backout── ├ ┤─ACtive── ├ ┤─COMmit─── ├ ┤─WAITIng─ ├ ┤─INDoubt── └ ┘─SHunted─ ├ ┤─INFlight─ ├ ┤─HBackout─ └ ┘─HCommit──

5─ ──┬ ┬──────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ──┬ ┬─────────────── ───5└ ┘──TRansid(value) └ ┘──TAskid(value) └ ┘──AGe(value) └ ┘──TErmid(value)

5─ ──┬ ┬──────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ──┬ ┬───────────── ─────5└ ┘──NETName(value) └ ┘──Userid(value) ├ ┤─CONnection─ └ ┘──Link(value)

├ ┤─Dataset──── ├ ┤─Rlsserver── ├ ┤─WAITCommit─ ├ ┤─WAITForget─ └ ┘─WAITRmi────

5─ ──┬ ┬────────────── ──┬ ┬───────────────── ─5%└ ┘──SYsid(value) └ ┘──NETUowid(value)

182 CICS User’s Handbook

Page 203: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT INQUIRE UOWDSNFAIL

55─ ──CEMT Inquire UOWDsnfail ──UOw(value) ──DSname(value) ──┬ ┬──────── ────────────5 ├ ┤─NOtrls─ └ ┘─RLS────

5─ ──┬ ┬──────────── ──┬ ┬────────────── ──┬ ┬────────────── ──┬ ┬──────────────── ─5%├ ┤─CAche────── ├ ┤─Backupnonbwo─ └ ┘──Sysid(value) └ ┘──NEtname(value)

├ ┤─CONnection─ ├ ┤─COMmitfail─── ├ ┤─DATASET──── ├ ┤─DATASETFull── ├ ┤─RLSServer── ├ ┤─DEAdlock───── └ ┘─UNdefined── ├ ┤─DELexiterror─ ├ ┤─Failedbkout── ├ ┤─INDExrecfull─ ├ ┤─IOerror────── ├ ┤─Openerror──── ├ ┤─RLSGone────── ├ ┤─INDOubt────── ├ ┤─RRCommitfail─ ├ ┤─RRIndoubt──── └ ┘─Lckstrucfull─

CEMT INQUIRE UOWENQ

55─ ──CEMT Inquire UOWEnq ──┬ ┬──────────── ──┬ ┬──────────────── ───────────────────5└ ┘──Uow(value) └ ┘──TRansid(value)

5─ ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬──────── ───────────────5└ ┘──TAskid(value) ├ ┤─ACtive─── ├ ┤─Dataset───── ├ ┤─Owner──

└ ┘─RETained─ ├ ┤─File──────── └ ┘─Waiter─ ├ ┤─EXecenq───── ├ ┤─ADdrexecenq─ ├ ┤─TDq───────── └ ┘─TSq─────────

5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┬ ┬───────────────── ──────────────5└ ┘──Netuowid(value) └ ┘──ENqfails(value) └ ┘──RESource(value)

5─ ──┬ ┬───────────── ──┬ ┬────────────────── ──┬ ┬───────────── ─5%└ ┘──RLen(value) └ ┘──QUalifier(value) └ ┘──QLen(value)

CEMT INQUIRE UOWLINK

┌ ┐─ALl─────55─ ──CEMT Inquire UOWLink ──┼ ┼───────── ──┬ ┬──────────── ──┬ ┬──────────── ─────────5

└ ┘──(value) └ ┘──UOw(value) ├ ┤─CONnection─ └ ┘─RMI────────

5─ ──┬ ┬───────────── ──┬ ┬───────────── ──┬ ┬─────────── ──┬ ┬───────────── ───────────5└ ┘──LInk(value) ├ ┤─COOrdinator─ ├ ┤─Irc─────── ├ ┤─COLdstart───

├ ┤─SUbordinate─ ├ ┤─APpc────── ├ ┤─STarting──── └ ┘─UNKnown───── ├ ┤─LU61────── ├ ┤─Warmstart─── ├ ┤─NOtapplic─ ├ ┤─UNAvailable─

| └ ┘─Rrms────── ├ ┤─UNConnected─ └ ┘─NOtapplic───

5─ ──┬ ┬────────────── ──┬ ┬─────────────── ──┬ ┬───────────────── ─5%└ ┘──SYsid(value) └ ┘──RMIQfy(value) └ ┘──NEtuowid(value)

CEMT INQUIRE VTAM

55─ ──CEMT Inquire Vtam ─5%

Chapter 3. CICS-Supplied Transaction 183

Page 204: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT PERFORM DELETSHIPPED

55─ ──CEMT Perform DEletshipped ─5%

CEMT PERFORM ENDAFFINITY

55─ ──CEMT Perform Endaffinity ──NETName(value) ──┬ ┬────────────── ─5%└ ┘──NETId(value)

CEMT PERFORM RESET

55─ ──CEMT Perform Reset ─5%

CEMT PERFORM SECURITY REBUILD

55─ ──CEMT Perform SEcurity ── ──┬ ┬───────── ─5% └ ┘─Rebuild─

CEMT PERFORM SHUTDOWN

55─ ──CEMT Perform SHUTdown ──┬ ┬──────────── ──┬ ┬──────────── ──┬ ┬─────────────── ──5└ ┘──Xlt(value) └ ┘──Plt(value) ├ ┤──Sdtran(value)

└ ┘─NOSdtran──────

5─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ── ──┬ ┬────── ─5% └ ┘ ─Immediate─ ──┬ ┬─────────── └ ┘─Takeover─ └ ┘─Dump─ └ ┘─NORestart─

CEMT PERFORM DUMP

55─ ──CEMT Perform ──┬ ┬─DUmp─ ──┬ ┬────────────── ─5%└ ┘─SNap─ └ ┘──Title(value)

184 CICS User’s Handbook

Page 205: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT PERFORM STATISTICS

┌ ┐───────────────────────55─ ──CEMT Perform STatistics ── ──┬ ┬──────── ───

6┴┬ ┬ ─ALl─ ──┬ ┬────────── ─5%

└ ┘─RECORd─ │ │└ ┘─RESetnow─ ├ ┤─AUtoinstall─────── ├ ┤─Connection──────── ├ ┤─DB2─────────────── ├ ┤─DIspatcher──────── ├ ┤─Enqueue─────────── ├ ┤─FEpi────────────── ├ ┤─FIle────────────── ├ ┤─Journalname─────── ├ ┤─Lsrpool─────────── ├ ┤─Monitor─────────── ├ ┤─PROGAuto────────── ├ ┤─PROGRam─────────── ├ ┤─RECOVery────────── ├ ┤─STAts───────────── ├ ┤─STOrage─────────── ├ ┤─STReamname──────── ├ ┤─SYsdump─────────── ├ ┤─TAblemgr────────── ├ ┤─TCLass────────────

| ├ ┤─TCPipservice────── ├ ┤─TDqueue─────────── ├ ┤─TErminal────────── ├ ┤─TRAnsaction─────── ├ ┤─TRDump──────────── ├ ┤─TSqueue─────────── └ ┘─Vtam──────────────

CEMT SET AUTOINSTALL

55─ ──CEMT Set AUToinstall ──┬ ┬───────────────── ──┬ ┬──────────────── ─────────────5| └ ┘──Consoles(value) └ ┘──Maxreqs(value)

5─ ──┬ ┬──────────────── ─5%└ ┘──Program(value)

CEMT SET AUXTRACE

55─ ──CEMT Set AUXtrace ──┬ ┬─────── ──┬ ┬────────── ── ──┬ ┬──────── ─5% ├ ┤─STArt─ ├ ┤─NOswitch─ └ ┘─SWitch─ ├ ┤─Pause─ ├ ┤─NExt───── └ ┘─STOp── └ ┘─All──────

CEMT SET CONNECTION

55─ ──CEMT Set Connection ──┬ ┬──(value) ── ──┬ ┬──────────── ──┬ ┬──────────── ────────5 └ ┘─ALl───── └ ┘─NOTpending─ ├ ┤─INService── └ ┘─OUtservice─

5─ ──┬ ┬────────── ──┬ ┬──────────── ──┬ ┬────────── ──┬ ┬───────────── ────────────────5 ├ ┤─ACquired─ ├ ┤─PUrge────── ├ ┤─COmmit─── └ ┘──ENdaffinity └ ┘─RELeased─ ├ ┤─FORCEPurge─ ├ ┤─Backout── ├ ┤─CAncel───── ├ ┤─FORCEUow─ └ ┘─FCancel──── └ ┘─RESync───

5─ ──┬ ┬───────────── ─5% └ ┘──NORecovdata

Chapter 3. CICS-Supplied Transaction 185

Page 206: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET DB2CONN

55─ ──CEMT Set DB2Conn ──────────────────────────────────────────────────────────5

┌ ┐───────────────────────────── ┌ ┐─────────────────────────────5─ ───

6┴┬ ┬───────────────────────── ───

6┴┬ ┬───────────────────────── ─5%

├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── ├ ┤──DB2ID(data-area) ───────│ │├ ┤─UOW────────────── ├ ┤──MSGQUEUE1(data-area) ───│ │├ ┤─TASK───────────── ├ ┤──MSGQUEUE2(data-area) ───│ │├ ┤─TXID───────────── ├ ┤──MSGQUEUE3(data-area) ───│ │└ ┘─NONE───────────── ├ ┤──┬ ┬──NONTERMREL(cvda) ───├ ┤──AUTHID(data-area) ────── │ │├ ┤─RELEASE──────────├ ┤──┬ ┬──AUTHTYPE(cvda) ───── │ │└ ┘─NORELEASE────────│ │├ ┤─GROUP────────── ├ ┤──PLAN(data-area) ────────│ │├ ┤─SIGN─────────── ├ ┤──PLANEXITNAME(data-area)│ │├ ┤─TERM─────────── ├ ┤──┬ ┬──PRIORITY(cvda) ─────

│ │├ ┤─TX───────────── │ │├ ┤─HIGH─────────── │ │├ ┤─OPID─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─USERID───────── │ │└ ┘─LOW────────────

├ ┤──COMAUTHID(data-area) ─── ├ ┤──PURGECYCLEM(data-area) ─├ ┤──┬ ┬──COMAUTHTYPE(cvda) ── ├ ┤──PURGECYCLES(data-area) ─│ │├ ┤─CGROUP──────────── ├ ┤──SECURITY(REBUILD) ──────│ │├ ┤─CSIGN───────────── ├ ┤──SIGNID(data-area) ──────│ │├ ┤─CTERM───────────── ├ ┤──┬ ┬──STANDBYMODE(cvda) ──

│ │├ ┤─CTX─────────────── │ │├ ┤─NOCONNECT───────── │ │├ ┤─COPID───────────── │ │├ ┤─CONNECT─────────── │ │└ ┘─CUSERID─────────── │ │└ ┘─RECONNECT─────────

├ ┤──COMTHREADLIM(data-area) ├ ┤──STATSQUEUE(data-area) ──├ ┤──┬ ┬──CONNECTERROR(cvda) ─ ├ ┤──TCBLIMIT(data-area) ────│ │├ ┤─ABEND────────────── ├ ┤──THREADLIMIT(data-area) ─│ │└ ┘─SQLCODE──────────── └ ┘──┬ ┬──THREADWAIT(cvda) ───└ ┘──┬ ┬──CONNECTST(cvda) ── ── ├ ┤─TWAIT────────────

├ ┤─CONNECTED───────── ├ ┤─NOTWAIT────────── ├ ┤─NOTCONNECTED────── └ ┘─N9ð6───────────── └ ┘─FORCENOTCONNECTED─

186 CICS User’s Handbook

Page 207: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET DB2ENTRY

┌ ┐─────────────────────────────55──CEMT Set DB2Entry─ ──┬ ┬───────────── ───

6┴┬ ┬───────────────────────── ─5%

└ ┘──(data-area) ├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── │ │├ ┤─UOW────────────── │ │├ ┤─TASK───────────── │ │├ ┤─TXID───────────── │ │└ ┘─NONE─────────────

├ ┤──AUTHID(data-area) ──────├ ┤──┬ ┬──AUTHTYPE(cvda) ─────

│ │├ ┤─GROUP────────── │ │├ ┤─SIGN─────────── │ │├ ┤─TERM─────────── │ │├ ┤─TX───────────── │ │├ ┤─OPID─────────── │ │└ ┘─USERID─────────

├ ┤──┬ ┬──DISABLEDACT(cvda) ── │ │├ ┤─ABEND───────────── │ │├ ┤─SQLCODE─────────── │ │└ ┘─POOL──────────────

├ ┤──┬ ┬──ENABLESTATUS(cvda) ─ │ │├ ┤─ENABLED──────────── │ │├ ┤─DISABLED─────────── │ │└ ┘─FORCEDISABLED──────

├ ┤──PLAN(data-area) ────────├ ┤──PLANEXITNAME(data-area)├ ┤──┬ ┬──PRIORITY(cvda) ─────

│ │├ ┤─HIGH─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─LOW────────────

├ ┤──PROTECTNUM(data-area) ──├ ┤──THREADLIMIT(data-area) ─└ ┘──┬ ┬──THREADWAIT(cvda) ───

├ ┤─TWAIT──────────── ├ ┤─NOTWAIT────────── └ ┘─TPOOL────────────

CEMT SET DB2TRAN

┌ ┐─────────────────────────55─ ──CEMT Set DB2Tran ───

6┴┬ ┬───────────────────── ─5%

├ ┤──DB2Entry(data-area)└ ┘──Transid(data-area) ─

CEMT SET DELETSHIPPED

55─ ──CEMT Set DEletshipped ──┬ ┬───────────────── ──┬ ┬───────────── ─5%└ ┘──INterval(value) └ ┘──IDle(value)

CEMT SET DSAS

55─ ──CEMT Set DSAs ──┬ ┬───────────────── ──┬ ┬────────────────── ─5%└ ┘──Dsalimit(value) └ ┘──EDsalimit(value)

Chapter 3. CICS-Supplied Transaction 187

Page 208: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET DSNAME

55─ ──CEMT Set DSName ──┬ ┬──(value) ──┬ ┬──────────── ──┬ ┬───────────── ─────────────5 └ ┘─ALl───── ├ ┤─REMOve───── ├ ┤─AVailable─── ├ ┤─RECOVEREd── └ ┘─UNAvailable─ ├ ┤─RESetlocks─ └ ┘─RETRy──────

5─ ──┬ ┬───────────── ──┬ ┬───────── ─5% ├ ┤─Quiesced──── ├ ┤─BACkout─ ├ ┤─UNQuiesced── ├ ┤─Commit── └ ┘─IMmquiesced─ └ ┘─FOrce───

CEMT SET DUMPDS

55─ ──CEMT Set DUmpds ──┬ ┬──────── ──┬ ┬────────────── ─5% ├ ┤─Open─── ├ ┤─Autoswitch─── ├ ┤─CLosed─ └ ┘─Noautoswitch─ └ ┘─Switch─

| CEMT SET ENQMODEL|

| 55─ ──CEMT Set ENQModel(value) ──┬ ┬────────── ─5%| ├ ┤─Enabled──| └ ┘─DIsabled─

CEMT SET FILE

55─ ──CEMT Set FIle ──┬ ┬──(value) ──┬ ┬──────────── ──┬ ┬────────── ──┬ ┬──────── ──────5 └ ┘─ALl───── ├ ┤─OPen─────── ├ ┤─ENabled── ├ ┤─REAd─── ├ ┤─CLosed───── └ ┘─DIsabled─ └ ┘─NORead─ └ ┘─Forceclose─

5─ ──┬ ┬────────── ──┬ ┬─────────── ──┬ ┬────────── ──┬ ┬────────── ──┬ ┬───────────── ───5 ├ ┤─UPdate─── ├ ┤─ADdable─── ├ ┤─BRowse─── ├ ┤─DElete─── ├ ┤─EXclusive─── └ ┘─NOUpdate─ └ ┘─NOAddable─ └ ┘─NOBrowse─ └ ┘─NODelete─ └ ┘─NOEXclusive─

5─ ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬──────── ──┬ ┬─────────────── ──┬ ┬─────────── ────5├ ┤─EMptyreq─── ├ ┤─Old─── ├ ┤─RLs──── └ ┘──DSname(value) ├ ┤─NOTTable──

└ ┘─NOEMptyreq─ └ ┘─Share─ └ ┘─NOTRls─ ├ ┤─CIcstable─ ├ ┤─USertable─

| └ ┘─CFTable───

5─ ──┬ ┬──────── ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬──────────── ──────5| ├ ┤─LOAd─── └ ┘──CFDtpool(value) └ ┘──Tablename(value) ├ ┤─COntention─| └ ┘─NOLoad─ └ ┘─LOCking────

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5%| └ ┘──Maxnumrecs(value) └ ┘──Keylength(value) └ ┘──RECordsize(value)

CEMT SET GTFTRACE

55─ ──CEMT Set Gtftrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──

CEMT SET INTTRACE

55─ ──CEMT Set INttrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──

188 CICS User’s Handbook

Page 209: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET IRC

55─ ──CEMT SET IRc ──┬ ┬─Open───── ─5% ├ ┤─Closed─── └ ┘─Immclose─

CEMT SET JOURNALNAME

55─ ──CEMT Set Journalname(value) ──┬ ┬──(value) ──┬ ┬────────── ──┬ ┬─────── ─5% └ ┘─All───── ├ ┤─Enabled── ├ ┤─FLush─ └ ┘─DIsabled─ └ ┘─Reset─

CEMT SET LINE

55─ ──CEMT Set Line(value) ──┬ ┬─────────────── ──┬ ┬──────────────── ───────────────5└ ┘──NUmber(value) └ ┘──NEgpoll(value)

5─ ──┬ ┬──────────── ──┬ ┬──────────── ─5% ├ ┤─Inservice── ├ ┤─Purge────── └ ┘─Outservice─ └ ┘─Forcepurge─

CEMT SET MODENAME

55─ ──CEMT Set MODename ──┬ ┬──(value) ──┬ ┬─────────────────── ─────────────────────5└ ┘─ALl───── └ ┘──COnnection(value)

5─ ──┬ ┬────────────────── ──┬ ┬────────── ─5%└ ┘──AVailable(value) ├ ┤─ACQuired─

└ ┘─CLosed───

CEMT SET MONITOR

55─ ──CEMT Set MONitor ──┬ ┬───── ──┬ ┬──────── ──┬ ┬───────── ──┬ ┬────────── ──────────5 ├ ┤─ON── ├ ┤─Perf─── ├ ┤─EVent─── ├ ┤─EXcept─── └ ┘─OFf─ └ ┘─NOPerf─ └ ┘─NOEVent─ └ ┘─NOEXcept─

5─ ──┬ ┬──────────── ──┬ ┬───────────── ──┬ ┬────────────────── ─5%├ ┤─Converse─── ├ ┤─SYncpoint─── └ ┘──Frequency(value)

└ ┘─NOConverse─ └ ┘─NOSyncpoint─

CEMT SET NETNAME

55─ ──CEMT Set Netname ──┬ ┬──(value) ──┬ ┬───────────────── ──┬ ┬────────────── ──────5└ ┘─ALl───── └ ┘──PRiority(value) ├ ┤─PAgeable─────

└ ┘─AUtopageable─

5─ ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬─────── ──┬ ┬──────────── ──┬ ┬────────── ─────────5 ├ ┤─Inservice── ├ ┤─ATi─── ├ ┤─TTi─── ├ ┤─PUrge────── ├ ┤─ACquired─ └ ┘─Outservice─ └ ┘─NOAti─ └ ┘─NOTti─ └ ┘─Forcepurge─ ├ ┤─COldacq── └ ┘─RELeased─

5─ ──┬ ┬────────── ─5% ├ ┤─CReate─── └ ┘─NOCreate─

Chapter 3. CICS-Supplied Transaction 189

Page 210: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET PROCESSTYPE

┌ ┐─ALl─────55─ ──CEMT Set PROCesstype ──┼ ┼───────── ──┬ ┬────────── ──┬ ┬────────── ─5%

└ ┘──(value) ├ ┤─ACtivity─ ├ ┤─Enabled── ├ ┤─FUll───── └ ┘─Disabled─ ├ ┤─Off────── └ ┘─Process──

CEMT SET PROGRAM

┌ ┐─PRIvate─55─ ──CEMT Set Program ──┬ ┬──(value) ───── ──┬ ┬────────── ──┼ ┼───────── ─────────────5

├ ┤──CLass(value) ├ ┤─Enabled── └ ┘─Shared── └ ┘─ALl────────── └ ┘─DIsabled─

5─ ──┬ ┬───────── ──┬ ┬──────── ──┬ ┬─────────── ──┬ ┬───────────────── ──┬ ┬───────── ───5| ├ ┤─NEwcopy─ ├ ┤─CEDf─── ├ ┤─DPlsubset─ └ ┘──JVMClass(value) ├ ┤─DEBUG───| └ ┘─PHasein─ └ ┘─NOCedf─ └ ┘─Fullapi─── └ ┘─NODEBUG─

5─ ──┬ ┬─────── ─5%| ├ ┤─JVM───| └ ┘─NOJVM─

CEMT SET STATISTICS

55─ ──CEMT Set STatistics ──┬ ┬───── ── ──┬ ┬────────── ── ──┬ ┬─────────── ─────────────5 ├ ┤─ON── └ ┘─RESetnow─ └ ┘─RECordnow─ └ ┘─OFf─

5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ─5%└ ┘──Interval(hhmmss) └ ┘──Endofday(hhmmss)

CEMT SET SYDUMPCODE

55─ ──CEMT Set SYDumpcode ──┬ ┬──(value) ──┬ ┬─────────── ──┬ ┬──────────── ───────────5 └ ┘─ALl───── ├ ┤─SYsdump─── ├ ┤─SHutdown─── └ ┘─NOSYsdump─ └ ┘─NOSHutdown─

5─ ──┬ ┬───────── ──┬ ┬──────────────── ──┬ ┬──────── ──┬ ┬─────── ─5%├ ┤─RELated─ └ ┘──Maximum(value) ├ ┤─RESet── ├ ┤─Dae───

└ ┘─Local─── ├ ┤─REMove─ └ ┘─NODae─ └ ┘─ADd────

190 CICS User’s Handbook

Page 211: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET SYSTEM

┌ ┐──────────────────────────55─ ──CEMT Set SYStem ───

6┴┬ ┬────────────────────── ─5%

├ ┤──AGing(value) ──────── ├ ┤──AKp(value) ────────── ├ ┤──DSAlimit(value) ─────

| ├ ┤──DSRtprogram(value) ── ├ ┤──DTrprogram(value) ─── ├ ┤──EDsalimit(value) ────

| ├ ┤──Forceqr ──┬ ┬─Force───| │ │└ ┘─NOForce─| ├ ┤──Logdefer(value) ─────| ├ ┤──MAXOpentcbs(value) ──

├ ┤──MAxtasks(value) ───── ├ ┤──MRobatch(value) ───── ├ ┤──┬ ┬─CTLGAll──── ────── │ │├ ┤─CTLGModify─ │ │└ ┘─CTLGNone─── ├ ┤──Progautoexit(value) ─ ├ ┤──┬ ┬─AUTOActive─── ──── │ │└ ┘─AUTOInactive─ ├ ┤──RUnaway(value) ────── ├ ┤──SCandelay(value) ──── ├ ┤──Time(value) ───────── └ ┘──┬ ┬─SYsdump─── ─────── └ ┘─NOSysdump─

CEMT SET TASK

55─ ──CEMT Set TAsk ──┬ ┬──(value) ──┬ ┬───────────────── ──┬ ┬──────────── ─5%└ ┘─All───── └ ┘──PRiority(value) ├ ┤─PUrge──────

└ ┘─FOrcepurge─

CEMT SET TCLASS

55─ ──CEMT Set TClass ──┬ ┬──(value) ──┬ ┬────────────────── ────────────────────────5└ ┘─ALl───── └ ┘──Maxactive(value)

5─ ──┬ ┬──────────────────── ─5%└ ┘──Purgethresh(value)

CEMT SET TCPIP

55─ ──CEMT Set TCPIP ──┬ ┬──(value) ──┬ ┬──Openstatus(cvda) ─5% └ ┘─ALl───── ├ ┤─OPEN───────────── ├ ┤─CLOSE──────────── └ ┘─IMMCLOSE─────────

CEMT SET TCPIPSERVICE

55─ ──CEMT Set TCPIPSERVICE ──┬ ┬──(value) ──┬ ┬──────────────── ────────────────────5└ ┘─ALl───── └ ┘──Backlog(value)

5─ ──┬ ┬────────────────── ──┬ ┬──────────── ─5%├ ┤──Openstatus(cvda) └ ┘──URM(value)

├ ┤─OPEN───────────── ├ ┤─CLOSE──────────── └ ┘─IMMCLOSE─────────

Chapter 3. CICS-Supplied Transaction 191

Page 212: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET TDQUEUE

55─ ──CEMT Set TDqueue ──┬ ┬──(value) ──┬ ┬───────────────────── ──┬ ┬────────── ──────5└ ┘─All───── └ ┘──TRIggerlevel(value) ├ ┤─ENabled──

└ ┘─DIsabled─

5─ ──┬ ┬──────── ─5% ├ ┤─OPen─── └ ┘─Closed─

CEMT SET TERMINAL

55─ ──CEMT Set TErminal ──┬ ┬──(value) ───── ──┬ ┬───────────────── ──────────────────5├ ┤──CLass(value) └ ┘──PRiority(value)

└ ┘─ALl──────────

5─ ──┬ ┬────────────── ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬─────── ──┬ ┬──────────── ─────5 ├ ┤─PAgeable───── ├ ┤─Inservice── ├ ┤─ATi─── ├ ┤─TTi─── ├ ┤─PUrge────── └ ┘─AUtopageable─ └ ┘─Outservice─ └ ┘─NOAti─ └ ┘─NOTti─ ├ ┤─Forcepurge─ └ ┘─CAncel─────

5─ ──┬ ┬────────── ──┬ ┬────────── ─5% ├ ┤─ACquired─ ├ ┤─CReate─── ├ ┤─COldacq── └ ┘─NOCreate─ └ ┘─RELeased─

CEMT SET TRANSACTION

55─ ──CEMT Set TRAnsaction ──┬ ┬──(value) ───── ──┬ ┬───────────────── ───────────────5├ ┤──CLass(value) └ ┘──PRIority(value)

└ ┘─ALl──────────

5─ ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬────────────── ─5%└ ┘──TClass(value) ├ ┤─Enabled── ├ ┤─PUrgeable────

└ ┘─Disabled─ └ ┘─NOTpurgeable─

CEMT SET TRDUMPCODE

55─ ──CEMT Set TRDumpcode ──┬ ┬──(value) ──┬ ┬──────────── ──┬ ┬─────────── ───────────5 └ ┘─ALl───── ├ ┤─Trandump─── ├ ┤─SYsdump─── └ ┘─NOTrandump─ └ ┘─NOSYsdump─

5─ ──┬ ┬──────────── ──┬ ┬───────── ──┬ ┬──────────────── ──┬ ┬──────── ─5%├ ┤─SHutdown─── ├ ┤─RELated─ └ ┘──Maximum(value) ├ ┤─RESet──

└ ┘─NOSHutdown─ └ ┘─Local─── ├ ┤─REMove─ └ ┘─ADd────

| CEMT SET TSQUEUE|

| ┌ ┐─ALl─────| 55─ ──CEMT Set TSqueue ──┼ ┼───────── ──┬ ┬───────────────── ────────────────────────5| └ ┘──(value) ├ ┤──SYSID(value) ───| └ ┘──POOLNAME(value)

| 5─ ──┬ ┬──────────────────── ──┬ ┬──Action(value) ─5%| └ ┘──LAstusedint(value) └ ┘─DELETE────────

192 CICS User’s Handbook

Page 213: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CEMT SET UOW

55─ ──CEMT Set UOW(value) ──┬ ┬──(value) ──┬ ┬─COMmit── ─5% └ ┘─ALl───── ├ ┤─Backout─ └ ┘─Force───

CEMT SET UOWLINK

55─ ──CEMT Set UOWlink(value) ──┬ ┬──(value) ──Delete ─5% └ ┘─ALl─────

CEMT SET VTAM

55─ ──CEMT Set Vtam ──┬ ┬─Open─────── ──┬ ┬───────────────────── ──┬ ┬────────────── ─5%├ ┤─Closed───── └ ┘──Psdinterval(hhmmss) └ ┘──Deregistered

├ ┤─Immclose─── └ ┘─Forceclose─

CEOT

55─ ──CEOT ──┬ ┬────────────── ──┬ ┬─────── ──┬ ┬─────── ─5% ├ ┤─PAgeable───── ├ ┤─ATi─── ├ ┤─TTi─── └ ┘─AUtopageable─ └ ┘─NOAti─ └ ┘─NOTti─

CESF

55─ ──CESF ──┬ ┬─────────── ─5% ├ ┤─GOODNIGHT─ └ ┘─LOGOFF────

CESN

| 55─ ──CESN USERID=uuuuuuuu ──CESN ──USERID=uuuuuuuu ──┬ ┬─────────────────── ───────5└ ┘──,GROUPID=gggggggg

5─ ──┬ ┬─────────────── ──┬ ┬────────────── ──┬ ┬───────────────── ─5%└ ┘──,LANGUAGE=lll └ ┘──,PS=pppppppp └ ┘──,NEWPS=password

Note:1 Do not use blanks between parameters in the comma-separated

list.

Chapter 3. CICS-Supplied Transaction 193

Page 214: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CMSG

55─ ──CMSG ──┬ ┬────── ──'message' ─────────────────────────────────────────────────5 └ ┘─MSG=─

┌ ┐────────────────5─ ──┬ ┬───────────────────────────────────────────────── ───

6┴┬ ┬──────────── ──────5

│ │┌ ┐───────────────── └ ┘─,OPCLASS=n─ └ ┘─,ROUTE=─ ──┬ ┬ ─ ──

6┴─Termid──/opid─ ─────────────────

├ ┤─ALL──────────────────────────────── │ │┌ ┐───────────── ┌ ┐─────────────────── └ ┘ ───

6┴─.termlist─ ───

6┴─,±termid──/opid─

5─ ──┬ ┬───────────── ──┬ ┬───────────────── ──┬ ┬─────────────────────── ────────────5└ ┘─,TIME=value─ ├ ┤─,DATE=value───── └ ┘──,ERRTERM= ──┬ ┬─Termid─

└ ┘─,FULLDATE=value─ └ ┘─ORIG───

5─ ──┬ ┬───────────── ──┬ ┬──────────────────── ──┬ ┬─────────────────────── ─────────5└ ┘──,ID=(title) └ ┘──,HEADING= ──┬ ┬─YES─ └ ┘──,PROTECT= ──┬ ┬─YES────

└ ┘─NO── ├ ┤─NO───── └ ┘─Prefix─

5─ ──┬ ┬─,SEND─── ─5% └ ┘─,CANCEL─

ROUTE

┌ ┐───────────────────────55─ ──ROUTE= ──┬ ┬───

6┴─Termid──\ldc──/opid─ ──────── ─5%

├ ┤─ALL──\ldc─────────────────────── │ │┌ ┐─────────────────── └ ┘───

6┴─.termlist──\ldc─ ─┤ Idloop ├─

Idloop: ┌ ┐───────────────────────────├─ ───

6┴┬ ┬─────────────────────── ─┤

└ ┘─,±termid──\ldc──/opid─

CRTE

55─ ──CRTE ──SYSID=sysid ──┬ ┬──────────────── ─5% └ ┘─,TRPROF=trprof─

CSFE SPOOLFE

55─ ──CSFE spoolfe= ──┬ ┬─ON── ─5% └ ┘─OFF─

CSFE ZCQTRACE

55─ ──CSFE zcqtrace ──┬ ┬─=termid────── ─5% ├ ┤─,AUTOINSTALL─ └ ┘─,OFF─────────

CSFE DEBUG TRANID

55─ ──CSFE debug ──┬ ┬─,TRANID=xxxx─ ──┬ ┬─────────────────── ─5% └ ┘─,TASKREQ=yyy─ │ │┌ ┐─OFF─

└ ┘──,STGFRZ= ──┴ ┴─ON──

194 CICS User’s Handbook

Page 215: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

CSFE DEBUG CHKSTSK

55─ ──CSFE debug ──┬ ┬──,CHKSTSK= ──┬ ┬─CURRENT─ ─5% │ │└ ┘─NONE────

└ ┘──,CHKSTRM= ──┬ ┬─CURRENT─ └ ┘─NONE────

CSPG GETPAGE

55─ ──CSPG ──Getpage ──┬ ┬─── ──B ──┬ ┬────── ──┬ ┬───────── ─5%└ ┘─A─ ├ ┤─\ldc─ └ ┘─,hhhhhh─

└ ┘─\ALL─

CSPG MESSCHNYYYY

55─ ──CSPG ──Messchnyyyy ──┬ ┬──────────── ─5% └ ┘─Parameters─

CSPG MSGTERM

55─ ──CSPG ──Msgterm ──┬ ┬─A─ ──┬ ┬───────── ─5% ├ ┤─B─ └ ┘─,hhhhhh─ ├ ┤─C─ ├ ┤─H─ └ ┘─R─

CWTO

55─ ──CWTO ──Message ─5%

Chapter 3. CICS-Supplied Transaction 195

Page 216: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CST syntax

196 CICS User’s Handbook

Page 217: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

Chapter 4. Resource definition online

The syntax diagrams that follow are taken from the CICS ResourceDefinition Guide.

ADD syntax

55─ ──ADd ──Group(groupname1) ──LIst(listname) ──┬ ┬──────────────────── ─5%├ ┤──Before(groupname2)└ ┘──After(groupname3) ─

ALTER syntax

55─ ──ALter ──┬ ┬──Connection(name) ── ──Group(groupname) ───────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TErminal(name) ────├ ┤──TDqueue(name) ─────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──attribute list(new value) ─5%

APPEND syntax

55─ ──APpend ──LIst(listname1) ──To(listname2) ─5%

Copyright IBM Corp. 1989, 1999 197

Page 218: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

CHECK syntax

55─ ──CHeck ──┬ ┬──Group(groupname) ──────────────────────────────── ───────────5└ ┘──List(listname1, listname2, listname3, listname4)

5─ ──┬ ┬───────────────────── ─5%| └ ┘──Remotesystem(sysid)

COPY syntax

┌ ┐─All────────────────55─ ──COpy ──┼ ┼──────────────────── ──Group(groupname) ────────────────────────5

├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──┬ ┬──AS(newname) ────────────────── ──┬ ┬───────── ─5%├ ┤──TO(newgroupname) ───────────── ├ ┤──Replace└ ┘──AS(new-name) TO(newgroupname) └ ┘──MErge ──

198 CICS User’s Handbook

Page 219: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

USERDEFINE syntax

55─ ──USerdefine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────├ ┤──DOctemplate(name) ─├ ┤──Enqmodel(name) ────├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──attribute list(newvalue) ─5%

DEFINE syntax

55─ ──DEFine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──LSRpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──attribute list(newvalue) ─5%

Chapter 4. Resource definition online 199

Page 220: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

DELETE syntax

55─ ──DELete ──┬ ┬─All──────────────── ──Group(groupname) ──┬ ┬──────── ─5%| ├ ┤──Connection(name) ── └ ┘─REMove─

├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

DISPLAY syntax

55─ ──DISplay ──┬ ┬──List(listname) ──┬ ┬────────────────── ──────────────── ─5%│ │└ ┘──Group(groupname)

└ ┘──Group(groupname) ──┬ ┬──────────────────── ──┬ ┬────────├ ┤ ─ ─ALl(name) ───────── └ ┘──REname├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

200 CICS User’s Handbook

Page 221: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

EXPAND syntax

55─ ──EXPand ──┬ ┬──List(listname) ──┬ ┬────────────────── ──────────────── ─5%│ │└ ┘──Group(groupname)

└ ┘──Group(groupname) ──┬ ┬──────────────────── ──┬ ┬────────├ ┤ ─ ─ALl(name) ───────── └ ┘──REname├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

INSTALL syntax

| 55─ ──Install ──┬ ┬──────────────────── ──┬ ┬──Group(groupname) ─5%| ├ ┤ ─ ─ALl(name) ───────── └ ┘──List(listname) ──

├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)| ├ ┤──TCpipservice(name)

├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

Chapter 4. Resource definition online 201

Page 222: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

LOCK syntax

55─ ──Lock ──┬ ┬──Group(groupname) ─5%└ ┘──List(listname) ──

MOVE syntax

┌ ┐─All────────────────55─ ──Move ──┼ ┼──────────────────── ──Group(groupname) ──┬ ┬──────── ────────────5

| ├ ┤──Connection(name) ── └ ┘─REMove─├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──┬ ┬──AS(newname) ───────────────── ──┬ ┬───────── ─5%| ├ ┤──TO(newgroupname) ──────────── ├ ┤──REPlace

└ ┘──AS(newname) TO(newgroupname) └ ┘──MErge ──

REMOVE syntax

55─ ──REMove ──Group(groupname) ──List(listname) ─5%

202 CICS User’s Handbook

Page 223: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

RENAME syntax

55─ ──REName ──┬ ┬──────────────────── ──┬ ┬────────────────── ──────────────────5├ ┤ ─ ─ALl(name) ───────── └ ┘──Group(groupname)├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──REQuestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──┬ ┬───────────── ──┬ ┬────────────────── ──┬ ┬──────── ─5%| └ ┘──AS(newname) └ ┘──TO(newgroupname) └ ┘──REMove

UNLOCK syntax

55─ ──UNLock ──┬ ┬──Group(groupname) ─5%└ ┘──List(listname) ──

Chapter 4. Resource definition online 203

Page 224: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RDO

USERDEFINE syntax

55─ ──USerdefine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──attribute list(newvalue) ─5%

VIEW syntax

55─ ──View ──Group(groupname) ──┬ ┬──────────────────── ─5%├ ┤ ─ ─ALl(name) ─────────├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────├ ┤──PROFile(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

204 CICS User’s Handbook

Page 225: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CSD

Chapter 5. DFHCSDUP commands

The syntax diagrams that follow are taken from the CICS ResourceDefinition Guide.

ADD syntax

55─ ──ADd ──Group(groupname) ──LIst(listname) ─5%

ALTER syntax

55─ ──ALter ──┬ ┬──Connection(name) ── ──Group(groupname) ───────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──attribute list(new value) ─5%

APPEND syntax

55─ ──APpend ──FRomcsd(ddname) ──LIst(listname1) ──To(listname2) ─5%

Copyright IBM Corp. 1989, 1999 205

Page 226: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CSD

COPY syntax

55─ ──Copy ──Group(groupname1) ──To(groupname2) ──┬ ┬───────── ──────────────────5 ├ ┤──Replace └ ┘──MErge ──

5─ ──FRomcsd(ddname) ─5%

DEFINE syntax

55─ ──DEFine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──LSRpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

5─ ──attribute list(newvalue) ─5%

206 CICS User’s Handbook

Page 227: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CSD

DELETE syntax

55─ ──DELete ──┬ ┬──List(listname) ────────────────────────────────────── ─5% └ ┘──Group(groupname) ──┬ ┬─All──────────────── ──┬ ┬────────

| ├ ┤──Connection(name) ── └ ┘─REMove─├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

EXTRACT syntax

55─ ──EXtract ──┬ ┬──Group(groupname) ──┬ ┬──USerprogram(DFHxCRFy) ──────────── ──5└ ┘──LIst(listname) ── ├ ┤──USerprogram(DFHxFORy) ────────────

├ ┤──USerprogram(DFHðCBDC) ──────────── └ ┘──USerprogram(user-written program)

5─ ── ──┬ ┬───────── ─5% └ ┘─Objects─

INITIALIZE syntax

55─ ──INITialize ─5%

Chapter 5. DFHCSDUP commands 207

Page 228: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CSD

LIST syntax

┌ ┐─All─55─ ──LIst ──┬ ┬── ──┴ ┴───── ─────── ── ──┬ ┬───────── ─5%

├ ┤──Group(groupname) └ ┘─Objects─└ ┘──LIst(listname) ──

MIGRATE syntax

55─ ──MIgrate ──TAble(tablename) ──┬ ┬──────────────────────────── ─────────────5└ ┘──TYpesgroup(typesgroupname)

5─ ──┬ ┬──────────────────── ─5%└ ┘──TOGROUP(groupname)

REMOVE syntax

55─ ──Remove ──Group(groupname) ──LIst(listname) ─5%

208 CICS User’s Handbook

Page 229: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CSD

SCAN syntax

55─ ──SCAN ──┬ ┬──Connection(name) ── ──┬ ┬────────────────── ─5%├ ┤──DB2Conn(name) ───── └ ┘──ALIAS(aliasname)├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────

| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────

├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────

| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────

| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────

| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─

| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────

SERVICE syntax

55─ ──Service ──FRomcsd(ddname) ──LEvel(nnn) ─5%

UPGRADE syntax

55─ ──UPgrade ──┬ ┬───────────────── ── ──┬ ┬───────── ─5%└ ┘──USing(filename) └ ┘─Replace─

VERIFY syntax

55─ ──VERIFY ─5%

Chapter 5. DFHCSDUP commands 209

Page 230: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CSD

210 CICS User’s Handbook

Page 231: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

Chapter 6. Front End Programming Interfacecommand reference

This chapter contains General Use Programming Interface information.

FEPI application programming

FEPI ALLOCATE PASSCONVID

55─ ──FEPI ALLOCATE ──PASSCONVID(data-value) ─5%

Conditions: INVREQ

FEPI ALLOCATE POOL

55─ ──FEPI ALLOCATE ──POOL(data-value) ──CONVID(data-area) ────────────────────────5

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───5└ ┘──TARGET(data-value) └ ┘──TIMEOUT(data-value) └ ┘──SEQNUMIN(data-area)

5─ ──┬ ┬────────────────────── ──┬ ┬─────────────────── ─5%└ ┘──SEQNUMOUT(data-area) └ ┘──SESSNSTATUS(cvda)

Conditions: INVREQ

FEPI AP NOOP

55─ ──FEPI AP NOOP ─5%

Conditions: INVREQ

Previously allocated conversation

Copyright IBM Corp. 1989, 1999 211

Page 232: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI CONVERSE DATASTREAM

55─ ──FEPI CONVERSE DATASTREAM ──CONVID(data-value) ──FROM(data-value) ────────────5

┌ ┐─CHAIN─────5─ ──┬ ┬───────────────────────── ──┼ ┼─────────── ──┬ ┬───────────────── ──┬ ┬───── ───5

└ ┘──FROMFLENGTH(data-value) ├ ┤─RU──────── └ ┘──ENDSTATUS(cvda) └ ┘──FMH └ ┘─UNTILCDEB─

5─ ──┬ ┬───────────────── ──┬ ┬───────────────────────────────────── ───────────────5└ ┘──FMHSTATUS(cvda) └ ┘── ──INTO(data-area) ─┤ INTO options ├─

5─ ──┬ ┬─────────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ───5└ ┘──REMFLENGTH(data-area) └ ┘──RESPSTATUS(cvda) └ ┘──SEQNUMIN(data-area)

5─ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ─5%└ ┘──SEQNUMOUT(data-area) └ ┘──TIMEOUT(data-value)

INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤

└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)

Conditions: INVREQ

212 CICS User’s Handbook

Page 233: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

Temporary conversationFEPI CONVERSE DATASTREAM

55─ ──FEPI CONVERSE DATASTREAM ──POOL(data-value) ──┬ ┬──────────────────── ────────5└ ┘──TARGET(data-value)

┌ ┐─UNTILCDEB─5─ ──FROM(data-value) ──┬ ┬───────────────────────── ──┴ ┴─────────── ───────────────5

└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬───────────────── ──┬ ┬───── ──┬ ┬───────────────── ──────────────────────────5└ ┘──ENDSTATUS(cvda) └ ┘──FMH └ ┘──FMHSTATUS(cvda)

5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────────── ─────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──REMFLENGTH(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬───────────────────── ──┬ ┬────────────────────── ────5└ ┘──RESPSTATUS(cvda) └ ┘──SEQNUMIN(data-area) └ ┘──SEQNUMOUT(data-area)

5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)

INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤

└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)

Conditions: INVREQ

Previously allocated conversationFEPI CONVERSE FORMATTED

55─ ──FEPI CONVERSE FORMATTED ──CONVID(data-value) ──FROM(data-value) ─────────────5

5─ ──┬ ┬───────────────────────── ────────────────────────────────────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──AID(data-value) ──┬ ┬──────────────────────── ────────────────────────────5│ │└ ┘──FROMCURSOR(data-value)

└ ┘ ──KEYSTROKES ──┬ ┬──────────────────── ─────────└ ┘──ESCAPE(data-value)

5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────── ─────────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──ALARMSTATUS(cvda)

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────── ──┬ ┬─────────────────── ─────────5└ ┘──COLUMNS(data-area) └ ┘──ENDSTATUS(cvda) └ ┘──FIELDS(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ────────5└ ┘──LINES(data-area) └ ┘──RESPSTATUS(cvda) └ ┘──TIMEOUT(data-value)

5─ ──┬ ┬───────────────────── ─5%└ ┘──TOCURSOR(data-area)

INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤

└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)

Conditions: INVREQ

Chapter 6. FEPI command reference 213

Page 234: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

Temporary conversationFEPI CONVERSE FORMATTED

55─ ──FEPI CONVERSE FORMATTED ──POOL(data-value) ──┬ ┬──────────────────── ─────────5└ ┘──TARGET(data-value)

5─ ──FROM(data-value) ──┬ ┬───────────────────────── ──KEYSTROKES ──────────────────5└ ┘──FROMFLENGTH(data-value)

5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────────────────────── ────────────5└ ┘──ESCAPE(data-value) └ ┘── ──INTO(data-area) ─┤ INTO options ├─

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──┬ ┬───────────────── ─────────5└ ┘──ALARMSTATUS(cvda) └ ┘──COLUMNS(data-area) └ ┘──ENDSTATUS(cvda)

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ──────────5└ ┘──FIELDS(data-area) └ ┘──LINES(data-area) └ ┘──RESPSTATUS(cvda)

5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value) └ ┘──TOCURSOR(data-area)

INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤

└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)

Conditions: INVREQ

FEPI EXTRACT CONV

55─ ──FEPI EXTRACT CONV ──CONVID(data-value) ──┬ ┬────────────── ───────────────────5└ ┘──DEVICE(cvda)

5─ ──┬ ┬────────────── ──┬ ┬───────────────── ──┬ ┬─────────────────── ───────────────5└ ┘──FORMAT(cvda) └ ┘──POOL(data-area) └ ┘──TARGET(data-area)

5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ─5%└ ┘──NODE(data-area) └ ┘──SENSEDATA(data-area)

Conditions: INVREQ

214 CICS User’s Handbook

Page 235: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI EXTRACT FIELD

55─ ──FEPI EXTRACT FIELD ──CONVID(data-value) ──┬ ┬──FIELDLOC(data-value) ──────────5└ ┘──FIELDNUM(data-value)

5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────────── ─────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──BACKGROUND(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ──┬ ┬──────────────────── ─────5└ ┘──COLOR(data-area) └ ┘──FIELDATTR(data-area) └ ┘──HILIGHT(data-area)

5─ ──┬ ┬───────────────────────── ──┬ ┬─────────── ──┬ ┬──────────────────── ─────────5└ ┘──INPUTCONTROL(data-area) └ ┘──MDT(cvda) └ ┘──OUTLINE(data-area)

5─ ──┬ ┬───────────────────── ──┬ ┬─────────────── ──┬ ┬─────────────── ──────────────5└ ┘──POSITION(data-area) └ ┘──PROTECT(cvda) └ ┘──PS(data-area)

5─ ──┬ ┬───────────────── ──┬ ┬───────────────────────── ───────────────────────────5└ ┘──SIZE(data-area) └ ┘──TRANSPARENCY(data-area)

5─ ──┬ ┬─────────────────────── ─5%└ ┘──VALIDATION(data-area)

INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─┤

└ ┘──MAXFLENGTH(data-value) └ ┘──FLENGTH(data-area)

Conditions: INVREQ

FEPI EXTRACT STSN

55─ ──FEPI EXTRACT STSN ──CONVID(data-value) ──┬ ┬───────────────────── ────────────5└ ┘──SEQNUMIN(data-area)

5─ ──┬ ┬────────────────────── ──┬ ┬────────────────── ─5%└ ┘──SEQNUMOUT(data-area) └ ┘──STSNSTATUS(cvda)

Conditions: INVREQ

FEPI FREE

┌ ┐─HOLD────55─ ──FEPI FREE ──CONVID(data-value) ──┼ ┼───────── ─5% ├ ┤─RELEASE─ ├ ┤─FORCE─── └ ┘─PASS────

Conditions: INVREQ

FEPI ISSUE

55─ ──FEPI ISSUE ──CONVID(data-value) ──CONTROL(cvda) ──┬ ┬─────────────────────── ──5└ ┘──SENSEDATA(data-value)

5─ ──┬ ┬───────────── ─5%└ ┘──VALUE(cvda)

Conditions: INVREQ

Chapter 6. FEPI command reference 215

Page 236: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI RECEIVE DATASTREAM

┌ ┐─CHAIN─────55─ ──FEPI RECEIVE DATASTREAM ──CONVID(data-value) ──┼ ┼─────────── ────────────────5 ├ ┤─RU──────── └ ┘─UNTILCDEB─

5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ───────────────────────────────────5└ ┘──ENDSTATUS(cvda) └ ┘──FMHSTATUS(cvda)

5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────────── ─────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──REMFLENGTH(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬───────────────────── ──┬ ┬────────────────────── ────5└ ┘──RESPSTATUS(cvda) └ ┘──SEQNUMIN(data-area) └ ┘──SEQNUMOUT(data-area)

5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)

INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─┤

└ ┘──MAXFLENGTH(data-value) └ ┘──FLENGTH(data-area)

Conditions: INVREQ

FEPI RECEIVE FORMATTED

55─ ──FEPI RECEIVE FORMATTED ──CONVID(data-value) ────────────────────────────────5

5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────── ─────────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──ALARMSTATUS(cvda)

5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ──┬ ┬───────────────── ─────────5└ ┘──COLUMNS(data-area) └ ┘──CURSOR(data-area) └ ┘──ENDSTATUS(cvda)

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ──────────5└ ┘──FIELDS(data-area) └ ┘──LINES(data-area) └ ┘──RESPSTATUS(cvda)

5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)

INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─┤

└ ┘──MAXFLENGTH(data-value) └ ┘──FLENGTH(data-area)

Conditions: INVREQ

FEPI REQUEST PASSTICKET

55─ ──FEPI REQUEST PASSTICKET(data-area) ──CONVID(data-value) ────────────────────5

5─ ──┬ ┬──────────────────── ──┬ ┬────────────────────── ─5%└ ┘──ESMRESP(data-area) └ ┘──ESMREASON(data-area)

Conditions: INVREQ

216 CICS User’s Handbook

Page 237: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI SEND DATASTREAM

55─ ──FEPI SEND DATASTREAM ──CONVID(data-value) ──FROM(data-value) ────────────────5

5─ ──┬ ┬───────────────────── ──┬ ┬──────── ──┬ ┬───── ──┬ ┬───────────────────── ──────5└ ┘──FLENGTH(data-value) └ ┘──INVITE └ ┘──FMH └ ┘──SEQNUMIN(data-area)

5─ ──┬ ┬────────────────────── ─5%└ ┘──SEQNUMOUT(data-area)

Conditions: INVREQ

FEPI SEND FORMATTED

55─ ──FEPI SEND FORMATTED ──CONVID(data-value) ──FROM(data-value) ─────────────────5

5─ ──┬ ┬───────────────────── ──┬ ┬──AID(data-value) ──┬ ┬──────────────────── ─5%└ ┘──FLENGTH(data-value) │ │└ ┘──CURSOR(data-value)

└ ┘ ─KEYSTROKES─ ──┬ ┬──────────────────── ─────└ ┘──ESCAPE(data-value)

Conditions: INVREQ

FEPI START

55─ ──FEPI START ──CONVID(data-value) ──TRANSID(data-value) ───────────────────────5

5─ ──┬ ┬──────────────────── ─────────────────────────────────────────────────────5└ ┘──TERMID(data-value)

5─ ──┬ ┬───────────────────────────────────────────────── ────────────────────────5 └ ┘── ──USERDATA(data-value) ──┬ ┬─────────────────────

└ ┘──FLENGTH(data-value)

5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)

Conditions: INVREQ

Chapter 6. FEPI command reference 217

Page 238: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI system programming

FEPI ADD POOL

┌ ┐─ACQUIRED────────55─ ──FEPI ADD ──POOL(data-value) ──┼ ┼───────────────── ───────────────────────────5

├ ┤──ACQSTATUS(cvda) └ ┘─RELEASED────────

┌ ┐─INSERVICE────────5─ ──┬ ┬────────────────────────────────────────── ──┼ ┼────────────────── ─────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value) ├ ┤──SERVSTATUS(cvda) └ ┘─OUTSERVICE───────

5─ ──┬ ┬────────────────────────────────────────────── ─5% └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value)

Conditions: INVREQ, NOTAUTH

FEPI DELETE POOL

55─ ──FEPI DELETE ──POOL(data-value) ─────────────────────────────────────────────5

5─ ──┬ ┬────────────────────────────────────────── ───────────────────────────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value)

5─ ──┬ ┬────────────────────────────────────────────── ─5% └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value)

Conditions: INVREQ, NOTAUTH

FEPI DISCARD NODELIST

55─ ──FEPI DISCARD ──NODELIST(data-area) ──NODENUM(data-value) ─5%

Conditions: INVREQ, NOTAUTH

FEPI DISCARD POOL

55─ ──FEPI DISCARD ──POOL(data-value) ─5%

Conditions: INVREQ, NOTAUTH

FEPI DISCARD PROPERTYSET

55─ ──FEPI DISCARD ──PROPERTYSET(data-value) ─5%

Conditions: INVREQ, NOTAUTH

218 CICS User’s Handbook

Page 239: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI DISCARD TARGETLIST

55─ ──FEPI DISCARD ──TARGETLIST(data-area) ──TARGETNUM(data-value) ─5%

Conditions: INVREQ, NOTAUTH

FEPI INQUIRE CONNECTION

55─ ──FEPI INQUIRE CONNECTION ──NODE(data-value) ──TARGET(data-value) ─────────────5

5─ ──┬ ┬─────────────────── ──┬ ┬───────────────── ──┬ ┬──────────────────── ─────────5└ ┘──ACQNUM(data-area) └ ┘──ACQSTATUS(cvda) └ ┘──CONVNUM(data-area)

5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────────── ──┬ ┬───────────────── ─────5└ ┘──INSTLSTATUS(cvda) └ ┘──LASTACQCODE(data-area) └ ┘──POOL(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬───────────── ──┬ ┬───────────────────── ─────────────5└ ┘──SERVSTATUS(cvda) └ ┘──STATE(cvda) └ ┘──USERDATA(data-area)

5─ ──┬ ┬──────────────────────── ─5%└ ┘──WAITCONVNUM(data-area)

Conditions:END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE NODE

55─ ──FEPI INQUIRE ──NODE(data-value) ──┬ ┬─────────────────── ─────────────────────5└ ┘──ACQNUM(data-area)

5─ ──┬ ┬───────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────────────── ─────5└ ┘──ACQSTATUS(cvda) └ ┘──INSTLSTATUS(cvda) └ ┘──LASTACQCODE(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬───────────────────── ─5%└ ┘──SERVSTATUS(cvda) └ ┘──USERDATA(data-area)

Conditions:END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE POOL

55─ ──FEPI INQUIRE ──POOL(data-value) ──┬ ┬───────────────────────── ───────────────5└ ┘──BEGINSESSION(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────────── ──────────5└ ┘──CONTENTION(cvda) └ ┘──DEVICE(cvda) └ ┘──ENDSESSION(data-area)

5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────────── ──┬ ┬────────────── ────5└ ┘──EXCEPTIONQ(data-area) └ ┘──FJOURNALNUM(data-area) └ ┘──FORMAT(cvda)

5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┬ ┬─────────────────────── ────5└ ┘──INITIALDATA(cvda) └ ┘──INSTLSTATUS(cvda) └ ┘──MAXFLENGTH(data-area)

5─ ──┬ ┬─────────────── ──┬ ┬──────────────────────── ──┬ ┬────────────────── ────────5└ ┘──MSGJRNL(cvda) └ ┘──PROPERTYSET(data-area) └ ┘──SERVSTATUS(cvda)

5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ──┬ ┬─────────────────── ───────5└ ┘──STSN(data-area) └ ┘──UNSOLDATA(data-area) └ ┘──UNSOLDATACK(cvda)

5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────────── ─5%└ ┘──USERDATA(data-area) └ ┘──WAITCONVNUM(data-area)

Conditions:END, ILLOGIC, INVREQ, NOTAUTH

Chapter 6. FEPI command reference 219

Page 240: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI INQUIRE PROPERTYSET

55─ ──FEPI INQUIRE ──PROPERTYSET(data-value) ──┬ ┬───────────────────────── ────────5└ ┘──BEGINSESSION(data-area)

5─ ──┬ ┬────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────────── ──────────5└ ┘──CONTENTION(cvda) └ ┘──DEVICE(cvda) └ ┘──ENDSESSION(data-area)

5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────────── ──┬ ┬────────────── ────5└ ┘──EXCEPTIONQ(data-area) └ ┘──FJOURNALNUM(data-area) └ ┘──FORMAT(cvda)

5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────────── ──┬ ┬─────────────── ────────5└ ┘──INITIALDATA(cvda) └ ┘──MAXFLENGTH(data-area) └ ┘──MSGJRNL(cvda)

5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ──┬ ┬─────────────────── ─5%└ ┘──STSN(data-area) └ ┘──UNSOLDATA(data-area) └ ┘──UNSOLDATACK(cvda)

Conditions:END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE TARGET

55─ ──FEPI INQUIRE ──TARGET(data-value) ──┬ ┬───────────────── ─────────────────────5└ ┘──APPL(data-area)

5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ─5%└ ┘──INSTLSTATUS(cvda) └ ┘──SERVSTATUS(cvda) └ ┘──USERDATA(data-area)

Conditions:END, ILLOGIC, INVREQ, NOTAUTH

FEPI INSTALL NODELIST

55─ ──FEPI INSTALL ──NODELIST(data-area) ──NODENUM(data-value) ────────────────────5

┌ ┐─ACQUIRED──────── ┌ ┐─INSERVICE────────5─ ──┼ ┼───────────────── ──┬ ┬───────────────────────── ──┼ ┼────────────────── ─5%

├ ┤──ACQSTATUS(cvda) └ ┘──PASSWORDLIST(data-area) ├ ┤──SERVSTATUS(cvda) └ ┘─RELEASED──────── └ ┘─OUTSERVICE───────

Conditions: INVREQ, NOTAUTH

FEPI INSTALL POOL

55─ ──FEPI INSTALL ──POOL(data-value) ──PROPERTYSET(data-value) ───────────────────5

┌ ┐─ACQUIRED────────5─ ──┼ ┼───────────────── ──┬ ┬────────────────────────────────────────── ──────────5

├ ┤──ACQSTATUS(cvda) └ ┘──NODELIST(data-area) ──NODENUM(data-value) └ ┘─RELEASED────────

┌ ┐─INSERVICE────────5─ ──┼ ┼────────────────── ──┬ ┬────────────────────────────────────────────── ─5%

├ ┤──SERVSTATUS(cvda) └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value) └ ┘─OUTSERVICE───────

Conditions: INVREQ, NOTAUTH

220 CICS User’s Handbook

Page 241: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI INSTALL PROPERTYSET

55─ ──FEPI INSTALL ──PROPERTYSET(data-value) ──┬ ┬────────────────────────── ───────5└ ┘──BEGINSESSION(data-value)

┌ ┐─LOSE───────────── ┌ ┐─T3278M2──────5─ ──┼ ┼────────────────── ──┼ ┼────────────── ──┬ ┬──────────────────────── ─────────5

├ ┤──CONTENTION(cvda) ├ ┤──DEVICE(cvda) └ ┘──ENDSESSION(data-value) └ ┘─WIN────────────── ├ ┤─T3278M3────── ├ ┤─T3278M4────── ├ ┤─T3278M5────── ├ ┤─T3279M2────── ├ ┤─T3279M3────── ├ ┤─T3279M4────── ├ ┤─T3279M5────── ├ ┤─TPS55M2────── ├ ┤─TPS55M3────── ├ ┤─TPS55M4────── └ ┘─LUP──────────

5─ ──┬ ┬──────────────────────── ──┬ ┬───────────────────────── ────────────────────5└ ┘──EXCEPTIONQ(data-value) └ ┘──FJOURNALNUM(data-value)

┌ ┐─FORMATTED──── ┌ ┐─NOTINBOUND────────5─ ──┼ ┼────────────── ──┼ ┼─────────────────── ──┬ ┬──────────────────────── ────────5

├ ┤──FORMAT(cvda) ├ ┤──INITIALDATA(cvda) └ ┘──MAXFLENGTH(data-value) └ ┘─DATASTREAM─── └ ┘─INBOUND───────────

┌ ┐─NOMSGJRNL─────5─ ──┼ ┼─────────────── ──┬ ┬────────────────── ────────────────────────────────────5

├ ┤──MSGJRNL(cvda) └ ┘──STSN(data-value) ├ ┤─INPUT───────── ├ ┤─OUTPUT──────── └ ┘─INOUT─────────

5─ ──┬ ┬────────────────────────────────────────────── ─5% │ │┌ ┐─NEGATIVE────────── └ ┘──UNSOLDATA(data-value) ──┼ ┼──UNSOLDATACK(cvda) └ ┘─POSITIVE──────────

Conditions: INVREQ, NOTAUTH

FEPI INSTALL TARGETLIST

55─ ──FEPI INSTALL ──TARGETLIST(data-area) ──APPLLIST(data-area) ──────────────────5

┌ ┐─INSERVICE────────5─ ──TARGETNUM(data-value) ──┼ ┼────────────────── ─5%

├ ┤──SERVSTATUS(cvda) └ ┘─OUTSERVICE───────

Conditions: INVREQ, NOTAUTH

Chapter 6. FEPI command reference 221

Page 242: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI SET CONNECTION

55─ ──FEPI SET CONNECTION ──┬ ┬──NODE(data-value) ──────────────────────── ─────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value)

5─ ──┬ ┬──TARGET(data-value) ────────────────────────── ──┬ ┬───────────────── ──────5 └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value) ├ ┤──ACQSTATUS(cvda) ├ ┤─ACQUIRED──────── └ ┘─RELEASED────────

5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)

├ ┤─INSERVICE──────── └ ┘─OUTSERVICE───────

Conditions: INVREQ, NOTAUTH

FEPI SET NODE

55─ ──FEPI SET ──┬ ┬──NODE(data-value) ──────────────────────── ────────────────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value)

5─ ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──ACQSTATUS(cvda) ├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)

├ ┤─ACQUIRED──────── ├ ┤─INSERVICE──────── └ ┘─RELEASED──────── └ ┘─OUTSERVICE───────

Conditions: INVREQ, NOTAUTH

FEPI SET POOL

55─ ──FEPI SET ──┬ ┬──POOL(data-value) ──────────────────────── ────────────────────5 └ ┘──POOLLIST(data-area) ──POOLNUM(data-value)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)

├ ┤─INSERVICE──────── └ ┘─OUTSERVICE───────

Conditions: INVREQ, NOTAUTH

FEPI SET TARGET

55─ ──FEPI SET ──┬ ┬──TARGET(data-value) ────────────────────────── ────────────────5 └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value)

5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)

├ ┤─INSERVICE──────── └ ┘─OUTSERVICE───────

Conditions: INVREQ, NOTAUTH

222 CICS User’s Handbook

Page 243: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

FEPI SP NOOP

55─ ──FEPI SP NOOP ─5%

Conditions: INVREQ, NOTAUTH

Chapter 6. FEPI command reference 223

Page 244: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

FEPI programming

224 CICS User’s Handbook

Page 245: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Chapter 7. CICS-value data areas used by allcommands

This section lists the CICS-value data-area (CVDA) values and their numericequivalents for all of the EXEC CICS commands. CVDAs are described inthe CICS System Programming Reference.

This section consists of three tables:

� one, in alphabetic sequence of the CVDA values;� one, (beginning on page 233) in numeric sequence of the CVDA

values;� and one, (beginning on page 240) gives the CVDA values returned by

the INQUIRE TERMINAL|NETNAME DEVICE command.

CVDAs and numeric values in alphabetic sequenceCVDA Value CVDA Value

ABEND 900 ASSEMBLER 150ACQFAIL 515 ATI 75ACQUIRED 69 ATTENTION 524ACQUIRING 71 AUDALARM 395ACTIVE 181 AUTOACTIVE 630

| ACTIVITY| 1002 AUTOARCH 262ADD 291 AUTOCONN 170ADDABLE 41 AUTOINACTIVE 631ADDFAIL 519 AUTOPAGEABLE 80ADVANCE 265 AUTOSTART 618ALARM 501 AUXILIARY 247ALLCONN 169 AUXPAUSE 313ALLOCATED 81 AUXSTART 312ALLQUERY 431 AUXSTOP 314ALTERABLE 52 AVAILABLE 95ALTERNATE 197 BACKOUT 192ALTPRTCOPY 446 BACKTRANS 397

| AND| 1005 BACKUPNONBWO 800ANY 158 BASE 10APLKYBD 391| BASEAPI| 1052APLTEXT 393 BASESPACE 664APPC 124 BDAM 2APPCPARALLEL 374 BEGINSESSION 510APPCSINGLE 373 BELOW 159

| APPEND| 1036 BGAM 63APPLICATION 559| BINARY| 1038ASACTL 224 BLK 47ASCII7 616 BLOCKED 16ASCII8 617 BROWSABLE 39

Copyright IBM Corp. 1989, 1999 225

Page 246: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA Value CVDA Value

BSAM 61 CONVERSE 600BTAM 62 CONVIDLE 518BUSY 612 COORDINATOR 770C 149 COPID 908CACHE 791 COPY 401CANCEL 526 CREATE 67CANCELLED 624 CSIGN 905

| CANCELLING| 1025 CTERM 906CD 491 CTLGALL 632CEDF 370 CTLGMODIFY 633

| CFTABLE| 833 CTLGNONE 634CGROUP 902 CTRLABLE 56CICS 660 CTX 907CICSDATAKEY 379 CURRENT 260CICSEXECKEY 381 CUSERID 909CICSTABLE 101 DAE 684

| CKOPEN| 1055 DATA 508CLEAR 640 DATASET 756

| CLIENTAUTH| 1032 DATASETFULL 793CLOSED 19 DATASTREAM 543CLOSELEAVE 261 DEADLOCK 794CLOSEREQUEST 22| DEBUG| 1082CLOSING 21 DEC 46CMDPROT 673 DEFAULT 198CMDSECNO 205 DEFRESP1 497CMDSECYES 207 DEFRESP1OR2 528COBOL 151 DEFRESP2 498COBOLII 375 DEFRESP3 499COLD 788 DELAY 637COLDACQ 72 DELETABLE 43COLDQUERY 433| DELETE| 292COLDSTART 266 DELETEFAIL 520COLOR 399 DELEXITERROR 795COMMIT 208 DEREGERROR 679COMMITFAIL 792 DEREGISTERED 678

| COMPLETE| 1026 DEST 235| COMPOSITE| 1003 DISABLED 24

CONFFREE 82 DISABLING 25CONFRECEIVE 83 DISCARDFAIL 513CONFSEND 84 DISCREQ 444CONNECT 903 DISCONNING 910CONNECTED 690 DISK1 252CONNECTING 904 DISK2 253CONNECTION 755 DISK2PAUSE 254CONSISTENT 723 DISPATCHABLE 228CONSOLE 66| DORMANT| 1024

| CONTENTION| 836 DPLSUBSET 383CONTROLSHUT 623 DS3270 615

226 CICS User’s Handbook

Page 247: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA Value CVDA Value

DUALCASE 403 FORMFEED 407DUMMY 781 FOUTPUT 271DYNAMIC 178 FREE 85EB 490 FREEING 94

| EBCDIC| 1039 FULL 212EMERGENCY 268 FULLAPI 384EMPTY 210| FULLAUTO| 1073EMPTYREQ 31 FWDRECOVABLE 354ENABLED 23 GENERIC 651ENDAFFINITY 790 GMT 604EQUAL 911 GOINGOUT 172ESDS 5 GROUP 913EVENT 334 GTFSTART 317

| EVENTFAIL| 1012 GTFSTOP 318EXCEPT 332 HEURBACKOUT 758EXCEPTRESP 523 HEURCOMMIT 757EXCI 650 HEX 45EXCTL 48 HFORM 409EXECENQ 751 HIGH 914EXECENQADDR 752 HILIGHT 413EXIT 912 HOLD 163EXITTRACE 362| HTTPNO| 1034

| EXPIRED| 1017| HTTPYES| 1033EXTENDEDDS 405 IGNORE 1EXTRA 221 IGNORERR 816EXTSECURITY 194 IMMCLOSE 350FAILED 782 IMMCLOSING 352FAILEDBKOUT 357 IMMQUIESCED 706FAILINGBKOUT 358 INACTIVE 378FCLOSE 273 INBOUND 547FINALQUIESCE 183| INCOMPLETE| 1014FINPUT 270 INDEXRECFULL 796

| FIRED| 1001 INDIRECT 122FIRSTINIT 625 INDOUBT 620FIRSTQUIESCE 182 INFLIGHT 621FIXED 12 INITCOMPLETE 628FLUSH 783 INITIAL 789FMH 502 INOUT 532FMHPARM 385 INPUT 226FOPEN 272 INSERVICE 73FORCE 342 INSTALLED 550

| FORCECANCEL| 655 INSTALLFAIL 512FORCECLOSE 351| INTERNAL| 1058FORCECLOSING 353 INTRA 222

| FORCED| 1013 INTSTART 310FORCEPURGE 237 INTSTOP 311FORMATEDF 606 INVALID 359FORMATTED 542 IOERROR 797

Chapter 7. CICS-value data areas used by all commands 227

Page 248: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA Value CVDA Value

IRC 121 NOCMDPROT 674ISOLATE 658 NOCOLOR 400

| JVM| 1080 NOCONNECT 916KATAKANA 415 NOCONV 556KEYED 8 NOCONVERSE 601KSDS 6 NOCOPY 402

| LCKSTRUCFULL| 832 NOCREATE 68LEAVE 811 NOCTL 223LE370 377 NODAE 685LIC 493| NODEBUG| 1083LIGHTPEN 417 NODISCREQ 445

| LOAD| 834 NODUALCASE 404LOCAL 605 NOEMPTYREQ 32

| LOCKING| 837 NOEVENT 335LOG 54 NOEXCEPT 333LOGICAL 216 NOEXCTL 49LOGTERM 269 NOEXIT 917LOSE 544 NOEXITTRACE 363LOW 915 NOEXTENDEDDS 406LPA 165 NOFMH 503LUP 541 NOFMHPARM 386LUSTAT 525| NOFORCE| 1054LU61 125 NOFORMATEDF 607MAIN 248 NOFORMFEED 408MAP 155 NOHFORM 410MAPSET 155 NOHILIGHT 414MCHCTL 241 NOHOLD 164MDT 506 NOISOLATE 657MOD 813| NOJVM| 1081MODEL 370 NOKATAKANA 416MORE 492 NOLIGHTPEN 418MSRCONTROL 419| NOLOAD| 835MVS 780 NOLOG 55NEGATIVE 530 NOLOSTLOCKS 710NEWCOPY 167 NOMDT 507NEWSESSION 485 NOMSGJRNL 531NOALARM 500 NOMSRCONTROL 420NOALTPRTCOPY 447 NONAUTOCONN 171NOAPLKYBD 392 NONCICS 661NOAPLTEXT 394 NONE 496

| NOAPPEND| 1037| NONLE370| 1084NOATI 76 NOOBFORMAT 422NOAUDALARM 396 NOOBOPERID 388

| NOAUTO| 1071 NOOUTLINE 424NOAUTOARCH 263 NOPARTITIONS 426NOBACKTRANS 398 NOPERF 331NOCEDF 371 NOPRESETSEC 243NOCLEAR 641 NOPRINTADAPT 428

228 CICS User’s Handbook

Page 249: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA Value CVDA Value

NOPROGSYMBOL 430 NOTRANDUMP 187NOPRTCOPY 449 NOTREADABLE 36NOQUERY 432 NOTREADY 259NORECOVDATA 700 NOTRECOVABLE 30NOREENTPROT 681 NOTREQUIRED 667NORELEASE 918 NOTRLS 721NORELREQ 443| NOTROUTABLE| 1022NORETAINED 711 NOTSOS 669

| NORMAL| 1016 NOTSUPPORTED 15NORMALBKOUT 356| NOTSUSPENDED| 1027NORMALRESP 522 NOTTABLE 100NOROLLBACK 919 NOTTI 78NOSECURITY 196 NOTUPDATABLE 38NOSHUTDOWN 289 NOTWAIT 920NOSOSI 435 NOUCTRAN 451NOSPI 694| NOUSER| 1011

| NOSSL| 1031 NOVALIDATION 441NOSTSN 487 NOVFORM 412NOSWITCH 285 NOWAIT 341NOSYNCPOINT 603 NOWRITE 275NOSYSCONNECT 654 NOZCPTRACE 365NOSYSDUMP 185 NRS 774NOSYSLOG 784 N906 931NOTADDABLE 42 N906D 921NOTALTERABLE 53 OBFORMAT 421NOTAPPLIC 1 OBOPERID 387NOTASKSTART 608 OBTAINING 96NOTBROWSABLE 40 OFF 200NOTBUSY 613 OK 274NOTCDEB 495 OLD 26NOTCONNECTED 691 OLDCOPY 162NOTCTRLABLE 57 OLDSESSION 486NOTDEFINED 659 ON 201NOTDELETABLE 44 OPEN 18

| NOTDYNAMIC| 1021| OPENAPI| 1053NOTEMPTY 211 OPENERROR 798NOTERMINAL 214 OPENING 20NOTEXTKYBD 437 OPENOUTPUT 257NOTEXTPRINT 439 OPID 933

| NOTFIRED| 1000| OR| 1006NOTFWDRCVBLE 361 OUTLINE 423NOTINBOUND 546 OUTPUT 227NOTINIT 376 OUTSERVICE 74NOTINSTALLED 551 OWNER 753NOTKEYED 9 PAGEABLE 79NOTLPA 166 PARTITIONS 425NOTPENDING 127 PARTITIONSET 156NOTPURGEABLE 161 PATH 11

Chapter 7. CICS-value data areas used by all commands 229

Page 250: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA Value CVDA Value

PENDBEGIN 558 REGISTERED 670PENDDATA 560 REJECT 815PENDFREE 86 RELATED 675PENDING 126 RELEASE 563PENDPASS 565 RELEASED 70PENDRECEIVE 87 RELEASING 549PENDRELEASE 562 RELREQ 442PENDSTART 561 REMLOSTLOCKS 713PENDSTSN 557 REMOTE 4PENDUNSOL 564 REMOVE 276PERF 330 REMSESSION 740PHASEIN 168| REMTABLE| 103PHYSICAL 215 REPEATABLE 724PLI 152 REQUIRED 666PL1 152 REREAD 812POOL 922 RESET 290POSITIVE 529 RESETLOCKS 714POST 636| RESSECINT| 203PRESETSEC 242 RESSECNO 202PRIMARY 110 RESSECYES 204PRINTADAPT 427 RESYNC 702PRIVATE 174 RETAINED 715

| PROCESS| 1010 RETRY 716| PROGAUTO| 1072 REVERTED 264

PROGRAM 154 REWIND 811PROGSYMBOL 429 RLS 720PROTECTED 504 RLSACTIVE 730PRTCOPY 448 RLSGONE 799PURGE 236 RLSINACTIVE 731PURGEABLE 160 RLSSERVER 761

| QUASIRENT| 1050 RMI 771QUEUE 814 ROLLBACK 89QUIESCED 707 ROUTE 638QUIESCING 708| ROUTABLE| 1023

| QR| 1057| RRCOMMITFAIL| 830READABLE 35 RRDS 7READBACK 209| RRINDOUBT| 831READONLY 275 RTR 527READY 258 RU 494REBUILD 923 RUNNING 229RECEIVE 88 SCS 614RECONNECT 924 SECONDINIT 626RECOVDATA 701 SEND 90RECOVERABLE 29 SESSION 372RECOVERED 277 SESSIONFAIL 517RECOVERLOCKS 712 SESSIONLOST 516REENTPROT 680 SETFAIL 514REGERROR 677 SHARE 27

230 CICS User’s Handbook

Page 251: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA Value CVDA Value

SHARED 173 SYSTEM 643SHUNTED 762 SYSTEMOFF 320SHUTDISABLED 645 SYSTEMON 319SHUTDOWN 288 TAKEOVER 111SHUTENABLED 644 TAPE1 250SIGN 925 TAPE2 251SIGNEDOFF 245 TASK 233SIGNEDON 244 TASKSTART 611SINGLEOFF 324 TCAM 64SINGLEON 323 TCAMSNA 65SKIP 810 TCEXITALL 366SMF 255 TCEXITALLOFF 369SOS 668 TCEXITNONE 368SOSABOVE 683 TCEXITSYSTEM 367SOSBELOW 682 TDQ 767SOSI 434 TERM 234SPECIFIC 652 TERMINAL 213SPECTRACE 177 TEXTKYBD 436SPI 693 TEXTPRINT 438SPRSTRACE 175 THIRDINIT 627SQLCODE 926| THREADSAFE| 1051

| SSL| 1030 TIMEOUT 511STANDBY 629| TIMER| 1004STANTRACE 176 TPOOL 932START 635 TPS55M3 553STARTED 609 TPS55M4 554STARTING 772 TPS55M5 555STARTUP 180 TRANDUMP 186STATIC 179 TRANIDONLY 452STOPPED 610 TSQ 768STSN 509 TTI 77STSNSET 488 TX 929STSNTEST 489 TXID 928SUBORDINATE 773 TWAIT 927SUBSPACE 663 T3278M2 533SURROGATE 371 T3278M3 534SUSPENDED 231 T3278M4 535SWITCH 188 T3278M5 536SWITCHALL 287 T3279M2 537SWITCHING 225 T3279M3 538SWITCHNEXT 286 T3279M4 539SYNCFREE 91 T3279M5 540

| SYNCPOINT| 602 UCTRAN 450SYNCRECEIVE 92| UKOPEN| 1056SYNCSEND 93| UNATTEMPTED| 820SYSCONNECT 653 UNAVAILABLE 672SYSDUMP 184 UNBLOCKED 17SYSLOG 785 UNCOMMITTED 722

Chapter 7. CICS-value data areas used by all commands 231

Page 252: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDA Value

| UNCONNECTED| 703UNDEFINED 14UNDETERMINED 355UNENABLED 33

| UNENABLING| 34| UNEXPECTED| 1015| UNEXPIRED| 1018

UNPROTECTED 505UNQUIESCED 709UNREGISTERED 671UNSOLDATA 521

| UOW| 246UPDATABLE 37USER 642USERDATAKEY 380USEREXECKEY 382USERID 930USEROFF 322USERON 321USERTABLE 102VALID 360VALIDATION 440VARIABLE 13VFORM 411VRRDS 732VSAM 3VTAM 60WAIT 340WAITCOMMIT 763WAITER 754WAITFORGET 622WAITING 765WAITRMI 766WARMSTART 267WIN 545XCF 665XM 123XNOTDONE 144XOK 143ZCPTRACE 364

232 CICS User’s Handbook

Page 253: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

CVDAs and numeric values in numeric sequenceValue CVDA Value CVDA

1 IGNORE 47 BLK1 NOTAPPLIC 48 EXCTL2 BDAM 49 NOEXCTL3 VSAM 52 ALTERABLE4 REMOTE 53 NOTALTERABLE5 ESDS 54 LOG6 KSDS 55 NOLOG7 RRDS 56 CTRLABLE8 KEYED 57 NOTCTRLABLE9 NOTKEYED 60 VTAM

10 BASE 61 BSAM11 PATH 62 BTAM12 FIXED 63 BGAM13 VARIABLE 64 TCAM14 UNDEFINED 65 TCAMSNA15 NOTSUPPORTED 66 CONSOLE16 BLOCKED 67 CREATE17 UNBLOCKED 68 NOCREATE18 OPEN 69 ACQUIRED19 CLOSED 70 RELEASED20 OPENING 71 ACQUIRING21 CLOSING 72 COLDACQ22 CLOSEREQUEST 73 INSERVICE23 ENABLED 74 OUTSERVICE24 DISABLED 75 ATI25 DISABLING 76 NOATI26 OLD 77 TTI27 SHARE 78 NOTTI29 RECOVERABLE 79 PAGEABLE30 NOTRECOVABLE 80 AUTOPAGEABLE31 EMPTYREQ 81 ALLOCATED32 NOEMPTYREQ 82 CONFFREE33 UNENABLED 83 CONFRECEIVE

| 34| UNENABLING 84 CONFSEND35 READABLE 85 FREE36 NOTREADABLE 86 PENDFREE37 UPDATABLE 87 PENDRECEIVE38 NOTUPDATABLE 88 RECEIVE39 BROWSABLE 89 ROLLBACK40 NOTBROWSABLE 90 SEND41 ADDABLE 91 SYNCFREE42 NOTADDABLE 92 SYNCRECEIVE43 DELETABLE 93 SYNCSEND44 NOTDELETABLE 94 FREEING45 HEX 95 AVAILABLE46 DEC 96 OBTAINING

Chapter 7. CICS-value data areas used by all commands 233

Page 254: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Value CVDA Value CVDA

100 NOTTABLE 182 FIRSTQUIESCE101 CICSTABLE 183 FINALQUIESCE102 USERTABLE 184 SYSDUMP

| 103| REMTABLE 185 NOSYSDUMP110 PRIMARY 186 TRANDUMP111 TAKEOVER 187 NOTRANDUMP121 IRC 188 SWITCH122 INDIRECT 192 BACKOUT123 XM 194 EXTSECURITY124 APPC 196 NOSECURITY125 LU61 197 ALTERNATE126 PENDING 198 DEFAULT127 NOTPENDING 200 OFF143 XOK 201 ON144 XNOTDONE 202 RESSECNO149 C | 203| RESSECINT150 ASSEMBLER 204 RESSECYES151 COBOL 205 CMDSECNO152 PLI 207 CMDSECYES152 PL1 208 COMMIT154 PROGRAM 209 READBACK155 MAP 210 EMPTY155 MAPSET 211 NOTEMPTY156 PARTITIONSET 212 FULL158 ANY 213 TERMINAL159 BELOW 214 NOTERMINAL160 PURGEABLE 215 PHYSICAL161 NOTPURGEABLE 216 LOGICAL162 OLDCOPY 221 EXTRA163 HOLD 222 INTRA164 NOHOLD 223 NOCTL165 LPA 224 ASACTL166 NOTLPA 225 SWITCHING167 NEWCOPY 226 INPUT168 PHASEIN 227 OUTPUT169 ALLCONN 228 DISPATCHABLE170 AUTOCONN 229 RUNNING171 NONAUTOCONN 231 SUSPENDED172 GOINGOUT 233 TASK173 SHARED 234 TERM174 PRIVATE 235 DEST175 SPRSTRACE 236 PURGE176 STANTRACE 237 FORCEPURGE177 SPECTRACE 241 MCHCTL178 DYNAMIC 242 PRESETSEC179 STATIC 243 NOPRESETSEC180 STARTUP 244 SIGNEDON181 ACTIVE 245 SIGNEDOFF

234 CICS User’s Handbook

Page 255: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Value CVDA Value CVDA

| 246| UOW 321 USERON247 AUXILIARY 322 USEROFF248 MAIN 323 SINGLEON250 TAPE1 324 SINGLEOFF251 TAPE2 330 PERF252 DISK1 331 NOPERF253 DISK2 332 EXCEPT254 DISK2PAUSE 333 NOEXCEPT255 SMF 334 EVENT257 OPENOUTPUT 335 NOEVENT258 READY 340 WAIT259 NOTREADY 341 NOWAIT260 CURRENT 342 FORCE261 CLOSELEAVE 350 IMMCLOSE262 AUTOARCH 351 FORCECLOSE263 NOAUTOARCH 352 IMMCLOSING264 REVERTED 353 FORCECLOSING265 ADVANCE 354 FWDRECOVABLE266 COLDSTART 355 UNDETERMINED267 WARMSTART 356 NORMALBKOUT268 EMERGENCY 357 FAILEDBKOUT269 LOGTERM 358 FAILINGBKOUT270 FINPUT 359 INVALID271 FOUTPUT 360 VALID272 FOPEN 361 NOTFWDRCVBLE273 FCLOSE 362 EXITTRACE274 OK 363 NOEXITTRACE275 NOWRITE 364 ZCPTRACE275 READONLY 365 NOZCPTRACE276 REMOVE 366 TCEXITALL277 RECOVERED 367 TCEXITSYSTEM285 NOSWITCH 368 TCEXITNONE286 SWITCHNEXT 369 TCEXITALLOFF287 SWITCHALL 370 CEDF288 SHUTDOWN 370 MODEL289 NOSHUTDOWN 371 NOCEDF290 RESET 371 SURROGATE291 ADD 372 SESSION

| 292| DELETE 373 APPCSINGLE310 INTSTART 374 APPCPARALLEL311 INTSTOP 375 COBOLII312 AUXSTART 376 NOTINIT313 AUXPAUSE 377 LE370314 AUXSTOP 378 INACTIVE317 GTFSTART 379 CICSDATAKEY318 GTFSTOP 380 USERDATAKEY319 SYSTEMON 381 CICSEXECKEY320 SYSTEMOFF 382 USEREXECKEY

Chapter 7. CICS-value data areas used by all commands 235

Page 256: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Value CVDA Value CVDA

383 DPLSUBSET 433 COLDQUERY384 FULLAPI 434 SOSI385 FMHPARM 435 NOSOSI386 NOFMHPARM 436 TEXTKYBD387 OBOPERID 437 NOTEXTKYBD388 NOOBOPERID 438 TEXTPRINT391 APLKYBD 439 NOTEXTPRINT392 NOAPLKYBD 440 VALIDATION393 APLTEXT 441 NOVALIDATION394 NOAPLTEXT 442 RELREQ395 AUDALARM 443 NORELREQ396 NOAUDALARM 444 DISCREQ397 BACKTRANS 445 NODISCREQ398 NOBACKTRANS 446 ALTPRTCOPY399 COLOR 447 NOALTPRTCOPY400 NOCOLOR 448 PRTCOPY401 COPY 449 NOPRTCOPY402 NOCOPY 450 UCTRAN403 DUALCASE 451 NOUCTRAN404 NODUALCASE 452 TRANIDONLY405 EXTENDEDDS 485 NEWSESSION406 NOEXTENDEDDS 486 OLDSESSION407 FORMFEED 487 NOSTSN408 NOFORMFEED 488 STSNSET409 HFORM 489 STSNTEST410 NOHFORM 490 EB411 VFORM 491 CD412 NOVFORM 492 MORE413 HILIGHT 493 LIC414 NOHILIGHT 494 RU415 KATAKANA 495 NOTCDEB416 NOKATAKANA 496 NONE417 LIGHTPEN 497 DEFRESP1418 NOLIGHTPEN 498 DEFRESP2419 MSRCONTROL 499 DEFRESP3420 NOMSRCONTROL 500 NOALARM421 OBFORMAT 501 ALARM422 NOOBFORMAT 502 FMH423 OUTLINE 503 NOFMH424 NOOUTLINE 504 PROTECTED425 PARTITIONS 505 UNPROTECTED426 NOPARTITIONS 506 MDT427 PRINTADAPT 507 NOMDT428 NOPRINTADAPT 508 DATA429 PROGSYMBOL 509 STSN430 NOPROGSYMBOL 510 BEGINSESSION431 ALLQUERY 511 TIMEOUT432 NOQUERY 512 INSTALLFAIL

236 CICS User’s Handbook

Page 257: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Value CVDA Value CVDA

513 DISCARDFAIL 562 PENDRELEASE514 SETFAIL 563 RELEASE515 ACQFAIL 564 PENDUNSOL516 SESSIONLOST 565 PENDPASS517 SESSIONFAIL 600 CONVERSE518 CONVIDLE 601 NOCONVERSE519 ADDFAIL 602 SYNCPOINT520 DELETEFAIL 603 NOSYNCPOINT521 UNSOLDATA 604 GMT522 NORMALRESP 605 LOCAL523 EXCEPTRESP 606 FORMATEDF524 ATTENTION 607 NOFORMATEDF525 LUSTAT 608 NOTASKSTART526 CANCEL 609 STARTED527 RTR 610 STOPPED528 DEFRESP1OR2 611 TASKSTART529 POSITIVE 612 BUSY530 NEGATIVE 613 NOTBUSY531 NOMSGJRNL 614 SCS532 INOUT 615 DS3270533 T3278M2 616 ASCII7534 T3278M3 617 ASCII8535 T3278M4 618 AUTOSTART536 T3278M5 620 INDOUBT537 T3279M2 621 INFLIGHT538 T3279M3 622 WAITFORGET539 T3279M4 623 CONTROLSHUT540 T3279M5 624 CANCELLED541 LUP 625 FIRSTINIT542 FORMATTED 626 SECONDINIT543 DATASTREAM 627 THIRDINIT544 LOSE 628 INITCOMPLETE545 WIN 629 STANDBY546 NOTINBOUND 630 AUTOACTIVE547 INBOUND 631 AUTOINACTIVE549 RELEASING 632 CTLGALL550 INSTALLED 633 CTLGMODIFY551 NOTINSTALLED 634 CTLGNONE552 TPS55M2 635 START553 TPS55M3 636 POST554 TPS55M4 637 DELAY555 TPS55M5 638 ROUTE556 NOCONV 640 CLEAR557 PENDSTSN 641 NOCLEAR558 PENDBEGIN 642 USER559 APPLICATION 643 SYSTEM560 PENDDATA 644 SHUTENABLED561 PENDSTART 645 SHUTDISABLED

Chapter 7. CICS-value data areas used by all commands 237

Page 258: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Value CVDA Value CVDA

650 EXCI 713 REMLOSTLOCKS651 GENERIC 714 RESETLOCKS652 SPECIFIC 715 RETAINED653 SYSCONNECT 716 RETRY654 NOSYSCONNECT 720 RLS655 FORCECANCEL 721 NOTRLS657 NOISOLATE 722 UNCOMMITTED658 ISOLATE 723 CONSISTENT659 NOTDEFINED 724 REPEATABLE660 CICS 730 RLSACTIVE661 NONCICS 731 RLSINACTIVE663 SUBSPACE 732 VRRDS664 BASESPACE 740 REMSESSION665 XCF 751 EXECENQ666 REQUIRED 752 EXECENQADDR667 NOTREQUIRED 753 OWNER668 SOS 754 WAITER669 NOTSOS 755 CONNECTION670 REGISTERED 756 DATASET671 UNREGISTERED 757 HEURCOMMIT672 UNAVAILABLE 758 HEURBACKOUT673 CMDPROT 761 RLSSERVER674 NOCMDPROT 762 SHUNTED675 RELATED 763 WAITCOMMIT677 REGERROR 765 WAITING678 DEREGISTERED 766 WAITRMI679 DEREGERROR 767 TDQ680 REENTPROT 768 TSQ681 NOREENTPROT 770 COORDINATOR682 SOSBELOW 771 RMI683 SOSABOVE 772 STARTING684 DAE 773 SUBORDINATE685 NODAE 774 NRS690 CONNECTED 780 MVS691 NOTCONNECTED 781 DUMMY693 SPI 782 FAILED694 NOSPI 783 FLUSH700 NORECOVDATA 784 NOSYSLOG701 RECOVDATA 785 SYSLOG702 RESYNC 788 COLD703 UNCONNECTED 789 INITIAL706 IMMQUIESCED 790 ENDAFFINITY707 QUIESCED 791 CACHE708 QUIESCING 792 COMMITFAIL709 UNQUIESCED 793 DATASETFULL710 NOLOSTLOCKS 794 DEADLOCK711 NORETAINED 795 DELEXITERROR712 RECOVERLOCKS 796 INDEXRECFULL

238 CICS User’s Handbook

Page 259: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Value CVDA Value CVDA

797 IOERROR 928 TXID798 OPENERROR 929 TX799 RLSGONE 930 USERID800 BACKUPNONBWO 931 N906810 SKIP 932 TPOOL811 REWIND 933 OPID811 LEAVE | 1000| NOTFIRED812 REREAD | 1001| FIRED813 MOD | 1002| ACTIVITY814 QUEUE | 1003| COMPOSITE815 REJECT | 1004| TIMER816 IGNORERR | 1005| AND820 UNATTEMPTED | 1006| OR830 RRCOMMITFAIL | 1010| PROCESS831 RRINDOUBT | 1011| NOUSER832 LCKSTRUCFULL | 1012| EVENTFAIL

| 833| CFTABLE | 1013| FORCED| 834| LOAD | 1014| INCOMPLETE| 835| NOLOAD | 1015| UNEXPECTED| 836| CONTENTION | 1016| NORMAL| 837| LOCKING | 1017| EXPIRED

900 ABEND | 1018| UNEXPIRED902 CGROUP | 1021| NOTDYNAMIC903 CONNECT | 1022| NOTROUTABLE904 CONNECTING | 1023| ROUTABLE905 CSIGN | 1024| DORMANT906 CTERM | 1025| CANCELLING907 CTX | 1026| COMPLETE908 COPID | 1027| NOTSUSPENDED909 CUSERID | 1030| SSL910 DISCONNING | 1031| NOSSL911 EQUAL | 1032| CLIENTAUTH912 EXIT | 1033| HTTPYES913 GROUP | 1034| HTTPNO914 HIGH | 1036| APPEND915 LOW | 1037| NOAPPEND916 NOCONNECT | 1038| BINARY917 NOEXIT | 1039| EBCDIC918 NORELEASE | 1050| QUASIRENT919 NOROLLBACK | 1051| THREADSAFE920 NOTWAIT | 1052| BASEAPI921 N906D | 1053| OPENAPI922 POOL | 1054| NOFORCE923 REBUILD | 1055| CKOPEN924 RECONNECT | 1056| UKOPEN925 SIGN | 1057| QR926 SQLCODE | 1058| INTERNAL927 TWAIT | 1071| NOAUTO

Chapter 7. CICS-value data areas used by all commands 239

Page 260: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Value CVDA

| 1072| PROGAUTO| 1073| FULLAUTO| 1080| JVM| 1081| NOJVM| 1082| DEBUG| 1083| NODEBUG| 1084| NONLE370

CVDA values for the DEVICE optionCVDA sequence CVDA sequence

BATCHLU 191 T3277L 153BIPROG 160 T3277R 145BISYNCH 128 T3284L 155CDRDLPRT 24 T3284R 147CONTNLU 189 T3286L 156HARDCOPY 32 T3286R 148INTACTLU 190 T3600BI 138ISCMMCONV 209 T3601 177LUCMODGRP 210 T3614 178LUCSESS 211 T3650ATT 186LUTYPE4 193 T3650PIPE 184LUTYPE6 192 T3650USER 187MAGTAPE 20 T3653HOST 185RESSYS 208 T3735 136SDLC 176 T3740 137SEQDISK 18 T3780 133SYSTEM3 161 T3790 180SYSTEM7 2 T3790SCSP 182SYS370 164 T3790UP 181SYS7BSCA 166 T7770 1TCONSOLE 8 VIDEOTERM 64TELETYPE 34TTCAM 80TWX3335 33T1050 36T1053 74T2260L 65T2260R 72T2265 76T2740 40T2741BCD 43T2741COR 42T2770 130T2780 132T2980 134T3275R 146

240 CICS User’s Handbook

Page 261: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Numeric sequence Numeric sequence

1 T7770 189 CONTNLU2 SYSTEM7 190 INTACTLU8 TCONSOLE 191 BATCHLU

18 SEQDISK 192 LUTYPE620 MAGTAPE 193 LUTYPE424 CDRDLPRT 208 RESSYS32 HARDCOPY 209 ISCMMCONV33 TWX3335 210 LUCMODGRP34 TELETYPE 211 LUCSESS36 T105040 T274042 T2741COR43 T2741BCD64 VIDEOTERM65 T2260L72 T2260R74 T105376 T226580 TTCAM

128 BISYNCH130 T2770132 T2780133 T3780134 T2980136 T3735137 T3740138 T3600BI145 T3277R146 T3275R147 T3284R148 T3286R153 T3277L155 T3284L156 T3286L160 BIPROG161 SYSTEM3164 SYS370166 SYS7BSCA176 SDLC177 T3601178 T3614180 T3790181 T3790UP182 T3790SCSP184 T3650PIPE185 T3653HOST186 T3650ATT187 T3650USER

Chapter 7. CICS-value data areas used by all commands 241

Page 262: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

242 CICS User’s Handbook

Page 263: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIB � EIB field names

Chapter 8. EXEC interface block (EIB)

This chapter contains General-use Programming Interface information.

EIB field names and descriptions

EIB field COBOL C/370 PL/I ASM

EIBAID PIC X(1) char eibaid[1] CHAR(1) CL1EIBATT PIC X(1) char eibatt[1] CHAR(1) CL1EIBCALEN PIC S9(4)

COMPshort int eibcalen FIXED

BIN(15)H

EIBCOMPL PIC X(1) char eibcompl[1] CHAR(1) CL1EIBCONF PIC X(1) char eibconf[1] CHAR(1) CL1EIBCPOSN PIC S9(4)

COMPshort int eibcposn FIXED

BIN(15)H

EIBDATE PIC S9(7)COMP-3

char eibdate[4] FIXEDDEC(7,0)

PL4

EIBDS PIC X(8) char eibds[8] CHAR(8) CL8EIBEOC PIC X(1) char eibeoc[1] CHAR(1) CL1EIBERR PIC X(1) char eiberr[1] CHAR(1) CL1EIBERRCD PIC X(4) char eiberrcd[4] CHAR(4) CL4EIBFMH PIC X(1) char eibfmh[1] CHAR(1) CL1EIBFN PIC X(2) char eibfn[2] CHAR(2) CL2EIBFREE PIC X(1) char eibfree[1] CHAR(1) CL1EIBNODAT PIC X(1) char eibnodat[1] CHAR(1) CL1EIBRCODE PIC X(6) char eibrcode[6] CHAR(6) CL6EIBRECV PIC X(1) char eibrecv[1] CHAR(1) CL1EIBREQID PIC X(8) char eibreqid[8] CHAR(8) CL8EIBRESP PIC S9(8)

COMPlong int eibresp FIXED

BIN(31)F

EIBRESP2 PIC S9(8)COMP

long int eibresp2 FIXEDBIN(31)

F

EIBRLDBK PIC X(1) char eibrldbk[1] CHAR(1) CL1EIBRSRCE PIC X(8) char eibrsrce[8] CHAR(8) CL8EIBSIG PIC X(1) char eibsig[1] CHAR(1) CL1EIBSYNC PIC X(1) char eibsync[1] CHAR(1) CL1EIBSYNRB PIC X(1) char eibsynrb[1] CHAR(1) CL1EIBTASKN PIC S9(7)

COMP-3char eibtaskn[4] FIXED

DEC(7,0)PL4

EIBTIME PIC S9(7)COMP-3

char eibtime[4] FIXEDDEC(7,0)

PL4

EIBTRMID PIC X(4) char eibtrmid[4] CHAR(4) CL4EIBTRNID PIC X(4) char eibtrnid[4] CHAR(4) CL4

Copyright IBM Corp. 1989, 1999 243

Page 264: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBFN codes

EIBFN codesNote: In the column Type , API

indicates that the commandis described in the CICSApplication ProgrammingReference, and SPI indicatesthat it is described in theCICS System ProgrammingReference manual. SPI doesnot indicate that the special(SP) translator option isrequired for this command.FEPI indicates commandsused by the CICS/ESA FrontEnd Programming Interface.They are described in theCICS Front EndProgramming InterfaceUser's Guide.

EIBFNvalue

Command Type

X'0422' FREE APIX'0424' POINT APIX'0426' BUILD ATTACH APIX'0428' EXTRACT ATTACH APIX'042A' EXTRACT TCT APIX'042C' WAIT CONVID APIX'042E' EXTRACT PROCESS APIX'0430' ISSUE ABEND APIX'0432' CONNECT PROCESS APIX'0434' ISSUE

CONFIRMATIONAPI

X'0436' ISSUE ERROR APIX'0438' ISSUE PREPARE APIX'043A' ISSUE PASS APIX'043C' EXTRACT

LOGONMSGAPI

X'043E' EXTRACTATTRIBUTES

API

X'0602' READ APIEIBFNvalue

Command Type X'0604' WRITE FILE APIX'0606' REWRITE APIX'0608' DELETE APIX'0202' ADDRESS APIX'060A' UNLOCK APIX'0204' HANDLE CONDITION APIX'060C' STARTBR APIX'0206' HANDLE AID APIX'060E' READNEXT APIX'0208' ASSIGN APIX'0610' READPREV APIX'020A' IGNORE CONDITION APIX'0612' ENDBR APIX'020C' PUSH APIX'0614' RESETBR APIX'020E' POP APIX'0802' WRITEQ TD APIX'0210' ADDRESS SET APIX'0804' READQ TD APIX'0402' RECEIVE APIX'0806' DELETEQ TD APIX'0404' SEND APIX'0A02' WRITEQ TS APIX'0406' CONVERSE APIX'0A04' READQ TS APIX'0408' ISSUE EODS APIX'0A06' DELETEQ TS APIX'040A' ISSUE COPY APIX'0C02' GETMAIN APIX'040C' WAIT TERMINAL APIX'0C04' FREEMAIN APIX'040E' ISSUE LOAD APIX'0E02' LINK APIX'0410' WAIT SIGNAL APIX'0E04' XCTL APIX'0412' ISSUE RESET APIX'0E06' LOAD APIX'0414' ISSUE DISCONNECT APIX'0E08' RETURN APIX'0416' ISSUE ENDOUTPUT APIX'0E0A' RELEASE APIX'0418' ISSUE ERASEAUP APIX'0E0C' ABEND APIX'041A' ISSUE ENDFILE APIX'0E0E' HANDLE ABEND APIX'041C' ISSUE PRINT APIX'1002' ASKTIME APIX'041E' ISSUE SIGNAL APIX'1004' DELAY APIX'0420' ALLOCATE API

244 CICS User’s Handbook

Page 265: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBFN codes

EIBFNvalue

Command Type EIBFNvalue

Command Type

X'1006' POST API X'240E' ISSUECONFIRMATION

APIX'1008' START APIX'100A' RETRIEVE API X'2410' ISSUE ERROR APIX'100C' CANCEL API X'2412' ISSUE SIGNAL APIX'1202' WAIT EVENT API X'2414' RECEIVE APIX'1204' ENQ API X'2416' SEND APIX'1206' DEQ API X'2418' WAIT APIX'1208' SUSPEND API X'241A' ISSUE PREPARE APIX'1402' WRITE

JOURNALNUMAPI X'241C' EXTRACT

ATTRIBUTESAPI

X'1404' WAIT JOURNALNUM API X'3002' CREATE PROGRAM SPIX'1406' WRITE

JOURNALNAMEAPI X'3004' CREATE MAPSET SPI

X'3006' CREATEPARTITIONSET

SPIX'1408' WAIT JOURNALNAME APIX'1602' SYNCPOINT API X'3008' CREATE

TRANSACTIONSPI

X'1604' RESYNCENTRYNAME

SPIX'300A' CREATE PROFILE SPI

X'1802' RECEIVE MAP API X'300C' CREATE TYPETERM SPIX'1804' SEND MAP API X'300E' CREATE

CONNECTIONSPI

X'1806' SEND TEXT APIX'1808' SEND PAGE API X'3010' CREATE TERMINAL SPIX'180A' PURGE MESSAGE API X'3012' CREATE SESSIONS SPIX'180C' ROUTE API X'3014' CREATE FILE SPIX'180E' RECEIVE PARTN API X'3016' CREATE LSRPOOL SPIX'1810' SEND PARTNSET API X'3018' CREATE PARTNER SPIX'1812' SEND CONTROL API X'301A' CREATE TRANCLASS SPIX'1C02' DUMP API X'301C' CREATE TDQUEUE SPIX'1E02' ISSUE ADD API X'301E' CREATE

JOURNALMODELSPI

X'1E04' ISSUE ERASE APIX'1E06' ISSUE REPLACE API X'3020' CREATE DB2CONN SPIX'1E08' ISSUE ABORT API X'3022' CREATE DB2ENTRY SPIX'1E0A' ISSUE QUERY API X'3024' CREATE DB2TRAN SPIX'1E0C' ISSUE END API X'3026' CREATE

PROCESSTYPESPI

X'1E0E' ISSUE RECEIVE APIX'1E10' ISSUE NOTE API X'3028' CREATE TSMODEL SPIX'1E12' ISSUE WAIT API X'302A' CREATE ENQMODEL SPIX'1E14' ISSUE SEND API X'302C' CREATE

REQUESTMODELSPI

X'2002' BIF DEEDIT APIX'2202' ENABLE PROGRAM SPI X'302E' CREATE

DOCTEMPLATESPI

X'2204' DISABLE APIX'2206' EXTRACT EXIT SPI X'3030' CREATE

TCPIPSERVICESPI

X'2402' ALLOCATE APIX'2404' ASSIGN API X'3A02' INQ RRMS SPIX'2406' EXTRACT PROCESS API X'4202' INQUIRE

AUTINSTMODELSPI

X'2408' FREE APIX'240A' ISSUE ABEND API X'4210' DISCARD

AUTINSTMODELSPI

X'240C' CONNECT PROCESS API

Chapter 8. EXEC interface block (EIB) 245

Page 266: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBFN codes

EIBFNvalue

Command Type EIBFNvalue

Command Type

X'4402' INQUIRE PARTNER SPI X'5C10' DISCARD TDQUEUE SPIX'4410' DISCARD PARTNER SPI X'5E02' INQUIRE TASK SPIX'4602' INQUIRE PROFILE SPI X'5E04' SET TASK SPIX'4610' DISCARD PROFILE SPI X'5E06' CHANGE TASK APIX'4802' ENTER TRACENUM API X'5E08' INQUIRE STORAGE SPIX'4804' MONITOR API X'5E12' INQUIRE TCLASS SPIX'4A02' ASKTIME ABSTIME API X'5E14' SET TCLASS SPIX'4A04' FORMATTIME API X'5E18' DISCARD

TRANCLASSSPI

X'4C02' INQUIRE FILE SPIX'4C04' SET FILE SPI X'5E1A' INQUIRE

TRANCLASSSPI

X'4C10' DISCARD FILE SPIX'4E02' INQUIRE PROGRAM SPI X'5E1C' SET TRANCLASS SPIX'4E04' SET PROGRAM SPI X'5E22' WAIT EXTERNAL APIX'4E10' DISCARD PROGRAM SPI X'5E32' WAITCICS APIX'5002' INQUIRE

TRANSACTIONSPI X'6002' INQUIRE

JOURNALNUMSPI

X'5004' SET TRANSACTION SPI X'6004' SET JOURNALNUM SPIX'5010' DISCARD

TRANSACTIONSPI X'6010' DISCARD

JOURNALNAMESPI

X'5202' INQUIRE TERMINAL SPI X'6012' INQUIREJOURNALNAME

SPIX'5204' SET TERMINAL SPIX'5206' INQUIRE NETNAME SPI X'6014' SET JOURNALNAME SPIX'5208' SET NETNAME SPI X'6202' INQUIRE VOLUME SPIX'5210' DISCARD TERMINAL SPI X'6204' SET VOLUME SPIX'5212' INQUIRE TERMINAL SPI X'6402' PERFORM SECURITY SPIX'5214' SET TERMINAL SPI X'6602' INQUIRE DUMPDS SPIX'5216' INQUIRE NETNAME SPI X'6604' SET DUMPDS SPIX'5402' INQUIRE SYSTEM SPI X'6612' INQUIRE

TRANDUMPCODESPI

X'5404' SET SYSTEM SPIX'5412' INQ SYSTEM SPI X'6614' SET

TRANDUMPCODESPI

X'5602' SPOOLOPEN INPUT APIX'5602' SPOOLOPEN

OUTPUTAPI X'6622' INQUIRE

SYSDUMPCODESPI

X'5604' SPOOLREAD API X'6624' SET SYSDUMPCODE SPIX'5606' SPOOLWRITE API X'6802' INQUIRE VTAM SPIX'5610' SPOOLCLOSE API X'6804' SET VTAM SPIX'5802' INQUIRE

CONNECTIONSPI X'6812' INQUIRE

AUTOINSTALLSPI

X'5804' SET CONNECTION SPI X'6814' SET AUTOINSTALL SPIX'5806' PERFORM

ENDAFFINITYSPI X'6822' INQUIRE

DELETSHIPPEDSPI

X'5810' DISCARDCONNECTION

SPI X'6824' SET DELETSHIPPED SPIX'6826' PERFORM

DELETSHIPPEDSPI

X'5A02' INQUIRE MODENAME SPIX'5A04' SET MODENAME SPI X'6A02' QUERY SECURITY APIX'5C02' INQUIRE TDQUEUE SPI X'6C02' WRITE OPERATOR APIX'5C04' SET TDQUEUE SPI X'6C12' CICSMESSAGE API

246 CICS User’s Handbook

Page 267: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBFN codes

EIBFNvalue

Command Type EIBFNvalue

Command Type

X'6E02' INQUIRE IRC SPI X'8214' CONVERSEDATASTREAM

FEPIX'6E04' SET IRC SPIX'7002' INQUIRE STATISTICS SPI X'8216' EXTRACT CONV FEPIX'7004' SET STATISTICS SPI X'8218' EXTRACT FIELD FEPIX'7006' PERFORM

STATISTICSSPI X'821A' EXTRACT STSN FEPI

X'821C' FREE FEPIX'7008' COLLECT

STATISTICSSPI X'821E' ISSUE FEPI

X'8220' RECEIVEFORMATTED

FEPIX'7012' INQUIRE MONITOR SPIX'7014' SET MONITOR SPI X'8222' RECEIVE

DATASTREAMFEPI

X'7202' PERFORMRESETTIME

SPIX'8224' SEND FORMATTED FEPI

X'7402' SIGNON API X'8226' SEND DATASTREAM FEPIX'7404' SIGNOFF API X'8228' START FEPIX'7406' VERIFY PASSWORD API X'840E' SP FEPIX'7408' CHANGE

PASSWORDAPI X'8422' INQUIRE

PROPERTYSETFEPI

X'7602' PERFORMSHUTDOWN

SPI X'8428' INSTALLPROPERTYSET

FEPI

X'7802' INQUIRETRACEDEST

SPI X'8430' DISCARDPROPERTYSET

FEPI

X'7804' SET TRACEDEST SPI X'8442' INQUIRE NODE FEPIX'7812' INQUIRE

TRACEFLAGSPI X'8444' SET NODE FEPI

X'8444' SET NODELIST FEPIX'7814' SET TRACEFLAG SPI X'8448' INSTALL NODELIST FEPIX'7822' INQUIRE

TRACETYPESPI X'844A' ADD POOL FEPI

X'844C' DELETE POOL FEPIX'7824' SET TRACETYPE SPI X'8450' DISCARD NODELIST FEPIX'7A02' INQUIRE DSNAME SPI X'8462' INQUIRE POOL FEPIX'7A04' SET DSNAME SPI X'8464' SET POOL FEPIX'7C02' INQ EXCI SPI X'8464' SET POOLLIST FEPIX'7E02' DUMP

TRANSACTIONAPI X'8468' INSTALL POOL FEPI

X'8470' DISCARD POOL FEPIX'7E04' PERFORM DUMP SPI X'8482' INQUIRE TARGET FEPIX'8002' INQUIRE TSQUEUE SPI X'8484' SET TARGETLIST FEPIX'8004' SET TSQUEUE SPI X'8484' SET TARGET FEPIX'8012' INQUIRE TSQNAME SPI X'8488' INSTALL

TARGETLISTFEPI

X'8014' SET TSQNAME SPIX'801A' INQUIRE TSPOOL SPI X'8490' DISCARD

TARGETLISTFEPI

X'8022' INQUIRE TSMODEL SPIX'8030' DISCARD TSMODEL SPI X'84A2' INQUIRE

CONNECTIONFEPI

X'820E' AP FEPIX'8210' ALLOCATE POOL FEPI X'84A4' SET CONNECTION FEPIX'8210' ALLOCATE

PASSCONVIDFEPI X'8602' ACQUIRE SPI

X'8802' INQUIREEXITPROGRAM

SPIX'8212' CONVERSE

FORMATTEDFEPI

X'8A02' INQUIRE REQID SPI

Chapter 8. EXEC interface block (EIB) 247

Page 268: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBFN codes

EIBFNvalue

Command Type EIBFNvalue

Command Type

X'8C02' WRITE MESSAGE API X'962C' STARTBROWSEEVENT

SPIX'9002' INQUIRE UOW SPIX'9004' SET UOW SPI X'962E' GETNEXT EVENT SPIX'9022' INQUIRE UOWENQ SPI X'9630' ENDBROWSE EVENT SPIX'9042' INQUIRE UOWLINK SPI X'9632' STARTBROWSE

PROCESSSPI

X'9044' SET UOWLINK SPIX'9062' INQUIRE

UOWDSNFAILSPI X'9634' GETNEXT PROCESS SPI

X'9636' ENDBROWSEPROCESS

SPIX'9082' INQUIRE ENQMODEL SPIX'9084' SET ENQMODEL SPI X'9638' INQUIRE TIMER SPIX'9090' DISCARD

ENQMODELSPI X'963A' STARTBROWSE

TIMERSPI

X'9202' INQUIREJOURNALMODEL

SPI X'963C' GETNEXT TIMER SPIX'963E' ENDBROWSE TIMER SPI

X'9210' DISCARDJOURNALMODEL

SPI X'9802' INQUIRE CFDTPOOL SPIX'9A02' INQUIRE

REQUESTMODELSPI

X'9212' INQUIRESTREAMNAME

SPIX'9A10' DISCARD

REQUESTMODELSPI

X'9402' INQUIRE DB2CONN SPIX'9404' SET DB2CONN SPI X'9C02' INQUIRE

TCPIPSERVICESPI

X'9410' DISCARD DB2CONN SPIX'9422' INQUIRE DB2ENTRY SPI X'9C04' SET TCPIPSERVICE SPIX'9424' SET DB2ENTRY SPI X'9C10' DISCARD

TCPIPSERVICESPI

X'9430' DISCARD DB2ENTRY SPIX'9442' INQUIRE DB2TRAN SPI X'9C12' INQUIRE TCPIP SPIX'9444' SET DB2TRAN SPI X'9C14' SET TCPIP SPIX'9450' DISCARD DB2TRAN SPI X'9C22' INQUIRE WEB SPIX'9602' INQUIRE

PROCESSTYPESPI X'9C24' SET WEB SPI

X'9E02' INQUIREDOCTEMPLATE

SPIX'9604' SET PROCESSTYPE SPIX'9610' DISCARD

PROCESSTYPESPI X'9E10' DISCARD

DOCTEMPLATESPI

X'9612' INQUIRE ACTID SPIX'9614' INQUIRE CONTAIN SPIX'9616' INQUIRE EVENT SPIX'9618' INQUIRE PROCESS SPIX'9620' STARTBROWSE

ACTIVITYSPI

X'9622' GETNEXT ACTIVITY SPIX'9624' ENDBROWSE

ACTIVITYSPI

X'9626' STARTBROWSECONTAINER

SPI

X'9628' GETNEXTCONTAINER

SPI

X'962A' ENDBROWSECONTAINER

SPI

248 CICS User’s Handbook

Page 269: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBRCODE values

EIBRCODE valuesSee the notes at the end of the list of values for explanations of the numbersfollowing some of the conditions.

EIBFN EIBRCODE Condition

ð6 .. 85 .. .. .. .. .. SUPPRESSEDEIBFN EIBRCODE Condition

ð6 .. 86 .. .. .. .. .. LOADING

ð6 .. Dð .. .. .. .. .. SYSIDERR3ð2 .. Eð .. .. .. .. .. INVREQ

ð6 .. D1 .. .. .. .. .. ISCINVREQ ð6 .. D6 .. .. .. .. .. NOTAUTHð4 .. ð4 .. .. .. .. .. EOF

ð6 .. E1 .. .. .. .. .. LENGERRð4 .. 1ð .. .. .. .. .. EODS

ð4 .. C1 .. .. .. .. .. EOF

ð8 .. ð1 .. .. .. .. .. QZEROð4 .. C2 .. .. .. .. .. ENDINPT

ð8 .. ð2 .. .. .. .. .. QIDERRð4 .. Dð .. .. .. .. .. SYSIDERR3

ð8 .. ð4 .. .. .. .. .. IOERRð4 .. D2 .. .. .. .. .. SESSIONERR4

ð8 .. ð8 .. .. .. .. .. NOTOPENð4 .. D3 .. .. .. .. .. SYSBUSY5

ð8 .. 1ð .. .. .. .. .. NOSPACEð4 .. D4 .. .. .. .. .. SESSBUSY

ð8 .. Cð .. .. .. .. .. QBUSYð4 .. D5 .. .. .. .. .. NOTALLOC

ð8 .. Dð .. .. .. .. .. SYSIDERR3ð4 .. Eð .. .. .. .. .. INVREQ6

ð8 .. D1 .. .. .. .. .. ISCINVREQð4 .. E1 .. .. .. .. .. LENGERR7

ð8 .. D6 .. .. .. .. .. NOTAUTHð4 .. E3 .. .. .. .. .. WRBRK

ð8 .. D7 .. .. .. .. .. DISABLEDð4 .. E4 .. .. .. .. .. RDATT

ð8 .. Eð .. .. .. .. .. INVREQð4 .. E5 .. .. .. .. .. SIGNAL

ð8 .. E1 .. .. .. .. .. LENGERRð4 .. E6 .. .. .. .. .. TERMIDERR

ð4 .. E7 .. .. .. .. .. NOPASSBKRD

ðA .. ð1 .. .. .. .. .. ITEMERRð4 .. E8 .. .. .. .. .. NOPASSBKWR

ðA .. ð2 .. .. .. .. .. QIDERRð4 .. EA .. .. .. .. .. IGREQCD

ðA .. ð4 .. .. .. .. .. IOERRð4 .. EB .. .. .. .. .. CBIDERR

ðA .. ð8 .. .. .. .. .. NOSPACEð4 .. EC .. .. .. .. .. PARTNERIDERR

ðA .. 2ð .. .. .. .. .. INVREQð4 .. ED .. .. .. .. .. NETNAMEIDERR

ðA .. Dð .. .. .. .. .. SYSIDERR3ð4 .. F1 .. .. .. .. .. TERMERR

ðA .. D1 .. .. .. .. .. ISCINVREQð4 .. .. 2ð .. .. .. .. EOC

ðA .. D6 .. .. .. .. .. NOTAUTHð4 .. .. 4ð .. .. .. .. INBFMH

ðA .. E1 .. .. .. .. .. LENGERRð4 .. .. .. .. F6 .. .. NOSTART

ð4 .. .. .. .. F7 .. .. NONVAL

ðC .. E1 .. .. .. .. .. LENGERR ðC .. E2 .. .. .. .. .. NOSTGð6 .. ð1 .. .. .. .. .. FILENOTFOUND

ð6 .. ð2 .. .. .. .. .. ILLOGIC1

ðE .. ð1 .. .. .. .. .. PGMIDERRð6 .. ð3 .. .. .. .. .. LOCKED

ðE .. D6 .. .. .. .. .. NOTAUTHð6 .. ð5 .. .. .. .. .. RECORDBUSY

ðE .. Eð .. .. .. .. .. INVREQð6 .. ð8 .. .. .. .. .. INVREQ

ðE .. E1 .. .. .. .. .. LENGERRð6 .. ðC .. .. .. .. .. NOTOPEN

ðE .. F1 .. .. .. .. .. TERMERRð6 .. ðD .. .. .. .. .. DISABLED

ð6 .. ðF .. .. .. .. .. ENDFILE

ð6 .. 8ð .. .. .. .. .. IOERR1

ð6 .. 81 .. .. .. .. .. NOTFND

ð6 .. 82 .. .. .. .. .. DUPREC

ð6 .. 83 .. .. .. .. .. NOSPACE

ð6 .. 84 .. .. .. .. .. DUPKEY

Chapter 8. EXEC interface block (EIB) 249

Page 270: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBRCODE values

EIBFN EIBRCODE Condition EIBFN EIBRCODE Condition

1ð .. ð1 .. .. .. .. .. ENDDATA 18 .. .. .. 1ð .. .. .. IGREQID

1ð .. ð4 .. .. .. .. .. IOERR 1ð .. 11 .. .. .. .. .. TRANSIDERR 1A .. Eð .. .. .. .. .. INVREQ

1ð .. 12 .. .. .. .. .. TERMIDERR 1A .. ð4 .. .. .. .. .. DSSTAT

1ð .. 2ð .. .. .. .. .. EXPIRED 1A .. ð8 .. .. .. .. .. FUNCERR

1ð .. 81 .. .. .. .. .. NOTFND 1A .. ðC .. .. .. .. .. SELNERR

1ð .. Dð .. .. .. .. .. SYSIDERR3 1A .. 1ð .. .. .. .. .. UNEXPIN

1ð .. D1 .. .. .. .. .. ISCINVREQ 1A .. E1 .. .. .. .. .. LENGERR

1ð .. D6 .. .. .. .. .. NOTAUTH 1A .. .. 11 .. .. .. .. EODS

1ð .. D8 .. .. .. .. .. USERIDERR 1A .. .. 2B .. .. .. .. IGREQCD

1ð .. E1 .. .. .. .. .. LENGERR 1A .. .. .. 2ð .. .. .. EOC

1ð .. E9 .. .. .. .. .. ENVDEFERR 1ð .. FF .. .. .. .. .. INVREQ 22 .. 8ð .. .. .. .. .. INVEXITREQ

12 .. 32 .. .. .. .. .. ENQBUSY 4A .. .. .. .. ð1 .. .. ERROR

12 .. Eð .. .. .. .. .. INVREQ 12 .. E1 .. .. .. .. .. LENGERR 56 .. .. .. .. ðD .. .. NOTFND

56 .. .. .. .. 1ð .. .. INVREQ

14 .. ð1 .. .. .. .. .. JIDERR 56 .. .. .. .. 13 .. .. NOTOPEN

14 .. ð2 .. .. .. .. .. INVREQ 56 .. .. .. .. 14 .. .. ENDFILE

14 .. ð5 .. .. .. .. .. NOTOPEN 56 .. .. .. .. 15 .. .. ILLOGIC

14 .. ð6 .. .. .. .. .. LENGERR 56 .. .. .. .. 16 .. .. LENGERR

14 .. ð7 .. .. .. .. .. IOERR 56 .. .. .. .. 2A .. .. NOSTG

14 .. ð9 .. .. .. .. .. NOJBUFSP 56 .. .. .. .. 46 .. .. NOTAUTH

14 .. D6 .. .. .. .. .. NOTAUTH 56 .. .. .. .. 5ð .. .. NOSPOOL

56 .. .. .. .. 55 .. .. ALLOCERR

16 .. ð1 .. .. .. .. .. ROLLEDBACK 56 .. .. .. .. 56 .. .. STRELERR

56 .. .. .. .. 57 .. .. OPENERR

18 .. ð1 .. .. .. .. .. INVREQ 56 .. .. .. .. 58 .. .. SPOLBUSY

18 .. ð2 .. .. .. .. .. RETPAGE 56 .. .. .. .. 59 .. .. SPOLERR

18 .. ð4 .. .. .. .. .. MAPFAIL 56 .. .. .. .. 5A .. .. NODEIDERR

18 .. ð8 .. .. .. .. .. INVMPSZ2 56 .. .. .. .. 6ð .. .. OUTDESCRERR

18 .. 2ð .. .. .. .. .. INVERRTERM 18 .. 4ð .. .. .. .. .. RTESOME

18 .. 8ð .. .. .. .. .. RTEFAIL

18 .. E1 .. .. .. .. .. LENGERR

18 .. E3 .. .. .. .. .. WRBRK

18 .. E4 .. .. .. .. .. RDATT

18 .. .. ð2 .. .. .. .. PARTNFAIL

18 .. .. ð4 .. .. .. .. INVPARTN

18 .. .. ð8 .. .. .. .. INVPARTNSET

18 .. .. 1ð .. .. .. .. INVLDC

18 .. .. 2ð .. .. .. .. UNEXPIN

18 .. .. 4ð .. .. .. .. IGREQCD

18 .. .. 8ð .. .. .. .. TSIOERR

18 .. .. .. ð1 .. .. .. OVERFLOW

18 .. .. .. ð4 .. .. .. EODS

18 .. .. .. ð8 .. .. .. EOC

250 CICS User’s Handbook

Page 271: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBRCODE values

Notes:

1. When ILLOGIC or IOERR occurs during file control operations, furtherinformation is provided in field EIBRCODE, as follows:

.. xx xx xx xx .. BDAM response

.. xx .. .. .. .. VSAM return code

.. .. xx .. .. .. VSAM error code

.. .. .. xx .. .. VSAM problem determination code

.. .. .. .. xx .. VSAM component code

VSAM Administration: Macro Instruction Reference manual for VSAM,and the Data Facility Product Customization Guide for BDAM.

2. When INVMPSZ occurs during BMS operations, byte 3 of fieldEIBRCODE contains the terminal code:

.. .. .. xx .. .. terminal code

3. When SYSIDERR occurs, further information is provided in bytes 1 and2 of EIBRCODE, as follows:

.. ð4 ðð .. .. .. request was for invalid function

.. ð4 ð4 .. .. .. no session available and NOQUEUE

.. ð4 ð8 .. .. .. mode name not found

.. ð4 ðC .. .. .. mode name invalid

.. ð4 1ð .. .. .. task canceled or timed out during allocation

.. ð4 14 .. .. .. mode group is out of service

.. ð4 18 .. .. .. close - DRAIN=ALL (Note: APPC only)

.. ð8 .. .. .. .. SYSID out of service – for function shippingrequests, the exit program (XISCONA) may haverefused to queue the request because the intersystemconnection is busy

.. ðC xx .. .. .. SYSID definition error

.. ðC ðð .. .. .. name not that of TCTSE

.. ðC ð4 .. .. .. name not that of remote TCTSE

.. ðC ð8 .. .. .. mode name not found

.. ðC ðC .. .. .. profile not found

Further information about SYSIDERR can be found in the CICSIntercommunication Guide.

4. When SESSIONERR occurs, further information is provided in bytes 1and 2 of EIBRCODE, as follows:

.. ð8 .. .. .. .. session out of service

.. ðC xx .. .. .. session definition error

.. ðC ðð .. .. .. name not found

.. ðC ðC .. .. .. profile not found

Chapter 8. EXEC interface block (EIB) 251

Page 272: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBRCODE values

Further information about SESSIONERR can be found in the CICSIntercommunication Guide.

5. If SYSBUSY occurs on an ALLOCATE command that attempts toacquire a session to an APPC terminal or system, byte 3 of theEIBRCODE indicates where the error condition was detected:

.. .. .. ðð .. .. the request was for a session to a connectedterminal or system

.. .. .. ð1 .. .. the request was for a session to a remotelyconnected terminal or system, and the error occurredin the terminal-owning region (TOR) or an intermediatesystem

.. .. .. ð2 .. .. the request was for a session to a remotelyconnected terminal or system, and the error occurredin the application-owning region (AOR)

Further information about SYSBUSY can be found in the CICSIntercommunication Guide.

6. When INVREQ occurs during terminal control operations, furtherinformation is provided in byte 3 of EIBRCODE as follows:

.. .. .. ð4 .. .. ALLOCATE command - TCTTE already allocated

.. .. .. ð8 .. .. FREE command - TCTTE in wrong state

.. .. .. ðC .. .. CONNECT PROCESS command - SYNCLVL 2 hasbeen requested but cannot be supported on thesession in use

.. .. .. 1ð .. .. EXTRACT ATTACH command - invalid data

.. .. .. 14 .. .. SEND command - CONFIRM option has beenspecified but conversation is not SYNCLVL 1

.. .. .. 18 .. .. EXTRACT TCT command - invalid netname

.. .. .. 1C .. .. an invalid command has been issued for theterminal or logical unit in use

.. .. .. 2ð .. .. an invalid command has been issued for the LU6.2conversation type in use

.. .. .. 28 .. .. GETMAIN failure on ISSUE PASS command

252 CICS User’s Handbook

Page 273: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

EIBRCODE values

7. When LENGERR occurs during terminal control operations, furtherinformation is provided in byte 1 of EIBRCODE, as follows:

.. ðð .. .. .. .. input data is overlong and has been truncated

.. ð4 .. .. .. .. on output commands, an invalid (FROM)LENGTHhas been specified, either less than zero or greaterthan 32767

.. ð8 .. .. .. .. on input commands, an invalid (TO)LENGTH hasbeen specified, greater than 32767

.. ðC .. .. .. .. length error has occurred on ISSUE PASScommand

Chapter 8. EXEC interface block (EIB) 253

Page 274: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP values

RESP values and conditionsRESPvalue

Condition RESPvalue

Condition

00 NORMAL 45 NOJBUFSP01 ERROR 46 DSSTAT02 RDATT 47 SELNERR03 WRBRK 48 FUNCERR04 EOF 49 UNEXPIN05 EODS 50 NOPASSBKRD06 EOC 51 NOPASSBKWR07 INBFMH 52 -08 ENDINPT 53 SYSIDERR09 NONVAL 54 ISCINVREQ10 NOSTART 55 ENQBUSY11 TERMIDERR 56 ENVDEFERR12 FILENOTFOUND 57 IGREQCD13 NOTFND 58 SESSIONERR14 DUPREC 59 SYSBUSY15 DUPKEY 60 SESSBUSY16 INVREQ 61 NOTALLOC17 IOERR 62 CBIDERR18 NOSPACE 63 INVEXITREQ19 NOTOPEN 64 INVPARTNSET20 ENDFILE 65 INVPARTN21 ILLOGIC 66 PARTNFAIL22 LENGERR 67 -23 QZERO 68 -24 SIGNAL 69 USERIDERR25 QBUSY 70 NOTAUTH26 ITEMERR 71 VOLIDERR27 PGMIDERR 72 SUPPRESSED28 TRANSIDERR 73 -29 ENDDATA 74 -30 INVTSREQ 75 RESIDERR31 EXPIRED 76 -32 RETPAGE 77 -33 RTEFAIL 78 -34 RTESOME 79 -35 TSIOERR 80 NOSPOOL36 MAPFAIL 81 TERMERR37 INVERRTERM 82 ROLLEDBACK38 INVMPSZ 83 END39 IGREQID 84 DISABLED40 OVERFLOW 85 ALLOCERR41 INVLDC 86 STRELERR42 NOSTG 87 OPENERR43 JIDERR 88 SPOLBUSY44 QIDERR 89 SPOLERR

254 CICS User’s Handbook

Page 275: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP values

RESPvalue

Condition

90 NODEIDERR91 TASKIDERR92 TCIDERR93 DSNNOTFOUND94 LOADING95 MODELIDERR96 OUTDESCRERR97 PARTNERIDERR98 PROFILEIDERR99 NETNAMEIDERR100 LOCKED101 RECORDBUSY102 UOWNOTFOUND103 UOWLNOTFOUND104 LINKABEND105 CHANGED106 PROCESSBUSY107 ACTIVITYBUSY108 PROCESSERR109 ACTIVITYERR110 CONTAINERERR111 EVENTERR112 TOKENERR113 NOTFINISHED114 POOLERR115 TIMERERR116 SYMBOLERR117 TEMPLATERR118 -

Chapter 8. EXEC interface block (EIB) 255

Page 276: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP values

256 CICS User’s Handbook

Page 277: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Chapter 9. RESP2 values and their meanings

Note: The RESP2 values returned by the CICS/ESA Front EndProgramming Interface are described in the CICS Front EndProgramming Interface User's Guide.

Command Condition RESP2 Meaning

ACQUIRETERMINAL

INVREQ 2 The terminal is a remoteterminal

3 The terminal is LU6.1,APPC, IRC or anon-VTAM device

4 The terminal is not inservice; that is, it is notavailable for use.

5 VTAM is not open7 CICS is already in the

process of acquiring thissession.

8 NOQUEUE andQNOTENAB options areinvalid for a logged-ondevice

LENGERR 6 Out-of-range valuesupplied in theUSERDATALEN option

NOTAUTH 100 The user associated withthe task is not authorizedto use this command

TERMIDERR 1 The terminal cannot befound

ADDRESS INVREQ 200 The TCTUA option isspecified on anADDRESS commandissued in a DPL serverprogram

ASSIGN INVREQ 1 The task does not have asigned-on user

2 No BMS command hasyet been issued, BMSrouting is in effect, or nomap has yet beenpositioned

3 No BDI command has yetbeen issued

Copyright IBM Corp. 1989, 1999 257

Page 278: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

4 The task is not initiated byautomatic transactioninitiation (ATI)

5 The task is not associatedwith a terminal; or thetask has no principalfacility; or the principalfacility is not am MRO,LU6.1, or APPC session

200 Command syntax optionsare not allowed in aserver program invokedby a distributed programlink

CHANGEPASSWORD

INVREQ 13 There is an unknownreturn code in ESMRESPfrom the external securitymanager

18 The CICS externalsecurity manager interfaceis not initialized

29 The external securitymanager is notresponding

NOTAUTH 2 The supplied password iswrong

4 The new password is notacceptable

19 The USERID is revoked22 The change password

request failed duringSECLEVEL processing

31 The user is revoked in theconnection to the defaultgroup

USERIDERR 8 The USERID is not knownto the external securitymanager

CHANGE TASK INVREQ 1 The PRIORITY value isoutside the range 0–255

258 CICS User’s Handbook

Page 279: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

COLLECTSTATISTICS

NOTFND 1 The requested resourcecannot be found (forexample, if theJOURNALNAME specifiedis not known to CICS)

2 The type of resource isnot defined in the CICSsystem

IOERR 3 The requested statisticsarea was not functioning

INVREQ 4 The TCLASS value wasnot in the range 1–10, orthe LSRPOOL value wasnot in the range 1–8

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe task is not authorizedto access this particularresource in the wayrequired by this command

CONNECTPROCESS

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

CONVERSE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

CREATECONNECTION

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier connection orterminal pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 259

Page 280: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

102 The user of thetransaction issuing theCREATE CONNECTIONis not an authorizedsurrogate of the useridspecified inSECURITYNAME

INVREQ n Syntax error inATTRIBUTES string, orerror occurred duringeither discard or resourcedefinition phase ofprocessing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATEDB2CONN

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 Command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionnot yet completed

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.

260 CICS User’s Handbook

Page 281: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

102 The user associated withthe issuing task is not anauthorized surrogate ofthe user specified inAUTHID, COMAUTHID, orSIGNID parameter

103 The user associated withthe issuing task is notauthorized to create aDB2CONN with anAUTHTYPE orCOMAUTHTYPEparameter

CREATEDB2ENTRY

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 Command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionnot yet completed

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 261

Page 282: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

101 The user associated withthe issuing task is notauthorized to create aDB2ENTRY definition withthis name

102 The user associated withthe issuing task is not anauthorized surrogate ofthe user specified in theAUTHID parameter

103 The user associated withthe issuing task is notauthorized to create aDB2ENTRY with anAUTHTYPE parameter

CREATEDB2TRAN

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 Command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionnot yet completed

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create aDB2TRAN definition andassociate it with thenamed DB2ENTRY

262 CICS User’s Handbook

Page 283: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

102 The user associated withthe issuing task is not anauthorized surrogate ofthe user specified in theAUTHID parameter of theDB2ENTRY named in theDB2TRAN

103 The user associated withthe issuing task is notauthorized to create aDB2TRAN with theDB2ENTRY specifyingAUTHTYPE

CREATEDOCTEMPLATE

LENGERR 1 The length specified inATTRLEN is negative

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

CREATEENQMODEL

LENGERR 1 The length specified inATTRLEN is negative

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

Chapter 9. RESP2 values and their meanings 263

Page 284: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create this aENQMODEL definitionwith this name

CREATE FILE LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier connection orterminal pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create aFILE definition with thisname

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

264 CICS User’s Handbook

Page 285: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATEJOURNALMODEL

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATELSRPOOL

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 265

Page 286: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATEMAPSET

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create aMAPSET definition withthis name

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

266 CICS User’s Handbook

Page 287: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

CREATEPARTITIONSET

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create thisparticular PARTITIONSET

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATEPARTNER

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 267

Page 288: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATEPROFILE

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATEPROGRAM

LENGERR 1 The length specified inATTRLEN is negative

268 CICS User’s Handbook

Page 289: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create thisparticular PROGRAM

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATEREQUESTMODEL

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

Chapter 9. RESP2 values and their meanings 269

Page 290: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATESESSIONS

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

102 The user of transactionissuing CREATESESSIONS is not anauthorized surrogate ofthe user specified inUSERID

102 The user of thetransaction issuing theCREATE SESSIONScommand is not anauthorized surrogate ofthe userid specified inUSERID

INVREQ 200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

270 CICS User’s Handbook

Page 291: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

CREATETCPIPSERVICE

INVREQ n Syntax error inATTRIBUTE string or anerror occurred duringeither the discard orresource definition phaseof processing

200 The command executedin program defined withan EXECUTIONSET orDPLSUBSET, or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.

LENGERR 1 Length specified inATTRLEN is negative

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

CREATETDQUEUE

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create aTDQUEUE definition withthis name

102 The user of thetransaction issuing theCREATE TDQUEUEcommand is not anauthorized surrogate ofthe user specified inUSERID

Chapter 9. RESP2 values and their meanings 271

Page 292: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATETERMINAL

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

102 The user of thetransaction issuing theCREATE TERMINALcommand is not anauthorized surrogate ofthe userid specified inUSERID

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

272 CICS User’s Handbook

Page 293: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATETRANCLASS

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATETRANSACTION

LENGERR 1 The length specified inATTRLEN is negative

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 273

Page 294: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

101 The user associated withthe issuing task is notauthorized to create thisparticular TRANSACTION

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATETSMODEL

LENGERR 1 The length specified inATTRLEN is negative

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to create aTSMODEL definition withthis name

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

CREATETYPETERM

LENGERR 1 The length specified inATTRLEN is negative

274 CICS User’s Handbook

Page 295: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

DELAY INVREQ 4 Hours are out of range5 Minutes are out of range6 Seconds are out of range

DELETE FILENOTFOUND 1 The file name referred to

in the FILE option cannotbe found in the FCT

INVREQ 20 Delete operations are notallowed according to thefile entry specification inthe FCT or theuser-maintained datatable was defined as aCICS file and thedefinition does not allowfor delete operations

21 A DELETE command wasissued for a file referringto a VSAM ESDS

22 A generic delete wasissued for a file that is nota VSAM KSDS

Chapter 9. RESP2 values and their meanings 275

Page 296: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

25 The KEYLENGTH andGENERIC options werespecified, and the lengthspecified in theKEYLENGTH option isgreater than or equal tothe length of a full key

26 The KEYLENGTH optionwas specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers

27 A DELETE command wasissued for a file referringto a BDAM data set

31 A DELETE commandwithout the RIDFLD optionwas issued for a file forwhich no previous READUPDATE command hasbeen issued

42 The KEYLENGTH andGENERIC options werespecified, and the lengthspecified in theKEYLENGTH option isless than zero

44 The DELETE commanddoes not conform to theformat of DELETE for auser-maintained table; forexample if GENERICwere specified

47 A DELETE instructionincluded a token whosevalue cannot be matchedagainst any token in usefor an existing READ forUPDATE request

276 CICS User’s Handbook

Page 297: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

51 A DELETE commandspecifying the RBAkeyword was issuedagainst a KSDS file that isbeing accessed in RLSmode. RLS does notsupport relative byteaddress (RBA) access toKSDS files

55 NOSUSPEND wasspecified for a non-RLSfile

DISABLED 50 A file is disabled NOTOPEN 60 The requested file is

CLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but a closerequest against it hasbeen received or aDELETE command hasbeen issued against adata set that is quiesced,or is being quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED commend

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTFND 80 An attempt to delete arecord based on thesearch argument providedis unsuccessful or, foruser-maintained datatables, an attempt todelete a record wasunsuccessful becausethere is no entry with thespecified key in the datatable

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

Chapter 9. RESP2 values and their meanings 277

Page 298: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LOADING 104 A delete request has beenissued for auser-maintained table thatis currently being loaded

LOCKED 106 An attempt has beenmade to delete a recordspecifying the RIDFLD,but a retained lock existsagainst this key. If therequest specified theGENERIC keyword, allpossible records aredeleted, but the lockedrecords remain. Thenumber of records deletedis returned by NUMREC

RECORDBUSY 107 The NOSUSPENDkeyword was specified forthe deletion of a recordthat is locked by a VSAMactive lock

ILLOGIC 110 A VSAM error hasoccurred which does notfall within the one of theother CICS responsecategories

IOERR 120 There has been an I/Oerror during the file controloperation

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemwas closed.

DUPKEY 140 A record has beenaccessed by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key follows

278 CICS User’s Handbook

Page 299: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

DEQ LENGERR 1 The value specified forthe LENGTH option isoutside the range 1–255

INVREQ 2 The MAXLIFETIME optionhas an incorrect CVDA

DISABLEPROGRAM

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand.

DISCARDAUTINSTMODEL

MODELIDERR 1 The model cannot befound

INVREQ 2 The model you requestedis currently in use

3 The model cannot bediscarded because itsname begins with DFH

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

DISCARDCONNECTION

SYSIDERR 9 The named connectioncannot be found

INVREQ 24 Remote and in-use25 Not set out-of-service and

not remote26 Recovery work pending27 Discard processing failed28 Indirect connections point

to this connection29 MRO connection and IRC

active38 Delete already in flight39 Entry locked by another

RDO action200 DPL subset without

SYNCONRETURN NOTAUTH 100 The user of this command

is not authorized

Chapter 9. RESP2 values and their meanings 279

Page 300: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

DISCARDDB2CONN

INVREQ 2 The CICS DB2 interfaceis active

NOTFND 1 A DB2CONN cannot befound

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

DISCARDDB2ENTRY

INVREQ 2 The DB2ENTRY iscurrently in use

3 The DB2ENTRY is notdisabled

NOTFND 1 The DB2ENTRY cannotbe found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

DISCARDDB2TRAN

NOTFND 1 The DB2ENTRY cannotbe found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access theDB2ENTRY referenced bythis DB2TRAN in the wayrequired by this command

DISCARDDOCTEMPLATE

LENGERR 1 The length specified inATTRLEN is negative

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

280 CICS User’s Handbook

Page 301: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

DISCARDENQMODEL

NOTFND 1 The specifiedENQMODEL is notinstalled on this system

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

DISCARD FILE INVREQ 2 The file is not closed3 The file is not disabled

25 The file definition iscurrently in use

26 The file cannot bediscarded because itsname begins with DFH

43 The file cannot bediscarded because it haswork outstanding forwhich there are retainedlocks

FILENOTFOUND 18 The file cannot be found NOTAUTH 100 The user associated with

the issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

DISCARDJOURNALMODEL

NOTFND 1 The specifiedJOURNALMODEL namewas not found

Chapter 9. RESP2 values and their meanings 281

Page 302: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user is not authorizedfor this command

DISCARDJOURNALNAME

INVREQ 3 The specified journalname (for example, thesystem log) cannot bediscarded

JIDERR 1 The journal cannot befound

NOTAUTH 100 The user is not authorizedfor this command

101 The user does not havethe required accessauthority to the specifiedjournal name

DISCARDPARTNER

PARTNERIDERR 1 The partner cannot befound

5 The Partner ResourceManager (PRM) is notactive, because it failed toinitialize during CICSinitialization

INVREQ 2 The partner definition iscurrently in use

3 The partner cannot bediscarded because itsname begins with DFH

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

DISCARDPROFILE

PROFILEIDERR 1 The profile cannot befound

INVREQ 2 The profile definition iscurrently in use

3 A transaction definitionpoints to the profile

4 The profile cannot bediscarded because itsname begins with DFH

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

282 CICS User’s Handbook

Page 303: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

DISCARDPROGRAM

INVREQ 1 The resource cannot bediscarded because itsname begins with DFH

11 The resource definition iscurrently in use

15 The resource cannot bediscarded because it is auser-replaceable module

PGMIDERR 7 The resource definitioncannot be found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

DISCARDREQUESTMODEL

NOTFND 1 The requested modelname was not found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

DISCARDTCPIPSERVICE

INVREQ 9 The TCPIPservice is stillopen

NOTFND 3 The TCPIPSERVICEname was not found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

DISCARDTDQUEUE

QIDERR 1 The queue cannot befound

INVREQ 11 The queue name beginswith the letter C

18 The queue is not closed 30 Disable pending 31 The queue is not disabled

Chapter 9. RESP2 values and their meanings 283

Page 304: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

DISCARDTERMINAL

TERMIDERR 23 Named terminal cannot befound

INVREQ 33 APPC session or device 38 Terminal type not VTAM

or console 39 Not out of service and not

remote 40 Error console 41 MRO session 43 Delete failed 44 Remote and in-use 45 Locked by another RDO

action 46 Delete already in flight 200 The command was

executed in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET

NOTAUTH 100 The use of this commandis not authorized

DISCARDTRANCLASS

TCIDERR 1 The transaction classcannot be found

284 CICS User’s Handbook

Page 305: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ 2 The TRANCLASSdefinition is in use

12 The transaction classcannot be discardedbecause installedtransactions belong to it

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

DISCARDTRANSACTION

TRANSIDERR 1 The transaction cannot befound

INVREQ 4 The transaction cannot bediscarded because itsname begins with C

13 The transaction is a SITparameter

14 The transaction isscheduled to run at afuture time (in use by aninterval control element)

15 The transaction isscheduled to run whenrequired resources areavailable (in use by anautomatic initiatedescriptor)

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

DISCARDTSMODEL

NOTFND 1 The TSMODEL does notexist

INVREQ 2 The TSMODEL definitionis currentl in use

3 The TS model cannot bediscarded because itsname begins with DFH

Chapter 9. RESP2 values and their meanings 285

Page 306: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to discard aTSMODEL with this name

DUMPTRANSACTION

SUPPRESSED 1 The transaction dump issuppressed by MAXIMUMin table

2 The transaction dump issuppressed byNOTRANDUMP in table

3 The transaction dump issuppressed by a user exitprogram

NOSPACE 4 The transaction dump isincomplete due to lack ofspace

NOSTG 5 CICS has run out ofworking storage

NOTOPEN 6 The current CICS dumproutine is not open

OPENERR 7 Error on opening, closing,or writing to, the currentCICS dump routine

IOERR 9 The SDUMP process wasnot authorized

10 An error occurred duringsystem dumping

13 The CICS routine issuingthe SDUMP was unableto establish a recoveryroutine (FESTAE)

INVREQ 13 An incorrect DUMPCODEwas specified.DUMPCODE must notcontain leading orimbedded blanks

ENABLEPROGRAM

NOTAUTH 100 The user associated withthe issuing task is notauthorized to issue thiscommand

286 CICS User’s Handbook

Page 307: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

101 The user associated withthe task is not authorizedto access this particularresource in the wayrequired by thiscommand.

ENDBR FILENOTFOUND 1 The name referred to in

the FILE option cannot befound in the FCT

INVREQ 35 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

ILLOGIC 110 A VSAM error which doesnot fall within one of theother CICS responsecategories has occurred.

IOERR 120 There has been an I/Oerror during the operation

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining a connection); orthe link to the remotesystem is closed.

ENQ LENGERR 1 The value specified for

the LENGTH option isoutside the range 1–255

INVREQ 2 The MAXLIFETIME optionhas an incorrect CVDA

ENTERTRACENUM

INVREQ 1 TRACENUM is outsidethe range 0–199

2 There is no valid tracedestination

Chapter 9. RESP2 values and their meanings 287

Page 308: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

3 The user trace master flagis set OFF andEXCEPTION has notbeen specified

LENGERR 4 FROMLENGTH is outsidethe range 0–4000specified

EXTRACTATTRIBUTES(APPC)

INVREQ 200 A distributed program linkserver applicationexplicitly, or implicitly bydefault, specified thefunction-shipping session(its principal facility) onthe CONVID option

EXTRACTATTRIBUTES(MRO)

INVREQ 200 A distributed program linkserver applicationexplicitly, or implicitly bydefault, specified thefunction-shipping session(its principal facility) onthe CONVID option

EXTRACT EXIT NOTAUTH 100 The user associated with

the issuing task is notauthorized to issue thiscommand

101 The user associated withthe task is not authorizedto access this particularresource in the wayrequired by thiscommand.

EXTRACTPROCESS

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

FORMATTIME INVREQ 1 The ABSTIME option is inan incorrect format

288 CICS User’s Handbook

Page 309: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

FREE (APPC) INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

FREEMAIN INVREQ 1 The storage specified bythe DATA orDATAPOINTERparameter was notstorage acquired by aGETMAIN command

2 The storage areaspecified by the DATA orDATAPOINTERparameter was inCICS-key storage, andthe program issuing theFREEMAIN commandwas in user-key.

GETMAIN LENGERR 1 The FLENGTH value was

less than 1 or greaterthan the length of thetarget storage area fromwhich the request was tobe satisfied

NOSTG 2 The storage requestedwas more than wascurrently available in thetarget DSA

HANDLEABEND

PGMIDERR 1 The program has no entryin the PPT and autoinstallfor programs is not active

2 The program is disabled 9 The installed program

definition is for a remoteprogram

HANDLE AID INVREQ 200 The command was issued

by a distributed programlink server application

Chapter 9. RESP2 values and their meanings 289

Page 310: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INQUIREAUTINSTMODEL

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

MODELIDERR 1 The model specifiedcannot be found

END 2 There are no moreresource definitions of thistype

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREAUTOINSTALL

INVREQ 20 The console has aninvalid CVDA value

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRECFDTPOOL

END 2 There are no morecoupling facility data tablepools to browse

ILLOGIC 1 START command issuedwhen CFDTPOOLsalready in progress, orNEXT or END issuedwhen CFDTPOOLs is notin progress

POOLERR 1 Named CFDTPOOL wasnot found

2 An internal controlstructure that CICS usesto maintain access toCFDT pools has beenaltered while the set ofpools known to CICS wasbeing browsed.

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

290 CICS User’s Handbook

Page 311: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INQUIRECONNECTION

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SYSIDERR 1 The named connectioncould not be found

INQUIREDB2CONN

NOTFND 1 The requested DB2CONNcannot be found

NOTAUTH 100 Command authorizationfailure

INQUIREDB2ENTRY

NOTFND 1 The requestedDB2ENTRY cannot befound

NOTAUTH 100 Command authorizationfailure

101 Resource authorizationfailure

INQUIREDB2TRAN

NOTFND 1 The requested DB2TRANcannot be found

NOTAUTH 100 Command authorizationfailure

101 Resource authorizationfailure

INQUIREDELETSHIPPED

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREDOCTEMPLATE

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

Chapter 9. RESP2 values and their meanings 291

Page 312: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

MODELIDERR 1 The DOCTEMPLATEspecified cannot be found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREDSNAME

DSNNOTFOUND 1 The data set cannot befound

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

IOERR 40 QUIESCESTATE wasspecified, but an errorwas raised by DFSMSreading the ICF catalog

49 An error was raised byDFSMS reading the ICFcatalog to establish thebase data set name

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREDUMPDS

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREENQMODEL

END 2 There are no moreresource definitions of thistype

NOTFND 1 The ENQMODEL cannotbe found

292 CICS User’s Handbook

Page 313: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 1 A START has beenissued when a browse ofthis resoutrce type isalready in progress, or aNEXT ot END issuedwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

INQUIRE EXCI END 2 There are no more

resource definitions of thistype

ILLOGIC 1 A START has beenissued when a browse ofthis resoutrce type isalready in progress, or aNEXT ot END issuedwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

INQUIREEXITPROGRAM

END 2 There are no moreresource definitions of thistype

INVREQ 3 The exit point identified by

EXIT does not exist

Chapter 9. RESP2 values and their meanings 293

Page 314: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

PGMIDERR 1 � The exit identified byEXITPROGRAM andENTRYNAME is notenabled, or

� The EXIT parameteris missing for aninquiry on a globaluser exit, or

� The EXIT parameteris present on atask-related user exit

INQUIRE FILE END 2 There are no more

resource definitions asthis type

FILENOTFOUND 1 The file cannot be found ILLOGIC 1 A START has been given

when a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

294 CICS User’s Handbook

Page 315: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

INQUIRE IRC NOTAUTH 100 The user associated with

the issuing task is notauthorized to use thiscommand

INQUIREJOURNALMODEL

END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwithout a precedingSTART

2 The browse token is notvalid

NOTFND 1 The specified journalmodel was not found

NOTAUTH 100 The user is not authorizedfor this command

INQUIREJOURNALNAME

END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwithout a precedingSTART

2 The browse token is notvalid

JIDERR 1 The specified journalname was not found

Chapter 9. RESP2 values and their meanings 295

Page 316: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user is not authorizedfor this command

101 The user does not havethe required accessauthority to the specifiedresource (Not applicableto INQUIREJOURNALNAME START,INQUIREJOURNALNAME NEXT,or INQUIREJOURNALNAME ENDcommands)

INQUIREMODENAME

END 2 There are no moreresource difinitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT orEND has been givenwhen a browse of thisresource type is not inprogress

SYSIDERR 1 The connection cannot befound

2 The modename within theconnection cannot befound

3 The connection specifiedon an INQUIREMODENAME NEXTcannot be found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREMONITOR

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREPARTNER

END 2 There are no moreresource definitions of thistype

296 CICS User’s Handbook

Page 317: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress

PARTNERIDERR 1 The partner cannot befound

2 Partner ResourceManager (PRM) is notactive, because it failed toinitialize during CICSinitialization

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREPROFILE

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

PROFILEIDERR 1 The profile cannot befound

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREPROGRAM

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or or a NEXTor an END has beengiven when a browse ofthis resource type is not inprogress

PGMIDERR 1 The program cannot befound

Chapter 9. RESP2 values and their meanings 297

Page 318: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

INQUIREREQID

NOTFND 1 The REQID cannot befound

ILLOGIC 1 You have issued aSTART command when abrowse is already inprogress, or a NEXT oran END issued when abrowse of this resourcetype is not in progress

END 2 There are no moreresource definitions of thistype

INVREQ 3 An I/O error occurredwhile an attempt wasmade to read data fromtemporary storage for theSET, QUEUE, RTERMIDor RTRANSID option

4 Data required for the SET,QUEUE, RTERMID orRTRANSID option cannotbe returned because ithas been deleted fromtemporary storage

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIREREQUESTMODEL

NOTFND 1 The specified erquestmodel was not found

298 CICS User’s Handbook

Page 319: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 1 You have issued aSTART command when abrowse is already inprogress, or a NEXT oran END issued when abrowse of this resourcetype is not in progress

END 2 All authorized resourcedefinitions have beenretrieved

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRESTATISTICS

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRESTORAGE

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

TASKIDERR 1 The task number does notexist

2 The task number is asystem task, not a usertask

INQUIRESTREAMNAME

NOTAUTH 100 The user is not authorizedfor this command

END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged

NOTFND 1 The requested log streamname was not found

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwithout a precedingSTART

2 The browse token is notvalid

Chapter 9. RESP2 values and their meanings 299

Page 320: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INQUIRESYSDUMPCODE

END 2 There are no moreresource definitions of thistype

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

ILLOGIC 1 A START command hasbeen issued when abrowse is already inprogress or a NEXT or anEND command issuedwhen a browse of thisresource type is not inprogress

NOTFND 1 The named dump codecannot be found

INQUIRESYSTEM

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRE TASK TASKIDERR 1 The named task cannot

be found 2 The task is executing a

type of transaction whichis not subject to thiscommand operator

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INVREQ 1 SUSPENDVALUE isspecified but significantcharacters are lost

3 TCLASS is specified butCLASS is named. Theuser should specify theTRANCLASS option

10 Requested data is held ona data profile, but the datais not available

300 CICS User’s Handbook

Page 321: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INQUIRE TASKLIST

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRETCLASS

TCIDERR 1 The named task classcannot be found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRE TCPIP INVREQ 4 TCPIP=NO has been

specified in the systeminitialization table (SIT)

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRETCPIPSERVICE

NOTFND 3 Named TCPIPSERVICEwas not found

ILLOGIC 1 A START command hasbeen issued when abrowse is already inprogress or a NEXT or anEND command issuedwhen a browse of thisresource type is not inprogress

END 2 There are no moreresource definitions of thistype

INVREQ 4 TCPIP not available(TCPIP=NO)

5 TCPIP is closed NOTAUTH 100 The user associated with

the issuing task is notauthorized to use thiscommand

INQUIRETDQUEUE

ENDCOND 2 There are no moreresource definitions of thistype

ILLOGIC 1 Browse sequence error

Chapter 9. RESP2 values and their meanings 301

Page 322: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

QIDERR 1 The named queue cannotbe found

NORMAL 0 No errors INQUIRETERMINAL

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

TERMIDERR 1 The named terminalcannot be found

INQUIRETRACEDEST

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRETRACEFLAG

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRETRACETYPE

NOTFND 1 CICS was initializedwithout support for atleast one of thecomponents listed in thecommand; trace levelswere returned for all othercomponents

302 CICS User’s Handbook

Page 323: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

INQUIRETRANCLASS

INVREQ 12 The TRANCLASSdefinition is in use

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access theparticular resource in theway required by thiscommand

TCIDERR 1 The transaction classcannot be found

INQUIRETRANDUMPCODE

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

NOTFND 1 The dump code cannot befound

INQUIRETRANSACTION

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress

Chapter 9. RESP2 values and their meanings 303

Page 324: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

TRANSIDERR 1 The transaction could notbe found

INVREQ 3 The TCLASS option hasbeen specified in thisINQUIRE command, andthe transaction belongs toa class that is not one ofthe numbered classesDFHTCL00 throughDFHTCL10

NORMAL 10 The profile definitionassociated with thetransaction is notavailable

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

INQUIRETSMODEL

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress

NOTFND 1 The TSMODEL does notexist

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

304 CICS User’s Handbook

Page 325: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INQUIRETSPOOL

END 2 There are no moreresource definitions of thistype

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress

NOTFND 1 The TSPOOL does notexist

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

INQUIRETSQUEUE/TSQNAME

END 2 There are no moreresource definitions of thistype

INVREQ 1 The specified SYSID doesnot exist in anyTYPE=SHARED entry inthe temporary storagetable

2 When INQUIRETSQUEUE NEXT isspecified, the NEXTqueue to be browsed hasa Queuename of morethan 8 significantcharacters. The queuename is truncated, somesignificant characters arelost.

4 This TSQNAME cannotbe deleted as it waswritten by CICS usingPUTQ macro

Chapter 9. RESP2 values and their meanings 305

Page 326: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

POOLERR 3 The POOLNAME doesnot exist

QIDERR 1 The temporary storagequeue cannot be found

SYSIDERR 3 The SYSID does not mapto a shared pool

4 An error has occurred inthe shared TS server

5 An I/O error has occurredon the coupling facility

INQUIRE UOW END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged

ILLOGIC 1 A browse of this resourcetype is already inprogress, or an INQUIREUOW START commandhas not been issued

UOWNOTFOUND 1 A named UOW cannot befound

NOTAUTH 100 A use of this command isnot authorized

INQUIREUOWDSNFAIL

END 2 There are no moreUOW/data set pairs

306 CICS User’s Handbook

Page 327: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXThas been given without apreceding START

NOTAUTH 100 A use of this command isnot authorized

INQUIREUOWENQ

END 2 All enqueues have beenretrieved

ILLOGIC 1 � For INQUIREUOQENQ START - abrowse of thisresource is already inprogress

� For INQUIREUOWENQ NEXT andINQUIRE UOWENQEND - an INQUIREUOWENQ STARTcommand has notbeen issued

UOWNOTFOUND 1 The named UOW cannotbe found

NOTAUTH 100 A use of this command isnot authorized

INQUIREUOWLINK

END 2 All authorized resourcedefinitions have beenretrieved

ILLOGIC 1 � For INQUIREUOQLINK START - abrowse of thisresource is already inprogress

� For INQUIREUOWLINK NEXT andINQUIRE UOWLINKEND - an INQUIREUOWLINK STARTcommand has notbeen issued

UOWLNOTFOUND 1 The named UOW-linkcannot be found

UOWNOTFOUND 1 The named UOW cannotbe found

NOTAUTH 100 A use of this command isnot authorized

Chapter 9. RESP2 values and their meanings 307

Page 328: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INQUIREVOLUME

VOLIDERR 1 The program has issuedan INQUIRE VOLUMEbrowse command. Thiscommand is withdrawn

INQUIRE VTAM INVREQ 1 VTAM is not present in

the system NOTAUTH 100 The user associated with

the issuing task is notauthorized to use thiscommand

INQUIRE WEB INVREQ 11 An invalid value was

supplied for one of theoptions

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

ISSUE ABEND INVREQ 200 A distributed program link

server applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE ABORT INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE ADD INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUECONFIRMATION

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

308 CICS User’s Handbook

Page 329: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ISSUE END INVREQ 200 A distributed program link

server applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE ENDFILE INVREQ 200 A distributed program linkserver applicationattempted to send on itsfunction-shipping session,its principal facility

ISSUEENDOUTPUT

INVREQ 200 A distributed program linkserver applicationattempted to send on itsfunction shipping session,its principal facility

ISSUE EODS INVREQ 200 A distributed program linkserver applicationattempted to send on itsfunction shipping session,its principal facility

ISSUE ERASE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUEERASEAUP

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE ERROR INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping sessionon the CONVID option

Chapter 9. RESP2 values and their meanings 309

Page 330: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ISSUE NOTE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUEPREPARE

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE PRINT INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE QUERY INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUERECEIVE

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUEREPLACE

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE RESET INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

310 CICS User’s Handbook

Page 331: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ISSUE SEND INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE SIGNAL(APPC)

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

ISSUE WAIT INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

LINK INVREQ 8 A LINK command with theINPUTMSG option isissued for a program thatis not associated with aterminal, or that isassociated with an APPClogical unit, or an IRCsession

14 The SYNCONRETURNoption is specified but theprogram issuing the linkrequest (the clientprogram) is already inconversation with a mirrortask (that is, a logicalunit-of-work (LUW) is inprogress) in the remoteregion specified on theSYSID option. In thiscase, the client program isin an incorrect state tosupport theSYNCONRETURN option

Chapter 9. RESP2 values and their meanings 311

Page 332: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

15 The program issuing thelink request is already inconversation with a mirrortask and the TRANSIDspecified is different fromthe transaction identifier ofthe active mirror

16 The TRANSID specified isall blanks

19 A LINK command with theINPUTMSG option isissued for a program thatis the subject of a DPLrequest; that is, SYSID isalso specified

30 The program managerdomain has not yet beeninitialized. This is probablydue to a link requesthaving been made in afirst stage PLT

LENGERR 11 The COMMAREA lengthis less than 0 or greaterthan 32767

12 The length specified onthe DATALENGTH optionis a negative value

13 The length specified onthe DATALENGTH optionis greater than the lengthspecified on the LENGTHoption

26 The COMMAREA addressis zero, but theCOMMAREA length isnon zero

27 The INPUTMSG length <0 or > 32767

NOTAUTH 101 A resource security checkhas failed onPROGRAM(name)

312 CICS User’s Handbook

Page 333: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

PGMIDERR 1 A program has no entry inthe PPT and eitherprogram autoinstall wasswitched off, or theprogram autoinstall controlprogram indicated that theprogram should not beautoinstalled

2 A program is disabled 3 A program cannot be

loaded because

� This was the first loadof the program andthe program loadfailed, usuallybecause the loadmodule could not befound

� This was asubsequent load ofthe program, but thefirst load failed

In order to reset the loadstatus the load modulemust be in the DFHRPLconcatenation, and a SETPROGRAM NEWCOPYwill be required

21 The program autoinstallcontrol program failedeither because theprogram autoinstall controlprogram is incorrect,incorrectly defined, or asa result of an abend in theprogram autoinstall controlprogram. Programautoinstall is disabled andmessage DFHPG0202 orDFHPG0203 written to theCSPL

22 The model returned bythe program autoinstallcontrol program is notdefined in the PPT table,or is not enabled

Chapter 9. RESP2 values and their meanings 313

Page 334: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

23 The program autoinstallcontrol program returnedinvalid data

24 Define for the programfailed due to autoinstallreturning an invalidprogram name ordefinition

ROLLEDBACK 29 The SYNCONRETURNwas specified and theserver program wasunable successfully totake a syncpoint. Theserver program has takena rollback, and allchanges made torecoverable resources inthe remote region, withinthe current UOW, arebacked out

SYSIDERR 18 The SYSID specifiedcannot be found in theintersystem table, or thelink to the specifiedsystem is unavailable

20 The remote systemspecified by SYSID is anLUTYPE6.1-connectedsystem. Distributedprogram link requests arenot supported onLUTYPE6.1 connections

TERMERR 17 An unrecoverable erroroccurred during theconversation with themirror (for example, thesession failed or theserver region failed)

LOAD INVREQ 30 The program manager

domain has not yet beeninitialized. This is probablydue to a load requesthaving been made in afirst stage PLT

314 CICS User’s Handbook

Page 335: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LENGERR 19 LENGTH is used and thelength of the loadedprogram is not less than32KB

NOTAUTH 101 A resource security checkhas failed onPROGRAM(name)

PGMIDERR 1 A program, table, or maphas no entry in the PPTand either programautoinstall was switchedoff, or the programautoinstall control programindicated that the programshould not beautoinstalled

2 A program is disabled 3 A program cannot be

loaded because

� This was the first loadof the program andthe program loadfailed, usuallybecause the loadmodule could not befound

� This was asubsequent load ofthe program, but thefirst load failed

In order to reset the loadstatus the load modulemust be in the DFHRPLconcatenation, and a SETPROGRAM NEWCOPYwill be required

9 The installed programdefinition is for a remoteprogram

Chapter 9. RESP2 values and their meanings 315

Page 336: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

21 The program autoinstallcontrol program failedeither because theprogram autoinstall controlprogram is incorrect,incorrectly defined, or asa result of an abend in theprogram autoinstall controlprogram. Programautoinstall is disabled andmessage DFHPG0202 orDFHPG0203 written to theCSPL

22 The model returned bythe program autoinstallcontrol program was notdefined in the PPT table,or was not enabled

23 The program autoinstallcontrol program returnedinvalid data

24 Define for the programfailed due to autoinstallreturning an invalidprogram name ordefinition

MONITOR INVREQ 1 POINT value is outside

the range 1–255 2 POINT value is not

defined in the MCT 3 DATA1 value is not valid 4 DATA2 value is not valid 5 DATA1 value not

specified for an MCToperation that required it

6 DATA2 value notspecified for an MCToperation that required it

PERFORMDELETSHIPPED

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

316 CICS User’s Handbook

Page 337: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

PERFORMDUMP

SUPPRESSED 1 The dump was not takenbecause the number ofdumps with this dumpcode exceeds themaximum for the code

2 The dump was not takenbecause the system dumptable entry for this codeindicates no system dump

3 The dump was not takenbecause it wassuppressed by a user exitprogram

8 The dump was not takenbecause system dumpsare suppressed globally

NOSPACE 4 The dump is incompletedue to lack of dumpdata-set space

NOSTG 5 CICS cannot complete thedump because ofinsufficient storage

INVREQ 6 TITLELENGTH is greaterthan 80 bytes

7 CALLERLENGTH isgreater than 8 bytes

13 The DUMPCODEcontains leading orimbedded blanks

IOERR 9 CICS is not authorized byMVS to take dumps

10 An error occurs duringsystem dumping

12 MVS cannot process thedump because there is nodump data set or becauseit is full

13 An error occurred in theCICS routine that issuesMVS SDUMP requests

SYSBUSY 11 The MVS dump routine isbusy. Retry the command

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 317

Page 338: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

PERFORMENDAFFINITY

INVREQ 25 The connection is still inservice

26 There may be recoveryinformation outstandingfor the connection.RECOVSTATUS has avalue other thanNORECOVDATA

32 See messageDFHZC0178. VTAM couldnot end the affinity for areason other than 35(NOTFOUND) or 36(SESSIONS ACTIVE)

34 Enter NETID. NETID wasnot specified, and cannotbe obtained from theinstalled connection. Thismay be because theconnection does not exist,or because it does notcontain a NETID value

35 VTAM could not find anaffinity for the values input

36 VTAM could not end theaffinity because theconnection had somesessions active

37 See messageDFHZC0176. A VTAMerror prevented theCHANGE AFFINITYmacro being carried out

PERFORMRESETTIME

INVREQ 1 There is no clock in thesystem

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

PERFORMSECURITYREBUILD

INVREQ 1 No ESM is installed, orthe ESM is inactive

5 The ESM is temporarilyinactive and cannotperform the actionrequested

318 CICS User’s Handbook

Page 339: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

IOERR 3 Error returned from ESM.The return code is inESMRESP, if the optionwas used

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

NORMAL 0 Profiles have beenrefreshed

4 No action is required,because RACF is atVersion 2.1 (or later), andso profiles are refreshedautomatically

SYSBUSY 3 A security rebuild iscurrently in progress

PERFORMSHUTDOWN

INVREQ 1 A normal shutdown hasbeen requested whenshutdown was already inprogress

2 The XLT cannot be found 3 The PLT cannot be found 4 XRF is not in effect 5 The transaction specified

on SDTRAN is notenabled for shutdown

6 The transaction specifiedon SDTRAN is notdefined as remote

7 The transaction specifiedon SDTRAN is notenabled

TRANSIDERR 1 The shutdown transactionspecified on SDTRANwas not found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 319

Page 340: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

PERFORMSTATISTICSRECORD

IOERR n Statistics for at least oneof the options chosenwere not available; usuallythe reason for this error iscorruption of the memoryin which they areaccumulated. (See below)

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

NOTFND n Statistics for at least oneof the options chosenwere not availablebecause CICS wasinitialized without supportfor the function. (Seebelow)

The values of “n” are asfollows:

1 AUTOINSTALL 2 CONNECTION 3 DISPATCHER 6 FILE

8 JOURNALNUM andJOURNALNAME

10 LSRPOOL 11 MONITOR 12 PROGRAM 13 STATS 14 STORAGE 15 SYSDUMP 16 TABLEMGR 18 TCLASS,

TRANCLASS 19 TDQUEUE 20 TERMINAL 21 TRANDUMP 22 TRANSACTION 23 TSQUEUE 24 VTAM 25 FEPI 26 PROGAUTO 28 ENQUEUE 29 RECOVERY 30 STREAMNAME

320 CICS User’s Handbook

Page 341: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

POST INVREQ 4 Hours are out of range 5 Minutes are out of range 6 Seconds are out of range PURGEMESSAGE

INVREQ 200 The command was calledin a distributed programlink server program

QUERYSECURITY

NOTFND 1 The RESID is not valid

2 The RESTYPE is not valid 3 The RESID value for

RESTYPE(SPCOMMAND) is notvalid

5 The RESCLASS is notdefined to the externalsecurity manager (ESM)

8 The resource is notprotected

Possible causes include

� RESCLASS notactive

� No profile found

� ESM not active QIDERR 1 No indirect queue name

associated with the givenRESID has been found

LENGERR 6 The RESIDLENGTH valueis not valid, that is, not inthe range 1–246

INVREQ 7 The CVDA value is notvalid for theLOGMESSAGE

9 The RESID is invalid orfilled with blanks

10 The external securitymanager (ESM) is inactiveor not present

READ FILENOTFOUND 1 The file name referred to

in the FILE option cannotbe found in the FCT

Chapter 9. RESP2 values and their meanings 321

Page 342: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LENGERR 10 Neither the LENGTH norSET options have beenspecified on a READcommand for a file withvariable-length records orfor a BDAM file withvariable-length orundefined-format records

11 The length of a recordread with the INTO optionspecified exceeds thevalue specified in theLENGTH option; therecord is truncated, andthe data area supplied inthe LENGTH option is setto the actual length of therecord

13 An incorrect length isspecified for a file withfixed-length records

INVREQ 20 Read is not allowedaccording to the file entryspecification in the FCT ora read command with theUPDATE option has beenissued to a file whereupdate operations are notallowed according to thefile entry specification inthe FCT

25 The KEYLENGTH andGENERIC options arespecified and the lengthspecified in theKEYLENGTH option isgreater than or equal tothe length of a full key

26 The KEYLENGTH optionis specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers

322 CICS User’s Handbook

Page 343: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

28 Following a READUPDATE command for afile, another READUPDATE command isissued for a filereferencing the same dataset before exclusivecontrol is released by aREWRITE, UNLOCK, orDELETE command

40 A BDAM key conversionerror occurred

42 The KEYLENGTH andGENERIC options arespecified, and the lengthspecified in theKEYLENGTH option isless than or equal to zero

44 The command does notconform to the format ofREAD for auser-maintained table; forexample if GTEQ isspecified with UPDATE

51 A READ to a KSDS filethat was being accessedin RLS mode specified theRBA keyword. RLS modedoes not support relativebyte address access toKSDS data sets

52 A READ request to anon-RLS file specifiedCONSISTENT

53 A READ request to anon-RLS file specifiedREPEATABLE

55 A READ request to anon-RLS file specifiedNOSUSPEND, which isnot allowed because thefile is not a VSAM fileaccessed in RLS mode

Chapter 9. RESP2 values and their meanings 323

Page 344: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

DISABLED 50 A file was initially definedas disabled and has notsince been enabled or ithas been disabled by anEXEC CICS SET FILE orthe CEMT SET FILEcommand

NOTOPEN 60 The requested file isCLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but aCLOSE request against ithas been received or aREAD command hasbeen issued against adata set that is quiesced,or is being quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED command

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedis unsuccessful or, foruser-maintained datatables, an attempt to reada record is unsuccessfulbecause there is no entrywith the specified key inthe data table

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

324 CICS User’s Handbook

Page 345: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LOADING 104 A READ UPDATE hasbeen issued for auser-maintained datatable that is currentlybeing loaded or a READGENERIC has beenissued for auser-maintained datatable that is currentlybeing loaded

LOCKED 106 An attempt has beenmade to read a recordeither specifying theUPDATE keyword, orspecifying (explicitly orimplicitly) CONSISTENTor REPEATABLE, but therecord was locked by aretained lock

RECORDBUSY 107 The NOSUSPENDkeyword was specifiedand the record was lockedby an active lock

ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during the READoperation

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.

DUPKEY 140 A record has beenretrieved by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key follows.

Chapter 9. RESP2 values and their meanings 325

Page 346: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

READNEXT FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT

LENGERR 10 Neither the LENGTH norSET options have beenspecified for a file withvariable-length records orfor a BDAM file withundefined-format records

11 The length of a recordread with the INTO optionspecified exceeds thevalue specified in theLENGTH option; therecord is truncated, andthe data areas supplied inthe LENGTH option is setto the actual length of therecord

13 An incorrect length isspecified for a file withfixed-length records

INVREQ 20 The FILE definition doesnot allow updates

INVREQ 25 The KEYLENGTH optionis specified for a genericbrowse (that is one whereGENERIC was specifiedon the STARTBR or thelast RESETBR) and thevalue of KEYLENGTHwas greater than the fullkey length

26 The KEYLENGTH optionis specified for anongeneric browse, andthe specified length doesnot equal the lengthdefined for the data set towhich this file refers

34 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand

326 CICS User’s Handbook

Page 347: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

37 The type of recordidentification used toaccess a data set duringthe browse is changed bythe READNEXT command

42 The KEYLENGTH optionis specified for a genericbrowse (that is one whereGENERIC was specifiedon the STARTBR or thelast RESETBR) and thevalue of KEYLENGTH isless than zero

52 CONSISTENT is notallowed because the file isnot a VSAM file that isaccessed in RLS mode

53 REPEATABLE is notallowed because the file isnot a VSAM file that isaccessed in RLS mode

54 UPDATE is not allowedbecause the file is not aVSAM file that isaccessed in RLS mode

55 NOSUSPEND is notallowed because the file isnot a VSAM file that isaccessed in RLS mode

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedis unsuccessful

ENDFILE 90 An end-of-file conditionhas been detected duringa browse

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

Chapter 9. RESP2 values and their meanings 327

Page 348: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LOCKED 106 The read requestspecified the UPDATEkeyword, or one of theread integrity keywordsCONSISTENT orREPEATABLE, or the fileresource definitionspecified read integrity,but VSAM held a retainedlock against the record

RECORDBUSY 107 NOSUSPEND wasspecified on the requestbut VSAM held an activelock against the record,which would cause therequest to wait

ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during theREADNEXT command

SYSIDERR 130 The SYSID optionspecifies a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.

DUPKEY 140 A record has beenretrieved by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key follows

READPREV FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT

LENGERR 10 Neither the LENGTH norSET options have beenspecified for a file withvariable-length records

328 CICS User’s Handbook

Page 349: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

11 The length of a recordread with the INTO optionspecified exceeds thevalue specified in theLENGTH option; therecord is truncated, andthe data area supplied inthe LENGTH option is setto the actual length of therecord

13 An incorrect length isspecified for a file withfixed-length records

INVREQ 20 The FILE definition doesnot allow updates

24 A READPREV commandis issued for a file forwhich the previousSTARTBR or RESETBRcommand has theGENERIC option

26 The KEYLENGTH optionis specified and thespecified length does notequal the length definedfor the data set this filerefers to

37 The type of recordidentification used toaccess a data set duringthe browse is changed

39 A READPREV is issuedfor a BDAM file

41 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand

52 CONSISTENT is notallowed because the file isnot a VSAM file that isaccessed in RLS-mode

53 REPEATABLE is notallowed because the file isnot a VSAM file that isaccessed in RLS-mode

Chapter 9. RESP2 values and their meanings 329

Page 350: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

54 UPDATE is not allowedbecause the file is not aVSAM file that isaccessed in RLS-mode

55 NOSUSPEND is notallowed because the file isnot a VSAM file that isaccessed in RLS-mode

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedis unsuccessful

ENDFILE 90 An end-of-file conditionhas been detected duringa browse

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

LOCKED 106 The read requestspecified the UPDATEkeyword, or one of theread integrity keywordsCONSISTENT orREPEATABLE, or the fileresource definitionspecified read integrity,but VSAM held a retainedlock against the record

RECORDBUSY 107 NOSUSPEND wasspecified on the requestbut VSAM held an activelock against the record,which would cause therequest to wait

ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during the browse

330 CICS User’s Handbook

Page 351: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SYSIDERR 130 The SYSID optionspecified a name that hasnot been defined to CICSas a remote system(defined by defining aCONNECTION); or thelink to the remote systemis closed.

DUPKEY 140 A record has beenretrieved by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key exists

RECEIVE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

RELEASE PGMIDERR 1 A program, table, or maphas no entry in the PPT

2 A program, table, or mapis disabled

9 The installed programdefinition is for a remoteprogram

INVREQ 5 An invalid attempt hasbeen made by a programto release itself

6 A RELEASE commandhas been issued for aprogram that is not loaded

7 A RELEASE commandhas been issued for aprogram that is loaded,without the HOLD option,by another task

17 A program has beendefined withRELOAD=YES. It must bereleased by a FREEMAINrather than a RELEASEcommand

Chapter 9. RESP2 values and their meanings 331

Page 352: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

30 The program managerdomain has not yet beeninitialized

RESETBR FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT

INVREQ 25 The KEYLENGTH andGENERIC options arespecified and the lengthspecified in theKEYLENGTH option isgreater than or equal tothe length of a full key

26 The KEYLENGTH optionis specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers

36 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand

42 The KEYLENGTH andGENERIC options arespecified, and the lengthspecified in theKEYLENGTH option isless than zero

51 A RESETBR command toa KSDS file that wasbeing accessed in RLSmode specified the RBAkeyword. RLS mode doesnot support RBA accessto KSDS data sets

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedhas been unsuccessful

332 CICS User’s Handbook

Page 353: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during the file controloperation

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.

RESYNCENTRYNAME

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

RETURN INVREQ 1 A RETURN commandwith the TRANSID optionhas been issued by aprogram that is notassociated with a terminal

2 A RETURN commandwith the COMMAREA orIMMEDIATE option hasbeen issued in a programthat is not at the highestlogical level

4 A RETURN commandwith the TRANSID optionhas been issued in aprogram that is associatedwith an APPC logical unit

Chapter 9. RESP2 values and their meanings 333

Page 354: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

8 A RETURN commandwith the INPUTMSGoption has been issuedfor a program that is notassociated with aterminal, or that isassociated with an APPClogical unit, or an IRCsession

30 PG domain is notinitialized. Parameters arenot allowed on the EXECRETURN statement infirst stage PLT programs

200 A RETURN command hasbeen issued with anINPUTMSG option in aprogram invoked by DPL

LENGERR 11 The COMMAREA lengthis less than 0 or greaterthan 32763

26 The COMMAREAADDRESS passed waszero, but the commarealength was non-zero

27 The INPUTMSG LENGTHwas less than 0 or greaterthan 32767

REWRITE FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT

LENGERR 10 The length option has notbeen specified for a filewith variable-lengthrecords, or for a BDAMfile with undefined formatrecords

12 The length specifiedexceeds the maximumrecord size

14 An incorrect length isspecified for a file withfixed-length records

334 CICS User’s Handbook

Page 355: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ 30 A REWRITE commandhas been issued without atoken and no previousREAD for UPDATE (alsowithout a token) can befound

46 A REWRITE commandhas attempted to changethe length of a BDAMvariable length record orblock

47 A REWRITE instructionincluded a token whosevalue cannot be matchedagainst any token in usefor an existing READ forUPDATE request

55 NOSUSPEND is notallowed because the file isnot a VSAM file accessedin RLS mode

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOSPACE 100 No space is available onthe direct access devicefor adding the updatedrecord to the data set

103 For user-maintained datatables, CICS is unable toget sufficient storage inthe CICS address spaceto store the updated datatable entry

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

Chapter 9. RESP2 values and their meanings 335

Page 356: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LOCKED 106 When updating a recordvia a base key or analternate key, an attemptwas made to modify analternate key containedwithin the record (not thekey by which the updatewas made) and the newvalue of the alternate keyis the subject of aretained lock held byanother transaction

RECORDBUSY 107 The NOSUSPENDkeyword was specifiedand the record was foundto be locked by an activelock in VSAM

ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during the file controloperation

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.

DUPREC 150 An attempt has beenmade to rewrite a recordto a data set whoseupgrade set has analternate index with theUNIQUEKEY attribute, ifthe correspondingalternate key alreadyexists in the alternateindex

ROUTE INVREQ 4 Hours are out of range 5 Minutes are out of range 6 Seconds are out of range

336 CICS User’s Handbook

Page 357: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

200 BMS commands are notsupported for distributedprogram link

SEND INVREQ 200 A distributed program linkserver application hasattempted to send on itsfunction-shipping session(its principal facility) or, forSEND (APPC), adistributed program linkserver application hasspecified thefunction-shipping session(its principal facility) onthe CONVID option

SENDCONTROL

INVREQ 200 A distributed program linkserver application hasattempted to send on itsfunction-shipping session(its principal facility)

SEND MAP INVREQ 200 Command is not allowedfor a distributed programlink server program

SEND PAGE INVREQ 200 Command is not allowedfor a distributed programlink server program

SENDPARTNSET

INVREQ 200 Command is not allowedfor a distributed programlink server program

SEND TEXT INVREQ 200 Command is not allowedfor a distributed programlink server program

SEND TEXTMAPPED

INVREQ 200 A distributed program linkserver application hasspecified thefunction-shipping session(its principal facility) onthe CONVID option

Chapter 9. RESP2 values and their meanings 337

Page 358: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SEND TEXTNOEDIT

INVREQ 200 Command is not allowedfor a distributed programlink server program

SETAUTOINSTALL

INVREQ 1 VTAM is not in use in thissystem

2 The MAXREQS value isnot in the range 0–999

4 One of the modulesinvoked by DFHZATDX(DFHZATA andDFHZATD) cannot befound

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

PGMIDERR 3 The program namecannot be found

SETCONNECTION

INVREQ 1 ACQSTATUS|CONNSTATUSwas specified for anon-APPC connection

2 1. ACQUIRED specifiedwith OUTSERVICE

2. ACQUIRED specifiedfor OUTSERVICEconnection

3. OUTSERVICEspecified forACQUIREDconnection

3 ACQSTATUS|CONNSTATUShas an invalid CVDAvalue

4 SERVSTATUS has aninvalid CVDA value

5 PENDSTATUS orNOTPENDING wasspecified for a connectionthat is not APPC or IRC

6 PURGE was specified forconnection that is notVTAM

7 PURGETYPE has aninvalid CVDA value

8 PENDSTATUS has aninvalid CVDA value

338 CICS User’s Handbook

Page 359: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

11 SET command named aremote connection

12 EXITTRACING has aninvalid CVDA

13 ZCPTRACING has aninvalid CVDA

14 EXITTRACING|ZCPTRACINGspecified for a non-VTAMconnection or VTAM notinitialized

16 The resource whosename was specified byCONNECTION(data-value)is an indirect link

17 ACQSTATUS|CONNSTATUScannot be set whensystem initialized withISC=NO

18 NOTPENDING cannot beset for a connection whichhas successfullycompleted ExchangeLognames processing

19 CONNSTATUS cannot beset to ACQUIRED whenin the FREEING state

20 COMMIT, BACKOUT, orFORCE is not valid forthis type of connection

21 BACKOUT or FORCEwas specified, but wasunsuccessful. SomeUOWs remain shunted forthis connection

22 Other SET parameterswere included with theCANCEL orFORCECANCEL option

23 The resource whosename was specified byCONNECTION(name) isthe local TCT system entry(TCTSE)

25 Connection is still inservice

Chapter 9. RESP2 values and their meanings 339

Page 360: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

26 RECOVSTATUS does nothave a value ofNORECOVDATA.ENDAFFINITY is invalid

30 Wrong connection type forENDAFFINITY. Affinitiescan exist only on LU6.1and LU6.2 connections

31 User PERFORMENDAFFINITY. TheNETID could not beobtained from the installedconnection. Therefore, toend affinity you must usethe PERFORMENDAFFINITY command

32 See messageDFHZC0178. VTAM couldnot end the affinity for areason other than 35(NOTFOUND) or 36(SESSIONS ACTIVE)

35 VTAM could not find anaffinity for this connection

36 VTAM could not end theaffinity because theconnection had somesessions active

37 See messageDFHZC0176. A VTAMerror prevented theCHANGE ENDAFFINmacro being carried out

44 GRSTATUS is not set toREGISTERED orDEREGISTERED

45 NORECOVDATA cannotbe set for a connectionthat is in service

46 NORECOVDATA wasspecified for a non-APPCconnection

SYSIDERR 9 The named connectioncould not be found

IOERR 10 Unexpected error NORMAL 58 AIDs are successfully

canceled NORMAL 59 No AIDs are canceled

340 CICS User’s Handbook

Page 361: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET DB2CONN INVREQ 1 Invalid ACCOUNTRECvalue

2 Invalid AUTHTYPE value 3 Invalid BUSY value 4 Invalid COMAUTHTYPE

value 5 Invalid CONNECTERROR

value 6 Invalid CONNECTST

value 7 Invalid NONTERMREL

value 9 Invalid PRIORITY value 10 Invalid SECURITY value 11 Invalid STANDBYMODE

value 12 Invalid THREADWAIT

value 13 Bad characters in

AUTHID 14 Bad characters in

COMAUTHID 15 Bad characters in DB2ID 16 Bad characters in

MSGQUEUE1 17 Bad characters in

MSGQUEUE2 18 Bad characters in

MSGQUEUE3 19 Bad characters in PLAN 20 Bad characters in

PLANEXITNAME 21 Bad characters in SIGNID 22 Bad characters in

STATSQUEUE 23 Both AUTHID and

AUTHTYPE specified 24 Both COMAUTHID and

COMAUTHTYPEspecified

Chapter 9. RESP2 values and their meanings 341

Page 362: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

25 STANDBYMODE(NOCONNECT)andCONNECTERROR(SQLCODE)specified orCONNECTERROR(SQLCODE)specified whenSTANDBYMODE isNOCONNECT

26 Both PLAN andPLANEXITNAMEspecified

27 Invalid ACCOUNTRECvalue

28 COMTHREADLIMexceeds TCBLIMIT orCOMTHREADLIM > 2000or COMTHREADLIM < 0

29 PURGE CYCLE is toolow; that is, < 30 seconds

1. or PURGE CYCLEminutes < 0

2. or PURGE CYCLEseconds < 0

3. or PURGE CYCLEminutes > 59

4. or PURGE CYCLEseconds > 59

32 TCBLIMIT > 2000 orTCBLIMIT < 4

33 THREADLIMIT exceedsTCBLIMIT orTHREADLIMIT > 2000 orTHREADLIMIT < 3

34 Already connected 35 RCT suffix not allowed 36 RCT suffix not found 37 Wrong level RCT 39 DB2 not active 40 Insufficient authorization 41 Connection error 42 Invalid INIT parms 43 DB2ID cannot be set,

CONN active 44 DB2CONN partially

discarded 45 RCT suffix invalid

342 CICS User’s Handbook

Page 363: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

46 SET NOTCONNECTEDwhen the FORCE orWAIT option has beenspecified, but thistransaction is itself usingthe CICS DB2 interface

NORMAL 38 Waiting for DB2 (mayoccur following aCONNECTST with aCVDA of CONNECT)

NOTFND 1 There is no DB2TRANcurrently installed with thespecified name

NOTAUTH 100 Command authorizationfailure

101 Surrogate authorizationfailure

102 AUTHTYPE authorizationfailure

SET DB2ENTRY INVREQ 2 Invalid ACTION value 3 Invalid AUTHTYPE value 4 Invalid BUSY value 5 Invalid ENABLESTATUS

value 7 Invalid PRIORITY value 8 Invalid THREADWAIT

value 9 Bad characters in

AUTHID 10 Bad characters in PLAN 11 Bad characters in

PLANEXITNAME 12 Both AUTHID and

AUTHTYPE specified 13 Both PLAN and

PLANEXITNAMEspecified

14 Entry is disabling 15 PROTECTNUM greater

than THREADLIMIT orPROTECTNUM < 0 orPROITECTNUM > 2000

16 THREADWAIT must beTPOOL withTHREADLIMIT=0

Chapter 9. RESP2 values and their meanings 343

Page 364: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

17 THREADLIMIT > 2000 orTHREADLIMIT < 0 orTHREADLIMIT >TCBLIMIT

18 Invalid ACCOUNTRECvalue

19 SET DISABLED when theFORCE ir WAIT optionhas been specified, butthis transaction itself isusing the DB2ENTRY

NOTAUTH 100 Command authorizationfailure

101 Resource authorizationfailure

102 Surrogate authorizationfailure

103 AUTHTYPE authorizationfailure

NOTFND 1 There is no DB2ENTRYcurrently installed with thespecified name

SET DB2TRAN INVREQ 2 Bad characters inTRANSID name

3 TRANSID already exisitsin another installedDB2TRAN

4 Bad characters inDB2ENTRY name

NOTAUTH 100 Command authorizationfailure

101 Resource authorizationfailure

102 Surrogate authorizationfailure

103 AUTHTYPE authorizationfailure

NOTFND 1 There is no DB2TRANcurrently installed with thespecified name

SETDELETSHIPPED

INVREQ 1 INTERVAL value is invalid

2 INTERVALHRS value isnot in the range 0-99

3 INTERVALMINS value isinvalid

4 INTERVALSECS value isinvalid

344 CICS User’s Handbook

Page 365: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

5 IDLE value is invalid 6 IDLEHRS value is not in

the range 0-99 7 IDLEMINS value is invalid 8 IDLESECS value is invalid NOTAUTH 100 The user associated with

the issuing task is notauthorized to use thiscommand

SET DSNAME DSNNOTFOUND 1 The named data setcannot be found

15 RECOVERED wasspecified, but the data setwas not found

INVREQ 3 ACTION has an invalidCVDA value

10 REMOVE was specified,but the data set isassociated with a filedefinition

12 REMOVE was specifiedwith another option. If youspecify remove, it must bethe only option present onthe command

13 REMOVE was specifiedbut a lock was held on thedata set by anotherINQUIRE or SETDSNAME command, or byCICS file controlprocessing.

14 RECOVERED wasspecified but CICS is notconfigured to support“backup while open”(BWO). Check that youhave a version ofMVS/DFP, DFHSM, andDFDSS that support BWO

16 RECOVERED wasspecified but the data sethas not been openedduring this CICS session,so the BWO attributes inthe ICF catalog cannot beset

Chapter 9. RESP2 values and their meanings 345

Page 366: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

17 RECOVERED wasspecified for a BDAM dataset, or a VSAM path. Thisis not supported

18 RECOVERED wasspecified for a VSAMbase data set that hadFCTs open. This is notallowed.

19 RECOVERED wasspecified for an unknowndata set, or the data setwas not in the ‘forwardrecovered’ state

29 QUIESCESTATE isspecified, but theoperation is not supportedbecause DFSMS 1.3, orlater, is not installed

30 QUIESCESTATE has aninvalid CVDA value

31 BUSY has an invalidCVDA value

33 AVAILABILITY has aninvalid CVDA value data

34 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified, but is rejectedeither because q quiesceor unquiesce is alreadytaking place, or becauseDFSMSdss is currentlytaking a backup copy ofthe data set

36 A QUIESCESTATE valueof UNQUIESCED isspecified, but is rejectedby RLS either because anunquiesce is alreadytaking place, or becauseDFSMSdss is currentlytaking a backup copy ofthe data set

346 CICS User’s Handbook

Page 367: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

39 AVAILABILITY,QUIESCESTATE,RESETLOCKS or RETRYis specified for a data setthat is a BDAM data set

40 The CICS control block(DSNB) describing thedata set has been deleted(by the REMOVE option)by another task beforeCICS could process theSET command

41 QUIESCESTATE isspecified for a data setthat is not known toDFSMS as a VSAM dataset

42 An invalid CVDA isspecified forUOWACTION

43 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified withoutNOWAIT, and the issuingtask has updated the dataset, or is browsing thedata set, in the same unitof work. This is notallowed because:

� For QUIESCED thiswould result in adeadlock

� For IMMQUIESCEDthis would result inthe issuing task beingpurged

44 A SET DSNAMEREMOVE command hasbeen issued by anothertask. This has beendetected after this SETDSNAME command wasissued, but before theAVAILABILITY option isprocessed

46 FAILEDBKOUT, which isobsolete, is specified

Chapter 9. RESP2 values and their meanings 347

Page 368: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

47 No file has been openedagainst the data set sincethe last cold start of thisCICS region, or since thefile definition was installedfor the data set

IOERR 20 RECOVERED wasspecified but an error wasraised on accessing theICF catalog. Ensure thatthe specified data set ison an SMS managedDASD and is known tothe SMS subsystem

21 RECOVERED wasspecified but an error wasraised by the CICS tablemanager program

35 QUIESCESTATE isspecified but theSMSVSAM server is notavailable

40 QUIESCESTATE isspecified, and anunexpected error occurredin DFSMS

48 The specified operationcannot be completedbecause the data set ismigrated. Recall the dataset and re-issue thecommand

49 An error was raised byDFSMS when reading theICF Catalog to establishthe base data set name

348 CICS User’s Handbook

Page 369: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SUPPRESSED 37 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified, but the quiesceof the data set iscancelled by anotherparticipating CICS region.This could be for one ofthe following reasons:

� A user issued a SETDSNAMEUNQUIESCEDcommand

� AN XCFVSDS globaluser exit programsuppressed thequiesce

� AN XCFSREQ globaluser exit programsuppressed the closeof a file that is openagainst the data set

38 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified, but the quiesceof the data set iscancelled by this CICSregion because thequiesce operation timedout. This is probably dueto a long-runningtransaction on anotherparticipating CICS regionpreventing the close of afile that is open againstthe data set

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET DUMPDS INVREQ 1 INITIALDDS has an

invalid value 2 SWITCHSTATUS has an

invalid CVDA value

Chapter 9. RESP2 values and their meanings 349

Page 370: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

3 OPENSTATUS has aninvalid CVDA value

IOERR 4 OPEN or SWITCH causedan error opening a dataset

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SETENQMODEL

INVREQ 2 The attempt toenable/disble anENQMODEL failed,because a more genericENQMODEL is enabled

3 STATE has an invalidCVDA value

IOERR 4 The ENQMODEL is in theWAITING state

NOTFND 1 The specifiedENQMODEL is notinstalled on this system

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET FILE INVREQ 1 The named file isREMOTE

2 The named file is notCLOSED

3 The named file is notDISABLED

4 ADD has an invalid CVDAvalue

5 BROWSE has an invalidCVDA value

6 BUSY has an invalidCVDA value

7 DELETE has an invalidCVDA value

8 DISPOSITION has aninvalid CVDA value

9 EMPTYSTATUS has aninvalid CVDA value

10 LSRPOOLID wasspecified for a non-VSAMdata set

350 CICS User’s Handbook

Page 371: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

11 LSRPOOLID is not in therange 1–8, or thecorresponding buffer isnot defined

12 READ has an invalidCVDA value

13 STRINGS value is not inthe range 1–255, or this isnot a VSAM file

14 UPDATE has an invalidCVDA value

16 OPENSTATUS has aninvalid CVDA value

17 ENABLESTATUS has aninvalid CVDA value

19 DELETE has beenspecified for a non-VSAMfile

20 EMPTYSTATUS has beenspecified for a non-VSAMfile

21 CLOSED or DISABLEDhas been specified, butthis transaction has anincomplete requestagainst the file

22 ENABLED was specifiedfor a file that is currentlyDISABLING orUNENABLING

23 EXCLUSIVE has aninvalid CVDA value

24 EXCLUSIVE has beenspecified for a non-BDAMfile.

28 OPEN, CLOSE, ENABLEor DISABLE has beenspecified but an exitprogram running at exitpoint XFCSREQinstructed CICS not tocarry out the command

29 TABLE has an invalidCVDA value

30 MAXNUMREQS value isout of range

Chapter 9. RESP2 values and their meanings 351

Page 372: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

31 The TABLE option isinvalid for a BDAM file(must be VSAM for a datatable.)

32 The TABLE option is notvalid for a file defined withthe REUSE option

33 The TABLE option isinvalid for a file defined asUNBLOCKED

34 The MAXNUMRECSoption is invalid for aBDAM file (must beVSAM for a data table.)

35 The MAXNUMRECSoption is invalid for a filedefined with the REUSEoption

36 The MAXNUMRECSoption is invalid for a filedefined as UNBLOCKED

37 The TABLE option isinvalid when LSRPOOL=0is specified

39 The USERTABLE optionis invalid when recordformat is not variable

40 CONSISTENT orREPEATABLE is specifiedfor a file that is notaccessed in RLS mode

41 The DSNB cannot bedisconnected for this filebecause the file hasdeferred workoutstanding, for whichthere are retained locks.This means there is atleast one shunted UOW,awaiting completion, thathas made changes to thisfile

352 CICS User’s Handbook

Page 373: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

42 The SET FILE requestcannot be satisfiedbecause the file hasdeferred workoutstanding, for whichthere are retained locks.This means there is atleast one shunted UOW,awaiting completion, thathas made changes to thisfile. The only valid optionswhen a file has deferredwork pending are thosethat change the file state.File state changes arepermitted because theymay be required to enablethe deferred work to becompleted

43 The file cannot bediscarded because it hasdeferred workoutstanding, for whichthere are retained locks.This means there is atleast one shunted UOW,awaiting completion, thathas made changes to thisfile

44 A file open request cannotbe satisfied because thefile references a data setthat has been marked asunavailable by a SETDSNAME UNAVAILABLEcommand

45 A file open request cannotbe satisfied because thefile references anRLS-mode data set thathas been quiesced by aSET DSNAMEQUIESCED command

Chapter 9. RESP2 values and their meanings 353

Page 374: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

46 A file open request cannotbe satisfied because thefile references anRLS-mode data set that isbeing copied by aDFSMSdss-initiatednon-BWO backup

47 A file open request cannotbe satisfied because thefile references anRLS-mode data set that isin the process ofquiescing by a SETDSNAME QUIESCEDcommand

48 A file open request cannotbe satisfied because thefile references a data setfor which its ICF Catalogentry indicates that arecovery is pending, or isin progress (for example,a CICSVR job is running)

49 An invalid CVDA isspecified for theREADINTEG option

50 An attempt has beenmade to open an RLS filewhen RLS is notsupported

51 An invalid CVDA isspecified for theRLSACCESS option

52 An attempt has beenmade to specify RLSaccess for a BDAM dataset

53 An attempt has beenmade to specify aCICS-maintained datatable for a file defined withRLS access

354 CICS User’s Handbook

Page 375: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

54 A file open request cannotbe satisfied because ofone of the followingreasons:

� the file is beingopened in RLS modeand this region hasother files open innon-RLS modeagainst the data setwhich it references

� the file is beingopened in non-RLSmode and this regionhas other files openin RLS mode againstthe data set which itreferences

� the file is beingopened in non-RLSmode and this regionhas unresolved RLSrecovery work againstthe data set which itreferences

55 LOADTYPE has an invalidCVDA value

56 UPDATEMODEL has aninvalid CVDA value

57 EMPTYSTATUS has aCVDA value that is notallowed for a couplingfacility data table.EMPTYSTATUS must beNOEMPTYREQ for acoupling facility data table.

58 CFDTPOOL is notspecified for a file thatrefers to a coupling facilitydata table.

59 KEYLENGTH is notspecified for a file thatrefers to a coupling facilitydata table, and whichspecifies LOAD=NO

60 An invalid KEYLENGTH isspecified

Chapter 9. RESP2 values and their meanings 355

Page 376: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

61 RECORDSIZE is notspecified for a file thatrefers to a coupling facilitydata table that specifiesLOAD=NO

62 An invalid RECORDSIZEis specified

63 Open is specified for a filethat refers to a couplingfacility data table, butOPEN processing hasfailed because:

� The file attributes donot match thosespecified when theCFDT was created, or

� A KEYLENGTH orRECORDSIZE hasbeen specified thatexceeds themaximum supported

64 OPEN is specified for afile that refers to acoupling facility data table,but OPEN processing hasfailed because the serveris not available

65 An invalid CDFTPOOLname is specified

66 An invalid TABLE name isspecified

67 An UPDATEMODEL ofCONTENTION isspecified for a recoverablecoupling facility data table.The update model mustbe LOCKING for acoupling facility data tablethat is recoverable

FILENOTFOUND 18 The named file cannot befound

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

356 CICS User’s Handbook

Page 377: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

IOERR * OPEN has failed inVSAM, and the RESP2field contains a VSAMresponse code

* CLOSE has failed inVSAM, and the RESP2field contains a VSAMresponse code

SET IRC INVREQ 1 A program required forIRC, DFHCRSP, isunavailable

2 OPENSTATUS has aninvalid CVDA value

4 CICS was initializedwithout IRC support(ISC=NO)

5 No connection has beendefined

6 The VTAM APPLID forthis CICS is blanks; IRCrequires a non-blankAPPLID

7 Another CICS using IRChas the same VTAMAPPLID as this one;unique names arerequired

8 IRC rejected the open ofthis CICS because it hadalready reached themaximum number oflogons

18 IRC support (the DFHIRPmodule) is below the levelrequired by this CICSsystem

NOSTG 9 CICS storage isinsufficient for the request

10 MVS storage isinsufficient (SVC blockrequest rejected)

Chapter 9. RESP2 values and their meanings 357

Page 378: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

11 MVS storage isinsufficient (SUBSYSblock request rejected)

IOERR 12 IRC initialization failed 13 The log on to IRC failed 14 An attempt to attach the

node error transaction,CSNC, failed

15 An error occurred closingIRC

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SETJOURNALNAME

JIDERR 1 The specified journalname was not found

2 An error occurred duringan attempt to define thelog stream associatedwith the journal name, orthe journal name wasincorrectly specified

3 The specified journalname refers to aDASD-only log stream towhich a CICS region inanother MVS image iscurrently connected.

INVREQ 2 The request is invalid 3 The system log cannot be

changed 4 The ACTION option has

an invalid CVDA value 5 The STATUS option has

an invalid CVDA value n The ACTION option

specifies FLUSH or RESTfor a journal that is notcurrently connected to alog stream

358 CICS User’s Handbook

Page 379: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

IOERR 6 Either the log streamassociated with thejournal name cannot beopened, or the journalcannot be opened, or anunrecoverable error hasoccurred during theflushing of the log bufferto the log stream

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

SETJOURNALNUM

JIDERR 1 There are no valid optionssupported by thiscommand, which isobsolete. Use the SETJOURNALNAMEcommand

SETMODENAME

SYSIDERR 1 The connection cannot befound

2 The MODENAME withinthe connection cannot befound

INVREQ 3 MODENAME‘SNASVCMG’ wasspecified

4 The AVAILABLE value isout of range

5 AVAILABLE was specifiedbut CICS is not in sessionon this connection

6 CLOSED was specifiedwith AVAILABLE

7 ACQSTATUS has aninvalid CVDA value

8 This is not aparallel-session APPCgroup

Chapter 9. RESP2 values and their meanings 359

Page 380: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

9 ACQUIRED was specifiedbut CICS is not in sessionon this connection

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET MONITOR INVREQ 1 STATUS has an invalidCVDA value

2 PERFCLASS has aninvalid CVDA value

3 EXCEPTCLASS has aninvalid CVDA value

4 EVENTCLASS has aninvalid CVDA value

5 CONVERSEST has aninvalid CVDA value

6 SYNCPOINTST has aninvalid CVDA value

7 The FREQUENCY valueis invalid

� Hours exceed 24,minutes or secondsexceed 59, or totalvalue is out of range

8 The FREQUENCYHRSvalue is out of range

9 The FREQUENCYMINvalue is out of range

10 The FREQUENCYSECvalue is out of range

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET NETNAME INVREQ 27 EXITTRACING has aninvalid CVDA value

29 The terminal is not aVTAM terminal

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

360 CICS User’s Handbook

Page 381: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SET PROGRAM INVREQ 1 DISABLED orDPLSUBSET wasspecified for a programbeginning ‘DFH’

2 STATUS has an invalidCVDA value

3 NEWCOPY was specifiedand RESCOUNT is notequal to zero

4 SHARESTATUS has aninvalid CVDA value

5 COPY has an invalidCVDA value

6 COPY was specified for amodule currently loadedwith the HOLD option

9 CEDFSTATUS has aninvalid CVDA value

17 You have specified anoption that is invalid for aremote program(CEDFSTATUS, COPY,EXECUTIONSET orSHARESTATUS)

18 You have specified anoption that is invalid for amap set (CEDFSTATUSor EXECUTIONSET)

19 You have specified anoption that is invalid for apartition set(CEDFSTATUS orEXECUTIONSET)

20 EXECUTIONSET has aninvalid CVDA

PGMIDERR 7 The program, map set, orpartition set cannot befound

IOERR 8 The COPY option wasspecified but CICS couldnot locate the module

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 361

Page 382: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

SETSTATISTICS

INVREQ 1 The INTERVAL value isout of range

2 The ENDOFDAY value isout of range

3 RECORDING has aninvalid CVDA value

4 The INTERVALHRS valueis out of range

5 The INTERVALMINSvalue is out of range

6 The INTERVALSECSvalue is out of range

7 More than one of theinterval values has beenused and the combinationeither exceeds 24 hoursor is less than 1 minute

8 The ENDOFDAYHRSvalue is out of range

9 The ENDOFDAYMINSvalue is out of range

10 The ENDOFDAYSECSvalue is out of range

11 RESETNOW orRECORDNOW has beenspecified, but theRECORDING state hasnot been changed

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SETSYSDUMPCODE

NOTFND 1 The dump code cannot befound

INVREQ 2 ACTION has an invalidCVDA value

4 SYSDUMPING has aninvalid CVDA value

5 The MAXIMUM value isout of range

362 CICS User’s Handbook

Page 383: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

6 SHUTOPTION has aninvalid CVDA value

7 REMOVE is specified withother options

9 The dump code is invalid 13 DUMPSCOPE has an

invalid CVDA value 14 RELATED requires

MVS/ESA 5.1 15 DAEOPTION has an

invalid CVDA value DUPREC 10 ADD is specified for a

dump code already in thesystem dump table

IOERR 11 An error occurredupdating the CICScatalog. The entry ischanged for the currentrun, but is not recordedfor restarts

NOSPACE 12 The CICS catalog full.The entry is changed forthe current run, but is notrecorded for restarts

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET SYSTEM INVREQ 1 The MAXTASKS value isout of range

3 The AKP value is out ofrange

5 TIME is not in the range100–3600000

6 The RUNAWAY value isout of range

7 MROBATCH is not in therange 1–255

9 DUMPING has an invalidCVDA value

12 AKP was specified, butCICS was initializedwithout keypointing

13 TIME is less thanSCANDELAY

14 PRTYAGING is not in therange 0–65535

Chapter 9. RESP2 values and their meanings 363

Page 384: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

15 SCANDELAY is not in therange 0–5000

20 DSALIMIT is not in therange 2MB to 16MB

21 EDSALIMIT is not in therange 10MB to 2GB

22 There is insufficient MVSstorage to allocateDSALIMIT

23 There is insufficient MVSstorage to allocateEDSALIMIT

LENGERR 20 The GMMLENGTH valueis out of range

NOSTG 16 CICS reduced the valueyou requested forMAXTASKS because ofstorage constraints; seethe NEWMAXTASKSoption

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET TASK TASKIDERR 1 The task cannot be found 2 The task is protected by

CICS and not eligible formodification with thiscommand

INVREQ 3 PURGETYPE has aninvalid CVDA value

4 PRIORITY is not in therange 0–255

5 The task is not in a validstate for purging

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET TCLASS TCIDERR 1 The transaction classcannot be found

INVREQ 2 The MAXIMUM value isnot in the range 0–999

364 CICS User’s Handbook

Page 385: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET TCPIP INVREQ 4 TCPIP not available(TCPIP=NO)

5 TCPIP already closed (forSETCLOSED|IMMCLOSE)

6 TCPIP already open (forSET OPEN)

11 STATUS has an invalidCVDA value

12 The OPEN request didnot complete becauseanother task subsequentlyrequested a CLSOE ofCICS internal socketssupport

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SETTCPIPSERVICE

INVREQ 4 TCPIP is not available(TCPIP=NO)

4 TCPIP status is closed 7 Port in use 8 CICS is not authorized to

use this port 9 TCPIPSERVICE not

closed 10 Unknown IP address 11 Invalid value specified in

an operand of the SETcommand (either theSTATUS or theURMname is wrong)

12 Invalid status NOTFND 3 The named

TCPIPSERVICE is notfound

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET TDQUEUE QIDERR 1 The queue cannot befound

Chapter 9. RESP2 values and their meanings 365

Page 386: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ 2 TRIGGERLEVEL wasspecified for anextrapartition queue

3 The TRIGGERLEVELvalue is not in the range0–32767

4 ATITERMID was specifiedfor an extrapartition queue

5 ATITRANID was specifiedfor an extrapartition queue

6 ATIFACILITY wasspecified for anextrapartition queue

7 ATIFACILITY has aninvalid CVDA value

8 OPENSTATUS has aninvalid CVDA value

9 OPENSTATUS wasspecified for anintrapartition queue

10 ENABLESTATUS has aninvalid CVDA value

12 The queue is remote 13 The queue is indirect 15 OPENSTATUS was

specified for a DISABLEDqueue

16 OPENSTATUS wasspecified, but the JCLDDNAME to which thequeue definition pointswas not found

18 SET not possible becausethe queue was not closed

19 ATIUSERID was specifiedfor an extrapartition queue

20 The ESM interface is notinitialized

21 CICS has received anunknown response fromthe ESM

22 The ESM did not respond 30 Disabled pending

condition 31 SET not possible because

the queue was notdisabled

366 CICS User’s Handbook

Page 387: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

35 SET not possible becausethe queue is in-doubt

40 SET not possible becausethe queue is CXRF

IOERR 14 An error occurred openingor closing the data setassociated with the queue

17 The queue cannot be setCLOSED because there isno space in theassociated data set

NOTAUTH 23 The user named on theATIUSERID option is notauthorized

24 The user named in theATIUSERID has beenrevoked

25 During SECLABELprocessing by the externalsecurity manager, an erroroccurred. For informationabout security labels, seethe OS/390 SecurityServer (RACF) SecurityAdministrator’s Guide,SC28-1915

27 The user named in theATIUSERID option is notallowed to access thequeue

100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

102 The user associated withthe issuing task is not anauthorized surrogate forthe user specified inATIUSERID

USERIDERR 28 The user named inATIUSERID is not knownto the ESM

Chapter 9. RESP2 values and their meanings 367

Page 388: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SET TERMINAL INVREQ 1 TERMSTATUS orACQSTATUS wasspecified for IRC sessionsor non-VTAM terminal

2 TERMSTATUS orACQSTATUS has aninvalid CVDA value

4 ATISTATUS has aninvalid CVDA value

5 ATISTATUS changewould result in NOATI andNOTTI

6 CREATESESS wasspecified for non-VTAMterminal

7 CREATESESS has aninvalid CVDA value

9 PAGESTATUS has aninvalid CVDA value

11 Trying to put the issuingterminal OUTSERVICE

13 SERVSTATUS has aninvalid CVDA value

15 TERMPRIORITY valuenot in range 0–255

17 NOTTI cannot bespecified for the issuingterminal

18 TTISTATUS has aninvalid CVDA value

21 PURGETYPE has aninvalid CVDA value

22 TRACING has an invalidCVDA value

24 Invalid option requestedfor a remote terminal

25 ACQUIRED specified, butterminal is not inservice

26 PURGE specified, buttarget task hasSPURGE=NO on itsassociated transactiondefinition

27 EXITTRACING has aninvalid CVDA value

28 ZCPTRACING has aninvalid CVDA value

368 CICS User’s Handbook

Page 389: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

29 EXITTRACING orZCPTRACING specifiedfor non-VTAM terminal (orVTAM not installed)

31 This is a remote terminalwith no associatedsurrogate

33 SET TERMINAL is notvalid for an LU6.2 (APPC)session

34 A permanent transactionhas been defined for thisterminal (TRANSACTIONoperand in TERMINALdefinition)

35 Attempt made to changeTCAM CONTROL onnon-TCAM terminal

36 Invalid value supplied forTCAM CONTROL

37 Preset signon failed,terminal remainsOUTSERVICE

38 OBFORMATST has aninvalid CVDA value

39 RELREQST has aninvalid CVDA value

40 DISCREQST has aninvalid CVDA value

41 ALTPRTCOPYST has aninvalid CVDA value

42 PRTCOPYST has aninvalid CVDA value

43 UCTRANST has aninvalid CVDA value

44 Options would result inthe invalid combination ofthe alternate printer copystatus being set withoutan alternate printerdefined

45 Options would result inthe invalid combination ofthe alternate printer beingdefined without a primaryprinter defined

Chapter 9. RESP2 values and their meanings 369

Page 390: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

46 OBFORMATST isspecified for a console or3790

48 Options would result inthe invalid combination ofthe printer copy statusbeing set without aprimary printer defined

50 VTAM not available forVTAM terminal

51 PRINTER andALTPRINTER optionspecified for a non-3270terminal

52 PRTCOPYST ofALTPRTCOPST optionspecified for a non-3270terminal

54 Option other thanPURGETYPE specifiedfor IRC session

57 Other SET parameterswere included with theCANCEL option

NORMAL 53 Purge deferred 58 AIDs are successfully

canceled 59 No AIDs are canceled 60 MAPNAME or

MAPSETNAME specified,but the terminal is not of atype supported by BMS

TERMIDERR 23 The named terminalcannot be found

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SETTRACEDEST

INVREQ 1 INSTATUS has an invalidCVDA value

2 A TABLESIZE value of <−1 has been specified

3 AUXSTATUS has aninvalid CVDA value

4 SWITCHSTATUS has aninvalid CVDA value

370 CICS User’s Handbook

Page 391: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

5 GTFSTATUS has aninvalid CVDA value

6 AUXPAUSE wasspecified, but auxiliarytracing is not active

11 SWITCHACTION has aninvalid CVDA value

IOERR 10 A SWITCH request or aSET AUXSTART requestresulted in an “open” errorfor the trace data set

NOSPACE 7 There is insufficient spacefor a new trace table

NOSTG 8 There is insufficient spacefor an auxiliary tracebuffer

9 There is insufficient spacefor a GTF trace buffer

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SETTRACEFLAG

INVREQ 1 SYSTEMSTATUS has aninvalid CVDA value

2 USERSTATUS has aninvalid CVDA value

3 SINGLESTATUS has aninvalid CVDA value

4 TCEXITSTATUS has aninvalid CVDA value

5 TCEXITSTATUS isspecified but VTAM is notinstalled

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SETTRACETYPE

NOTFND 1 At least one CICScomponent was notaccessible. Trace levelswere set for the othercomponents

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

Chapter 9. RESP2 values and their meanings 371

Page 392: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SETTRANCLASS

INVREQ 2 The MAXACTIVE value isnot in the range 0-999

3 The PURGETHRESHvalue is not in the range0-1000000

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

TCIDERR 1 The transaction classcannot be found

SETTRANDUMPCODE

NOTFND 1 The dump code cannot befound

INVREQ 2 ACTION has an invalidCVDA value

3 TRANDUMPING has aninvalid CVDA value

4 SYSDUMPING has aninvalid CVDA value

5 The MAXIMUM value isout of range

6 SHUTOPTION has aninvalid CVDA value

7 REMOVE is specified withother options

9 The dump code is invalid 13 DUMPSCOPE has an

invalid CVDA value 14 RELATED requires

MVS/ESA 5.1 DUPREC 10 ADD is specified for a

dump code already in thetransaction dump table

IOERR 11 An error occurredupdating the CICScatalog. The entry ischanged for the currentrun, but is not recordedfor restarts

NOSPACE 12 The CICS catalog is full.The entry is changed forthe current run, but is notrecorded for restarts

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

372 CICS User’s Handbook

Page 393: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SETTRANSACTION

TRANSIDERR 1 The transaction cannot befound

INVREQ 2 PURGEABILITY has aninvalid CVDA value

3 STATUS has an invalidCVDA value

4 DISABLED has beenspecified for aCICS-supplied transaction

5 The TCLASS orTRANCLASS name is notknown

7 Tracing has an invalidCVDA value

8 DUMPING has an invalidCVDA value

9 The PRIORITY value isout of range

10 RUNAWAYTYPE has aninvalid CVDA value

11 SHUTDOWN has aninvalid CVDA value

12 USER has been specifiedwithout a RUNAWAYvalue

13 RUNAWAY has beenspecified without aRUNAWAYTYPE value ofUSER

14 The RUNAWAY value isout of range

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

SETTSQUEUE/TSQNAME

NOTFND 1 The TSQUEUE cannot befound

Chapter 9. RESP2 values and their meanings 373

Page 394: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

INVREQ 1 The TSQUEUE was notdeleted becauseLASTUSEDINIT wasgreater than the interval,or because theTSQUEUE is in use

2 The action specified wasnot DELETE

3 LASTUSEDINIT wasspecified but has aninterval value; that is, anegative value

4 The filetype was not validfor the specified operation

POOLERR 0 POOLNAME wasspecified but the poolcould not be accessed

QIDERR 1 The QUEUE name wasinvalid (it was binaryzeroes)

SYSIDERR 0 SYSID was specified butthere was nocorresponding pool, or thepool was unavailable

3 The SYSID does not mapto a shared pool

5 I/O error on the couplingfacility

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand

SET UOW UOWNOTFOUND 1 The UOW cannot befound

INVREQ 3 UOWSTATE has aninvalid CVDA value

4 CICS is not in a validstate to COMMIT,BACKOUT, or FORCEthis UOW

374 CICS User’s Handbook

Page 395: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTAUTH 100 The use of this commandis not authorized

SET UOWLINK UOWLNOTFOUND 1 The specified UOW-linkcannot be found

INVREQ 2 Resynchronization isalready in progress, or theUOW-link is already beingprocessed by anotherinstance of the SETUOWLINK command

3 The UOW is in-doubt, andthe UOW-link is thecoordinator of the commitor backout session. TheUOW must be forcedusing the SET UOWcommand before theUOW-link can be deleted

4 This is not a link createdby a connection, or is nota recoverable link

5 The UOW-link (and theassociated communicationsession) is still active

6 ACTION has an invalidCVDA value

7 The UOW-link has asuitable connectiondefinition, and cannot bedeleted

NOTAUTH 100 The use of this commandis not authorized

SET VOLUME VOLIDERR 1 This command isobsolete, and is retainedonly for compatibility withreleases of CICS earlierthan CICS for MVS/ESA5.1. It has no equivalentfunction in CICS forMVS/ESA 5.1 or laterreleases

SET VTAM INVREQ 1 VTAM is not present inthe system

2 OPENSTATUS has aninvalid CVDA value

Chapter 9. RESP2 values and their meanings 375

Page 396: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

4 The PSDINTERVAL valueis out of range

5 The PSDINTHRS value isout of range

6 The PSDINTMINS valueis out of range

7 The PSDINTSECS valueis out of range

8 A PSDINTERVAL value >0 was specified in anXRF-eligible system

9 VTAM reported an errorwhile an attempt wasbeing made to set thePSD interval

10 A PSD interval has beenspecified but either theVTAM currently in use (orthe VTAM library usedwhen the terminal controltable was assembled)does not supportpersistent sessions. Theinterval may have beenspecified earlier than thiscommand; see thePSDINTERVALdescription. If OPEN wasalso requested, CICS hasopened the VTAM ACB

11 The ACB has openedsuccessfully, but an erroroccurred in at least one ofthe sessions thatpersisted from theprevious failure

12 Your OPEN request didnot complete becauseanother task subsequentlyrequested a close of theVTAM connection

13 An error occurred duringrecovery of sessions, andthe VTAM ACB will beclosed as a result

376 CICS User’s Handbook

Page 397: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

14 CICS is performingcleanup processingfollowing a predatory XRFtakeover. CICS rejectsOPEN requests with thiserror, without invokingVTAM, during this activity.OPEN requests areprocessed as usual assoon as cleanup iscomplete

16 Your attempt to deregisterCICS from a VTAMgeneric resource failedbecause CICS is notregistered as a member ofa generic resource group

IOERR n An error occurred duringthe opening of the ACB. IfCICS could not processthe request, the RESP2value is 3. If VTAMdetects the failure, CICSreturns the VTAM FDBK2code in RESP2: you canlook up these errors in theVTAM Programmingmanual, under ACBOPEN and CLOSE returncodes

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SET WEB INVREQ 11 An invalid value has been

supplied for STATUS,GARBAGEINT orTIMEOUTINT

NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand

SIGNOFF INVREQ 1 No user is currentlysigned on

2 There is no terminal withthis task

Chapter 9. RESP2 values and their meanings 377

Page 398: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

3 This task’s terminal haspreset security

4 Signoff is attempted usingtransaction routing withoutusing the CRTEtransaction

18 The CICS ESM interfacenot initialized

200 Command not allowed fora distributed program linkserver program

SIGNON NOTAUTH 1 A password is required 2 The supplied password is

wrong 3 A new password is

required 4 The new password is not

acceptable 5 An OIDCARD is required 6 The supplied OIDCARD is

wrong 16 The USERID is not

authorized to use thisterminal

17 The USERID is notauthorized to use theapplication

19 The USERID is revoked 20 The USERID’s access to

the specified group hasbeen revoked

21 The signon failed duringSECLABEL checking

22 The signon failed becauseESM is not currentlyaccepting signons

23 The GROUPID is notknown to the ESM

24 The USERID is notcontained in theGROUPID

INVREQ 9 The terminal alreadysigned on

10 No terminal associatedwith this task

11 This task’s terminal haspreset security

378 CICS User’s Handbook

Page 399: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

12 The response from CICSsecurity modules isunrecognized

13 There is an unknownreturn code in ESMRESPfrom the external securitymanager

14 The required nationallanguage is not available

15 Signon attempted viatransaction routing withoutusing the CRTEtransaction

18 The CICS ESM interfaceis not initialized

25 The terminal is of aninvalid type

27 The ESM is not active 28 The required national

language is invalid 29 The user is already

signed on. This relates tothe signon scopechecking

200 Command not allowed fora distributed program linkserver program

USERIDERR 8 The USERID is not knownto external securitymanager

30 The USERID is all blanksor nulls

SPOOLCLOSE INVREQ 4 Unsupported language 8 Unsupported function 40 Subsystem interface

already enabled

Note: Errors 1024 andover are internaland should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.

NOSPOOL 4 No subsystem present 8 Interface being disabled;

CICS is quiescing

Chapter 9. RESP2 values and their meanings 379

Page 400: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

12 Interface has beenstopped

NOTOPEN 8 Dataset has not beenopened

NOTFND 1024 Input or output functionhas been corrupted, andSPOOLCLOSE could notcomplete

SPOOLOPENINPUT

ILLOGIC 3 Invalid CLASS valuespecified

INVREQ 4 Unsupported language 8 Unsupported function 16 USERID missing 36 INPUT|OUTPUT missing 40 Subsystem interface

already enabled

Note: Errors 1024 andover are internaland should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.

NOSPOOL 4 No subsystem present 8 Interface being disabled;

CICS is quiescing 12 Interface has been

stopped NOTFND 4 No data sets could be

located for retrieval for thespecified external writername

1024 Input or output functionhas been corrupted, andSPOOLCLOSE could notcomplete

NOTOPEN 8 Data set has not beenopened or a task whichhas not issued theSPOOLOPEN for a spooldata set has attempted toaccess it.

1024 Subtask OPEN macrofailure

380 CICS User’s Handbook

Page 401: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

OPENERR 4 A VSAM SHOWCB macrofailed to return the lengthsof the VSAM controlblocks used to access theJES spool file.

SPOLBUSY 4 Interface already in useby another task

8 Interface already in useby current task

SPOOLOPENOUTPUT

ILLOGIC 3 Invalid CLASS valuespecified

INVREQ 4 Unsupported language 8 Unsupported function 16 USERID missing 20 NODE missing 36 INPUT|OUTPUT missing 40 Subsystem interface

already enabled

Note: Errors 1024 andover are internaland should notoccur. If one ofthese error codesis returned contactyour IBM supportcenter.

44 Error in the OUTDESCRstring

48 OUTDESCR specified butfunction not available(wrong level of MVS orJES)

52 OUTDESCR specified butbad pointer found onkeyword or inOUTDESCR condition

NOSPOOL 4 No subsystem present 8 Interface being disabled;

CICS is quiescing 12 Interface has been

stopped NOTFND 4 No data sets could be

located for retrieval for thespecified external writername

NOTOPEN 8 Data set has not beenopened

Chapter 9. RESP2 values and their meanings 381

Page 402: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

1024 Subtask OPEN macrofailure

OPENERR 4 A VSAM SHOWCB macrofailed to return the lengthsof the VSAM controlblocks used to access theJES spool file.

SPOLBUSY 4 Interface already in useby another task

8 Interface already in useby current task

SPOOLREAD ILLOGIC 3 Invalid CLASS valuespecified

INVREQ 4 Unsupported language 8 Unsupported function 12 Read attempt after end of

file 24 INTO missing 40 Subsystem interface

already enabled.

Note: Errors 1024 andover are internal,and should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.

NOSPOOL 4 No subsystem present 8 Interface being disabled;

CICS is quiescing 12 Interface has been

stopped NOTFND 4 No data sets could be

located for retrieval for thespecified external writername

NOTOPEN 8 Data set has not beenopened

12 Attempt to read an outputfile

1024 Subtask OPEN macrofailure

SPOLBUSY 4 Interface already in useby another task

8 Interface already in useby current task

SPOOLWRITE INVREQ 4 Unsupported language

382 CICS User’s Handbook

Page 403: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

8 Unsupported function 28 FROM missing 40 Subsystem interface

already enabled.

Note: Errors 1024 andover are internal,and should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.

NOSPOOL 4 No subsystem present 8 Interface being disabled;

CICS is quiescing 12 Interface has been

stopped NOTOPEN 8 Spool report has not been

opened 16 Attempt to write an input

file 1024 Subtask OPEN macro

failure SPOLBUSY 4 Interface already in use

by another task 8 Interface already in use

by current task START INVREQ 4 Hours are out of range 5 Minutes are out of range 6 Seconds are out of range 11 An attempt was made to

ship a START requestwith the ATTACH option

Chapter 9. RESP2 values and their meanings 383

Page 404: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

12 A START request with theATTACH option has failed

Note: RESP2 values of4, 5 and 6 arevalid only if issuingAT or AFTERoptions. WhenspecifyingINTERVAL, onlyEIBRESP ispassed with avalue of X'10' - noRESP2 value ispassed in thiscase

18 A USERID was specifiedand the CICS externalsecurity manager interfaceis not initialized

NOTAUTH 7 A resource security checkhas failed onTRANSID(name)

9 A surrogate user securitycheck has failed onUSERID(name)

USERIDERR 8 The specified USERID isnot known to the externalsecurity manager

10 The external securitymanager is in a statesuch that CICS cannotdetermine whether aspecified USERID is valid

STARTBR FILENOTFOUND 1 A file name referred to inthe FILE option cannot befound in the FCT andSYSID has not beenspecified

INVREQ 20 Browse operations are notallowed according to thefile entry specification inthe FCT

384 CICS User’s Handbook

Page 405: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

25 The KEYLENGTH andGENERIC options arespecified, and the lengthdefined for the data set towhich this file specified inthe KEYLENGTH option isgreater than or equal tothe length of a full key

26 The KEYLENGTH optionis specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers

33 An attempt has beenmade to start a browsewith a REQID already inuse for another browse

42 The KEYLENGTH andGENERIC options arespecified, and the lengthspecified in theKEYLENGTH option isless than zero

44 The specified file is auser-maintained datatable

51 A STARTBR command toa KSDS file that wasbeing accessed in RLSmode specified the RBAkeyword. RLS mode doesnot support RBA accessto KSDS files

DISABLED 50 File is disabled

Chapter 9. RESP2 values and their meanings 385

Page 406: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

NOTOPEN 60 The requested file isCLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but aCLOSE request against ithas been received or aSTARTBR command wasissued against a data setthat is quiesced, or isbeing quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED command

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTFND 80 An attempt to position ona record based on thesearch argument providedwas unsuccessful

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

LOADING 104 A STARTBR was issuedto a user-maintained datatable that is currentlybeing loaded

LOCKED 106 An attempt has beenmade to start a browse,but a retained lock existsagainst the key of the firstrecord in the range of thebrowse. After a LOCKEDresponse, the browse hasnot been started

ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during the file controloperation

386 CICS User’s Handbook

Page 407: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.

SYNCPOINT INVREQ 200 SYNCPOINT was in a

program that is linked tofrom a remote system thathas not specified theSYNCONRETURN option,or it was linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

SYNCPOINTROLLBACK

INVREQ 200 SYNCPOINT ROLLBACKwas in a program that islinked to from a remotesystem that has notspecified theSYNCONRETURN option,or it was linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

UNLOCK FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT andSYSID has not beenspecified

INVREQ 47 An unlock included atoken whose value cannotbe matched against anytoken in use for anexisting READ forUPDATE request

DISABLED 50 A file is disabled NOTOPEN 60 The requested file is

CLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but a closerequest against it hasbeen received

Chapter 9. RESP2 values and their meanings 387

Page 408: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

ILLOGIC (VSAM andCICS-maintained datatables)

110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during the file controloperation

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.

VERIFYPASSWORD

NOTAUTH 2 The supplied password iswrong

3 A new password isrequired

19 The USERID is revoked USERIDERR 8 The USERID is not known

to the external securitymanager

INVREQ 13 There is an unknownreturn code in ESMRESPfrom the external securitymanager

18 The CICS externalsecurity manager interfaceis not initialized

29 The external securitymanager is notresponding

32 The userid field contains ablank character in aninvalid position

388 CICS User’s Handbook

Page 409: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

WAIT CONVID INVREQ 200 Command not supportedfor distributed programlink when it refers to theprincipal facility

WAIT EVENT INVREQ 2 The ECB address is a nullpointer, (X'00000000') or(X'FF000000')

3 The specified eventcontrol area address isabove the 16MB line forprograms executing in24-bit mode

4 The event control areaaddress is not aligned ona fullword boundary

6 The timer-event controlarea specified on a WAITEVENT is in use-keytask-lifetime storage, andis inaccessible to anothertransaction. This conditioncan only occur if thestorage for the timer-eventcontrol area is obtainedother than by an EXECCICS POST command,and is for posting as anECB by some other taskon completion of an event

WAITEXTERNAL

INVREQ 1 An ECB is not valid, forexample the ECB is notfullword aligned

2 An ECB is already beingwaited on

3 NUMEVENTS is not apositive number

4 PURGEABILITY isspecified with an incorrectCVDA

5 No valid ECBs have beenfound in the list becauseeither the ECBLISTaddress is not valid or allthe ECB addresses arenot valid

Chapter 9. RESP2 values and their meanings 389

Page 410: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

6 The event control blocks(ECBs) specified are inuser-key task-lifetimestorage, and areinaccessible to anothertransaction that isexpected to post theECBs or the ECBsspecified are in read-onlystorage

WAITTERMINAL

INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option

WAITCICS INVREQ 1 An ECB is not valid, forexample the ECB is notfullword aligned

3 NUMEVENTS is not apositive number

4 PURGEABILITY isspecified with an incorrectCVDA

5 No valid ECBs have beenfound in the list, becauseeither the ECBLISTaddress is not valid, or allthe ECB addresses arenot valid

6 The event control block(ECBs) specified are inuser-key task-lifetimestorage, and areinaccessible to anothertransaction that isexpected to post theECBs or the ECBsspecified are in read-onlystorage

WRITE FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT

390 CICS User’s Handbook

Page 411: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LENGERR 10 LENGTH is omitted for aWRITE to a file withvariable-length records orto a BDAM file withundefined-format records

12 The length specified forthe write operationexceeds the maximumrecord size; the record istruncated

14 An incorrect length isspecified for a writeoperation involvingfixed-length records

INVREQ 20 Add operations are notallowed according to thefile entry specification inthe FCT

23 When writing recordscontaining embeddedkeys, the key in therecord area (FROMoption) and the key inRIDFLD do not match

26 The KEYLENGTH optionis specified, and thespecified length does notequal the length definedfor the data set to whichthis file refers to

38 A WRITE with theMASSINSERT option hasbeen issued against aBDAM file

40 A BDAM key conversionerror has occurred

44 The WRITE commanddoes not conform to theformat of WRITE for auser-maintained datatable

Chapter 9. RESP2 values and their meanings 391

Page 412: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

51 A WRITE commandspecifying the RBAkeyword was issuedagainst a KSDS file thatwas being accessed inRLS mode. RLS modedoes not support relativebyte address access toKSDS files

55 NOSUSPEND specifiedbut file is not RLS

DISABLED 50 A file is disabled NOTOPEN 60 The requested file is

CLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but aCLOSE request against ithas been received or aWRITE request wasissued against a data setthat is quiesced, or isbeing quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED command

ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition

NOSPACE 100 No space is available onthe direct access devicefor adding records to adata set

102 The maximum number oftable entries specified forthe user-maintained tablehas already been reached

103 CICS is unable to getsufficient storage in theCICS address space tocreate an in-memory tableentry for the record beingwritten

NOTAUTH 101 A resource security checkhas failed onFILE(filename)

392 CICS User’s Handbook

Page 413: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

LOADING 104 A WRITE is issued to auser-maintained datatable that is currentlybeing loaded

SUPPRESSED 105 A user exit program thatis invoked at the XDTADexit point decides not toadd the record to theuser-maintained datatable

LOCKED 106 An attempt was made towrite a record, but aretained lock existsagainst the key of thisrecord

RECORDBUSY 107 NOSUSPEND wasspecified on the requestbut VSAM held an activelock against the record,which would cause therequest to wait

ILLOGIC 110 A VSAM error hasoccurred that does not fallwithin one of the otherCICS response categories

IOERR 120 There has been an I/Oerror during the file controloperation or you are tryingto write to a BDAM trackaddress that is notdefined for a data set

SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.

DUPREC 150 An attempt has beenmade to add a record to adata set, by referring to afile, or a path over a file(with the UNIQUEKEYattribute), in which thesame key already exists

Chapter 9. RESP2 values and their meanings 393

Page 414: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

WRITEOPERATOR

INVREQ 1 The TEXTLENGTH valueis not valid

2 The NUMROUTES valueis not valid

3 A ROUTECODE value isnot valid

4 The MAXLENGTH valueis not valid

5 The TIMEOUT value isnot valid

6 The ACTION value is notvalid

EXPIRED 7 TIMEOUT has occurredbefore the operator’s replywas received

LENGERR 8 The reply was longer thanMAXLENGTH, and hasbeen truncated

XCTL PGMIDERR 1 A program has no entry in

the PPT and eitherprogram autoinstall wasswitched off, or theprogram autoinstall controlprogram indicated that theprogram should no beautoinstalled

2 A program is disabled 3 A program cannot be

loaded because this wasthe first load of theprogram and the programload failed or this was asubsequent load of theprogram, but the first loadfailed

In order to reset the loadstatus the load modulemust be in the DFHRPLconcatenation, and a SETPROGRAM NEWCOPYwill be required

9 The installed programdefinition is for a remoteprogram

394 CICS User’s Handbook

Page 415: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

21 The program autoinstallcontrol program failedeither because theprogram autoinstall controlprogram is incorrect,incorrectly defined, or asa result of an abend in theprogram autoinstall controlprogram. Programautoinstall is disabled andmessage DFHPG0202 orDFHPG0203 is written tothe CSPL

22 The model returned bythe program autoinstallcontrol program was notdefined in the PPT table,or was not enabled

23 The program autoinstallcontrol program returnedinvalid data

24 Define for the programfailed due to autoinstallreturning an invalidprogram name ordefinition

INVREQ 8 An XCTL command withthe INPUTMSG optionwas issued for a programthat is not associated witha terminal, or that isassociated with an APPClogical unit, or an IRCsession

29 EXEC XCTL is notallowed in a GLUE orTRUE

30 The program managerdomain has not yet beeninitialized

200 An XCTL command withthe INPUTMSG optionhas been issued in aprogram invoked by DPL

LENGERR 11 LENGTH is less than 0 orgreater than 32763

Chapter 9. RESP2 values and their meanings 395

Page 416: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

RESP2 values

Command Condition RESP2 Meaning

26 The COMMAREA addresspassed was zero, butLENGTH was non zero

27 INPUTMSGLEN was lessthan 0 or greater than32767

28 LENGTH orINPUTMSGLEN is greaterthan the length of the dataarea specified in theCOMMAREA orINPUTMSG options, andwhile that data was beingcopied a destructiveoverlap occurred becauseof the incorrect length

NOTAUTH 101 A resource security checkhas failed onPROGRAM(name)

396 CICS User’s Handbook

Page 417: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Chapter 10. EXEC interface block (EIB) response andfunction codes

This appendix lists the response codes and the function codes of EXECCICS commands.

Response codes of EXEC CICS commandsAfter the execution of an EXEC CICS command, fields EIBRESP andEIBRCODE are set to indicate whether the command executed successfully,or whether a CICS condition was raised.

Each possible value of EIBRESP relates directly to a specific condition, nomatter which command caused the condition to be raised. This is not true forEIBRCODE values: both the value and the byte of EIBRCODE in which it isset depend on which command was issued.

The following sections list the conditions that are applicable to the EXECCICS commands described in this book, their corresponding RESP values(decimal), the associated EIBRCODE values (hexadecimal), and thetransaction abend codes (if any).

EXEC CICS DISCARD, INQUIRE, PERFORM, and SETcommandsThe first word of EIBRCODE for these commands is always set equal to thehexadecimal equivalent of the RESP value; the remaining bytes are set toX'00'.

Copyright IBM Corp. 1989, 1999 397

Page 418: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Condition (Byte 3) RESPValuecode code

EIBRCODE Abend

DSNNOTFOUND 93 5D AEX1DUPREC 14 0E AEINEND 83 53 AEXKFILENOTFOUND 12 0C AEILILLOGIC 21 15 AEIUINVREQ 16 10 AEIPIOERR 17 11 AEIQJIDERR 43 2B AEYGLENGERR 22 16 AEIVMODELIDERR 95 5F AEX3NOSPACE 18 12 AEIRNOSTG 42 2A —NOTAUTH 70 46 AEY7NOTFND 13 0D AEIMPARTNERIDERR 97 61 AEX5PGMIDERR 27 1B AEI0PROFILEIDERR 98 62 AEX6QIDERR 44 2C AEYHSYSBUSY 59 3B —SYSIDERR 53 35 AEYQTASKIDERR 91 5B AEXXTCIDERR 92 5C AEX0TERMIDERR 11 0B AEIKTRANSIDERR 28 1C AEI1

| UOWNOTFOUND| 102| 66| -USERIDERR 69 45 AEYXVOLIDERR 71 47 AEXV

EXEC CICS DISABLE, ENABLE, and EXTRACT EXITcommandsConditions that can be raised by the DISABLE, ENABLE, and EXTRACTEXIT commands are INVEXITREQ and NOTAUTH. There are no conditionsassociated with the RESYNC command.

Condition RESPValue

EIBRCODE Abend

INVEXITREQ 63 80 AEY0NOTAUTH 70 46 AEY7

398 CICS User’s Handbook

Page 419: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Function codes of EXEC CICS commandsThe function code (field EIBFN) is a hexadecimal value that identifies thecommand most recently issued by a task. The format of the EIBFN field isas follows:

ASM CL2

COBOL PIC X(2)

PL/I CHAR (2)

C CHAR variable name(2);

The function codes of the commands described in this book are listed belowin command sequence, then in function code sequence. For informationabout other function codes, see the CICS Application ProgrammingReference manual.

Command Code

ACQUIRE TERMINAL 86 02COLLECT STATISTICS 70 08CREATE CONNECTION 30 0ECREATE DB2CONN 30 20CREATE DB2ENTRY 30 22CREATE DB2TRAN 30 24

| CREATE DOCTEMPLATE| 30 2E| CREATE ENQMODEL| 30 2A

CREATE FILE 30 14CREATE JOURNALMODEL 30 1ECREATE LSRPOOL 30 16CREATE MAPSET 30 04CREATE PARTITIONSET 30 06CREATE PARTNER 30 18

| CREATE PROCESSTYPE| 30 26CREATE PROFILE 30 0ACREATE PROGRAM 30 02

| CREATE REQUESTMODEL| 30 2CCREATE SESSIONS 30 12

| CREATE TCPIPSERVICE| 30 30CREATE TDQUEUE 30 1CCREATE TERMINAL 30 10CREATE TRANCLASS 30 1ACREATE TRANSACTION 30 08

| CREATE TSMODEL| 30 28CREATE TYPETERM 30 0CDISABLE PROGRAM 22 04DISCARD AUTINSTMODEL 42 10DISCARD CONNECTION 58 10DISCARD DB2CONN 94 10DISCARD DB2ENTRY 94 30DISCARD DB2TRAN 94 50

Chapter 10. EXEC interface block (EIB) response and function codes 399

Page 420: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Command Code

| DISCARD DOCTEMPLATE| 9E 10| DISCARD ENQMODEL| 90 90

DISCARD FILE 4C 10DISCARDJOURNALMODEL

92 10

DISCARD JOURNALNAME 60 10DISCARD PARTNER 44 10

| DISCARD PROCESSTYPE| 96 10DISCARD PROFILE 46 10DISCARD PROGRAM 4E 10

| DISCARD| REQUESTMODEL| 9A 10

| DISCARD TCPIPSERVICE| 9C 10DISCARD TDQUEUE 5C 10DISCARD TERMINAL 52 10DISCARD TRANCLASS 5E 18DISCARD TRANSACTION 50 10

| DISCARD TSMODEL| 80 30ENABLE PROGRAM 22 02EXTRACT EXIT 22 06

| INQUIRE ACTIVITYID| 96 12INQUIRE AUTINSTMODEL 42 02INQUIRE AUTOINSTALL 68 12

| INQUIRE CFDTPOOL| 98 02INQUIRE CONNECTION 58 02

| INQUIRE CONTAINER| 96 14INQUIRE DB2CONN 94 02INQUIRE DB2ENTRY 94 22INQUIRE DB2TRAN 94 42INQUIRE DELETSHIPPED 68 22

| INQUIRE DOCTEMPLATE| 9E 02INQUIRE DSNAME 7A 02INQUIRE DUMPDS 66 02

| INQUIRE ENQMODEL| 90 82| INQUIRE EVENT| 96 16| INQUIRE EXCI| 7C 02

INQUIRE EXITPROGRAM 88 02INQUIRE FILE 4C 02INQUIRE IRC 6E 02INQUIRE JOURNALMODEL 92 02INQUIRE JOURNALNAME 60 12INQUIRE JOURNALNUM 60 02INQUIRE MODENAME 5A 02INQUIRE MONITOR 70 12INQUIRE NETNAME 52 16INQUIRE NETNAME 52 06INQUIRE PARTNER 44 02

| INQUIRE PROCESS| 96 18

400 CICS User’s Handbook

Page 421: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Command Code

| INQUIRE PROCESSTYPE| 96 02INQUIRE PROFILE 46 02INQUIRE PROGRAM 4E 02INQUIRE REQID 8A 02

| INQUIRE REQUESTMODEL| 9A 02| INQUIRE RRMS| 3A 02

INQUIRE STATISTICS 70 02INQUIRE STORAGE 5E 08INQUIRE STREAMNAME 92 12INQUIRE SYSDUMPCODE 66 22INQUIRE SYSTEM 54 02INQUIRE TASK 5E 02INQUIRE TCLASS 5E 12

| INQUIRE TCPIP| 9C 12| INQUIRE TCPIPSERVICE| 9C 02

INQUIRE TDQUEUE 5C 02INQUIRE TERMINAL 52 02INQUIRE TERMINAL 52 12

| INQUIRE TIMER| 96 38INQUIRE TRACEDEST 78 02INQUIRE TRACEFLAG 78 12INQUIRE TRACETYPE 78 22INQUIRE TRANCLASS 5E 1AINQUIRETRANDUMPCODE

66 12

INQUIRE TRANSACTION 50 02| INQUIRE TSMODEL| 80 22| INQUIRE TSPOOL| 80 1A| INQUIRE TSQNAME| 80 12

INQUIRE TSQUEUE 80 02INQUIRE UOW 90 02INQUIRE UOWDSNFAIL 90 62INQUIRE UOWENQ 90 22INQUIRE UOWLINK 90 42INQUIRE VOLUME 62 02INQUIRE VTAM 68 02

| INQUIRE WEB| 9C 22PERFORM DELETSHIPPED 68 26PERFORM DUMP 7E 04PERFORM ENDAFFINITY 58 06PERFORM RESETTIME 72 02PERFORM SECURITY 64 02PERFORM SHUTDOWN 76 02PERFORM STATISTICS 70 06RESYNC ENTRYNAME 16 04SET AUTOINSTALL 68 14SET CONNECTION 58 04SET DB2CONN 94 04

Chapter 10. EXEC interface block (EIB) response and function codes 401

Page 422: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Command Code

SET DB2ENTRY 94 24SET DB2TRAN 94 44SET DELETSHIPPED 68 24SET DSNAME 7A 04SET DUMPDS 66 04

| SET ENQMODEL| 90 84SET FILE 4C 04SET IRC 6E 04SET JOURNALNAME 60 14SET JOURNALNUM 60 04SET MODENAME 5A 04SET MONITOR 70 14SET NETNAME 52 08

| SET PROCESSTYPE| 96 04SET PROGRAM 4E 04SET STATISTICS 70 04SET SYSDUMPCODE 66 24SET SYSTEM 54 04SET TASK 5E 04SET TCLASS 5E 14

| SET TCPIP| 9C 14| SET TCPIPSERVICE| 9C 04

SET TDQUEUE 5C 04SET TERMINAL 52 04SET TERMINAL 52 14SET TRACEDEST 78 04SET TRACEFLAG 78 14SET TRACETYPE 78 24SET TRANCLASS 5E 1CSET TRANDUMPCODE 66 14SET TRANSACTION 50 04

| SET TSQNAME| 80 14| SET TSQUEUE| 80 04

SET UOW 90 04SET UOWLINK 90 44SET VOLUME 62 04SET VTAM 68 04

| SET WEB| 9C 24

Code Command

16 04 RESYNC ENTRYNAME22 02 ENABLE PROGRAM22 04 DISABLE PROGRAM22 06 EXTRACT EXIT30 0A CREATE PROFILE30 0C CREATE TYPETERM

402 CICS User’s Handbook

Page 423: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Code Command

30 0E CREATE CONNECTION30 02 CREATE PROGRAM30 04 CREATE MAPSET30 06 CREATE PARTITIONSET30 08 CREATE TRANSACTION30 1A CREATE TRANCLASS30 1C CREATE TDQUEUE30 1E CREATE JOURNALMODEL30 10 CREATE TERMINAL30 12 CREATE SESSIONS30 14 CREATE FILE30 16 CREATE LSRPOOL30 18 CREATE PARTNER30 20 CREATE DB2CONN30 22 CREATE DB2ENTRY30 24 CREATE DB2TRAN

| 30 26| CREATE PROCESSTYPE| 30 28| CREATE TSMODEL| 30 2A| CREATE ENQMODEL| 30 2C| CREATE REQUESTMODEL| 30 2E| CREATE DOCTEMPLATE| 30 30| CREATE TCPIPSERVICE| 3A 02| INQUIRE RRMS

42 02 INQUIRE AUTINSTMODEL42 10 DISCARD AUTINSTMODEL44 02 INQUIRE PARTNER44 10 DISCARD PARTNER46 02 INQUIRE PROFILE46 10 DISCARD PROFILE4C 02 INQUIRE FILE4C 04 SET FILE4C 10 DISCARD FILE4E 02 INQUIRE PROGRAM4E 04 SET PROGRAM4E 10 DISCARD PROGRAM50 02 INQUIRE TRANSACTION50 04 SET TRANSACTION50 10 DISCARD TRANSACTION52 02 INQUIRE TERMINAL52 04 SET TERMINAL52 06 INQUIRE NETNAME52 08 SET NETNAME52 10 DISCARD TERMINAL52 12 INQUIRE TERMINAL52 14 SET TERMINAL52 16 INQUIRE NETNAME54 02 INQUIRE SYSTEM54 04 SET SYSTEM

Chapter 10. EXEC interface block (EIB) response and function codes 403

Page 424: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Code Command

58 02 INQUIRE CONNECTION58 04 SET CONNECTION58 06 PERFORM ENDAFFINITY58 10 DISCARD CONNECTION5A 02 INQUIRE MODENAME5A 04 SET MODENAME5C 02 INQUIRE TDQUEUE5C 04 SET TDQUEUE5C 10 DISCARD TDQUEUE5E 02 INQUIRE TASK5E 04 SET TASK5E 08 INQUIRE STORAGE5E 1A INQUIRE TRANCLASS5E 1C SET TRANCLASS5E 12 INQUIRE TCLASS5E 14 SET TCLASS5E 18 DISCARD TRANCLASS60 02 INQUIRE JOURNALNUM60 04 SET JOURNALNUM60 10 DISCARD JOURNALNAME60 12 INQUIRE JOURNALNAME60 14 SET JOURNALNAME62 02 INQUIRE VOLUME62 04 SET VOLUME64 02 PERFORM SECURITY66 02 INQUIRE DUMPDS66 04 SET DUMPDS66 12 INQUIRE TRANDUMPCODE66 14 SET TRANDUMPCODE66 22 INQUIRE SYSDUMPCODE66 24 SET SYSDUMPCODE68 02 INQUIRE VTAM68 04 SET VTAM68 12 INQUIRE AUTOINSTALL68 14 SET AUTOINSTALL68 22 INQUIRE DELETSHIPPED68 24 SET DELETSHIPPED68 26 PERFORM DELETSHIPPED6E 02 INQUIRE IRC6E 04 SET IRC70 02 INQUIRE STATISTICS70 04 SET STATISTICS70 06 PERFORM STATISTICS70 08 COLLECT STATISTICS70 12 INQUIRE MONITOR70 14 SET MONITOR72 02 PERFORM RESETTIME76 02 PERFORM SHUTDOWN

404 CICS User’s Handbook

Page 425: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Code Command

78 02 INQUIRE TRACEDEST78 04 SET TRACEDEST78 12 INQUIRE TRACEFLAG78 14 SET TRACEFLAG78 22 INQUIRE TRACETYPE78 24 SET TRACETYPE7A 02 INQUIRE DSNAME7A 04 SET DSNAME

| 7C 02| INQUIRE EXCI7E 04 PERFORM DUMP80 02 INQUIRE TSQUEUE

| 80 04| SET TSQUEUE| 80 12| INQUIRE TSQNAME| 80 14| SET TSQNAME| 80 1A| INQUIRE TSPOOL| 80 22| INQUIRE TSMODEL| 80 30| DISCARD TSMODEL

86 02 ACQUIRE TERMINAL88 02 INQUIRE EXITPROGRAM8A 02 INQUIRE REQID90 02 INQUIRE UOW90 04 SET UOW90 22 INQUIRE UOWENQ90 42 INQUIRE UOWLINK90 44 SET UOWLINK90 62 INQUIRE UOWDSNFAIL

| 90 82| INQUIRE ENQMODEL| 90 84| SET ENQMODEL| 90 90| DISCARD ENQMODEL

92 02 INQUIRE JOURNALMODEL92 10 DISCARD JOURNALMODEL92 12 INQUIRE STREAMNAME

| 94 02| INQUIRE DB2CONN| 94 04| SET DB2CONN| 94 10| DISCARD DB2CONN| 94 22| INQUIRE DB2ENTRY| 94 24| SET DB2ENTRY| 94 30| DISCARD DB2ENTRY| 94 42| INQUIRE DB2TRAN| 94 44| SET DB2TRAN| 94 50| DISCARD DB2TRAN| 96 02| INQUIRE PROCESSTYPE| 96 04| SET PROCESSTYPE| 96 10| DISCARD PROCESSTYPE| 96 12| INQUIRE ACTIVITYID| 96 14| INQUIRE CONTAINER| 96 16| INQUIRE EVENT| 96 18| INQUIRE PROCESS

Chapter 10. EXEC interface block (EIB) response and function codes 405

Page 426: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes � DFH messages

Code Command

| 96 38| INQUIRE TIMER| 98 02| INQUIRE CFDTPOOL| 9A 02| INQUIRE REQUESTMODEL| 9A 10| DISCARD REQUESTMODEL| 9C 02| INQUIRE TCPIPSERVICE| 9C 04| SET TCPIPSERVICE| 9C 10| DISCARD TCPIPSERVICE| 9C 12| INQUIRE TCPIP| 9C 14| SET TCPIP| 9C 22| INQUIRE WEB| 9C 24| SET WEB| 9E 02| INQUIRE DOCTEMPLATE| 9E 10| DISCARD DOCTEMPLATE

406 CICS User’s Handbook

Page 427: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

Chapter 11. DFH messages

While CICS is running, it can produce several types of messages:

� Console messages advise the system operator of execution progress, orrequest a decision.

� Certain CICS-supplied support programs communicate directly withterminal operators.

� CICS management modules and support programs log significant eventsand error occurrences to transient data destinations; for example, to thecontrol system master terminal (CSMT), or to the CICS database controllog (CDBC) for the CICS-DBCTL interface.

� The CICS message switching program (DFHMSP) generates messageswitching responses (described in the CICS Supplied Transactionsmanual).

� CICS directs informational macro notes (mnotes) to programmers (theseare not documented).

� Messages produced by CICS/ESA utility programs such as DFH$MOLSand DFHMNDUP. These messages are self-explanatory and are notdocumented.

All of the CICS messages described in this book can also be viewed onlineusing the CICS transaction CMAC. For guidance on using CMAC, see theCICS Supplied Transactions manual.

Message IdentifiersMessage identifiers are of two types.

DFHnnnn identifiersThese consist of the prefix “DFH” followed by a four digit message number.“DFH” is the IBM assigned identifier for CICS modules. The first two digitsare the CICS module reference code as follows:01 DFHSSIN

42 DFHZCNR

51 DFHCSDUP

52 DFHCSDUP

55 DFHCSDUP

56 DFHCSDUP

7x Command-level translators

The last two digits are assigned by CICS to identify the message or group ofmessages within an assembled program.

Copyright IBM Corp. 1989, 1999 407

Page 428: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

DFHccnnnn identifiersThese consist of the prefix “DFH” followed by a two-letter componentidentifier (cc), and a four-digit message number (nnnn). The componentidentifier shows the domain or the component which issues the message.Here is a list of component identifiers with associated domains andcomponents:AC The abnormal condition

program component

AI The auto-install terminal modelmanager (AITM)

AM The RDO allocation manager

AP The application domain

AU The transaction affinities utility

BA The Business ApplicationManager (BAM) domain

BR Bridging to 3270 transactions

CA RDO command utility routine

CC The CICS catalog domain (localand global)

CE The sign on programcomponent

CF CICS coupling facility datatables server

CP The CPI Communicationscomponent

CR The ISC remote schedulercomponent

CZ The CICS class librariesdomain

DB The CICS database controlcomponent

DD The directory manager

DM The domain manager domain

DS The dispatcher domain

DU The dump domain

DX The CICS database controlcomponent

EM The Event Manager domain

ER The user backout program

EX The external CICS interface

FC The file control component

FE The FE terminal test programcomponent

IC The interval control program

IN The indoubt testing tool

IR The interregion component

JC The online journal controlcomponent

KC The transaction/profile manager

KE The kernel domain

LD The loader domain

LG The logger domain

LM The lock manager domain

MC The BMS message controlprogram component

ME The message domain

MN The monitor domain

MU The message editing utilityprogram

MV The MVS RESMGR exit stub

NQ The enqueue manager domain

PA The parameter managerdomain

408 CICS User’s Handbook

Page 429: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

PC The program control programcomponent

PD The print dump exit routineDFHPDX

PG The program manager domain

PR The partner resource manager

PS The system spooler interfacecontrol module component

RD The RDO allocation manager

RM The recovery Manager

RP CICS ONC RPC

RS The communicationsresynchronization program

RT The ISC transaction routingcomponent

RU The recovery utility program

RX The RRS-coordinated EXCIdomain

SH The Scheduler domain

SI The system initializationcomponent

SK The sub task control programcomponent

SM The storage manager domain

SN The signon component

SO The CICS sockets domain

SR The system recoverycomponent

ST The statistics domain

SZ The front end programminginterface (FEPI)

TC The terminal control programcomponent

TD The transient data component

TF The terminal facility manager

TI The timer domain

TM The system terminationprogram component

TO The terminal object resolutionprogram component

TP The BMS terminal pageretrieval program component

TR The trace domain

TS The temporary storage domain

UP The measured usage licensecharging support macro

US The user domain

WB The CICS Web Interface

XA The XRF alternate component

XC The XRF CICS availabilitymanager

XG The XRF general component

XM The transaction manager

XO The XRF CICS availabilitymanager

XQ The shared temporary storagequeue pool server

XS The CICS security component

ZC The terminal control working setcomponent

ZE The TCP error message writercomponent

ZN The syncpoint componentThus the CICS message DFHAP0002 is issued from the application domain,identified by the two-character identifier AP.

Chapter 11. DFH messages 409

Page 430: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

Action codesCertain messages (for example, DFHDB8208D) include an action code afterthe message identifier. Action codes give guidance to the operator of thetype of action needed when the message appears on the system console.The following action codes are used:

A Immediate action (for example, mount a tape)

D Immediate decision (reply to a request, for example, enter “GO” or“CANCEL”)

E Eventual – action is required, but does not have to be takenimmediately

I No action required (If issued via the message domain, these messagescan be suppressed by specifying MSGLVL=0 as a system initializationoverride.)

Severity codesCertain messages, especially those associated with messages to terminaloperators and messages which come from CICS utilities, have a severitycode. (DFHST0210 I, is an example.) A severity code indicates to theoperator whether a message is associated with an error, and if so, howserious it is. The following severity codes are used:

E Error. Something has gone wrong and action is required of the userbefore CICS processing can continue.

I Information only. No action is required.

W Warning. Something may have gone wrong, a program loop forexample, but CICS processing continues.

S Severe error. Something serious has gone wrong and immediate actionis required. CICS processing is suspended until action has been taken.

410 CICS User’s Handbook

Page 431: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

Format of informationInformation about each message is presented in the following format:

� Message identifier – in the form DFHnnnn or DFHccnnnn

� Message text – the words and inserts which make up the message asdisplayed in CICS

� Explanation – the events leading to or following the production of themessage

� System action – the action that has been or will be taken by CICS

� User response – the action recommended for the user (the console orterminal operator or system programmer)

� Destination – the device or log to which the message is sent. This isone of the following:

– Console – refers to a terminal type attached to CICS. (Route codesare 2 and 11 unless otherwise stated.)

– Terminal end user

– TERMCDBC – terminals running the CDBC transaction.

– SYSPRINT (System printer)

– One of the following transient data queues:

CADL VTAM resource definition logCAFF Transaction affinities utility messagesCAIL Autoinstall terminal model manager (AITM) logCCPI Common programming interface for communications (CPI

Communications) messagesCDBC CICS-DBCTL interface logCDB2 CICS DB2 messagesCDUL Transaction dump messagesCMIG Migration log for messages reporting the use of functions

that are no longer supportedCPLD PL/I dumpsCPLI PL/I sysprint outputCRDI Log for installed resource definitionsCRPO ONC RPC messagesCSDL CEDA command logCSCS Sign on/off security logCSFL File allocation and related messagesCSKL Log for transaction and profile resource definitionsCSMT Write term errors and abends from DFHTACP and

DFHACPCSPL Log for program resource definitions

Chapter 11. DFH messages 411

Page 432: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

CSQL TDQUEUE messagesCSRL Log for partner resource definitionsCSSL Statistics logCSTL Term I/O error messages from DFHTACPCSML Sign on/off messagesCSNE Terminal error messages issued from DFHZNAC.CSZL FEPI message queueCWBO CICS Web Interface messages

Note: Destination CXRF is used by the alternate CICS system inan XRF environment until the other destinations are madeavailable during the takeover.

� Module(s) – the name(s) of the module or modules that determined thatthe message should be sent. (This is not necessarily the module thatissued the macro to write the message.)

XMEOUT parameters –Messages that can drive the XMEOUT global user exit include a list ofXMEOUT parameters. The XMEOUT exit allows you to suppress or reroutemessages that use the message domain. For programming informationabout the XMEOUT user exit see the CICS Customization Guide

Route codes –Console messages can be sent to a number of console types. The type ofconsole to which a particular message is sent is determined by the MVSroute code. Each route code maps onto one console type. The meanings ofthe route codes normally used by CICS are as follows:

Code Meaning1 Master console action – indicates a change in system status

demanding operator action2 Master console information – indicates a change in system status

(system default)3 Tape pool status or other tape related information4 Direct access pool status or other related information5 Tape library information6 Disk library information7 Unit record pool information8 Teleprocessing control status9 System security checking

Note: This route code suppresses the operator’s reply on thescreen and on SYSLOG

10 System error or maintenance information

412 CICS User’s Handbook

Page 433: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

11 Programmer information for the MVS log

Unless otherwise stated, console messages have the route codes ‘2’ and‘11’.

Message editing –You can use the message editing utility to change the text or language ofthose CICS messages that are issued via the message domain. Messagesthat cannot be changed using the utility include a note to this effect beforethe message destination. See the CICS Operations and Utilities Guide formore information about the message editing utility.

Console message reformatting –The “console message handling facility” is an optional feature of the CICSsubsystem that can affect the appearance of CICS messages displayed onan MVS console. It is effective when you specify FORMATMSG=YES as aninitialization parameter for the CICS subsystem, as described in the CICSTransaction Server for OS/390 Installation Guide. When this facility is used,it affects messages displayed on MVS system consoles in the followingways:

� The subsystem tries to ensure that all console messages issued by allCICS regions have a standard format. The standard format is:

Column number: 1 13 22

| | |

+DFHnnnn applid message-text

The “plus” sign (+) is added by MVS to indicate that a problem-stateprogram issued the message. It is not present when CICS issues themessage while it is in supervisor state.

The applid inserted into the message is the specific application identifier.This is the identifier that is specified in the system initializationparameter APPLID. It is the only operand when XRF=NO is alsospecified, or the second operand when XRF=YES is also specified.

� The subsystem adds routecodes specified in the ROUTECODESsubsystem initialization parameter, so the messages might be sent tomore console destinations than those implied in the body of this book.

� The subsystem reformats messages for all CICS releases, even thoseissued by CICS/OS/VS Version 1.

� The subsystem does not reformat messages that are issued by a CICSregion that has not yet determined its applid. This includes messagesthat are issued while processing the system initialization table and itsoverrides.

Chapter 11. DFH messages 413

Page 434: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

� The subsystem routine that reformats the messages does not receivecontrol until after the message has been recorded in the CICS job’s joblog. Therefore, the reformatting is not usually apparent in the job log.

� Messages issued by the message domain already contain the applid.The subsystem does not insert the applid into such messages, but itmight insert blank characters to cause alignment into standard locations.

� If the original CICS message is a long one, adding the applid in thestandard position might cause the message to exceed the maximumlength for an MVS console message. In this case, the original messageis suppressed (does not appear on the console), and a new message isissued using the MVS multiple-line console message service to split themessage over several lines. Both the original message and perhapsseveral instances of the reformatted multiple-line message appear in thejob log, but only one copy of the reformatted message is displayed onthe console.

� For some messages where the applid normally follows a time and datestamp, inserting the applid in the standard position would have resultedin the applid being duplicated within the message. For these messages,the subsystem eliminates the time and date stamp, since they areavailable from other sources, and only one occurrence of the applid isshown.

Terminal identifiers –Some messages include a terminal identifier (termid) in the message text.This is normally shown as a 4-character identifier. However, when CICScannot completely identify a terminal – for example, when intersystemcommunication is taking place, the terminal identifier is prefixed by theapplication identification (applid) of the system owning the terminal.

Abend code inserts –The transaction abend code insert (abcode) in some CICS messages isdisplayed as ‘????’ when neither the EXEC CICS ABEND request nor theDFHPC TYPE=ABEND macro request specifies an abend code.

Dumps –A dump is generally available for printing when a CICS system abend orabnormal termination occurs, provided the relevant data set has beenspecified. The dump can be used for problem determination.

414 CICS User’s Handbook

Page 435: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

Terminology –The terms “abnormally terminates” and “abnormal termination” are frequentlyused in a general sense to relate, as applicable, to one of the following:

� The termination of CICS as a result of an MVS ABEND macro. (Theterm “abend” may also be used.)

� The termination of a transaction (task) as a result of a CICS transactionABEND macro.

MVS user abend codesDFH messages which accompany a CICS system, utility, or subtask abendhave an associated MVS user abend code. Where possible, the value of thiscode is the numeric part of the corresponding DFH message. ThusDFH0305 has an 0305 user abend code. If an MVS abend code is issuedbut not the associated CICS message, the problem probably does notoriginate with CICS. See the description of the MVS abend code in the MVSSystem Codes manual for further information.

The highest possible value of an MVS user abend code is 4095, thereforeany DFH message with a number higher than 4095 has an MVS user abendcode that does not follow the above convention. The following are lists of theabend codes for messages with numbers above 4095, in order of abendcode, and in order of message number.

Ordered by abend code

Chapter 11. DFH messages 415

Page 436: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

0108 DFH52630121 DFH51000123 DFH51750125 DFH51800126 DFH51840127 DFH51480147 DFH57210148 DFH57220149 DFH57230150 DFHER57240151 DFHER57250152 DFH57540161 DFHAK58020162 DFHAK58030170 DFHPS53940184 DFHJC45340185 DFHJC45300190 DFHXG64500191 DFHXG64510192 DFHXG64520193 DFHXG64530194 DFHXG64540195 DFHXG64400196 DFHXG64410197 DFHXG64420198 DFHXG64430200 DFHXA65400201 DFHXA65410202 DFHXG64440203 DFHXG64300204 DFHXA65300205 DFHXG64390206 DFHXG64150207 DFHXA65230209 DFHXG64270210 DFHXA65280211 DFH65290213 DFHXG65240214 DFHXA65800220 DFHXO67000221 DFHXO67040222 DFHXO67020223 DFHXO67030224 DFHXO6720

416 CICS User’s Handbook

Page 437: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

Ordered by message identifierDFHAK5802 0161DFHAK5803 0162DFHER5724 0150DFHER5725 0151DFHJC4530 0185DFHJC4534 0184DFHPS5394 0170DFHXA6523 0207DFHXA6528 0210DFHXA6530 0204DFHXA6540 0200DFHXA6541 0201DFHXA6580 0214DFHXG6415 0206DFHXG6427 0209DFHXG6430 0203DFHXG6439 0205DFHXG6440 0195DFHXG6441 0196DFHXG6442 0197DFHXG6443 0198DFHXG6444 0202DFHXG6450 0190DFHXG6451 0191DFHXG6452 0192DFHXG6453 0193DFHXG6454 0194DFHXG6524 0213DFHXO6700 0220DFHXO6702 0222DFHXO6703 0223DFHXO6704 0221DFHXO6720 0224DFH5100 0121DFH5148 0127DFH5175 0123DFH5180 0125DFH5184 0126DFH5263 0108DFH5721 0147DFH5722 0148DFH5723 0149DFH5754 0152DFH6529 0211

Notes:

1. All messages which appear in the JES job log are prefixed by a timestamp and job number. Because of this, some messages will have theirmessage text truncated. If the full message text is required, consult theMVS log as all messages in the JES log are duplicated in the MVSsystem log.

2. User abend 0225 is internal to CICS. It is issued by DFHDTES when,during backout, an entry in a hash table has been marked empty where

Chapter 11. DFH messages 417

Page 438: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

it should not be possible. This causes the CICS region to be abnormallyterminated. If this abend occurs, you will need help to resolve theproblem. See Part 4 of the CICS Problem Determination Guide forguidance on how to proceed.

418 CICS User’s Handbook

Page 439: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

Chapter 12. Transaction abend codes

When abnormal conditions occur, CICS can send a message to the CSMTtransient data destination containing the transaction ID, the program nameand the abend code. Here is an example:

DFHAC2236 date time applid Transaction tranid abend primary abcode in programprogram name term termid backout successful

{ batchid = }batchid. message

Alternatively, the application can intercept abends by including an activeEXEC CICS HANDLE ABEND command. The actual abend code can bedetermined by issuing the EXEC CICS ASSIGN command with the ABCODEoption.

The transaction identification code tranid usually consists of the 4 charactersdefined to CICS. However, when a transaction is initiated by using a lightpen, an operator identification (OPID) card reader, or 3270 PA or PF keys(specified in the TASKREQ= operand), CICS creates an internal transactionidentification in the form of a 1-byte 3270 attention identification (AID) codefollowed by 3 bytes of X'FF'.

The code that may actually appear in the message in place of theinternally-created transaction identification will be *xx*, where xx is thecharacter translation of the 3270 AID code. To prevent ambiguity, the usershould avoid using these codes as transaction identifiers.

The keys, the light pen (LPA), and OPID, and their corresponding printedAID codes are given in the following list:

PF1 *F1* PF13 *C1* LPA *7E*PF2 *F2* PF14 *C2* OPID *E6*PF3 *F3* PF15 *C3* PA1 *6C*PF4 *F4* PF16 *C4* PA2 *6E*PF5 *F5* PF17 *C5* PA3 *6B*PF6 *F6* PF18 *C6*PF7 *F7* PF19 *C7*PF8 *F8* PF20 *C8*PF9 *F9* PF21 *C9*PF10 *7A* PF22 *4A*PF11 *7B* PF23 *4B*PF12 *7C* PF24 *4C*

Copyright IBM Corp. 1989, 1999 419

Page 440: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

DFH messages

An abend code indicates the cause of an error that may have beenoriginated by CICS or by a user program. For most of the abend codesdescribed, a CICS transaction dump is provided at abnormal termination.

All CICS transaction abend codes abcode are 4-character alphanumericcodes of the form Axxy, where:

Aack 'M' is the IBM-assigned designation of a CICS transaction abend.

xx is the 2-character code assigned by CICS to identify the module thatdetected an error.

y is the 1-character alphanumeric code assigned by CICS.

Format of informationFor each transaction abend code, the following information is given:

� An explanation of events leading to or following the message.

� The action that has been or will be taken by CICS (system action).

� The action recommended for the user (console or terminal operator).

� The module or modules that can determine that the message should besent (not necessarily the module or modules that can issue the macro towrite the message.)

420 CICS User’s Handbook

Page 441: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Chapter 13. Transaction abend codes

For guidance about interpreting the transaction abend codes summarizedbelow, see the CICS Messages and Codes manual.

Abend Module Explanation

AACA DFHTFP,DFHACP Invalid error codeAALM DFHAMLM Error has occurred on call to Log Manager (LM)

domainAALN DFHAMTD Error has occurred on call to the TD managerAALO DFHAMD2 Error has occurred on call to the CICS/DB2 table

manager DFHD2TMAALP DFHAMPG Error has occurred on call to the Program ManagerAALQ DFHAMBA Error has occurred on call to the Business

Application ManagerAALR DFHAMBA Error has occurred on call to the Temporary Storage

ManagerAALS DFHAMBA Error has occurred on call to the Global Enqueue

ManagerAALT DFHAMOP Error has occurred on call to the Internet Inter-Orb

Protocol ManagerAALU DFHAMSO Error has occurred on call to the Sockets Doamin

ManagerAAL1 DFHALP DFHALP was processing a request that deadlockedAAL2 DFHALP Unexpected response from suspend or resume

allocated taskAAL3 DFHALP Task purged before GETMAIN completedAAL4 DFHALP Error occurred on call to storage manager (SM)

domainAAL6 DFHALP Error occurred on call to

SIGNOFF_TERMINAL_USERAAL7 DFHALP Error occurred on call to schedule a remote terminal

deleteAAMA DFHAMP Internal logic error in DFHAMPAAMC DFHAMP Task purged before GETMAIN completedAAMD DFHAMP Unexpected return code from DFHDMP, internal

logic errorAAMF DFHAMP Unexpected return code from KE domain, internal

logic errorAAMG DFHAMP Unexpected return code from DFHAFMT, internal

logic errorAAMH DFHAMP Unexpected return code from DFHFCMT, internal

logic errorAAMI DFHAMP Unexpected return code from DFHFCRL, internal

logic errorAAMJ DFHAMP Irrecoverable error from DFHFCFS while installing a

file

Copyright IBM Corp. 1989, 1999 421

Page 442: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AAMK DFHAMP Irrecoverable error from DFHFCDN while installing afile

AAMN DFHAMP Unexpected return code from DFHPRPT, internallogic error

AAMO DFHAMP Invalid return code from DFHTORAAMP DFHAMP Unexpected return code from DFHPUP, internal

logic errorAAMQ DFHAMP Partner resource manager is unavailable, failed to

initializeAAMS DFHAMP Unexpected return code from SM domain, internal

logic errorAAMT DFHAMP Unexpected return code from DFHTMP, internal

logic errorAAMZ DFHAMP Unexpected return code from DFHZCP, internal logic

errorAAM1 DFHAMP Unexpected response from DFHXMCL during install

of TRANCLASSAAM2 DFHAMP Unexpected response from DFHXMXD during

transaction definition installAAOA DFHCPI Unsupported CPI verbAAOB DFHCPI CPI verb with more than eight parametersAAOC DFHCPARH Invalid number of parameters for CPI

Communications callAAOD DFHCPCBI Task purged before GETMAIN request to SM

domain completedAAOE DFHCPCBA Task purged before GETMAIN request to SM

domain completedAAOF DFHCPCBS Task purged before GETMAIN request to SM

domain completedAAOG DFHCPCBA Application attached with unsupported sync levelAAOH DFHCPCOJ Journaling of data sent on CPI Communications

mapped conversation failedAAOI DFHCPCRI,

DFHCPCRWJournaling of data received on CPI Communicationsmapped conversation failed

AAOJ DFHCPIC CPI Communications detected unexpected responsefrom internal routine

AAOK DFHCPIC CPI Communications detected unexpected call tointernal routine

AAOL DFHCPCLR CPI Communications made an invalid call toDFHLUC

AAOM DFHCPCLR,DFHCPSRH

CPI Communications out of sync with DFHZUSRstate machines

AAON DFHCPCLR,DFHCPCLC

Unexpected response from DFHLUC to CPICommunications

AAOO DFHCPARH CPI Communications invoked with invalid firstparameter

AAOP DFHCPCFS Impossible situation requested for CPICommunications

422 CICS User’s Handbook

Page 443: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AAOQ DFHCPCFS CPI Communications return code has no entry instate table

AAOR DFHCPIC CPI Communications detected invalid value inconversation control block

AAOS DFHCPIC CPI Communications finds unexpected RESET forconversation state

AAOT DFHCPCBI CPI Communications chain error in conversationcontrol blocks

AAOU DFHCPCBI CPI Communications error processing initializeconversation request

AAOV DFHCPCFS CPI Communications internal state table corruptedAAOW DFHCPCLC Internal logic error in DFHCPCLCAAOX DFHCPIC CPI Communications has detected bad syncpoint

return codeAAOY DFHCPCRB Invalid LL field while CPI Communications receives

mapped conversationAAOZ DFHCPCRB Invalid ID field while CPI Communications receives

mapped conversationAAO2 DFHCPCBA Unexpected response from DFHLUC to CPI

CommunicationsAAO3 DFHCPI Call to CPI Communications without initializationAAO4 DFHCPCLR Logic error detected by DFHZARLAAO5 DFHCPCBA,

DFHCPCBI,DFHCPCBS

Task purged before GETMAIN completed

AAO7 DFHCPSRH Invalid DFHLUC parameter list passed to CPICommunications

AAO8 DFHCPSRH Invalid Conversation Control Block (CPC) passed toCPI Communications

AAO9 DFHCPCLR Task purge detectedABAC DFHBASP EXEC CICS RETURN issued for activity executed

with RUN command.ABAD DFHBASP EXEC CICS RETURN ENDACTIVITY issued for

activity executedwith RUN command.ABAE DFHEIBAM EXEC CICS RETURN issued for activity executed

with LINK command.ABAF DFHEIBAM EXEC CICS RETURN ENDACTIVITY issued for

activity executedwith LINK command.ABLA DFHMCP,

DFHMCPE,DFHM32,DFHPBP,DFHRLR

Task purged before GETMAIN request to SMdomain completed

ABLB DFHMCP,DFHMCPE,DFHM32,DFHPBP,DFHRLR

Error on call to SM domain

Chapter 13. Transaction abend codes 423

Page 444: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ABMA DFHPBP,DFHMCP

TIOA = 0 or < (storage accounting length - 12)

ABMB DFHPBP,DFHMCPDFHMCX

Cursor position larger than current screen size

ABMC DFHMCP CMSG tran attempt to send to greater number ofterminals than possible

ABMD DFHTPP,DFHTPR

Unexpected return code from send DFHTPR orDFHTPP

ABME DFHTPP,DFHTPR

DFHTPR or DFHTPP detected invalid datastreamduring BMS request

ABMF DFHPBP Send length too largeABMG DFHMCP,

DFHTPQBMS service not present

ABMI DFHMCP,DFHMCX,DFHMCY

Not input map

ABML DFHRLR Terminal control locate routine received invalid dataABMM DFHPBP Invalid map specifiedABMO DFHMCP,

DFHMCX,DFHMCY

Not output map

ABMQ DFHQRY Task not terminal-oriented or terminal not defined toCICS correctly

ABMR DFHTPR CPSG initiated but task not terminal-orientedABMU DFHMCP,

DFHEMSAddress not within region boundaries

ABMV DFHRLR Invalid route list entryABMX DFHPBP Invalid set attribute order in textABMZ DFHMCP,

DFHMCX,DFHMCY

TIOA address in TCTTEDA is zero

ABM0 DFHMCP,DFHMCX,DFHMCY

Map could not be located

ABM1 DFHRLR BMS service requested from non-BMS-supportedterminal

ABM2 DFHMCP No user data for BMS requestABM3 DFHMCP BMS service requested from a non-terminal-oriented

taskABM4 DFHMCP,

DFHTPPBMS issued invalid request response to tempstorage PUT or PUTQ

ABM5 DFHMCP,DFHTPR

Purge request issued with invalid REQID by BMS

ABM6 DFHMCP CSPS not installedABM7 DFHPBP Trailer too largeABM8 DFHPBP Justify parameter zero or too large for pageABM9 DFHPBP Header or trailer too large

424 CICS User’s Handbook

Page 445: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ABNA DFHTPS No route list suppliedABNB DFHTPS Invalid TCTTE type for principal facility of the taskABNC DFHTPS Access temporary storage queue failedABNE DFHTPS Error response from BMS ROUTE or STORE

requestABNF DFHTPS Transaction not in send mode when sent to remote

systemABNG DFHTPS Attach received from remote system without dataABNH DFHTPS Ship data to remote system failedABNI DFHTPS No profile for LU6.2 transaction routing requestABNJ DFHTPS Task purged before GETMAIN completeABNK DFHTPS Error on call to storage manager domainABRC DFHBRMS,

DFHBRTCBridge exit not defined and could not beautoinstalled

ABRD DFHBRMS,DFHBRTC

Bridge exit is disabled

ABRE DFHBRMS,DFHBRTC

Bridge exit could not be loaded

ABRF DFHBRMS,DFHBRTC

Bridge exit is defined as remote

ABRG DFHBRXM An invalid bridge facility token was specifiedABRH DFHBRXM The bridge facility token specified is in use by

another transaction, or has been discardedABRI DFHBRXM There are no free bridge facility tokens availableABRJ DFHBRXM An invalid FACILITYLIKE value was specifiedABRK DFHBRXM The bridge exit returned an invalid brxa_resp valueABRN DFHBRIC,

DFHBRMS,DFHBRSP,DFHBRTC

The USERID check failed following call to the bridgeexit

ABRQ DFHBRMS,DFHBRTC

The bridge exit issued an abend

ABRR DFHBRXM The user transaction's profile could not be foundABRS DFHBRXM CICS was unable to obtain storage to create bridge

facilityABRY DFHBRMS,

DFHBRTCCICS returned an unexpected error running thebridge exit

ABRZ DFHBRIC,DFHBRMS,DFHBRSP,DFHBRTC,DFHXMBR

The bridge exit returned invalid data in the BRXA

ABR3 DFHEMS An unsupported BMS request was received by thebridge exit

ABSA DFHTBS A message passed to DFHBSMSG is too long -CICS internal error

ABXA DFH0CBRF Wrong type of RECEIVE vector in input messageABXC DFH0CBRE Error on SYNCPOINT request issued by bridge exit

Chapter 13. Transaction abend codes 425

Page 446: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ABXD DFH0CBRE Error when SYNCPOINT ROLLBACK request issuedby bridge exit

ABXE DFH0CBAE,DFH0CBRENo data passed on BRDATA parameter of STARTcommand

ABXF DFH0CBAE,DFH0CBRE,DFH0CBAIError detected by bridge exit inputting next messageABXG DFH0CBAE,DFH0CBREError detected by bridge exit outputting next

messageABXH DFH0CBRF No data available in message - transaction is non

conversationalABXI DFH0CBAE,DFH0CBREMessage received by bridge exit exceeds maximum

message sizeABXJ DFH0CBAE,DFH0CBREBridge exit detected error in MQCIH passed by client

applicationABXK DFH0CBAE,DFH0CBREBridge exit detected error in data passed on

BRDATA parameterABXM DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with unsupported function or

commandABXN DFH0CBRF Bridge exit detected input messsage was truncatedABXO DFH0CBRF Bridge exit detected error in BRMQ vector passed

by client applicationABXP DFH0CBRF Bridge exit detected error in BRMQ vector header

passedABXQ DFH0CBRF Bridge exit could not find ADSD vector as part of

BRMQ-RM vectorABXS DFH0CBRE Bridge exit detected error trying to open queue for

input/outputABX1 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with invalid BRXA-HEADER -

storage overwriteABX2 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with invalid

BRXA-TRANSACTION-AREA - storage overwriteABX3 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with unsupported

BRXA-COMMAND-AREA - storage overwriteABX5 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called without a user-area - error in

bridge exitABX6 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with invalid user-area - storage

overwrite or error in bridge exitABX7 DFH0CBRF TC command passed to bridge exit exceeded

maximum message sizeABX8 DFH0CBRF BMS BRMQ vector does not contain mapset

requestedABX9 DFH0CBRF Next BMS BRMQ vector does not contain mapname

requestedACAA DFHCAP Parameterized resource definition contains invalid

resource type codeACAD DFHCAP Parameterized resource definition contains invalid

resource type codeACAI DFHCAP Invalid function code for domain call to DFHCAPACAJ DFHCAP Preallocated dynamic storage area too small

426 CICS User’s Handbook

Page 447: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ACAM DFHECBAM Internal Error in CBAM transactionACCx C/370 errors. See the C/370 User's Guide for further

information.ACFA DFHFCDL Abend during loading of CFDT by CFCL transactionACFB DFHEIFC Request to CFDT is reliant on lock acquired before

server failedACFC DFHEIFC Attempt to reopen access between CICS file and

CFDT failedACFD DFHFCDL Call to CICS Txn Manager returned response and

processing cannot continueACFE DFHFCDL Transaction not internally attached to CICSACHA DFHCHS Remote server transaction is incorrect levelACHB DFHCHS Remote server received frame out of sequenceACHC DFHCHS Remote server did not receive expected

acknowledgement type data frameACHD DFHCHS Remote server did not receive expected response

type data frameACHE DFHCHS Remote server received unexpected data frameACHF DFHCHS Remote server sent more than one data frameACHG DFHCHS Remote server sent data when not in correct modeACHH DFHCHS Remote server has no TIOA for dataACHI DFHCHS Remote server received unexpected return codeACHJ DFHCHS Remote server cannot return error condition to

CICS/CMSACHK DFHCHS Logic error in transformer program requestACHL DFHCHS Remote server buffer too smallACHM DFHCHS Remote server response retry limit exceededACHN DFHCHS Remote server request retry limit exceededACHO DFHCHS Remote server reply retry limit exceededACHP DFHCHS Remote server reply has insufficient storageACHR DFHCHS Failure of the CICS/CMS remote server transaction

(CEHS)ACHS DFHCHS Failure of the CICS/OS2 remote server transaction

(CEHP)ACL0 ICCGLBIC Insufficient storage available to CICS regionACL1 ICCGLBIC CICS Foundation Classes have thrown an exception

- application manager failed to catch itACL2 ICCRESEC CICS Foundation Classes invoked default

handleEvent method defined in class IccResourceACL3 ICCRESIC CICS Foundation Classes responded to an

application programmer's request to abend CICStask

ACL4 ICCGLIBC CICS Foundation Classes detected an internal errorACL5 ICCBASEC CICS Foundation Classes received an error from

CICS GETMAINACL6 ICCBASEC CICS Foundation Classes detected an error

processing storage release request

Chapter 13. Transaction abend codes 427

Page 448: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ACL7 ICCGLBIC CICS Foundation Classes have thrown an exceptiontheapplication programmer failed to catch

ACL8 ICCGLBIC CICS Foundation Classes have thrown an exceptiontheapplication programmer failed to catch

ACL9 ICCRESIC CICS Foundation Classes responded to a request toabenda CICS task.

ACLA ICCGLIBC CICS Foundation Classes detetcted an internalerror.

ACLB ICCGLIBC CICS Foundation Classes detetcted an internalerror.

ACLC ICCGLIBC CICS Foundation Classes detetcted an internalerror.

ACLD ICCGLIBC CICS Foundation Classes detetcted an internalerror.

ACLE ICCGLIBC CICS Foundation Classes detetcted an internalerror.

ACLF ICCGLIBC CICS Foundation Classes detetcted an internalerror.

ACLG ICCGLIBC CICS Foundation Classes detetcted an internalerror.

ACLH ICCBASEC CICS Foundation Classes detetcted an errorwhileprocessing a storage release request.

ACNA DFHCCNV Table DFHCNV could not be loadedACNB DFHCCNV Program DFHUCNV cannot be linkedACN1 DFHCCNV Table DFHCNV could not be loadedACN2 DFHCCNV Table DFHCNV has wrong format in first recordACN3 DFHCCNV Program DFHUCNV could not be linkedACN4 DFHCCNV Unrecognized format of DFHCNV table encounteredACN5 DFHCCNV Override for default client code page received and

unrecognizedACN6 DFHCCNV Conversion between client code page and server

code page not supported by CICS/390ACN7 DFHCCNV Override for default binary format received and

unrecognizedACN8 DFHCCNV FIELD defined as having GRAPHIC characters and

client code page and server code page imply FIELDcontains only SBCS characters

ACN9 DFHCCNV Table DFHCNV could not be loadedACP1 DFHCPY Bad DFHIC TYPE=GET response codeACP2 DFHCPY Bad DFHIC TYPE=INITIATE response codeACQA DFHCLS5 Connection Quiesce Protocol txn not intended to be

initiated this wayACQB DFHCLS5 Connection Quiesce Protocol txn encountered an

errorACQC DFHCLS5 Connection Quiesce Protocol txn encountered an

errorACRA DFHAPRT Relay program invoked without terminal as principal

facility

428 CICS User’s Handbook

Page 449: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ACRB DFHAPRT Relay program invoked by transaction not defined asremote

ACRC DFHAPRT Invalid response from DFHZCXACRD DFHAPRT System entry not foundACRE DFHAPRT Link is out of serviceACRF DFHAPRT Dynamic routing program incorrectly initiatedACRG DFHAPRT No matching entry in AID chain for ATI initiated

remote transactionACRH DFHAPRT Profile could not be foundACRI DFHAPRT,

DFHEPCDynamic transaction routing program could not belinked

ACRJ DFHAPRT,DFHEPC

Dynamic transaction routing program has abended

ACRK DFHAPRT Relay program invoked with no address for principalfacility

ACRL DFHAPRT The task does not own the facilityACRM DFHAPRT Dynamic routing program INITIAL_LINK failureACRO DFHCRQ Attempt to invoke CRSQ from a terminalACRP DFHAPRT SYDID does not support a routable startACSA DFHCRS Remote scheduler task (CRSR) does not own

intersystem link TCTTEACSB DFHCRS Invalid reply to schedule requestACSC DFHCRS Unexpected request received from remote systemACSD DFHCRS Internal logic error detectedACSE DFHCRS DFHCRS attached in unsupported mannerACSF DFHCRS Task purged before GETMAIN to SM domain

successfulACSG DFHCRS Error on call to SM domainACSH DFHCRS Sync level mismatch for processing APPC dataACSI DFHCRS APPC conversion failure when attaching between

systemsACSJ DFHCRS Unexpected response on call to RM domainACSL DFHCRS Unable to perform CDTS request or CFTS requestACSM DFHCRS Transaction CFTS has abendedACSN DFHCRS Transaction CFTS has stalledACTA DFHZTSP Relay program in TOR had unexpected request from

AORACTB DFHZTSP Relay program in TOR WRITE, LAST request failedACTC DFHZTSP Relay program in TOR failed to free sessionACTD DFHZTSP Relay program in TOR WRITE, WAIT, READ

request failedACTE DFHZTSP Relay program in TOR failed to free sessionACTF DFHZTSP Relay program in TOR failed to free sessionACTG DFHZTSP Relay program in TOR received invalid region

responseACTH DFHZISP Privileged allocate issued against a remote LU6.2

systemACTI DFHCRT TCTTE for session not owned by task

Chapter 13. Transaction abend codes 429

Page 450: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ACTJ DFHCRT Principal facility of relay transaction not a TCTTEACTK DFHZISP Task purged before GETMAIN successfulACTL DFHZISP Error on call to SM domainACUA DFHZXRL Request not supported for transaction routingACUB DFHZXRL TCTSE address missing from parameter list for

ALLOCATE requestACUC DFHZXRL TCTSE address not that of a remote LU6.2 terminalACUD DFHZXRL Profile DFHCICSR was not located as installed

profile definitionACUE DFHZXRL Request to DFHZTSP to build surrogate TCTTE not

satisfiedACUF DFHZXRL Session not allocated, request incorrectly specifiedACUG DFHZXRL Profile for ALLOCATE not located as installed

transaction definitionACUH DFHZXRL Requested session already owned by the TCAACUI DFHZXRL MODENAME named in profile not foundACUJ DFHZXRL Maximum session count for modegroup is zeroACUK DFHZXRL No TCT entry for TOR in TCTSE for remote terminalACUL DFHZXRL WRITE, WAIT, READ request failedACUM DFHZXRL Request to DFHZTSP to free surrogate TCTTE not

satisfiedACUO DFHZXRL Attempt to receive data from TOR failedACUP DFHZXRL Expected rollback not receivedACUQ DFHZXRL Attempt to receive data from TOR failedACUR DFHZXRL Expected rollback not receivedACUS DFHZXRL Attempt to receive data from TOR failedACUT DFHZXRL Expected rollback or syncpoint not receivedACUV DFHZXRL TC ISSUE ABEND on MRO link failedACUW DFHZXRL TC ISSUE ERROR on MRO link failedACUX DFHZXRL WRITE, WAIT, READ request failedACUY DFHZXRL TC WRITE, WAIT failedACUZ DFHZXRL WRITE, WAIT, READ request failedACU0 DFHZXRL TC WRITE, LAST, WAIT failedACU1 DFHZXRL Attempt to receive data from TOR failedACU2 DFHZXRL Response from the TOR violates protocolsACU3 DFHZXRL AOR set of conversation state machine violates

protocolsACU4 DFHZXRL Setting of conversation state machine failedACU5 DFHZXRL Connection between two systems not installedACU6 DFHZXRL DFHRTSU request for syncpoint failedACU7 DFHZXRL Remote system connection not APPC or MRO

connectionACU8 DFHZXRL Unexpected response and reason code from

DFHRTSUACU9 DFHZXRL Unexpected response and reason code from

recovery managerACVA DFHZXRT TC WRITE, WAIT, or READ failedACVB DFHZXRT ISSUE SIGNAL on MRO link violates protocols

430 CICS User’s Handbook

Page 451: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ACVC DFHZXRT ISSUE SIGNAL on LU6.2 link failedACVD DFHZXRT TC READ, WAIT failedACVE DFHZXRT TC WRITE failedACVF DFHZXRT TC WRITE, LAST, WAIT failedACVG DFHZXRT Attempt to free session with LU6.2 terminal failedACVH DFHZXRT Attempt to free session with AOR failedACVK DFHZXRT ISSUE ABEND on LU6.2 link failedACVL DFHZXRT TC ISSUE ABEND on MRO link failedACVM DFHZXRT ISSUE ERROR on LU6.2 link failedACVN DFHZXRT TC ISSUE ERROR on MRO link failedACVO DFHZXRT ISSUE PREPARE in TOR failed or violates protocolsACVP DFHZXRT Expected FMH43 not received from AORACVQ DFHZXRT Nonzero return code from APPC terminalACVR DFHZXRT TC SEND, LAST, WAIT failedACWA DFHCWTO CWTO transaction has failed, task started without a

terminal IDACXA DFHCXCU Catch-up transaction, CXCU, has failedADCA DFHDLIDP Nonzero return code from DBCTLADCB DFHDLIDP No PSB scheduled for taskADCC DFHDLIDP PSB already scheduledADCD DFHDLIDP Deadlock detected by IMSADCE DFHDLIDP Nonzero return code from DFHDBATADCI DFHDLIDP User abend 3303 returned from IMSADCJ DFHDLIDP CICS-DBCTL interface terminatedADCP DFHDLIDP PSB schedule request failed security checkADCQ DFHDLIDP Invalid EXEC DLI SCHD requestADCR DFHDLIDP No active communication with DBCTLADCS DFHDBAT Unexpected response from DBCTL to single phase

commit requestADCT DFHDBCT Attempt to invoke a CICS-DBCTL control transaction

from a terminalADDA DFHDBME,

DFHDLI,DFHDLIDP

Error on call to SM domain

ADDB DFHDBCON,DFHDBDSC

Error on call to CC domain

ADDC DFHDBCON,DFHDBDI

Error on call to LD domain

ADDI DFHDBCT CICS cannot find DBCTL alternate after failureADDJ DFHDBCON CICS/DBCTL connect failure - DFHDBAT cannot be

ENABLEDADEF DFHCLS3 Severe error executing transaction CLS3ADIR DFHDIP Invalid DFHDI or DFHBMS requestADLE DFHDLIRP DL/I request for remote database on unknown

systemADLF DFHDLIRP DL/I request for remote database, but link downADLG DFHDLIRP Errors in DL/I argument list for remote database

request

Chapter 13. Transaction abend codes 431

Page 452: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ADLP DFHDLIRP PSB usage failed security checkADMA DFHDBCR Error in DBCTL connection statusADMB DFHDBCR Unrecognizable message from CICS/XRF message

managerADMD DFHDBCR DBCTL connection status unable to complete search

for DBCTLalternate.ADPL DFHEIP,

DFHCPIR,DFHDLI

Restricted API command used in DPL environment

ADPM DFHDLI CALL AIBTDLI request issued for function type notsupported by CICS

ADXA DFHDXCU XRF DBCTL state catch-up transaction, DXCU, hasfailed

ADXB DFHDXCU XRF DBCTL state catch-up transaction, DXCU, hasfailed

AD2A DFHD2EX1 Error occurred on a LOCK call to LM domainAD2B DFHD2EX1 Error occurred on an UNLOCK call to LM domainAD2C DFHD2EX1 Unexpected EXCEPTION response occurred on

locate call to DM domainAD2D DFHD2EX1 An error occurred on locate call to DM domain to

locate DB2TRAN control blockAD2E DFHD2EX1 Unexpected EXCEPTION response occurred on

locate call to DM domain to locate a DB2ENTRYcontrol block

AD2F DFHD2EX1 An error occurred on locate call to DM domain tolocate a DB2ENTRY control block

AD2G DFHD2EX1 A transaction attempted to use a DB2ENTRY that isDISABLED or is DISABLING

AD2H DFHD2EX1 The CICS-DB2 attachment facility detected that adynamic plan exit program abended

AD2I DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because it was not linkedAMODE 31

AD2J DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because it is disabled

AD2K DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because no programdefinition was found

AD2L DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because the programcould not be loaded

AD2M DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because the program isdefined as remote

AD2N DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program

AD2O DFHD2EX1 An error occurred on an WAIT_MVS call to DMdomain

432 CICS User’s Handbook

Page 453: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AD2P DFHD2EX1 Transaction was unable to obtain a DB2 thread froma DB2ENTRY or pool

AD2Q DFHD2EX1 An error occurred on a GETMAIN call to SM domainAD2R DFHD2EX1 The CICS-DB2 subtask processing DB2 request for

this transaction has abendedAD2S DFHD2EX1 The subtask servicing the DB2 request for

transaction issued a sign-on request to DB2 whichfailed

AD2T DFHD2EX1 An attempt to create a DB2 thread failed with DB2reason code 00F30040

AD2U DFHD2EX1 An attempt to create a DB2 thread by the subtaskservicing the DB2 request failed

AD2V DFHD2EX1 The CICS-DB2 attachment facility lost connection toDB2 (reason code 00F30805)

AD2W DFHD2EX1 The CICS-DB2 attachment facility received anunexpected response to single-phase commit call toDB2

AD2X DFHD2EX1 The CICS-DB2 attachment facility detected that theCICS task and thread subtask were in an invalidstate

AD2Y DFHD2EX1 The transaction was unable to obtain a DB2 threadfrom a DB2ENTRY or or pool - no TCBs available

AD2Z DFHD2EX1 DB2 detected a deadlock and CICS-DB2 attachmentfacility attempted a syncpoint rollback command fortransaction

AD21 DFHD2EX1 The CICS-DB2 attachment facility received a requestfor resource manager with incorrect name

AD22 DFHD2EDF The CICS-DB2 attachment facility EDF processorwas unable to interpret the SQL request

AD23 DFHD2EX2 An error occurred on LOCK call to LM domainAD24 DFHD2EX2 An error occurred on an UNLOCK call to LM domainAD25 DFHD2CC An error occurred on LOCK call to LM domainAD26 DFHD2CC An error occurred on an UNLOCK call to LM domainAD27 DFHD2EX1 The CICS-DB2 attachment facility attempted to

attach a subtask which failed due to lack of storageAD28 DFHD2EX1 The CICS-DB2 attachment facility attempted to

attach a subtask which failedAD29 DFHD2EDF The CICS-DB2 attachment facility was unable to link

to its EDF processor DFHD2EDFAD3A DFHD2STR An error occurred on a LOCK call to LM domainAD3B DFHD2STR An error occurred on an UNLOCK call to LM domainAD3D DFHD2CM1 Unexpected response while deleting a record from

TS queue during processing of a DSNC STRTcommand

AD3G DFHD2CM1 Unexpected response from EXEC CICS GETMAINissued during processing of a CICS-DB2 DSNCcommand

Chapter 13. Transaction abend codes 433

Page 454: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AD3I DFHD2CM1 Unexpected response from EXEC CICS INQUIREDB2CONN issued during startup of the CICS-DB2interface

AD3M DFHD2CM1 Unexpected error occurred during processing ofDSNC MODIFY command

AD3P DFHD2CM1 Unexpected error occurred during processing ofDSNC STOP command

AD3Q DFHD2CM1 Unexpected response received reading a record frmTS queue during processing of a DSNCX STRTcommand

AD3R DFHD2STR Unexpected response received reading a record frmTS queue during startup of the CICS-DB2 interface

AD3S DFHD2CM1 Unexpected response received from EXEC CICSSET DB2CONN command during startup of theCICS-DB2 interface

AD3T DFHD2EX1 Transaction was unable to obtain a DB2 thread fromthe pool

AD3U DFHD2EX1 Error on locate call to transaction manager domainAD3W DFHD2STR Unexpected response received writing a record to

TS queue during startup of CICS-DB2 interfaceAD3X DFHD2CM1 Unexpected response received writing a record to

TS queue during startup of DSNC STRT commandAD3Z DFHD2EX1 The CICS-DB2 subtask has abended because the

DB2 adapter is beingshutdown.AEC1 DFHECIP,

DFHECSP,DFHEMTP,DFHESTP,DFHEOTP,DFHEDAP

CECI, CEMT, or CEDA/B/C transaction attemptedon unsupported terminal

AEC2 DFHECIP,DFHECSP,DFHEMTP,DFHESTP,DFHEOTP,DFHEDAP

CECI, CEMT, or CEDA/B/C tried to use too small ascreen

AEC3 DFHAPLI COBOL II failed to initialize a threadAEC4 DFHAPLI COBOL II failed to initialize a run-unitAEC5 DFHAPLI C/370 failed to initialize a threadAEC6 DFHAPLI C/370 failed to initialize a run-unitAEC7 DFHAPLI Language Environment/370 failed to initialize a

threadAEC8 DFHAPLI Language Environment/370 failed to initialize a

run-unitAEC9 DFHAPLI Language Environment/370 had error during

RUNUNIT BEGIN INITIALIZATION phaseAEDA DFHEDFX CEDF started with invalid start codeAEDB DFHEDFX DFHEDFP passed invalid EDFXA

434 CICS User’s Handbook

Page 455: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AEDC DFHEDFX EDF GETMAIN request failedAEDD DFHEDFX EDF attach failedAEDE DFHEDFX EDF suspend failedAEDF DFHEDFX User task purged before control returned to EDFAEDG DFHEDFX User task gone away while suspended, before

control returned from EDFAEDH DFHEDFX Failure of call to Program ManagerAED1 DFHEDFP,

DFHEDFBRAttempt to use EDF on unsupported terminal, usingCEBR on unsupported device or CEBR initiated witha non-terminal principal priority

AED2 DFHEDFX EDF has terminated a taskAED3 DFHEDFX EDF has terminated a taskAED4 DFHEDFP Internal logic error in DFHEDFPAED5 DFHEDFD Internal logic error in EDF - insufficient dynamic

storageAED6 DFHEDFU Internal logic error in EDFAED7 DFHEDFP TWA size too small for CEDF transactionAED8 DFHEDFX Terminal control error in DFHEDFXAED9 DFHEDFD Temporary storage error in EDFAEIA DFHEIP ERROR condition not handledAEID DFHEIP EOF condition not handledAEIE DFHEIP EODS condition not handledAEIG DFHEIP INBFMH condition not handledAEIH DFHEIP ENDINPT condition not handledAEII DFHEIP NONVAL condition not handledAEIJ DFHEIP NOSTART condition not handledAEIK DFHEIP TERMIDERR condition not handledAEIL DFHEIP FILENOTFOUND condition not handledAEIM DFHEIP NOTFND condition not handledAEIN DFHEIP DUPREC condition not handledAEIO DFHEIP DEPKEY condition not handledAEIP DFHEIP INVREQ condition not handledAEIQ DFHEIP IOERR condition not handledAEIR DFHEIP NOSPACE condition not handledAEIS DFHEIP NOTOPEN condition not handledAEIT DFHEIP ENDFILE condition not handledAEIU DFHEIP ILLOGIC condition not handledAEIV DFHEIP LENGERR condition not handledAEIW DFHEIP QZERO condition not handledAEIZ DFHEIP ITEMERR condition not handledAEI0 DFHEIP PGMIDERR condition not handledAEI1 DFHEIP TRANSIDERR condition not handledAEI2 DFHEIP ENDDATE condition not handledAEI3 DFHEIP INVTSREQ condition not handledAEI4 DFHEIP EXPIRED condition not handledAEI8 DFHEIP TSIOERR condition not handledAEI9 DFHEIP MAPFAIL condition not handledAELA DFHETL Function purged before control returned

Chapter 13. Transaction abend codes 435

Page 456: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AELB DFHEGL Function purged before control returnedAEMA DFHUEM Error on call to AP domainAEMB DFHUEM Error on call to LD domainAEMP DFHUEM Task purged before set active request to AP domain

completedAEMQ DFHUEM Task purged before IDENTIFY_PROGRAM

completed successfullyAETA DFHERM Task abended by DFHERM after using DFHRMCAL

macroAETC DFHERM Command issued with invalid TRUEAETF DFHERM Task purged before completion of request to SM

domainAETG DFHERM Error on call to SM domainAETH DFHERM Task purged before completion of request to SM

domainAETI DFHERM Error on call to SM domainAETJ DFHERM Error on ADD_LINK call to RM domainAETK DFHERM Error on SET_LINK call to RM domainAETL DFHERM Error on SET_UOW call to RM domainAETM DFHRMSY Error on INQUIRE_TRANSACTION call to XM

domainAETN DFHRMSY Error on INITIATE_RECOVERY call to RM domainAETO DFHRMSY Error on INITIATE_RECOVERY call to RM domainAETP DFHRMSY Error on TERMINATE_RECOVERY call to RM

domainAETQ DFHRMSY Error on INQUIRE_UOW call to RM domainAETR DFHRMSY Error on INQUIRE_UOW call to RM domainAETS DFHRMSY Error on INQUIRE_STARTUP call to RM domainAEXC DFHEIP RESIDERR condition not handledAEXF DFHEIP ESCERROR condition not handledAEXG DFHEIP UOWLNOTFOUND condition not handledAEXI DFHEIP TERMERR condition not handledAEXJ DFHEIP ROLLEDBACK condition not handledAEXK DFHEIP END condition not handledAEXL DFHEIP DISABLED condition not handledAEXU DFHEIDTI,

DFHEIQDS,DFHEIQSA,DFHEIQSC,DFHEIQSM,DFHEIQSPDFHEIQST,DFHEIQSX

NOTPOSS condition raised on encountering invalidparameter

AEXV DFHEIP VOLIDERR condition not handledAEXW DFHEIP SUPPRESSED condition not handledAEXX DFHEIP TASKIDERR condition not handledAEXY DFHxxx Transaction purged before control was returned For

module list, see CICS Messages and Codes

436 CICS User’s Handbook

Page 457: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AEXZ DFHxxx Command failed due to serious failure in CICScomponent For module list, see CICS Messages andCodes

AEX0 DFHEIP TCIDERR condition not handledAEX1 DFHEIP DSNNOTFOUND condition not handledAEX2 DFHEIP LOADING condition not handledAEX3 DFHEIP MODELIDERR condition not handledAEX4 DFHEIP RECORDBUSY condition not handledAEX5 DFHEIP PARTNERIDERR condition not handledAEX6 DFHEIP PROFILEIDERR condition not handledAEX7 DFHEIP NETNAMEIDERR condition not handledAEX8 DFHEIP LOCKED condition not handledAEX9 DFHEIP RECORDBUSY condition not handledAEYA DFHEIP INVERRTERM condition not handledAEYB DFHEIP INVMPSZ condition not handledAEYC DFHEIP IGREQID condition not handledAEYD DFHSRP Storage violation by CICSAEYE DFHEIP INVLDC condition not handledAEYG DFHEIP JIDERR condition not handledAEYH DFHEIP QIDERR condition not handledAEYJ DFHEIP DSSTAT condition not handledAEYK DFHEIP SELNERR condition not handledAEYL DFHEIP FUNCERR condition not handledAEYM DFHEIP UNEXPIN condition not handledAEYN DFHEIP NOPASSBKRD condition not handledAEYO DFHEIP NOPASSBKWR condition not handledAEYP DFHEIP SEGIDERR condition not handledAEYQ DFHEIP SYSIDERR condition not handledAEYR DFHEIP ISCINVREQ condition not handledAEYT DFHEIP ENVDEFERR condition not handledAEYU DFHEIP IGREQCD condition not handledAEYV DFHEIP SESSIONERR condition not handledAEYX DFHEIP USERIDERR condition not handledAEYY DFHEIP NOTALLOC condition not handledAEYZ DFHEIP CBIDERR condition not handledAEY0 DFHEIP INVEXITREQ condition not handledAEY1 DFHEIP INVPARTNSET condition not handledAEY2 DFHEIP INVPARTN condition not handledAEY3 DFHEIP PARTNFAIL condition not handledAEY6 DFHUEM Internal logic error in DFHUEMAEY7 DFHEIP NOTAUTH condition not handledAEY8 DFHEIP No DSA found on chain trying to free dynamic

storageAEY9 DFHEIP,

DFHEEIInvalid EXEC CICS command issued

AEZA DFHEIP AMODE 24 program defined in transaction withTASKDATALOC=ANY

Chapter 13. Transaction abend codes 437

Page 458: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AEZB DFHERM AMODE 24 task related user exit defined intransaction with TASKDATALOC=ANY

AEZC DFHAPLI AMODE 24 program defined in transaction withTASKDATALOC=ANY

AEZD DFHAPLI Attempt to run EXECKEY(USER) program intransaction with TASKDATAKEY(CICS) defined

AEZE DFHEIP CHANGE condition not handled - see AEIAAEZF DFHEIP PROCESSBUSY condition not handled - see AEIAAEZG DFHEIP ACTIVITYBUSY condition not handled - see AEIAAEZH DFHEIP PROCESSERR condition not handled - see AEIAAEZI DFHEIP ACTIVITYERR condition not handled - see AEIAAEZJ DFHEIP CONTAINERERR condition not handled - see AEIAAEZK DFHEIP EVENTERR condition not handled - see AEIAAEZL DFHEIP TOKENERR condition not handled - see AEIAAEZM DFHEIP NOTFINISHED condition not handled - see AEIAAEZN DFHEIP POOLERR condition not handled - see AEIAAEZO DFHEIP TIMERERR condition not handled - see AEIAAEZP DFHEIP SYMBOLERR condition not handled - see AEIAAEZQ DFHEIP TEMPLATERR condition not handled - see AEIAAFCB DFHEIFC Unexpected response from DFHFCEI resource level

security checkAFCC DFHEIFC,

DFHDMPCAInternal logical error on calling file control requestmodule DFHFCFR

AFCD DFHEIFC Irrecoverable error as table manager tries to locateAFCT

AFCE DFHEIFC A GETMAIN for FFLE storage failedAFCF DFHEIFC,

DFHDMPCAFile control deadlock between tasks

AFCG DFHEIFC,DFHDMPCA

File issued sequence of file control requests thatwould deadlock itself

AFCH DFHEIFC Request to disabled or closed tableAFCJ DFHFCU Task taking longer than DTIMEOUT interval

specified for CSFUAFCK DFHDMPCA,

DFHEIFCFile update request issued against RLS mode dataset during backup

AFCL DFHDTLX Response could not continue during loading ofShared Data Table by CSFL txn

AFCM DFHDTLX Data table load failedAFCN DFHDMPCA,

DFHEIFCJournal record too large for journal buffer

AFCO DFHDTLX Transaction not internally attached by CICS onattempt to attach

AFCR DFHEIFC,DFHDMPCA

SMSVSAM server address space has failed

AFCS DFHEIFC,DFHDMPCA

SMSVSAM server address space was inactive

AFCT DFHEIFC,DFHDMPCA

SMSVSAM server has been recycled since anearlier request from same UOW

438 CICS User’s Handbook

Page 459: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AFCU DFHEIFC,DFHDMPCA

Data set in lost locks state

AFCV DFHEIFC,DFHDMPCA

Request against file in RLS mode unable to acquirerecord lock

AFCW DFHEIFC,DFHDMPCA

FC request against file in RLS mode would causedeadlock

AFCY DFHDMPCA,DFHEIFC

Transaction purged during file request

AFCZ DFHDMPCA,DFHEIFC

Irrecoverable error response from DFHFCFR to itscaller

AFC0 DFHEIFC,DFHDMPCA

Updating file after file control restart failed

AFC2 DFHFCU Disastrous error from DFHFCFS on open file requestAFC7 DFHDMPCA Disastrous error response from DFHFCFS to

DFHDMPCAAFDA DFHFCQT Attach of transaction failed - not internally attached

by CICSAFDB DFHFCQT Transaction not CFQS or CFQRAFDC DFHFCQT CFQS failed due to serious errorAFDD DFHFCQT CFQR failed due to serious errorAFDE DFHFCRD Attach of transaction failed - not internally attached

by CICSAFDF DFHFCOR Attach of transaction failed - not internally attached

by CICSAFDG DFHFCOR CFOR failed due to serious errorAFDH DFHEIFC,

DFHDMPCAVSAM RLS unable to create new locks - couplingfacility full

AGMA DFHGMM No terminal specified for Good Morning transactionAICA DFHSRP Task executing for longer than runaway time intervalAICB DFHICP RETRIEVE WAIT reissued in system shutdownAICC DFHTAJP,

DFHICPIncorrect response from a TI domain request

AICD DFHICP Incorrect response from a KE domain requestAICE DFHICP Incorrect response from a DS domain request (other

than AICG)AICF DFHICP Incorrect response from a TM domain requestAICG DFHICP PURGED response from DS request with reason

code TASK_CANCELAICH DFHICP,

DFHEIICTask purged before request to SM domaincompleted successfully

AICJ DFHICP Error on call to SM domainAICK DFHEIIC Invalid response from resource level security checkAICL DFHEIIC Invalid function code in the command level

parameter listAICN DFHICP Incorrect response from US domain requestAICO DFHICXM Unexpected EXCEPTION response on call to US

domain

Chapter 13. Transaction abend codes 439

Page 460: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AICQ DFHDFST DFHDFST is executing at a terminal which is notpermitted.

AICS DFHDFST DFHDFST has encountered an error during Retrieveprocessing.

AICT DFHDFST DFHDFST has encountered an error during STARTprocessing.

AICR DFHCRR Failure of DFHTC write request for IRCAINA DFHINDT Application program failed to pass commarea

containing request to be executed on LINKcommand

AINB DFHINDT Commarea passed did not contain valid request tobe executed

AINC DFHINDT,DFHINDAP

INQUIRE EXITPROGRAM failed with NOTAUTHresponse

AIND DFHINDT,DFHINDAP

INQUIRE EXITPROGRAM failed with unexpectedresponse

AINE DFHINDT Error on START_LINK_BROWSE commandto RMdomain

AINF DFHINDT EXCEPTION response on GET_NEXT_LINK call toRM domain

AING DFHINDT Error on GET_NEXT_LINK call to RM domainAINH DFHINDT Error on END_LINK_BROWSE command to RM

domainAINI DFHINDT Error on INQUIRE_UOW command to RM domainAINJ DFHINDT Exception respone on INITIATE_RECOVERY call to

RM domainAINK DFHINDT Error on INITIATE_RECOVERY call to RM domainAINL DFHINDT Error on SET_RECOVERY_STATUS command to

RM domainAINM DFHINDT Error on TERMINATE_RECOVERY command to RM

domainAINN DFHINTRU Error on ADD_LINK command to RM domainAINO DFHINTRU INQUIRE TRANSACTION command failed with

NOTAUTH responseAINP DFHINTRU INQUIRE TRANSACTION command failed with

unexpected responseAINQ DFHINTRU INQUIRE TASK command failed with TASKIDERR

responseAINR DFHINTRU INQUIRE TASK command failed with NOTAUTH

responseAINS DFHINTRU INQUIRE TASK command failed with unexpected

responseAIOA DFJIIOP The main method within CICSMain invoked with a

null COMMAREAAIOB DFJIIOP checkbytes method within CICSCommareaMapping

detected an errorAIOC DFJIIOP setbytes method within CICSCommareaMapping

detected an error

440 CICS User’s Handbook

Page 461: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AIOD DFJIIOP setIIOPDataFromTSQ method withinCICSCommareaMapping detected an error

AIOE DFJIIOP setIIOPDataFromTSQ method withinCICSCommareaMapping detected an error

AIOF DFJIIOP setIIOPDataFromTSQ method withinCICSCommareaMapping detected an error

AIOG DFJIIOP The main method within CICSMain failed to initializethe ORB

AIOH DFJIIOP The main method within CICSMain has receivedunexpected return code from ProcessMessage

AIOI DFJIIOP setBytes method within CICSCommareaMappinghas detected an error

AIOJ DFJIIOP writeIIOPDataToTSQ method withinCICSCommareaMapping has detected an error

AIOK DFJIIOP writeIIOPDataToTSQ method withinCICSCommareaMapping has detected an error

AIOV DFJIIOP setBytes method within CICSCommareaMappinghas detected an error

AIO0 DFHIIOPDFHIIOPA

Programme chech when IIOP/CORBA callprocessed

AIO1 DFHIIOPDFHIIOPA

Call to Socket domain failed

AIO2 DFHIIOPDFHIIOPA

IIOP/CORBA data stream contains invalid header ordata structure

AIO3 DFHIIOPDFHIIOPA

WRITEQ/READQ TS call detected that queuemodified by another process

AIO4 DFHIIOPDFHIIOPA

IIOP transaction CIOF has been started incorrectly.

AISA DFHMIRS CSMI attached to facility other than terminalAISB DFHMIRS Errors detected in data for mirror transactionAISC DFHMIRS TIOA not received from terminal by mirror

transactionAISD DFHMIRS Mirror program received nonzero return codeAISF DFHMIRS Facility for mirror is APPC, conversation unmappedAISG DFHMIRS Mirror transaction could not send replyAISH DFHCRNP Incorrect invocation of CSNCAISI DFHISP Invalid function shipping request from DFHEIP to

DFHISPAISJ DFHCRNP CSNC abended because LINK to DFHCRR failedAISK DFHISP Mirror transaction abendedAISL DFHLUP,

DFHCLS3,DFHCLS4,DFHZLS1

LU services manager transaction started directlyfrom user terminal

AISN DFHCRNP CSNC failed to acquire SUSPEND TOKENAISO DFHCRNP CSNC failed to suspend itselfAISP DFHMIRS Mirror transaction invoked with invalid principal

facility

Chapter 13. Transaction abend codes 441

Page 462: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AISQ DFHMIRS EXEC CICS command issued for CPICommunications session

AISR DFHCRR DFHCRR invoked in an incorrect mannerAISS DFHZARM Security violation at start of APPC conversationAIST DFHCRNP Unexpected return code after DFHTC

TYPE=LOCATEAISU DFHMIRS Error on call to SM domainAISV DFHMIRS PURGED condition on call to SM domain to

FREEMAINAISW DFHCRSP Error on call to SM domainAISX DFHCRSP PURGED condition on call to SM domain to

GETMAIN or FREEMAINAISY DFHLUP Invalid parameters for LU services managerAISZ DFHMXP Unexpected reply when committing START

PROTECT NOCHECK requestsAIS1 DFHCRSP Unexpected return code after DFHMROQM

FUNC=ENQ commandAIS2 DFHCRNP Unexpected return code after DFHMROQM

FUNC=WAIT_Q commandAIS3 DFHCRNP Failed to issue store clock instructionAIS4 DFHCRNP Unexpected return code after DFHMROQM

FUNC=ENQUEUE commandAIS5 DFHCRNP Unexpected return code after DFHMROQM

FUNC=ENQUEUE commandAIS6 DFHMIRS DISASTER, EXCEPTION, or INVALID condition on

call to SM domainAIS7 DFHMIRS PURGED condition on call to SM domainAIS8 DFHMIRS Internal logic error in DFHMIRSAIS9 DFHMIRS DPL server program returned invalid state after LINK

commandAITA DFHCRNP Error on call to RM domainAITB DFHISP Error on call to RM domainAITC DFHMIRS Error on call to RM domainAITD DFHMIRS Mirror program received unexpected response from

RX domainAITE DFHMIRS RTIMOUT interval exceeded on transactional EXCI

requestAITF DFHMIRS Transactional EXCI request purged waiting on eventAITG DFHMIRS Transactional EXCI request executed and both a

further request from the batch region and asuyncpoint initiated by RRMS occurred

AJA0 DFJCICS Invalid Resp code passed to SetAbendForConditionmethod

AJCD DFHJCP Error on call to SM domainAJCE DFHJCP Task purged before GETMAIN request to SM

domain completedAJCS DFHJCP Error on call to LM domainAJCT DFHJCP Error on call to RM domain

442 CICS User’s Handbook

Page 463: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AJCU DFHJCP Purge response from log manager or recoverymanager

AJ01 DFJCICS Main method of jave environment setup classinvoked without argument

AJ02 DFJCICS CICS AbendError caught by the java environmentsetup class, Wrapper

AJ03 DFJCICS CicsConditionException caught by WrapperAJ04 DFJCICS Unexpected condition caught by WrapperAJ05 DFJCICS Unhandled exception from Java applicationAJ07 DFJCICS Wrapper unable to invoke the user's main methodAJ09 DFJCICS Wrapper unable to invoke the user's main methodAJ99 DFJCICS Wrapper detected AbendException and issued

setAbend - abend code extracted fromAbendException is too long

AJMA DFHCJVM Change directory to CICS_HOME failedAJMB DFHAPLJ Call to JVM program disallowed due to previous

JVM terminationerrorsAJM1 DFHCJVM JNI_CreateJavaVM request failedAJM2 DFHCJVM JVM failed to find the CICS Wrapper ClassAJM3 DFHCJVM JVM failed to find the main method of the CICS

Wrapper classAJM4 DFHCJVM JVM failed to build the argument list for the CICS

Wrapperclass.AJM5 DFHCJVM The CICS Wrapper class threw an exceptionAJM6 DFHCJVM CICS JVM interface failed to set up CICS Recovery

facilities.AJM7 DFHCJVM CICS JVM interface failed to delete CICS Recovery

facilities.AJM8 DFHAPLJ A severe error occurred whilst the JVM was

executingAJM9 DFHCJVM CICS JVM interface failed to load user replaceable

module DFHJVMAT.AKCB DFHKCRP Transaction manager restart task could not completeAKCC DFHXMAT,

DFHXMCLPurge threshold on TRANCLASS reached

AKCE DFHKCQ Write to system log failedAKCF DFHKCQ Write to catalog failedAKCR DFHXCP Transaction manager received an invalid request

codeAKCS DFHXCP Deadlock time-out has occurredAKCT DFHXCP Terminal read-time-out has occurredAKCV DFHALP Unexpected return code on resume of suspended

taskAKC0 DFHAPATT Attempt to run CSSY as user transactionAKC1 DFHXCP DFHKC WAIT when ECB already marked as waitingAKC2 DFHXCP Unexpected response from DS domain call

Chapter 13. Transaction abend codes 443

Page 464: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AKC3 DFHXCP,DFHXMAT,DFHXMCL,DFHXMIQ,DFHXMTA

Task has been purged

AKC6 DFHXCP DFHKC SUSPEND did not precede DFHKCRESUME

AKC8 DFHXCP Unexpected response from call to KE domain fortask purge

AKC9 DFHXCP Error from call to NQ domainAKEA DFHKESTX Program check detected by KE domainAKEB DFHKESTX Operating system abend detected by KE domainAKEC DFHKESTX,

DFHKERRURunaway detected by KE domain

AKED DFHKEEDA Deferred abend request in KE domainAKEF DFHKERKE Error detected while processing KE domain callAKEG DFHKESGM MVS GETMAIN for kernel stack storage failedAKEH DFHKESTX Transaction purged while running outside control of

CICS.AKEI DFHKESTX Kernel domain detected runaway while transaction

isoutside control of CICS.AKEZ DFHKETA Failure of user attach - insufficient kernel tasksAKSE DFH99KC No code for keywordALGA DFHLGGL,

DFHLGJN,DFHLGLD,DFHLGST

Error obtaining lock within log manager domain

ALGB DFHLGGL,DFHLGJN,DFHLGLD,DFHLGST

Error releasing lock within log manager domain

ALGC DFHLGGL,DFHLGJN,DFHLGLD,DFHLGST

Disaster response detected processing buildingblock code used by log manager domain

ALGD DFHLGCM,DFHLGGL,DFHLGJN,DFHLGLD,DFHLGST

Disaster response detected processing buildingblock storage interface code used by log managerdomain

ALGE DFHLGJN Unexpected error while log manager attempted tofind jounal model definition

ALGF DFHLGGL,DFHLGJN,DFHLGST

Unexpected error when log manager attemptedenqueue/dequeue operation

ALGG DFHLGQC Transaction CSQC issued from a terminalALIA DFHAPLI Insufficient storage to satisfy GETMAIN requestALIB DFHAPLI Insufficient storage to satisfy GETMAIN request

444 CICS User’s Handbook

Page 465: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ALIC DFHAPLI Insufficient storage to satisfy GETMAIN requestALID DFHAPLI Insufficient storage to satisfy GETMAIN requestALIE DFHAPLI Insufficient storage to satisfy GETMAIN requestALIF DFHAPLI Insufficient storage to satisfy GETMAIN requestALIG DFHAPLI CICS unable to determine language of user

application programAMI1 DFHMIRS Unexpected response when mirror task resumedAMNA DFHCMP Exception response from MN domain—invalid

address in DATA1AMNB DFHCMP Exception response from MN domain—invalid data

in DATA2AMNZ DFHCMP Unexpected error response from MN domainAMSA DFHMSP SBA not followed by two 1-byte address fieldsAMSB DFHMSP Internal logic error in DFHMSPAMSC DFHMSP Task purged before GETMAIN to SM domain

completedAMSD DFHMSP Error on call to SM domainANQA DFHNQED,

DFHNQIB,DFHNQNQ,DFHNQST

Error occurred obtaining lock within enqueue domain

ANQB DFHNQED,DFHNQIB,DFHNQNQ,DFHNQST

Error occurred releasing lock within enqueue domain

ANQC DFHNQED Error occurred obtaining sysplex enqueueANQD DFHNQED Error occurred obtaining sysplex enqueueANQE DFHNQRN EXEC ENQ issued and enqmodel disabled or in

waiting stateAPCF DFHAPLI Program not compiled with supported PL/I compilerAPCG DFHxxx Transaction purged For module list,see CICS

Messages and CodesAPCH DFHAPLI COBOL II or LE/370 support not presentAPCI DFHAPLI Execution of PL/I programs has been disabledAPCJ DFHAPLI C/370 does not recognize programAPCK DFHAPLI Execution of C program disabledAPCL DFHAPLI Language Environment/370 unable to determine

program languageAPCN DFHxxx Attempt to release program/mapset/partitionset that

is not loaded or has already been deleted. Formodule list, see CICS Messages and Codes

APCO DFHAPXM GETMAIN of storage for LEVEL 2 trace failed duringtransaction initialization

APCS DFHAPLI CICS could not get run time information from LE/370APCT DFHxxx Program/mapset/partitionset failure. For module list,

see CICS Messages and CodesAPCW DFHAPLI Compiler level for COBOL program cannot be

determined

Chapter 13. Transaction abend codes 445

Page 466: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

APCY DFHAPLI Macro request from PL/I or COBOL applicationAPCZ DFHAPLI Program not reentrant and cannot be loaded into

read-only storageAPC0 DFHPCP,

DFHMCYSerious error on call to program manager domain

APC1 DFHAPLI Request for TGT exceeding 64KB in sizeAPC2 DFHAPLI Illegal branch following abend conditionAPC3 DFHAPLI No Language Environment/370 support present for

programAPC4 DFHPCPC2 Loader domain define request failed for program

ILBOCOMAPC5 DFHPCPC2 Loader domain load request failed for program

ILBOCOMAPC6 DFHPCPC2 An internal error has occurredAPC7 DFHPCPC2 An MVS IDENTIFY call for entry point ILBOCOM0

failedAPC8 DFHPCPC2 An MVS LOAD of ILBOCOM0 has failedAPC9 DFHPCPC2 An MVS LOAD of ILBOCOM has failedAPLx PL/I abend code (see OS/VS PL/I Optimizing

Compiler: Programmer’s Guide)APP1 DFHP3270 Invalid DFHIC TYPE=GET response codeAPP2 DFHP3270 Data length passed to DFHP3270 less than or equal

to 5APP3 DFHP3270 Invalid request to nonprinterAPR1 DFHPRK Invalid DFHIC TYPE=PUT response codeAPSJ DFHPSIP Spooler initialization program incorrectly invokedAPST DFHEPS SPOOL command without NOHANDLE operandAPSU DFHPSPST Invalid JES return code to spoolerAPSV DFHPSPST VSAM macro return code contains invalid valueAPSW DFHPSPST Abend in CICS system spooler subtaskAPSX DFHPSPST A CICS storage area contains invalid valueAPSY DFHPSPST Storage area for MVS macro return code contains

invalid valueAPSZ DFHPSPST CICS area for JES interface return code contains

invalid valueAPTI DFHPSPST Task purged before GETMAIN request to SM

domain completedAPTJ DFHPSPST Error on call to SM domainAPUA DFHPUP GETSTG parameter missing on call to DFHPUP

(PUPF)APUB DFHPUP GETSTG parameter missing on call to DFHPUP

(PUPU)APUC DFHPUP Invalid function code supplied on domain call to

DFHPUPAPUD DFHPUP Unable to locate RDO language definition table

(DFHEITSP)APUE DFHPUP Lack of storage to load RDO language definition

table (DFHEITSP)

446 CICS User’s Handbook

Page 467: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

APUF DFHPUP RDO language definition table invalid or missingAPUG DFHPUP Storage cannot be obtained for CSD record bufferAPUH DFHPUP Storage cannot be obtained for argument listAPUI DFHPUP Storage cannot be freed for argument listAPUJ DFHPUP Storage cannot be freed for CSD record bufferAPUK DFHPUP Unable to obtain storageAPUL DFHPUP Unrecognized resource type code (FLATTEN)APUM DFHPUP Unrecognized resource type code (TRANCASE)APUN DFHPUP Unrecognized resource type code (COMPARE)APUO DFHPUP Unrecognized resource type code (BACKTRANS)APUP DFHPUP Error processing language definition table for RDOAPUQ DFHPUP Error processing language definition table for RDOAPUR DFHPUP Data type conflictAPUS DFHPUP Invalid integer data length for keyword fieldAPUT DFHPUP Invalid keyword existence bit numberAPUZ DFHPUP Invalid resource type code in CSD recordAPXA DFHAPXM User transaction's profile could not be foundARCB DFHRCEX Initialization failure - exit program cannot be foundARHA DFHCPIR SAA resource recovery interface has invalid first

parameterARHB DFHCPIR Invalid number of parameters for SAA resource

recovery callARHC DFHCPIR Unexpected return code from syncpoint program for

SAA resource recovery interfaceARM0 DFHRMXN3 Transaction not internally attached by CICSARPA DFHRTC Unexpected response from DFHSUSN signing off

user of CRTE transactionARPF DFHRPAS The alias could not be initializedARPG DFHRPAS The alias was not able to link to the CICS programARPH DFHRPAS The alias detected a global work area errorARPI DFHRPAS The alias detected a logic errorARPJ DFHRPAS The alias ends for one of various reasonsARPK DFHRPAS The alias detected a CICS logic errorARPL DFHRPAS The alias detected an authorization errorARPM DFHRPAS The alias detected an error in user codeARPN DFHRPAS The alias detected an error while trying to switch

TCBsARPO DFHRPAS The alias program detected an abendARPU DFHRPC01 The connection manager could not access the CICS

ONC RPC data setARPV DFHRPC0E The connection manager received unexpected

response from CICSARPW DFHRPC0E The connection manager received unexpected

response from CICSARPX DFHRPC01 The connection manager started against an invalid

terminalARPZ DFHRPC0B The connection manager has insufficient authority

Chapter 13. Transaction abend codes 447

Page 468: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ARP2 DFHRPMS The server controller detected internal error duringCICS ONC RPC enable processing

ARP4 DFHRPMS The server controller has performed an exceptiondisable because of an internal error

ARP5 DFHRPMS An invalid attempt was made to start the servercontroller

ARP9 DFHRPC01 There was not enough storage for the connectionmanager

ARTA DFHRTE Task does not own terminal as its principal facilityARTB DFHRTE No input TIOA, or data length zeroARTC DFHRTE Link not usableARTD DFHRTE Internal logic error in DFHRTEARTE DFHRTE Error in I/O to or from temporary storageARTF DFHRTE Invalid attempt to use CRTEARTG DFHRTE Profile not foundARTH DFHRTE Error on call to schedule remote terminal delete

during sign-offARUA DFHXMRU Exception condition on ADD_LINK during BIND

phase of ATTACHARUB DFHXMXM A RUN SYNCHRONOUS command caused an

attempt to attach a remotely defined transactionARUC DFHXMRU A RUN SYNCHRONOUS command caused an

attempt to attach a transaction with an invalidUSERID.

ARXA DFHRXUW Error attempting to express interest in RRMS Unit ofRecovery

ARXB DFHRXUW Error on ADD_LINK call to Recovery Managerdomain

ARXC DFHRXUW Error on transactional EXCI requestASCA DFHSMSCP Disaster response to DFHSC TYPE=GETMAIN

request from SM domainASCB DFHSMSCP Disaster response to DFHSC TYPE=FREEMAIN

request from SM domainASCP DFHSMSCP Task purged while waiting for contiguous main

storageASCR DFHSMSCP Invalid storage control request typeASDA DFHCESD CESD started directly from a terminal not internally

by CICSASFA DFHSFP Unexpected response from EXEC CICSASFB DFHSFP Attempt to execute CICS signoff without an

associated terminalASFC DFHSFP Attempt to execute CICS signoff program against

APPC sessionASHA DFHSHDM Command failed due to a serious failure in a CICS

componentASHB DFHSHDM Command failed due to a serious failure in a CICS

component

448 CICS User’s Handbook

Page 469: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ASHR DFHSHRSP Command failed due to a serious failure in a CICScomponent

ASHU DFHSHRSP Abend occurred due to a routing failureASH2 DFHSHXM Resources required to service request unobtainableASH3 DFHSHRM Transaction bound to a Scheduler Services request

has backed out (default abend code)ASH4 DFHSHXM Scheduler Services attempted to attatch a disabled

transaction.ASIA DFHSII1 Error on call to SM domainASIB DFHSIPLT Invalid attempt to run CICS internal task CPLT as

user transactionASNA DFHSNP Unexpected response from EXEC CICSASNB DFHSNP Attempt to execute CICS signon without an

associated terminalASNC DFHSNP Signon program failed to send request to userASND DFHSNTU Request from DFHSNTU to ENQ failed during

signoff terminal userASOA DFHSOL TCP/IP listener task CSOL incorrectly started from a

terminalASPA DFHAPAC Task purged before request to RM domain

completed successfullyASPB DFHAPAC Error on call to RM domainASPC DFHSPP Error on call to bridge syncpoint routine (DFHBRSP)ASPF DFHAPAC ROLLEDBACK returned to RM domainASPI DFHCR2U Unexpected FMH or no data received from partner

systemASPJ DFHCR2U Unexpected syncpoint message data received from

partner systemASPN DFHAPAC Transaction has issued an EXEC CICS RETURN in

backout required program stateASPO DFHAPAC Intersystem session failed during syncpointASPP DFHAPAC Intersystem session failed during syncpointASPQ DFHAPAC Intersystem communication failed during syncpointASPR DFHAPAC Intersystem communication failed during syncpointASP1 DFHAPAC Intersystem communication failed during syncpointASP2 DFHAPAC Syncpoint attempted with intersystem conversation

in invalid stateASP3 DFHAPAC No syncpoint taken in remote systemASP7 DFHAPAC Resource manager replied 'No' to request to

'Prepare'ASP8 DFHAPAC Syncpoint rollback not supportedASP9 DFHEISP User Syncpoint not allowed in activationASQA DFHCRRSY Communication session failed during CLS2

processingASQB DFHCRRSY Logic error during CLS2 processingASQC DFHCRRSY CLS2 transaction attached with unexpected start

code

Chapter 13. Transaction abend codes 449

Page 470: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ASQD DFHCRRSY CLS2 transaction could not use transaction managerfor input parameters

ASQG DFHCRRSY CLS2 transaction failed during receipt of data viaMRO session

ASQH DFHCRRSY CLS2 transaction failed during receipt of data viaMRO session

ASQI DFHCRRSY Attempt to invoke CICS recovery manager to savelogname failed

ASQK DFHCRRSY CICS internal logic errorASQL DFHCRRSY Invocation of TERMINATE_RECOVERY command

to unlock data failedASQM DFHCRRSY CICS internal logic errorASRA DFHSRP Program check has occurredASRB DFHSRP Operating system abendASRD DFHSRP Invalid macro call or reference to CSA or TCAASRE DFHSRP Attempt to access a CICS-DB2 RCT load module

terminated taskASRK DFHSR1 DFHSR1 unable to call system recovery program

(DFHSRP)ATCA DFHZARQ DFHTC macro issued when in final quiesce modeATCB DFHZARQ Two consecutive reads or writes without intervening

waitATCC DFHZARQ Read or more than one write issued using pipeline

sessionATCD DFHZDSP,

DFHZERHCTYPE or QUEUE issued and VTAM or ZCPfunction not included in system

ATCE DFHZARQ DFHTC request issued without address of TIOAATCF DFHZCRQ DFHTC CTYPE macro issued to non-VTAM TCTTEATCG DFHZARQ DFHTC request for terminal which program does not

ownATCH DFHxxx Task purged before domain call completed

successfully For module list,see CICS Messagesand Codes

ATCI DFHZSUPDFHMRXMDFH62XM

Error occurred on call to DFHRTSU

ATCJ DFHZATADFHZATDDFHZATR

Invalid autoinstall invocation

ATCK DFHZARQ Write issued with CCOMPL=NO without authorityATCL DFHETL,

DFHTCPCM,DFHZARQ

Error during automatic journaling or automaticlogging

ATCN DFHZSUPDFH62XMDFHTFXM

Error during automatic journaling or automaticlogging

ATCO DFHZARQ Function unsupported by terminal or systemATCQ DFHZRAQ Temporary storage error

450 CICS User’s Handbook

Page 471: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ATCR DFHZRAR Temporary storage errorATCS DFHZARQ Send data after request change direction receivedATCT DFHZSUP

DFHMRXMDFH62XM

Build of surrogate TCTTE for remotely-ownedterminal failed

ATCU DFHZARQ Send in receive modeATCV DFHETL,

DFHZARQ,DFHZISP

Application attempted operation on logical unit whichfailed

ATCW DFHZSUPDFHMRXMDFH62XM

No installed profile definition for LU6.1 or APPCsession

ATCX DFHxxx Error on call to SM domain For module list,see CICSMessages and Codes

ATCY DFHZARQ,DFHZSUPDFHMRXMDFH62XM

Error processing inbound FMH

ATCZ DFHZSLS Error in call to security domainATC1 DFHTCRP Terminal control restart task failureATC2 DFHZSLS VTAM rejected CICS SET VTAM OPEN requestATC3 DFHZARQ Write to TLX device issued with data length of 0

causing TIOA data length (TIOATDL) to be 0ATC4 DFHTCRP The XRF TCB abendedATC5 DFHETL Internal logic error in APPC mapped processingATC6 DFHETL SEND DATA length greater than 65528 bytesATC7 DFHZSUP Unexpected response from INITIAL-CALL request to

DFHZARLATC8 DFHETL Error during processing of an inbound FMHATC9 DFHZNCE RESUME issued without prior SUSPENDATDC DFHETD Task purged awaiting enqueue during

READQ/WRITEQ or DELETEQ commandATDY DFHTDRP Transient data initialization failedATDZ DFHTDRP CICS function invoked by TD init failedATFE DFHTOUT1 FREEMAIN failed during CEDA CHECK or CEDA

INSTALLATGE DFHTOUT1 GETMAIN failed during CEDA CHECK or CEDA

INSTALLATMA DFHTMP Task purged before GETMAIN request to SM

domain completed successfullyATMB DFHTMP Error on call to SM domainATNA DFHZNAC Terminal operator entered transaction identification

for NACPATND DFHZARQ,

DFHZARL,DFHZSUP

Task termination postponed

Chapter 13. Transaction abend codes 451

Page 472: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

ATNI DFHZARL,DFHZARM,DFHZARQ,DFHZRAQ,DFHZSUP

Task terminated by NEP (VTAM) or TEP(non-VTAM)

ATOA DFHCESC Invalid attempt to invoke CESC with terminal asprincipal facility

ATOB DFHCESC Abnormal response from EXEC CICS STARTTRANSACTION(CESC)

ATOC DFHCESC Failure of a DFHZCUT timeout requestATOD DFHCESC Abnormal response from EXEC CICS CANCEL

TRANSACTION(CESC)ATOE DFHCESC Cannot determine time XRF takeover beganATOF DFHCESC Abnormal response from EXEC CICS DELAY

TRANSACTION(CESC)ATOG DFHCESC Abnormal response from EXEC CICS START

TRANSACTION(CEGN)ATOH DFHCESC Failure of CESC due to an invalid function codeATOT DFHCEGN CEGN RETRIEVE failureATOU DFHCEGN CEGN RETURN failureATOV DFHCEGN CEGN GETMAIN, ASSIGN or SEND failureATPA DFHTPR Error occurred estimating the length of a CICS

messageATPB DFHTPR Error occurred trying to retrieve a CICS messageATPC DFHTPQ Error occurred estimating the length of a CICS

messageATPD DFHTPQ Error occurred trying to retrieve a CICS messageATPE DFHTPQ,

DFHTPRTask purged before GETMAIN request to SMdomain completed successfully

ATPF DFHTPQ,DFHTPR

Error on call to SM domain

ATRA DFHTRP Task abnormal termination requested by DFHTRAPATSA DFHTSDQ CTSD transaction attached other than by internal

requestATSB DFHTSDQ CTSD transaction attached with invalid parametersATSC DFHEITS,

DFHICP,DFHTSP

Task canceled during temporary storage command

ATSD DFHEITS,DFHICP,DFHTSP

Unexpected response from DS domain

ATSP DFHEITS,DFHTSP

Attempt to write to or delete a recoverable TS queuealready deleted in the same unit of work

ATSQ DFHEITS Move of data to or from temporary storage failedATUF DFH99KO Insufficient space to build parameter list for

DYNALLOC SVCAUEL DFHUEM,

DFHERMInternal logic error in CICS user exit management

452 CICS User’s Handbook

Page 473: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AUEP DFHUEH User exit program sent return code UERCPURG touser exit handler

AUXA CAUCAFB1 Unexpected error when one of TAU Detector exitprograms called CAUTABM

AUXB CAUCAFF3,CAUCAFF6,CAUCAFB1

The TAU Detector dataspace has filled up

AUYA CAUCAFB1 The TAU Detector transaction (CAFB) receivedunrecognized request

AUYC CAUCAFB1 The TAU Detector transaction (CAFB) receivedunexpected reply

AUYE CAUCAFB2,CAUCAFF3

The TAU Detector program found an invalid affinityfile number

AUYF CAUCAFB1 The TAU Detector transaction (CAFB) not started byCAFF

AUYG CAUCAFB1 The TAU Detector transaction (CAFB) still running atCICS termination

AUYH CAUCAFF4,CAUCAFF5,CAUCAFB1

The TAU Detector program found invalid address inDetector GWA

AUYI CAUCAFB2,CAUCAFF6

The TAU Detector transaction (CAFB of CAFB) hadunexpected error

AUYJ CAUCAFB2 One of the TAU affinity data files is fullAUZA CAUCAFF1, to

CAUCAFF6,CAUCAFF7,CAUCAFB1,CAUCAFB2,CAUCAF41

Unexpected error when CAFF or CAFB issued anEXEC CICS command

AUZB CAUCAFF1, toCAUCAFF6,CAUCAFB1,CAUCAFB2

Unexpected error when CAFF or CAFB issued aVSAM FC EXEC CICS command

AUZC CAUCAFF1,CAUCAFF2

Invalid internal field holding TAU Detector state

AUZD CAUCAFF1,CAUCAFF2

CICS APPLID in TAU file does not match APPLID ofCICS system

AUZF CAUCAFF1, toCAUCAFF6,CAUCAFB1

Unexpected error when CAFF or CAFB issued aDetector user exit

AUZH CAUCAFF3 Unexpected error when CAFF called CAUTABM tocreate MVS dataspace

AUZI CAUCAFF3,CAUCAFF6

Unexpected error when CAFF called CAUTABM tocreate affinity table

AUZJ CAUCAFF3 Unexpected error when CAFF called CAUTABM toadd element to table

AUZK CAUCAFF3 Unexpected error when CAFF attempted to initializeinternal trace table

Chapter 13. Transaction abend codes 453

Page 474: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AUZL CAUCAFF4 Unexpected error when CAFF attempted to releaseinternal trace table

AUZN CAUCAFF4 Unexpected error when CAFF called CAUTABM todestroy dataspace

AUZO CAUCAFF6 Unexpected error when CAFF called CAUTABM todestroy table

AUZQ CAUCAFF3 Unexpected error when CAFF CAUCAFP to createMVS CPOOL storage

AUZR CAUCAFF4,CAUCAFF5,CAUCAFB1

Unexpected error when CAFF or CAFB calledCAUCAFP to access storage

AUZS CAUCAFF4 Unexpected error when CAFF called CAUCAFP todestroy MVS CPOOL storage

AUZU CAUCAFF1 Unexpected error when CAFF calculated occupancyof dataspace occupied

AUZV CAUCAFF1 Incorrect method of initiating TAU Detectortransaction CAFF

AUZY CAUCAFF3,CAUCAFB2

Unexpected error when CAFF or CAFB calledCAUTABM to replace element

AUZZ CAUCAFF3,CAUCAFF6

Unexpected error when CAFF called subroutine toupdate TT or UT

AUZ1 CAUCAFF3 Header record on VSAM affinity data file not foundAWBA DFHWBXN CICS Web Receive error encounteredAWBB DFHWBBLI CICS Web Business Logic Interface program

parmlist errorAWBC DFHWBENV,

DFHWBTLNo commarea passed to CICS Web Interface utilityprogram

AWBE DFHWBBLI Converter program attempted to change responsearea address

AWBF DFHWBA Web Interface alias detected an error in initializationAWBH DFHWBA Web Interface alias detected a logic errorAWBI DFHWBA Web Interface alias received unexpected response

from EXEC CICS ASSIGN STARTCODEAWBJ DFHWBA Web Interface alias received unexpected response

when it switched to RP TCBAWBK DFHWBA Web Interface alias received an abend in converter

or program servicing the requestAWBL DFHWBA *** NO DESCRIPTION FOUND ***AWBM DFHWBA Web Interface alias detected an error from program

DFHWBBLI.AWBQ DFHWBA1,

DFHWBBLIWeb Business Logic Interface program detectederror in parameter list

AWBR DFHWBA1,DFHWBBLI

Web Business Logic Interface program detected alogic error

AWBU DFHWBC01 Web Interface connection manager could not getstorage

AWBV DFHWBC04 Web Interface connection manager detected errorresponse on EXEC CICS DEQ

454 CICS User’s Handbook

Page 475: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AWBX DFHWBC01 Web Interface connection manager started againstinvalid terminal type

AWBZ DFHWBC0B Web Interface connection manager detectedNOTAUTH response to EXEC CICS EXTRACT EXIT

AWB2 DFHWBXN Web Interface error in server controller attemting todisable

AWB3 DFHWBXN Web Interface error trying to determine how servercontroller was started

AWB4 DFHWBXN Web Interface server controller was invalidly startedAWB5 DFHWBM Requested port in not availableAWB7 DFHWBENV Web Interface environment variables program

invoked with invoking task number of zeroAWB8 DFHWBGB CWBG task started directly from terminalAWB9 DFHWBC01 Web Interface connection manager failed for lack of

storageAWC1 DFHWBLT Bridge exit DFHWBLT could not establish

partnership with Web terminal translation taskAWC2 DFHWBLT Bridge exit DFHWBLT passe an invalid state tokenAWC3 DFHWBLT Unsupported combination of BMS and terminal

control commands passedAWC4 DFHWBLT Bridge exit DFHWBLT reinvoked after returning an

earlier errorAWC5 DFHWBLT Bridge exit DFHWBLT could not getmain a brxa user

areaAWC6 DFHWBLT Bridge exit DFHWBLT detected an incinsistency in

request parameters or state dataAWKY DFHWKP Failure of global catalog request during warm

keypointingAXFA DFHXFP File control request keylength zeroAXFB DFHXFP Unacceptable FMH type foundAXFC DFHXFP Invalid request passed to data transformation

programAXFD DFHXFP Invalid request for remote systemAXFE DFHXFP Transformation requested does not existAXFF DFHXFP Unacceptable queue organization foundAXFG DFHXFP Unacceptable argument number in data following

FMH type 43AXFH DFHXFP Unexpected argument in data following FMH type 43AXFI DFHXFP Zero data length for WRITEQ TD or READQ TDAXFJ DFHXFP Error code in UIBFCTR and UIBDLTR cannot be

converted to SNA error codeAXFL DFHXFP Null chain of data receivedAXFM DFHXFP ISCINVREQ condition raisedAXFO DFHXFP Check on DS and DBA parameters failedAXFP DFHXFP No second FMH receivedAXFQ DFHXFP FMH too short or too longAXFR DFHXFP Length of data exceeds 32767AXFS DFHXFP Maximum length of I/O area exceeds 65535

Chapter 13. Transaction abend codes 455

Page 476: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AXFT DFHXFP Size of output I/O area exceeds 65535AXFU DFHXFP Invalid two-level cursorAXFW DFHXFP Invalid length specification givenAXFX DFHXFP Function shipping request by APPC link failed

protocolsAXFY DFHXFP APPC conversation failure for attach between CICS

systemsAXF0 DFHXFP Task purged due to lack of storage in a DSAAXF1 DFHXFP Unexpected return code from storage manager

module DFHSMGFAXF2 DFHXFP Task purged because of insufficient storage in DSAAXF3 DFHXFP Unexpected return code from storage manager

module DFHSMMCAXF4 DFHXFX Task purged before GET_BUFFER request

completed successfullyAXF5 DFHXFX Error on call to DFHEISRAXF8 DFHXFX Keyword shipped to system that does not support

the functionAXMA DFHxxx Error obtaining a lock in transaction manager

domain For module list,see CICS Messages andCodes

AXMB DFHxxx Error releasing a lock in transaction managerdomain For module list,see CICS Messages andCodes

AXMC DFHXMAT,DFHXMXE

Severe error allocating unique transaction number toa new transaction

AXMD DFHXMAB Invalid attempt to run CICS internal task CSXMAXMY DFHXMAT Error obtaining transaction class membershipAXMZ DFHXMTA Severe error detected by the transaction manager

domainAXSA DFHXSMN Security control task could not completeAXSC DFHXSMN Task purged before GETMAIN request to SM

domain completed successfullyAXSD DFHTCRP Error on call to SM domainAXTA DFHXTP Calculation of data length to be shipped failedAXTB DFHXTP Obtain of TIOA to ship data failedAXTC DFHXTP Data transform failedAXTD DFHXTP No TIOA received from remote systemAXTE DFHXTP Data received from remote system not long enoughAXTF DFHXTP No relay process FMH received from remote systemAXTG DFHXTP Data transform from remote system failedAXTH DFHXTP Locate of terminal identifier failedAXTI DFHXTP Major request byte LUCOPN0 invalidAXTJ DFHXTP Unexpected combination of bit settings in XTSSTAT

and XTSTCOPCAXTK DFHXTP APPC conversation failed on attach between CICS

systemsAXTL DFHXTP Wrong sync level for processing APPC mapped data

456 CICS User’s Handbook

Page 477: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AXTM DFHXTP Wrong sync level for message—protectedtransaction

AXTN DFHETL Application buffer chained off TCTTE (offestTCTERCSA) has corrupted header

AXTO DFHXTP Exception response from CICS security managerAXTP DFHXTP Exception response from DFHCCNV to DFHXTPAXTQ DFHXTP Exception response from DFHCCNV to DFHXTPAXTR DFHXTP Exception response from DFHPGLE to DFHXTPAZAB DFHZARM SEND DATA length greater than 65528AZAD DFHZCN1 DFHZCN1 started from unexpected placeAZAE DFHZCN1 DFHZCN1 started from terminal facility but not

LU6.2 sessionAZAF DFHZCN1 DFHZCN1 started for CCIN with errorsAZAG DFHZCT1 DFHZCT1 started from unexpected placeAZAH DFHZCT1 DFHZCT1 started from terminal facility but not LU6.2

sessionAZAI DFHZCT1 DFHZCT1 started for CTIN with errorsAZAJ DFHZCN1 CCIN must be local transaction on region directly

connected to clientAZAK DFHZCT1 CTIN must be local transaction on region directly

connected to clientAZCA DFHZARM DFHZARM conversation state conflictAZCB DFHZARM Sense code X'088901xx' received during APPC

mapped processingAZCC DFHZARM Unsupported function management dataAZCD DFHETL,

DFHZARMDFHZARM invalid data length received

AZCE DFHETL,DFHZARM

Application data length to be received exceedsallowable limits

AZCF DFHZARM Invalid request to DFHZARLAZCG DFHZARM Invalid TCTTEAZCH DFHETL,

DFHZARMUnexpected sense code X'0889xxxx' received whileprocessing APPC mapped data

AZCI DFHETL,DFHZARM,DFHZARQ

Invalid sync level

AZCJ DFHZARM System does not support APPC structured field withnull data

AZCK DFHZARM Internal logic error in error recovery for APPCmapped processing

AZCL DFHZARM Sense code X'088901xx' received during APPCmapped processing

AZCM DFHZARM Error on call to SM domainAZCN DFHZARM Task purged before GETMAIN request to SM

domain completed successfullyAZCO DFHZCGRP VTAM persistent sessions initialization txn (CGRP)

started directly from terminal

Chapter 13. Transaction abend codes 457

Page 478: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AZCP DFHZSUPDFH62XM

Logic error in ZCP

AZCQ DFHZSUPDFHMRXMDFH62XM

Error on call to RM domain

AZCR DFHZARL Error during APPC SYNCPOINT ROLLBACKrequest

AZCT DFHZARQ Terminal read-time-out has occurredAZCU DFHZCOVR Invalid attempt to start COVR transactionAZCV DFHZCOVR Logic error in COVR transaction while connecting to

VTAMAZCW DFHZCSTP Invalid attempt to run CICS internal task CSTPAZIA DFHZIS2 Transaction request for storage during MRO

processing invalidAZIB DFHZIS2 Transaction purged while waiting for storageAZIC DFHZIS2 Error on call to SM domain to FREEMAINAZID DFHZIS2 PURGED condition on call to SM domain to

FREEMAINAZIE DFHZARQ IRC ISSUE-ERROR or ISSUE-ABEND violated IRC

protocolsAZIF DFHZARQ Error on call to RM domainAZI1 DFHZARQ IRC data transmission protocol violatedAZI2 DFHZARQ IRC data transmission cannot completeAZI3 DFHZARQ Conversation failedAZI4 DFHZARQ IRC link to connected transaction downAZI5 DFHZARQ IRC data transmission violated IRC protocolsAZI6 DFHZARQ IRC connected transaction abnormally terminatedAZI7 DFHZIS2 Wait during MRO request rejected by CICS

dispatcherAZI8 DFHZIS1 Incorrect format for error log dataAZI9 DFHZIS2 Failing transaction purged during waitAZRA DFHZARRC FMH address missing from APPC receive bufferAZRB DFHZARR0 First parameter is invalid in call to DFHZARR0AZRD DFHZARR0 APPC logical and physical receive buffers are out of

stepAZRE DFHZARR0 Logical APPC receive buffer starts outside physical

bufferAZRF DFHZARRF Invalid state error returned from DFHZUSR state

machineAZRG DFHZARR Invalid state error returned from DFHZUSR state

machineAZRH DFHZARR Invalid RECEIVE_TYPE in DFHZARRAZRI DFHZARR1 Invalid parameter passed to DFHZARR1AZRJ DFHZARR0 APPC record length exceeds receive bufferAZRK DFHZARRF Invalid combination of fields in DFHLUC parameter

listAZRL DFHZARRF First parameter invalid in call to DFHZARRF

458 CICS User’s Handbook

Page 479: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AZRM DFHZARR DFHZARR called one of its own routines at wrongtime

AZRN DFHZARRF DFHLUC parameter list does not have LUCCIERRset on

AZRO DFHZARER First parameter invalid in call to DFHZARERAZRP DFHZARER Invalid response from DFHZNACAZRQ DFHZARRA Invalid parameter in call to DFHZARRAAZRR DFHZARRA Corrupted header in application bufferAZRS DFHZARRA DFHZARRA cannot acquire main memoryAZRT DFHZARRA Invalid application bufferAZRU DFHZARRF Unexpected response from DFHZARR0AZRV DFHZARR1 Unexpected response from DFHZARR0AZRW DFHZARRA Negative record length in the TCTTEAZRY DFHZARR Unexpected response from DFHZARRCAZRZ DFHZARR Unexpected response from an internal subroutineAZR2 DFHZARRA DFHZARRA can not acquire main memoryAZR3 DFHZARRA Task purged during GETMAIN requestAZR4 DFHZARER Unexpected response from dispatcher domain callAZR5 DFHZARR1 Unexpected response from dispatcher domain callAZR6 DFHZARER Exception condition from APPC routine DFHZARL to

RM domainAZS0 DFHZSTAP DFHZSTAM macro passed invalid requestAZS1 DFHZSTAP No TCTTE pointer passed via DFHZSTAM macroAZS2 DFHZSTAP TCTTE passed via DFHZSTAM does not relate to

MRO or APPC conversationAZS3 DFHZSTAP No LUCX found for an APPC TCTTEAZS4 DFHZSTAP DFHZUSRM LUC State Machine has invalid settingAZS5 DFHZSTAP Internal State number has invalid settingAZS6 DFHZSTAP Internal State number has invalid settingAZTA DFHZTSP Task does not own terminal as principal facilityAZTB DFHZTSP Attempt to delete/install remote terminal failedAZTC DFHZTSP Failure of remote terminal install or delete caused by

SOS conditionAZTF DFHZTSP TCTTE length error due to storage violation, or CICS

logic errorAZTG DFHZTSP Principal facility not intersystem TCTTEAZTH DFHZTSP Error response from remote terminal control macroAZTI DFHZTSP Terminal not defined as remotely ownedAZTL DFHZTSP Request to invalid terminalAZTM DFHZTSP Data has no FMHAZTN DFHZTSP Conversation unexpectedly terminatedAZTO DFHZTSP TCTTE ownership chain in errorAZTP DFHZTSP BMS TYPE=STORE request failedAZTQ DFHZTSP Invalid BMS data received from remote systemAZTR DFHZTSP BMS TYPE=PAGEOUT request failedAZTS DFHZTSP Data ship to remote system failedAZTT DFHZTSP Connection with remote system not APPC or MRO

connection

Chapter 13. Transaction abend codes 459

Page 480: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AZTU DFHZTSP Link TCTTE not owned by task after syncpointAZTV DFHZTSP Invalid FMH received from remote systemAZTW DFHZTSP Attach request to task already runningAZTY DFHZTSP Maximum APPC sessions limit reachedAZTZ DFHZTSP Relay program DFHCRT attached in unsupported

mannerAZT1 DFHZTSP Task attached improperly in AOR when transaction

routingAZT3 DFHZTSP Task is being routed back to region from where it

cameAZT6 DFHZTSP TOR has violated transaction routing protocolAZT7 DFHZTSP TCT entry for remotely owned APPC terminal can

not be added to TCTAZT8 DFHZTSP TCT entry for remotely owned APPC terminal can

not be deleted from TCTAZT9 DFHZTSP TCT entry for remotely owned APPC terminal can

not be deleted from TCT as it is locked by anothertask

AZVA DFHZATS Time-out while waiting for service transaction CITSto complete

AZVB DFHZATS DFHZCQ failed to create remote terminal definitionAZVC DFHZATS Unexpected error in DFHZATSAZVD DFHZATS Unexpected error in install procedure of DFHZATSAZVE DFHZATS Terminal has same ID as an existing TCT entryAZVF DFHZATS An attempt was made to start

CITS/CDTS/CMTS/CFTS from a terminalAZVG DFHZATS Error in remote delete routinesAZVH DFHZATS Error in remote delete routine while processing mass

deleteAZVI DFHZATS Error in remote delete routine while processing

single deleteAZVJ DFHZATS Error in mass deletion of remote terminalsAZVK DFHZATS Unexpected return code during deletion of single

terminalAZVL DFHZATS Error in mass flag routine of remote terminals for

deletionAZVM DFHZATMF Error in DFHZATMFAZVN DFHZATMF CRMF started directly from terminalAZVO DFHZATMD CRMD started directly from terminalAZVP DFHZATMD Error in DFHZATMDAZVQ DFHZATS Request to install a shipped terminal definition

rejected by autoinstall user programAZVR DFHZATS Unexpected return code from autoinstall user

programAZVS DFHZATS Error in autoinstall user programAZVU DFHZATS Autoinstall of shipped terminal, virtual terminal or

shipped connection failed

460 CICS User’s Handbook

Page 481: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

AZXA DFHZXCU Catch-up program finds unexpected error, reasoncode 5

AZXB DFHZXCU Catch-up program finds unexpected error, reasoncode 4

DHxx DFH***** EXEC DL/I error or invalid status code (xx)0100 DFHEAP

DFHECPDFHEDPDFHEPP

Translator error opening listing data set

0101 DFHEAPDFHECPDFHEDPDFHEPP

Translator program check

0211 DFHPDDFHPDX

Recursive program check in system dump

0212 DFHPDDFHPDX

Too many program checks in system dump

0300 DFHCSDUP SYSIN data set failed to open successfully0301 DFHCSDUP Invalid RECFM in SYSIN DD statement0302 DFHCSDUP Invalid record length in SYSIN DD statement0303 DFHCSDUP SYSPRINT data set has not opened successfully0304 DFHCSDUP DFHCSDUP found unrecognized resource type code

in CSD record0305 DFHCSDUP Unexpected return code received0307 DFHCSDUP Attempt to print input command failed0308 DFHCSDUP Bad command sequence found migrating TCT table0309 DFHCSDUP Unrecognized function code found in command0321 DFHCSDUP Internal error in DFHCSDUP module0322 DFHCSDUP Table to be migrated could not be loaded0323 DFHCSDUP VSAM detected an error processing a command0325 DFHCSDUP Error occurred during execution of DFHDMP function0326 DFHCSDUP Internal logic error in DFHCSDUP utility program0327 DFHCSDUP Language table DFHEITCU could not be loaded0328 DFHCSDUP Language table DFHEITCU could not be unloaded0330 DFHCSDUP Cross-reference table size too small0331 DFHCSDUP *** NO DESCRIPTION FOUND ***0332 DFHCSDUP *** NO DESCRIPTION FOUND ***0401 DFHXCSTB EXCI call made in AMODE 240402 DFHXCPRH Nonzero return code following MVS ESTAE issued

by DFHXCPRH0403 DFHXCPRH Nonzero return code following MVS GETMAIN

request by DFHXCPRH0404 DFHXCPRH EXCI dump services not available to take MVS

SDUMP0405 DFHXCPRH Failure of SSI VERIFY request by DFHXCPRH0406 DFHXCPRH Failure of CICS SVC call during EXCI initialization0407 DFHXCPRH CICS SVC at the wrong level for EXCI

Chapter 13. Transaction abend codes 461

Page 482: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Abend codes

Abend Module Explanation

0408 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRHfor working storage

0409 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRHfor SSI VERIFY

0410 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRHfor XCUSER block

0411 DFHXCDMP Failure of CICS SVC call by DFHXCDMP0412 DFHXCEIP Invalid function in EXEC parameter list of EXCI

EXEC API request0413 DFHXCEIP Error in EXEC parameter list of EXCI EXEC API

request0414 DFHXCEIP Nonzero return code following MVS ESTAE issued

by DFHXCEIP0415 DFHXCEIP Error in EXCI initialization detected by DFHXCEIP0501 DFHCALLA,

DFHMSGIF,DFHTRCIF

JCICS request attempted on a pthread

0555 DFHAPLJ CICS JVM interface percolation abend to driveLanguageEnvironment recovery

462 CICS User’s Handbook

Page 483: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Chapter 14. 1xxx-9xxx (COBOL II) abend codes

Abend codes with 1 through 9 as the first character are issued by COBOL IIapplications running on CICS. The last three digits of the abend code, xxx,correspond to the xxx in the associated COBOL II run-time message,IGZxxxI.

COBOL II run-time messages are described in the VS COBOL II ApplicationProgram Debugging Guide, SC26-4049.

Copyright IBM Corp. 1989, 1999 463

Page 484: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

464 CICS User’s Handbook

Page 485: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM

Chapter 15. VTAM-associated errors

This section lists the terminal error codes from VTAM.

VTAM terminal error codes and CICS message numbersTerminal error codes from VTAM are put in a one-byte field of theDFHZNAC COMMAREA (DFHNEPCA) at label TWAEC.

For those error codes that have CICS messages associated with them, youshould see the CICS Messages and Codes for descriptions of thecorresponding error conditions.

CICS message Action flags set Error code Symbolic label

DFHZC0101 X'5D' TCZPRDTODFHZC0125 X'FB' TCZPSUNBDFHZC0131 X'FC' TCZPSOPNDFHZC0144 11 X'7A' TCZPSRACDFHZC0145 3 9 10 11 24

DUMPNTAX'79' TCZPSRAF

DFHZC0146 X'FD' TCZPSRCDFHZC0147 3 9 10 11 24

DUMPNTAX'71' TCZPSLE

DFHZC0148 9 10 11 24 X'72' TCZPSVFDFHZC0149 X'FF' TCZPSPEDFHZC0150 3 9 10 11 15 24

DUMPNTAX'FE' TCZPSRF

DFHZC0155 3 9 10 11 24DUMPNTA

X'6C' TCZPSAF

DFHZC0156 X'6D' TCZPSARDFHZC2102 3 X'E9' TCZSTINDDFHZC2117 9 10 11 23 24 X'DB' TCZPIPLDFHZC2351 2 3 X'6F' TCZSDASDFHZC2400 2 3 9 10 11 24

AOSX'C1' TCZSRCAT

DFHZC2401 2 3 9 10 11 24OUTSERV

X'B1' TCZRPLAC

DFHZC2402 3 11 X'B4' TCZRSNEDFHZC2403 2 5 18 24 X'11' TCZSRCBFDFHZC2404 X'E6' TCZDMLGDFHZC2404 2 3 9 10 11 24

AOSX'14' TCZLRCER

DFHZC2404 2 3 9 10 11 24AOS

X'18' TCZLRCNR

DFHZC2405 18 X'10' TCZSRCTUDFHZC2406 9 10 11 18 X'19' TCZSRCTSDFHZC2407 2 3 9 10 11 24 X'15' TCZSRCPF

Copyright IBM Corp. 1989, 1999 465

Page 486: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM

CICS message Action flags set Error code Symbolic label

DFHZC2408 2 3 9 10 11 1824

X'1A' TCZSRCVE

DFHZC2408 2 3 9 10 11 1824

X'1E' TCZSRCV2

DFHZC2409 2 3 9 10 11 1524

X'D0' TCZTXCS

DFHZC2410 2 3 9 10 11 1824

X'D1' TCZTXCU

DFHZC2411 X'E0' TCZDMSNDFHZC2412 X'E1' TCZDMRADFHZC2413 2 X'E2' TCZDMCLDFHZC2414 X'80' TCZSRCSPDFHZC2416 18 24 X'13' TCZSRCVHDFHZC2417 2 24 X'1D' TCZSRCVIDFHZC2417 X'20' TCZVTAMIDFHZC2418 2 3 9 10 11 24

AOSX'BB' TCZSEXUC

DFHZC2419 2 3 9 10 11 24AOS

X'82' TCZSSXUC

DFHZC2420 2 3 9 10 11 24AOS

X'B5' TCZSAXUC

DFHZC2421 2 3 9 10 11 24 X'60' TCZUNCMDDFHZC2422 1 2 3 9 10 11

DUMPNTAX'90' TCZLGCER

DFHZC2423 3 9 10 11 24 X'74' TCZSDSE5DFHZC2424 3 9 10 11 15 24 X'75' TCZSESE1DFHZC2425 3 9 10 11 15 24 X'B2' TCZSDAUCDFHZC2426 2 3 9 10 11 22 X'94' TCZRACESDFHZC2427 2 X'C5' TCZSRCNADFHZC2428 3 9 11 X'92' TCZSDSE6DFHZC2429 3 10 11 X'91' TCZRSTLEDFHZC2430 3 9 11 RESP X'78' TCZSDRE2DFHZC2431 2 3 9 10 11 X'CB' TCZSRCTCDFHZC2432 X'81' TCZSSXNRDFHZC2433 X'E4' TCZAIERDFHZC2434 3 11 X'43' TCZCPYNSDFHZC2435 3 10 11 24 X'96' TCZRVSZ1DFHZC2436 3 10 11 X'97' TCZRVSZ3DFHZC2437 3 9 11 X'73' TCZSDSE4DFHZC2438 3 10 11 X'A1' TCZRVSZ2DFHZC2439 2 18 X'98' TCZACT01DFHZC2440 X'D7' TCZSXC1DFHZC2441 X'D6' TCZSXC2DFHZC2442 X'DC' TCZPXE1DFHZC2443 2 3 9 10 11 24 X'59' TCZROCTDFHZC2444 2 3 9 10 11 24 X'A3' TCZBKTSEDFHZC2445 3 9 11 X'95' TCZSDSE8

466 CICS User’s Handbook

Page 487: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM

CICS message Action flags set Error code Symbolic label

DFHZC2446 2 3 9 10 11 24AOS

X'84' TCZSSXIB

DFHZC2447 3 9 10 11 AOS X'9A' TCZDOMCFDFHZC2448 2 3 10 11 24

AOS RESPX'65' TCZINVRR

DFHZC2449 2 3 11 18 22 24 X'A7' TCZBOEBDFHZC2450 X'83' TCZSSXARDFHZC2451 2 3 9 10 11 X'CC' TCZSRCCIDFHZC2452 3 9 10 11 18 24 X'D5' TCZCXE2DFHZC2453 1 2 3 9 10 X'D4' TCZCXRRDFHZC2454 2 3 9 10 11 X'CD' TCZSRCCXDFHZC2455 2 3 9 10 11 X'93' TCZRACETDFHZC2456 2 3 9 10 11 18

24X'44' TCZSRCDE

DFHZC2457 2 3 9 10 11 24 X'D8' TCZRNCHDFHZC2458 X'DD' TCZPXE2DFHZC2459 3 9 11 X'99' TCZSDSE7DFHZC2463 X'D3' TCZDMPDDFHZC2467 2 3 9 10 11 24

AOSX'88' TCZLEXCI

DFHZC2468 2 3 9 10 11 24 X'89' TCZLEXUSDFHZC2469 2 3 9 10 11 X'D9' TCZYX43DFHZC2469 2 3 9 10 11 X'F2' TCZEXRVTDFHZC2470 9 10 11 24 X'DA' TCZSXC3DFHZC2471 2 3 10 11 22 24

PRTTIOAX'A8' TCZFMHLE

DFHZC2472 11 X'A9' TCZRACRFDFHZC2473 3 9 11 X'AA' TCZSDSE9DFHZC2485 3 9 10 11 X'E3' TCZCNCLDFHZC2486 3 X'9B' TCZRACNLDFHZC2487 3 X'76' TCZLGNADFHZC2488 X'77' TCZDMRYDFHZC2489 3 9 11 X'40' TCZINCPYDFHZC2490 2 3 9 10 11 15

24X'41' TCZTOLRQ

DFHZC2497 X'42' TCZUNPRTDFHZC2498 X'4B' TCZICPUTDFHZC3400 3 10 11 RESP X'45' TCZCHMXDFHZC3402 3 9 10 11 X'46' TCZOCIRDFHZC3409 2 3 9 10 11 24

AOSX'85' TCZUNEGR

DFHZC3410 2 3 9 10 11 X'BC' TCZINIIRDFHZC3416 2 3 X'E8' TCZDMSLEDFHZC3417 3 9 10 11 24 X'50' TCZSDRE3DFHZC3418 3 9 10 11 24 X'51' TCZBDPRIDFHZC3419 2 3 5 X'52' TCZBDUACDFHZC3420 20 X'53' TCZBDTOSDFHZC3421 20 X'5A' TCZSBIRV

Chapter 15. VTAM-associated errors 467

Page 488: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM

CICS message Action flags set Error code Symbolic label

DFHZC3422 2 3 9 10 11 1824

X'5B' TCZNSP01

DFHZC3424 9 10 11 15 24 X'5C' TCZNSP02DFHZC3428 3 X'EB' TCZSTRMHDFHZC3429 2 3 X'EC' TCZSTRMMDFHZC3430 2 3 X'ED' TCZSTONDFHZC3431 2 3 X'EF' TCZSTINDFHZC3432 2 3 X'EA' TCZSTLERDFHZC3433 X'58' TCZERMGRDFHZC3434 2 3 9 10 11 24 X'54' TCZUNBISDFHZC3440 X'55' TCZEMWBKDFHZC3441 X'63' TCZVTAMODFHZC3442 X'67' TCZVTAMKDFHZC3443 X'64' TCZVTAMADFHZC3444 2 3 9 10 11 24

PRTACTX'6A' TCZTIOAE

DFHZC3452 X'66' TCZSIGRDFHZC3454 2 3 5 18 24 X'5E' TCZBRUACDFHZC3455 2 3 5 18 24 X'5F' TCZBDSQPDFHZC3461 X'48' TCZOPSINDFHZC3462 X'49' TCZCLSINDFHZC3463 X'4A' TCZOPACBDFHZC3464 20 X'57' TCZRELISDFHZC3465 1 2 3 9 10 11

AOSX'9D' TCZRSPER

DFHZC3466 20 AOS X'69' TCZSEXOSDFHZC3468 9 10 11 15 24 X'70' TCZCLRRVDFHZC3469 9 10 11 24 X'CE' TCZVHOLDDFHZC3470 9 10 11 24 X'AB' TCZLUERRDFHZC3470 9 10 11 24 X'37' TCZXSHRADFHZC3471 9 10 11 24 X'CF' TCZVRNOPDFHZC3472 X'9E' TCZDEVNDDFHZC3473 X'4D' TCZSLSRLDFHZC3474 9 10 11 24 X'AC' TCZVRDACDFHZC3475 9 10 11 24 X'AD' TCZNRLUFDFHZC3476 9 10 11 24 X'AE' TCZRCLUFDFHZC3477 9 10 11 24 X'AF' TCZCLEANDFHZC3479 2 3 9 10 11 24 X'4E' TCZUNBFEDFHZC3480 24 AOS X'A0' TCZNOISCDFHZC3481 2 3 9 10 11 24 X'4C' TCZDSPCLDFHZC3482 X'DF' TCZDMGFDFHZC3484 X'C6' TCZPASSDDFHZC3485 24 X'C7' TCZPSPREDFHZC3486 24 X'C2' TCZLUINPDFHZC3487 24 X'C9' TCZNPSAUDFHZC3488 2 3 9 10 11 18

24X'3C' TCZXUVAR

DFHZC3489 18 24 X'C8' TCZLUINH

468 CICS User’s Handbook

Page 489: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM

CICS message Action flags set Error code Symbolic label

DFHZC3490 24 X'BF' TCZCPFALDFHZC3491 15 24 X'B0' TCZEXRODFHZC3492 X'16' TCZDMITDFHZC3495 24 X'6B' TCZNOTNADFHZC3499 X'C0' TCZDWEGFDFHZC4902 3 9 10 11 24 X'21' TCZLUCF1DFHZC4903 3 9 10 11 24 X'22' TCZLUCF2DFHZC4904 3 9 10 11 24 X'23' TCZFSMBEDFHZC4905 3 9 10 11 24 X'24' TCZFSMCSDFHZC4906 3 9 10 11 24 X'25' TCZFSMCRDFHZC4907 3 9 10 11 24 X'26' TCZSDLERDFHZC4909 3 9 10 11 24 X'28' TCZRVLERDFHZC4910 3 9 10 11 24 X'29' TCZRVLRBDFHZC4911 2 3 9 10 11 24 X'2A' TCZRLPEXDFHZC4912 2 3 9 10 11 24 X'2B' TCZRLPBDDFHZC4913 2 3 9 10 11 24 X'2C' TCZRLPDRDFHZC4914 2 3 9 10 11 24 X'2D' TCZRLPILDFHZC4915 2 3 9 10 11 24 X'2E' TCZRLPECDFHZC4916 2 3 9 10 11 24 X'2F' TCZRLPRRDFHZC4917 2 3 9 10 11 24 X'30' TCZRLPIFDFHZC4918 2 3 9 10 11 24 X'31' TCZRLPIRDFHZC4919 2 3 9 10 11 24 X'33' TCZIVINDDFHZC4920 2 3 9 10 11 24 X'34' TCZIVDATDFHZC4922 N24 X'32' TCZRLXCLDFHZC4924 2 3 5 24 X'B6' TCZNSEEDDFHZC4925 2 3 5 24 X'B7' TCZASINCDFHZC4926 2 3 5 24 X'B8' TCZEVBADDFHZC4927 2 3 5 24 X'B9' TCZFMH12DFHZC4928 24 X'BD' TCZDESGMDFHZC4929 2 3 5 24 X'B3' TCZBDBNDDFHZC4930 2 3 9 10 11 24 X'35' TCZRTMTDFHZC4931 18 24 X'F1' TCZBDMODDFHZC4932 2 3 24 X'F3' TCZICTYPDFHZC4933 2 3 24 X'F4' TCZIDBADFHZC4934 2 3 24 X'F5' TCZISYNLDFHZC4935 2 3 24 X'F6' TCZIUOWDFHZC4936 2 3 24 X'F7' TCZIFMHLDFHZC4937 2 3 5 24 X'8A' TCZLUSRRDFHZC4938 2 3 5 24 X'8B' TCZLUSRFDFHZC4939 2 3 5 24 X'8C' TCZLUPUNDFHZC4940 2 3 5 24 X'8F' TCZLUSKNDFHZC4941 2 3 5 24 X'8D' TCZLUPLKDFHZC4942 2 3 5 24 X'8E' TCZLUPEXDFHZC4943 3 9 10 11 24 X'F8' TCZFSMRBDFHZC4944 2 3 5 24 X'BE' TCZBFAILDFHZC4945 3 9 10 11 24 X'A2' TCZPRGEDFHZC4946 2 3 24 X'F9' TCZINVATDFHZC4947 2 3 24 X'FA' TCZLUSEC

Chapter 15. VTAM-associated errors 469

Page 490: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM

CICS message Action flags set Error code Symbolic label

DFHZC6590 X'3F' TCZXRSTDFHZC6591 9 10 11 15 24 X'3E' TCZXERRDFHZC6593 X'3B' TCZXSBCDFHZC6594 24 X'3A' TCZXSHRDFHZC6595 2 3 5 24 X'39' TCZXSABNDFHZC6596 2 3 15 24 X'38' TCZXSWASDFHZC6598 X'56' TCZXRFVS

470 CICS User’s Handbook

Page 491: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

System sense codes

Chapter 16. System sense codes received

This section contains Product-sensitive Programming Interface information.

This table lists the actions taken by DFHZNAC on receipt of inbound systemsense codes.

Sensecode

Message Action flags set

0001 DFHZC3401 20002 DFHZC3415 2, 3, 10, 110003 DFHZC3449 None0004 DFHZC3450 None0007 DFHZC3451 None00FF DFHZC3446 2, 3, 9, 10, 11, 23, 240801 DFHZC2476 3, 9, 10, 110802 DFHZC2461 None0806 DFHZC3426 None0807 DFHZC3411 None080B DFHZC2462 2, 3, 9, 10, 11, 15, 24080E DFHZC3448 23080F DFHZC3436 9, 10, 110811 DFHZC2464 9, 10, 110812 DFHZC2465 2, 3081B DFHZC2483 2, 3081C DFHZC2466 2, 3, 9, 10, 110824 DFHZC2475 3, 9, 10, 110825 DFHZC2484 2, 3, 9, 10, 110826 DFHZC3423 2, 3, 9, 10, 110827 DFHZC2480 30829 DFHZC3407 1, 2, 3, 10, 11, 24082A None 9, 32082B DFHZC3408 2, 3, 10, 11, 13082D DFHZC3413 None082E DFHZC3412 None082F DFHZC3414 2, 3, 9, 10, 110831 DFHZC3438 None0833 DFHZC3427 None0847 DFHZC3439 None084A None 32084C DFHZC3467 9, 10, 110860 DFHZC3459 None0863 DFHZC3460 9, 10, 110864 DFHZC2475 3, 9, 10, 110865 DFHZC2465 3, 9, 10, 110866 DFHZC2475 3, 9, 10, 110867 None 9, 10, 110868 DFHZC3456 2, 9, 10, 11

Copyright IBM Corp. 1989, 1999 471

Page 492: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

System sense codes

Sensecode

Message Action flags set

0869 DFHZC3457 2, 9, 10, 1108FF DFHZC3447 2, 3, 9, 10, 11, 241000 DFHZC3494 2, 3, 9, 10, 111001 DFHZC2481 2, 3, 9, 10, 11, 141002 DFHZC2481 2, 3, 9, 10, 11, 141003 DFHZC2479 2, 3, 9, 10, 11, 141005 DFHZC3406 2, 3, 4, 9, 10, 11, 141008 DFHZC2478 None1009 DFHZC3458 2, 9, 10, 1110FF DFHZC3446 2, 3, 9, 10, 11, 23, 242003 DFHZC3405 2, 3, 9, 10, 11, 15, 2420FF DFHZC3445 2, 3, 9, 10, 11, 23, 24400B DFHZC2477 1, 3, 1140FF DFHZC3453 2, 3, 9, 10, 11, 23, 248000 DFHZC3435 2, 3, 9, 10, 11, 18, 248005 DFHZC3435 2, 3, 9, 10, 11, 18, 2480FF DFHZC3435 2, 3, 9, 10, 11, 18, 23, 24FFFF DFHZC2460 2, 3, 9, 10, 11, 23, 24

Message Sensecode

Action flags set

DFHZC2460 FFFF 2, 3, 9, 10, 11, 23, 24DFHZC2461 0802 NoneDFHZC2462 080B 2, 3, 9, 10, 11, 15, 24DFHZC2464 0811 9, 10, 11DFHZC2465 0812 2, 3DFHZC2465 0865 3, 9, 10, 11DFHZC2466 081C 2, 3, 9, 10, 11DFHZC2475 0824 3, 9, 10, 11DFHZC2475 0864 3, 9, 10, 11DFHZC2475 0866 3, 9, 10, 11DFHZC2476 0801 3, 9, 10, 11DFHZC2477 400B 1, 3, 11DFHZC2478 1008 NoneDFHZC2479 1003 2, 3, 9, 10, 11, 14DFHZC2480 0827 3DFHZC2481 1001 2, 3, 9, 10, 11, 14DFHZC2481 1002 2, 3, 9, 10, 11, 14DFHZC2483 081B 2, 3DFHZC2484 0825 2, 3, 9, 10, 11DFHZC3401 0001 2DFHZC3405 2003 2, 3, 9, 10, 11, 15, 24DFHZC3406 1005 2, 3, 4, 9, 10, 11, 14DFHZC3407 0829 1, 2, 3, 10, 11, 24DFHZC3408 082B 2, 3, 10, 11, 13DFHZC3411 0807 None

472 CICS User’s Handbook

Page 493: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

System sense codes

Message Sensecode

Action flags set

DFHZC3412 082E NoneDFHZC3413 082D NoneDFHZC3414 082F 2, 3, 9, 10, 11DFHZC3415 0002 2, 3, 10, 11DFHZC3423 0826 2, 3, 9, 10, 11DFHZC3426 0806 NoneDFHZC3427 0833 NoneDFHZC3435 8000 2, 3, 9, 10, 11, 18, 24DFHZC3435 8005 2, 3, 9, 10, 11, 18, 24DFHZC3435 80FF 2, 3, 9, 10, 11, 18, 23, 24DFHZC3436 080F 9, 10, 11DFHZC3438 0831 NoneDFHZC3439 0847 NoneDFHZC3445 20FF 2, 3, 9, 10, 11, 23, 24DFHZC3446 00FF 2, 3, 9, 10, 11, 23, 24DFHZC3446 10FF 2, 3, 9, 10, 11, 23, 24DFHZC3447 08FF 2, 3, 9, 10, 11, 24DFHZC3448 080E 23DFHZC3449 0003 NoneDFHZC3450 0004 NoneDFHZC3451 0007 NoneDFHZC3453 40FF 2, 3, 9, 10, 11, 23, 24DFHZC3456 0868 2, 9, 10, 11DFHZC3457 0869 2, 9, 10, 11DFHZC3458 1009 2, 9, 10, 11DFHZC3459 0860 NoneDFHZC3460 0863 9, 10, 11DFHZC3467 084C 9, 10, 11DFHZC3494 1000 2, 3, 9, 10, 11None 082A 9, 32None 084A 32None 0867 9, 10, 11

Chapter 16. System sense codes received 473

Page 494: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

System sense codes

Action flag settings and default actions˚˚˚˚˚These are the default actions generated by DFHZNAC for DFHZNEP. Thedefault actions can vary from the actions set, depending on the state of thenode at the time of the error.

Flag Field Bit mask Hex bitsetting

Action

1 TWAOPT1 1... .... "X'80'" Print action flags2 .1.. .... "X'40'" Print VTAM RPL3 ..1. .... "X'20'" Print TCTTE4 ...1 .... "X'10'" Print TIOA5 .... 1... "X'08'" Print BIND area6 .... .1.. "X'04'" System dump if no task

attached9 1... .... "X'80'" Abort any send for this

terminal10 TWAOPT2 .1.. .... "X'40'" Abort any receive for " "11 ..1. .... "X'20'" Abend any task attached to

TCTTE12 ...1 .... "X'10'" Cancel any task attached to

TCTTE13 .... 1... "X'08'" Good Morning message to

be sent14 .... .1.. "X'04'" Purge any BMS pages for

this TCTTE15 .... ..1. "X'02'" SIMLOGON required17 TWAOPT3 1... .... "X'80'" Set INTLOG now allowed18 .1.. .... "X'40'" Set no internal general

logons20 ...1 .... "X'10'" Normal CLSDST (no reset

allowed)21 .... 1... "X'08'" Normal CLSDST (reset

allowed)22 .... .1.. "X'04'" Send negative response23 .... ..1. "X'02'" Keep node out of service24 .... ...1 "X'01'" CLSDST node

474 CICS User’s Handbook

Page 495: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM identifiers

Chapter 17. VTAM submodule identifiers

This chapter contains Product-sensitive Programming Interface information.

Hex ID Module Description

X'00' ZDSP DISPATCHX'01' ZARQ READ /WRITE RX'02' ZLOC LOCATEX'03' ZDET DETACHX'04' ZTCP TCPX'06' ZCRQ COMMAND REQSX'08' ZSTU STATUS CHANGEX'09' ZTSP TERMINAL SHARINGX'0A' ZHPX HPO RPL EXEC OS

ONLYX'0B' ZISP ALLOCATE/FREEX'0C' ZIS1 INTER SYSTEMX'0D' ZIS2 INTER SYSTEM 2X'0E' ZABD INVALID

REQUEST/ABENDX'10' ZATI ATIX'11' ZATT ATTACH TASKX'12' ZFRE FREE STORAGEX'13' ZGET GET STORAGEX'14' ZRAC RECEIVE ANYX'15' ZRST RESETSRX'16' ZRVS RECEIVE SPECX'17' ZRVX RECEIVE S EXTX'18' ZSDS SEND NORMALX'19' ZSDX SEND DATA EXITX'1A' ZUCT TRANSLATIONX'1B' ZUIX USER EXITX'1C' ZACT ACTIVATE SCANX'1D' ZSDR SEND RESPONSEX'1E' ZHPS HPO SEND/RECV CALLX'1F' ZRPL RECV.ANY BLDERX'20' ZAIT ATTACH INITX'21' ZASX ASYN COM EXITX'22' ZCLS CLOSE DESTINX'23' ZCLX CLOSE DS EXITX'24' ZDWE DWE PROCESSX'25' ZLEX LERAD EXITX'26' ZLGX LOGON EXITX'27' ZLRP LOGICAL RECX'28' ZLTX LOSTERM EXITX'29' ZOPN OPEN DESTINATX'2A' ZOPX OPEN DESTEXITX'2B' ZRAQ READAHEAD QUE

Copyright IBM Corp. 1989, 1999 475

Page 496: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM identifiers

Hex ID Module Description

X'2C' ZRAR READAHEAD RETX'2E' ZRRX REL REQUEST EXX'2F' ZNSP NETWORK SPEC EXITX'30' ZRSY RESYNCX'31' ZSAX SEND COMM EXTX'32' ZSCX SCIP EXITX'33' ZSDA SEND ASYN COMX'34' ZSKR SEND COMMAND

RESPONSE IDX'35' ZSES SESSIONC COMX'36' ZSEX SESSIONC EXITX'37' ZSIM SIMLOGONX'38' ZSIX SIMLOGON EXITX'39' ZSLS SETLOGON STARTX'3A' ZSSX SEND COM EXITX'3B' ZSYX SYNAD EXITX'3C' ZTAX TURNAROUND EXITX'3D' ZTPX TPEND EXITX'3E' ZOPA VTAM OPEN ACBX'3F' ZSHU VTAM SHUTDOWNX'40' ZQUE TERMINAL SHARINGX'41' ZEMW ERROR MESSAGE

WRITERX'42' ZSYN SYNCPOINT HANDLERX'43' ZTRA VTAM RPL TRACEX'44' ZAND ABEND CONTROL

BLOCKX'45' ZCNA CONSOLE CONTROLX'46' ZCNR CONSOLE REQUESTX'47' ZCNC CONSOLE ABNORMAL

COND.X'48' ZUAX ATTACH USER EXITX'49' ZUOX OUTPUT USER EXITX'4A' ZARL LU6.2 APPL REQUESTX'4B' ZARM LU6.2 MIGRATIONX'4C' ZRVL LU6.2 RECEIVEX'4D' ZRLX LU6.2 RECEIVE EXITX'4E' ZSDL LU6.2 SENDX'4F' ZSLX LU6.2 SEND EXITX'50' ZERH LU6.2 APPL ERPX'52' ZBKT LU6.2 BRACKET STATE

M/CX'53' ZCNT LU6.2 CONTENTION

STATEX'54' ZCHS LU6.2 CHAIN SENDX'55' ZCHR LU6.2 CHAIN RECEIVEX'56' ZUSR LU6.2 CONVERSATION

STATE

476 CICS User’s Handbook

Page 497: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM identifiers

Hex ID Module Description

X'57' ZDST SNA-ASCII TRANROUTINE

X'58' ZEV1 ENCRYPTIONVALIDATION 1

X'59' ZEV2 ENCRYPTIONVALIDATION 2

X'5E' ZXRC XRF TERMINALRECOVERY

X'5F' ZXTS XRF TERMINAL SCANX'60' ZXRL LU6.2 Transaction

RoutingX'61' ZINT Initialization Module IdentX'62' ZXRT LU6.2 Transaction

Routing TOSX'63' ZSTA LU6.2 Application StatusX'64' ZRLP LU6.2 RECEIVE

post-vtamX'65' ZCRT LU6.2 RPL_B stateX'66' ZRAS LU6.2 Slow-down

processingX'67' ZXPS LU6.2 Per sess recoveryX'7D' ZRLG RESPONSE LOGGERX'7E' ZNAC NACPX'7F' ZRSP RESYNC SYSTEM TASKX'80' ZATR ZATR restart deletesX'82' ZATA ZATA autoinstallX'84' ZATD ZATD autoinstall deleteX'86' ZGMM GOOD MORNING

TRANSACTIONX'8B' ZATS ZATS remote install entryX'C0' ZQ00 DFHZCQ REQUEST

ROUTERX'C1' ZQIN ZC INITIALIZEX'C2' ZQBA ZC Bind AnalysisX'C3' ZQCH ZC CHANGEX'C4' ZQDL ZC DELETEX'C5' ZQIT ZC INSTALL TCTTEX'C6' ZQRC ZC RECOVERX'C7' ZQRS ZC RESTOREX'C8' ZQIQ ZC INQUIREX'C9' ZQIS ZC INSTALLX'C4' ZTCT DUMMY TCTTE

IDENTIFIER

Chapter 17. VTAM submodule identifiers 477

Page 498: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

VTAM identifiers

478 CICS User’s Handbook

Page 499: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Storage classes

Chapter 18. AP domain storage classes

This chapter contains Diagnosis, Modification or Tuning information.

This table shows the valid AP domain storage classes. Some classes use astorage accounting area (SAA). For these, the storage class value alwaysappears in the first byte in the accounting area for a storage element. Thevalue is sometimes modified when the top bit is set to indicate getmainedstorage. As an example, X'01' can appear as X'81'.

Value Class SAA

X'01' TERMINAL24 NoX'02' CICS NoX'03' SHARED_CICS NoX'04' LINE NoX'05' TERMINAL NoX'06' TASK NoX'07' TASK24 NoX'08' CICS24 NoX'09' SHARED_CICS24 NoX'0C' CICS24_SAA YesX'0D' TRANSDATA YesX'0E' TEMPSTG YesX'11' USER NoX'12' USER24 NoX'13' SHARED_CICS24_SAA YesX'14' CONTROL NoX'16' TACLE YesX'20' SHARED_USER24 NoX'21' SHARED_USER No

Copyright IBM Corp. 1989, 1999 479

Page 500: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Storage classes

480 CICS User’s Handbook

Page 501: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Sending your comments to IBM

If you especially like or dislikeanything about this book, please useone of the methods listed below tosend your comments to IBM.

Feel free to comment on what youregard as specific errors oromissions, and on the accuracy,organization, subject matter, orcompleteness of this book.

Please limit your comments to theinformation in this book and the wayin which the information ispresented.

To request additional publications, orto ask questions or make commentsabout the functions of IBM productsor systems, you should talk to yourIBM representative or to your IBMauthorized remarketer.

When you send comments to IBM,you grant IBM a nonexclusive rightto use or distribute your commentsin any way it believes appropriate,without incurring any obligation toyou.

You can send your comments toIBM in any of the following ways:

� By mail, to this address:

Information Development Department (MP095)IBM United Kingdom LaboratoriesHursley ParkWINCHESTER,HampshireSO21 2JNUnited Kingdom

� By fax:

– From outside the U.K., afteryour international accesscode use 44–1962–870229

– From within the U.K., use01962–870229

� Electronically, use theappropriate network ID:

– IBM Mail Exchange:GBIBM2Q9 at IBMMAIL

– IBMLink:HURSLEY(IDRCF)

– Internet:[email protected]

Whichever you use, ensure that youinclude:

� The publication number and title

� The topic to which yourcomment applies

� Your name andaddress/telephone number/faxnumber/network ID.

Copyright IBM Corp. 1989, 1999 481

Page 502: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

IBM

Program Number: 5655-147

Printed in the United States of Americaon recycled paper containing 10%recovered post-consumer fiber.

SX33-61ð4-ð2

Page 503: CICS User’s Handbook - Freetesta.roberta.free.fr/My Books/Mainframe/CICS/IBM - CICS User's... · CICS User’s Handbook Release 3 SX33-6104-02. CICS Transaction Server for OS/390

Spine information:

IBM CICS TS for OS/390 CICS User’s Handbook Release 3