cics user’s handbook -...

451
CICS ® Transaction Server for OS/390 ® CICS User’s Handbook Release 3 SX33-6104-33

Upload: dodieu

Post on 28-Aug-2018

225 views

Category:

Documents


0 download

TRANSCRIPT

CICS® Transaction Server forOS/390®

CICS User’s HandbookRelease 3

SX33-6104-33

���

CICS® Transaction Server for OS/390®

CICS User’s HandbookRelease 3

SX33-6104-33

���

Note!Before using this information and the product it supports, be sure to read the general information under “Notices” onpage v.

Third edition (June 1999)

This edition applies to Release 3 of CICS Transaction Server for OS/390, program number 5655-147, and to allsubsequent versions, releases, and modifications 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-33. The technical changes for this editionare summarized under ″Summary of changes″ and are indicated by a vertical bar to the left of a change.

Order publications through your IBM representative or the IBM branch office serving your locality. Publications arenot stocked at the address given below.

At the back of this publication is a page entitled “Sending your comments to IBM”. If you want to make comments,but the methods described are not available 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 use or distribute the information in anyway it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 1989, 2000. All rights reserved.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Notices . . . . . . . . . . . . . . . vProgramming interface information . . . . . . viTrademarks . . . . . . . . . . . . . . vi

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

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

Handbook structure. . . . . . . . . . . . ix

Bibliography . . . . . . . . . . . . xiCICS Transaction Server for OS/390 . . . . . . xi

CICS books for CICS Transaction Server forOS/390 . . . . . . . . . . . . . . . xiCICSPlex SM books for CICS Transaction Serverfor OS/390 . . . . . . . . . . . . . xiiOther CICS books . . . . . . . . . . . xii

Determining if a publication is current . . . . . xii

Summary of changes . . . . . . . . xvChanges made for CICS Transaction Server forOS/390 Release 3 . . . . . . . . . . . . xvChanges made for CICS Transaction Server forOS/390 Release 2 . . . . . . . . . . . . xvChanges made for CICS/ESA 4.1 edition . . . . xv

Chapter 1. Command-level applicationprogramming . . . . . . . . . . . . 1General format . . . . . . . . . . . . . 1

DL/I command format . . . . . . . . . . 1RPG II command format . . . . . . . . . 1

Restrictions for distributed program link (DPL) . . . 1API command syntax . . . . . . . . . . . 2

Chapter 2. SPI command syntax. . . . 69

Chapter 3. CICS-Supplied Transaction 151

Chapter 4. Resource definition online 189

Chapter 5. DFHCSDUP commands 199

Chapter 6. Front End ProgrammingInterface command reference . . . . 203FEPI application programming . . . . . . . 203

Previously allocated conversation. . . . . . 203Temporary conversation . . . . . . . . . 204Previously allocated conversation. . . . . . 205Temporary conversation . . . . . . . . . 206

FEPI system programming . . . . . . . . . 210

Chapter 7. CICS-value data areas usedby all commands . . . . . . . . . . 219CVDAs and numeric values in alphabetic sequence 219CVDAs and numeric values in numeric sequence 232CVDAs returned by the INQNETNAME|TERMINAL DEVICE command . . . 244

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

Chapter 9. RESP2 values and theirmeanings . . . . . . . . . . . . . 265

Chapter 10. EXEC interface block(EIB) response and function codes . . 359Response codes of EXEC CICS commands. . . . 359

EXEC CICS DISCARD, INQUIRE, PERFORM,and SET commands . . . . . . . . . . 359EXEC CICS DISABLE, ENABLE, and EXTRACTEXIT commands . . . . . . . . . . . 360

Function codes of EXEC CICS commands . . . . 360

Chapter 11. DFH messages . . . . . 369Message Identifiers . . . . . . . . . . . 369

DFHnnnn identifiers . . . . . . . . . . 369DFHccnnnn identifiers . . . . . . . . . 369Action codes . . . . . . . . . . . . 372Severity codes . . . . . . . . . . . . 372

Format of information . . . . . . . . . . 372XMEOUT parameters – . . . . . . . . . 374Route codes – . . . . . . . . . . . . 374Message editing – . . . . . . . . . . . 374Console message reformatting – . . . . . . 374Terminal identifiers – . . . . . . . . . . 375Abend code inserts – . . . . . . . . . . 375Dumps – . . . . . . . . . . . . . . 375Terminology – . . . . . . . . . . . . 376

MVS user abend codes . . . . . . . . . . 376Ordered by abend code . . . . . . . . . 376Ordered by message identifier . . . . . . . 377

Chapter 12. Transaction abend codes 379Format of information . . . . . . . . . . 380

Chapter 13. Transaction abend codes 381

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

Chapter 15. VTAM-associated errors 413

© Copyright IBM Corp. 1989, 2000 iii

VTAM terminal error codes and CICS messagenumbers . . . . . . . . . . . . . . . 413

Chapter 16. System sense codesreceived . . . . . . . . . . . . . 419Action flag settings and default actions ����� . . 421

Chapter 17. VTAM submoduleidentifiers . . . . . . . . . . . . . 423

Chapter 18. AP domain storageclasses . . . . . . . . . . . . . . 427

Sending your comments to IBM . . . 429

iv CICS TS for OS/390: CICS User’s Handbook

Notices

This information was developed for products and services offered in the U.S.A.IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user’s responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany license to these patents. You can send license inquiries, in writing, to:

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

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, 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 any othercountry where such provisions are inconsistent with local law:INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESSFOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions, therefore this statement may not applyto you.

This publication could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact IBM United KingdomLaboratories, MP151, Hursley Park, Winchester, Hampshire, England, SO21 2JN.Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

© Copyright IBM Corp. 1989, 2000 v

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Programming License Agreement, or any equivalent agreementbetween us.

Programming interface informationThis book is intended to help you refer quickly to CICS system administration andoperating information.

This book also documents General-use Programming Interface and AssociatedGuidance Information, Product-sensitive Programming Interface and AssociatedGuidance Information, and Diagnosis, Modification or Tuning Informationprovided by CICS.

General-use programming interfaces allow the customer to write programs thatobtain the services of CICS.

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

Product-sensitive programming interfaces allow the customer installation toperform tasks such as diagnosing, modifying, monitoring, repairing, tailoring, ortuning of CICS. Use of such interfaces creates dependencies on the detailed designor implementation of the IBM software product. Product-sensitive programminginterfaces should be used only for these specialized purposes. Because of theirdependencies on detailed design and implementation, it is to be expected thatprograms written to such interfaces may need to be changed in order to run withnew product releases or versions, or as a result of service.

Product-sensitive Programming Interface and Associated Guidance Information isidentified where it occurs, by an introductory statement to a chapter or section.

Diagnosis, Modification or Tuning Information is provided to help you diagnoseproblems in a CICS system.

Attention: Do not use this Diagnosis, Modification or Tuning Information as aprogramming interface.

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

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

ACF/VTAMCICSCICS OS/2CICS/ESA

CICS/MVSCICS/VSEC/370DB2IBMIBMLink

MVS/ESARACFVSE/ESAVTAM

vi CICS TS for OS/390: CICS User’s Handbook

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

Notices vii

viii CICS TS for OS/390: CICS User’s Handbook

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:v System programmersv CICS or system operatorsv 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.

Handbook structure“Chapter 1. Command-level application programming” on page 1

Gives a summary of command-level application programming commands in CICSTransaction Server for OS/390. For programming information, see the CICSApplication Programming Reference.

“Chapter 2. SPI command syntax” on page 69

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

“Chapter 3. CICS-Supplied Transaction” on page 151

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

“Chapter 4. Resource definition online” on page 189

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

“Chapter 6. Front End Programming Interface command reference” on page 203

Gives a summary of the syntax for front end programming interface commandreferences. For more detailed information, see the CICS Front End ProgrammingInterface User’s Guide.

“CVDAs and numeric values in alphabetic sequence” on page 219

Gives a table of CVDA values. For programming information, see the CICS SystemProgramming Reference manual.

© Copyright IBM Corp. 1989, 2000 ix

“Chapter 8. EXEC interface block (EIB)” on page 249

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

“Chapter 10. EXEC interface block (EIB) response and function codes” onpage 359

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

“Chapter 11. DFH messages” on page 369

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

“Chapter 12. Transaction abend codes” on page 379

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

“Chapter 15. VTAM-associated errors” on page 413

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 423

Gives information about the product-sensitive product interface.

“Chapter 18. AP domain storage classes” on page 427

Shows the valid AP domain storage classes.

x CICS TS for OS/390: CICS User’s Handbook

Bibliography

CICS Transaction Server for OS/390

CICS 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 Program Specification GC33-1707

CICS books for 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-1777

© Copyright IBM Corp. 1989, 2000 xi

CICS DB2 Guide SC33-1939

CICSPlex SM books for CICS Transaction Server for OS/390

GeneralCICSPlex SM Master Index SC33-1812CICSPlex SM Concepts and Planning GC33-0786CICSPlex SM User Interface Guide SC33-0788CICSPlex SM Web User Interface Guide SC34-5403CICSPlex 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

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

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

Determining if a publication is currentIBM regularly updates its publications with new and changed information. Whenfirst published, both hardcopy and BookManager softcopy versions of a publicationare usually in step. However, due to the time required to print and distributehardcopy books, the BookManager version is more likely to have had last-minutechanges made to it before publication.

Subsequent updates will probably be available in softcopy before they are availablein hardcopy. This means that at any time from the availability of a release, softcopyversions should be regarded as the most up-to-date.

For CICS Transaction Server books, these softcopy updates appear regularly on theTransaction Processing and Data Collection Kit CD-ROM, SK2T-0730-xx. Each reissue

xii CICS TS for OS/390: CICS User’s Handbook

of the collection kit is indicated by an updated order number suffix (the -xx part).For example, collection kit SK2T-0730-06 is more up-to-date than SK2T-0730-05. Thecollection kit is also clearly dated on the cover.

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

Bibliography xiii

xiv CICS TS for OS/390: CICS User’s Handbook

Summary of changes

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

Changes made for CICS Transaction Server for OS/390 Release 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 are shownin alphabetic order.

In the section “CVDAs and numeric values in alphabetic sequence” on page 219,tables of CVDA values have been added.

Syntax boxes for EXEC CICS commands are replaced with “railroad” diagrams. Foran explanation of these diagrams, see the CICS Application Programming Referencemanual.

Trace has been removed from this handbook and has been moved into the CICSDiagnosis Reference manual.

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

© Copyright IBM Corp. 1989, 2000 xv

’’

xvi CICS TS for OS/390: CICS User’s Handbook

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, orassembler 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, orPL/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 of anEXEC statement, followed optionally by one or more ELEM statements, coded onan RPG calculation specification form (the C-spec).

Restrictions for distributed program link (DPL)The following commands are not supported in a program running in a resourceregion 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

© Copyright IBM Corp. 1989, 2000 1

API command syntax

ABEND

�� ABENDABCODE(name) CANCEL NODUMP

�#

ADDRESS

�� ADDRESSACEE(ptr-ref) COMMAREA(ptr-ref) CWA(ptr-ref) EIB(ptr-ref)

�TCTUA(ptr-ref) TWA(ptr-ref)

�#

ADDRESS SET

�� ADDRESS SET(data-area) USING(ptr-ref)SET(ptr-ref) USING(data-area)

�#

ALLOCATE (APPC)

�� ALLOCATE SYSID(systemname)PROFILE(name)

PARTNER(name)NOQUEUE STATE(cvda)

�#

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

ALLOCATE (LUTYPE6.1)

�� ALLOCATE SESSION(name)SYSID(systemname) PROFILE(name) NOQUEUE

�#

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

ALLOCATE (MRO)

�� ALLOCATE SYSID(systemname)NOQUEUE STATE(cvda)

�#

Conditions: INVREQ, SYSBUSY, SYSIDERR

ASKTIME

�� ASKTIMEABSTIME(data-area)

�#

API syntax

2 CICS TS for OS/390: CICS User’s Handbook

ASSIGN

�� ASSIGN , ,

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)DS3270(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

API syntax

Chapter 1. Command-level application programming 3

BIF DEEDIT

�� BIF DEEDIT FIELD(data-area)LENGTH(data-value)

�#

Condition: LENGERR

BUILD ATTACH (LUTYPE6.1)

�� BUILD ATTACH ATTACHID(name)PROCESS(name) RESOURCE(name) RPROCESS(name)

�RRESOURCE(name) QUEUE(name) IUTYPE(data-value) DATASTR(data-value)

�RECFM(data-value)

�#

BUILD ATTACH (MRO)

�� BUILD ATTACH ATTACHID(name)PROCESS(name) RESOURCE(name) RPROCESS(name)

�RRESOURCE(name) QUEUE(name) IUTYPE(data-value) DATASTR(data-value)

�RECFM(data-value)

�#

CANCEL

�� CANCELREQID(name)

SYSID(systemname) TRANSID(name)

�#

Conditions: ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR

CHANGE PASSWORD

�� CHANGE PASSWORD(data-value) NEWPASSWORD(data-value) USERID(data-value) �

�ESMREASON(data-area) ESMRESP(data-area)

�#

Conditions: INVREQ, NOTAUTH, USERIDERR

API syntax

4 CICS TS for OS/390: CICS User’s Handbook

CHANGE TASK

�� CHANGE TASKPRIORITY(data-value)

�#

Condition: INVREQ

CONNECT PROCESS (APPC)

�� CONNECT PROCESS CONVID(name)SESSION(name)

PROCNAME(data-area)PROCLENGTH(data-value)

PARTNER(name)

�PIPLIST(data-area)

PIPLENGTH(data-value)

SYNCLEVEL(data-value)STATE(cvda)

�#

Conditions: INVREQ, LENGERR, NOTALLOC, PARTNERIDERR, TERMERR

CONVERSE (APPC)

�� CONVERSECONVID(name)

FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE STATE (cvda)

�#

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

CONVERSE (default)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE DEST(name)

�#

Conditions: LENGERR

API syntax

Chapter 1. Command-level application programming 5

CONVERSE (LUTYPE2/LUTYPE3)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

�ERASE CTLCHAR(data-value)

DEFAULTALTERNATE

STRFIELD

TOLENGTH(data-area)TOFLENGTH(data-area)

�MAXLENGTH(data-value)MAXFLENGTH(data-value)

DEFRESP NOTRUNCATE ASIS�#

Conditions: EOC, LENGERR, TERMERR

CONVERSE (LUTYPE4)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEFRESP MAXLENGTH(data-value)

MAXFLENGTH(data-value)FMH NOTRUNCATE

�#

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

CONVERSE (LUTYPE6.1)

�� CONVERSEFROM(data-area) FROMLENGTH(data-value)

FROMFLENGTH(data-value) FMHCONVID(name)SESSION(name)

�ATTACHID(name)

INTO(data-area)SET(ptr-ref)

TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE DEFRESP

�#

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

API syntax

6 CICS TS for OS/390: CICS User’s Handbook

CONVERSE (MRO)

�� CONVERSECONVID(name)SESSION(name)

ATTACHID(name)�

�FROM(data-area) FROMLENGTH(data-value)

FROMFLENGTH(data-value) FMH

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE DEFRESP

�STATE (cvda)

�#

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

CONVERSE (SCS)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)DEFRESP STRFIELD NOTRUNCATE

�#

Conditions: LENGERR, TERMERR

CONVERSE (System/3)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE DEST(name) ASIS

�#

Conditions: LENGERR

CONVERSE (System/7)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEST(name) ASIS PSEUDOBIN

�#

Condition: LENGERR

API syntax

Chapter 1. Command-level application programming 7

CONVERSE (2260)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE CTLCHAR(data-value)

�LINEADDR(data-value) DEST(name) LEAVEKB

�#

Condition: LENGERR

CONVERSE (2741)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE DEST(name)

�#

Conditions: LENGERR, RDATT, WRBRK

CONVERSE (3270 display)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�ERASE CTLCHAR(data-value)

DEFAULTALTERNATE

STRFIELD

DEST(name) ASIS�#

Condition: LENGERR

API syntax

8 CICS TS for OS/390: CICS User’s Handbook

CONVERSE (3270 logical)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

�ERASE CTLCHAR(data-value)

DEFAULTALTERNATE

STRFIELD

TOLENGTH(data-area)TOFLENGTH(data-area)

�MAXLENGTH(data-value)MAXFLENGTH(data-value)

DEFRESP NOTRUNCATE ASIS�#

Conditions: INVREQ, LENGERR, TERMERR

CONVERSE (3600 BTAM)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE ASIS

�#

Condition: LENGERR

CONVERSE (3600-3601)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) LDC(name)

FMHDEFRESP MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

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

CONVERSE (3600-3614)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEFRESP MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

Conditions: LENGERR, TERMERR

API syntax

Chapter 1. Command-level application programming 9

CONVERSE (3650 interpreter)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEFRESP FMH MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

Conditions: EOC, EODS, INBFMH, LENGERR, TERMERR

CONVERSE (3650-3270)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) CTLCHAR(data-value) ERASE

DEFAULTALTERNATE

DEFRESP FMH�

�MAXLENGTH(data-value)MAXFLENGTH(data-value)

NOTRUNCATE�#

Conditions: LENGERR, TERMERR

CONVERSE (3650-3653)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEFRESP MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

Conditions: EOC, LENGERR, TERMERR

CONVERSE (3650-3680)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) FMH DEFRESP MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

Conditions: LENGERR, TERMERR

API syntax

10 CICS TS for OS/390: CICS User’s Handbook

CONVERSE (3735)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE ASIS

�#

Conditions: EOF, LENGERR

CONVERSE (3740)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE ASIS

�#

Condition: LENGERR

CONVERSE (3767)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEFRESP MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

Conditions: EOC, LENGERR, SIGNAL, TERMERR

CONVERSE (3770)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEFRESP FMH MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

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

API syntax

Chapter 1. Command-level application programming 11

CONVERSE (3790 full-function or inquiry)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) FMH DEFRESP MAXLENGTH(data-value)

MAXFLENGTH(data-value)NOTRUNCATE

�#

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

CONVERSE (3790 3270-display)

�� CONVERSE FROM(data-area) FROMLENGTH(data-value)FROMFLENGTH(data-value)

INTO(data-area)SET(ptr-ref)

� TOLENGTH(data-area)TOFLENGTH(data-area) DEFRESP CTLCHAR(data-value)

�ERASE

DEFAULT MAXLENGTH(data-value) NOTRUNCATEALTERNATE MAXFLENGTH(data-value)

�#

Conditions: LENGERR, TERMERR

DELAY

�� DELAY

,

,

INTERVAL(0)

INTERVAL(hhmmss)TIME(hhmmss)

FOR HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

UNTIL HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

REQID(name)�#

Conditions: EXPIRED, INVREQ

API syntax

12 CICS TS for OS/390: CICS User’s Handbook

DELETE

�� DELETE FILE(filename)TOKEN(data-area)RIDFLD(data-area)

keylength

�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

�� DELETEQ TD QUEUE(name)SYSID(systemname)

�#

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

DELETEQ TS

�� DELETEQ TS QUEUE(name)QNAME(name) SYSID(systemname)

�#

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

DEQ

�� DEQ RESOURCE(data-area)LENGTH(data-value)

UOW

MAXLIFETIME(cvda)TASK

�#

Conditions: INVREQ, LENGERR

API syntax

Chapter 1. Command-level application programming 13

DFHMDF (1 of 2)

��fld

DFHMDF �#

DFHMDF

�� ,

,

POS= number(line,column)

LENGTH=numberJUSTIFY=( )

LEFT , BLANKRIGHT ZERO

INITIAL=’char-data’XINIT=hex-data

(1)GINIT=’DBCS-characters’

ATTRB=( att1 att2 )DEFAULT

COLOR=color

BASEPS=

psid

�#

att1:

ASKIP

PROTUNPROT

,NUM

att2:

,, BRTNORM ,DETDRK ,IC

,FSET

Notes:

1 DBCS characters start with a shift-out character X'0E' and end with a shift-in character X'0F'.

API syntax

14 CICS TS for OS/390: CICS User’s Handbook

Minimum BMS:

DFHMDI

�� map DFHMDI �

DFHMDF (2 of 2)

�� ,

,

,

,

,

VALIDN=( )MUSTFILLMUSTENTERTRIGGER

GRPNAME=group-nameOCCURS=numberPICIN=’value’PICOUT=’value’OUTLINE= BOX

,

( )LEFTRIGHTOVERUNDER

NOSOSI=

YESYES

TRANSP=NO

CASE=MIXED

�#

API syntax

Chapter 1. Command-level application programming 15

� , ,

, ,

,

,

,

, ,

SIZE=(line,column) PS= BASETERM=type psid

, ,

CTRL=( ) VALIDN=PRINT MUSTFILLlength MUSTENTERFREEKB TRIGGERALARM COLUMN=numberFRSET LINE=number

NO FIELDS=NOEXTATT= ,

MAPONLYYES MAPATTS=(attr)

DEFAULT ,COLOR=

color DSATTS=(attr)NO OUTLINE= BOX

CURSLOC= ,YESOFF ( )

HILIGHT= LEFTBLINK RIGHTREVERSE OVERUNDERLINE UNDER

NOSOSI=

YESYES

TRANSP=NO

JUSTIFY=BOTTOM

�#

Standard BMS:

DFHMDI

�� ,

,

PARTN=(name), ACTIVATE

OBFMT= YESNOFIELD

DATA=BLOCK

NOTIOAPFX=

YESFLDSEP= char

X’hex-char’

�#

Full BMS:

DFHMDI

API syntax

16 CICS TS for OS/390: CICS User’s Handbook

�� ,

,

SAMECOLUMN=

numberNEXT

NEXTLINE=

numberSAME

JUSTIFY=( jst )HEADER=YESTRAILER=YES

�#

jst:

LEFT

RIGHT , FIRSTLAST

Minimum BMS:

DFHMDX

�� DFHMDX MAPSET= name* ,MODULE=name

,MAP= name*

�,DOCTYPE= ’-//W3C//DTD HTML 3.2//EN’

doctype,TITLE=’title-text’

�,MASTHEAD=url

,’alternate-text’,BACKGROUND=url ,BGCOLOR= color

�,TEXT= color ,LINK= color ,VLINK= color ,ALINK= color

,

,

, key = button ,

,

, bmscolor = color

YES,RESET= NO

’text’

�,SCREENW

,

,

,SUPPRESS=( (row,col) ),HEAD ,FOOT

�,ONLOAD=’text’ ,ONUNLOAD=’text’ NO

,PROPFONT= YES

�#

API syntax

Chapter 1. Command-level application programming 17

Standard BMS:

DFHMSD

�� mapset DFHMSD TYPE= DSECTMAPFINAL

� , ,

,

,

,

,

,

, ,

OUT NOMODE= CURSLOC=

IN YESINOUT OFFLOWER HILIGHT=

FOLD= BLINKUPPER REVERSE

NO UNDERLINETRIGRAPH= PS= BASE

YES psidASM ,

LANG=COBOL VALIDN=COBOL2 MUSTFILLPLI MUSTENTERC TRIGGER

USEREXITSTORAGE=AUTO TERM=typeBASE=name SUFFIX=n

, NOTIOAPFX=

CTRL=( ) YESPRINT ,lengthFREEKB MAPATTS=(attr)ALARM ,FRSET

NO DSATTS=(attr)EXTATT= OUTLINE= BOX

MAPONLY ,YESDEFAULT ( )

COLOR= LEFTcolor RIGHTADS OVER

DSECT= UNDERADSL NO

SOSI=YES

YESTRANSP=

NO

�#

API syntax

18 CICS TS for OS/390: CICS User’s Handbook

DFHMSD

�� ,

,

,

,

PARTN=(name), ACTIVATE

LDC=mnemonicNO

OBFMT=YES,

HTAB= tab,

VTAB= tabFIELD

DATA=BLOCK

FLDSEP= charX’hex-char’

�#

DFHPDI

��partn

DFHPDI VIEWPOS=(lines,columns) ,VIEWSZE=(lines,columns) �

� ,

,

BUFSZE=(lines,columns)CHARSZE=(vpels,hpels)MAPSFX=mapset-suffixATTRB=ERROR

�#

DFHPSD

�� partnset DFHPSD ,

,

SUFFIX=user-suffixALTSCRN=(lines,columns)CHARSZE=(vpels,hpels)

�#

DFHWBOUT

�� DFHWBOUT ’text’NO

, SOSI = YES

�#

API syntax

Chapter 1. Command-level application programming 19

DOCUMENT CREATE

�� DOCUMENT CREATE DOCTOKEN(data-area)FROM(data-area) LENGTH(data-value)TEXT(data-area)BINARY(data-area)

FROMDOC(data-area)TEMPLATE(name)

�SYMBOLLIST(data-area) LISTLENGTH(data-value) delun DOCSIZE(data-area)

�HOSTCODEPAGE(name)

�#

delun:

DELIMITER(data-value) UNESCAPED

Conditions: INVREQ, NOTFND, SYMBOLERR, TEMPLATERR

DOCUMENT INSERT

�� DOCUMENT INSERT DOCTOKEN(data-area) TEXT(data-area) LENGTH(data-value)BINARY(data-area)FROM(data-area)

SYMBOL(name)TEMPLATE(name)FROMDOC(data-area)BOOKMARK(name)

�DOCSIZE(data-value) HOSTCODEPAGE(name) AT(name)

TO(name)

�#

Conditions: DUPREC, INVREQ, NOTFND, TEMPLATERR

DOCUMENT RETRIEVE

�� DOCUMENT RETRIEVE DOCTOKEN(data-area) INTO(data-area) LENGTH(data-value) �

� MAXLENGTH(data-value)CLNTCODEPAGE(name) DATAONLY

�#

Conditions: LENGERR, NOTFND

API syntax

20 CICS TS for OS/390: CICS User’s Handbook

DOCUMENT SET

�� DOCUMENT SET DOCTOKEN(data-area) SYMBOL(name)VALUE(data-area)SYMBOLLIST(data-area)

DELIMITER(data-value)

� LENGTH(data-value)UNESCAPED

�#

Conditions: NOTFND, SYMBOLERR

DUMP TRANSACTION

�� DUMP TRANSACTION DUMPCODE(name)FROM(data-area) LENGTH(data-value)

FLENGTH(data-value)COMPLETE

�TRT segmentlist LENGTHLIST(data-area) NUMSEGMENTS(data-area) TASK

�STORAGE PROGRAM TERMINAL TABLES DCT FCT PCT PPT SIT

�TCT DUMPID(data-area)

�#

segmentlist:

SEGMENTLIST(data-area)

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

ENDBR

�� ENDBR FILE(filename)REQID(data-value) SYSID(systemname)

�#

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

ENQ

�� ENQ RESOURCE(data-area)LENGTH(data-value)

UOW

MAXLIFETIME(cvda)TASK

NOSUSPEND�#

Conditions: ENQBUSY, INVREQ, LENGERR

API syntax

Chapter 1. Command-level application programming 21

ENTER TRACENUM

�� ENTER TRACENUM(data-value)FROM(data-area)

FROMLENGTH(data-area)RESOURCE(name)

�EXCEPTION

�#

Conditions: INVREQ, LENGERR

EXTRACT ATTACH (LUTYPE6.1)

�� EXTRACT ATTACHATTACHID(name)CONVID(name)SESSION(name)

PROCESS(data-area) RESOURCE(data-area)�

�RPROCESS(data-area) RRESOURCE(data-area) QUEUE(data-area) IUTYPE(data-area)

�DATASTR(data-area) RECFM(data-area)

�#

Conditions: CBIDERR, INVREQ, NOTALLOC

EXTRACT ATTACH (MRO)

�� EXTRACT ATTACHATTACHID(name)CONVID(name)SESSION(name)

PROCESS(data-area) RESOURCE(data-area)�

�RPROCESS(data-area) RRESOURCE(data-area) QUEUE(data-area) IUTYPE(data-area)

�DATASTR(data-area) RECFM(data-area)

�#

Conditions: CBIDERR, INVREQ, NOTALLOC

EXTRACT ATTRIBUTES (APPC)

�� EXTRACT ATTRIBUTESCONVID(name)

STATE(cvda) �#

Conditions: INVREQ, NOTALLOC

API syntax

22 CICS TS for OS/390: CICS User’s Handbook

EXTRACT ATTRIBUTES (MRO)

�� EXTRACT ATTRIBUTESCONVID(name)SESSION(name)

STATE(cvda) �#

Conditions: INVREQ, NOTALLOC

EXTRACT CERTIFICATE

�� EXTRACT CERTIFICATE(ptr-ref)LENGTH(data-area) SERIALNUM(ptr-ref)

�SERIALNUMLEN(data-area) USERID(ptr-ref)

OWNER

ISSUER COMMONNAME(ptr-ref)�

�COMMONNAMLEN(data-area) COUNTRY(ptr-ref) COUNTRYLEN(data-area) STATE(ptr-ref)

�STATELEN(data-area) LOCALITY(ptr-ref) LOCALITYLEN(data-area)

�ORGANIZATION(ptr-ref) ORGANIZATLEN(data-area) ORGUNIT(ptr-ref)

�ORGUNITLEN(data-area)

�#

Conditions: INVREQ, LENGERR

EXTRACT LOGONMSG

�� EXTRACT LOGONMSG INTO(data-area)SET(ptr-ref)

LENGTH(data-area) �#

Condition: NOTALLOC

API syntax

Chapter 1. Command-level application programming 23

EXTRACT PROCESS (APPC)

�� EXTRACT PROCESSPROCNAME(data-area) PROCLENGTH(data-area) maxproclen

�CONVID(name) SYNCLEVEL(data-area) PIPLIST(ptr-ref) PIPLENGTH(data-area)

�#

maxproclen:

MAXPROCLEN(data-value)

Conditions: INVREQ, LENGERR, NOTALLOC

EXTRACT TCT

�� EXTRACT TCT NETNAME(name)SYSID(systemname)TERMID(data-area)

�#

Condition: INVREQ, NOTALLOC

FORMATTIME

�� FORMATTIME ABSTIME(data-area)DATE(data-area) FULLDATE(data-area)

�DATEFORM(data-area) DATESEP

(data-value)DAYCOUNT(data-area)

�DAYOFMONTH(data-area) DAYOFWEEK(data-area) DDMMYY(data-area)

�DDMMYYYY(data-area) MMDDYY(data-area) MMDDYYYY(data-area)

�MONTHOFYEAR(data-area) TIME(data-area)

TIMESEP(data-value)

�YEAR(data-area) YYDDD(data-area) YYDDMM(data-area)

�YYMMDD(data-area) YYYYDDD(data-area) YYYYDDMM(data-area) YYYYMMDD(data-area)

�#

Condition: INVREQ

API syntax

24 CICS TS for OS/390: CICS User’s Handbook

FREE

�� FREE �#

Condition: NOTALLOC

FREE (APPC)

�� FREECONVID(name) STATE(cvda)

�#

Conditions: INVREQ, NOTALLOC

FREE (LUTYPE6.1)

�� FREECONVID(name)SESSION(name)

�#

Conditions: INVREQ, NOTALLOC

FREE (MRO)

�� FREECONVID(name)SESSION(name)

STATE(cvda)�#

Conditions: INVREQ, NOTALLOC

FREEMAIN

�� FREEMAIN DATA(data-area)DATAPOINTER(ptr-value)

�#

Condition: INVREQ

GDS ALLOCATE (APPC basic)

�� GDS ALLOCATE SYSID(systemname)MODENAME(name)

PARTNER(name)

CONVID(data-area) RETCODE(data-area) �

�NOQUEUE STATE(cvda)

�#

API syntax

Chapter 1. Command-level application programming 25

GDS ASSIGN (APPC basic)

�� GDS ASSIGNPRINCONVID(data-area) PRINSYSID(data-area)

RETCODE(data-area) �#

GDS CONNECT PROCESS (APPC basic)

�� GDS CONNECT PROCESS CONVID(name) PROCNAME(name)PROCLENGTH(data-value)

PARTNER(name)

�PIPLIST(data-area)

PIPLENGTH(data-value)

SYNCLEVEL(data-value) CONVDATA(data-area) �

� RETCODE(data-area)STATE(cvda)

�#

GDS EXTRACT ATTRIBUTES (APPC basic)

�� GDS EXTRACT ATTRIBUTES CONVID(name)STATE(cvda)

CONVDATA(data-area) RETCODE(data-area) �#

GDS EXTRACT PROCESS (APPC basic)

�� GDS EXTRACT PROCESS CONVID(name) �

�PROCNAME(data-area) PROCLENGTH(data-area) maxproclen SYNCLEVEL(data-area)

�PIPLIST(pointer-ref) PIPLENGTH(data-area)

RETCODE(data-area) �#

maxproclen:

MAXPROCLEN(data-value)

GDS FREE (APPC basic)

�� GDS FREE CONVID(name) CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

GDS ISSUE ABEND (APPC basic)

�� GDS ISSUE ABEND CONVID(name) CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

API syntax

26 CICS TS for OS/390: CICS User’s Handbook

GDS ISSUE CONFIRMATION (APPC basic)

�� GDS ISSUE CONFIRMATION CONVID(name) CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

GDS ISSUE ERROR (APPC basic)

�� GDS ISSUE ERROR CONVID(name) CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

GDS ISSUE PREPARE (APPC basic)

�� GDS ISSUE PREPARE CONVID(name) CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

GDS ISSUE SIGNAL (APPC basic)

�� GDS ISSUE SIGNAL CONVID(name) CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

GDS RECEIVE (APPC basic)

�� GDS RECEIVE CONVID(name) INTO(data-area)SET(pointer-ref)

FLENGTH(data-area)MAXFLENGTH(data-value)

� BUFFERLLID

CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

GDS SEND (APPC basic)

�� GDS SEND CONVID(name)FROM(data-area) FLENGTH(data-value) INVITE

LASTCONFIRMWAIT

� CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

GDS WAIT (APPC basic)

�� GDS WAIT CONVID(name) CONVDATA(data-area) RETCODE(data-area)STATE(cvda)

�#

API syntax

Chapter 1. Command-level application programming 27

GETMAIN

�� GETMAIN SET(ptr-ref) FLENGTH(data-value)BELOW

LENGTH(data-value)INITIMG(data-value) SHARED

�NOSUSPEND USERDATAKEY

CICSDATAKEY

�#

Conditions: LENGERR, NOSTG

HANDLE ABEND

�� HANDLE ABENDCANCEL

PROGRAM(name)LABEL(label)RESET

�#

Conditions: NOTAUTH, PGMIDERR (PROGRAM only)

HANDLE AID

�� HANDLE AID ,

ANYKEY(label)

CLEAR(label)

CLRPARTN(label)

ENTER(label)

LIGHTPEN(label)

OPERID(label)

PA1-PA3(label)

PF1-PF24(label)

TRIGGER(label)

�#

Condition: INVREQ

API syntax

28 CICS TS for OS/390: CICS User’s Handbook

HANDLE CONDITION

�� HANDLE CONDITION , condition(label)

�#

IGNORE CONDITION

�� IGNORE CONDITION , condition �#

ISSUE ABEND (APPC)

�� ISSUE ABENDCONVID(name) STATE(cvda)

�#

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ABORT

�� ISSUE ABORTDESTID(data-value)

DESTIDLENG(data-value)CONSOLE

SUBADDR(data-value)PRINTCARDWPMEDIA1WPMEDIA2WPMEDIA3WPMEDIA4

�VOLUME(data-value)

VOLUMELENG(data-value)

�#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

API syntax

Chapter 1. Command-level application programming 29

ISSUE ADD

�� ISSUE ADD DESTID(data-value)DESTIDLENG(data-value)

� VOLUME(data-value)VOLUMELENG(data-value)

FROM(data-area)LENGTH(data-value)

�NUMREC(data-value) DEFRESP NOWAIT RIDFLD(data-area) RRN

�#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE CONFIRMATION (APPC)

�� ISSUE CONFIRMATIONCONVID(name) STATE(cvda)

�#

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE COPY (3270 display)

�� ISSUE COPY TERMID(name)CTLCHAR(data-value) WAIT

�#

Condition: NOTALLOC, TERMIDERR

ISSUE COPY (3270 logical)

�� ISSUE COPY TERMID(name)CTLCHAR(data-value) WAIT

�#

Conditions: LENGERR, NOTALLOC, TERMERR

ISSUE DISCONNECT (default)

�� ISSUE DISCONNECT �#

Conditions: SIGNAL, TERMERR

ISSUE DISCONNECT (LUTYPE6.1)

�� ISSUE DISCONNECTSESSION(name)

�#

Conditions: NOTALLOC, TERMERR

API syntax

30 CICS TS for OS/390: CICS User’s Handbook

ISSUE END

�� ISSUE ENDDESTID(data-value)

DESTIDLENG(data-value)CONSOLE

SUBADDR(data-value)PRINTCARDWPMEDIA1WPMEDIA2WPMEDIA3WPMEDIA4

�VOLUME(data-value)

VOLUMELENG(data-value)

�#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ENDFILE

�� ISSUE ENDFILEENDOUTPUT

�#

Condition: INVREQ, NOTALLOC

ISSUE ENDOUTPUT

�� ISSUE ENDOUTPUTENDFILE

�#

Condition: INVREQ, NOTALLOC

ISSUE EODS

�� ISSUE EODS �#

Conditions: INVREQ, NOTALLOC, TERMERR

API syntax

Chapter 1. Command-level application programming 31

ISSUE ERASE

�� ISSUE ERASE DESTID(data-value)DESTIDLENG(data-value)

� VOLUME(data-value)VOLUMELENG(data-value)

RIDFLD(data-area) �

� KEYLENGTH(data-value)KEYNUMBER(data-value)

RRNNUMREC(data-value) DEFRESP

�NOWAIT

�#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ERASEAUP

�� ISSUE ERASEAUPWAIT

�#

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ERROR (APPC)

�� ISSUE ERRORCONVID(name) STATE(cvda)

�#

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE LOAD

�� ISSUE LOAD PROGRAM(name)CONVERSE

�#

Conditions: NONVAL, NOTALLOC, NOSTART, TERMERR

ISSUE NOTE

�� ISSUE NOTE DESTID(data-value)DESTIDLENG(data-value)

� VOLUME(data-value)VOLUMELENG(data-value)

RIDFLD(data-area) RRN �#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

API syntax

32 CICS TS for OS/390: CICS User’s Handbook

ISSUE PASS

�� ISSUE PASS LUNAME(name)FROM(data-area) LENGTH(data-value) LOGMODE(data-value)

LOGONLOGMODE

�NOQUIESCE

�#

Conditions: INVREQ, LENGERR, NOTALLOC

ISSUE PREPARE (APPC)

�� ISSUE PREPARECONVID(name) STATE(cvda)

�#

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE PRINT

�� ISSUE PRINT �#

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE QUERY

�� ISSUE QUERY DESTID(data-value)DESTIDLENG(data-value)

�VOLUME(data-value)

VOLUMELENG(data-value)

�#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE RECEIVE

�� ISSUE RECEIVE INTO(data-area)SET(ptr-ref) LENGTH(data-area)

�#

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

API syntax

Chapter 1. Command-level application programming 33

ISSUE REPLACE

�� ISSUE REPLACE DESTID(data-value)DESTIDLENG(data-value)

�VOLUME(data-value)

VOLUMELENG(data-value)

FROM(data-area)LENGTH(data-value)

�NUMREC(data-value)

RIDFLD(data-area) KEYLENGTH(data-value)KEYNUMBER(data-value)

RRN

�DEFRESP NOWAIT

�#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE RESET

�� ISSUE RESET �#

Condition: INVREQ, NOTALLOC

ISSUE SEND

�� ISSUE SENDDESTID(data-value)

DESTIDLENG(data-value)CONSOLE

SUBADDR(data-value)PRINTCARDWPMEDIA1WPMEDIA2WPMEDIA3WPMEDIA4

�VOLUME(data-value)

VOLUMELENG(data-value)

FROM(data-area)LENGTH(data-value)

�NOWAIT DEFRESP

�#

Conditions: FUNCERR, IGREQCD, INVREQ, SELNERR, UNEXPIN

API syntax

34 CICS TS for OS/390: CICS User’s Handbook

ISSUE SIGNAL (APPC)

�� ISSUE SIGNALCONVID(name) STATE(cvda)

�#

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE SIGNAL (LUTYPE6.1)

�� ISSUE SIGNALCONVID(name)SESSION(name)

�#

Conditions: NOTALLOC, TERMERR

ISSUE WAIT

�� ISSUE WAITDESTID(data-value)

DESTIDLENG(data-value)CONSOLE

SUBADDR(data-value)PRINTCARDWPMEDIA1WPMEDIA2WPMEDIA3WPMEDIA4

�VOLUME(data-value)

VOLUMELENG(data-value)

�#

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

LINK

�� LINK PROGRAM(name)COMMAREA(data-area) lengths

�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

API syntax

Chapter 1. Command-level application programming 35

LOAD

�� LOAD PROGRAM(name)SET(ptr-ref) LENGTH(data-area)

FLENGTH(data-area)ENTRY(ptr-ref) HOLD

�#

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR

MONITOR

�� MONITOR POINT(data-value)DATA1(data-area) DATA2(data-area) ENTRYNAME(data-area)

�#

Condition: INVREQ

POINT

�� POINTCONVID(name)SESSION(name)

�#

Condition: NOTALLOC

POP HANDLE

�� POP HANDLE �#

Condition: INVREQ

POST

�� POST

,

,

INTERVAL(0)

INTERVAL(hhmmss)TIME(hhmmss)

AFTER HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

AT HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

SET(ptr-ref)REQID(name)

�#

Conditions: EXPIRED, INVREQ

API syntax

36 CICS TS for OS/390: CICS User’s Handbook

PURGE MESSAGE

�� PURGE MESSAGE �#

Conditions: Full BMS: INVREQ, TSIOERR

PUSH HANDLE

�� PUSH HANDLE �#

QUERY SECURITY

�� QUERY SECURITY RESTYPE(data-value)RESCLASS(data-value) RESIDLENGTH(data-value)

RESID(data-value) �

�LOGMESSAGE(cvda) READ(cvda) UPDATE(cvda) CONTROL(cvda) ALTER(cvda)

�#

Conditions: INVREQ, LENGERR, NOTFND, QIDERR

READ

�� READ FILE(filename)UNCOMMITTED

CONSISTENTREPEATABLEUPDATE

TOKEN(data-area)

INTO(data-area)SET(ptr-ref)

�LENGTH(data-area)

RIDFLD(data-area)KEYLENGTH(data-value)

GENERIC

�SYSID(systemname) RBA

RRNDEBKEYDEBREC

EQUAL

GTEQ NOSUSPEND�#

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

API syntax

Chapter 1. Command-level application programming 37

READNEXT

�� READNEXT FILE(filename) INTO(data-area)SET(ptr-ref)

UNCOMMITTED

CONSISTENTREPEATABLEUPDATE TOKEN(data-area)

�LENGTH(data-area)

RIDFLD(data-area)KEYLENGTH(data-value) REQID(data-value)

�SYSID(systemname) RBA

RRNNOSUSPEND

�#

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

READPREV

�� READPREV FILE(filename) INTO(data-area)SET(ptr-ref)

UNCOMMITTED

CONSISTENTREPEATABLEUPDATE TOKEN(data-area)

�LENGTH(data-area)

RIDFLD(data-area)KEYLENGTH(data-value) REQID(data-value)

�SYSID(systemname) RBA

RRNNOSUSPEND

�#

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

READQ TD

�� READQ TD QUEUE(name) INTO(data-area)SET(ptr-ref) LENGTH(data-area) SYSID(systemname)

�NOSUSPEND

�#

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

API syntax

38 CICS TS for OS/390: CICS User’s Handbook

READQ TS

�� READQ TS QUEUE(name)QNAME(name)

INTO(data-area)SET(ptr-ref) LENGTH(data-area) NUMITEMS(data-area)

�NEXT

ITEM(data-value) SYSID(systemname)�#

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

RECEIVE (APPC)

�� RECEIVECONVID(name)

INTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area)

�MAXLENGTH(data-value)MAXFLENGTH(data-value)

NOTRUNCATE STATE(cvda)�#

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

RECEIVE (default)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-value) FLENGTH(data-value) �

�MAXLENGTH(data-area)

NOTRUNCATE �#

Conditions: INVREQ, LENGERR, NOTALLOC

RECEIVE (LUTYPE2/LUTYPE3)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)ASIS

�BUFFER NOTRUNCATE

�#

Conditions: EOC, INVREQ, LENGERR, TERMERR

API syntax

Chapter 1. Command-level application programming 39

RECEIVE (LUTYPE4)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

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

RECEIVE (LUTYPE6.1)

�� RECEIVESESSION(name)

INTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area)

�MAXLENGTH(data-value)MAXFLENGTH(data-value)

NOTRUNCATE�#

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

RECEIVE (MRO)

�� RECEIVESESSION(name)

INTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area)

�MAXLENGTH(data-value)MAXFLENGTH(data-value)

NOTRUNCATE STATE(cvda)�#

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

RECEIVE (System/3)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE ASIS

�#

Conditions: INVREQ, LENGERR

API syntax

40 CICS TS for OS/390: CICS User’s Handbook

RECEIVE (System/7)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) PSEUDOBIN ASIS

�#

Conditions: INVREQ, LENGERR

RECEIVE (2260)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE LEAVEKB

�#

Conditions: INVREQ, LENGERR

RECEIVE (2741)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

Conditions: INVREQ, LENGERR, RDATT

RECEIVE (2980)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

PASSBK �#

Conditions: INVREQ, LENGERR, NOPASSBKRD

API syntax

Chapter 1. Command-level application programming 41

RECEIVE (3270 display)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE ASIS BUFFER

�#

Conditions: INVREQ, LENGERR

RECEIVE (3270 logical)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)ASIS

�BUFFER NOTRUNCATE

�#

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE (3600 BTAM)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

Conditions: INVREQ, LENGERR

RECEIVE (3600 pipeline)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

Conditions: INVREQ, LENGERR, NOTALLOC

API syntax

42 CICS TS for OS/390: CICS User’s Handbook

RECEIVE (3600-3601)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

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

RECEIVE (3600-3614)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE (3650)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

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

RECEIVE (3735)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

Conditions: EOF, INVREQ, LENGERR

API syntax

Chapter 1. Command-level application programming 43

RECEIVE (3740)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

Conditions: EOF, ENDINPT, INVREQ, LENGERR

RECEIVE (3767)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

Conditions: EOC, INVREQ, LENGERR, SIGNAL, TERMERR

RECEIVE (3770)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

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

RECEIVE (3790 full-function or inquiry)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)

�NOTRUNCATE

�#

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

API syntax

44 CICS TS for OS/390: CICS User’s Handbook

Standard and full BMS:

RECEIVE (3790 3270-display)

�� RECEIVEINTO(data-area)SET(ptr-ref)

LENGTH(data-area)FLENGTH(data-area) MAXLENGTH(data-value)

MAXFLENGTH(data-value)ASIS

�BUFFER NOTRUNCATE

�#

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE MAP

�� RECEIVE MAP(name)MAPSET(name) INTO(data-area)

SET(ptr-ref)

�TERMINAL

FROM(data-area)LENGTH(data-value)

TERMINALASIS INPARTN(name)

�#

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

Note: INPARTN is supported by Standard and full BMS

RECEIVE MAP MAPPINGDEV

�� RECEIVE MAP(name) MAPPINGDEV(data-value) FROM(data-area)LENGTH(data-value)

�MAPSET(name) INTO(data-area)

SET(ptr-ref)

�#

Conditions: INVMPSZ, INVREQ, MAPFAIL,

RECEIVE PARTN

�� RECEIVE PARTN(data-area) �#

RECEIVE PARTN

�� INTO(data-area)SET(ptr-ref)

LENGTH(data-value)ASIS

�#

Conditions: EOC, EODS, INVPARTN, INVREQ, LENGERR

API syntax

Chapter 1. Command-level application programming 45

RELEASE

�� RELEASE PROGRAM(name) �#

Conditions: INVREQ, NOTAUTH, PGMIDERR

RESETBR

�� RESETBR FILE(filename) RIDFLD(data-area)KEYLENGTH(data-value)

GENERIC

�REQID(data-value) SYSID(systemname)

GTEQ

EQUAL RBARRN

�#

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

RETRIEVE

�� RETRIEVE INTO(data-area)SET(ptr-ref) LENGTH(data-area) RTRANSID(data-area)

�RTERMID(data-area) QUEUE(data-area) WAIT

�#

Conditions: ENDDATA, ENVDEFERR, INVREQ, IOERR, LENGERR, NOTFND

RETURN

�� RETURNTRANSID(name)

commarea IMMEDIATE

�INPUTMSG(data-area)

INPUTMSGLEN(data-value)ENDACTIVITY

�#

commarea:

COMMAREA(data-area)LENGTH(data-value)

Conditions: INVREQ, LENGERR

API syntax

46 CICS TS for OS/390: CICS User’s Handbook

REWRITE

�� REWRITE FILE(filename)TOKEN(data-area)

FROM(data-area)LENGTH(data-value)

�SYSID(systemname) NOSUSPEND

�#

Conditions: CHANGED, DUPREC, FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ, LENGERR,LOCKED, NOSPACE, NOTAUTH, NOTFND, RECORDBUSY, SYSIDERR

ROUTE

�� ROUTE

,

,

INTERVAL(0)

INTERVAL(hhmmss)TIME(hhmmss)

AFTER HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

AT HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

ERRTERM(name)

TITLE(data-area)�

�LIST(data-area) OPCLASS(data-area) REQID(name) LDC(name) NLEOM

�#

Conditions: IGREQID, INVERRTERM, INVLDC, INVREQ, RTEFAIL, RTESOME

SEND (APPC)

�� SENDCONVID(name) FROM(data-area) LENGTH(data-value)

FLENGTH(data-value)INVITELAST

CONFIRMWAIT

�STATE(cvda)

�#

Conditions: INVREQ, LENGERR, NOTALLOC, SIGNAL, TERMERR

SEND (default)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) DEST(name) WAIT

�#

Conditions: INVREQ, LENGERR, NOTALLOC

API syntax

Chapter 1. Command-level application programming 47

SEND (LUTYPE2/LUTYPE3)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LAST

�ERASE CTLCHAR(data-value)

DEFAULTALTERNATE

STRFIELD

DEFRESP�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (LUTYPE4)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

FMH�#

Conditions: INVREQ, IGREQCD, LENGERR, SIGNAL, TERMERR

SEND (LUTYPE6.1)

�� SENDSESSION(name) WAIT INVITE

LASTATTACHID(name) FROM(data-area)

�LENGTH(data-value)FLENGTH(data-value)

FMH DEFRESP�#

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

SEND (MRO)

�� SENDSESSION(name) WAIT INVITE

LASTATTACHID(name) FROM(data-area)

�LENGTH(data-value)FLENGTH(data-value)

FMH DEFRESP STATE(cvda)�#

Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, TERMERR

API syntax

48 CICS TS for OS/390: CICS User’s Handbook

SEND (SCS)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

�STRFIELD FMH

�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (System/3)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) DEST(name) WAIT ASIS

�CNOTCOMPL

�#

Conditions: INVREQ, LENGERR

SEND (System/7)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) DEST(name) WAIT PSEUDOBIN

�ASIS

�#

Conditions: INVREQ, LENGERR

SEND (2260)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) CTLCHAR(data-value) DEST(name)

�LINEADDR(data-value) WAIT LEAVEKB

�#

Conditions: INVREQ, LENGERR

SEND (2741)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) DEST(name) WAIT

�#

Conditions: INVREQ, LENGERR, WRBRK

API syntax

Chapter 1. Command-level application programming 49

SEND (2980)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) DEST(name)

PASSBKCBUFF

�#

Conditions: INVREQ, LENGERR, NOPASSBKWR

SEND (3270 display)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) DEST(name) WAIT

�ERASE CTLCHAR(data-value)

DEFAULTALTERNATE

STRFIELD

�#

Conditions: INVREQ, LENGERR

SEND (3270 logical)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LAST

�ERASE CTLCHAR(data-value)

DEFAULTALTERNATE

STRFIELD

DEFRESP�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (3600 BTAM)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT ASIS

�#

Conditions: INVREQ, LENGERR

SEND (3600 pipeline)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT

�#

Conditions: INVREQ, LENGERR, TERMERR

API syntax

50 CICS TS for OS/390: CICS User’s Handbook

SEND (3600-3601)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) LDC(name)

FMHWAIT INVITE

LAST

�CNOTCOMPLDEFRESP

�#

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3600-3614)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650 interpreter)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTDEFRESP FMH

�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3270)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) CTLCHAR(data-value) WAIT

�ERASE

DEFAULTALTERNATE

INVITELAST

CNOTCOMPLDEFRESP

FMH�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3653)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

�#

Conditions: INVREQ, LENGERR, TERMERR

API syntax

Chapter 1. Command-level application programming 51

SEND (3650-3680)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

FMH�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (3735)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT ASIS

�#

Conditions: INVREQ, LENGERR

SEND (3740)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT ASIS

�#

Conditions: INVREQ, LENGERR

SEND (3767)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

�#

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3770)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

FMH�#

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3790 full-function or inquiry)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

FMH�#

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

API syntax

52 CICS TS for OS/390: CICS User’s Handbook

Minimum BMS:

Standard BMS:

SEND (3790 SCS)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) WAIT INVITE

LASTCNOTCOMPLDEFRESP

�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (3790 3270-display)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) CTLCHAR(data-value) WAIT

�ERASE

DEFAULTALTERNATE

INVITELAST

DEFRESP�#

Conditions: INVREQ, LENGERR, TERMERR

SEND (3790 3270-printer)

�� SEND FROM(data-area) LENGTH(data-value)FLENGTH(data-value) CTLCHAR(data-value) WAIT

�ERASE

DEFAULTALTERNATE

INVITELAST

DEFRESP�#

Conditions: INVREQ, LENGERR, TERMERR

SEND CONTROL

�� SEND CONTROL �#

SEND CONTROL

��CURSOR

(data-value)FORMFEED ERASE

DEFAULTALTERNATE

ERASEAUP

PRINT FREEKB�

�ALARM FRSET

�#

API syntax

Chapter 1. Command-level application programming 53

Full BMS:

Minimum BMS:

Standard BMS:

Full BMS:

SEND CONTROL

��MSR(data-value) OUTPARTN(name) ACTPARTN(name)

LDC(name)

�#

SEND CONTROL

��ACCUM

TERMINAL

SET(ptr-ref)PAGINGTERMINAL

WAIT LAST

REQID(name)

HONEOM

L40L64L80

�#

Conditions: IGREQCD, IGREQID, INVLDC, INVPARTN, INVREQ, RETPAGE, TSIOERR, WRBRK

SEND MAP

�� SEND MAP(name) �#

SEND MAP

��MAPSET(name) FROM(data-area) DATAONLY LENGTH(data-value)

MAPONLY

�CURSOR

(data-value)FORMFEED ERASE

DEFAULTALTERNATE

ERASEAUP

PRINT FREEKB�

�ALARM FRSET

�#

SEND MAP

��NLEOM MSR(data-value) FMHPARM(name) OUTPARTN(name) ACTPARTN(name)

LDC(name)

�#

API syntax

54 CICS TS for OS/390: CICS User’s Handbook

Minimum BMS:

SEND MAP

��ACCUM

TERMINAL

SET(ptr-ref)PAGINGTERMINAL

WAIT LAST

REQID(name) NOFLUSH

HONEOM

L40L64L80

�#

Conditions: IGREQCD, IGREQID, INVLDC, INVMPSZ, INVPARTN, INVREQ, OVERFLOW, RETPAGE, TSIOERR,WRBRK

SEND MAP

�� SEND MAP(name) MAPPINGDEV(data-value) SET(ptr-ref)MAPSET(name)

�FROM(data-area) DATAONLY LENGTH(data-value)

MAPONLYCURSOR

(data-value)

�FORMFEED ERASE

ERASEAUPPRINT FREEKB ALARM FRSET

�#

Conditions: INVMPSZ, INVREQ

SEND PAGE

�� SEND PAGE RELEASETRANSID(name)

RETAIN

TRAILER(data-area) SET(ptr-ref)�

�AUTOPAGE

CURRENTALL

NOAUTOPAGE

OPERPURGE FMHPARM(name) LAST�#

Conditions: IGREQCD, INVREQ, RETPAGE, TSIOERR, WRBRK

SEND PARTNSET

�� SEND PARTNSET(name)

�#

Conditions: INVPARTNSET, INVREQ

API syntax

Chapter 1. Command-level application programming 55

Standard BMS:

Full BMS:

SEND TEXT

�� SEND TEXT �#

SEND TEXT

�� FROM(data-area)LENGTH(data-value) CURSOR(data-value) FORMFEED

�ERASE

DEFAULTALTERNATE

PRINT FREEKB ALARM NLEOM FMHPARM(name)�

�OUTPARTN(name) ACTPARTN(name)

LDC(name)MSR(data-value)

�#

SEND TEXT

��TERMINAL

SET(ptr-ref)PAGINGTERMINAL

WAIT LAST

REQID(name) HEADER(data-area)�

�TRAILER(data-area) JUSTIFY(data-value)

JUSFIRSTJUSLAST

ACCUM

HONEOM

L40L64L80

�#

Conditions: IGREQCD, IGREQID, INVLDC, INVPARTN, INVREQ, LENGERR, RETPAGE, TSIOERR, WRBRK

SEND TEXT MAPPED

�� SEND TEXT MAPPED FROM(data-area)LENGTH(data-value)

TERMINAL

PAGINGTERMINAL

WAIT LAST

�REQID(name)

�#

Conditions: IGREQCD, IGREQID, INVREQ, TSIOERR, WRBRK

API syntax

56 CICS TS for OS/390: CICS User’s Handbook

SEND TEXT NOEDIT

�� SEND TEXT NOEDIT FROM(data-area)LENGTH(data-value) ERASE

DEFAULTALTERNATE

PRINT�

�FREEKB ALARM OUTPARTN(name)

TERMINAL

TERMINALWAIT LAST

PAGING

REQID(name)�

�HONEOM

L40L64L80

�#

Conditions: IGREQCD, IGREQID, INVREQ, INVPARTN, TSIOERR, WRBRK

SIGNOFF

�� SIGNOFF �#

Condition: INVREQ

SIGNON

�� SIGNON USERID(data-value)ESMREASON(data-area) ESMRESP(data-area)

�GROUPID(data-value) LANGUAGECODE(data-value)

NATLANG(data-value)LANGINUSE(data-area)

�NATLANGINUSE(data-area) PASSWORD(data-value) NEWPASSWORD(data-value)

�OIDCARD(data-value)

�#

Conditions: INVREQ, NOTAUTH, USERIDERR

API syntax

Chapter 1. Command-level application programming 57

SPOOLCLOSE TOKEN

�� SPOOLCLOSE TOKEN(data-area)KEEPDELETE

, NOHANDLERESP

RESP2

�#

Conditions: ALLOCERR, INVREQ, NOSPOOL, NOSTG, NOTFND, NOTOPEN, STRELERR

SPOOLOPEN INPUT

�� SPOOLOPEN INPUT TOKEN(data-area) USERID(data-value)CLASS(data-value)

� , NOHANDLERESP

RESP2

�#

Conditions: ALLOCERR, ILLOGIC, INVREQ, NOSPOOL, NOSTG, NOTAUTH, NOTFND, NOTOPEN, OPENERR,SPOLBUSY, SPOLERR, STRELERR

SPOOLOPEN OUTPUT

�� SPOOLOPEN OUTPUT TOKEN(data-area) USERID(data-value) NODE(data-value)CLASS(data-value)

�OUTDESCR(ptr-ref)

NOCC

ASAMCC

PRINT

PRINTRECORDLENGTH(data-value)

PUNCH

� , NOHANDLERESP

RESP2

�#

Conditions: ALLOCERR, ILLOGIC, INVREQ, LENGERR, NODEIDERR, NOSPOOL, NOSTG, NOTFND, NOTOPEN,OPENERR, OUTDESCERR, SPOLBUSY, STRELERR

API syntax

58 CICS TS for OS/390: CICS User’s Handbook

SPOOLREAD

�� SPOOLREAD TOKEN(data-area) INTO(data-area)MAXFLENGTH(data-value)

�TOFLENGTH(data-area)

, NOHANDLERESP

RESP2

�#

Conditions: ALLOCERR, ENDFILE, ILLOGIC, INVREQ, LENGERR, NOSPOOL, NOSTG, NOTFND, NOTOPEN,SPOLBUSY, SPOLERR, STRELERR

SPOOLWRITE

�� SPOOLWRITE TOKEN(data-area) FROM(data-area)FLENGTH(data-value)

LINE

PAGE�

� , NOHANDLERESP

RESP2

�#

Conditions: ALLOCERR, INVREQ, LENGERR, NOSPOOL, NOSTG, NOTOPEN, SPOLBUSY, SPOLERR, STRELERR

START

�� START TRANSID(name)

,

,

INTERVAL(0)

INTERVAL(hhmmss)TIME(hhmmss)

AFTER HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

AT HOURS(data-value)MINUTES(data-value)SECONDS(data-value)

REQID(name)�

�FROM(data-area) LENGTH(data-value)

FMHTERMID(name)USERID(data-value)

SYSID(systemname)�

�RTRANSID(name) RTERMID(name) QUEUE(name) NOCHECK PROTECT

�#

Conditions: INVREQ, IOERR, ISCINVREQ, LENGERR, NOTAUTH, SYSIDERR, TERMIDERR, TRANSIDERR,USERIDERR

API syntax

Chapter 1. Command-level application programming 59

START ATTACH

�� START ATTACH TRANSID(name)FROM(data-area) LENGTH(data-value)

�#

Conditions: INVREQ, LENGERR, NOTAUTH, TRANSIDERR

START BREXIT

�� START BREXITBREXIT(name)

TRANSID(name)BRDATA(data-area) BRDATALENGTH(data-value)

�USERID(data-value)

�#

Conditions: INVREQ,LENGERR, NOTAUTH, PGMIDERR, TRANSIDERR, USERIDERR

STARTBR

�� STARTBR FILE(filename) RIDFLD(data-area)KEYLENGTH(data-value)

GENERIC

�REQID(data-value) SYSID(systemname)

RBARRNDEBKEYDEBREC

GTEQEQUAL

�#

Conditions: DISABLED, FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ, LOADING, NOTAUTH,NOTFND, NOTOPEN, SYSIDERR

SUSPEND

�� SUSPEND �#

SYNCPOINT

�� SYNCPOINT �#

Conditions: INVREQ, ROLLEDBACK

SYNCPOINT ROLLBACK

�� SYNCPOINT ROLLBACK �#

Condition: INVREQ

API syntax

60 CICS TS for OS/390: CICS User’s Handbook

EXTRACT TCPIP

�� EXTRACT TCPIPCLIENTNAME(data-area) CNAMELENGTH(data-area)

�SERVERNAME(data-area) SNAMELENGTH(data-area)

� CLIENTADDR(data-area) CADDRLENGTH(data-area)CLIENTADDRNU(data-area)SERVERADDR(data-area) SADDRLENGTH(data-area)SERVERADDRNU(data-area)

SSLTYPE(cvda) TCPIPSERVICE(data-area)�

�PORTNUMBER(data-area) PORTNUMNU(data-area)

�#

Conditions: INVREQ, LENGERR

UNLOCK

�� UNLOCK FILE(filename)TOKEN(data-area) SYSID(systemname)

�#

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

VERIFY PASSWORD

�� VERIFY PASSWORD(data-value) USERID(data-value)CHANGETIME(data-area)

�DAYSLEFT(data-area) ESMREASON(data-area) ESMRESP(data-area)

�EXPIRYTIME(data-area) INVALIDCOUNT(data-area) LASTUSETIME(data-area)

�#

Conditions: INVREQ, NOTAUTH, USERIDERR

WAIT CONVID (APPC)

�� WAIT CONVID(name)STATE(cvda)

�#

Conditions: INVREQ, NOTALLOC

API syntax

Chapter 1. Command-level application programming 61

WAIT EVENT

�� WAIT EVENT ECADDR(ptr-value)NAME(name)

�#

Condition: INVREQ

WAIT EXTERNAL

�� WAIT EXTERNAL ECBLIST(ptr-value) NUMEVENTS(data-value)PURGEABLE

PURGEABILITY(cvda)NOTPURGEABLE

NAME(name)�#

Condition: INVREQ

WAIT JOURNALNAME

�� WAIT JOURNALNAME(data-value)REQID(data-value)

�#

Conditions: INVREQ, IOERR, JIDERR, NOTOPEN

WAIT SIGNAL

�� WAIT SIGNAL �#

Conditions: NOTALLOC, SIGNAL, TERMERR

WAIT TERMINAL

�� WAIT TERMINALCONVID(name)SESSION(name)

�#

Conditions: INVREQ, NOTALLOC, SIGNAL

WAITCICS

�� WAITCICS ECBLIST(ptr-value) NUMEVENTS(data-value)PURGEABLE

PURGEABILITY(cvda)NOTPURGEABLE

NAME(name)�#

Condition: INVREQ

API syntax

62 CICS TS for OS/390: CICS User’s Handbook

WEB ENDBROWSE

�� WEB ENDBROWSE HTTPHEADER �#

Conditions: INVREQ

WEB ENDBROWSE FORMFIELD

�� WEB ENDBROWSE FORMFIELD �#

Conditions: INVREQ

WEB EXTRACT

�� WEB EXTRACTHTTPMETHOD(data-area) METHODLENGTH(data-area)

�HTTPVERSION(data-area) VERSIONLEN(data-area) PATH(data-area) PATHLENGTH(data-area)

�REQUESTTYPE(cvda)

�#

Conditions: INVREQ, LENGERR

WEB READ

�� WEB READ HTTPHEADER(data-area) NAMELENGTH(data-value) VALUE(data-area) �

� VALUELENGTH(data-area) �#

Conditions:INVREQ, LENGERR, NOTFND

WEB READ FORMFIELD

�� WEB READ FORMFIELD(data-area) NAMELENGTH(data-value) VALUE(data-area)SET(ptr_ref)

� VALUELENGTH(data-area)CLNTCODEPAGE(name) HOSTCODEPAGE(name)

�#

Conditions:INVREQ, LENGERR, NOTFND

API syntax

Chapter 1. Command-level application programming 63

WEB READNEXT

�� WEB READNEXT HTTPHEADER(data-area) NAMELENGTH(data-area) VALUE(data-area) �

� VALUELENGTH(data-area) �#

Conditions:ENDFILE, INVREQ, LENGERR

WEB READNEXT FORMFIELD

�� WEB READNEXT FORMFIELD(data-area) NAMELENGTH(data-area) VALUE(data-area) �

� VALUELENGTH(data-area) �#

Conditions:ENDFILE, INVREQ, LENGERR

WEB RECEIVE

�� WEB RECEIVE INTO(data-area)SET(ptr-ref)

LENGTH(data-area) MAXLENGTH(data-value)TYPE(cvda)

�NOTRUNCATE CLNTCODEPAGE(name) HOSTCODEPAGE(name)

�#

Conditions:INVREQ, LENGERR

WEB RETRIEVE

�� WEB RETRIEVE DOCTOKEN(data-area) �#

Conditions:INVREQ

WEB SEND

�� WEB SEND DOCTOKEN(name)CLNTCODEPAGE(name) STATUSCODE(data-value)

�STATUSTEXT(data-area) LENGTH(data-value)

�#

Conditions:INVREQ, NOTFND

WEB STARTBROWSE

�� WEB STARTBROWSE HTTPHEADER �#

Conditions:INVREQ

API syntax

64 CICS TS for OS/390: CICS User’s Handbook

WEB STARTBROWSE FORMFIELD

�� WEB STARTBROWSE FORMFIELD(data-area) NAMELENGTH(data-value) �

�CLNTCODEPAGE(name) HOSTCODEPAGE(name)

�#

Conditions:INVREQ

WEB WRITE

�� WEB WRITE HTTPHEADER(data-area) NAMELENGTH(data-value) VALUE(data-area) �

� VALUELENGTH(data-value) �#

Conditions:INVREQ

WRITE

�� WRITE FILE(filename)MASSINSERT

FROM(data-area)LENGTH(data-value)

� RIDFLD(data-area)KEYLENGTH(data-value) SYSID(systemname) RBA

RRNNOSUSPEND

�#

Conditions: DISABLED, DUPREC, FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ, LENGERR,LOADING, LOCKED, NOSPACE, NOTAUTH, NOTOPEN, RECORDBUSY, SUPPRESSED, SYSIDERR

WRITE JOURNALNAME

�� WRITE JOURNALNAME(data-value) JTYPEID(data-value) FROM(data-area)FLENGTH(data-value)

�REQID(data-area) PREFIX(data-value)

PFXLENG(data-value)WAIT NOSUSPEND

�#

Conditions: INVREQ, IOERR, JIDERR, LENGERR, NOJBUFSP, NOTAUTH, NOTOPEN

API syntax

Chapter 1. Command-level application programming 65

WRITE OPERATOR

�� WRITE OPERATOR TEXT(data-value)TEXTLENGTH(data-area)

�ROUTECODES(data-value) NUMROUTES(data-value)

�EVENTUAL

ACTION(cvda)CRITICALIMMEDIATEREPLY(data-area) lengths

TIMEOUT(data-value)

�#

lengths:

MAXLENGTH(data-area)REPLYLENGTH(data-area)

Conditions: EXPIRED, INVREQ, LENGERR

WRITEQ TD

�� WRITEQ TD QUEUE(name) FROM(data-area)LENGTH(data-value) SYSID(systemname)

�#

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

WRITEQ TS

�� WRITEQ TS QUEUE(name)QNAME(name)

FROM(data-area)LENGTH(data-value)

�NUMITEMS(data-area)ITEM(data-area)

REWRITE

SYSID(systemname)

AUXILIARY

MAIN NOSUSPEND�#

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

API syntax

66 CICS TS for OS/390: CICS User’s Handbook

XCTL

�� XCTL PROGRAM(name)COMMAREA(data-area)

LENGTH(data-value)

�INPUTMSG(data-area)

INPUTMSGLEN(data-value)

�#

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR

Chapter 1. Command-level application programming 67

68 CICS TS for OS/390: CICS User’s Handbook

Chapter 2. SPI command syntax

This chapter contains General-use Programming Interface information.

ACQUIRE TERMINAL

�� ACQUIRE TERMINAL(data-value)NOQUEUEQALL

RELREQQNOTENABQSESSLIM

RELREQ

�USERDATA(data-value)

USERDATALEN(data-value)

�#

Conditions: INVREQ, LENGERR, NOTAUTH, TERMIDERR

© Copyright IBM Corp. 1989, 2000 69

COLLECT STATISTICS

�� COLLECT STATISTICS SET(ptr-ref) COL2 COL7 �#

COL7

AUTOINSTALLCOL8

DB2CONNCOL9

DISPATCHERENQUEUEFILE(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)PROGAUTOPROGRAM

(data-value)RECOVERYSTORAGE

(data-value)STREAMNAME(data-value)SYSDUMPCODE

(data-value)TABLEMGRTCLASS(data-value)TCPIPSERVICE(data-value)TDQUEUE

(data-value)TERMINAL(data-value)TRANCLASS(data-value)TRANDUMPCODE

(data-value)TRANSACTION

(data-value)TSQUEUEVTAM

COL9

DB2ENTRY(data-value)

COL8

CONNECTION(data-value)

COL2

LASTRESET(data-area)COL3

COL3

SPI syntax

70 CICS TS for OS/390: CICS User’s Handbook

CREATE CONNECTION

�� CREATE CONNECTION(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value)COMPLETEDISCARD

�#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE CONNECTION

CONNECTION attributes:

ACCESSMETHOD(VTAM)

ACCESSMETHOD(INDIRECT)ACCESSMETHOD(IRC)ACCESSMETHOD(XM)

ATTACHSEC(LOCAL)

ATTACHSEC(IDENTIFY)ATTACHSEC(MIXIDPE)ATTACHSEC(PERSISTENT)ATTACHSEC(VERIFY)

AUTOCONNECT(NO)

AUTOCONNECT(ALL)AUTOCONNECT(YES)

�BINDSECURITY(NO)

BINDSECURITY(YES)

CONNTYPE(SPECIFIC)

CONNTYPE(GENERIC)

DATASTREAM(USER)

DATASTREAM(LMS)DATASTREAM(SCS)DATASTREAM(STRFIELD)DATASTREAM(3270)

DESCRIPTION(char58)�

�INDSYS(char4)

INSERVICE(YES)

INSERVICE(NO)

MAXQTIME(NO)

MAXQTIME(0-9999) NETNAME(char8)�

�PROTOCOL(APPC)PROTOCOL(EXCI)PROTOCOL(LU61)

PSRECOVERY(SYSDEFAULT)

PSRECOVERY(NONE)

QUEUELIMIT(NO)

QUEUELIMIT(0-9999)

RECORDFORMAT(U)

RECORDFORMAT(VB)�

�REMOTESYSNET(char8) REMOTESYSTEM(char4)

REMOTENAME(char4)SECURITYNAME(char8)

�SINGLESESS(NO)

SINGLESESS(YES)

USEDFLTUSER(NO)

USEDFLTUSER(YES)

XLNACTION(KEEP)

XLNACTION(FORCE)

CREATE DB2CONN

�� CREATE DB2CONN(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 71

CREATE DB2CONN

DB2CONN attributes:

DESCRIPTION(char58)

CONNECTERROR(sqlcode)

CONNECTERROR(abend) DB2ID(char4)

MSGQUEUE1(CDB2)

MSGQUEUE1(char4)�

�MSGQUEUE2(char4) MSGQUEUE3(char4)

NONTERMREL(yes)

NONTERMREL(no)

PURGECYCLE(0,30)

PURGECYCLE(0-59,0-59)�

�SIGNID(char8)

STANDBYMODE(reconnect)

STANDBYMODE(noconnect)STANDBYMODE(connect)

STATSQUEUE(CDB2)

STATSQUEUE(char4)

TCBLIMIT(12)

TCBLIMIT(4-2000)�

�THREADERROR(n906d)

THREADERROR(abend)THREADERROR(n906)

ACCOUNTREC(none)

ACCOUNTREC(uow)ACCOUNTREC(task)ACCOUNTREC(txid)

AUTHID(char8)

AUTHTYPE(userid)

AUTHTYPE(group)AUTHTYPE(signid)AUTHTYPE(term)AUTHTYPE(txid)AUTHTYPE(opid)

�DROLLBACK(yes)

DROLLBACK(no) PLAN(char8)�

�PLANEXITNAME(DSNCUEXT)

PLANEXITNAME(char8)

PRIORITY(high)

PRIORITY(equal)PRIORITY(low)

THREADLIMIT(3)

THREADLIMIT(3-2000)

THREADWAIT(yes)

THREADWAIT(no)�

�COMAUTHID(char8)

COMAUTHTYPE(userid)

COMAUTHTYPE(group)COMAUTHTYPE(signid)COMAUTHTYPE(term)COMAUTHTYPE(txid)COMAUTHTYPE(user)

COMTHREADLIM(1)

COMTHREADLIM(0-2000)

CREATE DB2ENTRY

�� CREATE DB2ENTRY(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

72 CICS TS for OS/390: CICS User’s Handbook

CREATE DB2ENTRY

DB2ENTRY attributes:

DESCRIPTION(char58) TRANSID(char4)

ACCOUNTREC(none)

ACCOUNTREC(uow)ACCOUNTREC(task)ACCOUNTREC(txid)

AUTHID(char8)�

�AUTHTYPE(userid)

AUTHTYPE(group)AUTHTYPE(signid)AUTHTYPE(term)AUTHTYPE(txid)AUTHTYPE(opid)

DROLLBACK(yes)

DROLLBACK(no) PLAN(char8)

PLANEXITNAME(DSNCUEXT)

PLANEXITNAME(char8)�

�PRIORITY(high)

PRIORITY(equal)PRIORITY(low)

PROTECTNUM(0)

PROTECTNUM(0-2000)

THREADLIMIT(0)

THREADLIMIT(0-2000)

THREADWAIT(pool)

THREADWAIT(yes)THREADWAIT(no)

CREATE DB2TRAN

�� CREATE DB2TRAN(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DB2TRAN

DB2TRAN attributes:

DESCRIPTION(char58)ENTRY(char8)

TRANSID(char4)

CREATE DOCTEMPLATE

�� CREATE DOCTEMPLATE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 73

CREATE DOCTEMPLATE

DOCTEMPLATE attributes:

APPENDCRLF(YES)

APPENDCRLF(NO) DESCRIPTION(char58)FILE(char8)TSQUEUE(char16)TDQUEUE(char4)PROGRAM(char8)EXITPGM(char8)

DDNAME(DFHHTML)MEMBERNAME(char8)

DDNAME(char8)

�TEMPLATENAME(char48)

CREATE ENQMODEL

�� CREATE ENQMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: INVREQ, LENGERR, NOTAUTH

CREATE ENQMODEL

ENQMODEL attributes:

DESCRIPTION(char58)ENQNAME(char1-255)

ENQSCOPE(char4)

STATUS(ENABLED)

STATUS(DISABLED)

CREATE FILE

�� CREATE FILE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

74 CICS TS for OS/390: CICS User’s Handbook

CREATE FILE

FILE attributes (1/2):

ADD(NO)

ADD(YES)

BACKUPTYPE(STATIC)

BACKUPTYPE(DYNAMIC)

BROWSE(NO)

BROWSE(YES) CFDTPOOL(char8)�

�DATABUFFERS(2)

DATABUFFERS(2-32767)

DELETE(NO)

DELETE(YES) DESCRIPTION(char58)

DISPOSITION(SHARE)

DISPOSITION(OLD)�

�DSNAME(char44)

DSNSHARING(ALLREQS)

DSNSHARING(MODIFYREQS)

FWDRECOVLOG(NO)

FWDRECOVLOG(1-99)

INDEXBUFFERS(1)

INDEXBUFFERS(1-32767)�

�JNLADD(NONE)

JNLADD(AFTER)JNLADD(ALL)JNLADD(BEFORE)

JNLREAD(NONE)

JNLREAD(ALL)JNLREAD(READONLY)JNLREAD(UPDATEONLY)

JNLSYNCREAD(NO)

JNLSYNCREAD(YES)

JNLSYNCWRITE(YES)

JNLSYNCWRITE(NO)�

�JNLUPDATE(NO)

JNLUPDATE(YES)

JOURNAL(NO)

JOURNAL(1-99)

SPI syntax

Chapter 2. SPI command syntax 75

CREATE FILE

FILE attributes (2/2):

KEYLENGTH(1-255|1-16 for CFDT)

LOAD(NO)

LOAD(YES)

LSRPOOLID(1)

LSRPOOLID(NONE)LSRPOOLID(1-8)

�MAXNUMRECS(NOLIMIT)

MAXNUMRECS(1-99999999)NSRGROUP(char8)

OPENTIME(FIRSTREF)

OPENTIME(STARTUP) PASSWORD(char8)�

�READ(YES)

READ(NO)

READINTEG(UNCOMMITTED)

READINTEG(CONSISTENT)READINTEG(REPEATABLE)

RECORDFORMAT(V)

RECORDFORMAT(F) RECORDSIZE(1-32767)�

�RECOVERY(NONE)

RECOVERY(ALL)RECOVERY(BACKOUTONLY)

REMOTESYSTEM(char4)REMOTENAME(char8)

RLSACCESS(NO)

RLSACCESS(YES)�

�STATUS(ENABLED)

STATUS(DISABLED)STATUS(UNENABLED)

STRINGS(1)

STRINGS(1-255)

TABLE(NO)

TABLE(CF)TABLE(CICS)TABLE(USER)

TABLENAME(char8)�

�UPDATE(NO)

UPDATE(YES)

UPDATEMODEL(LOCKING)

UPDATEMODEL(CONTENTION)

CREATE JOURNALMODEL

�� CREATE JOURNALMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE JOURNALMODEL

JOURNALMODEL attributes:

DESCRIPTION(char58) JOURNALNAME(char8)

STREAMNAME(&USERID..&APPLID..&JNAME;)

STREAMNAME(char26)�

�TYPE(MVS)

TYPE(DUMMY)TYPE(SMF)

SPI syntax

76 CICS TS for OS/390: CICS User’s Handbook

CREATE LSRPOOL

�� CREATE LSRPOOL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE LSRPOOL

LSRPOOL attributes:

DATA512(3-32767) DATA1K(3-32767) DATA2K(3-32767) DATA4K(3-32767)�

�DATA8K(3-32767) DATA12K(3-32767) DATA16K(3-32767) DATA20K(3-32767)

�DATA24K(3-32767) DATA28K(3-32767) DATA32K(3-32767) DESCRIPTION(char58)

�HSDATA4K(0-16777215) HSDATA8K(0-16777215) HSDATA12K(0-16777215)

�HSDATA16K(0-16777215) HSDATA20K(0-16777215) HSDATA24K(0-16777215)

�HSDATA28K(0-16777215) HSDATA32K(0-16777215) HSINDEX4K(0-16777215)

�HSINDEX8K(0-16777215) HSINDEX12K(0-16777215) HSINDEX16K(0-16777215)

�HSINDEX20K(0-16777215) HSINDEX24K(0-16777215) HSINDEX28K(0-16777215)

�HSINDEX32K(0-16777215) INDEX512(3-32767) INDEX1K(3-32767) INDEX2K(3-32767)

�INDEX4K(3-32767) INDEX8K(3-32767) INDEX12K(3-32767) INDEX16K(3-32767)

�INDEX20K(3-32767)

�INDEX24K(3-32767) INDEX28K(3-32767) INDEX32K(3-32767)

LSRPOOLID(1)

LSRPOOLID(1-8)�

�MAXKEYLENGTH(0-255)

SHARELIMIT(50)

SHARELIMIT(1-100) STRINGS(1-255)

SPI syntax

Chapter 2. SPI command syntax 77

CREATE MAPSET

�� CREATE MAPSET(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE MAPSET

MAPSET attributes:

DESCRIPTION(char58)

RESIDENT(NO)

RESIDENT(YES)

STATUS(ENABLED)

STATUS(DISABLED)

USAGE(NORMAL)

USAGE(TRANSIENT)�

�USELPACOPY(NO)

USELPACOPY(YES)

CREATE PARTITIONSET

�� CREATE PARTITIONSET(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PARTITIONSET

PARTITIONSET attributes:

DESCRIPTION(char58)

RESIDENT(NO)

RESIDENT(YES)

STATUS(ENABLED)

STATUS(DISABLED)

USAGE(NORMAL)

USAGE(TRANSIENT)�

�USELPACOPY(NO)

USELPACPOY(YES)

CREATE PARTNER

�� CREATE PARTNER(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

78 CICS TS for OS/390: CICS User’s Handbook

CREATE PARTNER

PARTNER attributes:

DESCRIPTION(char58)NETNAME(char8)

NETWORK(char8)

PROFILE(DFHCICSA)

PROFILE(char8)�

� TPNAME(char64)XTPNAME(hex128)

CREATE PROCESSTYPE

�� CREATE PROCESSTYPE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PROCESSTYPE

PROCESSTYPE attributes:

DESCRIPTION(char58)FILE(char8)

AUDITLOG(char8)

AUDITLEVEL(OFF)

AUDITLEVEL(ACTIVITY)AUDITLEVEL(FULL)AUDITLEVEL(PROCESS)

�STATUS(ENABLED)

STATUS(DISABLED)

CREATE PROFILE

�� CREATE PROFILE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 79

CREATE PROFILE

PROFILE attributes:

CHAINCONTROL(NO)

CHAINCONTROL(YES) DESCRIPTION(char58)

DVSUPRT(ALL)

DVSUPRT(NONVTAM)DVSUPRT(VTAM)

INBFMH(NO)

INBFMH(ALL)INBFMH(DIP)INBFMH(EODS)

�JOURNAL(NO)

JOURNAL(1-99)

LOGREC(NO)

LOGREC(YES) MODENAME(char8)

MSGINTEG(NO)

MSGINTEG(YES)

MSGJRNL(NO)

MSGJRNL(INOUT)MSGJRNL(INPUT)MSGJRNL(OUTPUT)

�NEPCLASS(0)

NEPCLASS(0-255)

ONEWTE(NO)

ONEWTE(YES)

PRINTERCOMP(NO)

PRINTERCOMP(YES)

PROTECT(NO)

PROTECT(YES)

RAQ(NO)

RAQ(YES)�

�RTIMOUT(NO)

RTIMOUT(1-7000)

SCRNSIZE(DEFAULT)

SCRNSIZE(ALTERNATE)

UCTRAN(NO)

UCTRAN(YES)

CREATE PROGRAM

�� CREATE PROGRAM(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

80 CICS TS for OS/390: CICS User’s Handbook

CREATE PROGRAM

PROGRAM attributes:

CEDF(YES)

CEDF(NO)

CONCURRENCY(QUASIRENT)

CONCURRENCY(THREADSAFE)

DATALOCATION(BELOW)

DATALOCATION(ANY) DESCRIPTION(char58)�

�EXECKEY(USER)

EXECKEY(CICS)

EXECUTIONSET(FULLAPI)

EXECUTIONSET(DPLSUBSET) JVMCLASS(char255)

JVM(NO)

JVM(DEBUG)JVM(YES)

�LANGUAGE(ASSEMBLER)LANGUAGE(C)LANGUAGE(COBOL)LANGUAGE(LE370)LANGUAGE(PLI)

RELOAD(NO)

RELOAD(YES) REMOTESYSTEM(char4)REMOTENAME(char8)

�RESIDENT(NO)

RESIDENT(YES)

STATUS(ENABLED)

STATUS(DISABLED) TRANSID(char4)

USAGE(NORMAL)

USAGE(TRANSIENT)�

�USELPACOPY(NO)

USELPACOPY(YES)

CREATE REQUESTMODEL

�� CREATE REQUESTMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE REQUESTMODEL

REQUESTMODEL attributes:

DESCRIPTION(char58)OMGMODULE(char58) OMGINTERFACE(char31) OMGOPERATION(char31) �

� TRANSID(char4)

CREATE SESSIONS

�� CREATE SESSIONS(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 81

CREATE SESSIONS

SESSIONS attributes:

AUTOCONNECT(NO)

AUTOCONNECT(ALL)AUTOCONNECT(YES)

BUILDCHAIN(YES)

BUILDCHAIN(NO)CONNECTION(char4)

DESCRIPTION(char58)�

�DISCREQ(NO)

DISCREQ(YES)

IOAREALEN(0,0)

IOAREALEN(0-32767,0-32767)

MAXIMUM(1,0)

MAXIMUM(0-999,0-999) MODENAME(char8)�

�NEPCLASS(0)

NEPCLASS(0-255) NETNAMEQ(char8)

PROTOCOL(APPC)

PROTOCOL(LU61)PROTOCOL(EXCI)

RECEIVECOUNT(1-999)�

�RECEIVEPFX(char2)

RECEIVESIZE(4096)

RECEIVESIZE(1-30720)

RECOVOPTION(SYSDEFAULT)

RECOVOPTION(CLEARCONV)RECOVOPTION(NONE)RECOVOPTION(RELEASESESS)RECOVOPTION(UNCONDREL)

RELREQ(NO)

RELREQ(YES)�

�SENDCOUNT(1-999) SENDPFX(char2)

�SENDSIZE(4096)

SENDSIZE(1-30720) SESSNAME(char4)

SESSPRIORITY(0)

SESSPRIORITY(0-255)

USERAREALEN(0)

USERAREALEN(0-255)�

�USERID(char8)

CREATE TCPIPSERVICE

�� CREATE TCPIPSERVICE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

82 CICS TS for OS/390: CICS User’s Handbook

CREATE TCPIPSERVICE

TCPIPSERVICE attributes:

BACKLOG(0)

BACKLOG(0-32767) CERTIFICATE(char44) DESCRIPTION(char58) IPADDRESS(char15)�

�KEYFILE(char44)

PORTNUMBER(1-32767)SSL(NO)

SSL(YES)SSL(CLIENTAUTH)

STATUS(OPEN)

STATUS(CLOSED)�

� TRANSACTION(char4)TSQPREFIX(char6) URM(char8)

CREATE TDQUEUE

�� CREATE TDQUEUE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TDQUEUE

TDQUEUE attributes for extra-partition queues:

TYPE(EXTRA)BLOCKFORMAT(BLOCKED)BLOCKFORMAT(UNBLOCKED)

BLOCKSIZE(0)

BLOCKSIZE(0-32767)

DATABUFFERS(1)

DATABUFFERS(1-255)�

� DDNAME(char8)DESCRIPTION(char58)

DISPOSITION(SHR)

DISPOSITION(OLD)DISPOSITION(MOD)

DSNAME(DUMMY)DSNAME(char44)

�ERROROPTION(IGNORE)

ERROROPTION(SKIP)

OPENTIME(INITIAL)

OPENTIME(DEFERRED) PRINTCONTROL(A)PRINTCONTROL(M)

RECORDFORMAT(FIXED)RECORDFORMAT(VARIABLE)

�RECORDSIZE(0)

RECORDSIZE(0-32767)

,REMOTESYSTEM(char4)REMOTELENGTH(0-32767)REMOTENAME(char4)

�REWIND(LEAVE)REWIND(REREAD)

SYSOUTCLASS(*)

SYSOUTCLASS(char1)

TYPEFILE(INPUT)

TYPEFILE(OUTPUT)TYPEFILE(RDBACK)

SPI syntax

Chapter 2. SPI command syntax 83

CREATE TDQUEUE

TDQUEUE attributes for intra-partition queues:

TYPE(INTRA)ATIFACILITY(TERMINAL)

ATIFACILITY(FILE)ATIFACILITY(SYSTEM)

DESCRIPTION(char58) FACILITYID(char4)�

�RECOVSTATUS(NO)

RECOVSTATUS(LOGICAL)RECOVSTATUS(PHYSICAL)

,REMOTESYSTEM(char4)REMOTELENGTH(0-32767)REMOTENAME(char4)

�TRANSID(char4)

TRIGGERLEVEL(1)

TRIGGERLEVEL(0-32767) USERID(char8)

WAIT(YES)

WAIT(NO)�

�WAITACTION(REJECT)

WAITACTION(QUEUE)

CREATE TDQUEUE

TDQUEUE attributes for indirect queues:

TYPE(INDIRECT)DESCRIPTION(char58)

INDIRECTNAME(char4) �

,REMOTESYSTEM(char4)REMOTELENGTH(0-32767)REMOTENAME(char4)

CREATE TDQUEUE

TDQUEUE attributes for remote queues of unspecified TYPE:

DESCRIPTION(char58) REMOTELENGTH(0-32767) REMOTENAME(char4)REMOTESYSTEM(char4)

CREATE TERMINAL

�� CREATE TERMINAL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value)COMPLETEDISCARD

�#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

84 CICS TS for OS/390: CICS User’s Handbook

CREATE TERMINAL

TERMINAL attributes:

ALTPRINTCOPY(NO)

ALTPRINTCOPY(YES) ALTPRINTER(char4)

ATTACHSEC(LOCAL)

ATTACHSEC(IDENTIFY)ATTACHSEC(MIXIDPE)ATTACHSEC(PERSISTENT)ATTACHSEC(VERIFY)

AUTINSTMODEL(NO)

AUTINSTMODEL(ONLY)AUTINSTMODEL(YES)

�AUTINSTNAME(char8) BINDPASSWORD(hex16)

BINDSECURITY(NO)

BINDSECURITY(YES)

CONSOLE(NO)

CONSOLE(0-250)CONSNAME(char8)

�DESCRIPTION(char58)

INSERVICE(YES)

INSERVICE(NO) MODENAME(char8) NATLANG(E)NATLANG(K)

�NETNAME(char8) POOL(char8) PRINTER(char4)

PRINTERCOPY(NO)

PRINTERCOPY(YES)�

�REMOTESYSNET(char8) REMOTESYSTEM(char4)

REMOTENAME(char4)

�SECURITYNAME(char8)

TASKLIMIT(NO)

TASKLIMIT(1-32767)

TERMPRIORITY(0)

TERMPRIORITY(0-255) TRANSACTION(char4)�

� TYPETERM(char8)USERID(char8)

CREATE TRANCLASS

�� CREATE TRANCLASS(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TRANCLASS

TRANCLASS attributes:

DESCRIPTION(char58)MAXACTIVE(0-999)

PURGETHRESH(NO)

PURGETHRESH(1-1000000)

SPI syntax

Chapter 2. SPI command syntax 85

CREATE TRANSACTION

�� CREATE TRANSACTION(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TRANSACTION

TRANSACTION attributes:

ACTION(BACKOUT)

ACTION(COMMIT) ALIAS(char4) BREXIT(char8)

CMDSEC(NO)

CMDSEC(YES)

CONFDATA(NO)

CONFDATA(YES)�

�DESCRIPTION(char58)

DTIMOUT(NO)

DTIMOUT(1-6800)

DUMP(YES)

DUMP(NO)

DYNAMIC(NO)

DYNAMIC(YES)�

�INDOUBT(BACKOUT)

INDOUBT(COMMIT)INDOUBT(WAIT)

ISOLATE(YES)

ISOLATE(NO)

LOCALQ(NO)

LOCALQ(YES) PARTITIONSET(char8)PARTITIONSET(KEEP)PARTITIONSET(OWN)

�PRIORITY(1)

PRIORITY(0-255)

PROFILE(DFHCICST)

PROFILE(char8)PROGRAM(char8)REMOTESYSTEM(char4)

REMOTENAME(char8)

�RESSEC(NO)

RESSEC(YES)

RESTART(NO)

RESTART(YES)�

�RUNAWAY(SYSTEM)

RUNAWAY(0-2700000)

SHUTDOWN(DISABLED)

SHUTDOWN(ENABLED)

SPURGE(NO)

SPURGE(YES)

STATUS(ENABLED)

STATUS(DISABLED)�

�STORAGECLEAR(NO)

STORAGECLEAR(YES)

TASKDATAKEY(USER)

TASKDATAKEY(CICS)

TASKDATALOC(BELOW)

TASKDATALOC(ANY) TASKREQ(LPA)TASKREQ(MSRE)TASKREQ(OPID)TASKREQ(PA1-3)TASKREQ(PF1-24)

�TPNAME(char64)XTPNAME(hex128)

TPURGE(NO)

TPURGE(YES)

TRACE(YES)

TRACE(NO)

TRANCLASS(DFHTCL00)

TRANCLASS(char8)�

�TRPROF(DFHCICSS)

TRPROF(char8)

TWASIZE(0)

TWASIZE(0-32767)

WAIT(YES)

WAIT(NO)

WAITTIME(0,0,0)

WAITTIME(0-99,0-23,0-59)�

�XTRANID(hex8)

SPI syntax

86 CICS TS for OS/390: CICS User’s Handbook

CREATE TSMODEL

�� CREATE TSMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TSMODEL

TSMODEL attributes:

DESCRIPTION(char58)

LOCATION(AUXILIARY)

LOCATION(MAIN) POOLNAME(char8) PREFIX(char16)XPREFIX(char32)

�RECOVERY(NO)

RECOVERY(YES) REMOTESYSTEM(char4)REMOTEPREFIX(char16)XREMOTEPFX(char32)

SECURITY(NO)

SECURITY(YES)

CREATE TYPETERM

�� CREATE TYPETERM(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) �#

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 87

CREATE TYPETERM

TYPETERM attributes (1/3):

ALTPAGE(0,0)

ALTPAGE(0-999,0-999) ALTSCREEN(0-999,0-999) ALTSUFFIX(char1)

APLKYBD(NO)

APLKYBD(YES)�

�APLTEXT(NO)

APLTEXT(YES)

ASCII(NO)

ASCII(7)ASCII(8)

ATI(NO)

ATI(YES)

AUDIBLEALARM(NO)

AUDIBLEALARM(YES)

AUTOCONNECT(NO)

AUTOCONNECT(ALL)AUTOCONNECT(YES)

�AUTOPAGE(NO)AUTOPAGE(YES)

BACKTRANS(NO)

BACKTRANS(YES)

BRACKET(YES)

BRACKET(NO)

BUILDCHAIN(NO)

BUILDCHAIN(YES)�

�CGCSGID(0,0)

CGCSGID(0-65535,0-65535)

COLOR(NO)

COLOR(YES)

COPY(NO)

COPY(YES)

CREATESESS(NO)

CREATESESS(YES)�

�DEFSCREEN(0,0)

DEFSCREEN(0-999,0-999)�

�DESCRIPTION(char58)

DEVICE(char8)DISCREQ(YES)

DISCREQ(NO)

DUALCASEKYBD(NO)

DUALCASEKYBD(YES)�

�ERRCOLOR(NO)

ERRCOLOR(BLUE)ERRCOLOR(GREEN)ERRCOLOR(NEUTRAL)ERRCOLOR(PINK)ERRCOLOR(RED)ERRCOLOR(TURQUOISE)ERRCOLOR(YELLOW)

ERRHILIGHT(NO)

ERRHILIGHT(BLINK)ERRHILIGHT(REVERSE)ERRHILIGHT(UNDERLINE)

ERRINTENSIFY(NO)

ERRINTENSIFY(YES)

ERRLASTLINE(NO)

ERRLASTLINE(YES)�

�EXTENDEDDS(NO)

EXTENDEDDS(YES)

FMHPARM(NO)

FMHPARM(YES)

FORMFEED(NO)

FORMFEED(YES)

HILIGHT(NO)

HILIGHT(YES)

HORIZFORM(NO)

HORIZFORM(YES)�

�IOAREALEN(0,0)

IOAREALEN(0-32767,0-32767)

KATAKANA(NO)

KATAKANA(YES)

SPI syntax

88 CICS TS for OS/390: CICS User’s Handbook

CREATE TYPETERM

TYPETERM attributes (2/3):

LDCLIST(char8)

LIGHTPEN(NO)

LIGHTPEN(YES) LOGMODE(char8)LOGMODE(0)

LOGONMSG(NO)

LOGONMSG(YES)

MSRCONTROL(NO)

MSRCONTROL(YES)�

�NEPCLASS(0)

NEPCLASS(0-255)

OBFORMAT(NO)

OBFORMAT(YES)

OBOPERID(NO)

OBOPERID(YES)

OUTLINE(NO)

OUTLINE(YES)�

�PAGESIZE(24,80)

PAGESIZE(0-999,0-999)

PARTITIONS(NO)

PARTITIONS(YES)

PRINTADAPTER(NO)

PRINTADAPTER(YES)

PROGSYMBOLS(NO)

PROGSYMBOLS(YES)�

�QUERY(NO)

QUERY(ALL)QUERY(COLD)

RECEIVESIZE(256)

RECEIVESIZE(0-30720)

RECOVNOTIFY(NONE)

RECOVNOTIFY(MESSAGE)RECOVNOTIFY(TRANSACTION)

�RECOVOPTION(SYSDEFAULT)

RECOVOPTION(CLEARCONV)RECOVOPTION(NONE)RECOVOPTION(RELEASESESS)RECOVOPTION(UNCONDREL)

RELREQ(NO)

RELREQ(YES)�

�ROUTEDMSGS(ALL)ROUTEDMSGS(NONE)ROUTEDMSGS(SPECIFIC)

SENDSIZE(0)

SENDSIZE(0-30720) SESSIONTYPE(char8)

SHIPPABLE(NO)

SHIPPABLE(YES)�

�SIGNOFF(YES)

SIGNOFF(NO)SIGNOFF(LOGOFF)

SOSI(NO)

SOSI(YES) TERMMODEL(1)TERMMODEL(2)

TEXTKYBD(NO)

TEXTKYBD(YES)

TEXTPRINT(NO)

TEXTPRINT(YES)�

�TTI(YES)

TTI(NO)

UCTRAN(NO)

UCTRAN(TRANID)UCTRAN(YES)

USERAREALEN(0)

USERAREALEN(0-255)

VALIDATION(NO)

VALIDATION(YES)

CREATE TYPETERM

TYPETERM attributes (3/3):

VERTICALFORM(NO)

VERTICALFORM(YES)

XRFSIGNOFF(NOFORCE)

XRFSIGNOFF(FORCE)

SPI syntax

Chapter 2. SPI command syntax 89

DISABLE PROGRAM

�� DISABLE PROGRAM(data-value)ENTRYNAME(data-value) EXIT(data-value)

EXITALLFORMATEDF

�SHUTDOWN SPI STOP TASKSTART

�#

Conditions: INVEXITREQ, NOTAUTH

DISCARD AUTINSTMODEL

�� DISCARD AUTINSTMODEL(data-value) �#

Conditions: INVREQ, MODELIDERR, NOTAUTH

DISCARD CONNECTION

�� DISCARD CONNECTION(data-value) �#

Conditions: INVREQ, NOTAUTH, SYSIDERR

DISCARD DB2CONN

�� DISCARD DB2CONN �#

Conditions: INVREQ, NOTAUTH, NOTFND

DISCARD DB2ENTRY

�� DISCARD DB2ENTRY(data-value) �#

Conditions: NOTFND, INVREQ, NOTAUTH

DISCARD DB2TRAN

�� DISCARD DB2TRAN(data-value) �#

Conditions: NOTFND, NOTAUTH

DISCARD DOCTEMPLATE

�� DISCARD DOCTEMPLATE(data-value) �#

Conditions: NOTAUTH, NOTFND

SPI syntax

90 CICS TS for OS/390: CICS User’s Handbook

DISCARD ENQMODEL

�� DISCARD ENQMODEL(data-value) �#

Conditions: NOTAUTH, NOTFND

DISCARD FILE

�� DISCARD FILE(data-value) �#

Conditions: FILENOTFOUND, INVREQ, NOTAUTH

DISCARD JOURNALMODEL

�� DISCARD JOURNALMODEL(data-value) �#

Conditions: NOTAUTH, NOTFND

DISCARD JOURNALNAME

�� DISCARD JOURNALNAME(data-value) �#

Conditions: INVREQ, JIDERR, NOTAUTH

DISCARD PARTNER

�� DISCARD PARTNER(data-value) �#

Conditions: INVREQ, NOTAUTH, PARTNERIDERR

DISCARD PROCESSTYPE

�� DISCARD PROCESSTYPE(data-value) �#

Conditions: INVREQ, NOTAUTH, PROCESSERR

DISCARD PROFILE

�� DISCARD PROFILE(data-value) �#

Conditions: INVREQ, NOTAUTH, PROFILEIDERR

SPI syntax

Chapter 2. SPI command syntax 91

DISCARD PROGRAM

�� DISCARD PROGRAM(data-value) �#

Conditions: INVREQ, NOTAUTH, PGMIDERR

DISCARD REQUESTMODEL

�� DISCARD REQUESTMODEL(data-value) �#

Conditions: NOTAUTH, NOTFND

DISCARD TCPIPSERVICE

�� DISCARD TCPIPSERVICE(data-value) �#

Conditions: INVREQ, NOTAUTH, NOTFND

DISCARD TDQUEUE

�� DISCARD TDQUEUE(data-value) �#

Conditions: INVREQ, NOTAUTH, QIDERR

DISCARD TERMINAL

�� DISCARD TERMINAL(data-value) �#

Conditions: INVREQ, NOTAUTH, TERMIDERR

DISCARD TRANCLASS

�� DISCARD TRANCLASS(data-value) �#

Conditions: INVREQ, NOTAUTH, TCIDERR

DISCARD TRANSACTION

�� DISCARD TRANSACTION(data-value) �#

Conditions: INVREQ, NOTAUTH, TRANSIDERR

SPI syntax

92 CICS TS for OS/390: CICS User’s Handbook

DISCARD TSMODEL

�� DISCARD TSMODEL(data-value) �#

Conditions: INVREQ, NOTAUTH, NOTFND

ENABLE PROGRAM

�� ENABLE PROGRAM(data-value) ,

ENTRY(ptr-ref)ENTRYNAME(data-value)EXIT(data-value)FORMATEDF

GALENGTH(data-value)GAENTRYNAME(data-value)

INDOUBTWAITLINKEDITMODE

QUASIRENTTHREADSAFE

OPENAPIOPENAPI

SHUTDOWNSPISTARTTALENGTH(data-value)TASKSTART

�#

Conditions: INVEXITREQ, NOTAUTH

EXTRACT EXIT

�� EXTRACT EXIT PROGRAM(data-value)ENTRYNAME(data-value)

GALENGTH(data-area) GASET(ptr-ref) �#

Conditions: INVEXITREQ, NOTAUTH

INQUIRE AUTINSTMODEL

�� INQUIRE AUTINSTMODEL(data-value) �#

Conditions: END, ILLOGIC, MODELIDERR, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 93

INQUIRE AUTOINSTALL

�� INQUIRE AUTOINSTALL ,

CONSOLES(cvda)CURREQS(data-area)ENABLESTATUS(cvda)MAXREQS(data-area)PROGRAM(data-area)

�#

Conditions: NOTAUTH

INQUIRE CFDTPOOL

�� INQUIRE CFDTPOOL(data-value)CONNSTATUS(cvda)

�#

Conditions: END, ILLOGIC, NOTAUTH, POOLERR

INQUIRE CONNECTION

�� INQUIRE CONNECTION(data-value) ,

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

SPI syntax

94 CICS TS for OS/390: CICS User’s Handbook

INQUIRE DB2CONN

�� INQUIRE DB2CONN ASS1 ASS43 �#

ASS1

,

ACCOUNTREC(cvda)UOWTASKTXIDNONE

AUTHID(data-area)AUTHTYPE(cvda)GROUPSIGNTERMTXOPIDUSERID

COMAUTHID(data-area)COMAUTHTYPE(cvda)CGROUPCSIGNCTERMCTXCOPIDCUSERID

COMTHREADLIM(data-area)COMTHREADS(data-area)

CONNECTERROR(cvda)ABENDSQLCODECONNECTST(cvda)CONNECTEDCONNECTINGDISCONNINGNOTCONNECTED

ASS43

,

DB2ID(data-area)DB2RELEASE(data-area)

DROLLBACK(cvda)ROLLBACKNOROLLBACK

MSGQUEUE1(data-area)MSGQUEUE2(data-area)MSGQUEUE3(data-area)

NONTERMREL(cvda)RELEASENORELEASE

PLAN(data-area)PLANEXITNAME(data-area)

PRIORITY(cvda)HIGHEQUALLOW

PURGECYCLEM(data-area)

SPI syntax

Chapter 2. SPI command syntax 95

INQUIRE DB2ENTRY

�� INQUIRE DB2ENTRY(data-value)ACCOUNTREC(cvda)UOWTASKTXIDNONE

AUTHID(data-area) AUTHTYPE(cvda)GROUPSIGNTERMTXOPIDUSERID

�DISABLEDACT(cvda)ABENDSQLCODEPOOL

DROLLBACK(cvda)ROLLBACKNOROLLBACK

ENABLESTATUS(cvda)ENABLEDDISABLEDDISABLING

PLAN(data-area)�

�PLANEXITNAME(data-area) PRIORITY(cvda)

HIGHEQUALLOW

PROTECTNUM(data-area)�

�PTHREADS(data-area) THREADLIMIT(data-area) THREADS(data-area) THREADWAIT(cvda)

TWAITNOTWAITTPOOL

�#

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

INQUIRE DB2TRAN

�� INQUIRE DB2TRAN(data-value) DB2ENTRY(data-area) TRANSID(data-area)

�#

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

SPI syntax

96 CICS TS for OS/390: CICS User’s Handbook

INQUIRE DELETSHIPPED

�� INQUIRE DELETSHIPPED INQ1 INQ6 �#

INQ6

INQ7INQ8

INQ7

INTERVAL(data-area)

INQ8

INQ9 INQ10 INQ11

INQ9

INTERVALHRS(data-area)

INQ10

INTERVALMINS(data-area)

INQ11

INTERVALSECS(data-area)

INQ1

INQ2INQ3 INQ4 INQ5

INQ2

IDLE(data-area)

INQ3

IDLEHRS(data-area)

INQ4

IDLEMINS(data-area)

INQ5

IDLESECS(data-area)

SPI syntax

Chapter 2. SPI command syntax 97

INQUIRE DOCTEMPLATE

�� INQUIRE DOCTEMPLATE(data-value) ,

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

INQUIRE DSNAME

�� INQUIRE DSNAME(data-value) ,

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

�� INQUIRE DUMPDS ,

CURRENTDDS(data-area)INITIALDDS(data-area)OPENSTATUS(cvda)SWITCHSTATUS(cvda)

�#

Conditions: NOTAUTH

SPI syntax

98 CICS TS for OS/390: CICS User’s Handbook

INQUIRE ENQ

�� INQUIRE ENQ ENQSCOPE(data-value)RESOURCE(data-value) RESLEN(data-value)UOW(data-value)

,

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

�� INQUIRE ENQMODEL(data-value) ,

ENQSCOPE(data-area)ENQNAME(data-area)STATUS(cvda)

�#

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE EXCI

�� INQUIRE EXCITASK(data-value)URID(data-value)

�#

Conditions: END, ILLOGIC, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 99

INQUIRE EXITPROGRAM

�� INQUIRE EXITPROGRAM(data-value) ,

INQ2INQ3IEPOT1IEPOT2INQ2INQ4INQ12INQ7INQ6INQ8

INDOUBTST(cvda)INQ11

QUALIFIER(data-area)INQ14

SPIST(cvda)INQ11INQ9INQ13

�#

INQ2

CONNECTST(cvda)

INQ14

SHUTDOWNST(cvda)

INQ4

ENTRY(data-area)

INQ2

EXIT(data-value)

INQ13

TASKSTARTST(cvda)

INQ11

STARTSTATUS(cvda)

INQ12

FORMATEDFST(cvda)

IEPOT1

APIST(data-value)

SPI syntax

100 CICS TS for OS/390: CICS User’s Handbook

INQUIRE FILE

�� INQUIRE FILE(data-value) ,

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

�� INQUIRE IRCOPENSTATUS(cvda)

�#

Conditions: NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 101

INQUIRE JOURNALMODEL

�� INQUIRE JOURNALMODEL(data-value)JOURNALNAME(data-area) STREAMNAME(data-area)

�TYPE(cvda)

�#

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE JOURNALNAME

�� INQUIRE JOURNALNAME(data-value) ,

STATUS(cvda)STREAMNAME(data-area)TYPE(cvda)

�#

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

INQUIRE MODENAME

�� INQUIRE MODENAME(data-value) CONNECTION(data-value) ,

ACTIVE(data-area)AUTOCONNECT(cvda)AVAILABLE(data-area)MAXIMUM(data-area)MAXWINNERS(data-area)

�#

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

SPI syntax

102 CICS TS for OS/390: CICS User’s Handbook

INQUIRE MONITOR

�� INQUIRE MONITOR ,

INQM5INQM1INQM2

INQM9freqhrs freqmins freqsecs

INQM3INQM4INQM8INQM6

TIME(cvda)

�#

INQM4

STATUS(cvda)

INQM3

PERFCLASS(cvda)

INQM1

EVENTCLASS(cvda)

INQM5

CONVERSEST(cvda)

INQM6

SYNCPOINTST(cvda)

INQM2

EXCEPTCLASS(cvda)

INQM8

SUBSYSTEMID(data-area)

INQM9

FREQUENCY(data-area)

freqhrs:

FREQUENCYHRS(data-area)

freqmins:

SPI syntax

Chapter 2. SPI command syntax 103

INQUIRE TERMINAL/NETNAME

�� INQUIRE NETNAME(data-value)TERMINAL(data-area)

�#

Conditions: NOTAUTH, TERMIDERR

INQUIRE PARTNER

�� INQUIRE PARTNER(data-value) ,

NETWORK(data-area)NETNAME(data-area)PROFILE(data-area)TPNAME(data-area)TPNAMELEN(data-area)

�#

Conditions: END, ILLOGIC, NOTAUTH, PARTNERIDERR

INQUIRE PROCESSTYPE

�� INQUIRE PROCESSTYPE(data-value)FILE(data-area) AUDITLOG(data-area)

�AUDITLEVEL(cvda) STATUS(cvda)

�#

Conditions: NOTAUTH, PROCESSERR

INQUIRE PROFILE

�� INQUIRE PROFILE(data-value) �#

Conditions: END, ILLOGIC, NOTAUTH, PROFILEIDERR

SPI syntax

104 CICS TS for OS/390: CICS User’s Handbook

INQUIRE PROGRAM

�� INQUIRE PROGRAM(data-value) ,

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

SPI syntax

Chapter 2. SPI command syntax 105

INQUIRE REQID

�� INQUIRE REQID(data-value)REQTYPE(cvda)

INQ4 INQ3 INQ5 INQ17 �

�RTRANSID(data-area) RTERMID(data-area) QUEUE(data-area) USERID(data-area)

�#

INQ17

INQ18

INQ18

INQ19 INQ20 INQ21

INQ19

SET(ptr-ref)

INQ20

LENGTH(data-area)

INQ21

FMHSTATUS(cvda)

INQ5

INQ6INQ7INQ8INQ12

INQ7

TIME(data-area)

INQ6

INTERVAL(data-area)

INQ12

AT INQ13 INQ14 INQ15

INQ8

AFTER INQ9 INQ10 INQ11

SPI syntax

106 CICS TS for OS/390: CICS User’s Handbook

INQUIRE REQUESTMODEL

�� INQUIRE REQUESTMODEL(data-value) ,

OMGINTERFACE(data-area)OMGMODULE(data-area)OMGOPERATION(data-area)TRANSID(data-value)

�#

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

INQUIRE RRMS

�� INQUIRE RRMSOPENSTATUS(cvda)

�#

Conditions:

SPI syntax

Chapter 2. SPI command syntax 107

INQUIRE STATISTICS

�� INQUIRE STATISTICS INQ1 INQ7 INQ13RECORDING(cvda)

�#

INQ13

INQ14INQ15

INQ14

NEXTTIME(data-area)

INQ15

nxhrs nxmins nxsecs

INQ7

INQ8INQ9

INQ8

INTERVAL(data-area)

INQ9

inhrs inmins insecs

INQ1

INQ2endhrs endmins endsecs

INQ2

ENDOFDAY(data-area)

endhrs:

ENDOFDAYHRS(data-area)

endmins:

ENDOFDAYMINS(data-area)

endsecs:

SPI syntax

108 CICS TS for OS/390: CICS User’s Handbook

INQUIRE STORAGE

�� INQUIRE STORAGE INQ1 INQ3 INQ4INQ5 elist llist task

�#

INQ1

ADDRESS(ptr-value)

INQ3

ELEMENT(ptr-ref)

INQ4

FLENGTH(data-area)

INQ5

NUMELEMENTS(data-area)

elist:

ELEMENTLIST(ptr-ref)

llist:

LENGTHLIST(ptr-ref)

task:

TASK(data-value)

Conditions: NOTAUTH, TASKIDERR

SPI syntax

Chapter 2. SPI command syntax 109

INQUIRE STREAMNAME

�� INQUIRE STREAMNAME(data-value) ,

STATUS(cvda)SYSTEMLOG(cvda)USECOUNT(data-area)

�#

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE SYSDUMPCODE

�� INQUIRE SYSDUMPCODE(data-value) ,

CURRENT(data-area)DAEOPTION(cvda)DUMPSCOPE(cvda)MAXIMUM(data-area)SHUTOPTION(cvda)SYSDUMPING(cvda)

�#

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

SPI syntax

110 CICS TS for OS/390: CICS User’s Handbook

INQUIRE SYSTEM

�� INQUIRE SYSTEM ,

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

SPI syntax

Chapter 2. SPI command syntax 111

SPI syntax

112 CICS TS for OS/390: CICS User’s Handbook

INQUIRE TASK

�� INQUIRE TASK(data-value) ,

ACTIVITY(data-area)ACTIVITYID(data-area)ATTACHTIME(data-area)BRIDGE(data-area)

INQ3INQ5INQ6INQ7INQ8

FACILITYTYPE(cvda)IDENTIFIER(data-area)INDOUBT(cvda)INDOUBTMINS(data-area)INDOUBTWAIT(cvda)

INQ9PRIORITY(data-area)PROCESS(data-area)PROCESSTYPE(data-area)

INQ10INQ11INQ12INQ13INQ14INQ15INQ16INQ17INQ18

RUNSTATUS(cvda)INQ19

STARTCODE(data-area)INQ20

SUSPENDTIME(data-area)SUSPENDTYPE(data-area)

SUSPENDVALUE(data-area)INQ25

INQ22INQ23

TCB(cvda)INQ22INQ26INQ27

TRANSACTION(data-area)INQ28INQ29

UOW(data-area)USERID(data-area)

�#

INQ15

RESSEC(cvda)

INQ3

CMDSEC(cvda)

INQ26

TRACING( d )

SPI syntax

Chapter 2. SPI command syntax 113

INQUIRE TASK LIST

�� INQUIRE TASK LIST LISTSIZE(data-area)DISPATCHABLE RUNNING SUSPENDED

�SET(ptr-ref)

SETTRANSID(ptr-ref)

�#

Condition: NOTAUTH

INQUIRE TCLASS

�� INQUIRE TCLASS(data-value) ,

CURRENT(data-area)MAXIMUM(data-area)

�#

Conditions: NOTAUTH, TCIDERR

INQUIRE TCPIP

�� INQUIRE TCPIP OPENSTATUS(cvda) �#

Conditions: INVREQ, NOTAUTH

INQUIRE TCPIPService

�� INQUIRE TCPIPSERVICE(data-value) ,

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

SPI syntax

114 CICS TS for OS/390: CICS User’s Handbook

The following options apply to both the INQUIRE TERMINAL and the INQUIRENETNAME command.

INQUIRE TDQUEUE

�� INQUIRE TDQUEUE(data-value) ,

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

INQUIRE TERMINAL/NETNAME

�� INQUIRE TERMINAL(data-value)NETNAME(data-area)

�#

SPI syntax

Chapter 2. SPI command syntax 115

INQUIRE TERMINAL

�� ITER1 �#

ITER1

,

ITER2ITER3ITER4ITER5ITER6ITER7ITER8ITER9ITER10ITER11ITER12

ASCII(cvda)ITER14ITER15ITER16ITER17ITER18ITER18ITER19

CORRELID(data-area)ITER20ITER21ITER22ITER23ITER24ITER25ITER26ITER28ITER29ITER30ITER31ITER32ITER33ITER34ITER35ITER36ITER37ITER38ITER39

LINKSYSTEM(data-area)ITER39ITER39

ITER26

DEVICE(cvda)

ITER19

COPYST(cvda)

ITER36

SPI syntax

116 CICS TS for OS/390: CICS User’s Handbook

SPI syntax

Chapter 2. SPI command syntax 117

INQUIRE TERMINAL

�� ITER88 �#

ITER88

,

ITER40ITER41ITER42ITER43ITER44ITER46ITER47ITER48ITER49ITER49aITER50ITER51ITER52ITER54ITER55ITER56ITER57ITER58ITER59ITER60

REMOTESYSNET(data-area)ITER61ITER62ITER63ITER66ITER67ITER68ITER69ITER70ITER71ITER72ITER73ITER74ITER74AITER75ITER76ITER77ITER78ITER79ITER80ITER81ITER82ITER83ITER84ITER85ITER86ITER87

ITER70

SOSIST(cvda)

ITER43

SPI syntax

118 CICS TS for OS/390: CICS User’s Handbook

INQUIRE TRACEDEST

�� INQUIRE TRACEDEST ,

AUXSTATUS(cvda)CURAUXDS(data-area)GTFSTATUS(cvda)INTSTATUS(cvda)SWITCHSTATUS(cvda)TABLESIZE(data-area)

�#

Conditions: NOTAUTH

INQUIRE TRACEFLAG

�� INQUIRE TRACEFLAG ,

SINGLESTATUS(cvda)SYSTEMSTATUS(cvda)TCEXITSTATUS(cvda)USERSTATUS(cvda)

�#

Conditions: NOTAUTH

INQUIRE TRACETYPE

�� INQUIRE TRACETYPE STANDARDSPECIAL

,

COMPID(data-area)�#

Conditions: NOTAUTH, NOTFND

SPI syntax

Chapter 2. SPI command syntax 119

INQUIRE TRANCLASS

�� INQUIRE TRANCLASS(data-value) ,

INQ2INQ4INQ5INQ3

�#

INQ3

QUEUED(data-area)

INQ2

ACTIVE(data-area)

INQ4

MAXACTIVE(data-area)

INQ5

PURGETHRESH(data-area)

Conditions: INVREQ, NOTAUTH, TCIDERR

INQUIRE TRANDUMPCODE

�� INQUIRE TRANDUMPCODE(data-value) ,

CURRENT(data-area)DUMPSCOPE(cvda)MAXIMUM(data-area)SHUTOPTION(cvda)SYSDUMPING(cvda)TRANDUMPING(cvda)

�#

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

SPI syntax

120 CICS TS for OS/390: CICS User’s Handbook

INQUIRE TRANSACTION

�� INQUIRE TRANSACTION(data-value) ,

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)

INQ4INQ5

SCRNSIZE(cvda)INQ6

STATUS(cvda)INQ7

TASKDATAKEY(cvda)TASKDATALOC(cvda)

INQ8TRACING(cvda)TRPROF(data-area)TWASIZE(data-area)

�#

INQ6

SHUTDOWN(cvda)

INQ5

RUNAWAYTYPE(cvda)

INQ7

STORAGECLEAR(cvda)

INQ4

RUNAWAY(data-area)

INQ8

INQ9INQ10

INQ9

SPI syntax

Chapter 2. SPI command syntax 121

INQUIRE TSMODEL

�� INQUIRE TSMODEL(data-value) ,

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

�� INQUIRE TSPOOL(data-value)CONNSTATUS(cvda)

�#

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TSQUEUE

�� INQUIRE TSQUEUE(data-value)TSQNAME(data-value) POOLNAME(data-value)

SYSID(data-value)

,

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

SPI syntax

122 CICS TS for OS/390: CICS User’s Handbook

INQUIRE UOW

�� INQUIRE UOW(data-area) ,

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

�� INQUIRE UOWDSNFAILCAUSE(cvda)

DSNAME(data-area)NETNAME(data-area) REASON(cvda)

�RLSACCESS(cvda) SYSID(data-area)

UOW(data-area) �#

Conditions: END, ILLOGIC, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 123

INQUIRE UOWENQ

�� INQUIRE UOWENQ ,

ENQSCOPE(data-value)RESOURCE(data-value) RESLEN(data-value)UOW(data-value)

� ,

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

�� INQUIRE UOWLINK(data-area)LINK(data-area) NETUOWID(data-area) PROTOCOL(cvda)

APPCIRCLU61NOTAPPLICRRMS

�RESYNCSTATUS(cvda)COLDNOTAPPLICOKSTARTINGUNAVAILABLEUNCONNECTED

RMIQFY(data-area) ROLE(cvda)COORDINATORSUBORDINATEUNKNOWN

SYSID(data-area)�

�TYPE(cvda)CFTABLECONNECTIONRMI

UOW(data-area) URID(data-area)�#

Conditions: END, ILLOGIC, NOTAUTH, UOWLNOTFOUND, UOWNOTFOUND

SPI syntax

124 CICS TS for OS/390: CICS User’s Handbook

INQUIRE VTAM

�� INQUIRE VTAM ,

INQ9INQ8INQ8

INQ3INQ4

�#

INQ8

GRSTATUS(cvda)

INQ8

OPENSTATUS(cvda)

INQ9

GRNAME(data-area)

INQ3

PSDINTERVAL(data-area)

INQ4

psinhrs psinmins psinsecs

psinhrs:

PSDINTHRS(data-area)

psinmins:

PSDINTMINS(data-area)

psinsecs:

PSDINTSECS(data-area)

Conditions: INVREQ, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 125

INQUIRE WEB

�� INQUIRE WEB(data-area) ,

GARBAGEINT(data-area)TIMEOUTINT(data-area)

�#

Conditions: NOTAUTH

PERFORM DELETSHIPPED

�� PERFORM DELETSHIPPED �#

Conditions: NOTAUTH

PERFORM DUMP

�� PERFORM DUMP DUMPCODE(data-value)TITLE(data-area) TITLELENGTH(data-value)

�CALLER(data-value) CALLERLENGTH(data-value) DUMPID(data-value)

�#

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH, SUPPRESSED, SYSBUSY

PERFORM ENDAFFINITY

�� PERFORM ENDAFFINITY NETNAME(data-value)NETID(data-value)

�#

Conditions: INVREQ

PERFORM RESETTIME

�� PERFORM RESETTIME �#

Conditions: INVREQ, NOTAUTH

PERFORM SECURITY REBUILD

�� PERFORM SECURITY REBUILDESMRESP(data-area)

�#

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSBUSY

SPI syntax

126 CICS TS for OS/390: CICS User’s Handbook

PERFORM SHUTDOWN

�� PERFORM SHUTDOWNDUMP

,

IMMEDIATE

PLT(data-value)SDTRAN(data-value)NOSDTRAN

XLT(data-value)TAKEOVER

�#

Conditions: INVREQ, NOTAUTH, TRANSIDERR

PERFORM STATISTICS RECORD

�� PERFORM STATISTICS RECORD ,

ALLRESETNOW

AUTOINSTALLCONNECTIONDB2DISPATCHERENQUEUEFEPIFILE

JOURNALNAMEJOURNALNUM

LSRPOOLMONITORPROGAUTOPROGRAMRECOVERYSTATSSTORAGESTREAMNAMESYSDUMPTABLEMGRTCPIPSERVICETDQUEUETERMINAL

TRANCLASSTCLASS

TRANDUMPTRANSACTIONTSQUEUEVTAM

�#

Conditions: IOERR, NOTAUTH, NOTFND

SPI syntax

Chapter 2. SPI command syntax 127

RESYNC ENTRYNAME

�� RESYNC ENTRYNAME(data-value)QUALIFIER(data-value)

�IDLIST(data-value)

IDLISTLENGTH(data-value)PARTIAL

�#

Conditions: NOTAUTH

SET AUTOINSTALL

�� SET AUTOINSTALLCONSOLES(cvda) MAXREQS(data-value) PROGRAM(data-value)

�#

Conditions: INVREQ, NOTAUTH, PGMIDERR

SET CONNECTION

�� SET CONNECTION(data-value)ACQSTATUS(cvda)CONNSTATUS(cvda)ACQUIREDRELEASED

AFFINITY(cvda)ENDAFFINITY

EXITTRACING(cvda)EXITTRACENOEXITTRACE

�PENDSTATUS(cvda)NOTPENDING

PURGETYPE(cvda)CANCELFORCECANCELFORCEPURGEPURGE

RECOVSTATUS(cvda)NORECOVDATA

SERVSTATUS(cvda)INSERVICEOUTSERVICE

�UOWACTION(cvda)BACKOUTCOMMITFORCERESYNC

ZCPTRACING(cvda)NOZCPTRACEZCPTRACE

�#

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSIDERR

SPI syntax

128 CICS TS for OS/390: CICS User’s Handbook

SET DB2CONN

�� SET DB2CONN ASS1 ASS43 �#

ASS1

,

ACCOUNTREC(cvda)UOWTASKTXIDNONE

AUTHID(data-area)AUTHTYPE(cvda)GROUPSIGNTERMTXOPIDUSERIDBUSY(cvda)WAITNOWAITFORCE

COMAUTHID(data-area)COMAUTHTYPE(cvda)CGROUPCSIGNCTERMCTXCOPIDCUSERID

COMTHREADLIM(data-area)CONNECTERROR(cvda)ABENDSQLCODECONNECTST(cvda)CONNECTEDNOTCONNECTED

ASS43

,

DB2ID(data-area)MSGQUEUE1(data-area)MSGQUEUE2(data-area)MSGQUEUE3(data-area)

NONTERMREL(cvda)RELEASENORELEASE

PLAN(data-area)PLANEXITNAME(data-area)

PRIORITY(cvda)HIGHEQUALLOW

PURGECYCLEM(data-area)PURGECYCLES(data-area)SECURITY(REBUILD)SIGNID(data-area)

SPI syntax

Chapter 2. SPI command syntax 129

refid=synsyn.SET DB2ENTRY

�� SET DB2ENTRY(data-area)

,

ACCOUNTREC(cvda)UOWTASKTXIDNONE

AUTHID(data-area)AUTHTYPE(cvda)GROUPSIGNTERMTXOPIDUSERIDBUSY(cvda)WAITNOWAITFORCEDISABLEDACT(cvda)ABENDSQLCODEPOOLENABLESTATUS(cvda)ENABLEDDISABLED

PLAN(data-area)PLANEXITNAME(data-area)

PRIORITY(cvda)HIGHEQUALLOW

PROTECTNUM(data-area)THREADLIMIT(data-area)

THREADWAIT(cvda)TWAITNOWAITTPOOL

�#

Conditions: NOTAUTH, NOTFND, INVREQ

refid=synsyn.SET DB2TRAN

�� SET DB2TRAN ,

DB2ENTRY(data-area)TRANSID(data-area)

�#

Conditions: NOTAUTH, NOTFND, INVREQ

SPI syntax

130 CICS TS for OS/390: CICS User’s Handbook

SET DELETSHIPPED

�� SET DELETSHIPPED SET7 SET2 �#

SET2

SET2SET3

SET2

INTERVAL(data-value)

SET3

,

SET4SET5SET6

SET4

INTERVALHRS(data-value)

SET6

INTERVALSECS(data-value)

SET5

INTERVALMINS(data-value)

SET7

SET8SET9

SET8

IDLE(data-value)

SET9

,

SET10SET11SET12

SPI syntax

Chapter 2. SPI command syntax 131

SET DSNAME

�� SET DSNAME(data-value)ACTION(cvda)REMOVERECOVEREDRESETLOCKSRETRY

SETDS4 SETDS7WAIT

BUSY(cvda)NOWAIT

SETDS11 �#

SETDS11

SETDS12BACKOUTCOMMITFORCE

SETDS12

UOWACTION(cvda)

SETDS7

SETDS8QUIESCEDIMMQUIESCEDUNQUIESCED

SETDS8

QUESCESTATE(cvda)

SETDS4

SETDS5AVAILABLEUNAVAILABLE

SETDS5

AVAILABILITY(cvda)

Conditions: DSNNOTFOUND, INVREQ, IOERR, NOTAUTH, SUPPRESSED

SPI syntax

132 CICS TS for OS/390: CICS User’s Handbook

SET DUMPDS

�� SET DUMPDSINITIALDDS(data-value) OPENSTATUS(cvda)

CLOSEDOPENSWITCH

SWITCHSTATUS(cvda)NOSWITCHSWITCHNEXT

�#

Conditions: INVREQ, IOERR, NOTAUTH

SET ENQMODEL

�� SET ENQMODEL(data-value) STATUS(cvda)DISABLEDENABLED

�#

Conditions: INVREQ, NOTAUTH, NOTFND

SET FILE

�� SET FILE(data-value)SET DATASET(data-value)

ATTRIBUTES(data-value) �#

Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

SPI syntax

Chapter 2. SPI command syntax 133

SET FILE

FILE attributes:

ADD(cvda)ADDABLENOTADDABLE

BROWSE(cvda)BROWSABLENOTBROWSABLE

WAIT

BUSY(cvda)FORCENOWAIT

CFDTPOOL(data-value) DELETE(cvda)DELETABLENOTDELETABLE

�DISPOSITION(cvda)OLDSHARE

DSNAME(data-value)OBJECTNAME(data-value)

EMPTYSTATUS(cvda)EMPTYEMPTYREQNOEMPTYREQ

� ,

ENABLESTATUS(cvda)DISABLEDENABLEDOPENSTATUS(cvda)CLOSEDOPEN

EXCLUSIVE(cvda)EXCTLNOEXCTL

KEYLENGTH(data-value)�

�LOADTYPE(cvda)LOADNOLOAD

LSRPOOLID(data-value) MAXNUMRECS(data-value) READ(cvda)NOTREADABLEREADABLE

�RECORDSIZE(data-value) READINTEG(cvda)

UNCOMMITTEDCONSISTENTREPEATABLE

RLSACCESS(cvda)RLSNOTAPPLICNOTRLS

�STRINGS(data-value) TABLE(cvda)

CFTABLECICSTABLENOTTABLEUSERTABLE

TABLENAME(data-value) UPDATE(cvda)NOTUPDATABLEUPDATABLE

�UPDATEMODEL(cvda)CONTENTIONLOCKING

SPI syntax

134 CICS TS for OS/390: CICS User’s Handbook

SET IRC

�� SET IRCOPENSTATUS(cvda)CLOSEDIMMCLOSEOPEN

�#

Conditions: INVREQ, IOERR, NOSTG, NOTAUTH

SET JOURNALNAME

�� SET JOURNALNAME(data-value) SETJ2FLUSHRESET

SETJ1DISABLEDENABLED

�#

SETJ1

STATUS(cvda)

SETJ2

ACTION(cvda)

Conditions: INVREQ, IOERR, JIDERR, NOTAUTH

SET MODENAME

�� SET MODENAME(data-value) CONNECTION(data-value) �

�AVAILABLE(data-value)

ACQSTATUS(cvda)ACQUIRED

ACQSTATUS(cvda)CLOSED

�#

Conditions: INVREQ, NOTAUTH, SYSIDERR

SPI syntax

Chapter 2. SPI command syntax 135

SET MONITOR

�� SET MONITORSET5

CONVERSENOCONVERSE

SET1EVENTNOEVENT

SET2EXCEPTNOEXCEPT

,

SET7

SET8SET9SET10

�SET3

PERFNOPERF

SET4ONOFF

SET6SYNCPOINTNOSYNCPOINT

�#

SET6

SYNCPOINTST(cvda)

SET4

STATUS(cvda)

SET3

PERFCLASS(cvda)

SET7

FREQUENCY(data-value)

SET10

FREQUENCYSEC(data-value)

SET8

FREQUENCYHRS(data-value)

SET9

FREQUENCYMIN (data-value)

SET2

EXCEPTCLASS(cvda)

SET1

EVENTCLASS(cvda)

SET5

SPI syntax

136 CICS TS for OS/390: CICS User’s Handbook

SET NETNAME

�� SET NETNAME(data-value)EXITTRACING(cvda)EXITTRACENOEXITTRACE

�#

Conditions: INVREQ, NOTAUTH

SET PROCESSTYPE

�� SET PROCESSTYPE(data-value)STATUS(cvda)DISABLEDENABLED

AUDITLEVEL(cvda)ACTIVITYFULLOFFPROCESS

�#

Conditions: INVREQ, NOTAUTH, PROCESSERR

SET PROGRAM

�� SET PROGRAM(data-value)CEDFSTATUS(cvda)CEDFNOCEDF

COPY(cvda)NEWCOPYPHASEIN

EXECUTIONSET(cvda)DPLSUBSETFULLAPI

�SHARESTATUS(cvda)PRIVATESHARED

JVMCLASS(255-character data-area) JVMDEBUG(cvda)DEBUGNODEBUG

�RUNTIME(cvda)JVMNOJVM

STATUS(cvda)DISABLEDENABLED

VERSION(cvda)�#

Conditions: INVREQ, IOERROR, NOTAUTH, PGMIDERR

SPI syntax

Chapter 2. SPI command syntax 137

SET STATISTICS

�� SET STATISTICS SET1 SET7SET14 /

RECORDNOW RESETNOW

�#

SET14 /

RECORDING(cvda)

ON

OFF

SET7

SET8SET3

SET8

INTERVAL(data-value)

SET3

,

SET4SET11SET12

SET4

INTERVALHRS(data-value)

SET12

INTERVALSECS(data-value)

SET11

INTERVALMINS(data-value)

SET1

SET2SET3

SET2

ENDOFDAY(data-value)

SPI syntax

138 CICS TS for OS/390: CICS User’s Handbook

SET SYSDUMPCODE

�� SET SYSDUMPCODE(data-value)ACTION(cvda)ADDREMOVERESET

DAEOPTION(cvda)DAENODAE

DUMPSCOPE(cvda)LOCALRELATED

�MAXIMUM(data-value) SHUTOPTION(cvda)

NOSHUTDOWNSHUTDOWN

SYSDUMPING(cvda)NOSYSDUMPSYSDUMP

�#

Conditions: DUPREC, INVREQ, IOERR, NOSPACE, NOTAUTH, NOTFND

SPI syntax

Chapter 2. SPI command syntax 139

SET SYSTEM

�� SET SYSTEM ,

SET2SET4SET5SET5

SET6NOSYSDUMPSYSDUMPSET7SET7aSET20

LOGDEFER(data-area)SET7bSET10 SET11SET12

SET13CTLGALLCTLGMODIFYCTLGNONESET14

SET15AUTOACTIVEAUTOINACTIVESET16SET17SET18SET19

�#

SET7a

FORCEQR(cvda)

SET2

AKP(data-value)

SET19

TIME(data-value)

SET17

RUNAWAY(data-value)

SET12

MROBATCH(data-value)

SET4

DSALIMIT(data-value)

SET18

SPI syntax

140 CICS TS for OS/390: CICS User’s Handbook

SET TASK

�� SET TASK(data-value)PRIORITY(data-value) PURGETYPE(cvda)

FORCEPURGEPURGE

�#

Conditions: INVREQ, NOTAUTH, TASKIDERR

SET TCLASS

�� SET TCLASS(data-value)MAXIMUM(data-value)

�#

Conditions: INVREQ, NOTAUTH, TCIDERR

SET TCPIP

�� SET TCPIP STATUS(data-value)CLOSEIMMCLOSEOPEN

�#

Conditions: INVREQ, IOERR, NOTAUTH

SET TCPIPSERVICE

�� SET TCPIPSERVICE(data-value)STATUS(cvda)CLOSEIMMCLOSEOPEN

URM(data-value)�#

Conditions: INVREQ, NOTAUTH, NOTFND

SPI syntax

Chapter 2. SPI command syntax 141

SET TDQUEUE

�� SET TDQUEUE(data-value)ATIFACILITY(cvda)NOTERMINALTERMINAL

ATITERMID(data-value)�

�ATITRANID(data-value) ATIUSERID(data-value) ENABLESTATUS(cvda)

DISABLEDENABLED

OPENSTATUS(cvda)CLOSEDOPEN

�TRIGGERLEVEL(data-value)

�#

Conditions: INVREQ, IOERR, NOTAUTH, QIDERR, USERIDERR

SPI syntax

142 CICS TS for OS/390: CICS User’s Handbook

SET TERMINAL

�� SET TERMINAL(data-value)ACQSTATUS(cvda)TERMSTATUS(cvda)ACQUIREDCOLDACQRELEASED

ALTPRINTER(data-value)�

�ALTPRTCOPYST(cvda)ALTPRTCOPYNOALTPRTCOPY

ATISTATUS(cvda)ATI

NOATI

CREATESESS(cvda)CREATENOCREATE

DISCREQST(cvda)DISCREQNODISCREQ

�EXITTRACING(cvda)EXITTRACENOEXITTRACE

MAPNAME(data-value) MAPSETNAME(data-value)�

�NEXTTRANSID(data-value) OBFORMATST(cvda)

OBFORMATNOOBFORMAT

OPERID(data-value) PAGESTATUS(cvda)AUTOPAGEABLEPAGEABLE

�PRINTER(data-value) PRTCOPYST(cvda)

PRTCOPYNOPRTCOPY

PURGETYPE(cvda)FORCEPURGEPURGE

FORCECANCEL

RELREQST(cvda)RELREQNORELREQ

�SERVSTATUS(cvda)INSERVICEOUTSERVICE

TCAMCONTROL(data-value) TERMPRIORITY(data-value)�

�TRACING(cvda)SPECTRACESTANTRACE

TTISTATUS(cvda)NOTTITTI

UCTRANST(cvda)UCTRANNOUCTRANTRANIDONLY

ZCPTRACING(cvda)NOZCPTRACEZCPTRACE

�#

Conditions: INVREQ, NORMAL, NOTAUTH, TERMIDERR

SPI syntax

Chapter 2. SPI command syntax 143

SET TRACEDEST

�� SET TRACEDESTAUXSTATUS(cvda)AUXPAUSEAUXSTARTAUXSTOP

GTFSTATUS(cvda)GTFSTARTGTFSTOP

INTSTATUS(cvda)INTSTARTINTSTOP

�SWITCHACTION(cvda)SWITCH

SWITCHSTATUS(cvda)NOSWITCHSWITCHALLSWITCHNEXT

TABLESIZE(data-value)�#

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH

SET TRACEFLAG

�� SET TRACEFLAGSINGLESTATUS(cvda)SINGLEOFFSINGLEON

SYSTEMSTATUS(cvda)SYSTEMOFFSYSTEMON

TCEXITSTATUS(cvda)TCEXITALLTCEXITALLOFFTCEXITNONETCEXITSYSTEM

�USERSTATUS(cvda)USEROFFUSERON

�#

Conditions: INVREQ, NOTAUTH

SET TRACETYPE

�� SET TRACETYPE STANDARDSPECIAL

,

COMPID(data-value)�#

Conditions: NOTAUTH, NOTFND

SET TRANCLASS

�� SET TRANCLASS(data-value)MAXACTIVE(data-value) PURGETHRESH(data-value)

�#

Conditions: INVREQ, NOTAUTH, TCIDERR

SPI syntax

144 CICS TS for OS/390: CICS User’s Handbook

SET TRANDUMPCODE

�� SET TRANDUMPCODE(data-value)ACTION(cvda)ADDREMOVERESET

DUMPSCOPE(cvda)LOCALRELATED

MAXIMUM(data-value)�

�SHUTOPTION(cvda)NOSHUTDOWNSHUTDOWN

SYSDUMPING(cvda)NOSYSDUMPSYSDUMP

TRANDUMPING(cvda)NOTRANDUMPTRANDUMP

�#

Conditions: DUPREC, INVREQ, IOERR, NOSPACE, NOTAUTH, NOTFND

SPI syntax

Chapter 2. SPI command syntax 145

SET TRANSACTION

�� SET TRANSACTION(data-value)DUMPING(cvda)TRANDUMPNOTRANDUMP

PRIORITY(data-value) PURGEABILITY(cvda)NOTPURGEABLEPURGEABLE

�RUNAWAY(data-value) SET3

SYSTEMUSER

SET4SHUTDISABLEDSHUTENABLED

STATUS(cvda)DISABLEDENABLED

SET5 �

�TRACING(cvda)SPECTRACESPRSTRACESTANTRACE

�#

SET5

SET6SET7

SET6

TCLASS(data-value)

SET7

TRANCLASS(data-value)

SET4

SHUTDOWN(cvda)

SET3

RUNAWAYTYPE(cvda)

Conditions: INVREQ, NOTAUTH, TRANSIDERR

SPI syntax

146 CICS TS for OS/390: CICS User’s Handbook

SET TSQUEUE

�� SET TSQUEUE(data-value)TSQNAME(data-value) SYSID(data-value)

POOLNAME(data-value)

�ACTION(cvda)

LASTUSEDINT(data-value)DELETE

�#

Conditions: INVREQ, NOTAUTH, NOTFND, POOLERR, QIDERR, SYSIDERR

SET UOW

�� SET UOW(data-value) SETUOW2 �#

SETUOW2

SETUOW3COMMITBACKOUTFORCE

SETUOW3

UOWSTATE(cvda)

Conditions: INVREQ, NOTAUTH, UOWNOTFOUND

SET UOWLINK

�� SET UOWLINK(data-value)SET1

DELETE

�#

SET1

ACTION(cvda)

Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND

SPI syntax

Chapter 2. SPI command syntax 147

SET VTAM

�� SET VTAMSET1

CLOSEDFORCECLOSEIMMCLOSEOPEN

SET7DEREGISTERED

�#

SET7

SET8SET3

SET8

PSDINTERVAL(data-value)

SET3

,

SET4SET11SET12

SET4

PSDINTHRS(data-value)

SET12

PSDINTSECS(data-value)

SET11

PSDINTMINS(data-value)

SET1

OPENSTATUS(cvda)

Conditions: INVREQ, IOERR, NOTAUTH

SPI syntax

148 CICS TS for OS/390: CICS User’s Handbook

SET WEB

�� SET WEBGARBAGEINT(data-value) TIMEOUTINT(data-value)

�#

Conditions: INVREQ, IOERR, NOTAUTH

Chapter 2. SPI command syntax 149

150 CICS TS for OS/390: CICS User’s Handbook

Chapter 3. CICS-Supplied Transaction

Some CICS-supplied transactions are menu driven, while others can be entered onthe command line. Menus are provided wherever the transaction name appears onits own in the syntax descriptions on the pages that follow.

CEBT INQUIRE AUXTRACE

�� CEBT Inquire Auxtrace �#

CEBT INQUIRE DUMP

�� CEBT Inquire Dump �#

CEBT INQUIRE INTTRACE

�� CEBT Inquire Inttrace �#

CEBT INQUIRE GTFTRACE

�� CEBT Inquire Gtftrace �#

CEBT INQUIRE SURVEILLANCE

�� CEBT Inquire Surveillance �#

CEBT PERFORM SHUTDOWN

�� CEBT Perform SHutdown Dump Immediate �#

CEBT PERFORM SNAP

�� CEBT Perform SNap �#

CEBT PERFORM TAKEOVER

�� CEBT Perform Takeover Dump �#

© Copyright IBM Corp. 1989, 2000 151

CEBT SET AUXTRACE

�� CEBT Set AuxtraceSTArtPauseSTOp

NOswitchNExtAll

SWitch �#

CEBT SET DUMP

�� CEBT Set DumpOpenCLosedSwitch

AutoswitchNoautoswitch

�#

CEBT SET GTFTRACE

�� CEBT Set GtftraceSTArtSTOp

�#

CEBT SET INTTRACE

�� CEbt Set InttraceSTArtSTOp

�#

CEBT SET SURVEILLANCE

�� CEBT Set SurveillanceOFfON

�#

CEBT SET TAKEOVER

�� CEBT Set TakeoverAutomaticCommandManual

�#

CEDA (part 1 of 2)

�� CEDA �

CST syntax

152 CICS TS for OS/390: CICS User’s Handbook

� ADD GROUP LISTAFTERBEFORE

ALTER Resource typeAPPEND LIST TOCHECK

GROUP REMOTESYSTEM

LISTALL

COPY GROUPAS REPLACE

Resource type MERGETO

ASTO(1)

DEFINE Resource type GROUP attribute listDELETE

ALL GROUP REMOVE

Resource type LISTDISPLAY LIST

GROUPGROUP

RENAMEALL

Resource typeEXPAND LIST

GROUPGROUP

RENAMEALL

Resource typeINSTALL

GROUPALL

LISTResource type

LOCKGROUP

LISTALL

MOVE GROUPAS REPLACE REMOVE

Resource type MERGETO

ASTOREMOVE GROUP LISTRENAME

GROUP AS TO REMOVEALL

Resource typeUNLOCK

GROUP

LIST(1)

USERDEFINE Resource type GROUP attribute listVIEW GROUP

ALL

Resource type

�#

CST syntax

Chapter 3. CICS-Supplied Transaction 153

Notes:

1 Consult the CICS Resource Definition Guide. for information about theattributes applicable to each resource type.

CEDA (part 2 of 2)

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

CST syntax

154 CICS TS for OS/390: CICS User’s Handbook

CEDF

�� CEDFtermidsysidsessionid

,ON

,OFF�#

CEDX

�� CEDX tranid,ON

,OFF�#

CEMT DISCARD

�� CEMT Discard ,

Autinstmodel(value)Connection(value)DB2ConnDB2Entry(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

�� CEMT Inquire AUTInstmodelAll

�#

CST syntax

Chapter 3. CICS-Supplied Transaction 155

CEMT INQUIRE AUTOINSTALL

�� CEMT Inquire AUTOinstall �#

CEMT INQUIRE AUXTRACE

�� CEMT Inquire AUXtrace �#

CEMT INQUIRE CONNECTION

�� CEMT Inquire Connection (value)ALl NEtname(value) NOTPending

PEnding

�INServiceOUtservice

ACquiredRELeasedOBtainingFReeingAVailable

NOTSupportedUnattemptedCOMPleteFailed

VtamIRcXMINDirectXCfRConnection

EXciAPpcLu61

�XOkXNotdone

RECovdataNORecovdataNRs

Grname(value) Membername(value)�

�REMotesystem(value) RNAme(value) RNEtname(value)

�#

CEMT INQUIRE DB2CONN

�� CEMT Inquire DB2Conn �#

CEMT INQUIRE DB2ENTRY

�� CEMT Inquire DB2Entry(data-area)AT(data-area) START

ENDNEXT

CST syntax

156 CICS TS for OS/390: CICS User’s Handbook

�ACCOUNTREC(cvda)UOWTASKTXIDNONE

AUTHID(data-area) AUTHTYPE(cvda)GROUPSIGNTERMTXOPIDUSERID

�DISABLEDACT(cvda)ABENDSQLCODEPOOL

DROLLBACK(cvda)ROLLBACKNOROLLBACK

ENABLESTATUS(cvda)ENABLEDDISABLEDDISABLING

�PLAN(data-area) PLANEXITNAME(data-area) PRIORITY(cvda)

HIGHEQUALLOW

�PROTECTNUM(data-area) PTHREADS(data-area)

�THREADLIMIT(data-area) THREADS(data-area) THREADWAIT(cvda)

TWAITNOTWAITTPOOL

�#

CEMT INQUIRE DB2TRAN

�� CEMT Inquire DB2Tran(data-area) DB2Entry(data-area)

�Transid(data-area)

�#

CEMT INQUIRE DELETSHIPPED

�� CEMT Inquire DEletshippedIDle(value) INterval(value)

�#

CEMT INQUIRE DOCTEMPLATE

CST syntax

Chapter 3. CICS-Supplied Transaction 157

�� CEMT Inquire DOctemplateTSqTDqFileEXitpgmMember

Name(name) AppendNoappend

�EbcdicBinary

Templatename(name) Templatename ( name )�

�DDnameDSname

�#

CEMT INQUIRE DSAS

�� CEMT Inquire DSAs �#

CEMT INQUIRE DSNAME

�� CEMT Inquire DSNameALl

(value)VSamBDam

FIlecount(value)VAlidINvalidPathBASEFWDRECOVAbleNOTrecovableRECOVERAbleUNDeterminedStaticDynamicUNDetermined

FRlog(value)AVailableUNAvailableNOLostlocksREMLostlocksRECOVERLocksRETAinedNORetainedQuiescedUNQuiesced

BASEDsname(value)FWDRECOVLsn(value)

�#

CST syntax

158 CICS TS for OS/390: CICS User’s Handbook

CEMT INQUIRE DUMPDS

�� CEMT Inquire DUmpds �#

CEMT INQUIRE ENQ

�� CEMT Inquire EnqUow(value) TRansid(value) TAskid(value)

�ACtiveRETained

DatasetFileEXecenqADdrexecenqTDqTSq

OwnerWaiter

Netuowid(value)�

�ENqfails(value) RESource(value) RLen(value)

�QUalifier(value) QLen(value)

�#

CEMT INQUIRE ENQMODEL

�� CEMT Inquire ENQModel (value)ENQSCOPE(value)ENQNAME(value)

DISABLEDENABLEDWAITING

�#

CEMT INQUIRE EXCI

�� CEMT Inquire ExciTask(number)Urid(value)

�#

CEMT INQUIRE FILE

�� CEMT Inquire FIleALl

(value) VsamBDamREMote

OPenCLosed

ENabledUNenabledDIsabled

CST syntax

Chapter 3. CICS-Supplied Transaction 159

�REAdNORead

UPdateNOUpdate

ADdableNOAddable

BRowseNOBrowse

DEleteNODelete

�EXclusiveNOEXclusive

OLdShare

RLsNOTRls

EMptyreqNOEMptyreq

DSname(value)�

�NOTTableCIcstableUSertableCFTable

LOAdNOLoad

CFDtpool(value)�

�Tablename(value) LOCKING

COntentionMaxnumrecs(value)

�Keylength(value) RECordsize(value)

�#

CEMT INQUIRE GTFTRACE

�� CEMT Inquire Gtftrace �#

CEMT INQUIRE INTTRACE

�� CEMT Inquire INttrace �#

CEMT INQUIRE IRC

�� CEMT Inquire IRc �#

CEMT INQUIRE JMODEL

�� CEMT Inquire JModelAll

(value) (Journalnamevalue) MvsSMfDummy

�STreamname(value)

�#

CST syntax

160 CICS TS for OS/390: CICS User’s Handbook

CEMT INQUIRE JOURNALNAME

�� CEMT Inquire JOurnalnameAll(value)

MvsSMfDUmmy

EnabledDIsabledFAiled

�STreamname(value)

�#

CEMT INQUIRE LINE

�� CEMT Inquire Line (value)NUmber(value) NEgpoll(value)

�InserviceOutservice

�#

CEMT INQUIRE MODENAME

�� CEMT Inquire MODenameALl

(value) COnnection(value)�

�Maximum(value) AVailable(value) ACTive(value)

�#

CEMT INQUIRE MONITOR

�� CEMT Inquire MONitorGmtLocal

SUbsystemid(value)�#

CEMT INQUIRE NETNAME

�� CEMT Inquire NetnameALl

(value) TRansaction(value)�

�PRiority(value) PAgeable

AUtopageableInserviceOutservice

ATiNOAti

TTiNOTti

CST syntax

Chapter 3. CICS-Supplied Transaction 161

�RTerminalRSessionSessionLocal

TErminal(value) ACquiredCOldacqRELeased

CReateNOCreate

�TAsk(value) REMotesystem(value) RNAme(value)

�RNEtname(value) CId(value) Userid

�#

CEMT INQUIRE PARTNER

�� CEMT Inquire PArtnerAll

(value) NETWork(value) NETName(value)�

�Profile(value) Ltpname(value) Tpname(value)

�#

CEMT INQUIRE PROCESSTYPE

�� CEMT Inquire PROCesstypeALl

(value) FIle (value)�

�AUditlog (value) ACtivity

FUllOffProcess

EnabledDisabled

�#

CEMT INQUIRE PROFILE

�� CEMT Inquire PROFileAll

(value)�#

CEMT INQUIRE PROGRAM

CST syntax

162 CICS TS for OS/390: CICS User’s Handbook

�� CEMT Inquire PROGramALl

(value)CLass(value)

LENgth(value) PLiCObolCLE370ASsemblerNOTDEfinedJAVA

�PROgramMapsetPArtitionset

EnabledDIsabled

PRIvate

Shared REQuiredNOTRequired

CEDfNOCedf

�DYnamicNOTDYnamic

REScount(value) USecount(value) ANyBelow

�CEXeckeyUExeckey

DPlsubsetFullapi

QuasirentThreadsafe

REMotesystem(value)�

�JVMLE370NATIVEUNKNOWN

�DEBugNODebug

JVMClass(value)�#

CEMT INQUIRE STATISTICS

�� CEMT Inquire STAtistics �#

CEMT INQUIRE STREAMNAME

�� CEMT Inquire STReamnameALl

(value)Usecount(value) Failed

Ok

�SyslogNosyslog

�#

CST syntax

Chapter 3. CICS-Supplied Transaction 163

CEMT INQUIRE SYDUMPCODE

�� CEMT Inquire SYDumpcodeALl

(value) SYsdumpNOSYsdump

RELatedLocal

�SHutdownNOSHutdown

Maximum(value) Current(value) DaeNODae

�#

CEMT INQUIRE SYSTEM

�� CEMT Inquire SYStem �#

CEMT INQUIRE TASK

�� CEMT Inquire TAskALl

(value)TClass(value)

TRanid(value)�

�FAcility(value) Running

DIspatchableSUspended

TAskTErmDEst

PRiority(value)�

�STartcode(value) USerid(value) UOw(value) HTYpe(value)

�HValue(value) HTIme(value) Backout

CommitBRidge(value)

�IDentifier(value) Indoubtmins(value) Nowait

Wait

�DB2plan(value) ACTIVITYId(value) ACTIVITY(value)

�PROCESS(value) PROCESSType(value)

�#

CST syntax

164 CICS TS for OS/390: CICS User’s Handbook

CEMT INQUIRE TCLASS

�� CEMT Inquire TClassALl

(value) Maxactive(value) ACtive(value)�

�Purgethresh(value) Queued(value)

�#

CEMT INQUIRE TCPIPSERVICE

�� INQUIRE TCPIPSERVICE(value)Backlog(value) CLOsetimeout(value)

�Connection(value) IPaddress(value) OPENSTATUS(value)

OPENCLOSINGCLOSEDIMMCLOSING

�Port(value) SSLTYPE(value)

NOYESCLIENTAUTH

SOcketclose(value)WaitTImeout

�TCPIPService(value) TRansid(value) TSqprefix(value)

�URM(value)

�#

CEMT INQUIRE TDQUEUE

�� CEMT Inquire TDqueueAll

(value) TRIggerlevel(value) INDirectEXtraINTraREMote

�NAmeind(value) ENabled

DIsabledOPenClosed

TErmid(value)�

CST syntax

Chapter 3. CICS-Supplied Transaction 165

�TRAnid(value) Userid(value) Shr

OLdMod

INPutOUtputRDback

QueueREJect

�WaitNOwait

DAtabuffers(value) DDname(value) DSname(value)�#

CEMT INQUIRE TERMINAL

�� CEMT Inquire TErminalALl

(value)CLass(value)

TRansaction(value)�

�COnsole(value) PRiority(value) PAgeable

AUtopageableInserviceOutservice

�ATiNOAti

TTiNOTti

RTerminalRSessionSessionLocal

NEtname(value) ACquiredRELeased

�CReateNOCreate

TAsk(value) REMotesystem(value) RNAme(value)�

�RNEtname(value) Userid(value)

�CId(value)

�#

CEMT INQUIRE TRANSACTION

�� CEMT Inquire TRAnsactionALl

(value)CLass(value)

PRIority(value)�

�PROgram(value) TClass(value) Enabled

DisabledPUrgeableNOTPurgeable

CST syntax

166 CICS TS for OS/390: CICS User’s Handbook

�PRFile(value) CDatakey

UdatakeyANyBElow

ISolateNOIsolate

TRprof(value)�

�BAckoutCOmmit

BRexit(value) FAcilitylike(value)�

�INdoubtmins(value) NOWait

WaitRoutableNOTRoutable

�#

CEMT INQUIRE TRDUMPCODE

�� CEMT Inquire TRDumpcodeALl

(value) TrandumpNOTrandump

SYsdumpNOSYsdump

�SHutdownNOSHutdown

RELatedLocal

Maximum(value) Current(value)�#

CEMT INQUIRE TSMODEL

�� CEMT Inquire TSModelALl

(value)

,

LOCATION(value)POOLNAME(data-area)PREFIX(data-area)RECOVSTATUS(value)REMOTEPREFIX(data-area)REMOTESYSTEM(data-area)SECURITYST(value)

�#

CEMT INQUIRE TSPOOL

�� CEMT Inquire TSPoolALl

(value) CONNSTATUS(cvda)�#

CEMT INQUIRE TSQNAME

�� CEMT Inquire TSqnameALl

(value) Sysid(value) Numitems(value)�

CST syntax

Chapter 3. CICS-Supplied Transaction 167

�LAstusedint(value) LEngth(value) MAIn

AUxiliary

�MAXitemlen(value) MInitemlen(value) Transid(value)

�#

CEMT INQUIRE TSQUEUE

�� CEMT Inquire TSQueueALl

(value) SYSID(value)POOLNAME(value)

�Numitems(value) LAstusedint(value) LEngth(value)

�MAInAUxiliary

MAXitemlen(value) MInitemlen(value)�

� RECOVSTATUS(value)Transid(value)

�#

CEMT INQUIRE UOW

�� CEMT Inquire UOWALl

(value) BackoutCOMmitINDoubtINFlightHBackoutHCommit

ACtiveWAITIngSHunted

�TRansid(value) TAskid(value) AGe(value) TErmid(value)

�NETName(value) Userid(value) CONnection

DatasetRlsserverWAITCommitWAITForgetWAITRmi

Link(value)�

�SYsid(value) NETUowid(value)

�#

CST syntax

168 CICS TS for OS/390: CICS User’s Handbook

CEMT INQUIRE UOWDSNFAIL

�� CEMT Inquire UOWDsnfail UOw(value) DSname(value)NOtrlsRLS

�CAcheCONnectionDATASETRLSServerUNdefined

BackupnonbwoCOMmitfailDATASETFullDEAdlockDELexiterrorFailedbkoutINDExrecfullIOerrorOpenerrorRLSGoneINDOubtRRCommitfailRRIndoubtLckstrucfull

Sysid(value) NEtname(value)�#

CEMT INQUIRE UOWENQ

�� CEMT Inquire UOWEnqUow(value) TRansid(value) TAskid(value)

�ACtiveRETained

DatasetFileEXecenqADdrexecenqTDqTSq

OwnerWaiter

Netuowid(value)�

�ENqfails(value) RESource(value) RLen(value)

�QUalifier(value) QLen(value)

�#

CEMT INQUIRE UOWLINK

�� CEMT Inquire UOWLinkALl

(value) UOw(value) CONnectionRMI

CST syntax

Chapter 3. CICS-Supplied Transaction 169

�LInk(value) COOrdinator

SUbordinateUNKnown

IrcAPpcLU61NOtapplicRrms

COLdstartSTartingWarmstartUNAvailableUNConnectedNOtapplic

�SYsid(value) RMIQfy(value) NEtuowid(value)

�#

CEMT INQUIRE VTAM

�� CEMT Inquire Vtam �#

CEMT PERFORM DELETSHIPPED

�� CEMT Perform DEletshipped �#

CEMT PERFORM ENDAFFINITY

�� CEMT Perform Endaffinity NETName(value)NETId(value)

�#

CEMT PERFORM RESET

�� CEMT Perform Reset �#

CEMT PERFORM SECURITY REBUILD

�� CEMT Perform SEcurityRebuild

�#

CEMT PERFORM SHUTDOWN

�� CEMT Perform SHUTdownXlt(value) Plt(value) Sdtran(value)

NOSdtran

�Immediate

NORestartTakeover Dump

�#

CST syntax

170 CICS TS for OS/390: CICS User’s Handbook

CEMT PERFORM DUMP

�� CEMT Perform DUmpSNap Title(value)

�#

CEMT PERFORM STATISTICS

�� CEMT Perform STatisticsRECORd

, ALlRESetnow

AUtoinstallConnectionDB2DIspatcherEnqueueFEpiFIleJournalnameLsrpoolMonitorPROGAutoPROGRamRECOVerySTAtsSTOrageSTReamnameSYsdumpTAblemgrTCLassTCPipserviceTDqueueTErminalTRAnsactionTRDumpTSqueueVtam

�#

CEMT SET AUTOINSTALL

�� CEMT Set AUToinstallConsoles(value) Maxreqs(value)

�Program(value)

�#

CST syntax

Chapter 3. CICS-Supplied Transaction 171

CEMT SET AUXTRACE

�� CEMT Set AUXtraceSTArtPauseSTOp

NOswitchNExtAll

SWitch�#

CEMT SET CONNECTION

�� CEMT Set Connection (value)ALl NOTpending INService

OUtservice

�ACquiredRELeased

PUrgeFORCEPurgeCAncelFCancel

COmmitBackoutFORCEUowRESync

ENdaffinity NORecovdata�#

CEMT SET DB2CONN

�� CEMT Set DB2Conn ASS1 ASS43 �#

ASS1

CST syntax

172 CICS TS for OS/390: CICS User’s Handbook

,

ACCOUNTREC(cvda)UOWTASKTXIDNONE

AUTHID(data-area)AUTHTYPE(cvda)GROUPSIGNTERMTXOPIDUSERID

COMAUTHID(data-area)COMAUTHTYPE(cvda)CGROUPCSIGNCTERMCTXCOPIDCUSERID

COMTHREADLIM(data-area)CONNECTERROR(cvda)ABENDSQLCODECONNECTST(cvda)CONNECTEDNOTCONNECTEDFORCENOTCONNECTED

ASS43

CST syntax

Chapter 3. CICS-Supplied Transaction 173

,

DB2ID(data-area)MSGQUEUE1(data-area)MSGQUEUE2(data-area)MSGQUEUE3(data-area)

NONTERMREL(cvda)RELEASENORELEASE

PLAN(data-area)PLANEXITNAME(data-area)

PRIORITY(cvda)HIGHEQUALLOW

PURGECYCLEM(data-area)PURGECYCLES(data-area)SECURITY(REBUILD)SIGNID(data-area)

STANDBYMODE(cvda)NOCONNECTCONNECTRECONNECT

STATSQUEUE(data-area)TCBLIMIT(data-area)THREADLIMIT(data-area)

THREADWAIT(cvda)TWAITNOTWAITN906

CEMT SET DB2ENTRY

CST syntax

174 CICS TS for OS/390: CICS User’s Handbook

�� CEMT Set DB2Entry(data-area)

,

ACCOUNTREC(cvda)UOWTASKTXIDNONE

AUTHID(data-area)AUTHTYPE(cvda)GROUPSIGNTERMTXOPIDUSERIDDISABLEDACT(cvda)ABENDSQLCODEPOOLENABLESTATUS(cvda)ENABLEDDISABLEDFORCEDISABLED

PLAN(data-area)PLANEXITNAME(data-area)

PRIORITY(cvda)HIGHEQUALLOW

PROTECTNUM(data-area)THREADLIMIT(data-area)

THREADWAIT(cvda)TWAITNOTWAITTPOOL

�#

CEMT SET DB2TRAN

�� CEMT Set DB2Tran ASS1 �#

ASS1

,

DB2Entry(data-area)Transid(data-area)

CST syntax

Chapter 3. CICS-Supplied Transaction 175

CEMT SET DELETSHIPPED

�� CEMT Set DEletshippedINterval(value) IDle(value)

�#

CEMT SET DSAS

�� CEMT Set DSAsDsalimit(value) EDsalimit(value)

�#

CEMT SET DSNAME

�� CEMT Set DSName (value)ALl REMOve

RECOVEREdRESetlocksRETRy

AVailableUNAvailable

�QuiescedUNQuiescedIMmquiesced

BACkoutCommitFOrce

�#

CEMT SET DUMPDS

�� CEMT Set DUmpdsOpenCLosedSwitch

AutoswitchNoautoswitch

�#

CEMT SET ENQMODEL

�� CEMT Set ENQModel(value)EnabledDIsabled

�#

CEMT SET FILE

�� CEMT Set FIle (value)ALl OPen

CLosedForceclose

ENabledDIsabled

REAdNORead

CST syntax

176 CICS TS for OS/390: CICS User’s Handbook

�UPdateNOUpdate

ADdableNOAddable

BRowseNOBrowse

DEleteNODelete

EXclusiveNOEXclusive

�EMptyreqNOEMptyreq

OldShare

RLsNOTRls

DSname(value) NOTTableCIcstableUSertableCFTable

�LOAdNOLoad

CFDtpool(value) Tablename(value)�

�COntentionLOCking

Maxnumrecs(value) Keylength(value)�

�RECordsize(value)

�#

CEMT SET GTFTRACE

�� CEMT Set GtftraceSTArtSTOp

�#

CEMT SET INTTRACE

�� CEMT Set INttraceSTArtSTOp

�#

CEMT SET IRC

�� CEMT SET IRc OpenClosedImmclose

�#

CEMT SET JOURNALNAME

�� CEMT Set Journalname(value) (value)

AllEnabledDIsabled

FLushReset

�#

CST syntax

Chapter 3. CICS-Supplied Transaction 177

CEMT SET LINE

�� CEMT Set Line(value)NUmber(value) NEgpoll(value)

�InserviceOutservice

PurgeForcepurge

�#

CEMT SET MODENAME

�� CEMT Set MODename (value)ALl COnnection(value)

�AVailable(value) ACQuired

CLosed

�#

CEMT SET MONITOR

�� CEMT Set MONitorONOFf

PerfNOPerf

EVentNOEVent

EXceptNOEXcept

�ConverseNOConverse

SYncpointNOSyncpoint

Frequency(value)�#

CEMT SET NETNAME

�� CEMT Set Netname (value)ALl PRiority(value) PAgeable

AUtopageable

�InserviceOutservice

ATiNOAti

TTiNOTti

PUrgeForcepurge

ACquiredCOldacqRELeased

�CReateNOCreate

�#

CEMT SET PROCESSTYPE

CST syntax

178 CICS TS for OS/390: CICS User’s Handbook

�� CEMT Set PROCesstypeALl

(value) ACtivityFUllOffProcess

EnabledDisabled

�#

CEMT SET PROGRAM

�� CEMT Set Program (value)CLass(value)

ALl

EnabledDIsabled

PRIvate

Shared�

�NEwcopyPHasein

CEDfNOCedf

DPlsubsetFullapi

JVMClass(value) DEBUGNODEBUG

�JVMNOJVM

�#

CEMT SET STATISTICS

�� CEMT Set STatisticsONOFf

RESetnow RECordnow�

�Interval(hhmmss) Endofday(hhmmss)

�#

CEMT SET SYDUMPCODE

�� CEMT Set SYDumpcode (value)

ALlSYsdumpNOSYsdump

SHutdownNOSHutdown

�RELatedLocal

Maximum(value) RESetREMoveADd

DaeNODae

�#

CEMT SET SYSTEM

CST syntax

Chapter 3. CICS-Supplied Transaction 179

�� CEMT Set SYStem ,

SET1SET2SET3SET4SET4aSET5

Forceqr ForceNOForce

Logdefer(value)SET6SET6SET7SET8SET9SET11SET12SET13SET14SYsdumpNOSysdump

�#

SET2

AKp(value)

SET14

Time(value)

SET1

AGing(value)

SET12

RUnaway(value)

SET7

MRobatch(value)

CST syntax

180 CICS TS for OS/390: CICS User’s Handbook

SET6

MAxtasks(value)

SET3

DSAlimit(value)

SET13

SCandelay(value)

SET5

EDsalimit(value)

SET4a

DTrprogram(value)

SET6

MAXOpentcbs(value)

SET4

DSRtprogram(value)

SET9

Progautoexit(value)

SET8

CTLGAllCTLGModifyCTLGNone

CST syntax

Chapter 3. CICS-Supplied Transaction 181

SET11

AUTOActiveAUTOInactive

CEMT SET TASK

�� CEMT Set TAsk (value)All PRiority(value) PUrge

FOrcepurge

�#

CEMT SET TCLASS

�� CEMT Set TClass (value)ALl Maxactive(value) Purgethresh(value)

�#

CEMT SET TCPIP

�� CEMT Set TCPIP (value)ALl

Openstatus(cvda)OPENCLOSEIMMCLOSE

�#

CEMT SET TCPIPSERVICE

�� CEMT Set TCPIPSERVICE (value)ALl Backlog(value)

�Openstatus(cvda)OPENCLOSEIMMCLOSE

URM(value)�#

CEMT SET TDQUEUE

�� CEMT Set TDqueue (value)All TRIggerlevel(value) ENabled

DIsabled

�OPenClosed

�#

CST syntax

182 CICS TS for OS/390: CICS User’s Handbook

CEMT SET TERMINAL

�� CEMT Set TErminal (value)CLass(value)ALl

PRiority(value) PAgeableAUtopageable

�InserviceOutservice

ATiNOAti

TTiNOTti

PUrgeForcepurgeCAncel

ACquiredCOldacqRELeased

�CReateNOCreate

�#

CEMT SET TRANSACTION

�� CEMT Set TRAnsaction (value)CLass(value)ALl

PRIority(value)�

�TClass(value) Enabled

DisabledPUrgeableNOTpurgeable

�#

CEMT SET TRDUMPCODE

�� CEMT Set TRDumpcode (value)ALl Trandump

NOTrandumpSYsdumpNOSYsdump

�SHutdownNOSHutdown

RELatedLocal

Maximum(value) RESetREMoveADd

�#

CEMT SET TSQUEUE

�� CEMT Set TSqueueALl

(value) SYSID(value)POOLNAME(value)

LAstusedint(value)�

� Action(value)DELETE

�#

CST syntax

Chapter 3. CICS-Supplied Transaction 183

CEMT SET UOW

�� CEMT Set UOW(value) (value)ALl

COMmitBackoutForce

�#

CEMT SET UOWLINK

�� CEMT Set UOWlink(value) (value)ALl

Delete �#

CEMT SET VTAM

�� CEMT Set Vtam OpenClosedImmcloseForceclose

Psdinterval(hhmmss) Deregistered�#

CEOT

�� CEOTPAgeableAUtopageable

ATiNOAti

TTiNOTti

�#

CESF

�� CESFGOODNIGHTLOGOFF

�#

CESN

�� CESN USERID=uuuuuuuu CESN USERID=uuuuuuuu,GROUPID=gggggggg

�,LANGUAGE=lll ,PS=pppppppp ,NEWPS=password

�#

Notes:

1 Do not use blanks between parameters in the comma-separated list.

CMSG

�� CMSGMSG=

’message’ �

CST syntax

184 CICS TS for OS/390: CICS User’s Handbook

,

, ,

,ROUTE= Termid /opidALL

.termlist ,±termid /opid

� ,

,OPCLASS=n ,TIME=value ,DATE=value,FULLDATE=value

�,ERRTERM= Termid

ORIG,ID=(title) ,HEADING= YES

NO

�,PROTECT= YES

NOPrefix

,SEND,CANCEL

�#

ROUTE

�� ROUTE= ,

,

Termid *ldc /opidALL *ldc

.termlist *ldc Idloop

�#

Idloop:

,

,±termid *ldc /opid

CRTE

�� CRTE SYSID=sysid,TRPROF=trprof

�#

CSFE SPOOLFE

CST syntax

Chapter 3. CICS-Supplied Transaction 185

�� CSFE spoolfe= ONOFF

�#

CSFE ZCQTRACE

�� CSFE zcqtrace =termid,AUTOINSTALL,OFF

�#

CSFE DEBUG TRANID

�� CSFE debug ,TRANID=xxxx,TASKREQ=yyy OFF

,STGFRZ= ON

�#

CSFE DEBUG CHKSTSK

�� CSFE debug ,CHKSTSK= CURRENTNONE

,CHKSTRM= CURRENTNONE

�#

CSPG GETPAGE

�� CSPG GetpageA

B*ldc*ALL

,hhhhhh�#

CSPG MESSCHNYYYY

�� CSPG MesschnyyyyParameters

�#

CSPG MSGTERM

�� CSPG Msgterm ABCHR

,hhhhhh�#

CST syntax

186 CICS TS for OS/390: CICS User’s Handbook

CWTO

�� CWTO Message �#

CST syntax

Chapter 3. CICS-Supplied Transaction 187

CST syntax

188 CICS TS for OS/390: CICS User’s Handbook

Chapter 4. Resource definition online

The syntax diagrams that follow are taken from the CICS Resource Definition Guide.

ADD syntax

�� ADd Group(groupname1) LIst(listname)Before(groupname2)After(groupname3)

�#

ALTER syntax

�� ALter 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)TErminal(name)TDqueue(name)TRANClass(name)TRANSaction(name)TSmodel(name)TYpeterm(name)

Group(groupname) attribute list(new value) �#

APPEND syntax

�� APpend LIst(listname1) To(listname2) �#

CHECK syntax

�� CHeck Group(groupname)List(listname1, listname2, listname3, listname4) Remotesystem(sysid)

�#

© Copyright IBM Corp. 1989, 2000 189

COPY syntax

�� COpyAll

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)

Group(groupname) AS(newname)TO(newgroupname)AS(new-name) TO(newgroupname)

ReplaceMErge

�#

USERDEFINE syntax

�� USerdefine 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)

Group(groupname) attribute list(newvalue) �#

RDO

190 CICS TS for OS/390: CICS User’s Handbook

DEFINE syntax

�� DEFine 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)

Group(groupname) attribute list(newvalue) �#

DELETE syntax

�� DELete AllConnection(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)

Group(groupname)REMove

�#

RDO

Chapter 4. Resource definition online 191

DISPLAY syntax

�� DISplay List(listname)Group(groupname)

Group(groupname)ALl(name) REnameConnection(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)

�#

RDO

192 CICS TS for OS/390: CICS User’s Handbook

EXPAND syntax

�� EXPand List(listname)Group(groupname)

Group(groupname)ALl(name) REnameConnection(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)

�#

RDO

Chapter 4. Resource definition online 193

INSTALL syntax

�� InstallALl(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)PROCesstype(name)PROFile(name)PROGram(name)Requestmodel(name)TCpipservice(name)TDqueue(name)TErminal(name)TRANClass(name)TRANSaction(name)TSmodel(name)TYpeterm(name)

Group(groupname)List(listname)

�#

LOCK syntax

�� Lock Group(groupname)List(listname)

�#

RDO

194 CICS TS for OS/390: CICS User’s Handbook

MOVE syntax

�� MoveAll

Connection(name)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)

Group(groupname)REMove

AS(newname)TO(newgroupname)AS(newname) TO(newgroupname)

�REPlaceMErge

�#

REMOVE syntax

�� REMove Group(groupname) List(listname) �#

RDO

Chapter 4. Resource definition online 195

RENAME syntax

�� RENameALl(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)PROCesstype(name)PROFile(name)PROGram(name)REQuestmodel(name)Sessions(name)TCpipservice(name)TDqueue(name)TErminal(name)TRANClass(name)TRANSaction(name)TSmodel(name)TYpeterm(name)

Group(groupname) AS(newname) TO(newgroupname)�

�REMove

�#

UNLOCK syntax

�� UNLock Group(groupname)List(listname)

�#

RDO

196 CICS TS for OS/390: CICS User’s Handbook

USERDEFINE syntax

�� USerdefine 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)

Group(groupname) attribute list(newvalue) �#

VIEW syntax

�� View Group(groupname)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)

�#

RDO

Chapter 4. Resource definition online 197

198 CICS TS for OS/390: CICS User’s Handbook

Chapter 5. DFHCSDUP commands

The syntax diagrams that follow are taken from the CICS Resource Definition Guide.

ADD syntax

�� ADd Group(groupname) LIst(listname) �#

ALTER syntax

�� ALter 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)

Group(groupname) attribute list(new value) �#

APPEND syntax

�� APpend FRomcsd(ddname) LIst(listname1) To(listname2) �#

COPY syntax

�� Copy Group(groupname1) To(groupname2)ReplaceMErge

FRomcsd(ddname) �#

© Copyright IBM Corp. 1989, 2000 199

DEFINE syntax

�� DEFine 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)

Group(groupname) attribute list(newvalue) �#

DELETE syntax

�� DELete List(listname)Group(groupname) All

Connection(name) REMoveDB2Conn(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)

�#

CSD

200 CICS TS for OS/390: CICS User’s Handbook

EXTRACT syntax

�� EXtract Group(groupname)LIst(listname)

USerprogram(DFHxCRFy)USerprogram(DFHxFORy)USerprogram(DFH0CBDC)USerprogram(user-written program)

Objects�#

INITIALIZE syntax

�� INITialize �#

LIST syntax

�� LIstAll

Group(groupname)LIst(listname)

Objects�#

MIGRATE syntax

�� MIgrate TAble(tablename)TYpesgroup(typesgroupname) TOGROUP(groupname)

�#

REMOVE syntax

�� Remove Group(groupname) LIst(listname) �#

CSD

Chapter 5. DFHCSDUP commands 201

SCAN syntax

�� SCAN 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)

ALIAS(aliasname)�#

SERVICE syntax

�� Service FRomcsd(ddname) LEvel(nnn) �#

UPGRADE syntax

�� UPgradeUSing(filename) Replace

�#

VERIFY syntax

�� VERIFY �#

CSD

202 CICS TS for OS/390: CICS User’s Handbook

Chapter 6. Front End Programming Interface commandreference

This chapter contains General Use Programming Interface information.

FEPI application programming

FEPI ALLOCATE PASSCONVID

�� FEPI ALLOCATE PASSCONVID(data-value) �#

Notes:

1 INVREQ

FEPI ALLOCATE POOL

�� FEPI ALLOCATE POOL(data-value) CONVID(data-area)TARGET(data-value)

�TIMEOUT(data-value) SEQNUMIN(data-area) SEQNUMOUT(data-area)

�SESSNSTATUS(cvda)

�#

Notes:

1 INVREQ

FEPI AP NOOP

�� FEPI AP NOOP �#

Notes:

1 INVREQ

Previously allocated conversation

FEPI CONVERSE DATASTREAM

�� FEPI CONVERSE DATASTREAM CONVID(data-value) FROM(data-value) �

© Copyright IBM Corp. 1989, 2000 203

�FROMFLENGTH(data-value)

CHAIN

RUUNTILCDEB

ENDSTATUS(cvda) FMH�

�FMHSTATUS(cvda) INTO(data-area) INTO options

�REMFLENGTH(data-area) RESPSTATUS(cvda) SEQNUMIN(data-area)

�SEQNUMOUT(data-area) TIMEOUT(data-value)

�#

INTO options:

MAXFLENGTH(data-value) TOFLENGTH(data-area)

Notes:

1 INVREQ

Temporary conversation

FEPI CONVERSE DATASTREAM

�� FEPI CONVERSE DATASTREAM POOL(data-value)TARGET(data-value)

� FROM(data-value)FROMFLENGTH(data-value)

UNTILCDEB�

�ENDSTATUS(cvda) FMH FMHSTATUS(cvda)

�INTO(data-area) INTO options REMFLENGTH(data-area)

�RESPSTATUS(cvda) SEQNUMIN(data-area) SEQNUMOUT(data-area)

�TIMEOUT(data-value)

�#

FEPI programming

204 CICS TS for OS/390: CICS User’s Handbook

INTO options:

MAXFLENGTH(data-value) TOFLENGTH(data-area)

Notes:

1 INVREQ

Previously allocated conversation

FEPI CONVERSE FORMATTED

�� FEPI CONVERSE FORMATTED CONVID(data-value) FROM(data-value) �

�FROMFLENGTH(data-value)

� AID(data-value)FROMCURSOR(data-value)

KEYSTROKESESCAPE(data-value)

�INTO(data-area) INTO options ALARMSTATUS(cvda)

�COLUMNS(data-area) ENDSTATUS(cvda) FIELDS(data-area)

�LINES(data-area) RESPSTATUS(cvda) TIMEOUT(data-value)

�TOCURSOR(data-area)

�#

INTO options:

MAXFLENGTH(data-value) TOFLENGTH(data-area)

Notes:

1 INVREQ

FEPI programming

Chapter 6. FEPI command reference 205

Temporary conversation

FEPI CONVERSE FORMATTED

�� FEPI CONVERSE FORMATTED POOL(data-value)TARGET(data-value)

� FROM(data-value)FROMFLENGTH(data-value)

KEYSTROKES �

�ESCAPE(data-value) INTO(data-area) INTO options

�ALARMSTATUS(cvda) COLUMNS(data-area) ENDSTATUS(cvda)

�FIELDS(data-area) LINES(data-area) RESPSTATUS(cvda)

�TIMEOUT(data-value) TOCURSOR(data-area)

�#

INTO options:

MAXFLENGTH(data-value) TOFLENGTH(data-area)

Notes:

1 INVREQ

FEPI EXTRACT CONV

�� FEPI EXTRACT CONV CONVID(data-value)DEVICE(cvda) FORMAT(cvda)

�POOL(data-area) TARGET(data-area) NODE(data-area)

�SENSEDATA(data-area)

�#

Notes:

1 INVREQ

FEPI programming

206 CICS TS for OS/390: CICS User’s Handbook

FEPI EXTRACT FIELD

�� FEPI EXTRACT FIELD CONVID(data-value) FIELDLOC(data-value)FIELDNUM(data-value)

�INTO(data-area) INTO options BACKGROUND(data-area)

�COLOR(data-area) FIELDATTR(data-area) HILIGHT(data-area)

�INPUTCONTROL(data-area) MDT(cvda) OUTLINE(data-area)

�POSITION(data-area) PROTECT(cvda) PS(data-area)

�SIZE(data-area) TRANSPARENCY(data-area) VALIDATION(data-area)

�#

INTO options:

MAXFLENGTH(data-value) FLENGTH(data-area)

Notes:

1 INVREQ

FEPI EXTRACT STSN

�� FEPI EXTRACT STSN CONVID(data-value)SEQNUMIN(data-area)

�SEQNUMOUT(data-area) STSNSTATUS(cvda)

�#

Notes:

1 INVREQ

FEPI programming

Chapter 6. FEPI command reference 207

FEPI FREE

�� FEPI FREE CONVID(data-value)HOLD

RELEASEFORCEPASS

�#

Notes:

1 INVREQ

FEPI ISSUE

�� FEPI ISSUE CONVID(data-value) CONTROL(cvda)SENSEDATA(data-value)

�VALUE(cvda)

�#

Notes:

1 INVREQ

FEPI RECEIVE DATASTREAM

�� FEPI RECEIVE DATASTREAM CONVID(data-value)CHAIN

RUUNTILCDEB

�ENDSTATUS(cvda) FMHSTATUS(cvda)

�INTO(data-area) INTO options REMFLENGTH(data-area)

�RESPSTATUS(cvda) SEQNUMIN(data-area) SEQNUMOUT(data-area)

�TIMEOUT(data-value)

�#

INTO options:

MAXFLENGTH(data-value) FLENGTH(data-area)

FEPI programming

208 CICS TS for OS/390: CICS User’s Handbook

Notes:

1 INVREQ

FEPI RECEIVE FORMATTED

�� FEPI RECEIVE FORMATTED CONVID(data-value) �

�INTO(data-area) INTO options ALARMSTATUS(cvda)

�COLUMNS(data-area) CURSOR(data-area) ENDSTATUS(cvda)

�FIELDS(data-area) LINES(data-area) RESPSTATUS(cvda)

�TIMEOUT(data-value)

�#

INTO options:

MAXFLENGTH(data-value) FLENGTH(data-area)

Notes:

1 INVREQ

FEPI REQUEST PASSTICKET

�� FEPI REQUEST PASSTICKET(data-area) CONVID(data-value) �

�ESMRESP(data-area) ESMREASON(data-area)

�#

Notes:

1 INVREQ

FEPI SEND DATASTREAM

�� FEPI SEND DATASTREAM CONVID(data-value) FROM(data-value) �

�FLENGTH(data-value) INVITE FMH SEQNUMIN(data-area)

FEPI programming

Chapter 6. FEPI command reference 209

�SEQNUMOUT(data-area)

�#

Notes:

1 INVREQ

FEPI SEND FORMATTED

�� FEPI SEND FORMATTED CONVID(data-value) FROM(data-value) �

�FLENGTH(data-value)

AID(data-value)CURSOR(data-value)

KEYSTROKESESCAPE(data-value)

�#

Notes:

1 INVREQ

FEPI START

�� FEPI START CONVID(data-value) TRANSID(data-value) �

�TERMID(data-value) USERDATA(data-value)

FLENGTH(data-value)

�TIMEOUT(data-value)

�#

Notes:

1 INVREQ

FEPI system programming

FEPI ADD POOL

�� FEPI ADD POOL(data-value)ACQUIRED

ACQSTATUS(cvda)RELEASED

FEPI programming

210 CICS TS for OS/390: CICS User’s Handbook

�NODELIST(data-area) NODENUM(data-value)

INSERVICE

SERVSTATUS(cvda)OUTSERVICE

�TARGETLIST(data-area) TARGETNUM(data-value)

�#

Notes:

1 INVREQ, NOTAUTH

FEPI DELETE POOL

�� FEPI DELETE POOL(data-value) �

�NODELIST(data-area) NODENUM(data-value)

�TARGETLIST(data-area) TARGETNUM(data-value)

�#

Notes:

1 INVREQ, NOTAUTH

FEPI DISCARD NODELIST

�� FEPI DISCARD NODELIST(data-area) NODENUM(data-value) �#

Notes:

1 INVREQ, NOTAUTH

FEPI DISCARD POOL

�� FEPI DISCARD POOL(data-value) �#

Notes:

1 INVREQ, NOTAUTH

FEPI DISCARD PROPERTYSET

�� FEPI DISCARD PROPERTYSET(data-value) �#

Notes:

1 INVREQ, NOTAUTH

FEPI programming

Chapter 6. FEPI command reference 211

FEPI DISCARD TARGETLIST

�� FEPI DISCARD TARGETLIST(data-area) TARGETNUM(data-value) �#

Notes:

1 INVREQ, NOTAUTH

FEPI INQUIRE CONNECTION

�� FEPI INQUIRE CONNECTION NODE(data-value) TARGET(data-value) �

�ACQNUM(data-area) ACQSTATUS(cvda) CONVNUM(data-area)

�INSTLSTATUS(cvda) LASTACQCODE(data-area) POOL(data-area)

�SERVSTATUS(cvda) STATE(cvda) USERDATA(data-area)

�WAITCONVNUM(data-area)

�#

Notes:

1 END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE NODE

�� FEPI INQUIRE NODE(data-value)ACQNUM(data-area) ACQSTATUS(cvda)

�INSTLSTATUS(cvda) LASTACQCODE(data-area) SERVSTATUS(cvda)

�USERDATA(data-area)

�#

Notes:

1 END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE POOL

�� FEPI INQUIRE POOL(data-value)BEGINSESSION(data-area)

FEPI programming

212 CICS TS for OS/390: CICS User’s Handbook

�CONTENTION(cvda) DEVICE(cvda) ENDSESSION(data-area)

�EXCEPTIONQ(data-area) FJOURNALNUM(data-area) FORMAT(cvda)

�INITIALDATA(cvda) INSTLSTATUS(cvda) MAXFLENGTH(data-area)

�MSGJRNL(cvda) PROPERTYSET(data-area) SERVSTATUS(cvda)

�STSN(data-area) UNSOLDATA(data-area) UNSOLDATACK(cvda)

�USERDATA(data-area) WAITCONVNUM(data-area)

�#

Notes:

1 END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE PROPERTYSET

�� FEPI INQUIRE PROPERTYSET(data-value)BEGINSESSION(data-area)

�CONTENTION(cvda) DEVICE(cvda) ENDSESSION(data-area)

�EXCEPTIONQ(data-area) FJOURNALNUM(data-area) FORMAT(cvda)

�INITIALDATA(cvda) MAXFLENGTH(data-area) MSGJRNL(cvda)

�STSN(data-area) UNSOLDATA(data-area) UNSOLDATACK(cvda)

�#

Notes:

1 END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE TARGET

�� FEPI INQUIRE TARGET(data-value)APPL(data-area)

FEPI programming

Chapter 6. FEPI command reference 213

�INSTLSTATUS(cvda) SERVSTATUS(cvda) USERDATA(data-area)

�#

Notes:

1 END, ILLOGIC, INVREQ, NOTAUTH

FEPI INSTALL NODELIST

�� FEPI INSTALL NODELIST(data-area) NODENUM(data-value) �

�ACQUIRED

ACQSTATUS(cvda)RELEASED

PASSWORDLIST(data-area)

INSERVICE

SERVSTATUS(cvda)OUTSERVICE

�#

Notes:

1 INVREQ, NOTAUTH

FEPI INSTALL POOL

�� FEPI INSTALL POOL(data-value) PROPERTYSET(data-value) �

�ACQUIRED

ACQSTATUS(cvda)RELEASED

NODELIST(data-area) NODENUM(data-value)�

�INSERVICE

SERVSTATUS(cvda)OUTSERVICE

TARGETLIST(data-area) TARGETNUM(data-value)�#

Notes:

1 INVREQ, NOTAUTH

FEPI INSTALL PROPERTYSET

�� FEPI INSTALL PROPERTYSET(data-value)BEGINSESSION(data-value)

FEPI programming

214 CICS TS for OS/390: CICS User’s Handbook

�LOSE

CONTENTION(cvda)WIN

T3278M2

DEVICE(cvda)T3278M3T3278M4T3278M5T3279M2T3279M3T3279M4T3279M5TPS55M2TPS55M3TPS55M4LUP

ENDSESSION(data-value)�

�EXCEPTIONQ(data-value) FJOURNALNUM(data-value)

FORMATTED

FORMAT(cvda)DATASTREAM

�NOTINBOUND

INITIALDATA(cvda)INBOUND

MAXFLENGTH(data-value)

NOMSGJRNL

MSGJRNL(cvda)INPUTOUTPUTINOUT

�STSN(data-value) NEGATIVE

UNSOLDATA(data-value) UNSOLDATACK(cvda)POSITIVE

�#

Notes:

1 INVREQ, NOTAUTH

FEPI INSTALL TARGETLIST

�� FEPI INSTALL TARGETLIST(data-area) APPLLIST(data-area) �

� TARGETNUM(data-value)INSERVICE

SERVSTATUS(cvda)OUTSERVICE

�#

Notes:

1 INVREQ, NOTAUTH

FEPI SET CONNECTION

�� FEPI SET CONNECTION NODE(data-value)NODELIST(data-area) NODENUM(data-value)

FEPI programming

Chapter 6. FEPI command reference 215

� TARGET(data-value)TARGETLIST(data-area) TARGETNUM(data-value) ACQSTATUS(cvda)

ACQUIREDRELEASED

�SERVSTATUS(cvda)INSERVICEOUTSERVICE

USERDATA(data-value)�#

Notes:

1 INVREQ, NOTAUTH

FEPI SET NODE

�� FEPI SET NODE(data-value)NODELIST(data-area) NODENUM(data-value)

�ACQSTATUS(cvda)ACQUIREDRELEASED

SERVSTATUS(cvda)INSERVICEOUTSERVICE

USERDATA(data-value)�#

Notes:

1 INVREQ, NOTAUTH

FEPI SET POOL

�� FEPI SET POOL(data-value)POOLLIST(data-area) POOLNUM(data-value)

�SERVSTATUS(cvda)INSERVICEOUTSERVICE

USERDATA(data-value)�#

Notes:

1 INVREQ, NOTAUTH

FEPI SET TARGET

�� FEPI SET TARGET(data-value)TARGETLIST(data-area) TARGETNUM(data-value)

FEPI programming

216 CICS TS for OS/390: CICS User’s Handbook

�SERVSTATUS(cvda)INSERVICEOUTSERVICE

USERDATA(data-value)�#

Notes:

1 INVREQ, NOTAUTH

FEPI SP NOOP

�� FEPI SP NOOP �#

Notes:

1 INVREQ, NOTAUTH

FEPI programming

Chapter 6. FEPI command reference 217

FEPI programming

218 CICS TS for OS/390: CICS User’s Handbook

Chapter 7. CICS-value data areas used by all commands

This chapter contains General-use Programming Interface information.

This § lists the CICS-value data-area (CVDA) values and their numeric equivalentsfor all of the EXEC CICS commands. CVDAs are described in the CICS SystemProgramming Reference.

Using the tablesThe § consists of three tables. The first, beginning below, is in charactersequence of the CVDA values. The second, beginning on page 232, is innumeric sequence. The third, beginning on page 244, gives the CVDA valuesreturned by the INQUIRE TERMINAL|NETNAME DEVICE command.

CVDAs and numeric values in alphabetic sequence

CVDA DecValueHexValueABEND 900 384ACQFAIL 515 203ACQUIRED 69 45ACQUIRING 71 48ACTIVE 181 B5ACTIVITY 1002 3EAADD 291 123ADDABLE 41 29ADDFAIL 519 207ADVANCE 265 109ALARM 501 1F5ALLCONN 169 A9ALLOCTD 81 51ALLQUERY 431 1AFALTERABLE 52 34ALTERNATE 197 C5ALTPRTCOPY 446 1BEAND 1005 3EDANY 158 9EAPLKYBD 391 187APLTEXT 393 198APPC 124 7CAPPCPARALLEL 374 176APPCSINGLE 373 175APPEND 1036 40CAPPLICATION 559 22FASACTL 224 E0ASCII7 616 268ASCII8 617 267ASSEMBLER 150 96ATI 75 4BATTENTION 524 20CAUDALARM 395 18B

© Copyright IBM Corp. 1989, 2000 219

CVDA DecValueHexValueAUTOACTIVE 630 276AUTOARCH 262 106AUTOAUTH 1095 447AUTOCONN 170 AAAUTOINACTIVE 631 277AUTOPAGEABLE 80 50AUTOREGISTER 1094 446AUTOSTART 618 26AAUXILIARY 247 F7AUXPAUSE 313 139AUXSTART 312 138AUXSTOP 314 13AAVAILABLE 95 5FBACKOUT 192 C0BACKTRANS 397 18DBACKUPNONBWO 800 320BASE 10 ABASEAPI 1052 41CBASESPACE 664 298BASICAUTH 1092 444BDAM 2 2BEGINSESSION 510 1FEBELOW 159 9FBGAM 63 3FBINARY 1038 40EBLK 47 2FBLOCKED 16 10BROWSABLE 39 27BSAM 61 3DBTAM 62 3EBUSY 612 264C 149 95CACHE 791 317CANCEL 526 20ECANCELLED 624 270CANCELLING 1025 401CD 491 1EBCEDF 370 172CERTIFICAUTH 1093 445CFTABLE 833 341CGROUP 902 386CICS 660 294CICSDATAKEY 379 17BCICSEXECKEY 381 17DCICSTABLE 101 65CKOPEN 1055 41FCLEAR 640 280CLIENTAUTH 1032 408CLOSED 19 13CLOSELEAVE 261 105CLOSEREQUEST 22 16CLOSING 21 15CMDPROT 673 2A1CMDSECNO 205 CD

CVDA

220 CICS TS for OS/390: CICS User’s Handbook

|||

|||

|||

|||

CVDA DecValueHexValueCMDSECYES 207 CFCOBOL 151 97COBOLII 375 177COLD 788 314COLDACQ 72 48COLDQUERY 433 1B1COLDSTART 266 10ACOLOR 399 18FCOMMIT 208 D0COMMITFAIL 792 318COMPLETE 1026 402COMPOSITE 1003’ 3EBCONFFREE 82 52CONFRECEIVE 83 53CONFSEND 84 54CONNECT 903 387CONNECTED 690 2B2CONNECTING 904 388CONNECTION 755 2F3CONSISTENT 723 2D3CONSOLE 66 42CONTENTION 836 344CONTROLSHUT 623 26FCONVERSE 600 258CONVIDLE 518 206COORDINATOR 770 302COPID 908 38CCOPY 401 191CREATE 67 43CSIGN 905 389CTERM 906 38ACTLGALL 632 278CTLGMODIFY 633 279CTLGNONE 634 27ACTRLABLE 56 38CTX 907 38BCURRENT 260 104CUSERID 909 38DDAE 684 2ACDATA 508 1FCDATASET 756 2F4DATASETFULL 793 319DATASTREAM 543 21FDEADLOCK 794 31ADEBUG 1082 43ADEC 46 2EDEFAULT 198 C6DEFRESP1 497 1F1DEFRESP1OR2 528 210DEFRESP2 498 1F2DEFRESP3 499 1F3DELAY 637 27DDELETABLE 43 2BDELETE 292 124

CVDA

Chapter 7. CICS-value data areas used by all commands 221

CVDA DecValueHexValueDELETEFAIL 520 208DELEXITERROR 795 31BDEREGERROR 679 2A7DEREGISTERED 678 2A6DEST 235 EBDISABLED 24 18DISABLING 25 19DISCARDFAIL 513 201DISCONNING 910 38EDISCREQ 444 1BCDISK1 252 FCDISK2 253 FDDISK2PAUSE 254 FEDISPATCHABLE 228 E4DORMANT 1024 400DPLSUBSET 383 17FDS3270 615 267DUALCASE 403 193DUMMY 781 30DDYNAMIC 178 B2EB 490 1EAEBCDIC 1039 40FEMERGENCY 268 10CEMPTY 210 D2EMPTYREQ 31 1FENABLED 23 17ENDAFFINITY 790 316EQUAL 911 38FESDS 5 5EVENT 334 14EEVENTFAIL 1012 3F4EXCEPT 332 14CEXCEPTRESP 523 20BEXCI 650 28AEXCTL 48 30EXECENQ 751 2EFEXECENQADDR 752 2F0EXIT 912 390EXITTRACE 362 16AEXPIRED 1017 3F9EXTENDEDDS 405 195EXTRA 221 DDEXTSECURITY 194 C2FAILED 782 30EFAILEDBKOUT 357 165FAILINGBKOUT 358 166FCLOSE 273 111FINALQUIESCE 183 B7FINPUT 270 10EFIRED 1001 3E9FIRSTINIT 625 271FIRSTQUIESCE 182 B6FIXED 12 CFLUSH 783 30F

CVDA

222 CICS TS for OS/390: CICS User’s Handbook

CVDA DecValueHexValueFMH 502 1F6FMHPARM 385 181FOPEN 272 110FORCE 342 156FORCECANCEL 655 28FFORCECLOSE 351 15FFORCECLOSING 353 161FORCED 1013 3F5FORCEPURGE 237 EDFORMATEDF 606 25EFORMATTED 542 21EFORMFEED 407 197FOUTPUT 271 10FFREE 85 55FREEING 94 5EFULL 212 D4FULLAPI 384 180FULLAUTO 1073 431FWDRECOVABLE 354 162GENERIC 651 28BGMT 604 25CGOINGOUT 172 ACGROUP 913 391GTFSTART 317 13DGTFSTOP 318 13EHEURBACKOUT 758 2F6HEURCOMMIT 757 2F5HEX 45 2DHFORM 409 199HIGH 914 392HILIGHT 413 19DHOLD 163 A3HTTPNO 1034 40AHTTPYES 1033 409IGNORE 1 1IGNORERR 816 330IMMCLOSE 350 15EIMMCLOSING 352 160IMMQUIESCED 706 2C2INACTIVE 378 17AINBOUND 547 223INCOMPLETE 1014 3F6INDEXRECFULL 796 31CINDIRECT 122 7AINDOUBT 620 26CINFLIGHT 621 25DINITCOMPLETE 628 274INITIAL 789 315INOUT 532 214INPUT 226 E2INSERVICE 73 49INSTALLED 550 226INSTALLFAIL 512 200INTERNAL 1058 422

CVDA

Chapter 7. CICS-value data areas used by all commands 223

CVDA DecValueHexValueINTRA 222 DEINTSTART 310 136INTSTOP 311 137INVALID 359 167IOERROR 797 31DIRC 121 79ISOLATE 658 292JVM 1080 438KATAKANA 415 19FKEYED 8 8KSDS 6 6LCKSTRUCFULL 832’ 340LEAVE 811 32BLE370 377 179LIC 493 1EDLIGHTPEN 417 1A1LOAD 834 342LOCAL 605 25DLOCKING 837 345LOG 54 36LOGICAL 216 D8LOGTERM 269 10DLOSE 544 220LOW 915 393LPA 165 A5LUP 541 21DLUSTAT 525 20DLU61 125 7DMAIN 248 F8MAP 155 9BMAPSET 155 9BMCHCTL 241 F1MDT 506 1FAMOD 813 32DMODEL 370 172MORE 492 1ECMSRCONTROL 419 1A3MVS 780 30CNATIVE 1084 43CNEGATIVE 530 212NEWCOPY 167 A7NEWSESSION 485 1E5NOALARM 500 1F4NOALTPRTCOPY 447 1BFNOAPLKYBD 392 188NOAPLTEXT 394 18ANOAPPEND 1037 40DNOATI 76 4CNOAUDALARM 396 18CNOAUTHENTIC 1091 443NOAUTO 1071 42FNOAUTOARCH 263 107NOBACKTRANS 398 18ENOCEDF 371 173

CVDA

224 CICS TS for OS/390: CICS User’s Handbook

|||

|||

CVDA DecValueHexValueNOCLEAR 641 281NOCMDPROT 674 2A2NOCOLOR 400 190NOCONNECT 916 394NOCONV 556 22CNOCONVERSE 601 259NOCOPY 402 192NOCREATE 68 44NOCTL 223 DFNODAE 685 2ADNODEDUG 1083 43BNODISCREQ 445 1BDNODUALCASE 404 194NOEMPTYREQ 32 20NOEVENT 335 14FNOEXCEPT 333 14DNOEXCTL 49 31NOEXIT 917 395NOEXITTRACE 363 16BNOEXTENDEDDS 406 196NOFMH 503 1F7NOFMHPARM 386 182NOFORCE 1054 41ENOFORMATEDF 607 25FNOFORMFEED 408 198NOHFORM 410 19ANOHILIGHT 414 19ENOHOLD 164 A4NOISOLATE 657 291NOJVM 1081 439NOKATAKANA 416 1A0NOLIGHTPEN 418 1A2NOLOAD 835 343NOLOG 55 37NOLOSTLOCKS 710 2C6NOMDT 507 1FBNOMSGJRNL 531 213NOMSRCONTROL 420 1A4NONAUTOCONN 171 ABNONCICS 661 295NONE 496 1F0NOOBFORMAT 422 1A6NOOBOPERID 388 184NOOUTLINE 424 1A8NOPARTITIONS 426 1AANOPERF 331 14BNOPRESETSEC 243 F3NOPRINTADAPT 428 1ACNOPROGSYMBOL 430 1AENOPRTCOPY 449 1C1NOQUERY 432 1B0NORECOVDATA 700 2BCNOREENTPROT 681 2A9NORELEASE 918 396

CVDA

Chapter 7. CICS-value data areas used by all commands 225

CVDA DecValueHexValueNORELREQ 443 1BBNORETAINED 711 2C7NORMAL 1016 3F8NORMALBKOUT 356 164NORMALRESP 522 20ANOROLLBACK 919 397NOSECURITY 196 C4NOSHUTDOWN 289 121NOSOSI 435 1B3NOSPI 694 2B6NOSSL 1031 407NOSTSN 487 1E7NOSWITCH 285 11DNOSYNCPOINT 603 25BNOSYSCONNECT 654 28ENOSYSDUMP 185 B9NOSYSLOG 784 310NOTADDABLE 42 2ANOTALTERABLE 53 35NOTAPPLIC 1 1NOTASKSTART 608 260NOTBROWSABLE 40 28NOTBUSY 613 265NOTCDEB 495 1EFNOTCONNECTED 691 2B3NOTCTRLABLE 57 39NOTDEFINED 659 293NOTDELETABLE 44 2CNOTDYNAMIC 1021 3FDNOTEMPTY 211 D3NOTERMINAL 214 D6NOTEXTKYBD 437 1B5NOTEXTPRINT 439 1B7NOTFIRED 1000 3E8NOTFWDRCVBLE 361 169NOTINBOUND 546 222NOTINIT 376 178NOTINSTALLED 551 227NOTKEYED 9 9NOTLPA 166 A6NOTPENDING 127 7FNOTPURGEABLE 161 A1NOTRANDUMP 187 BBNOTREADABLE 36 24NOTREADY 259 103NOTRECOVABLE 30 1ENOTREQUIRED 667 29BNOTRLS 721 2D1NOTROUTABLE 1022 3FENOTSOS 669 29DNOTSUPPORTED 15 FNOTSUSPENDED 1027 403NOTTABLE 100 64NOTTI 78 4E

CVDA

226 CICS TS for OS/390: CICS User’s Handbook

CVDA DecValueHexValueNOTUPDATABLE 38 26NOTWAIT 920 398NOUCTRAN 451 1C3NOUSER 1011 3F3NOVALIDATION 441 1B9NOVFORM 412 19CNOWAIT 341 155NOWRITE 275 113NOZCPTRACE 365 16DNRS 774 306N906 931 3A3N906D 921 399OBFORMAT 421 1A5OBOPERID 387 183OBTAINING 96 60OFF 200 C8OK 274 112OLD 26 1AOLDCOPY 162 A2OLDSESSION 486 1E6ON 201 C9OPEN 18 12OPENAPI 1053 41DOPENERROR 798 31EOPENING 20 14OPENINPUT 256 100OPENOUTPUT 257 101OPID 933 3A5OR 1006 3EEOUTLINE 423 1A7OUTPUT 227 E3OUTSERVICE 74 4AOWNER 753 2F1PAGEABLE 79 4FPARTITIONS 425 1A9PARTITIONSET 156 9CPATH 11 BPENDBEGIN 558 22EPENDDATA 560 230PENDFREE 86 56PENDING 126 7EPENDPASS 565 235PENDRECEIVE 87 57PENDRELEASE 562 232PENDSTART 561 231PENDSTSN 557 22DPENDUNSOL 564 234PERF 330 14APHASEIN 168 A8PHYSICAL 215 D7PLI 152 98PL1 152 98POOL 922 39APOSITIVE 529 211

CVDA

Chapter 7. CICS-value data areas used by all commands 227

CVDA DecValueHexValuePOST 636 27CPRESETSEC 242 F2PRIMARY 110 6EPRINTADAPT 427 1ABPRIVATE 174 AEPROCESS 1010 3F2PROGAUTO 1072 430PROGRAM 154 9APROGSYMBOL 429 1ADPROTECTED 504 1F8PRTCOPY 448 1C0PURGE 236 ECPURGEABLE 160 A0QR 1057 421QUASIRENT 1050 41AQUEUE 814 32EQUIESCED 707 2C3QUIESCING 708 2C4READABLE 35 23READBACK 209 D1READONLY 275 113READY 258 102REBUILD 923 39BRECEIVE 88 58RECONNECT 924 39CRECOVDATA 701 2BDRECOVERABLE 29 1DRECOVERED 277 115RECOVERLOCKS 712 2C8REENTPROT 680 2A8REGERROR 677 2A5REGISTERED 670 29EREJECT 815 32FRELATED 675 2A3RELEASE 563 233RELEASED 70 46RELEASING 549 225RELREQ 442 1BAREMLOSTLOCKS 713 2C9REMOTE 4 4REMOVE 276 114REMSESSION 740 2E4REMTABLE 103 67REPEATABLE 724 2D4REQUIRED 666 29AREREAD 812 32CRESET 290 122RESETLOCKS 714 2CARESSECINT 203 CBRESSECNO 202 CARESSECYES 204 CCRESYNC 702 2BERETAINED 715 2CBRETRY 716 2CC

CVDA

228 CICS TS for OS/390: CICS User’s Handbook

CVDA DecValueHexValueREVERTED 264 108REWIND 811 32BRLS 720 2D0RLSACTIVE 730 2DARLSGONE 799 31FRLSINACTIVE 731 2DBRLSSERVER 761 2F9RMI 771 303ROLLBACK 89 59ROUTABLE 1023 3FFROUTE 638 27ERRCOMMITFAIL 830 33ERRDS 7 7RRINDOUBT 831 33FRRMS 1062 426RTR 527 20FRU 494 1EERUNNING 229 E5SCS 614 266SECONDINIT 626 272SEND 90 5ASESSION 372 174SESSIONFAIL 517 205SESSIONLOST 516 204SETFAIL 514 202SHARE 27 1BSHARED 173 ADSHUNTED 762 2FASHUTDISABLED 645 285SHUTDOWN 288 120SHUTENABLED 644 284SIGN 925 39DSIGNEDOFF 245 F5SIGNEDON 244 F4SINGLEOFF 324 144SINGLEON 323 143SKIP 810 32ASMF 255 FFSOS 668 29CSOSABOVE 683 2ABSOSBELOW 682 2AASOSI 434 1B2SPECIFIC 652 28CSPECTRACE 177 B1SPI 693 2B5SPRSTRACE 175 AFSQLCODE 926 39ESSL 1030 406STANDBY 629 275STANTRACE 176 B0START 635 27BSTARTED 609 261STARTING 772 304STARTUP 180 B4

CVDA

Chapter 7. CICS-value data areas used by all commands 229

|||

CVDA DecValueHexValueSTATIC 179 B3STOPPED 610 262STSN 509 1FDSTSNSET 488 1E8STSNTEST 489 1E9SUBORDINATE 773 305SUBSPACE 663 297SURROGATE 371 173SUSPENDED 231 E7SWITCH 188 BCSWITCHALL 287 11FSWITCHING 225 E1SWITCHNEXT 286 11ESYNCFREE 91 5BSYNCPOINT 602 25ASYNCRECEIVE 92 5CSYNCSEND 93 5DSYSCONNECT 653 28DSYSDUMP 184 B8SYSLOG 785 311SYSTEM 643 283SYSTEMOFF 320 140SYSTEMON 319 13FTAKEOVER 111 6FTAPE1 250 FATAPE2 251 FBTASK 233 E9TASKSTART 611 263TCAM 64 40TCAMSNA 65 41TCEXITALL 366 16ETCEXITALLOFF 369 171TCEXITNONE 368 170TCEXITSYSTEM 367 16FTDQ 767 2FFTERM 234 EATERMINAL 213 D5TEXTKYBD 436 1B4TEXTPRINT 438 1B6THIRDINIT 627 273THREADSAFE 1051 41BTIMEOUT 511 1FFTIMER 1004 3ECTPOOL 932 3A4TPS55M3 553 229TPS55M4 554 22ATPS55M5 555 22BTRANDUMP 186 BATRANIDONLY 452 1C4TSQ 768 300TTI 77 4DTWAIT 927 39FTX 929 3A1TXID 928 3A0

CVDA

230 CICS TS for OS/390: CICS User’s Handbook

CVDA DecValueHexValueT3278M2 533 215T3278M3 534 216T3278M4 535 217T3278M5 536 218T3279M2 537 219T3279M3 538 21AT3279M4 539 21BT3279M5 540 21CUCTRAN 450 1C2UKOPEN 1056 420UNATTEMPTED 820 334UNAVAILABLE 672 2A0UNBLOCKED 17 11UNCOMMITTED 722 2D2UNCONNECTED 703 2BFUNDEFINED 14 EUNDETERMINED 355 163UNENABLED 33 21UNENABLING 34 22UNEXPECTED 1015 3F7UNEXPIRED 1018 3FAUNPROTECTED 505 1F9UNQUIESCED 709 2C5UNREGISTERED 671 29FUNSOLDATA 521 209UOW 246 F6UPDATABLE 37 25USER 642 282USERDATAKEY 380 17CUSEREXECKEY 382 17EUSERID 930 3A2USEROFF 322 142USERON 321 141USERTABLE 102 66VALID 360 168VALIDATION 440 1B8VARIABLE 13 DVFORM 411 19BVRRDS 732 2DCVSAM 3 3VTAM 60 3CWAIT 340 154WAITCOMMIT 763 2FBWAITER 754 2F2WAITFORGET 622 26EWAITING 765 2FDWAITRMI 766 2FEWAITRRMS 1063 427WARMSTART 267 10BWIN 545 221XCF 665 299XM 123 7BXNOTDONE 144 90XOK 143 8F

CVDA

Chapter 7. CICS-value data areas used by all commands 231

|||

CVDA DecValueHexValueZCPTRACE 364 16C

CVDAs and numeric values in numeric sequence

DecValueHexValue CVDA1 1 IGNORE1 1 NOTAPPLIC2 2 BDAM3 3 VSAM4 4 REMOTE5 5 ESDS6 6 KSDS7 7 RRDS8 8 KEYED9 9 NOTKEYED10 A BASE11 B PATH12 C FIXED13 D VARIABLE14 E UNDEFINED15 F NOTSUPPORTED16 10 BLOCKED17 11 UNBLOCKED18 12 OPEN19 13 CLOSED20 14 OPENING21 15 CLOSING22 16 CLOSEREQUEST23 17 ENABLED24 18 DISABLED25 19 DISABLING26 1A OLD27 1B SHARE29 1D RECOVERABLE30 1E NOTRECOVABLE31 1F EMPTYREQ32 20 NOEMPTYREQ33 21 UNENABLED34 22 UNENABLING35 23 READABLE36 24 NOTREADABLE37 25 UPDATABLE38 26 NOTUPDATABLE39 27 BROWSABLE40 28 NOTBROWSABLE41 29 ADDABLE42 2A NOTADDABLE43 2B DELETABLE44 2C NOTDELETABLE45 2D HEX46 2E DEC47 2F BLK48 30 EXCTL

CVDA

232 CICS TS for OS/390: CICS User’s Handbook

DecValueHexValue CVDA49 31 NOEXCTL52 34 ALTERABLE53 35 NOTALTERABLE54 36 LOG55 37 NOLOG56 38 CTRLABLE57 39 NOTCTRLABLE60 3C VTAM61 3D BSAM62 3E BTAM63 3F BGAM64 40 TCAM65 41 TCAMSNA66 42 CONSOLE67 43 CREATE68 44 NOCREATE69 45 ACQUIRED70 46 RELEASED71 47 ACQUIRING72 48 COLDACQ73 49 INSERVICE74 4A OUTSERVICE75 4B ATI76 4C NOATI77 4D TTI78 4E NOTTI79 4F PAGEABLE80 50 AUTOPAGEABLE81 51 ALLOCATED82 52 CONFFREE83 53 CONFRECEIVE84 54 CONFSEND85 55 FREE86 56 PENDFREE87 57 PENDRECEIVE88 58 RECEIVE89 59 ROLLBACK90 5A SEND91 5B SYNCFREE92 5C SYNCRECEIVE93 5D SYNCSEND94 5E FREEING95 5F AVAILABLE96 60 OBTAINING100 64 NOTTABLE101 65 CICSTABLE102 66 USERTABLE103 67 REMTABLE110 6E PRIMARY111 6F TAKEOVER121 79 IRC122 7A INDIRECT123 7B XM124 7C APPC

CVDA

Chapter 7. CICS-value data areas used by all commands 233

DecValueHexValue CVDA125 7D LU61126 7E PENDING127 7F NOTPENDING143 8F XOK144 90 XNOTDONE149 95 C150 96 ASSEMBLER151 97 COBOL152 98 PLI152 98 PL1154 9A PROGRAM155 9B MAP156 9C PARTITIONSET158 9E ANY159 9F BELOW160 A0 PURGEABLE161 A1 NOTPURGEABLE162 A2 OLDCOPY163 A3 HOLD164 A4 NOHOLD165 A5 LPA166 A6 NOTLPA167 A7 NEWCOPY168 A8 PHASEIN169 A9 ALLCONN170 AA AUTOCONN171 AB NONAUTOCONN172 AC GOINGOUT173 AD SHARED174 AE PRIVATE175 AF SPRSTRACE176 B0 STANTRACE177 B1 SPECTRACE178 B2 DYNAMIC179 B3 STATIC180 B4 STARTUP181 B5 ACTIVE182 B6 FIRSTQUIESCE183 B7 FINALQUIESCE184 B8 SYSDUMP185 B9 NOSYSDUMP186 BA TRANDUMP187 BB NOTRANDUMP188 BC SWITCH192 C0 BACKOUT194 C2 EXTSECURITY196 C4 NOSECURITY197 C5 ALTERNATE198 C6 DEFAULT200 C8 OFF201 C9 ON202 CA RESSECNO203 CB RESSECINT204 CC RESSECYES

CVDA

234 CICS TS for OS/390: CICS User’s Handbook

DecValueHexValue CVDA205 CD CMDSECNO207 CF CMDSECYES208 D0 COMMIT209 D1 READBACK210 D2 EMPTY211 D3 NOTEMPTY212 D4 FULL213 D5 TERMINAL214 D6 NOTERMINAL215 D7 PHYSICAL216 D8 LOGICAL221 DD EXTRA222 DE INTRA223 DF NOCTL224 E0 ASACTL225 E1 SWITCHING226 E2 INPUT227 E3 OUTPUT228 E4 DISPATCHABLE229 E5 RUNNING231 E7 SUSPENDED233 E9 TASK234 EA TERM235 EB DEST236 EC PURGE237 ED FORCEPURGE241 F1 MCHCTL242 F2 PRESETSEC243 F3 NOPRESETSEC244 F4 SIGNEDON245 F5 SIGNEDOFF246 F6 UOW247 F7 AUXILIARY248 F8 MAIN250 FA TAPE1251 FB TAPE2252 FC DISK1253 FD DISK2254 FE DISK2PAUSE255 FF SMF257 101 OPENOUTPUT258 102 READY259 103 NOTREADY260 104 CURRENT261 105 CLOSELEAVE262 106 AUTOARCH263 107 NOAUTOARCH264 108 REVERTED265 109 ADVANCE266 10A COLDSTART267 10B WARMSTART268 10C EMERGENCY269 10D LOGTERM270 10E FINPUT

CVDA

Chapter 7. CICS-value data areas used by all commands 235

DecValueHexValue CVDA271 10F FOUTPUT272 110 FOPEN273 111 FCLOSE274 112 OK275 113 NOWRITE275 113 READONLY276 114 REMOVE277 115 RECOVERED285 11D NOSWITCH286 11E SWITCHNEXT287 11F SWITCHALL288 120 SHUTDOWN289 121 NOSHUTDOWN290 122 RESET291 123 ADD292 124 DELETE310 136 INTSTART311 137 INTSTOP312 138 AUXSTART313 139 AUXPAUSE314 13A AUXSTOP317 13D GTFSTART318 13E GTFSTOP319 13F SYSTEMON320 140 SYSTEMOFF321 141 USERON322 142 USEROFF323 143 SINGLEON324 144 SINGLEOFF330 14A PERF331 14B NOPERF332 14C EXCEPT333 14D NOEXCEPT334 14E EVENT335 14F NOEVENT340 154 WAIT341 155 NOWAIT342 156 FORCE350 15E IMMCLOSE351 15F FORCECLOSE352 160 IMMCLOSING353 161 FORCECLOSING354 162 FWDRECOVABLE355 163 UNDETERMINED356 164 NORMALBKOUT357 165 FAILEDBKOUT358 166 FAILINGBKOUT359 167 INVALID360 168 VALID361 169 NOTFWDRCVBLE362 16A EXITTRACE363 16B NOEXITTRACE364 16C ZCPTRACE365 16D NOZCPTRACE

CVDA

236 CICS TS for OS/390: CICS User’s Handbook

DecValueHexValue CVDA366 16E TCEXITALL367 16F TCEXITSYSTEM368 170 TCEXITNONE369 171 TCEXITALLOFF370 172 CEDF370 172 MODEL371 173 NOCEDF371 173 SURROGATE372 174 SESSION373 175 APPCSINGLE374 176 APPCPARALLEL375 177 COBOLII376 178 NOTINIT377 179 LE370378 17A INACTIVE379 17B CICSDATAKEY380 17C USERDATAKEY381 17D CICSEXECKEY382 17E USEREXECKEY383 17F DPLSUBSET384 180 FULLAPI385 181 FMHPARM386 182 NOFMHPARM387 183 OBOPERID388 184 NOOBOPERID391 187 APLKYBD392 188 NOAPLKYBD393 189 APLTEXT394 18A NOAPLTEXT395 18B AUDALARM396 18C NOAUDALARM397 18D BACKTRANS398 18E NOBACKTRANS399 18F COLOR400 190 NOCOLOR401 191 COPY402 192 NOCOPY403 193 DUALCASE404 194 NODUALCASE405 195 EXTENDEDDS406 196 NOEXTENDEDDS407 197 FORMFEED408 198 NOFORMFEED409 199 HFORM410 19A NOHFORM411 19B VFORM412 19C NOVFORM413 19D HILIGHT414 19E NOHILIGHT415 19F KATAKANA416 1A0 NOKATAKANA417 1A1 LIGHTPEN418 1A2 NOLIGHTPEN419 1A3 MSRCONTROL

CVDA

Chapter 7. CICS-value data areas used by all commands 237

DecValueHexValue CVDA420 1A4 NOMSRCONTROL421 1A5 OBFORMAT422 1A6 NOOBFORMAT423 1A7 OUTLINE424 1A8 NOOUTLINE425 1A9 PARTITIONS426 1AA NOPARTITIONS427 1AB PRINTADAPT428 1AC NOPRINTADAPT429 1AD PROGSYMBOL430 1AE NOPROGSYMBOL431 1AF ALLQUERY432 1B0 NOQUERY433 1B1 COLDQUERY434 1B2 SOSI435 1B3 NOSOSI436 1B4 TEXTKYBD437 1B5 NOTEXTKYBD438 1B6 TEXTPRINT439 1B7 NOTEXTPRINT440 1B8 VALIDATION441 1B9 NOVALIDATION442 1BA RELREQ443 1BB NORELREQ444 1BC DISCREQ445 1BD NODISCREQ446 1BE ALTPRTCOPY447 1BF NOALTPRTCOPY448 1C0 PRTCOPY449 1C1 NOPRTCOPY450 1C2 UCTRAN451 1C3 NOUCTRAN452 1C4 TRANIDONLY485 1E5 NEWSESSION486 1E6 OLDSESSION487 1E7 NOSTSN488 1E8 STSNSET489 1E9 STSNTEST490 1EA EB491 1EB CD492 1EC MORE493 1ED LIC494 1EE RU495 1EF NOTCDEB496 1F0 NONE497 1F1 DEFRESP1498 1F2 DEFRESP2499 1F3 DEFRESP3500 1F4 NOALARM501 1F5 ALARM502 1F6 FMH503 1F7 NOFMH504 1F8 PROTECTED505 1F9 UNPROTECTED

CVDA

238 CICS TS for OS/390: CICS User’s Handbook

DecValueHexValue CVDA506 1FA MDT507 1FB NOMDT508 1FC DATA509 1FD STSN510 1FE BEGINSESSION511 1FF TIMEOUT512 200 INSTALLFAIL513 201 DISCARDFAIL514 202 SETFAIL515 203 ACQFAIL516 204 SESSIONLOST517 205 SESSIONFAIL518 206 CONVIDLE519 207 ADDFAIL520 208 DELETEFAIL521 209 UNSOLDATA522 20A NORMALRESP523 20B EXCEPTRESP524 20C ATTENTION525 20D LUSTAT526 20E CANCEL527 20F RTR528 210 DEFRESP1OR2529 211 POSITIVE530 212 NEGATIVE531 213 NOMSGJRNL532 214 INOUT533 215 T3278M2534 216 T3278M3535 217 T3278M4536 218 T3278M5537 219 T3279M2538 21A T3279M3539 21B T3279M4540 21C T3279M5541 21D LUP542 21E FORMATTED543 21F DATASTREAM544 220 LOSE545 221 WIN546 222 NOTINBOUND547 223 INBOUND549 225 RELEASING550 226 INSTALLED551 227 NOTINSTALLED552 228 TPS55M2553 229 TPS55M3554 22A TPS55M4555 22B TPS55M5556 22C NOCONV557 22D PENDSTSN558 22E PENDBEGIN559 22F APPLICATION560 230 PENDDATA

CVDA

Chapter 7. CICS-value data areas used by all commands 239

DecValueHexValue CVDA561 231 PENDSTART562 232 PENDRELEASE563 233 RELEASE564 234 PENDUNSOL565 235 PENDPASS600 258 CONVERSE601 259 NOCONVERSE602 25A SYNCPOINT603 25B NOSYNCPOINT604 25C GMT605 25D LOCAL606 25E FORMATEDF607 25F NOFORMATEDF608 260 NOTASKSTART609 261 STARTED610 262 STOPPED611 263 TASKSTART612 264 BUSY613 265 NOTBUSY614 266 SCS615 267 DS3270616 268 ASCII7617 269 ASCII8618 26A AUTOSTART620 26C INDOUBT621 26D INFLIGHT622 26E WAITFORGET623 26F CONTROLSHUT624 270 CANCELLED625 271 FIRSTINIT626 272 SECONDINIT627 273 THIRDINIT628 274 INITCOMPLETE629 275 STANDBY630 276 AUTOACTIVE631 277 AUTOINACTIVE632 278 CTLGALL633 279 CTLGMODIFY634 27A CTLGNONE635 27B START636 27C POST637 27D DELAY638 27E ROUTE640 280 CLEAR641 281 NOCLEAR642 282 USER643 283 SYSTEM644 284 SHUTENABLED645 285 SHUTDISABLED650 28A EXCI651 28B GENERIC652 28C SPECIFIC653 28D SYSCONNECT654 28E NOSYSCONNECT

CVDA

240 CICS TS for OS/390: CICS User’s Handbook

DecValueHexValue CVDA655 28F FORCECANCEL657 291 NOISOLATE658 292 ISOLATE659 293 NOTDEFINED660 294 CICS661 295 NONCICS663 297 SUBSPACE664 298 BASESPACE665 299 XCF666 29A REQUIRED667 29B NOTREQUIRED668 29C SOS669 29D NOTSOS670 29E REGISTERED671 29F UNREGISTERED672 2A0 UNAVAILABLE673 2A1 CMDPROT674 2A2 NOCMDPROT675 2A3 RELATED677 2A5 REGERROR678 2A6 DEREGISTERED679 2A7 DEREGERROR680 2A8 REENTPROT681 2A9 NOREENTPROT682 2AA SOSBELOW683 2AB SOSABOVE684 2AC DAE685 2AD NODAE690 2B2 CONNECTED691 2B3 NOTCONNECTED693 2B5 SPI694 2B6 NOSPI700 2BC NORECOVDATA701 2BD RECOVDATA702 2BE RESYNC703 2BF UNCONNECTED706 2C2 IMMQUIESCED707 2C3 QUIESCED708 2C4 QUIESCING709 2C5 UNQUIESCED710 2C6 NOLOSTLOCKS711 2C7 NORETAINED712 2C8 RECOVERLOCKS713 2C9 REMLOSTLOCKS714 2CA RESETLOCKS715 2CB RETAINED716 2CC RETRY720 2D0 RLS721 2D1 NOTRLS722 2D2 UNCOMMITTED723 2D3 CONSISTENT724 2D4 REPEATABLE730 2DA RLSACTIVE731 2DB RLSINACTIVE

CVDA

Chapter 7. CICS-value data areas used by all commands 241

DecValueHexValue CVDA732 2DC VRRDS740 2E4 REMSESSION751 2EF EXECENQ752 2F0 EXECENQADDR753 2F1 OWNER754 2F2 WAITER755 2F3 CONNECTION756 2F4 DATASET757 2F5 HEURCOMMIT758 2F6 HEURBACKOUT761 2F9 RLSSERVER762 2FA SHUNTED763 2FB WAITCOMMIT765 2FD WAITING766 2FE WAITRMI767 2FF TDQ768 300 TSQ770 302 COORDINATOR771 303 RMI772 304 STARTING773 305 SUBORDINATE774 306 NRS780 30C MVS781 30D DUMMY782 30E FAILED783 30F FLUSH784 310 NOSYSLOG785 311 SYSLOG788 314 COLD789 315 INITIAL790 316 ENDAFFINITY791 317 CACHE792 318 COMMITFAIL793 319 DATASETFULL794 31A DEADLOCK795 31B DELEXITERROR796 31C INDEXRECFULL797 31D IOERROR798 31E OPENERROR799 31F RLSGONE800 320 BACKUPNONBWO810 32A SKIP811 32B REWIND811 32B LEAVE812 32C REREAD813 32D MOD814 32E QUEUE815 32F REJECT816 330 IGNORERR820 334 UNATTEMPTED830 33E RRCOMMITFAIL831 33F RRINDOUBT832 340 LCKSTRUCFULL833 341 CFTABLE

CVDA

242 CICS TS for OS/390: CICS User’s Handbook

DecValueHexValue CVDA834 342 LOAD835 343 NOLOAD836 344 CONTENTION837 345 LOCKING900 384 ABEND902 386 CGROUP903 387 CONNECT904 388 CONNECTING905 389 CSIGN906 38A CTERM907 38B CTX908 38C COPID909 38D CUSERID910 38E DISCONNING911 38F EQUAL912 390 EXIT913 391 GROUP914 392 HIGH915 393 LOW916 394 NOCONNECT917 395 NOEXIT918 396 NORELEASE919 397 NOROLLBACK920 398 NOTWAIT921 399 N906D922 39A POOL923 39B REBUILD924 39C RECONNECT925 39D SIGN926 39E SQLCODE927 39F TWAIT928 3A0 TXID929 3A1 TX930 3A2 USERID931 3A3 N906932 3A4 TPOOL933 3A5 OPID1000 3E8 NOTFIRED1001 3E9 FIRED1002 3EA ACTIVITY1003 3EB COMPOSITE1004 3EC TIMER1005 3ED AND1006 3EE OR1010 3F2 PROCESS1011 3F3 NOUSER1012 3F4 EVENTFAIL1013 3F5 FORCED1014 3F6 INCOMPLETE1015 3F7 UNEXPECTED1016 3F8 NORMAL1017 3F9 EXPIRED1018 3FA UNEXPIRED1021 3FD NOTDYNAMIC

CVDA

Chapter 7. CICS-value data areas used by all commands 243

DecValueHexValue CVDA1022 3FE NOTROUTABLE1023 3FF ROUTABLE1024 400 DORMANT1025 401 CANCELLING1026 402 COMPLETE1027 403 NOTSUSPENDED1030 406 SSL1031 407 NOSSSL1032 408 CLIENTAUTH1033 409 HTTPYES1034 40A HTTPNO1036 40C APPEND1037 40D NOAPPEND1038 40E BINARY1039 40F EBCDIC1050 41A QUASIRENT1051 41B THREADSAFE1052 41C BASEAPI1053 41D OPENAPI1054 41E NOFORCE1055 41F CKOPEN1056 420 UKOPEN1057 421 QR1058 422 INTERNAL10623 426 RRMS1063 427 WAITRRMS1071 42F NOAUTO1072 430 PROGAUTO1073 431 FULLAUTO1080 438 JVM1081 439 NOJVM1082 43A DEBUG1083 43B NODEBUG1084 43C NATIVE1091 443 NOAUTHENTIC1092 444 BASICAUTH1093 445 CERTIFICAUTH1094 446 AUTOREGISTER1095 447 AUTOAUTH

CVDAs returned by the INQ NETNAME|TERMINAL DEVICE command

In alphabetic sequenceCVDADecValueHexValueBATCHLU 191 BFBIPROG 160 A0BISYNCH 128 80CDRDLPRT 24 18CONTNLU 189 BDHARDCOPY 32 20INTACTLU 190 BEISCMMCONV 209 D1LUCMODGRP 210 D2LUCSESS 211 D3

CVDA

244 CICS TS for OS/390: CICS User’s Handbook

||||||

||||||||||||||||||

In alphabetic sequenceCVDADecValueHexValueLUTYPE4 193 C1LUTYPE6 192 C0MAGTAPE 20 14RESSYS 208 D0SDLC 176 B0SEQDISK 18 12SYSTEM3 161 A1SYSTEM7 2 2SYS370 164 A4SYS7BSCA 166 A6TCONSOLE 8 8TELETYPE 34 22TTCAM 80 50TWX3335 33 21T1050 36 24T1053 74 4AT2260L 65 41T2260R 72 48T2265 76 4CT2740 40 28T2741BCD 43 2BT2741COR 42 2AT2770 130 82T2780 132 84T2980 134 86T3275R 146 92T3277L 153 99T3277R 145 91T3284L 155 9BT3284R 147 93T3286L 156 9CT3286R 148 94T3600BI 138 8AT3601 177 B1T3614 178 B2T3650ATT 186 BAT3650PIPE 184 B8T3650USER 187 BBT3653HOST 185 B9T3735 136 88T3740 137 89T3780 133 85T3790 180 B4T3790SCSP 182 B6T3790UP 181 B5T7770 1 1VIDEOTERM 64 40

InnumericalsequenceDecValue

HexValue CVDA

1 1 T77702 2 SYSTEM78 8 TCONSOLE

CVDA

Chapter 7. CICS-value data areas used by all commands 245

InnumericalsequenceDecValue

HexValue CVDA

18 12 SEQDISK20 14 MAGTAPE24 18 CDRDLPRT32 20 HARDCOPY33 21 TWX333534 22 TELETYPE36 24 T105040 28 T274042 2A T2741COR43 2B T2741BCD64 40 VIDEOTERM65 41 T2260L72 48 T2260R74 4A T105376 4C T226580 50 TTCAM128 80 BISYNCH130 82 T2770132 84 T2780133 85 T3780134 86 T2980136 88 T3735137 89 T3740138 8A T3600BI145 91 T3277R146 92 T3275R147 93 T3284R148 94 T3286R153 99 T3277L155 9A T3284L156 9B T3286L160 A0 BIPROG161 A1 SYSTEM3164 A4 SYS370166 A6 SYS7BSCA176 B0 SDLC177 B1 T3601178 B2 T3614180 B4 T3790181 B5 T3790UP182 B6 T3790SCSP184 B8 T3650PIPE185 B9 T3653HOST186 BA T3650ATT187 BB T3650USER189 BD CONTNLU190 BE INTACTLU191 BF BATCHLU192 C0 LUTYPE6193 C1 LUTYPE4208 D0 RESSYS209 D1 ISCMMCONV210 D2 LUCMODGRP

CVDA

246 CICS TS for OS/390: CICS User’s Handbook

InnumericalsequenceDecValue

HexValue CVDA

211 D3 LUCSESS

CVDA

Chapter 7. CICS-value data areas used by all commands 247

CVDA

248 CICS TS for OS/390: CICS User’s Handbook

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) COMP short int eibcalen FIXED BIN(15) HEIBCOMPL PIC X(1) char eibcompl[1] CHAR(1) CL1EIBCONF PIC X(1) char eibconf[1] CHAR(1) CL1EIBCPOSN PIC S9(4) COMP short int eibcposn FIXED BIN(15) HEIBDATE PIC S9(7) COMP-3 char eibdate[4] FIXED DEC(7,0) PL4EIBDS 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) COMP long int eibresp FIXED BIN(31) FEIBRESP2 PIC S9(8) COMP long int eibresp2 FIXED BIN(31) FEIBRLDBK 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-3 char eibtaskn[4] FIXED DEC(7,0) PL4EIBTIME PIC S9(7) COMP-3 char eibtime[4] FIXED DEC(7,0) PL4EIBTRMID PIC X(4) char eibtrmid[4] CHAR(4) CL4EIBTRNID PIC X(4) char eibtrnid[4] CHAR(4) CL4

EIBFN codes

Note: In the column Type, API indicates that the command is described in theCICS Application Programming Reference, and SPI indicates that it is describedin the CICS System Programming Reference manual. SPI does not indicate thatthe special (SP) translator option is required for this command. FEPIindicates commands used by the CICS/ESA Front End ProgrammingInterface. They are described in the CICS Front End Programming InterfaceUser’s Guide.

© Copyright IBM Corp. 1989, 2000 249

EIBFN value Command Type

X’0202’ ADDRESS APIX’0204’ HANDLE CONDITION APIX’0206’ HANDLE AID APIX’0208’ ASSIGN APIX’020A’ IGNORE CONDITION APIX’020C’ PUSH APIX’020E’ POP APIX’0210’ ADDRESS SET APIX’0402’ RECEIVE APIX’0404’ SEND APIX’0406’ CONVERSE APIX’0408’ ISSUE EODS APIX’040A’ ISSUE COPY APIX’040C’ WAIT TERMINAL APIX’040E’ ISSUE LOAD APIX’0410’ WAIT SIGNAL APIX’0412’ ISSUE RESET APIX’0414’ ISSUE DISCONNECT APIX’0416’ ISSUE ENDOUTPUT APIX’0418’ ISSUE ERASEAUP APIX’041A’ ISSUE ENDFILE APIX’041C’ ISSUE PRINT APIX’041E’ ISSUE SIGNAL APIX’0420’ ALLOCATE APIX’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 CONFIRMATION APIX’0436’ ISSUE ERROR APIX’0438’ ISSUE PREPARE APIX’043A’ ISSUE PASS APIX’043C’ EXTRACT LOGONMSG APIX’043E’ EXTRACT ATTRIBUTES APIX’0602’ READ APIX’0604’ WRITE FILE APIX’0606’ REWRITE APIX’0608’ DELETE APIX’060A’ UNLOCK APIX’060C’ STARTBR APIX’060E’ READNEXT APIX’0610’ READPREV APIX’0612’ ENDBR APIX’0614’ RESETBR APIX’0802’ WRITEQ TD APIX’0804’ READQ TD APIX’0806’ DELETEQ TD APIX’0A02’ WRITEQ TS APIX’0A04’ READQ TS API

EIB

250 CICS TS for OS/390: CICS User’s Handbook

EIBFN value Command Type

X’0A06’ DELETEQ TS APIX’0C02’ GETMAIN APIX’0C04’ FREEMAIN APIX’0E02’ LINK APIX’0E04’ XCTL APIX’0E06’ LOAD APIX’0E08’ RETURN APIX’0E0A’ RELEASE APIX’0E0C’ ABEND APIX’0E0E’ HANDLE ABEND APIX’1002’ ASKTIME APIX’1004’ DELAY APIX’1006’ POST APIX’1008’ START APIX’100A’ RETRIEVE APIX’100C’ CANCEL APIX’1202’ WAIT EVENT APIX’1204’ ENQ APIX’1206’ DEQ APIX’1208’ SUSPEND APIX’1402’ WRITE JOURNALNUM APIX’1404’ WAIT JOURNALNUM APIX’1406’ WRITE JOURNALNAME APIX’1408’ WAIT JOURNALNAME APIX’1602’ SYNCPOINT APIX’1604’ RESYNC ENTRYNAME SPIX’1802’ RECEIVE MAP APIX’1804’ SEND MAP APIX’1806’ SEND TEXT APIX’1808’ SEND PAGE APIX’180A’ PURGE MESSAGE APIX’180C’ ROUTE APIX’180E’ RECEIVE PARTN APIX’1810’ SEND PARTNSET APIX’1812’ SEND CONTROL APIX’1C02’ DUMP APIX’1E02’ ISSUE ADD APIX’1E04’ ISSUE ERASE APIX’1E06’ ISSUE REPLACE APIX’1E08’ ISSUE ABORT APIX’1E0A’ ISSUE QUERY APIX’1E0C’ ISSUE END APIX’1E0E’ ISSUE RECEIVE APIX’1E10’ ISSUE NOTE APIX’1E12’ ISSUE WAIT APIX’1E14’ ISSUE SEND APIX’2002’ BIF DEEDIT APIX’2202’ ENABLE PROGRAM SPIX’2204’ DISABLE APIX’2206’ EXTRACT EXIT SPIX’2402’ ALLOCATE APIX’2404’ ASSIGN APIX’2406’ EXTRACT PROCESS APIX’2408’ FREE API

EIB

Chapter 8. EXEC interface block (EIB) 251

EIBFN value Command Type

X’240A’ ISSUE ABEND APIX’240C’ CONNECT PROCESS APIX’240E’ ISSUE CONFIRMATION APIX’2410’ ISSUE ERROR APIX’2412’ ISSUE SIGNAL APIX’2414’ RECEIVE APIX’2416’ SEND APIX’2418’ WAIT APIX’241A’ ISSUE PREPARE APIX’241C’ EXTRACT ATTRIBUTES APIX’3002’ CREATE PROGRAM SPIX’3004’ CREATE MAPSET SPIX’3006’ CREATE PARTITIONSET SPIX’3008’ CREATE TRANSACTION SPIX’300A’ CREATE PROFILE SPIX’300C’ CREATE TYPETERM SPIX’300E’ CREATE CONNECTION SPIX’3010’ CREATE TERMINAL SPIX’3012’ CREATE SESSIONS SPIX’3014’ CREATE FILE SPIX’3016’ CREATE LSRPOOL SPIX’3018’ CREATE PARTNER SPIX’301A’ CREATE TRANCLASS SPIX’301C’ CREATE TDQUEUE SPIX’301E’ CREATE JOURNALMODEL SPIX’3020’ CREATE DB2CONN SPIX’3022’ CREATE DB2ENTRY SPIX’3024’ CREATE DB2TRAN SPIX’3026’ CREATE PROCESSTYPE SPIX’3028’ CREATE TSMODEL SPIX’302A’ CREATE ENQMODEL SPIX’302C’ CREATE REQUESTMODEL SPIX’302E’ CREATE DOCTEMPLATE SPIX’3030’ CREATE TCPIPSERVICE SPIX’3A02’ INQ RRMS SPIX’4202’ INQUIRE AUTINSTMODEL SPIX’4210’ DISCARD AUTINSTMODEL SPIX’4402’ INQUIRE PARTNER SPIX’4410’ DISCARD PARTNER SPIX’4602’ INQUIRE PROFILE SPIX’4610’ DISCARD PROFILE SPIX’4802’ ENTER TRACENUM APIX’4804’ MONITOR APIX’4A02’ ASKTIME ABSTIME APIX’4A04’ FORMATTIME APIX’4C02’ INQUIRE FILE SPIX’4C04’ SET FILE SPIX’4C10’ DISCARD FILE SPIX’4E02’ INQUIRE PROGRAM SPIX’4E04’ SET PROGRAM SPIX’4E10’ DISCARD PROGRAM SPIX’5002’ INQUIRE TRANSACTION SPIX’5004’ SET TRANSACTION SPIX’5010’ DISCARD TRANSACTION SPI

EIB

252 CICS TS for OS/390: CICS User’s Handbook

EIBFN value Command Type

X’5202’ INQUIRE TERMINAL SPIX’5204’ SET TERMINAL SPIX’5206’ INQUIRE NETNAME SPIX’5208’ SET NETNAME SPIX’5210’ DISCARD TERMINAL SPIX’5212’ INQUIRE TERMINAL SPIX’5214’ SET TERMINAL SPIX’5216’ INQUIRE NETNAME SPIX’5402’ INQUIRE SYSTEM SPIX’5404’ SET SYSTEM SPIX’5412’ INQ SYSTEM SPIX’5602’ SPOOLOPEN INPUT APIX’5602’ SPOOLOPEN OUTPUT APIX’5604’ SPOOLREAD APIX’5606’ SPOOLWRITE APIX’5610’ SPOOLCLOSE APIX’5802’ INQUIRE CONNECTION SPIX’5804’ SET CONNECTION SPIX’5806’ PERFORM ENDAFFINITY SPIX’5810’ DISCARD CONNECTION SPIX’5A02’ INQUIRE MODENAME SPIX’5A04’ SET MODENAME SPIX’5C02’ INQUIRE TDQUEUE SPIX’5C04’ SET TDQUEUE SPIX’5C10’ DISCARD TDQUEUE SPIX’5E02’ INQUIRE TASK SPIX’5E04’ SET TASK SPIX’5E06’ CHANGE TASK APIX’5E08’ INQUIRE STORAGE SPIX’5E12’ INQUIRE TCLASS SPIX’5E14’ SET TCLASS SPIX’5E18’ DISCARD TRANCLASS SPIX’5E1A’ INQUIRE TRANCLASS SPIX’5E1C’ SET TRANCLASS SPIX’5E22’ WAIT EXTERNAL APIX’5E32’ WAITCICS APIX’6002’ INQUIRE JOURNALNUM SPIX’6004’ SET JOURNALNUM SPIX’6010’ DISCARD JOURNALNAME SPIX’6012’ INQUIRE JOURNALNAME SPIX’6014’ SET JOURNALNAME SPIX’6202’ INQUIRE VOLUME SPIX’6204’ SET VOLUME SPIX’6402’ PERFORM SECURITY SPIX’6602’ INQUIRE DUMPDS SPIX’6604’ SET DUMPDS SPIX’6612’ INQUIRE TRANDUMPCODE SPIX’6614’ SET TRANDUMPCODE SPIX’6622’ INQUIRE SYSDUMPCODE SPIX’6624’ SET SYSDUMPCODE SPIX’6802’ INQUIRE VTAM SPIX’6804’ SET VTAM SPIX’6812’ INQUIRE AUTOINSTALL SPIX’6814’ SET AUTOINSTALL SPI

EIB

Chapter 8. EXEC interface block (EIB) 253

EIBFN value Command Type

X’6822’ INQUIRE DELETSHIPPED SPIX’6824’ SET DELETSHIPPED SPIX’6826’ PERFORM DELETSHIPPED SPIX’6A02’ QUERY SECURITY APIX’6C02’ WRITE OPERATOR APIX’6C12’ CICSMESSAGE APIX’6E02’ INQUIRE IRC SPIX’6E04’ SET IRC SPIX’7002’ INQUIRE STATISTICS SPIX’7004’ SET STATISTICS SPIX’7006’ PERFORM STATISTICS SPIX’7008’ COLLECT STATISTICS SPIX’7012’ INQUIRE MONITOR SPIX’7014’ SET MONITOR SPIX’7202’ PERFORM RESETTIME SPIX’7402’ SIGNON APIX’7404’ SIGNOFF APIX’7406’ VERIFY PASSWORD APIX’7408’ CHANGE PASSWORD APIX’7602’ PERFORM SHUTDOWN SPIX’7802’ INQUIRE TRACEDEST SPIX’7804’ SET TRACEDEST SPIX’7812’ INQUIRE TRACEFLAG SPIX’7814’ SET TRACEFLAG SPIX’7822’ INQUIRE TRACETYPE SPIX’7824’ SET TRACETYPE SPIX’7A02’ INQUIRE DSNAME SPIX’7A04’ SET DSNAME SPIX’7C02’ INQ EXCI SPIX’7E02’ DUMP TRANSACTION APIX’7E04’ PERFORM DUMP SPIX’8002’ INQUIRE TSQUEUE SPIX’8004’ SET TSQUEUE SPIX’8012’ INQUIRE TSQNAME SPIX’8014’ SET TSQNAME SPIX’801A’ INQUIRE TSPOOL SPIX’8022’ INQUIRE TSMODEL SPIX’8030’ DISCARD TSMODEL SPIX’820E’ AP FEPIX’8210’ ALLOCATE POOL FEPIX’8210’ ALLOCATE PASSCONVID FEPIX’8212’ CONVERSE FORMATTED FEPIX’8214’ CONVERSE DATASTREAM FEPIX’8216’ EXTRACT CONV FEPIX’8218’ EXTRACT FIELD FEPIX’821A’ EXTRACT STSN FEPIX’821C’ FREE FEPIX’821E’ ISSUE FEPIX’8220’ RECEIVE FORMATTED FEPIX’8222’ RECEIVE DATASTREAM FEPIX’8224’ SEND FORMATTED FEPIX’8226’ SEND DATASTREAM FEPIX’8228’ START FEPIX’840E’ SP FEPI

EIB

254 CICS TS for OS/390: CICS User’s Handbook

EIBFN value Command Type

X’8422’ INQUIRE PROPERTYSET FEPIX’8428’ INSTALL PROPERTYSET FEPIX’8430’ DISCARD PROPERTYSET FEPIX’8442’ INQUIRE NODE FEPIX’8444’ SET NODE FEPIX’8444’ SET NODELIST FEPIX’8448’ INSTALL NODELIST FEPIX’844A’ ADD POOL FEPIX’844C’ DELETE POOL FEPIX’8450’ DISCARD NODELIST FEPIX’8462’ INQUIRE POOL FEPIX’8464’ SET POOL FEPIX’8464’ SET POOLLIST FEPIX’8468’ INSTALL POOL FEPIX’8470’ DISCARD POOL FEPIX’8482’ INQUIRE TARGET FEPIX’8484’ SET TARGETLIST FEPIX’8484’ SET TARGET FEPIX’8488’ INSTALL TARGETLIST FEPIX’8490’ DISCARD TARGETLIST FEPIX’84A2’ INQUIRE CONNECTION FEPIX’84A4’ SET CONNECTION FEPIX’8602’ ACQUIRE SPIX’8802’ INQUIRE EXITPROGRAM SPIX’8A02’ INQUIRE REQID SPIX’8C02’ WRITE MESSAGE APIX’9002’ INQUIRE UOW SPIX’9004’ SET UOW SPIX’9022’ INQUIRE UOWENQ SPIX’9042’ INQUIRE UOWLINK SPIX’9044’ SET UOWLINK SPIX’9062’ INQUIRE UOWDSNFAIL SPIX’9082’ INQUIRE ENQMODEL SPIX’9084’ SET ENQMODEL SPIX’9090’ DISCARD ENQMODEL SPIX’9202’ INQUIRE JOURNALMODEL SPIX’9210’ DISCARD JOURNALMODEL SPIX’9212’ INQUIRE STREAMNAME SPIX’9402’ INQUIRE DB2CONN SPIX’9404’ SET DB2CONN SPIX’9410’ DISCARD DB2CONN SPIX’9422’ INQUIRE DB2ENTRY SPIX’9424’ SET DB2ENTRY SPIX’9430’ DISCARD DB2ENTRY SPIX’9442’ INQUIRE DB2TRAN SPIX’9444’ SET DB2TRAN SPIX’9450’ DISCARD DB2TRAN SPIX’9602’ INQUIRE PROCESSTYPE SPIX’9604’ SET PROCESSTYPE SPIX’9610’ DISCARD PROCESSTYPE SPIX’9612’ INQUIRE ACTID SPIX’9614’ INQUIRE CONTAIN SPIX’9616’ INQUIRE EVENT SPIX’9618’ INQUIRE PROCESS SPI

EIB

Chapter 8. EXEC interface block (EIB) 255

EIBFN value Command Type

X’9620’ STARTBROWSE ACTIVITY SPIX’9622’ GETNEXT ACTIVITY SPIX’9624’ ENDBROWSE ACTIVITY SPIX’9626’ STARTBROWSE CONTAINER SPIX’9628’ GETNEXT CONTAINER SPIX’962A’ ENDBROWSE CONTAINER SPIX’962C’ STARTBROWSE EVENT SPIX’962E’ GETNEXT EVENT SPIX’9630’ ENDBROWSE EVENT SPIX’9632’ STARTBROWSE PROCESS SPIX’9634’ GETNEXT PROCESS SPIX’9636’ ENDBROWSE PROCESS SPIX’9638’ INQUIRE TIMER SPIX’963A’ STARTBROWSE TIMER SPIX’963C’ GETNEXT TIMER SPIX’963E’ ENDBROWSE TIMER SPIX’9802’ INQUIRE CFDTPOOL SPIX’9A02’ INQUIRE REQUESTMODEL SPIX’9A10’ DISCARD REQUESTMODEL SPIX’9C02’ INQUIRE TCPIPSERVICE SPIX’9C04’ SET TCPIPSERVICE SPIX’9C10’ DISCARD TCPIPSERVICE SPIX’9C12’ INQUIRE TCPIP SPIX’9C14’ SET TCPIP SPIX’9C22’ INQUIRE WEB SPIX’9C24’ SET WEB SPIX’9E02’ INQUIRE DOCTEMPLATE SPIX’9E10’ DISCARD DOCTEMPLATE SPI

EIBRCODE valuesSee the notes at the end of the list of values for explanations of the numbersfollowing some of the conditions.

EIBFN EIBRCODE Condition02 .. E0 .. .. .. .. .. INVREQ

04 .. 04 .. .. .. .. .. EOF04 .. 10 .. .. .. .. .. EODS04 .. C1 .. .. .. .. .. EOF04 .. C2 .. .. .. .. .. ENDINPT04 .. D0 .. .. .. .. .. SYSIDERR3

04 .. D2 .. .. .. .. .. SESSIONERR4

04 .. D3 .. .. .. .. .. SYSBUSY5

04 .. D4 .. .. .. .. .. SESSBUSY04 .. D5 .. .. .. .. .. NOTALLOC04 .. E0 .. .. .. .. .. INVREQ6

04 .. E1 .. .. .. .. .. LENGERR7

04 .. E3 .. .. .. .. .. WRBRK04 .. E4 .. .. .. .. .. RDATT04 .. E5 .. .. .. .. .. SIGNAL04 .. E6 .. .. .. .. .. TERMIDERR04 .. E7 .. .. .. .. .. NOPASSBKRD

EIB

256 CICS TS for OS/390: CICS User’s Handbook

EIBFN EIBRCODE Condition04 .. E8 .. .. .. .. .. NOPASSBKWR04 .. EA .. .. .. .. .. IGREQCD04 .. EB .. .. .. .. .. CBIDERR04 .. EC .. .. .. .. .. PARTNERIDERR04 .. ED .. .. .. .. .. NETNAMEIDERR04 .. F1 .. .. .. .. .. TERMERR04 .. .. 20 .. .. .. .. EOC04 .. .. 40 .. .. .. .. INBFMH04 .. .. .. .. F6 .. .. NOSTART04 .. .. .. .. F7 .. .. NONVAL

06 .. 01 .. .. .. .. .. FILENOTFOUND06 .. 02 .. .. .. .. .. ILLOGIC1

06 .. 03 .. .. .. .. .. LOCKED06 .. 05 .. .. .. .. .. RECORDBUSY06 .. 08 .. .. .. .. .. INVREQ06 .. 0C .. .. .. .. .. NOTOPEN06 .. 0D .. .. .. .. .. DISABLED06 .. 0F .. .. .. .. .. ENDFILE06 .. 80 .. .. .. .. .. IOERR1

06 .. 81 .. .. .. .. .. NOTFND06 .. 82 .. .. .. .. .. DUPREC06 .. 83 .. .. .. .. .. NOSPACE06 .. 84 .. .. .. .. .. DUPKEY06 .. 85 .. .. .. .. .. SUPPRESSED06 .. 86 .. .. .. .. .. LOADING06 .. D0 .. .. .. .. .. SYSIDERR3

06 .. D1 .. .. .. .. .. ISCINVREQ06 .. D6 .. .. .. .. .. NOTAUTH06 .. E1 .. .. .. .. .. LENGERR

08 .. 01 .. .. .. .. .. QZERO08 .. 02 .. .. .. .. .. QIDERR08 .. 04 .. .. .. .. .. IOERR08 .. 08 .. .. .. .. .. NOTOPEN08 .. 10 .. .. .. .. .. NOSPACE08 .. C0 .. .. .. .. .. QBUSY08 .. D0 .. .. .. .. .. SYSIDERR3

08 .. D1 .. .. .. .. .. ISCINVREQ08 .. D6 .. .. .. .. .. NOTAUTH08 .. D7 .. .. .. .. .. DISABLED08 .. E0 .. .. .. .. .. INVREQ08 .. E1 .. .. .. .. .. LENGERR

0A .. 01 .. .. .. .. .. ITEMERR0A .. 02 .. .. .. .. .. QIDERR0A .. 04 .. .. .. .. .. IOERR0A .. 08 .. .. .. .. .. NOSPACE0A .. 20 .. .. .. .. .. INVREQ0A .. D0 .. .. .. .. .. SYSIDERR3

0A .. D1 .. .. .. .. .. ISCINVREQ0A .. D6 .. .. .. .. .. NOTAUTH0A .. E1 .. .. .. .. .. LENGERR

EIB

Chapter 8. EXEC interface block (EIB) 257

EIBFN EIBRCODE Condition0C .. E1 .. .. .. .. .. LENGERR0C .. E2 .. .. .. .. .. NOSTG

0E .. 01 .. .. .. .. .. PGMIDERR0E .. D6 .. .. .. .. .. NOTAUTH0E .. E0 .. .. .. .. .. INVREQ0E .. E1 .. .. .. .. .. LENGERR0E .. F1 .. .. .. .. .. TERMERR

EIBFN EIBRCODE Condition10 .. 01 .. .. .. .. .. ENDDATA10 .. 04 .. .. .. .. .. IOERR10 .. 11 .. .. .. .. .. TRANSIDERR10 .. 12 .. .. .. .. .. TERMIDERR10 .. 20 .. .. .. .. .. EXPIRED10 .. 81 .. .. .. .. .. NOTFND10 .. D0 .. .. .. .. .. SYSIDERR3

10 .. D1 .. .. .. .. .. ISCINVREQ10 .. D6 .. .. .. .. .. NOTAUTH10 .. D8 .. .. .. .. .. USERIDERR10 .. E1 .. .. .. .. .. LENGERR10 .. E9 .. .. .. .. .. ENVDEFERR10 .. FF .. .. .. .. .. INVREQ

12 .. 32 .. .. .. .. .. ENQBUSY12 .. E0 .. .. .. .. .. INVREQ12 .. E1 .. .. .. .. .. LENGERR

14 .. 01 .. .. .. .. .. JIDERR14 .. 02 .. .. .. .. .. INVREQ14 .. 05 .. .. .. .. .. NOTOPEN14 .. 06 .. .. .. .. .. LENGERR14 .. 07 .. .. .. .. .. IOERR14 .. 09 .. .. .. .. .. NOJBUFSP14 .. D6 .. .. .. .. .. NOTAUTH

16 .. 01 .. .. .. .. .. ROLLEDBACK

18 .. 01 .. .. .. .. .. INVREQ18 .. 02 .. .. .. .. .. RETPAGE18 .. 04 .. .. .. .. .. MAPFAIL18 .. 08 .. .. .. .. .. INVMPSZ2

18 .. 20 .. .. .. .. .. INVERRTERM18 .. 40 .. .. .. .. .. RTESOME18 .. 80 .. .. .. .. .. RTEFAIL18 .. E1 .. .. .. .. .. LENGERR18 .. E3 .. .. .. .. .. WRBRK18 .. E4 .. .. .. .. .. RDATT18 .. .. 02 .. .. .. .. PARTNFAIL18 .. .. 04 .. .. .. .. INVPARTN18 .. .. 08 .. .. .. .. INVPARTNSET18 .. .. 10 .. .. .. .. INVLDC18 .. .. 20 .. .. .. .. UNEXPIN

EIB

258 CICS TS for OS/390: CICS User’s Handbook

EIBFN EIBRCODE Condition18 .. .. 40 .. .. .. .. IGREQCD18 .. .. 80 .. .. .. .. TSIOERR18 .. .. .. 01 .. .. .. OVERFLOW18 .. .. .. 04 .. .. .. EODS18 .. .. .. 08 .. .. .. EOC18 .. .. .. 10 .. .. .. IGREQID

1A .. E0 .. .. .. .. .. INVREQ1A .. 04 .. .. .. .. .. DSSTAT1A .. 08 .. .. .. .. .. FUNCERR1A .. 0C .. .. .. .. .. SELNERR1A .. 10 .. .. .. .. .. UNEXPIN1A .. E1 .. .. .. .. .. LENGERR1A .. .. 11 .. .. .. .. EODS1A .. .. 2B .. .. .. .. IGREQCD1A .. .. .. 20 .. .. .. EOC

22 .. 80 .. .. .. .. .. INVEXITREQ

4A .. .. .. .. 01 .. .. ERROR

56 .. .. .. .. 0D .. .. NOTFND56 .. .. .. .. 10 .. .. INVREQ56 .. .. .. .. 13 .. .. NOTOPEN56 .. .. .. .. 14 .. .. ENDFILE56 .. .. .. .. 15 .. .. ILLOGIC56 .. .. .. .. 16 .. .. LENGERR56 .. .. .. .. 2A .. .. NOSTG56 .. .. .. .. 46 .. .. NOTAUTH56 .. .. .. .. 50 .. .. NOSPOOL56 .. .. .. .. 55 .. .. ALLOCERR56 .. .. .. .. 56 .. .. STRELERR56 .. .. .. .. 57 .. .. OPENERR56 .. .. .. .. 58 .. .. SPOLBUSY56 .. .. .. .. 59 .. .. SPOLERR56 .. .. .. .. 5A .. .. NODEIDERR56 .. .. .. .. 60 .. .. OUTDESCRERR

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

EIB

Chapter 8. EXEC interface block (EIB) 259

VSAM Administration: Macro Instruction Reference manual for VSAM, and theData Facility Product Customization Guide for BDAM.

2. When INVMPSZ occurs during BMS operations, byte 3 of field EIBRCODEcontains the terminal code:.. .. .. xx .. ..

terminal code3. When SYSIDERR occurs, further information is provided in bytes 1 and 2 of

EIBRCODE, as follows:.. 04 00 .. .. ..

request was for invalid function.. 04 04 .. .. ..

no session available and NOQUEUE.. 04 08 .. .. ..

mode name not found.. 04 0C .. .. ..

mode name invalid.. 04 10 .. .. ..

task canceled or timed out during allocation.. 04 14 .. .. ..

mode group is out of service.. 04 18 .. .. ..

close - DRAIN=ALL (Note: APPC only).. 08 .. .. .. ..

SYSID out of service – for function shipping requests, the exit program(XISCONA) may have refused to queue the request because theintersystem connection is busy

.. 0C xx .. .. ..SYSID definition error

.. 0C 00 .. .. ..name not that of TCTSE

.. 0C 04 .. .. ..name not that of remote TCTSE

.. 0C 08 .. .. ..mode name not found

.. 0C 0C .. .. ..profile not found

Further information about SYSIDERR can be found in the CICSIntercommunication Guide.

4. When SESSIONERR occurs, further information is provided in bytes 1 and 2 ofEIBRCODE, as follows:.. 08 .. .. .. ..

session out of service.. 0C xx .. .. ..

session definition error.. 0C 00 .. .. ..

name not found.. 0C 0C .. .. ..

profile not found

Further information about SESSIONERR can be found in the CICSIntercommunication Guide.

5. If SYSBUSY occurs on an ALLOCATE command that attempts to acquire asession to an APPC terminal or system, byte 3 of the EIBRCODE indicateswhere the error condition was detected:

EIB

260 CICS TS for OS/390: CICS User’s Handbook

.. .. .. 00 .. ..the request was for a session to a connected terminal or system

.. .. .. 01 .. ..the request was for a session to a remotely connected terminal orsystem, and the error occurred in the terminal-owning region (TOR) oran intermediate system

.. .. .. 02 .. ..the request was for a session to a remotely connected terminal orsystem, and the error occurred in the application-owning region (AOR)

Further information about SYSBUSY can be found in the CICSIntercommunication Guide.

6. When INVREQ occurs during terminal control operations, further informationis provided in byte 3 of EIBRCODE as follows:.. .. .. 04 .. ..

ALLOCATE command - TCTTE already allocated.. .. .. 08 .. ..

FREE command - TCTTE in wrong state.. .. .. 0C .. ..

CONNECT PROCESS command - SYNCLVL 2 has been requested butcannot be supported on the session in use

.. .. .. 10 .. ..EXTRACT ATTACH command - invalid data

.. .. .. 14 .. ..SEND command - CONFIRM option has been specified butconversation is not SYNCLVL 1

.. .. .. 18 .. ..EXTRACT TCT command - invalid netname

.. .. .. 1C .. ..an invalid command has been issued for the terminal or logical unit inuse

.. .. .. 20 .. ..an invalid command has been issued for the LU6.2 conversation type inuse

.. .. .. 28 .. ..GETMAIN failure on ISSUE PASS command

7. When LENGERR occurs during terminal control operations, further informationis provided in byte 1 of EIBRCODE, as follows:.. 00 .. .. .. ..

input data is overlong and has been truncated.. 04 .. .. .. ..

on output commands, an invalid (FROM)LENGTH has been specified,either less than zero or greater than 32767

.. 08 .. .. .. ..on input commands, an invalid (TO)LENGTH has been specified,greater than 32767

.. 0C .. .. .. ..length error has occurred on ISSUE PASS command

RESP values and conditions

RESPvalueCondition00 NORMAL01 ERROR02 RDATT

EIB

Chapter 8. EXEC interface block (EIB) 261

RESPvalueCondition03 WRBRK04 EOF05 EODS06 EOC07 INBFMH08 ENDINPT09 NONVAL10 NOSTART11 TERMIDERR12 FILENOTFOUND13 NOTFND14 DUPREC15 DUPKEY16 INVREQ17 IOERR18 NOSPACE19 NOTOPEN20 ENDFILE21 ILLOGIC22 LENGERR23 QZERO24 SIGNAL25 QBUSY26 ITEMERR27 PGMIDERR28 TRANSIDERR29 ENDDATA30 INVTSREQ31 EXPIRED32 RETPAGE33 RTEFAIL34 RTESOME35 TSIOERR36 MAPFAIL37 INVERRTERM38 INVMPSZ39 IGREQID40 OVERFLOW41 INVLDC42 NOSTG43 JIDERR44 QIDERR45 NOJBUFSP46 DSSTAT47 SELNERR48 FUNCERR49 UNEXPIN50 NOPASSBKRD51 NOPASSBKWR52 -53 SYSIDERR54 ISCINVREQ55 ENQBUSY56 ENVDEFERR

EIB

262 CICS TS for OS/390: CICS User’s Handbook

RESPvalueCondition57 IGREQCD58 SESSIONERR59 SYSBUSY60 SESSBUSY61 NOTALLOC62 CBIDERR63 INVEXITREQ64 INVPARTNSET65 INVPARTN66 PARTNFAIL67 -68 -69 USERIDERR70 NOTAUTH71 VOLIDERR72 SUPPRESSED73 -74 -75 RESIDERR76 -77 -78 -79 -80 NOSPOOL81 TERMERR82 ROLLEDBACK83 END84 DISABLED85 ALLOCERR86 STRELERR87 OPENERR88 SPOLBUSY89 SPOLERR90 NODEIDERR91 TASKIDERR92 TCIDERR93 DSNNOTFOUND94 LOADING95 MODELIDERR96 OUTDESCRERR97 PARTNERIDERR98 PROFILEIDERR99 NETNAMEIDERR100 LOCKED101 RECORDBUSY102 UOWNOTFOUND103 UOWLNOTFOUND104 LINKABEND105 CHANGED106 PROCESSBUSY107 ACTIVITYBUSY108 PROCESSERR109 ACTIVITYERR110 CONTAINERERR

EIB

Chapter 8. EXEC interface block (EIB) 263

RESPvalueCondition111 EVENTERR112 TOKENERR113 NOTFINISHED114 POOLERR115 TIMERERR116 SYMBOLERR117 TEMPLATERR118 -

EIB

264 CICS TS for OS/390: CICS User’s Handbook

Chapter 9. RESP2 values and their meanings

Note: The RESP2 values returned by the CICS/ESA Front End ProgrammingInterface are described in the CICS Front End Programming Interface User’sGuide.

Command Condition RESP2 MeaningACQUIRE TERMINAL INVREQ 2 The terminal is a remote terminal

3 The terminal is LU6.1, APPC, IRC ora non-VTAM device

4 The terminal is not in service; that is,it is not available for use.

5 VTAM is not open7 CICS is already in the process of

acquiring this session.8 NOQUEUE and QNOTENAB options

are invalid for a logged-on deviceLENGERR 6 Out-of-range value supplied in the

USERDATALEN optionNOTAUTH 100 The user associated with the task is

not authorized to use this commandTERMIDERR 1 The terminal cannot be found

ADDRESS INVREQ 200 The TCTUA option is specified on anADDRESS command issued in a DPLserver program

ASSIGN INVREQ 1 The task does not have a signed-onuser

2 No BMS command has yet beenissued, BMS routing is in effect, or nomap has yet been positioned

3 No BDI command has yet beenissued

4 The task is not initiated by automatictransaction initiation (ATI)

5 The task is not associated with aterminal; or the task has no principalfacility; or the principal facility is notan MRO, LU6.1, or APPC session

6 A CICS BTS request is issued fromoutside

200 Command syntax options are notallowed in a server program invokedby a distributed program link

CHANGE PASSWORD INVREQ 13 There is an unknown return code inESMRESP from the external securitymanager

18 The CICS external security managerinterface is not initialized

29 The external security manager is notresponding

NOTAUTH 2 The supplied password is wrong4 The new password is not acceptable

© Copyright IBM Corp. 1989, 2000 265

Command Condition RESP2 Meaning19 The USERID is revoked22 The change password request failed

during SECLEVEL processing31 The user is revoked in the connection

to the default groupUSERIDERR 8 The USERID is not known to the

external security manager

CHANGE TASK INVREQ 1 The PRIORITY value is outside therange 0–255

COLLECT STATISTICS NOTFND 1 The requested resource cannot befound (for example, if theJOURNALNAME specified is notknown to CICS)

2 The type of resource is not defined inthe CICS system

IOERR 3 The requested statistics area was notfunctioning

INVREQ 4 The TCLASS value was not in therange 1–10, or the LSRPOOL valuewas not in the range 1–8

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the task isnot authorized to access thisparticular resource in the wayrequired by this command

CONNECT PROCESS INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

CONVERSE INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

CREATE CONNECTION LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier connection orterminal pool definition has not yetbeen completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

102 The user of the transaction issuingthe CREATE CONNECTION is notan authorized surrogate of the useridspecified in SECURITYNAME

266 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningINVREQ n Syntax error in ATTRIBUTES string,

or error occurred during eitherdiscard or resource definition phaseof processing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE DB2CONN LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 Command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition not yetcompleted

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram defined with anEXECUTIONSET value ofDPLSUBSET or a program invokedfrom a remote system by adistributed program link without theSYNCONRETURN option.

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

102 The user associated with the issuingtask is not an authorized surrogate ofthe user specified in AUTHID,COMAUTHID, or SIGNID parameter

103 The user associated with the issuingtask is not authorized to create aDB2CONN with an AUTHTYPE orCOMAUTHTYPE parameter

CREATE DB2ENTRY LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 Command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition not yetcompleted

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram defined with anEXECUTIONSET value ofDPLSUBSET or a program invokedfrom a remote system by adistributed program link without theSYNCONRETURN option.

Chapter 9. RESP2 values and their meanings 267

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create aDB2ENTRY definition with this name

102 The user associated with the issuingtask is not an authorized surrogate ofthe user specified in the AUTHIDparameter

103 The user associated with the issuingtask is not authorized to create aDB2ENTRY with an AUTHTYPEparameter

CREATE DB2TRAN LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 Command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition not yetcompleted

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram defined with anEXECUTIONSET value ofDPLSUBSET or a program invokedfrom a remote system by adistributed program link without theSYNCONRETURN option.

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create aDB2TRAN definition and associate itwith the named DB2ENTRY

102 The user associated with the issuingtask is not an authorized surrogate ofthe user specified in the AUTHIDparameter of the DB2ENTRY namedin the DB2TRAN

103 The user associated with the issuingtask is not authorized to create aDB2TRAN with the DB2ENTRYspecifying AUTHTYPE

CREATEDOCTEMPLATE

LENGERR 1 The length specified in ATTRLEN isnegative

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

268 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning200 The command was executed in a

program defined with anEXECUTIONSET value ofDPLSUBSET or a program invokedfrom a remote system by adistributed program link without theSYNCONRETURN option.

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

CREATE ENQMODEL LENGERR 1 The length specified in ATTRLEN isnegative

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram defined with anEXECUTIONSET value ofDPLSUBSET or a program invokedfrom a remote system by adistributed program link without theSYNCONRETURN option.

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create this aENQMODEL definition with thisname

CREATE FILE LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier connection orterminal pool definition has not yetbeen completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create aFILE definition with this name

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATEJOURNALMODEL

LENGERR 1 The length specified in ATTRLEN isnegative

Chapter 9. RESP2 values and their meanings 269

Command Condition RESP2 MeaningILLOGIC 2 The command cannot be executed

because an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE LSRPOOL LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE MAPSET LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create aMAPSET definition with this name

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

270 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning200 The command was executed in a

program that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATEPARTITIONSET

LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create thisparticular PARTITIONSET

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE PARTNER LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE PROFILE LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

Chapter 9. RESP2 values and their meanings 271

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE PROGRAM LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create thisparticular PROGRAM

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATEREQUESTMODEL

LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

272 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning200 The command was executed in a

program that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE SESSIONS LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

102 The user of transaction issuingCREATE SESSIONS is not anauthorized surrogate of the userspecified in USERID

102 The user of the transaction issuingthe CREATE SESSIONS command isnot an authorized surrogate of theuserid specified in USERID

INVREQ 200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE TCPIPSERVICE INVREQ n Syntax error in ATTRIBUTE string oran error occurred during either thediscard or resource definition phaseof processing

200 The command executed in programdefined with an EXECUTIONSET orDPLSUBSET, or a program invokedfrom a remote system by adistributed program link without theSYNCONRETURN option.

LENGERR 1 Length specified in ATTRLEN isnegative

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

CREATE TDQUEUE LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create aTDQUEUE definition with this name

Chapter 9. RESP2 values and their meanings 273

Command Condition RESP2 Meaning102 The user of the transaction issuing

the CREATE TDQUEUE command isnot an authorized surrogate of theuser specified in USERID

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE TERMINAL LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

102 The user of the transaction issuingthe CREATE TERMINAL commandis not an authorized surrogate of theuserid specified in USERID

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE TRANCLASS LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

274 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning200 The command was executed in a

program that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATETRANSACTION

LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create thisparticular TRANSACTION

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE TSMODEL LENGERR 1 The length specified in ATTRLEN isnegative

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to create aTSMODEL definition with this name

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

CREATE TYPETERM LENGERR 1 The length specified in ATTRLEN isnegative

ILLOGIC 2 The command cannot be executedbecause an earlier CONNECTION orTERMINAL pool definition has notyet been completed

Chapter 9. RESP2 values and their meanings 275

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

200 The command was executed in aprogram that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

DEFINE COUNTER INVREQ 202 Duplicate counter name301 The server has reported an error that

is not nderstood by the namescounter interface

302 The server cannot create the newnamed counter because there is notenough spacce in the named counterpool

303 An unexpected error has occurred ona macro used to access the couplingfacility

304 The pool selection parameterspecified in the program cannot beresolved to a valid server name usingthe current options table

305 The interface is unable to establish aconnection to the server for theselected named counter pool

306 An abend occurred during serverprocesing of a request

308 The DFHNCOPT options tablemodule could not be loaded

309 The named counter interfaceencountered an unknown entryformat

310 The user exit program is notlink-edited with the options table andcannot be loaded

403 The POOL parameter containsinvalid characters or embeddedspaces

404 The COUNTER parameter containsinvalid characters or embeddedspaces

406 The VALUE parameter is invalid407 The MINIMUM or MAXIMUM

parameter is invalid

DELAY INVREQ 4 Hours are out of range5 Minutes are out of range6 Seconds are out of range

276 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningDELETE FILENOTFOUND 1 The file name referred to in the FILE

option cannot be found in the FCTCHANGED 109 A DELETE command (without

RIDFLD) issued for a file defined asa coupling facility data table and therecord has been changed since theapplication program read it forupdate

INVREQ 20 Delete operations are not allowedaccording to the file entryspecification in the FCT or theuser-maintained data table wasdefined as a CICS file and thedefinition does not allow for deleteoperations

21 A DELETE command was issued fora file referring to a VSAM ESDS

22 A generic delete was issued for a filethat is not a VSAM KSDS

25 The KEYLENGTH and GENERICoptions were specified, and thelength specified in the KEYLENGTHoption is greater than or equal to thelength of a full key

26 The KEYLENGTH option wasspecified (but the GENERIC option isnot specified), and the specifiedlength does not equal the lengthdefined for the data set to which thisfile refers

27 A DELETE command was issued fora file referring to a BDAM data set

31 A DELETE command without theRIDFLD option was issued for a filefor which no previous READUPDATE command has been issued

42 The KEYLENGTH and GENERICoptions were specified, and thelength specified in the KEYLENGTHoption is less than zero

44 The DELETE command does notconform to the format of DELETE fora user-maintained table; for exampleif GENERIC were specified

47 A DELETE instruction included atoken whose value cannot bematched against any token in use foran existing READ for UPDATErequest

51 A DELETE command specifying theRBA keyword was issued against aKSDS file that is being accessed inRLS mode. RLS does not supportrelative byte address (RBA) access toKSDS files

55 NOSUSPEND was specified for anon-RLS file

Chapter 9. RESP2 values and their meanings 277

Command Condition RESP2 Meaning56 An attempt to update a recoverable

coupling facility data table has failedDISABLED 50 A file is disabledNOTOPEN 60 The requested file is CLOSED and

UNENABLED or the requested file isOPEN and in use by othertransactions, but a close requestagainst it has been received or aDELETE command has been issuedagainst a data set that is quiesced, oris being quiesced, as a result of a SETDSNAME QUIESCED orIMMQUIESCED commend

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTFND 80 An attempt to delete a record basedon the search argument provided isunsuccessful or, for user-maintaineddata tables, an attempt to delete arecord was unsuccessful becausethere is no entry with the specifiedkey in the data table

NOTAUTH 101 A resource security check has failedon FILE(filename)

LOADING 104 A delete request has been issued fora user-maintained table that iscurrently being loaded

LOCKED 106 An attempt has been made to deletea record specifying the RIDFLD, buta retained lock exists against this key.If the request specified the GENERICkeyword, all possible records aredeleted, but the locked recordsremain. The number of recordsdeleted is returned by NUMREC

RECORDBUSY 107 The NOSUSPEND keyword wasspecified for the deletion of a recordthat is locked by a VSAM active lock

ILLOGIC 110 A VSAM error has occurred whichdoes not fall within the one of theother CICS response categories

IOERR 120 There has been an I/O error duringthe file control operation

SYSIDERR 130 The SYSID option specified a namethat is neither the local nor theremote system (made known to CICSby defining a CONNECTION); or thelink to the remote system was closed.

131 The connection to the couplingfacility data table server has failed

132 The DELETE is issued against acoupling facility data table that nolonger exists

278 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningDUPKEY 140 A record has been accessed by way

of an alternate index with theNONUNIQUEKEY attribute, andanother alternate index record withthe same key follows

DELETE COUNTER INVREQ 201 The named counter not found301 The server has reported an error code

that is not understood by the namedcounter interface

303 An unexpected error has occurred ona macro used to access the couplingfacility

304 The pool selection parameterspecified in the program cannot beresolved to a valid server name usingthe current options table

305 The interface is unable to establish aconnection to the server for thenamed counter pool

306 An abend occurred during serverprocessing of a request

308 The DFHNCOPT options tablemodule could not be loaded

309 The named counter interfaceencountered an unknown entryformat

310 The user exit program is notlink-edited with the options table andcannot be loaded

403 The pool selection parameter containscharacters that are not allowed orembedded spaces

DEQ LENGERR 1 The value specified for the LENGTHoption is outside the range 1–255

INVREQ 2 The MAXLIFETIME option has anincorrect CVDA

DISABLE PROGRAM NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command.

DISCARDAUTINSTMODEL

MODELIDERR 1 The model cannot be found

INVREQ 2 The model you requested is currentlyin use

3 The model cannot be discardedbecause its name begins with DFH

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

Chapter 9. RESP2 values and their meanings 279

Command Condition RESP2 Meaning

DISCARDCONNECTION

SYSIDERR 9 The named connection cannot befound

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

SYNCONRETURNNOTAUTH 100 The user of this command is not

authorized

DISCARD DB2CONN INVREQ 2 The CICS DB2 interface is activeNOTFND 1 A DB2CONN cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

DISCARD DB2ENTRY INVREQ 2 The DB2ENTRY is currently in use3 The DB2ENTRY is not disabled

NOTFND 1 The DB2ENTRY cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

DISCARD DB2TRAN NOTFND 1 The DB2ENTRY cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access theDB2ENTRY referenced by thisDB2TRAN in the way required bythis command

DISCARDDOCTEMPLATE

LENGERR 1 The length specified in ATTRLEN isnegative

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INVREQ n There is a syntax error in theATTRIBUTES string, or an erroroccurred during either the discard orresource definition phase ofprocessing

280 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning200 The command was executed in a

program that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

DISCARD ENQMODEL NOTFND 1 The specified ENQMODEL is notinstalled on this system

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

DISCARD FILE INVREQ 2 The file is not closed3 The file is not disabled25 The file definition is currently in use26 The file cannot be discarded because

its name begins with DFH43 The file cannot be discarded because

it has work outstanding for whichthere are retained locks

FILENOTFOUND 18 The file cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

DISCARDJOURNALMODEL

NOTFND 1 The specified JOURNALMODELname was not found

NOTAUTH 100 The user is not authorized for thiscommand

DISCARDJOURNALNAME

INVREQ 3 The specified journal name (forexample, the system log) cannot bediscarded

JIDERR 1 The journal cannot be foundNOTAUTH 100 The user is not authorized for this

command101 The user does not have the required

access authority to the specifiedjournal name

DISCARD PARTNER PARTNERIDERR 1 The partner cannot be found5 The Partner Resource Manager

(PRM) is not active, because it failedto initialize during CICS initialization

INVREQ 2 The partner definition is currently inuse

3 The partner cannot be discardedbecause its name begins with DFH

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

DISCARD PROFILE PROFILEIDERR 1 The profile cannot be foundINVREQ 2 The profile definition is currently in

use

Chapter 9. RESP2 values and their meanings 281

Command Condition RESP2 Meaning3 A transaction definition points to the

profile4 The profile cannot be discarded

because its name begins with DFHNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

DISCARD PROGRAM INVREQ 1 The resource cannot be discardedbecause its name begins with DFH

11 The resource definition is currently inuse

15 The resource cannot be discardedbecause it is a user-replaceablemodule

PGMIDERR 7 The resource definition cannot befound

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

DISCARDREQUESTMODEL

NOTFND 1 The requested model name was notfound

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

DISCARDTCPIPSERVICE

INVREQ 9 The TCPIPservice is still open

NOTFND 3 The TCPIPSERVICE name was notfound

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

DISCARD TDQUEUE QIDERR 1 The queue cannot be foundINVREQ 11 The queue name begins with the

letter C18 The queue is not closed30 Disable pending31 The queue is not disabled200 The command was executed in a

program that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

DISCARD TERMINAL TERMIDERR 23 Named terminal cannot be found

282 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningINVREQ 33 APPC session or device

38 Terminal type not VTAM or console39 Not out of service and not remote40 Error console41 MRO session43 Delete failed44 Remote and in-use45 Locked by another RDO action46 Delete already in flight200 The command was executed in a

program that has been linked to froma remote system that has notspecified the SYNCONRETURNoption, or has been linked to locallyand is defined withEXECUTIONSET=DPLSUBSET

NOTAUTH 100 The use of this command is notauthorized

DISCARD TRANCLASS TCIDERR 1 The transaction class cannot be foundINVREQ 2 The TRANCLASS definition is in use

12 The transaction class cannot bediscarded because installedtransactions belong to it

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

DISCARDTRANSACTION

TRANSIDERR 1 The transaction cannot be found

INVREQ 4 The transaction cannot be discardedbecause its name begins with C

13 The transaction is a SIT parameter14 The transaction is scheduled to run at

a future time (in use by an intervalcontrol element)

15 The transaction is scheduled to runwhen required resources are available(in use by an automatic initiatedescriptor)

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

DISCARD TSMODEL NOTFND 1 The TSMODEL does not existINVREQ 2 The TSMODEL definition is currentl

in use3 The TS model cannot be discarded

because its name begins with DFHNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

Chapter 9. RESP2 values and their meanings 283

Command Condition RESP2 Meaning101 The user associated with the issuing

task is not authorized to discard aTSMODEL with this name

DOCUMENT CREATE INVREQ 1 The retrieved document specified onthe FROM option is not in a validRETRIEVE format

NOTFND 2 The document specified on theFROMDOC option could not befound or was named incorrectly

3 The template specified on theTEMPLATE option could not befound or was named incorrectly

7 The host codepage specified on theHOSTCODEPAGE option could notbe found or was named incorrectly

8 The value specified for DELIMITERis not valid

DOCUMENT INSERT INVREQ 0 The bookmark specified on the TOoption appears before the bookmarkon the AT bookmark

1 The retrieved document specified onthe FROM option is not in a validRETRIEVE format

2 The bookmart name on theBOOKMARK option is invalid

NOTFND 1 The document specified on theDOCUMENT option is not found orthe name is incorrect

2 The document specified on theFROMDOC option is not found orthe name is incorrect

3 The template specified on theTEMPLATE option is not found orthe name is incorrect

4 The document specified on theSYMBOL option is not found or thename is incorrect

5 The document specified on the AToption is not found or the name isincorrect

6 The document specified on the TOoption is not found or the name isincorrect

7 The document specified on theHOSTCODEPAGE option is notfound or the name is incorrect

DOCUMENT RETRIEVE LENGERR 1 MAXLENGTH is less than or equalto zero

2 The length of the receiving buffer iszero or is too short to contain thedocument contents

NOTFND 1 The document has not been createdor the name is incorrectly specified

284 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning7 The specified client codepage cannot

be found

DOCUMENT SET INVREQ 8 The value specified for DELIMITERis not valid

NOTFND 1 The document has not been createdot the name is incorrectly specified

SYMBOLERR 0 SYMBOLLIST was not used

DUMP TRANSACTION SUPPRESSED 1 The transaction dump is suppressedby MAXIMUM in table

2 The transaction dump is suppressedby NOTRANDUMP in table

3 The transaction dump is suppressedby a user exit program

NOSPACE 4 The transaction dump is incompletedue to lack of space

NOSTG 5 CICS has run out of working storageNOTOPEN 6 The current CICS dump routine is

not openOPENERR 7 Error on opening, closing, or writing

to, the current CICS dump routineIOERR 9 The SDUMP process was not

authorized10 An error occurred during system

dumping13 The CICS routine issuing the SDUMP

was unable to establish a recoveryroutine (FESTAE)

INVREQ 13 An incorrect DUMPCODE wasspecified. DUMPCODE must notcontain leading or imbedded blanks

ENABLE PROGRAM NOTAUTH 100 The user associated with the issuingtask is not authorized to issue thiscommand

101 The user associated with the task isnot authorized to access thisparticular resource in the wayrequired by this command.

ENDBR FILENOTFOUND 1 The name referred to in the FILEoption cannot be found in the FCT

INVREQ 35 The REQID, if any, does not matchthat of any successful STARTBRcommand

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTAUTH 101 A resource security check has failedon FILE(filename)

ILLOGIC 110 A VSAM error which does not fallwithin one of the other CICSresponse categories has occurred.

IOERR 120 There has been an I/O error duringthe operation

Chapter 9. RESP2 values and their meanings 285

Command Condition RESP2 MeaningSYSIDERR 130 The SYSID option specified a name

that is neither the local nor theremote system (made known to CICSby defining a connection); or the linkto the remote system is closed.

ENQ LENGERR 1 The value specified for the LENGTHoption is outside the range 1–255

INVREQ 2 The MAXLIFETIME option has anincorrect CVDA

ENTER TRACENUM INVREQ 1 TRACENUM is outside the range0–199

2 There is no valid trace destination3 The user trace master flag is set OFF

and EXCEPTION has not beenspecified

LENGERR 4 FROMLENGTH is outside the range0–4000 specified

EXTRACT ATTRIBUTES(APPC)

INVREQ 200 A distributed program link serverapplication explicitly, or implicitly bydefault, specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

EXTRACT ATTRIBUTES(MRO)

INVREQ 200 A distributed program link serverapplication explicitly, or implicitly bydefault, specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

EXTRACT EXIT NOTAUTH 100 The user associated with the issuingtask is not authorized to issue thiscommand

EXTRACT EXIT NOTAUTH 100 The user associated with the issuingtask is not authorized to issue thiscommand

101 The user associated with the task isnot authorized to access thisparticular resource in the wayrequired by this command.

EXTRACT PROCESS INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

EXTRACT TCPIP INVREQ 2 Invalid socket response5 The command being issued is from a

non-TCPIP applicationLENGERR 3 CLIENTADDR is too small

4 SERVERADDR is too small

286 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning6 CLIENTNAME is too small7 SERVERNAME is too small

FORMATTIME INVREQ 1 The ABSTIME option is in anincorrect format

FREE (APPC) INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

FREEMAIN INVREQ 1 The storage specified by the DATA orDATAPOINTER parameter was notstorage acquired by a GETMAINcommand

2 The storage area specified by theDATA or DATAPOINTER parameterwas in CICS-key storage, and theprogram issuing the FREEMAINcommand was in user-key.

GET COUNTER INVREQ 201 The named counter not found301 The server has reported an error that

is not understood by the namedcounter interface

303 An unexpected error occurred on amacro used to access the couplingfacility

304 The pool selection parameterspecified cannot be resolved to avalid server name using the currentoptions table

305 The interface is unable to establish aconnection to the server for thenamed counter pool

306 An abend occurred during serverprocessing of a request

308 The DFHNCOPT options tablemodule could not be loaded

309 The named counter interfaceencountered an unknown entryformat during processing of theoptions table

310 The user exit program is notlink-edited with the options table andconnot be loaded

403 The POOL parameter containsinvalid characters or embeddedspaces

404 The COUNTER parameter containsinvalid characters or embeddedspaces

406 The INCREMENT value is invalid

Chapter 9. RESP2 values and their meanings 287

Command Condition RESP2 MeaningLENGERR 001 The current value that the server has

attempted to return in the VALUEdata area has overflowed into thehigh-order (sign) bit

002 The current value is too large for afullword data area by only 1 bit

003 The current value is too large for afullword data area by a value greaterthan 1

SUPPRESSED 101 The maximum value for the namedcounter has already been assignedand the counter is in the’counter-at-limit’ condition

103 The current value of the namedcounter is not within the rangespecified by the COMPAREMAX andCOMPAREMIN parameters,pub orgreater than the COMPAREMAXparameter or less than theCOMPAREMIN parameter whenonly one option is specified

GETMAIN LENGERR 1 The FLENGTH value was less than 1or greater than the length of thetarget storage area from which therequest was to be satisfied

NOSTG 2 The storage requested was more thanwas currently available in the targetDSA

HANDLE ABEND PGMIDERR 1 The program has no entry in the PPTand autoinstall for programs is notactive

2 The program is disabled9 The installed program definition is

for a remote program

HANDLE AID INVREQ 200 The command was issued by adistributed program link serverapplication

INQUIREAUTINSTMODEL

ILLOGIC 1 A START has been given when abrowse is already in progress, or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

MODELIDERR 1 The model specified cannot be foundEND 2 There are no more resource

definitions of this typeNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INQUIREAUTOINSTALL

INVREQ 20 The console has an invalid CVDAvalue

288 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INQUIRE CFDTPOOL END 2 There are no more coupling facilitydata table pools to browse

ILLOGIC 1 START command issued whenCFDTPOOLs already in progress, orNEXT or END issued whenCFDTPOOLs is not in progress

POOLERR 1 Named CFDTPOOL was not found2 An internal control structure that

CICS uses to maintain access toCFDT pools has been altered whilethe set of pools known to CICS wasbeing browsed.

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRECONNECTION

END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SYSIDERR 1 The named connection could not befound

INQUIRE DB2CONN NOTFND 1 The requested DB2CONN cannot befound

NOTAUTH 100 Command authorization failureINQUIRE DB2ENTRY NOTFND 1 The requested DB2ENTRY cannot be

foundNOTAUTH 100 Command authorization failure

101 Resource authorization failureINQUIRE DB2TRAN NOTFND 1 The requested DB2TRAN cannot be

foundNOTAUTH 100 Command authorization failure

101 Resource authorization failure

INQUIREDELETSHIPPED

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIREDOCTEMPLATE

END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

Chapter 9. RESP2 values and their meanings 289

Command Condition RESP2 MeaningMODELIDERR 1 The DOCTEMPLATE specified

cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INQUIRE DSNAME DSNNOTFOUND 1 The data set cannot be foundEND 2 There are no more resource

definitions of this typeILLOGIC 1 A START has been given when a

browse is already in progress or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

IOERR 40 QUIESCESTATE was specified, butan error was raised by DFSMSreading the ICF catalog

49 An error was raised by DFSMSreading the ICF catalog to establishthe base data set name

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE DUMPDS NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE ENQMODEL END 2 There are no more resourcedefinitions of this type

NOTFND 1 The ENQMODEL cannot be foundILLOGIC 1 A START has been issued when a

browse of this resoutrce type isalready in progress, or a NEXT otEND issued when a browse of thisresource type is not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

INQUIRE EXCI END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been issued when abrowse of this resoutrce type isalready in progress, or a NEXT otEND issued when a browse of thisresource type is not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

290 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning

INQUIREEXITPROGRAM

END 2 There are no more resourcedefinitions of this type

INVREQ 3 The exit point identified by EXITdoes not exist

ILLOGIC 1 A START has been given when abrowse is already in progress, or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

PGMIDERR 1 v The exit identified byEXITPROGRAM andENTRYNAME is not enabled, or

v The EXIT parameter is missing foran inquiry on a global user exit, or

v The EXIT parameter is present ona task-related user exit

INQUIRE FILE END 2 There are no more resourcedefinitions as this type

FILENOTFOUND 1 The file cannot be foundILLOGIC 1 A START has been given when a

browse is already in progress or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

INQUIRE IRC NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIREJOURNALMODEL

END 2 All authorized resource definitionshave been retrieved. All data areasspecified on this command are leftunchanged

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwithout a preceding START

2 The browse token is not validNOTFND 1 The specified journal model was not

found

Chapter 9. RESP2 values and their meanings 291

Command Condition RESP2 MeaningNOTAUTH 100 The user is not authorized for this

command

INQUIREJOURNALNAME

END 2 All authorized resource definitionshave been retrieved. All data areasspecified on this command are leftunchanged

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwithout a preceding START

2 The browse token is not validJIDERR 1 The specified journal name was not

foundNOTAUTH 100 The user is not authorized for this

command101 The user does not have the required

access authority to the specifiedresource (Not applicable to INQUIREJOURNALNAME START, INQUIREJOURNALNAME NEXT, orINQUIRE JOURNALNAME ENDcommands)

INQUIRE MODENAME END 2 There are no more resourcedifinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress, or aNEXT or END has been given whena browse of this resource type is notin progress

SYSIDERR 1 The connection cannot be found2 The modename within the connection

cannot be found3 The connection specified on an

INQUIRE MODENAME NEXTcannot be found

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE MONITOR NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE PARTNER END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwhen a browse if this resource typeis not in progress

PARTNERIDERR 1 The partner cannot be found2 Partner Resource Manager (PRM) is

not active, because it failed toinitialize during CICS initialization

292 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INQUIRE PROFILE END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress, or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

PROFILEIDERR 1 The profile cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INQUIRE PROGRAM END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

PGMIDERR 1 The program cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

INQUIRE REQID NOTFND 1 The REQID cannot be foundILLOGIC 1 You have issued a START command

when a browse is already inprogress, or a NEXT or an ENDissued when a browse of thisresource type is not in progress

END 2 There are no more resourcedefinitions of this type

INVREQ 3 An I/O error occurred while anattempt was made to read data fromtemporary storage for the SET,QUEUE, RTERMID or RTRANSIDoption

4 Data required for the SET, QUEUE,RTERMID or RTRANSID optioncannot be returned because it hasbeen deleted from temporary storage

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIREREQUESTMODEL

NOTFND 1 The specified erquest model was notfound

Chapter 9. RESP2 values and their meanings 293

Command Condition RESP2 MeaningILLOGIC 1 You have issued a START command

when a browse is already inprogress, or a NEXT or an ENDissued when a browse of thisresource type is not in progress

END 2 All authorized resource definitionshave been retrieved

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE STATISTICS NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE STORAGE NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

TASKIDERR 1 The task number does not exist2 The task number is a system task,

not a user task

INQUIRESTREAMNAME

NOTAUTH 100 The user is not authorized for thiscommand

END 2 All authorized resource definitionshave been retrieved. All data areasspecified on this command are leftunchanged

NOTFND 1 The requested log stream name wasnot found

ILLOGIC 1 A START has been given when abrowse is already in progress, or aNEXT or an END has been givenwithout a preceding START

2 The browse token is not valid

INQUIRESYSDUMPCODE

END 2 There are no more resourcedefinitions of this type

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

ILLOGIC 1 A START command has been issuedwhen a browse is already in progressor a NEXT or an END commandissued when a browse of thisresource type is not in progress

NOTFND 1 The named dump code cannot befound

INQUIRE SYSTEM NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE TASK TASKIDERR 1 The named task cannot be found2 The task is executing a type of

transaction which is not subject tothis command operator

294 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INVREQ 1 SUSPENDVALUE is specified butsignificant characters are lost

3 TCLASS is specified but CLASS isnamed. The user should specify theTRANCLASS option

10 Requested data is held on a dataprofile, but the data is not available

INQUIRE TASK LIST NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE TCLASS TCIDERR 1 The named task class cannot befound

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE TCPIP INVREQ 4 TCPIP=NO has been specified in thesystem initialization table (SIT)

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRETCPIPSERVICE

NOTFND 3 Named TCPIPSERVICE was notfound

ILLOGIC 1 A START command has been issuedwhen a browse is already in progressor a NEXT or an END commandissued when a browse of thisresource type is not in progress

END 2 There are no more resourcedefinitions of this type

INVREQ 4 TCPIP not available (TCPIP=NO)5 TCPIP is closed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE TDQUEUE ENDCOND 2 There are no more resourcedefinitions of this type

ILLOGIC 1 Browse sequence errorNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

QIDERR 1 The named queue cannot be foundNORMAL 0 No errors

INQUIRE TERMINAL END 2 There are no more resourcedefinitions of this type

Chapter 9. RESP2 values and their meanings 295

Command Condition RESP2 MeaningILLOGIC 1 A START has been given when a

browse is already in progress or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

TERMIDERR 1 The named terminal cannot be found

INQUIRE TRACEDEST NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE TRACEFLAG NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE TRACETYPE NOTFND 1 CICS was initialized without supportfor at least one of the componentslisted in the command; trace levelswere returned for all othercomponents

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

INQUIRE TRANCLASS INVREQ 12 The TRANCLASS definition is in useNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access theparticular resource in the wayrequired by this command

TCIDERR 1 The transaction class cannot be found

INQUIRETRANDUMPCODE

END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

NOTFND 1 The dump code cannot be found

INQUIRETRANSACTION

END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwhen a browse if this resource typeis not in progress

TRANSIDERR 1 The transaction could not be found

296 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningINVREQ 3 The TCLASS option has been

specified in this INQUIRE command,and the transaction belongs to a classthat is not one of the numberedclasses DFHTCL00 throughDFHTCL10

NORMAL 10 The profile definition associated withthe transaction is not available

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

INQUIRE TSMODEL END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwhen a browse if this resource typeis not in progress

NOTFND 1 The TSMODEL does not existNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

INQUIRE TSPOOL END 2 There are no more resourcedefinitions of this type

ILLOGIC 1 A START has been given when abrowse is already in progress or aNEXT or an END has been givenwhen a browse if this resource typeis not in progress

NOTFND 1 The TSPOOL does not existNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

INQUIRETSQUEUE/TSQNAME

END 2 There are no more resourcedefinitions of this type

INVREQ 1 The specified SYSID does not exist inany TYPE=SHARED entry in thetemporary storage table

Chapter 9. RESP2 values and their meanings 297

Command Condition RESP2 Meaning2 When INQUIRE TSQUEUE NEXT is

specified, the NEXT queue to bebrowsed has a Queuename of morethan 8 significant characters. Thequeue name is truncated, somesignificant characters are lost.

4 This TSQNAME cannot be deleted asit was written by CICS using PUTQmacro

ILLOGIC 1 A START has been given when abrowse is already in progress, or aNEXT or an END has been givenwhen a browse of this resource typeis not in progress

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

POOLERR 3 The POOLNAME does not existQIDERR 1 The temporary storage queue cannot

be foundSYSIDERR 3 The SYSID does not map to a shared

pool4 An error has occurred in the shared

TS server5 An I/O error has occurred on the

coupling facility

INQUIRE UOW END 2 All authorized resource definitionshave been retrieved. All data areasspecified on this command are leftunchanged

ILLOGIC 1 A browse of this resource type isalready in progress, or an INQUIREUOW START command has not beenissued

UOWNOTFOUND 1 A named UOW cannot be foundNOTAUTH 100 A use of this command is not

authorized

INQUIREUOWDSNFAIL

END 2 There are no more UOW/data setpairs

ILLOGIC 1 A START has been given when abrowse is already in progress, or aNEXT has been given without apreceding START

NOTAUTH 100 A use of this command is notauthorized

INQUIRE UOWENQ END 2 All enqueues have been retrieved

298 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningILLOGIC 1 v For INQUIRE UOQENQ START - a

browse of this resource is alreadyin progress

v For INQUIRE UOWENQ NEXTand INQUIRE UOWENQ END -an INQUIRE UOWENQ STARTcommand has not been issued

UOWNOTFOUND 1 The named UOW cannot be foundNOTAUTH 100 A use of this command is not

authorized

INQUIRE UOWLINK END 2 All authorized resource definitionshave been retrieved

ILLOGIC 1 v For INQUIRE UOQLINK START -a browse of this resource is alreadyin progress

v For INQUIRE UOWLINK NEXTand INQUIRE UOWLINK END -an INQUIRE UOWLINK STARTcommand has not been issued

UOWLNOTFOUND 1 The named UOW-link cannot befound

UOWNOTFOUND 1 The named UOW cannot be foundNOTAUTH 100 A use of this command is not

authorized

INQUIRE VOLUME VOLIDERR 1 The program has issued an INQUIREVOLUME browse command. Thiscommand is withdrawn

INQUIRE VTAM INVREQ 1 VTAM is not present in the systemNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

INQUIRE WEB INVREQ 11 An invalid value was supplied forone of the options

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

ISSUE ABEND INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE ABORT INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

Chapter 9. RESP2 values and their meanings 299

Command Condition RESP2 MeaningISSUE ADD INVREQ 200 A distributed program link server

application specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE CONFIRMATION INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE END INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE ENDFILE INVREQ 200 A distributed program link serverapplication attempted to send on itsfunction-shipping session, itsprincipal facility

ISSUE ENDOUTPUT INVREQ 200 A distributed program link serverapplication attempted to send on itsfunction shipping session, itsprincipal facility

ISSUE EODS INVREQ 200 A distributed program link serverapplication attempted to send on itsfunction shipping session, itsprincipal facility

ISSUE ERASE INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE ERASEAUP INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE ERROR INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session on theCONVID option

ISSUE NOTE INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

300 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningISSUE PREPARE INVREQ 200 A distributed program link server

application specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE PRINT INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE QUERY INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE RECEIVE INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE REPLACE INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE RESET INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE SEND INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE SIGNAL (APPC) INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

ISSUE WAIT INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

LINK INVREQ 8 A LINK command with theINPUTMSG option is issued for aprogram that is not associated with aterminal, or that is associated with anAPPC logical unit, or an IRC session

Chapter 9. RESP2 values and their meanings 301

Command Condition RESP2 Meaning14 The SYNCONRETURN option is

specified but the program issuing thelink request (the client program) isalready in conversation with a mirrortask in the remote region specified onthe SYSID option. (That is, a logicalunit-of-work (LUW) is in progress orMRO=YES has been specified in theclient region). In this case, the clientprogram is in an incorrect state tosupport the SYNCONRETURNoption

15 The program issuing the link requestis already in conversation with amirror task and the TRANSIDspecified is different from thetransaction identifier of the activemirror

16 The TRANSID specified is all blanks17 The TRANSID supplied by the

dynamic routing program is allblanks

19 A LINK command with theINPUTMSG option is issued for aprogram that is the subject of a DPLrequest; that is, SYSID is alsospecified

30 The program manager domain hasnot yet been initialized. This isprobably due to a link request havingbeen made in a first stage PLT

43 A LINK has been attempted to ahot-pooled Java program object whilethere is already a hot-pooledprogram on the link stack

LENGERR 11 The COMMAREA length is less than0 or greater than 32767

12 The length specified on theDATALENGTH option is a negativevalue

13 The length specified on theDATALENGTH option is greater thanthe length specified on the LENGTHoption

26 The COMMAREA address is zero,but the COMMAREA length is nonzero

27 The INPUTMSG length < 0 or >32767

NOTAUTH 101 A resource security check has failedon PROGRAM(name)

PGMIDERR 1 A program has no entry in the PPTand either program autoinstall wasswitched off, or the programautoinstall control program indicatedthat the program should not beautoinstalled

2 A program is disabled

302 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning3 A program cannot be loaded because

v This was the first load of theprogram and the program loadfailed, usually because the loadmodule could not be found

v This was a subsequent load of theprogram, but the first load failed

In order to reset the load status theload module must be in the DFHRPLconcatenation, and a SET PROGRAMNEWCOPY will be required

21 The program autoinstall controlprogram failed either because theprogram autoinstall control programis incorrect, incorrectly defined, or asa result of an abend in the programautoinstall control program. Programautoinstall is disabled and messageDFHPG0202 or DFHPG0203 writtento the CSPL

22 The model returned by the programautoinstall control program is notdefined in the PPT table, or is notenabled

23 The program autoinstall controlprogram returned invalid data

24 Define for the program failed due toautoinstall returning an invalidprogram name or definition

25 The dynamic routing programrejected the link request

ROLLEDBACK 29 The SYNCONRETURN was specifiedand the server program was unablesuccessfully to take a syncpoint. Theserver program has taken a rollback,and all changes made to recoverableresources in the remote region,within the current UOW, are backedout

SYSIDERR 18 The SYSID specified cannot be foundin the intersystem table, or the link tothe specified system is unavailable

20 The remote system specified bySYSID is an LUTYPE6.1-connectedsystem. Distributed program linkrequests are not supported onLUTYPE6.1 connections

28 The remote system specified bySYSID is not in service

29 No sessions available — the dynamicrouting program has chosen not toqueue the link request

31 The request to allocate a session tothe remote system has been rejected

32 The queue of allocate requests forsessions to the remote system hasbeen purged

Chapter 9. RESP2 values and their meanings 303

Command Condition RESP2 MeaningTERMERR 17 An unrecoverable error occurred

during the conversation with themirror (for example, the sessionfailed or the server region failed)

LOAD INVREQ 30 The program manager domain hasnot yet been initialized. This isprobably due to a load requesthaving been made in a first stagePLT

LENGERR 19 LENGTH is used and the length ofthe loaded program is not less than32KB

NOTAUTH 101 A resource security check has failedon PROGRAM(name)

PGMIDERR 1 A program, table, or map has noentry in the PPT and either programautoinstall was switched off, or theprogram autoinstall control programindicated that the program shouldnot be autoinstalled

2 A program is disabled3 A program cannot be loaded because

v This was the first load of theprogram and the program loadfailed, usually because the loadmodule could not be found

v This was a subsequent load of theprogram, but the first load failed

In order to reset the load status theload module must be in the DFHRPLconcatenation, and a SET PROGRAMNEWCOPY will be required

9 The installed program definition isfor a remote program

21 The program autoinstall controlprogram failed either because theprogram autoinstall control programis incorrect, incorrectly defined, or asa result of an abend in the programautoinstall control program. Programautoinstall is disabled and messageDFHPG0202 or DFHPG0203 writtento the CSPL

22 The model returned by the programautoinstall control program was notdefined in the PPT table, or was notenabled

23 The program autoinstall controlprogram returned invalid data

24 Define for the program failed due toautoinstall returning an invalidprogram name or definition

MONITOR INVREQ 1 POINT value is outside the range1–255

304 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning2 POINT value is not defined in the

MCT3 DATA1 value is not valid4 DATA2 value is not valid5 DATA1 value not specified for an

MCT operation that required it6 DATA2 value not specified for an

MCT operation that required itPERFORMDELETSHIPPED

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

PERFORM DUMP SUPPRESSED 1 The dump was not taken because thenumber of dumps with this dumpcode exceeds the maximum for thecode

2 The dump was not taken because thesystem dump table entry for thiscode indicates no system dump

3 The dump was not taken because itwas suppressed by a user exitprogram

8 The dump was not taken becausesystem dumps are suppressedglobally

NOSPACE 4 The dump is incomplete due to lackof dump data-set space

NOSTG 5 CICS cannot complete the dumpbecause of insufficient storage

INVREQ 6 TITLELENGTH is greater than 80bytes

7 CALLERLENGTH is greater than 8bytes

13 The DUMPCODE contains leading orimbedded blanks

IOERR 9 CICS is not authorized by MVS totake dumps

10 An error occurs during systemdumping

12 MVS cannot process the dumpbecause there is no dump data set orbecause it is full

13 An error occurred in the CICSroutine that issues MVS SDUMPrequests

SYSBUSY 11 The MVS dump routine is busy.Retry the command

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

PERFORMENDAFFINITY

INVREQ 25 The connection is still in service

26 There may be recovery informationoutstanding for the connection.RECOVSTATUS has a value otherthan NORECOVDATA

Chapter 9. RESP2 values and their meanings 305

Command Condition RESP2 Meaning32 See message DFHZC0178. VTAM

could not end the affinity for areason other than 35 (NOTFOUND)or 36 (SESSIONS ACTIVE)

34 Enter NETID. NETID was notspecified, and cannot be obtainedfrom the installed connection. Thismay be because the connection doesnot exist, or because it does notcontain a NETID value

35 VTAM could not find an affinity forthe values input

36 VTAM could not end the affinitybecause the connection had somesessions active

37 See message DFHZC0176. A VTAMerror prevented the CHANGEAFFINITY macro being carried out

PERFORM RESETTIME INVREQ 1 There is no clock in the systemNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

PERFORM SECURITYREBUILD

INVREQ 1 No ESM is installed, or the ESM isinactive

5 The ESM is temporarily inactive andcannot perform the action requested

IOERR 3 Error returned from ESM. The returncode is in ESMRESP, if the optionwas used

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

NORMAL 0 Profiles have been refreshed4 No action is required, because RACF

is at Version 2.1 (or later), and soprofiles are refreshed automatically

SYSBUSY 3 A security rebuild is currently inprogress

PERFORM SHUTDOWN INVREQ 1 A normal shutdown has beenrequested when shutdown wasalready in progress

2 The XLT cannot be found3 The PLT cannot be found4 XRF is not in effect5 The transaction specified on

SDTRAN is not enabled forshutdown

6 The transaction specified onSDTRAN is not defined as remote

7 The transaction specified onSDTRAN is not enabled

TRANSIDERR 1 The shutdown transaction specifiedon SDTRAN was not found

306 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

PERFORM STATISTICSRECORD

IOERR n Statistics for at least one of theoptions chosen were not available;usually the reason for this error iscorruption of the memory in whichthey are accumulated. (See below)

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

NOTFND n Statistics for at least one of theoptions chosen were not availablebecause CICS was initialized withoutsupport for the function. (See below)

The values of “n” are as follows:1 AUTOINSTALL2 CONNECTION3 DISPATCHER6 FILE8 JOURNALNUM and

JOURNALNAME10 LSRPOOL11 MONITOR12 PROGRAM13 STATS14 STORAGE15 SYSDUMP16 TABLEMGR18 TCLASS, TRANCLASS19 TDQUEUE20 TERMINAL21 TRANDUMP22 TRANSACTION23 TSQUEUE24 VTAM25 FEPI26 PROGAUTO28 ENQUEUE29 RECOVERY30 STREAMNAME

POST INVREQ 4 Hours are out of range5 Minutes are out of range6 Seconds are out of range

PURGE MESSAGE INVREQ 200 The command was called in adistributed program link serverprogram

QUERY COUNTER INVREQ 201 Named counter not found301 The server has reported an error code

that is not understood by the namedcounter interface

Chapter 9. RESP2 values and their meanings 307

Command Condition RESP2 Meaning303 An unexpected error has occurred on

a macro used to access the couplingfacility

304 The pool selection parameterspecified in the program cannot beresolved to a valid server name usingthe current options table

305 The interface is unable to establish aconnection to the server for theselected named counter pool

306 An abend occurred during serverprocessing of a request

308 The DFHNCOPT options tablemodule could not be loaded

309 The named counter interfaceencountered an unknown entryformat

310 The user exit program is notlink-edited with the options table andcannot be loaded

403 The POOL parameter containsinvalid characters or embeddedspaces

404 The COUNTER parameter containsinvalid characters or embeddedspaces

LENGERR 001 The current value that the server hasattempted to return in one of thedata areas has overflowed into thehigh-order (Sign) bit

002 A value is too large for a fullworddata area by only 1 bit

003 A value is too large for a fullworddata area by a value greater than 1

QUERY SECURITY NOTFND 1 The RESID is not valid2 The RESTYPE is not valid3 The RESID value for RESTYPE

(SPCOMMAND) is not valid5 The RESCLASS is not defined to the

external security manager (ESM)8 The resource is not protected

Possible causes include

v RESCLASS not active

v No profile found

v ESM not activeQIDERR 1 No indirect queue name associated

with the given RESID has been foundLENGERR 6 The RESIDLENGTH value is not

valid, that is, not in the range 1–246INVREQ 7 The CVDA value is not valid for the

LOGMESSAGE9 The RESID is invalid or filled with

blanks10 The external security manager (ESM)

is inactive or not present

308 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning

READ FILENOTFOUND 1 The file name referred to in the FILEoption cannot be found in the FCT

LENGERR 10 Neither the LENGTH nor SEToptions have been specified on aREAD command for a file withvariable-length records or for aBDAM file with variable-length orundefined-format records

11 The length of a record read with theINTO option specified exceeds thevalue specified in the LENGTHoption; the record is truncated, andthe data area supplied in theLENGTH option is set to the actuallength of the record

13 An incorrect length is specified for afile with fixed-length records

INVREQ 20 Read is not allowed according to thefile entry specification in the FCT ora read command with the UPDATEoption has been issued to a filewhere update operations are notallowed according to the file entryspecification in the FCT

25 The KEYLENGTH and GENERICoptions are specified and the lengthspecified in the KEYLENGTH optionis greater than or equal to the lengthof a full key

26 The KEYLENGTH option is specified(but the GENERIC option is notspecified), and the specified lengthdoes not equal the length defined forthe data set to which this file refers

28 Following a READ UPDATEcommand for a file, another READUPDATE command is issued for afile referencing the same data setbefore exclusive control is released bya REWRITE, UNLOCK, or DELETEcommand

40 A BDAM key conversion erroroccurred

42 The KEYLENGTH and GENERICoptions are specified, and the lengthspecified in the KEYLENGTH optionis less than or equal to zero

44 The command does not conform tothe format of READ for auser-maintained table; for example ifGTEQ is specified with UPDATE

51 A READ to a KSDS file that wasbeing accessed in RLS mode specifiedthe RBA keyword. RLS mode doesnot support relative byte addressaccess to KSDS data sets

Chapter 9. RESP2 values and their meanings 309

Command Condition RESP2 Meaning52 A READ request to a non-RLS file

specified CONSISTENT53 A READ request to a non-RLS file

specified REPEATABLE55 A READ request to a non-RLS file

specified NOSUSPEND, which is notallowed because the file is not aVSAM file accessed in RLS mode

56 Attempt to update a recoverablecoupling facility has failed becausethe current unit of work has alreadyupdated 1024 recoverable couplingfacility data tables

DISABLED 50 A file was initially defined asdisabled and has not since beenenabled or it has been disabled by anEXEC CICS SET FILE or the CEMTSET FILE command

NOTOPEN 60 The requested file is CLOSED andUNENABLED or the requested file isOPEN and in use by othertransactions, but a CLOSE requestagainst it has been received or aREAD command has been issuedagainst a data set that is quiesced, oris being quiesced, as a result of a SETDSNAME QUIESCED orIMMQUIESCED command

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTFND 80 An attempt to retrieve a record basedon the search argument provided isunsuccessful or, for user-maintaineddata tables, an attempt to read arecord is unsuccessful because thereis no entry with the specified key inthe data table

NOTAUTH 101 A resource security check has failedon FILE(filename)

LOADING 104 A READ UPDATE has been issuedfor a user-maintained data table thatis currently being loaded or a READGENERIC has been issued for auser-maintained data table that iscurrently being loaded

LOCKED 106 An attempt has been made to read arecord either specifying the UPDATEkeyword, or specifying (explicitly orimplicitly) CONSISTENT orREPEATABLE, but the record waslocked by a retained lock or a READUPDATE request to a recoverableCFDT uses the locking model andthe record being read is locked by aretained lock

310 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningRECORDBUSY 107 The NOSUSPEND keyword was

specified and the record was lockedby an active lock

ILLOGIC 110 A VSAM error has occurred whichdoes not fall within one of the otherCICS response categories

IOERR 120 There has been an I/O error duringthe READ operation

SYSIDERR 130 The SYSID option specified a namethat is neither the local nor theremote system (made known to CICSby defining a CONNECTION); or thelink to the remote system is closed.

131 The connection to the couplingfacility data table has failed

132 The READ is issued for a couplingfacility data table that no longerexists

DUPKEY 140 A record has been retrieved by wayof an alternate index with theNONUNIQUEKEY attribute, andanother alternate index record withthe same key follows.

READNEXT FILENOTFOUND 1 The file name referred to in the FILEoption cannot be found in the FCT

LENGERR 10 Neither the LENGTH nor SEToptions have been specified for a filewith variable-length records or for aBDAM file with undefined-formatrecords

11 The length of a record read with theINTO option specified exceeds thevalue specified in the LENGTHoption; the record is truncated, andthe data areas supplied in theLENGTH option is set to the actuallength of the record

13 An incorrect length is specified for afile with fixed-length records

INVREQ 20 The FILE definition does not allowupdates

25 The KEYLENGTH option is specifiedfor a generic browse (that is onewhere GENERIC was specified onthe STARTBR or the last RESETBR)and the value of KEYLENGTH wasgreater than the full key length

26 The KEYLENGTH option is specifiedfor a nongeneric browse, and thespecified length does not equal thelength defined for the data set towhich this file refers

34 The REQID, if any, does not matchthat of any successful STARTBRcommand

Chapter 9. RESP2 values and their meanings 311

Command Condition RESP2 Meaning37 The type of record identification used

to access a data set during thebrowse is changed by theREADNEXT command

42 The KEYLENGTH option is specifiedfor a generic browse (that is onewhere GENERIC was specified onthe STARTBR or the last RESETBR)and the value of KEYLENGTH is lessthan zero

52 CONSISTENT is not allowed becausethe file is not a VSAM file that isaccessed in RLS mode

53 REPEATABLE is not allowed becausethe file is not a VSAM file that isaccessed in RLS mode

54 UPDATE is not allowed because thefile is not a VSAM file that isaccessed in RLS mode

55 NOSUSPEND is not allowed becausethe file is not a VSAM file that isaccessed in RLS mode

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTFND 80 An attempt to retrieve a record basedon the search argument provided isunsuccessful

ENDFILE 90 An end-of-file condition has beendetected during a browse

NOTAUTH 101 A resource security check has failedon FILE(filename)

LOCKED 106 The read request specified theUPDATE keyword, or one of the readintegrity keywords CONSISTENT orREPEATABLE, or the file resourcedefinition specified read integrity, butVSAM held a retained lock againstthe record, or the request to arecoverable CFDT uses the lockingmodel and the record being read islocked by a retained lock

LOADING 104 The read request specifies a recordkey for a record in a coupling facilitydata table that is still being loaded,and the key is out of range of therecords already loaded

RECORDBUSY 107 NOSUSPEND was specified on therequest but VSAM held an activelock against the record, which wouldcause the request to wait

ILLOGIC 110 A VSAM error has occurred whichdoes not fall within one of the otherCICS response categories

IOERR 120 There has been an I/O error duringthe READNEXT command

312 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningSYSIDERR 130 The SYSID option specifies a name

that is neither the local nor theremote system (made known to CICSby defining a CONNECTION); or thelink to the remote system is closed.

131 The connection to the couplingfacility data table has failed

132 The READNEXT is issued for acoupling facility data table that nolonger exists

DUPKEY 140 A record has been retrieved by wayof an alternate index with theNONUNIQUEKEY attribute, andanother alternate index record withthe same key follows

READPREV FILENOTFOUND 1 The file name referred to in the FILEoption cannot be found in the FCT

LENGERR 10 Neither the LENGTH nor SEToptions have been specified for a filewith variable-length records

11 The length of a record read with theINTO option specified exceeds thevalue specified in the LENGTHoption; the record is truncated, andthe data area supplied in theLENGTH option is set to the actuallength of the record

13 An incorrect length is specified for afile with fixed-length records

INVREQ 20 The FILE definition does not allowupdates

24 A READPREV command is issued fora file for which the previousSTARTBR or RESETBR command hasthe GENERIC option

26 The KEYLENGTH option is specifiedand the specified length does notequal the length defined for the dataset this file refers to

37 The type of record identification usedto access a data set during thebrowse is changed

39 A READPREV is issued for a BDAMfile

41 The REQID, if any, does not matchthat of any successful STARTBRcommand

52 CONSISTENT is not allowed becausethe file is not a VSAM file that isaccessed in RLS-mode

53 REPEATABLE is not allowed becausethe file is not a VSAM file that isaccessed in RLS-mode

54 UPDATE is not allowed because thefile is not a VSAM file that isaccessed in RLS-mode

Chapter 9. RESP2 values and their meanings 313

Command Condition RESP2 Meaning55 NOSUSPEND is not allowed because

the file is not a VSAM file that isaccessed in RLS-mode

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTFND 80 An attempt to retrieve a record basedon the search argument provided isunsuccessful

ENDFILE 90 An end-of-file condition has beendetected during a browse

NOTAUTH 101 A resource security check has failedon FILE(filename)

LOCKED 106 The read request specified theUPDATE keyword, or one of the readintegrity keywords CONSISTENT orREPEATABLE, or the file resourcedefinition specified read integrity, butVSAM held a retained lock againstthe record

RECORDBUSY 107 NOSUSPEND was specified on therequest but VSAM held an activelock against the record, which wouldcause the request to wait

ILLOGIC 110 A VSAM error has occurred whichdoes not fall within one of the otherCICS response categories

IOERR 120 There has been an I/O error duringthe browse

SYSIDERR 130 The SYSID option specified a namethat has not been defined to CICS asa remote system (defined by defininga CONNECTION); or the link to theremote system is closed.

131 The connection to the couplingfacility data table server has failed

132 The READPREV is issued against acoupling facilty data table that nolonger exists

DUPKEY 140 A record has been retrieved by wayof an alternate index with theNONUNIQUEKEY attribute, andanother alternate index record withthe same key exists

RECEIVE INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

RELEASE PGMIDERR 1 A program, table, or map has noentry in the PPT

2 A program, table, or map is disabled9 The installed program definition is

for a remote programINVREQ 5 An invalid attempt has been made by

a program to release itself

314 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning6 A RELEASE command has been

issued for a program that is notloaded

7 A RELEASE command has beenissued for a program that is loaded,without the HOLD option, byanother task or the program has beenenabled as a global user exit

17 A program has been defined withRELOAD=YES. It must be releasedby a FREEMAIN rather than aRELEASE command

30 The program manager domain hasnot yet been initialized

RESETBR FILENOTFOUND 1 The file name referred to in the FILEoption cannot be found in the FCT

INVREQ 25 The KEYLENGTH and GENERICoptions are specified and the lengthspecified in the KEYLENGTH optionis greater than or equal to the lengthof a full key

26 The KEYLENGTH option is specified(but the GENERIC option is notspecified), and the specified lengthdoes not equal the length defined forthe data set to which this file refers

36 The REQID, if any, does not matchthat of any successful STARTBRcommand

42 The KEYLENGTH and GENERICoptions are specified, and the lengthspecified in the KEYLENGTH optionis less than zero

44 The command does not conform tothe format of RESETBR for auser-maintained or coupling facilitydata table

51 A RESETBR command to a KSDS filethat was being accessed in RLS modespecified the RBA keyword. RLSmode does not support RBA access toKSDS data sets

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTFND 80 An attempt to retrieve a record basedon the search argument provided hasbeen unsuccessful

NOTAUTH 101 A resource security check has failedon FILE(filename)

ILLOGIC 110 A VSAM error has occurred whichdoes not fall within one of the otherCICS response categories

IOERR 120 There has been an I/O error duringthe file control operation

Chapter 9. RESP2 values and their meanings 315

Command Condition RESP2 MeaningSYSIDERR 130 The SYSID option specified a name

that is neither the local nor theremote system (made known to CICSby defining a CONNECTION); or thelink to the remote system is closed.

131 The connection to the couplingfacility data table server has failed

132 The RESETBR is issued against acoupling facility data table that nolonger exists

RESYNC ENTRYNAME NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

RETURN INVREQ 1 A RETURN command with theTRANSID option has been issued bya program that is not associated witha terminal

2 A RETURN command with theCOMMAREA or IMMEDIATE optionhas been issued in a program that isnot at the highest logical level

4 A RETURN command with theTRANSID option has been issued ina program that is associated with anAPPC logical unit

8 A RETURN command with theINPUTMSG option has been issuedfor a program that is not associatedwith a terminal, or that is associatedwith an APPC logical unit, or an IRCsession

30 PG domain is not initialized.Parameters are not allowed on theEXEC RETURN statement in firststage PLT programs

200 A RETURN command has beenissued with an INPUTMSG option ina program invoked by DPL

LENGERR 11 The COMMAREA length is less than0 or greater than 32763

26 The COMMAREA ADDRESS passedwas zero, but the commarea lengthwas non-zero

27 The INPUTMSG LENGTH was lessthan 0 or greater than 32767

REWIND COUNTER INVREQ 201 Named counter not found301 The server has reported an error code

that is not understood by the namedcounter interface

303 An unexpected error has occurred ona macro used to access the couplingfacility

316 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning304 The pool selection parameter

specified in the program cannotresolve to a valid server name usingthe current options table

305 The interface is unable to establish aconnection the the server for theselected named counter pool

306 An abend occurred during serverprocessing of a request

308 The DFHNCOPT options tablemodule could not be loaded

309 The named counter interfaceencountered an unknown entryformat

310 The user-exit program is notlink-edited with the options table andcannot be loaded

403 The POOL parameter containsinvalid characters or embeddedspaces

404 The COUNTER parameter containsinvalid characters or embeddedspaces

406 The INCREMENT value is invalidSUPPRESSED 102 The named counter has not yet

reached its limit

REWRITE FILENOTFOUND 1 The file name referred to in the FILEoption cannot be found in the FCT

LENGERR 10 The length option has not beenspecified for a file withvariable-length records, or for aBDAM file with undefined formatrecords

12 The length specified exceeds themaximum record size

14 An incorrect length is specified for afile with fixed-length records

INVREQ 30 A REWRITE command has beenissued without a token and noprevious READ for UPDATE (alsowithout a token) can be found

46 A REWRITE command has attemptedto change the length of a BDAMvariable length record or block

47 A REWRITE instruction included atoken whose value cannot bematched against any token in use foran existing READ for UPDATErequest

55 NOSUSPEND is not allowed becausethe file is not a VSAM file accessedin RLS mode

56 An attempt to update a recoverablecoupling facility data table has failedbecause the current unit of work hasalready updated 1024 recoverablecoupling facility data tables

Chapter 9. RESP2 values and their meanings 317

Command Condition RESP2 MeaningISCINVREQ 70 The remote system indicated a failure

that does not correspond to a knowncondition

NOSPACE 100 No space is available on the directaccess device for adding the updatedrecord to the data set

102 The maximum number of recordsspecified for a recoverable couplingfacility data table has been exceeded

103 For user-maintained data tables,CICS is unable to get sufficientstorage in the CICS address space tostore the updated data table entry

108 Insufficient space in the couplingfacility data table pool to store theupdated record

NOTAUTH 101 A resource security check has failedon FILE(filename)

LOCKED 106 When updating a record via a basekey or an alternate key, an attemptwas made to modify an alternate keycontained within the record (not thekey by which the update was made)and the new value of the alternatekey is the subject of a retained lockheld by another transaction

RECORDBUSY 107 The NOSUSPEND keyword wasspecified and the record was foundto be locked by an active lock inVSAM

ILLOGIC 110 A VSAM error has occurred whichdoes not fall within one of the otherCICS response categories

IOERR 120 There has been an I/O error duringthe file control operation

SYSIDERR 130 The SYSID option specified a namethat is neither the local nor a remotesystem (made known to CICS bydefining a CONNECTION); or thelink to the remote system is closed.

131 The connection to the couplingfacility data table server has failed

132 The REWRITE is issued against acoupling facility data table that nolonger exists

CHANGED 109 A REWRITE command is issued for afile that is defined as a couplingfacility data table using thecontention update model and therecord has been changed since theapplication program read it forupdate

DUPREC 150 An attempt has been made to rewritea record to a data set whose upgradeset has an alternate index with theUNIQUEKEY attribute, if thecorresponding alternate key alreadyexists in the alternate index

318 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning

ROUTE INVREQ 4 Hours are out of range5 Minutes are out of range6 Seconds are out of range200 BMS commands are not supported

for distributed program link

SEND INVREQ 200 A distributed program link serverapplication has attempted to send onits function-shipping session (itsprincipal facility) or, for SEND(APPC), a distributed program linkserver application has specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

SEND CONTROL INVREQ 200 A distributed program link serverapplication has attempted to send onits function-shipping session (itsprincipal facility)

SEND MAP INVREQ 200 Command is not allowed for adistributed program link serverprogram

SEND PAGE INVREQ 200 Command is not allowed for adistributed program link serverprogram

SEND PARTNSET INVREQ 200 Command is not allowed for adistributed program link serverprogram

SEND TEXT INVREQ 200 Command is not allowed for adistributed program link serverprogram

SEND TEXT MAPPED INVREQ 200 A distributed program link serverapplication has specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

SEND TEXT NOEDIT INVREQ 200 Command is not allowed for adistributed program link serverprogram

SET AUTOINSTALL INVREQ 1 VTAM is not in use in this system2 The MAXREQS value is not in the

range 0–9994 One of the modules invoked by

DFHZATDX (DFHZATA andDFHZATD) cannot be found

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

Chapter 9. RESP2 values and their meanings 319

Command Condition RESP2 MeaningPGMIDERR 3 The program name cannot be found

SET CONNECTION INVREQ 1 ACQSTATUS|CONNSTATUS wasspecified for a non-APPC connection

2 1. ACQUIRED specified withOUTSERVICE

2. ACQUIRED specified forOUTSERVICE connection

3. OUTSERVICE specified forACQUIRED connection

3 ACQSTATUS|CONNSTATUS has aninvalid CVDA value

4 SERVSTATUS has an invalid CVDAvalue

5 PENDSTATUS or NOTPENDINGwas specified for a connection that isnot APPC or IRC

6 PURGE was specified for connectionthat is not VTAM

7 PURGETYPE has an invalid CVDAvalue

8 PENDSTATUS has an invalid CVDAvalue

11 SET command named a remoteconnection

12 EXITTRACING has an invalid CVDA13 ZCPTRACING has an invalid CVDA14 EXITTRACING|ZCPTRACING

specified for a non-VTAM connectionor VTAM not initialized

16 The resource whose name wasspecified by CONNECTION(data-value) is an indirect link

17 ACQSTATUS|CONNSTATUS cannotbe set when system initialized withISC=NO

18 NOTPENDING cannot be set for aconnection which has successfullycompleted Exchange Lognamesprocessing

19 CONNSTATUS cannot be set toACQUIRED when in the FREEINGstate

20 COMMIT, BACKOUT, or FORCE isnot valid for this type of connection

21 BACKOUT or FORCE was specified,but was unsuccessful. Some UOWsremain shunted for this connection

22 Other SET parameters were includedwith the CANCEL orFORCECANCEL option

23 The resource whose name wasspecified by CONNECTION(name) isthe local TCT system entry (TCTSE)

25 Connection is still in service

320 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning26 RECOVSTATUS does not have a

value of NORECOVDATA.ENDAFFINITY is invalid

30 Wrong connection type forENDAFFINITY. Affinities can existonly on LU6.1 and LU6.2 connections

31 User PERFORM ENDAFFINITY. TheNETID could not be obtained fromthe installed connection. Therefore, toend affinity you must use thePERFORM ENDAFFINITY command

32 See message DFHZC0178. VTAMcould not end the affinity for areason other than 35 (NOTFOUND)or 36 (SESSIONS ACTIVE)

35 VTAM could not find an affinity forthis connection

36 VTAM could not end the affinitybecause the connection had somesessions active

37 See message DFHZC0176. A VTAMerror prevented the CHANGEENDAFFIN macro being carried out

44 GRSTATUS is not set toREGISTERED or DEREGISTERED

45 NORECOVDATA cannot be set for aconnection that is in service

46 NORECOVDATA was specified for anon-APPC connection

SYSIDERR 9 The named connection could not befound

IOERR 10 Unexpected errorNORMAL 58 AIDs are successfully canceledNORMAL 59 No AIDs are canceledNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET DB2CONN INVREQ 1 Invalid ACCOUNTREC value2 Invalid AUTHTYPE value3 Invalid BUSY value4 Invalid COMAUTHTYPE value5 Invalid CONNECTERROR value6 Invalid CONNECTST value7 Invalid NONTERMREL value9 Invalid PRIORITY value10 Invalid SECURITY value11 Invalid STANDBYMODE value12 Invalid THREADWAIT value13 Bad characters in AUTHID14 Bad characters in COMAUTHID15 Bad characters in DB2ID16 Bad characters in MSGQUEUE117 Bad characters in MSGQUEUE218 Bad characters in MSGQUEUE319 Bad characters in PLAN20 Bad characters in PLANEXITNAME

Chapter 9. RESP2 values and their meanings 321

Command Condition RESP2 Meaning21 Bad characters in SIGNID22 Bad characters in STATSQUEUE23 Both AUTHID and AUTHTYPE

specified24 Both COMAUTHID and

COMAUTHTYPE specified25 STANDBYMODE(NOCONNECT)

and CONNECTERROR(SQLCODE)specified orCONNECTERROR(SQLCODE)specified when STANDBYMODE isNOCONNECT

26 Both PLAN and PLANEXITNAMEspecified

27 Invalid ACCOUNTREC value28 COMTHREADLIM exceeds

TCBLIMIT or COMTHREADLIM >2000 or COMTHREADLIM < 0

29 PURGE CYCLE is too low; that is, <30 seconds

1. or PURGE CYCLE minutes < 0

2. or PURGE CYCLE seconds < 0

3. or PURGE CYCLE minutes > 59

4. or PURGE CYCLE seconds > 5932 TCBLIMIT > 2000 or TCBLIMIT < 433 THREADLIMIT exceeds TCBLIMIT

or THREADLIMIT > 2000 orTHREADLIMIT < 3

34 Already connected35 RCT suffix not allowed36 RCT suffix not found37 Wrong level RCT39 DB2 not active40 Insufficient authorization41 Connection error42 Invalid INIT parms43 DB2ID cannot be set, CONN active44 DB2CONN partially discarded45 RCT suffix invalid46 SET NOTCONNECTED when the

FORCE or WAIT option has beenspecified, but this transaction is itselfusing the CICS DB2 interface

NORMAL 38 Waiting for DB2 (may occurfollowing a CONNECTST with aCVDA of CONNECT)

NOTFND 1 There is no DB2TRAN currentlyinstalled with the specified name

NOTAUTH 100 Command authorization failure101 Surrogate authorization failure102 AUTHTYPE authorization failure

SET DB2ENTRY INVREQ 2 Invalid ACTION value3 Invalid AUTHTYPE value4 Invalid BUSY value5 Invalid ENABLESTATUS value

322 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning7 Invalid PRIORITY value8 Invalid THREADWAIT value9 Bad characters in AUTHID10 Bad characters in PLAN11 Bad characters in PLANEXITNAME12 Both AUTHID and AUTHTYPE

specified13 Both PLAN and PLANEXITNAME

specified14 Entry is disabling15 PROTECTNUM greater than

THREADLIMIT or PROTECTNUM <0 or PROITECTNUM > 2000

16 THREADWAIT must be TPOOL withTHREADLIMIT=0

17 THREADLIMIT > 2000 orTHREADLIMIT < 0 orTHREADLIMIT > TCBLIMIT

18 Invalid ACCOUNTREC value19 SET DISABLED when the FORCE ir

WAIT option has been specified, butthis transaction itself is using theDB2ENTRY

NOTAUTH 100 Command authorization failure101 Resource authorization failure102 Surrogate authorization failure103 AUTHTYPE authorization failure

NOTFND 1 There is no DB2ENTRY currentlyinstalled with the specified name

SET DB2TRAN INVREQ 2 Bad characters in TRANSID name3 TRANSID already exisits in another

installed DB2TRAN4 Bad characters in DB2ENTRY name

NOTAUTH 100 Command authorization failure101 Resource authorization failure102 Surrogate authorization failure103 AUTHTYPE authorization failure

NOTFND 1 There is no DB2TRAN currentlyinstalled with the specified name

SET DELETSHIPPED INVREQ 1 INTERVAL value is invalid2 INTERVALHRS value is not in the

range 0-993 INTERVALMINS value is invalid4 INTERVALSECS value is invalid5 IDLE value is invalid6 IDLEHRS value is not in the range

0-997 IDLEMINS value is invalid8 IDLESECS value is invalid

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET DSNAME DSNNOTFOUND 1 The named data set cannot be found15 RECOVERED was specified, but the

data set was not foundINVREQ 3 ACTION has an invalid CVDA value

Chapter 9. RESP2 values and their meanings 323

Command Condition RESP2 Meaning10 REMOVE was specified, but the data

set is associated with a file definition12 REMOVE was specified with another

option. If you specify remove, it mustbe the only option present on thecommand

13 REMOVE was specified but a lockwas held on the data set by anotherINQUIRE or SET DSNAMEcommand, or by CICS file controlprocessing.

14 RECOVERED was specified but CICSis not configured to support “backupwhile open” (BWO). Check that youhave a version of MVS/DFP,DFHSM, and DFDSS that supportBWO

16 RECOVERED was specified but thedata set has not been opened duringthis CICS session, so the BWOattributes in the ICF catalog cannotbe set

17 RECOVERED was specified for aBDAM data set, or a VSAM path.This is not supported

18 RECOVERED was specified for aVSAM base data set that had FCTsopen. This is not allowed.

19 RECOVERED was specified for anunknown data set, or the data setwas not in the ‘forward recovered’state

29 QUIESCESTATE is specified, but theoperation is not supported becauseDFSMS 1.3, or later, is not installed

30 QUIESCESTATE has an invalidCVDA value

31 BUSY has an invalid CVDA value33 AVAILABILITY has an invalid CVDA

value data34 A QUIESCESTATE value of

QUIESCED or IMMQUIESCED isspecified, but is rejected eitherbecause q quiesce or unquiesce isalready taking place, or becauseDFSMSdss is currently taking abackup copy of the data set

36 A QUIESCESTATE value ofUNQUIESCED is specified, but isrejected by RLS either because anunquiesce is already taking place, orbecause DFSMSdss is currentlytaking a backup copy of the data set

39 AVAILABILITY, QUIESCESTATE,RESETLOCKS or RETRY is specifiedfor a data set that is a BDAM dataset

324 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning40 The CICS control block (DSNB)

describing the data set has beendeleted (by the REMOVE option) byanother task before CICS couldprocess the SET command

41 QUIESCESTATE is specified for adata set that is not known to DFSMSas a VSAM data set

42 An invalid CVDA is specified forUOWACTION

43 A QUIESCESTATE value ofQUIESCED or IMMQUIESCED isspecified without NOWAIT, and theissuing task has updated the data set,or is browsing the data set, in thesame unit of work. This is notallowed because:

v For QUIESCED this would resultin a deadlock

v For IMMQUIESCED this wouldresult in the issuing task beingpurged

44 A SET DSNAME REMOVE commandhas been issued by another task. Thishas been detected after this SETDSNAME command was issued, butbefore the AVAILABILITY option isprocessed

46 FAILEDBKOUT, which is obsolete, isspecified

47 No file has been opened against thedata set since the last cold start ofthis CICS region, or since the filedefinition was installed for the dataset

IOERR 20 RECOVERED was specified but anerror was raised on accessing the ICFcatalog. Ensure that the specifieddata set is on an SMS managedDASD and is known to the SMSsubsystem

21 RECOVERED was specified but anerror was raised by the CICS tablemanager program

35 QUIESCESTATE is specified but theSMSVSAM server is not available

40 QUIESCESTATE is specified, and anunexpected error occurred in DFSMS

48 The specified operation cannot becompleted because the data set ismigrated. Recall the data set andre-issue the command

49 An error was raised by DFSMS whenreading the ICF Catalog to establishthe base data set name

Chapter 9. RESP2 values and their meanings 325

Command Condition RESP2 MeaningSUPPRESSED 37 A QUIESCESTATE value of

QUIESCED or IMMQUIESCED isspecified, but the quiesce of the dataset is cancelled by anotherparticipating CICS region. This couldbe for one of the following reasons:

v A user issued a SET DSNAMEUNQUIESCED command

v AN XCFVSDS global user exitprogram suppressed the quiesce

v AN XCFSREQ global user exitprogram suppressed the close of afile that is open against the dataset

38 A QUIESCESTATE value ofQUIESCED or IMMQUIESCED isspecified, but the quiesce of the dataset is cancelled by this CICS regionbecause the quiesce operation timedout. This is probably due to along-running transaction on anotherparticipating CICS region preventingthe close of a file that is open againstthe data set

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET DUMPDS INVREQ 1 INITIALDDS has an invalid value2 SWITCHSTATUS has an invalid

CVDA value3 OPENSTATUS has an invalid CVDA

valueIOERR 4 OPEN or SWITCH caused an error

opening a data setNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET ENQMODEL INVREQ 2 The attempt to enable/disble anENQMODEL failed, because a moregeneric ENQMODEL is enabled

3 STATE has an invalid CVDA valueIOERR 4 The ENQMODEL is in the WAITING

stateNOTFND 1 The specified ENQMODEL is not

installed on this systemNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET FILE INVREQ 1 The named file is REMOTE2 The named file is not CLOSED3 The named file is not DISABLED4 ADD has an invalid CVDA value5 BROWSE has an invalid CVDA value6 BUSY has an invalid CVDA value7 DELETE has an invalid CVDA value

326 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning8 DISPOSITION has an invalid CVDA

value9 EMPTYSTATUS has an invalid

CVDA value10 LSRPOOLID was specified for a

non-VSAM data set11 LSRPOOLID is not in the range 1–8,

or the corresponding buffer is notdefined

12 READ has an invalid CVDA value13 STRINGS value is not in the range

1–255, or this is not a VSAM file14 UPDATE has an invalid CVDA value16 OPENSTATUS has an invalid CVDA

value17 ENABLESTATUS has an invalid

CVDA value19 DELETE has been specified for a

non-VSAM file20 EMPTYSTATUS has been specified

for a non-VSAM file21 CLOSED or DISABLED has been

specified, but this transaction has anincomplete request against the file

22 ENABLED was specified for a filethat is currently DISABLING orUNENABLING

23 EXCLUSIVE has an invalid CVDAvalue

24 EXCLUSIVE has been specified for anon-BDAM file.

28 OPEN, CLOSE, ENABLE orDISABLE has been specified but anexit program running at exit pointXFCSREQ instructed CICS not tocarry out the command

29 TABLE has an invalid CVDA value30 MAXNUMREQS value is out of

range31 The TABLE option is invalid for a

BDAM file (must be VSAM for a datatable.)

32 The TABLE option is not valid for afile defined with the REUSE option

33 The TABLE option is invalid for a filedefined as UNBLOCKED

34 The MAXNUMRECS option isinvalid for a BDAM file (must beVSAM for a data table.)

35 The MAXNUMRECS option isinvalid for a file defined with theREUSE option

36 The MAXNUMRECS option isinvalid for a file defined asUNBLOCKED

37 The TABLE option is invalid whenLSRPOOL=0 is specified

Chapter 9. RESP2 values and their meanings 327

Command Condition RESP2 Meaning39 The USERTABLE option is invalid

when record format is not variable40 CONSISTENT or REPEATABLE is

specified for a file that is notaccessed in RLS mode

41 The DSNB cannot be disconnectedfor this file because the file hasdeferred work outstanding, for whichthere are retained locks. This meansthere is at least one shunted UOW,awaiting completion, that has madechanges to this file

42 The SET FILE request cannot besatisfied because the file has deferredwork outstanding, for which thereare retained locks. This means thereis at least one shunted UOW,awaiting completion, that has madechanges to this file. The only validoptions when a file has deferredwork pending are those that changethe file state. File state changes arepermitted because they may berequired to enable the deferred workto be completed

43 The file cannot be discarded becauseit has deferred work outstanding, forwhich there are retained locks. Thismeans there is at least one shuntedUOW, awaiting completion, that hasmade changes to this file

44 A file open request cannot besatisfied because the file references adata set that has been marked asunavailable by a SET DSNAMEUNAVAILABLE command

45 A file open request cannot besatisfied because the file referencesan RLS-mode data set that has beenquiesced by a SET DSNAMEQUIESCED command

46 A file open request cannot besatisfied because the file referencesan RLS-mode data set that is beingcopied by a DFSMSdss-initiatednon-BWO backup

47 A file open request cannot besatisfied because the file referencesan RLS-mode data set that is in theprocess of quiescing by a SETDSNAME QUIESCED command

48 A file open request cannot besatisfied because the file references adata set for which its ICF Catalogentry indicates that a recovery ispending, or is in progress (forexample, a CICSVR job is running)

328 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning49 An invalid CVDA is specified for the

READINTEG option50 An attempt has been made to open

an RLS file when RLS is notsupported

51 An invalid CVDA is specified for theRLSACCESS option

52 An attempt has been made to specifyRLS access for a BDAM data set

53 An attempt has been made to specifya CICS-maintained data table for afile defined with RLS access

54 A file open request cannot besatisfied because of one of thefollowing reasons:

v the file is being opened in RLSmode and this region has otherfiles open in non-RLS modeagainst the data set which itreferences

v the file is being opened in non-RLSmode and this region has otherfiles open in RLS mode against thedata set which it references

v the file is being opened in non-RLSmode and this region hasunresolved RLS recovery workagainst the data set which itreferences

55 LOADTYPE has an invalid CVDAvalue

56 UPDATEMODEL has an invalidCVDA value

57 EMPTYSTATUS has a CVDA valuethat is not allowed for a couplingfacility data table. EMPTYSTATUSmust be NOEMPTYREQ for acoupling facility data table.

58 CFDTPOOL is not specified for a filethat refers to a coupling facility datatable.

59 KEYLENGTH is not specified for afile that refers to a coupling facilitydata table, and which specifiesLOAD=NO

60 An invalid KEYLENGTH is specified61 RECORDSIZE is not specified for a

file that refers to a coupling facilitydata table that specifies LOAD=NO

62 An invalid RECORDSIZE is specified

Chapter 9. RESP2 values and their meanings 329

Command Condition RESP2 Meaning63 Open is specified for a file that refers

to a coupling facility data table, butOPEN processing has failed because:

v The file attributes do not matchthose specified when the CFDTwas created, or

v A KEYLENGTH or RECORDSIZEhas been specified that exceeds themaximum supported

64 OPEN is specified for a file thatrefers to a coupling facility datatable, but OPEN processing has failedbecause the server is not available

65 An invalid CDFTPOOL name isspecified

66 An invalid TABLE name is specified67 An UPDATEMODEL of

CONTENTION is specified for arecoverable coupling facility datatable. The update model must beLOCKING for a coupling facility datatable that is recoverable

FILENOTFOUND 18 The named file cannot be foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

IOERR * OPEN has failed in VSAM, and theRESP2 field contains a VSAMresponse code

* CLOSE has failed in VSAM, and theRESP2 field contains a VSAMresponse code

SET IRC INVREQ 1 A program required for IRC,DFHCRSP, is unavailable

2 OPENSTATUS has an invalid CVDAvalue

4 CICS was initialized without IRCsupport (ISC=NO)

5 No connection has been defined6 The VTAM APPLID for this CICS is

blanks; IRC requires a non-blankAPPLID

7 Another CICS using IRC has thesame VTAM APPLID as this one;unique names are required

8 IRC rejected the open of this CICSbecause it had already reached themaximum number of logons

18 IRC support (the DFHIRP module) isbelow the level required by this CICSsystem

330 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOSTG 9 CICS storage is insufficient for the

request10 MVS storage is insufficient (SVC

block request rejected)11 MVS storage is insufficient (SUBSYS

block request rejected)IOERR 12 IRC initialization failed

13 The log on to IRC failed14 An attempt to attach the node error

transaction, CSNC, failed15 An error occurred closing IRC

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET JOURNALNAME JIDERR 1 The specified journal name was notfound

2 An error occurred during an attemptto define the log stream associatedwith the journal name, or the journalname was incorrectly specified

3 The specified journal name refers to aDASD-only log stream to which aCICS region in another MVS image iscurrently connected.

INVREQ 2 The request is invalid3 The system log cannot be changed4 The ACTION option has an invalid

CVDA value5 The STATUS option has an invalid

CVDA valuen The ACTION option specifies FLUSH

or REST for a journal that is notcurrently connected to a log stream

IOERR 6 Either the log stream associated withthe journal name cannot be opened,or the journal cannot be opened, oran unrecoverable error has occurredduring the flushing of the log bufferto the log stream

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

SET JOURNALNUM JIDERR 1 There are no valid options supportedby this command, which is obsolete.Use the SET JOURNALNAMEcommand

SET MODENAME SYSIDERR 1 The connection cannot be found2 The MODENAME within the

connection cannot be foundINVREQ 3 MODENAME ‘SNASVCMG’ was

specified

Chapter 9. RESP2 values and their meanings 331

Command Condition RESP2 Meaning4 The AVAILABLE value is out of

range5 AVAILABLE was specified but CICS

is not in session on this connection6 CLOSED was specified with

AVAILABLE7 ACQSTATUS has an invalid CVDA

value8 This is not a parallel-session APPC

group9 ACQUIRED was specified but CICS

is not in session on this connectionNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET MONITOR INVREQ 1 STATUS has an invalid CVDA value2 PERFCLASS has an invalid CVDA

value3 EXCEPTCLASS has an invalid CVDA

value4 EVENTCLASS has an invalid CVDA

value5 CONVERSEST has an invalid CVDA

value6 SYNCPOINTST has an invalid CVDA

value7 The FREQUENCY value is invalid

v Hours exceed 24, minutes orseconds exceed 59, or total value isout of range

8 The FREQUENCYHRS value is out ofrange

9 The FREQUENCYMIN value is outof range

10 The FREQUENCYSEC value is out ofrange

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET NETNAME INVREQ 27 EXITTRACING has an invalid CVDAvalue

29 The terminal is not a VTAM terminalNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET PROGRAM INVREQ 1 DISABLED or DPLSUBSET wasspecified for a program beginning‘DFH’

2 STATUS has an invalid CVDA value3 NEWCOPY was specified and

RESCOUNT is not equal to zero4 SHARESTATUS has an invalid

CVDA value5 COPY has an invalid CVDA value

332 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning6 COPY was specified for a module

currently loaded with the HOLDoption

9 CEDFSTATUS has an invalid CVDAvalue

17 You have specified an option that isinvalid for a remote program(CEDFSTATUS, COPY,EXECUTIONSET or SHARESTATUS)

18 You have specified an option that isinvalid for a map set (CEDFSTATUSor EXECUTIONSET)

19 You have specified an option that isinvalid for a partition set(CEDFSTATUS or EXECUTIONSET)

20 EXECUTIONSET has an invalidCVDA

PGMIDERR 7 The program, map set, or partitionset cannot be found

IOERR 8 The COPY option was specified butCICS could not locate the module

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

SET STATISTICS INVREQ 1 The INTERVAL value is out of range2 The ENDOFDAY value is out of

range3 RECORDING has an invalid CVDA

value4 The INTERVALHRS value is out of

range5 The INTERVALMINS value is out of

range6 The INTERVALSECS value is out of

range7 More than one of the interval values

has been used and the combinationeither exceeds 24 hours or is lessthan 1 minute

8 The ENDOFDAYHRS value is out ofrange

9 The ENDOFDAYMINS value is outof range

10 The ENDOFDAYSECS value is out ofrange

11 RESETNOW or RECORDNOW hasbeen specified, but the RECORDINGstate has not been changed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET SYSDUMPCODE NOTFND 1 The dump code cannot be found

Chapter 9. RESP2 values and their meanings 333

Command Condition RESP2 MeaningINVREQ 2 ACTION has an invalid CVDA value

4 SYSDUMPING has an invalid CVDAvalue

5 The MAXIMUM value is out of range6 SHUTOPTION has an invalid CVDA

value7 REMOVE is specified with other

options9 The dump code is invalid13 DUMPSCOPE has an invalid CVDA

value14 RELATED requires MVS/ESA 5.115 DAEOPTION has an invalid CVDA

valueDUPREC 10 ADD is specified for a dump code

already in the system dump tableIOERR 11 An error occurred updating the CICS

catalog. The entry is changed for thecurrent run, but is not recorded forrestarts

NOSPACE 12 The CICS catalog full. The entry ischanged for the current run, but isnot recorded for restarts

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET SYSTEM INVREQ 1 The MAXTASKS value is out ofrange

3 The AKP value is out of range5 TIME is not in the range 100–36000006 The RUNAWAY value is out of range7 MROBATCH is not in the range

1–2559 DUMPING has an invalid CVDA

value12 AKP was specified, but CICS was

initialized without keypointing13 TIME is less than SCANDELAY14 PRTYAGING is not in the range

0–6553515 SCANDELAY is not in the range

0–500020 DSALIMIT is not in the range 2MB

to 16MB21 EDSALIMIT is not in the range 10MB

to 2GB22 There is insufficient MVS storage to

allocate DSALIMIT23 There is insufficient MVS storage to

allocate EDSALIMITLENGERR 20 The GMMLENGTH value is out of

rangeNOSTG 16 CICS reduced the value you

requested for MAXTASKS because ofstorage constraints; see theNEWMAXTASKS option

334 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET TASK TASKIDERR 1 The task cannot be found2 The task is protected by CICS and

not eligible for modification with thiscommand

INVREQ 3 PURGETYPE has an invalid CVDAvalue

4 PRIORITY is not in the range 0–2555 The task is not in a valid state for

purgingNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET TCLASS TCIDERR 1 The transaction class cannot be foundINVREQ 2 The MAXIMUM value is not in the

range 0–999NOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET TCPIP INVREQ 4 TCPIP not available (TCPIP=NO)5 TCPIP already closed (for SET

CLOSED|IMMCLOSE)6 TCPIP already open (for SET OPEN)11 STATUS has an invalid CVDA value12 The OPEN request did not complete

because another task subsequentlyrequested a CLSOE of CICS internalsockets support

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET TCPIPSERVICE INVREQ 4 TCPIP is not available (TCPIP=NO)4 TCPIP status is closed7 Port in use8 CICS is not authorized to use this

port9 TCPIPSERVICE not closed10 Unknown IP address11 Invalid value specified in an operand

of the SET command (either theSTATUS or the URMname is wrong)

12 Invalid statusNOTFND 3 The named TCPIPSERVICE is not

foundNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET TDQUEUE QIDERR 1 The queue cannot be foundINVREQ 2 TRIGGERLEVEL was specified for an

extrapartition queue3 The TRIGGERLEVEL value is not in

the range 0–32767

Chapter 9. RESP2 values and their meanings 335

Command Condition RESP2 Meaning4 ATITERMID was specified for an

extrapartition queue5 ATITRANID was specified for an

extrapartition queue6 ATIFACILITY was specified for an

extrapartition queue7 ATIFACILITY has an invalid CVDA

value8 OPENSTATUS has an invalid CVDA

value9 OPENSTATUS was specified for an

intrapartition queue10 ENABLESTATUS has an invalid

CVDA value12 The queue is remote13 The queue is indirect15 OPENSTATUS was specified for a

DISABLED queue16 OPENSTATUS was specified, but the

JCL DDNAME to which the queuedefinition points was not found

18 SET not possible because the queuewas not closed

19 ATIUSERID was specified for anextrapartition queue

20 The ESM interface is not initialized21 CICS has received an unknown

response from the ESM22 The ESM did not respond30 Disabled pending condition31 SET not possible because the queue

was not disabled35 SET not possible because the queue

is in-doubt40 SET not possible because the queue

is CXRFIOERR 14 An error occurred opening or closing

the data set associated with thequeue

17 The queue cannot be set CLOSEDbecause there is no space in theassociated data set

NOTAUTH 23 The user named on the ATIUSERIDoption is not authorized

24 The user named in the ATIUSERIDhas been revoked

25 During SECLABEL processing by theexternal security manager, an erroroccurred. For information aboutsecurity labels, see the OS/390Security Server (RACF) SecurityAdministrator’s Guide, SC28-1915

27 The user named in the ATIUSERIDoption is not allowed to access thequeue

336 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

102 The user associated with the issuingtask is not an authorized surrogatefor the user specified in ATIUSERID

USERIDERR 28 The user named in ATIUSERID is notknown to the ESM

SET TERMINAL INVREQ 1 TERMSTATUS or ACQSTATUS wasspecified for IRC sessions ornon-VTAM terminal

2 TERMSTATUS or ACQSTATUS hasan invalid CVDA value

4 ATISTATUS has an invalid CVDAvalue

5 ATISTATUS change would result inNOATI and NOTTI

6 CREATESESS was specified fornon-VTAM terminal

7 CREATESESS has an invalid CVDAvalue

9 PAGESTATUS has an invalid CVDAvalue

11 Trying to put the issuing terminalOUTSERVICE

13 SERVSTATUS has an invalid CVDAvalue

15 TERMPRIORITY value not in range0–255

17 NOTTI cannot be specified for theissuing terminal

18 TTISTATUS has an invalid CVDAvalue

21 PURGETYPE has an invalid CVDAvalue

22 TRACING has an invalid CVDAvalue

24 Invalid option requested for a remoteterminal

25 ACQUIRED specified, but terminal isnot inservice

26 PURGE specified, but target task hasSPURGE=NO on its associatedtransaction definition

27 EXITTRACING has an invalid CVDAvalue

28 ZCPTRACING has an invalid CVDAvalue

29 EXITTRACING or ZCPTRACINGspecified for non-VTAM terminal (orVTAM not installed)

31 This is a remote terminal with noassociated surrogate

Chapter 9. RESP2 values and their meanings 337

Command Condition RESP2 Meaning33 SET TERMINAL is not valid for an

LU6.2 (APPC) session34 A permanent transaction has been

defined for this terminal(TRANSACTION operand inTERMINAL definition)

35 Attempt made to change TCAMCONTROL on non-TCAM terminal

36 Invalid value supplied for TCAMCONTROL

37 Preset signon failed, terminal remainsOUTSERVICE

38 OBFORMATST has an invalid CVDAvalue

39 RELREQST has an invalid CVDAvalue

40 DISCREQST has an invalid CVDAvalue

41 ALTPRTCOPYST has an invalidCVDA value

42 PRTCOPYST has an invalid CVDAvalue

43 UCTRANST has an invalid CVDAvalue

44 Options would result in the invalidcombination of the alternate printercopy status being set without analternate printer defined

45 Options would result in the invalidcombination of the alternate printerbeing defined without a primaryprinter defined

46 OBFORMATST is specified for aconsole or 3790

48 Options would result in the invalidcombination of the printer copystatus being set without a primaryprinter defined

50 VTAM not available for VTAMterminal

51 PRINTER and ALTPRINTER optionspecified for a non-3270 terminal

52 PRTCOPYST of ALTPRTCOPSToption specified for a non-3270terminal

54 Option other than PURGETYPEspecified for IRC session

57 Other SET parameters were includedwith the CANCEL option

NORMAL 53 Purge deferred58 AIDs are successfully canceled59 No AIDs are canceled60 MAPNAME or MAPSETNAME

specified, but the terminal is not of atype supported by BMS

TERMIDERR 23 The named terminal cannot be found

338 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

SET TRACEDEST INVREQ 1 INSTATUS has an invalid CVDAvalue

2 A TABLESIZE value of < −1 has beenspecified

3 AUXSTATUS has an invalid CVDAvalue

4 SWITCHSTATUS has an invalidCVDA value

5 GTFSTATUS has an invalid CVDAvalue

6 AUXPAUSE was specified, butauxiliary tracing is not active

11 SWITCHACTION has an invalidCVDA value

IOERR 10 A SWITCH request or a SETAUXSTART request resulted in an“open” error for the trace data set

NOSPACE 7 There is insufficient space for a newtrace table

NOSTG 8 There is insufficient space for anauxiliary trace buffer

9 There is insufficient space for a GTFtrace buffer

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET TRACEFLAG INVREQ 1 SYSTEMSTATUS has an invalidCVDA value

2 USERSTATUS has an invalid CVDAvalue

3 SINGLESTATUS has an invalidCVDA value

4 TCEXITSTATUS has an invalidCVDA value

5 TCEXITSTATUS is specified butVTAM is not installed

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET TRACETYPE NOTFND 1 At least one CICS component wasnot accessible. Trace levels were setfor the other components

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET TRANCLASS INVREQ 2 The MAXACTIVE value is not in therange 0-999

3 The PURGETHRESH value is not inthe range 0-1000000

Chapter 9. RESP2 values and their meanings 339

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

TCIDERR 1 The transaction class cannot be found

SET TRANDUMPCODE NOTFND 1 The dump code cannot be foundINVREQ 2 ACTION has an invalid CVDA value

3 TRANDUMPING has an invalidCVDA value

4 SYSDUMPING has an invalid CVDAvalue

5 The MAXIMUM value is out of range6 SHUTOPTION has an invalid CVDA

value7 REMOVE is specified with other

options9 The dump code is invalid13 DUMPSCOPE has an invalid CVDA

value14 RELATED requires MVS/ESA 5.1

DUPREC 10 ADD is specified for a dump codealready in the transaction dump table

IOERR 11 An error occurred updating the CICScatalog. The entry is changed for thecurrent run, but is not recorded forrestarts

NOSPACE 12 The CICS catalog is full. The entry ischanged for the current run, but isnot recorded for restarts

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET TRANSACTION TRANSIDERR 1 The transaction cannot be foundINVREQ 2 PURGEABILITY has an invalid

CVDA value3 STATUS has an invalid CVDA value4 DISABLED has been specified for a

CICS-supplied transaction5 The TCLASS or TRANCLASS name

is not known7 Tracing has an invalid CVDA value8 DUMPING has an invalid CVDA

value9 The PRIORITY value is out of range10 RUNAWAYTYPE has an invalid

CVDA value11 SHUTDOWN has an invalid CVDA

value12 USER has been specified without a

RUNAWAY value13 RUNAWAY has been specified

without a RUNAWAYTYPE value ofUSER

14 The RUNAWAY value is out of range

340 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

SETTSQUEUE/TSQNAME

NOTFND 1 The TSQUEUE cannot be found

INVREQ 1 The TSQUEUE was not deletedbecause LASTUSEDINIT was greaterthan the interval, or because theTSQUEUE is in use

2 The action specified was not DELETE3 LASTUSEDINIT was specified but

has an interval value; that is, anegative value

4 The filetype was not valid for thespecified operation

POOLERR 0 POOLNAME was specified but thepool could not be accessed

QIDERR 1 The QUEUE name was invalid (itwas binary zeroes)

SYSIDERR 0 SYSID was specified but there wasno corresponding pool, or the poolwas unavailable

3 The SYSID does not map to a sharedpool

5 I/O error on the coupling facilityNOTAUTH 100 The user associated with the issuing

task is not authorized to use thiscommand

101 The user associated with the issuingtask is not authorized to access thisparticular resource in the wayrequired by this command

SET UOW UOWNOTFOUND 1 The UOW cannot be foundINVREQ 3 UOWSTATE has an invalid CVDA

value4 CICS is not in a valid state to

COMMIT, BACKOUT, or FORCE thisUOW

NOTAUTH 100 The use of this command is notauthorized

SET UOWLINK UOWLNOTFOUND 1 The specified UOW-link cannot befound

INVREQ 2 Resynchronization is already inprogress, or the UOW-link is alreadybeing processed by another instanceof the SET UOWLINK command

Chapter 9. RESP2 values and their meanings 341

Command Condition RESP2 Meaning3 The UOW is in-doubt, and the

UOW-link is the coordinator of thecommit or backout session. TheUOW must be forced using the SETUOW command before the UOW-linkcan be deleted

4 This is not a link created by aconnection, or is not a recoverablelink

5 The UOW-link (and the associatedcommunication session) is still active

6 ACTION has an invalid CVDA value7 The UOW-link has a suitable

connection definition, and cannot bedeleted

NOTAUTH 100 The use of this command is notauthorized

SET VOLUME VOLIDERR 1 This command is obsolete, and isretained only for compatibility withreleases of CICS earlier than CICS forMVS/ESA 5.1. It has no equivalentfunction in CICS for MVS/ESA 5.1 orlater releases

SET VTAM INVREQ 1 VTAM is not present in the system2 OPENSTATUS has an invalid CVDA

value4 The PSDINTERVAL value is out of

range5 The PSDINTHRS value is out of

range6 The PSDINTMINS value is out of

range7 The PSDINTSECS value is out of

range8 A PSDINTERVAL value > 0 was

specified in an XRF-eligible system9 VTAM reported an error while an

attempt was being made to set thePSD interval

10 A PSD interval has been specified buteither the VTAM currently in use (orthe VTAM library used when theterminal control table was assembled)does not support persistent sessions.The interval may have been specifiedearlier than this command; see thePSDINTERVAL description. If OPENwas also requested, CICS has openedthe VTAM ACB

11 The ACB has opened successfully,but an error occurred in at least oneof the sessions that persisted fromthe previous failure

342 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning12 Your OPEN request did not complete

because another task subsequentlyrequested a close of the VTAMconnection

13 An error occurred during recovery ofsessions, and the VTAM ACB will beclosed as a result

14 CICS is performing cleanupprocessing following a predatory XRFtakeover. CICS rejects OPEN requestswith this error, without invokingVTAM, during this activity. OPENrequests are processed as usual assoon as cleanup is complete

16 Your attempt to deregister CICS froma VTAM generic resource failedbecause CICS is not registered as amember of a generic resource group

IOERR n An error occurred during theopening of the ACB. If CICS couldnot process the request, the RESP2value is 3. If VTAM detects thefailure, CICS returns the VTAMFDBK2 code in RESP2: you can lookup these errors in the VTAMProgramming manual, under ACBOPEN and CLOSE return codes

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SET WEB INVREQ 11 An invalid value has been suppliedfor STATUS, GARBAGEINT orTIMEOUTINT

NOTAUTH 100 The user associated with the issuingtask is not authorized to use thiscommand

SIGNOFF INVREQ 1 No user is currently signed on2 There is no terminal with this task3 This task’s terminal has preset

security4 Signoff is attempted using transaction

routing without using the CRTEtransaction

18 The CICS ESM interface notinitialized

200 Command not allowed for adistributed program link serverprogram

SIGNON NOTAUTH 1 A password is required2 The supplied password is wrong3 A new password is required4 The new password is not acceptable5 An OIDCARD is required6 The supplied OIDCARD is wrong

Chapter 9. RESP2 values and their meanings 343

Command Condition RESP2 Meaning16 The USERID is not authorized to use

this terminal17 The USERID is not authorized to use

the application19 The USERID is revoked20 The USERID’s access to the specified

group has been revoked21 The signon failed during SECLABEL

checking22 The signon failed because ESM is not

currently accepting signons23 The GROUPID is not known to the

ESM24 The USERID is not contained in the

GROUPIDINVREQ 9 The terminal already signed on

10 No terminal associated with this task11 This task’s terminal has preset

security12 The response from CICS security

modules is unrecognized13 There is an unknown return code in

ESMRESP from the external securitymanager

14 The required national language is notavailable

15 Signon attempted via transactionrouting without using the CRTEtransaction

18 The CICS ESM interface is notinitialized

25 The terminal is of an invalid type26 An error occurred during SNSCOPE

checking27 The ESM is not active28 The required national language is

invalid29 The user is already signed on. This

relates to the signon scope checking200 Command not allowed for a

distributed program link serverprogram

USERIDERR 8 The USERID is not known to externalsecurity manager

30 The USERID is all blanks or nulls

SPOOLCLOSE INVREQ 4 Unsupported language8 Unsupported function40 Subsystem interface already enabled

Note: Errors 1024 and over areinternal and should not occur. If oneof these error codes is returned,contact your IBM support center.

NOSPOOL 4 No subsystem present8 Interface being disabled; CICS is

quiescing

344 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning12 Interface has been stopped

NOTOPEN 8 Dataset has not been openedNOTFND 1024 Input or output function has been

corrupted, and SPOOLCLOSE couldnot complete

SPOOLOPEN INPUT ILLOGIC 3 Invalid CLASS value specifiedINVREQ 4 Unsupported language

8 Unsupported function16 USERID missing36 INPUT|OUTPUT missing40 Subsystem interface already enabled

Note: Errors 1024 and over areinternal and should not occur. If oneof these error codes is returned,contact your IBM support center.

NOSPOOL 4 No subsystem present8 Interface being disabled; CICS is

quiescing12 Interface has been stopped

NOTFND 4 No data sets could be located forretrieval for the specified externalwriter name

1024 Input or output function has beencorrupted, and SPOOLCLOSE couldnot complete

NOTOPEN 8 Data set has not been opened or atask which has not issued theSPOOLOPEN for a spool data set hasattempted to access it.

1024 Subtask OPEN macro failureOPENERR 4 A VSAM SHOWCB macro failed to

return the lengths of the VSAMcontrol blocks used to access the JESspool file.

SPOLBUSY 4 Interface already in use by anothertask

8 Interface already in use by currenttask

SPOOLOPEN OUTPUT ILLOGIC Invalid CLASS value specifiedINVREQ 4 Unsupported language

8 Unsupported function16 USERID missing20 NODE missing36 INPUT|OUTPUT missing40 Subsystem interface already enabled

Note: Errors 1024 and over areinternal and should not occur. If oneof these error codes is returnedcontact your IBM support center.

44 Error in the OUTDESCR string48 OUTDESCR specified but function

not available (wrong level of MVS orJES)

52 OUTDESCR specified but bad pointerfound on keyword or in OUTDESCRcondition

NOSPOOL 4 No subsystem present

Chapter 9. RESP2 values and their meanings 345

Command Condition RESP2 Meaning8 Interface being disabled; CICS is

quiescing12 Interface has been stopped

NOTFND 4 No data sets could be located forretrieval for the specified externalwriter name

NOTOPEN 8 Data set has not been opened1024 Subtask OPEN macro failure

OPENERR 4 A VSAM SHOWCB macro failed toreturn the lengths of the VSAMcontrol blocks used to access the JESspool file.

SPOLBUSY 4 Interface already in use by anothertask

8 Interface already in use by currenttask

SPOOLREAD ILLOGIC 3 Invalid CLASS value specifiedINVREQ 4 Unsupported language

8 Unsupported function12 Read attempt after end of file24 INTO missing40 Subsystem interface already enabled.

Note: Errors 1024 and over areinternal, and should not occur. If oneof these error codes is returned,contact your IBM support center.

NOSPOOL 4 No subsystem present8 Interface being disabled; CICS is

quiescing12 Interface has been stopped

NOTFND 4 No data sets could be located forretrieval for the specified externalwriter name

NOTOPEN 8 Data set has not been opened12 Attempt to read an output file1024 Subtask OPEN macro failure

SPOLBUSY 4 Interface already in use by anothertask

8 Interface already in use by currenttask

SPOOLWRITE INVREQ 4 Unsupported language8 Unsupported function28 FROM missing40 Subsystem interface already enabled.

Note: Errors 1024 and over areinternal, and should not occur. If oneof these error codes is returned,contact your IBM support center.

NOSPOOL 4 No subsystem present8 Interface being disabled; CICS is

quiescing12 Interface has been stopped

NOTOPEN 8 Spool report has not been opened16 Attempt to write an input file1024 Subtask OPEN macro failure

346 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningSPOLBUSY 4 Interface already in use by another

task8 Interface already in use by current

task

START INVREQ 4 Hours are out of range5 Minutes are out of range6 Seconds are out of range18 A USERID was specified and the

CICS external security managerinterface is not initialized

NOTAUTH 7 A resource security check has failedon TRANSID(name)

9 A surrogate user security check hasfailed on USERID(name)

USERIDERR 8 The specified USERID is not knownto the external security manager

10 The external security manager is in astate such that CICS cannotdetermine whether a specifiedUSERID is valid

START ATTACH INVREQ 11 An attempt was made to route aSTART ATTACH request

12 A START ATTACH request has failedNOTAUTH 7 A resource security check fails on

TRANSID (name)

START BREXIT INVREQ 11 An attempt was made to route aSTART BREXIT request

12 A START BREXIT request has failed18 A USERID is specified and the CICS

external security manager interface isnot initialized

NOTAUTH 7 A resource security check fails onTRANSID (name)

9 A surrogate user security check failson USERID (name)

USERIDERR 8 The specified USERID is not knownto the external security manager

10 The exnternal security manager is ina state such that CICS cannotdetermine whether a specifiedUSERID is valid

STARTBR FILENOTFOUND 1 A file name referred to in the FILEoption cannot be found in the FCTand SYSID has not been specified

INVREQ 20 Browse operations are not allowedaccording to the file entryspecification in the FCT

Chapter 9. RESP2 values and their meanings 347

Command Condition RESP2 Meaning25 The KEYLENGTH and GENERIC

options are specified, and the lengthdefined for the data set to which thisfile specified in the KEYLENGTHoption is greater than or equal to thelength of a full key

26 The KEYLENGTH option is specified(but the GENERIC option is notspecified), and the specified lengthdoes not equal the length defined forthe data set to which this file refers

33 An attempt has been made to start abrowse with a REQID already in usefor another browse

42 The KEYLENGTH and GENERICoptions are specified, and the lengthspecified in the KEYLENGTH optionis less than zero

44 The specified file is auser-maintained data table

51 A STARTBR command to a KSDS filethat was being accessed in RLS modespecified the RBA keyword. RLSmode does not support RBA access toKSDS files

DISABLED 50 File is disabledNOTOPEN 60 The requested file is CLOSED and

UNENABLED or the requested file isOPEN and in use by othertransactions, but a CLOSE requestagainst it has been received or aSTARTBR command was issuedagainst a data set that is quiesced, oris being quiesced, as a result of a SETDSNAME QUIESCED orIMMQUIESCED command

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTFND 80 An attempt to position on a recordbased on the search argumentprovided was unsuccessful

NOTAUTH 101 A resource security check has failedon FILE(filename)

LOADING 104 A STARTBR was issued to a couplingfacility data table that is currentlybeing loaded or the READ specifiesthe GENERIC or GTEQ options for auser-maintained data table

ILLOGIC 110 A VSAM error has occurred whichdoes not fall within one of the otherCICS response categories

IOERR 120 There has been an I/O error duringthe file control operation

348 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 MeaningSYSIDERR 130 The SYSID option specified a name

that is neither the local nor a remotesystem (made known to CICS bydefining a CONNECTION); or thelink to the remote system is closed.

131 The connection to the couplingfacility data table server has failed

132 The start browse is operating on acoupling facility data table that nolonger exists

SYNCPOINT INVREQ 200 SYNCPOINT was in a program thatis linked to from a remote systemthat has not specified theSYNCONRETURN option, or it waslinked to locally and is defined withEXECUTIONSET=DPLSUBSET

SYNCPOINTROLLBACK

INVREQ 200 SYNCPOINT ROLLBACK was in aprogram that is linked to from aremote system that has not specifiedthe SYNCONRETURN option, or itwas linked to locally and is definedwith EXECUTIONSET=DPLSUBSET

UNLOCK FILENOTFOUND 1 The file name referred to in the FILEoption cannot be found in the FCTand SYSID has not been specified

INVREQ 47 An unlock included a token whosevalue cannot be matched against anytoken in use for an existing READfor UPDATE request

48 An attempt is made to function-shipa request which includes a TOKENkeyword

DISABLED 50 A file is disabledNOTOPEN 60 The requested file is CLOSED and

UNENABLED or the requested file isOPEN and in use by othertransactions, but a close requestagainst it has been received

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOTAUTH 101 A resource security check has failedon FILE(filename)

ILLOGIC (VSAM andCICS-maintained data tables)

110 A VSAM error has occurred whichdoes not fall within one of the otherCICS response categories

IOERR 120 There has been an I/O error duringthe file control operation

SYSIDERR 130 The SYSID option specified a namethat is neither the local nor a remotesystem (made known to CICS bydefining a CONNECTION); or thelink to the remote system is closed.

131 The connection to the couplingfacility data table server has failed

Chapter 9. RESP2 values and their meanings 349

Command Condition RESP2 Meaning132 The UNLOCK is issued against a

coupling facility data table that nolonger exists

UPDATE COUNTER INVREQ 201 Named counter not found301 The server has reported an error that

is not understood by the namedcounter interface

303 An unexpected error has occurred ona macro used to access the couplingfacility

304 The pool parameter specified in theprogram cannot be resolved to avalid server name using the currentoptions table

305 The interface is unable to establish aconnection to the server for theselected named counter pool

306 An abend occurred during serverprocessing of a request

308 The DFHNCOPT options macro tablemodule could not be loaded

309 The named counter interfaceencountered an unknown entryformat

310 The user exit program is notlink-edited with the options table andcannot be loaded

403 The POOL parameter containsinvalid characters or embeddedspaces

404 The COUNTER parameter containsinvalid characters or embeddedspaces

406 The VALUE parameter is invalidSUPPRESSED 103 The current value of the named

counter is not within the rangespecified by the COMPAREMAX andCOMPAREMIN parameters, whenboth are specified or greater than theCOMPAREMAX parameter or lessthan the COMPAREMIN parameter,when only one option is specified

VERIFY PASSWORD NOTAUTH 2 The supplied password is wrong3 A new password is required19 The USERID is revoked

USERIDERR 8 The USERID is not known to theexternal security manager

INVREQ 13 There is an unknown return code inESMRESP from the external securitymanager

18 The CICS external security managerinterface is not initialized

29 The external security manager is notresponding

350 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning32 The userid field contains a blank

character in an invalid position

WAIT CONVID INVREQ 200 Command not supported fordistributed program link when itrefers to the principal facility

WAIT EVENT INVREQ 2 The ECB address is a null pointer,(X'00000000') or (X'FF000000')

3 The specified event control areaaddress is above the 16MB line forprograms executing in 24-bit mode

4 The event control area address is notaligned on a fullword boundary

6 The timer-event control area specifiedon a WAIT EVENT is in use-keytask-lifetime storage, and isinaccessible to another transaction.This condition can only occur if thestorage for the timer-event controlarea is obtained other than by anEXEC CICS POST command, and isfor posting as an ECB by some othertask on completion of an event

WAIT EXTERNAL INVREQ 1 An ECB is not valid, for example theECB is not fullword aligned

2 An ECB is already being waited on3 NUMEVENTS is not a positive

number4 PURGEABILITY is specified with an

incorrect CVDA5 No valid ECBs have been found in

the list because either the ECBLISTaddress is not valid or all the ECBaddresses are not valid

WAIT TERMINAL INVREQ 200 A distributed program link serverapplication specified thefunction-shipping session (itsprincipal facility) on the CONVIDoption

WAITCICS INVREQ 1 An ECB is not valid, for example theECB is not fullword aligned

3 NUMEVENTS is not a positivenumber

4 PURGEABILITY is specified with anincorrect CVDA

5 No valid ECBs have been found inthe list, because either the ECBLISTaddress is not valid, or all the ECBaddresses are not valid

WEB ENDBROWSEFORMFIELD

INVREQ 1 The command is being issued in anon-CICS Web application

3 The commend is being issued for anon-HTTP request

Chapter 9. RESP2 values and their meanings 351

|||||||||||

Command Condition RESP2 Meaning4 The command is being issued before

a WEB STARTBROWSE command isissued

5 No valid ECBs have been found inthe list, because either the ECBLISTaddress is not valid, or all the ECBaddresses are not valid

WEB ENDBROWSEHTTPHEADER

INVREQ 1 The command is being issued in anon-CICS Web interface application

3 The command is being issued for anon-HTTP request

4 The command is being issued beforea WEB STARTBROWSE command isissued

WEB EXTRACT INVREQ 1 The command is being issued in anon-CICS Web interface application

3 The command is being issued for anon-HTTP request

LENGERR 4 The length in METHODLENGTH isless than or equal to zero

5 The length in VERSIONLEN is lessthan or equal to zero

6 The length in PATHLENGTH is lessthan or equal to zero

8 The length in QUERYSTRLEN is lessthan or equal to zero

WEB READFORMFIELD

INVREQ 1 The command is being issued in anon-CICS Web application

3 The commend is being issued for anon-HTTP request

11 The client codepage could not befound

12 The server codepage could not befound

13 No forms data has been supplied inthe body of the HTTP request

14 The codepage combination for clientand server is invalid

LENGERR 1 The length in VALUELENGTH is lessthan or equal to zero

2 The form field value has beentruncated during a read operationbecause the receiving buffer is toosmall

NOTFND 1 The form field with the given namecould not be found

WEB READHTTPHEADER

INVREQ 1 The command is being issued in anon-CICS Web interface application

3 The command is being issued for anon-HTTP request

LENGERR 1 The length in VALUELENGTH is lessthan or equal to zero

352 CICS TS for OS/390: CICS User’s Handbook

||||||

||||||||||||||||||||||||||||||||||||||||||||||||

Command Condition RESP2 Meaning2 The header value has been truncated

because the receiving buffer is toosmall

NOTFND 1 The header with the given namecould not be found

WEB READNEXTFORMFIELD

ENDFILE The end of the list of name/valuepairs has been reached

INVREQ 1 The command is being issued in anon-CICS Web application

3 The command is being issued for anon-HTTP request

4 The command is being issued beforea WEB STARTBROWSE FORMFIELDhas been issued

6 A form field has been found which isnot in the expected format

LENGERR 1 NAMELENGTH or VALUELENGTHis less than or equal to zero

4 The form field name has beentruncated during a browse operationbecause the receiving buffer is toosmall

5 The form field value has beentruncated because the receivingbuffer is too small

WEB READNEXTHTTPHEADER

INVREQ 1 The command is being issued in anon-CICS Web interface application

3 The command is being issued for anon-HTTP request

4 The command is being issued beforea WEB STARTBROWSE has beenissued

LENGERR 1 NAMELENGTH or VALUELENGTHis less than or equal to zero

4 The header name has been truncatedbecause the receiving buffer is toosmall

5 The header value has been truncatedbecause the receiving buffer is toosmall

WEB RECEIVE INVREQ 1 The command is issued in anon-CICS Web interface application

LENGERR 1 The length is negative2 The length is positive and exceeds

the program’s maximum

WEB RETRIEVE INVREQ 1 The command is issued in anon-CICS Web interface application

2 A WEB SEND command has notbeen issued

WEB SEND INVREQ 1 The command is being issued in anon-CICS Web interface application

Chapter 9. RESP2 values and their meanings 353

|||||||||||||||||||||||||||||||||||||||||||||

Command Condition RESP2 MeaningNOTFND 1 The document has not been created

or the name is incorrectly specified7 The specified CLNTCODEPAGE is

not recognized or is incorrectlyspecified

WEB STARTBROWSEFORMFIELD

INVREQ 1 The command is being issued in anon-CICS Web application

3 The command is being issued for anon-HTTP request

5 There is already a WEBSTARTBROWSE in progress

11 The client codepage could not befound

12 The server codepage could not befound

13 No forms data has been supplied inthe body of the HTTP request

14 The codepage combination for clientand server is invalid

WEB STARTBROWSEHTTPHEADER

INVREQ 1 The command is being issued in anon-CICS Web interface application

3 The command is being issued for anon-HTTP request

WRITE FILENOTFOUND 1 The file name referred to in the FILEoption cannot be found in the FCT

LENGERR 10 LENGTH is omitted for a WRITE toa file with variable-length records orto a BDAM file withundefined-format records

12 The length specified for the writeoperation exceeds the maximumrecord size; the record is truncated

14 An incorrect length is specified for awrite operation involvingfixed-length records

INVREQ 20 Add operations are not allowedaccording to the file entryspecification in the FCT

23 When writing records containingembedded keys, the key in the recordarea (FROM option) and the key inRIDFLD do not match

26 The KEYLENGTH option is specified,and the specified length does notequal the length defined for the dataset to which this file refers to

38 A WRITE with the MASSINSERToption has been issued against aBDAM file

40 A BDAM key conversion error hasoccurred

44 The WRITE command does notconform to the format of WRITE fora user-maintained data table

354 CICS TS for OS/390: CICS User’s Handbook

|||||||||||||||||||||||||||||||

Command Condition RESP2 Meaning51 A WRITE command specifying the

RBA keyword was issued against aKSDS file that was being accessed inRLS mode. RLS mode does notsupport relative byte address accessto KSDS files

56 An attempt to update a recoverablecoupling facility data table has failedbecause the current unit of work haslaready updated 1024 recoverablecoupling facility data tables

DISABLED 50 A file is disabledNOTOPEN 60 The requested file is CLOSED and

UNENABLED or the requested file isOPEN and in use by othertransactions, but a CLOSE requestagainst it has been received or aWRITE request was issued against adata set that is quiesced, or is beingquiesced, as a result of a SETDSNAME QUIESCED orIMMQUIESCED command

ISCINVREQ 70 The remote system indicated a failurethat does not correspond to a knowncondition

NOSPACE 100 No space is available on the directaccess device for adding records to adata set

102 The maximum number of tableentries specified for theuser-maintained table has alreadybeen reached

103 CICS is unable to get sufficientstorage in the CICS address space tocreate an in-memory table entry forthe record being written

108 Insufficient space in the couplingfacility data table pool to store therecord

NOTAUTH 101 A resource security check has failedon FILE(filename)

LOADING 104 A WRITE is issued to auser-maintained data table that iscurrently being loaded

SUPPRESSED 105 A user exit program that is invokedat the XDTAD exit point decides notto add the record to theuser-maintained data table

LOCKED 106 An attempt was made to write arecord, but a retained lock existsagainst the key of this record

RECORDBUSY 107 NOSUSPEND was specified on therequest but VSAM held an activelock against the record, which wouldcause the request to wait

ILLOGIC 110 A VSAM error has occurred that doesnot fall within one of the other CICSresponse categories

Chapter 9. RESP2 values and their meanings 355

Command Condition RESP2 MeaningIOERR 120 There has been an I/O error during

the file control operation or you aretrying to write to a BDAM trackaddress that is not defined for a dataset

SYSIDERR 130 The SYSID option specified a namethat is neither the local nor a remotesystem (made known to CICS bydefining a CONNECTION); or thelink to the remote system is closed.

131 The connection to the couplingfacility data table server has failed

132 The WRITE is issued against acoupling facility data table that nolonger exists

DUPREC 150 An attempt has been made to add arecord to a data set, by referring to afile, or a path over a file (with theUNIQUEKEY attribute), in which thesame key already exists

WRITE OPERATOR INVREQ 1 The TEXTLENGTH value is not valid2 The NUMROUTES value is not valid3 A ROUTECODE value is not valid4 The MAXLENGTH value is not valid5 The TIMEOUT value is not valid6 The ACTION value is not valid

EXPIRED 7 TIMEOUT has occurred before theoperator’s reply was received

LENGERR 8 The reply was longer thanMAXLENGTH, and has beentruncated

XCTL PGMIDERR 1 A program has no entry in the PPTand either program autoinstall wasswitched off, or the programautoinstall control program indicatedthat the program should no beautoinstalled

2 A program is disabled3 A program cannot be loaded because

this was the first load of the programand the program load failed or thiswas a subsequent load of theprogram, but the first load failed

In order to reset the load status theload module must be in the DFHRPLconcatenation, and a SET PROGRAMNEWCOPY will be required

9 The installed program definition isfor a remote program

356 CICS TS for OS/390: CICS User’s Handbook

Command Condition RESP2 Meaning21 The program autoinstall control

program failed either because theprogram autoinstall control programis incorrect, incorrectly defined, or asa result of an abend in the programautoinstall control program. Programautoinstall is disabled and messageDFHPG0202 or DFHPG0203 iswritten to the CSPL

22 The model returned by the programautoinstall control program was notdefined in the PPT table, or was notenabled

23 The program autoinstall controlprogram returned invalid data

24 Define for the program failed due toautoinstall returning an invalidprogram name or definition

INVREQ 8 An XCTL command with theINPUTMSG option was issued for aprogram that is not associated with aterminal, or that is associated with anAPPC logical unit, or an IRC session

29 EXEC XCTL is not allowed in aGLUE or TRUE

30 The program manager domain hasnot yet been initialized

43 An XCTL has been attempted to ahot-pooled Java program object whilethere is already a hot-pooledprogram on the stack

200 An XCTL command with theINPUTMSG option has been issuedin a program invoked by DPL

LENGERR 11 LENGTH is less than 0 or greaterthan 32763

26 The COMMAREA address passedwas zero, but LENGTH was non zero

27 INPUTMSGLEN was less than 0 orgreater than 32767

28 LENGTH or INPUTMSGLEN isgreater than the length of the dataarea specified in the COMMAREA orINPUTMSG options, and while thatdata was being copied a destructiveoverlap occurred because of theincorrect length

NOTAUTH 101 A resource security check has failedon PROGRAM(name)

Chapter 9. RESP2 values and their meanings 357

358 CICS TS for OS/390: CICS User’s Handbook

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

This appendix lists the response codes and the function codes of EXEC CICScommands.

Response codes of EXEC CICS commandsAfter the execution of an EXEC CICS command, fields EIBRESP and EIBRCODEare set to indicate whether the command executed successfully, or whether a CICScondition was raised.

Each possible value of EIBRESP relates directly to a specific condition, no matterwhich command caused the condition to be raised. This is not true for EIBRCODEvalues: both the value and the byte of EIBRCODE in which it is set depend onwhich command was issued.

The following sections list the conditions that are applicable to the EXEC CICScommands described in this book, their corresponding RESP values (decimal), theassociated EIBRCODE values (hexadecimal), and the transaction abend codes (ifany).

EXEC CICS DISCARD, INQUIRE, PERFORM, and SETcommands

The first word of EIBRCODE for these commands is always set equal to thehexadecimal equivalent of the RESP value; the remaining bytes are set to X'00'.

Condition (Byte 3) RESP Valuecode 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 AEIK

© Copyright IBM Corp. 1989, 2000 359

Condition (Byte 3) RESP Valuecode code

EIBRCODE Abend

TRANSIDERR 28 1C AEI1UOWNOTFOUND 102 66 -USERIDERR 69 45 AEYXVOLIDERR 71 47 AEXV

EXEC CICS DISABLE, ENABLE, and EXTRACT EXITcommands

Conditions that can be raised by the DISABLE, ENABLE, and EXTRACT EXITcommands are INVEXITREQ and NOTAUTH. There are no conditions associatedwith the RESYNC command.

Condition RESP Value EIBRCODE AbendINVEXITREQ 63 80 AEY0NOTAUTH 70 46 AEY7

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 is asfollows:ASM CL2COBOL PIC X(2)PL/I CHAR (2)C CHAR variable name(2);

The function codes of the commands described in this book are listed below incommand sequence, then in function code sequence. For information about otherfunction codes, see the CICS Application Programming Reference manual.

Command CodeACQUIRE TERMINAL 86 02COLLECT STATISTICS 70 08CREATECONNECTION

30 0E

CREATE DB2CONN 30 20CREATE DB2ENTRY 30 22CREATE DB2TRAN 30 24CREATEDOCTEMPLATE

30 2E

CREATE ENQMODEL 30 2ACREATE FILE 30 14CREATEJOURNALMODEL

30 1E

CREATE LSRPOOL 30 16CREATE MAPSET 30 04CREATEPARTITIONSET

30 06

CREATE PARTNER 30 18CREATEPROCESSTYPE

30 26

CREATE PROFILE 30 0ACREATE PROGRAM 30 02

360 CICS TS for OS/390: CICS User’s Handbook

||||

|||

||

|||

Command CodeCREATEREQUESTMODEL

30 2C

CREATE SESSIONS 30 12CREATETCPIPSERVICE

30 30

CREATE TDQUEUE 30 1CCREATE TERMINAL 30 10CREATE TRANCLASS 30 1ACREATETRANSACTION

30 08

CREATE TSMODEL 30 28CREATE TYPETERM 30 0CDISABLE PROGRAM 22 04DISCARDAUTINSTMODEL

42 10

DISCARDCONNECTION

58 10

DISCARD DB2CONN 94 10DISCARD DB2ENTRY 94 30DISCARD DB2TRAN 94 50DISCARDDOCTEMPLATE

9E 10

DISCARDENQMODEL

90 90

DISCARD FILE 4C 10DISCARDJOURNALMODEL

92 10

DISCARDJOURNALNAME

60 10

DISCARD PARTNER 44 10DISCARDPROCESSTYPE

96 10

DISCARD PROFILE 46 10DISCARD PROGRAM 4E 10DISCARDREQUESTMODEL

9A 10

DISCARDTCPIPSERVICE

9C 10

DISCARD TDQUEUE 5C 10DISCARD TERMINAL 52 10DISCARDTRANCLASS

5E 18

DISCARDTRANSACTION

50 10

DISCARD TSMODEL 80 30ENABLE PROGRAM 22 02EXTRACT EXIT 22 06INQUIRE ACTIVITYID 96 12INQUIREAUTINSTMODEL

42 02

INQUIREAUTOINSTALL

68 12

INQUIRE CFDTPOOL 98 02INQUIRECONNECTION

58 02

Chapter 10. EXEC interface block (EIB) response and function codes 361

|||

|||

||

|||

|||

|||

|||

|||

||

||

||

Command CodeINQUIRECONTAINER

96 14

INQUIRE DB2CONN 94 02INQUIRE DB2ENTRY 94 22INQUIRE DB2TRAN 94 42INQUIREDELETSHIPPED

68 22

INQUIREDOCTEMPLATE

9E 02

INQUIRE DSNAME 7A 02INQUIRE DUMPDS 66 02INQUIRE ENQMODEL 90 82INQUIRE EVENT 96 16INQUIRE EXCI 7C 02INQUIREEXITPROGRAM

88 02

INQUIRE FILE 4C 02INQUIRE IRC 6E 02INQUIREJOURNALMODEL

92 02

INQUIREJOURNALNAME

60 12

INQUIREJOURNALNUM

60 02

INQUIREMODENAME

5A 02

INQUIRE MONITOR 70 12INQUIRE NETNAME 52 16INQUIRE NETNAME 52 06INQUIRE PARTNER 44 02INQUIRE PROCESS 96 18INQUIREPROCESSTYPE

96 02

INQUIRE PROFILE 46 02INQUIRE PROGRAM 4E 02INQUIRE REQID 8A 02INQUIREREQUESTMODEL

9A 02

INQUIRE RRMS 3A 02INQUIRE STATISTICS 70 02INQUIRE STORAGE 5E 08INQUIRESTREAMNAME

92 12

INQUIRESYSDUMPCODE

66 22

INQUIRE SYSTEM 54 02INQUIRE TASK 5E 02INQUIRE TCLASS 5E 12INQUIRE TCPIP 9C 12INQUIRETCPIPSERVICE

9C 02

INQUIRE TDQUEUE 5C 02INQUIRE TERMINAL 52 02INQUIRE TERMINAL 52 12INQUIRE TIMER 96 38

362 CICS TS for OS/390: CICS User’s Handbook

|||

|||

||||||

|||||

|||

||

|||||

||

Command CodeINQUIRE TRACEDEST 78 02INQUIRETRACEFLAG

78 12

INQUIRE TRACETYPE 78 22INQUIRETRANCLASS

5E 1A

INQUIRETRANDUMPCODE

66 12

INQUIRETRANSACTION

50 02

INQUIRE TSMODEL 80 22INQUIRE TSPOOL 80 1AINQUIRE TSQNAME 80 12INQUIRE TSQUEUE 80 02INQUIRE UOW 90 02INQUIREUOWDSNFAIL

90 62

INQUIRE UOWENQ 90 22INQUIRE UOWLINK 90 42INQUIRE VOLUME 62 02INQUIRE VTAM 68 02INQUIRE WEB 9C 22PERFORMDELETSHIPPED

68 26

PERFORM DUMP 7E 04PERFORMENDAFFINITY

58 06

PERFORMRESETTIME

72 02

PERFORM SECURITY 64 02PERFORMSHUTDOWN

76 02

PERFORM STATISTICS 70 06RESYNCENTRYNAME

16 04

SET AUTOINSTALL 68 14SET CONNECTION 58 04SET DB2CONN 94 04SET DB2ENTRY 94 24SET DB2TRAN 94 44SET DELETSHIPPED 68 24SET DSNAME 7A 04SET DUMPDS 66 04SET ENQMODEL 90 84SET FILE 4C 04SET IRC 6E 04SET JOURNALNAME 60 14SET JOURNALNUM 60 04SET MODENAME 5A 04SET MONITOR 70 14SET NETNAME 52 08SET PROCESSTYPE 96 04SET PROGRAM 4E 04SET STATISTICS 70 04SET SYSDUMPCODE 66 24

Chapter 10. EXEC interface block (EIB) response and function codes 363

||||||

||

||

||

Command CodeSET SYSTEM 54 04SET TASK 5E 04SET TCLASS 5E 14SET TCPIP 9C 14SET TCPIPSERVICE 9C 04SET TDQUEUE 5C 04SET TERMINAL 52 04SET TERMINAL 52 14SET TRACEDEST 78 04SET TRACEFLAG 78 14SET TRACETYPE 78 24SET TRANCLASS 5E 1CSETTRANDUMPCODE

66 14

SET TRANSACTION 50 04SET TSQNAME 80 14SET TSQUEUE 80 04SET UOW 90 04SET UOWLINK 90 44SET VOLUME 62 04SET VTAM 68 04SET WEB 9C 24

Code Command16 04 RESYNC ENTRYNAME22 02 ENABLE PROGRAM22 04 DISABLE PROGRAM22 06 EXTRACT EXIT30 0A CREATE PROFILE30 0C CREATE TYPETERM30 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 DB2TRAN30 26 CREATE PROCESSTYPE30 28 CREATE TSMODEL30 2A CREATE ENQMODEL30 2C CREATE

REQUESTMODEL

364 CICS TS for OS/390: CICS User’s Handbook

||||

||||

||

|||||||||

Code Command30 2E CREATE DOCTEMPLATE30 30 CREATE TCPIPSERVICE3A 02 INQUIRE RRMS42 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 SYSTEM58 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

JOURNALNAME

Chapter 10. EXEC interface block (EIB) response and function codes 365

||||||

Code Command60 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 SHUTDOWN78 02 INQUIRE TRACEDEST78 04 SET TRACEDEST78 12 INQUIRE TRACEFLAG78 14 SET TRACEFLAG78 22 INQUIRE TRACETYPE78 24 SET TRACETYPE7A 02 INQUIRE DSNAME7A 04 SET DSNAME7C 02 INQUIRE EXCI7E 04 PERFORM DUMP80 02 INQUIRE TSQUEUE80 04 SET TSQUEUE80 12 INQUIRE TSQNAME80 14 SET TSQNAME80 1A INQUIRE TSPOOL80 22 INQUIRE TSMODEL80 30 DISCARD TSMODEL86 02 ACQUIRE TERMINAL88 02 INQUIRE

EXITPROGRAM8A 02 INQUIRE REQID90 02 INQUIRE UOW

366 CICS TS for OS/390: CICS User’s Handbook

||

||||||||||||

Code Command90 04 SET UOW90 22 INQUIRE UOWENQ90 42 INQUIRE UOWLINK90 44 SET UOWLINK90 62 INQUIRE UOWDSNFAIL90 82 INQUIRE ENQMODEL90 84 SET ENQMODEL90 90 DISCARD ENQMODEL92 02 INQUIRE

JOURNALMODEL92 10 DISCARD

JOURNALMODEL92 12 INQUIRE

STREAMNAME94 02 INQUIRE DB2CONN94 04 SET DB2CONN94 10 DISCARD DB2CONN94 22 INQUIRE DB2ENTRY94 24 SET DB2ENTRY94 30 DISCARD DB2ENTRY94 42 INQUIRE DB2TRAN94 44 SET DB2TRAN94 50 DISCARD DB2TRAN96 02 INQUIRE PROCESSTYPE96 04 SET PROCESSTYPE96 10 DISCARD PROCESSTYPE96 12 INQUIRE ACTIVITYID96 14 INQUIRE CONTAINER96 16 INQUIRE EVENT96 18 INQUIRE PROCESS96 38 INQUIRE TIMER98 02 INQUIRE CFDTPOOL9A 02 INQUIRE

REQUESTMODEL9A 10 DISCARD

REQUESTMODEL9C 02 INQUIRE TCPIPSERVICE9C 04 SET TCPIPSERVICE9C 10 DISCARD TCPIPSERVICE9C 12 INQUIRE TCPIP9C 14 SET TCPIP9C 22 INQUIRE WEB9C 24 SET WEB9E 02 INQUIRE

DOCTEMPLATE9E 10 DISCARD

DOCTEMPLATE

Chapter 10. EXEC interface block (EIB) response and function codes 367

||||||

||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

368 CICS TS for OS/390: CICS User’s Handbook

Chapter 11. DFH messages

While CICS is running, it can produce several types of messages:v Console messages advise the system operator of execution progress, or request a

decision.v Certain CICS-supplied support programs communicate directly with terminal

operators.v CICS management modules and support programs log significant events and

error occurrences to transient data destinations; for example, to the controlsystem master terminal (CSMT), or to the CICS database control log (CDBC) forthe CICS-DBCTL interface.

v The CICS message switching program (DFHMSP) generates message switchingresponses (described in the CICS Supplied Transactions manual).

v CICS directs informational macro notes (mnotes) to programmers (these are notdocumented).

v Messages produced by CICS/ESA utility programs such as DFH$MOLS andDFHMNDUP. These messages are self-explanatory and are not documented.

All of the CICS messages described in this book can also be viewed online usingthe CICS transaction CMAC. For guidance on using CMAC, see the CICS SuppliedTransactions 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 digits are theCICS 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.

DFHccnnnn identifiersThese consist of the prefix “DFH” followed by a two-letter component identifier(cc), and a four-digit message number (nnnn). The component identifier shows thedomain or the component which issues the message. Here is a list of componentidentifiers with associated domains and components:

AC The abnormal condition program component

© Copyright IBM Corp. 1989, 2000 369

AI The auto-install terminal model manager (AITM)

AM The RDO allocation manager

AP The application domain

AU The transaction affinities utility

BA The Business Application Manager (BAM) domain

BR Bridging to 3270 transactions

CA RDO command utility routine

CC The CICS catalog domain (local and global)

CE The sign on program component

CF CICS coupling facility data tables server

CP The CPI Communications component

CR The ISC remote scheduler component

CZ The CICS class libraries domain

DB The CICS database control component

DD The directory manager

DM The domain manager domain

DS The dispatcher domain

DU The dump domain

DX The CICS database control component

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 program component

IC The interval control program

IN The indoubt testing tool

IR The interregion component

JC The online journal control component

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 control program component

ME The message domain

MN The monitor domain

MU The message editing utility program

370 CICS TS for OS/390: CICS User’s Handbook

MV The MVS RESMGR exit stub

NQ The enqueue manager domain

PA The parameter manager domain

PC The program control program component

PD The print dump exit routine DFHPDX

PG The program manager domain

PR The partner resource manager

PS The system spooler interface control module component

RD The RDO allocation manager

RM The recovery Manager

RP CICS ONC RPC

RS The communications resynchronization program

RT The ISC transaction routing component

RU The recovery utility program

RX The RRS-coordinated EXCI domain

SH The Scheduler domain

SI The system initialization component

SK The sub task control program component

SM The storage manager domain

SN The signon component

SO The CICS sockets domain

SR The system recovery component

ST The statistics domain

SZ The front end programming interface (FEPI)

TC The terminal control program component

TD The transient data component

TF The terminal facility manager

TI The timer domain

TM The system termination program component

TO The terminal object resolution program component

TP The BMS terminal page retrieval program component

TR The trace domain

TS The temporary storage domain

UP The measured usage license charging support macro

US The user domain

WB The CICS Web Interface

XA The XRF alternate component

Chapter 11. DFH messages 371

XC The XRF CICS availability manager

XG The XRF general component

XM The transaction manager

XO The XRF CICS availability manager

XQ The shared temporary storage queue pool server

XS The CICS security component

ZC The terminal control working set component

ZE The TCP error message writer component

ZN The syncpoint component

Thus the CICS message DFHAP0002 is issued from the application domain,identified by the two-character identifier AP.

Action codesCertain messages (for example, DFHDB8208D) include an action code after themessage identifier. Action codes give guidance to the operator of the type of actionneeded when the message appears on the system console. The following actioncodes 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 taken immediately

I No action required (If issued via the message domain, these messages canbe suppressed by specifying MSGLVL=0 as a system initializationoverride.)

Severity codesCertain messages, especially those associated with messages to terminal operatorsand messages which come from CICS utilities, have a severity code. (DFHST0210 I,is an example.) A severity code indicates to the operator whether a message isassociated with an error, and if so, how serious it is. The following severity codesare used:

E Error. Something has gone wrong and action is required of the user beforeCICS processing can continue.

I Information only. No action is required.

W Warning. Something may have gone wrong, a program loop for example,but CICS processing continues.

S Severe error. Something serious has gone wrong and immediate action isrequired. CICS processing is suspended until action has been taken.

Format of informationInformation about each message is presented in the following format:v Message identifier – in the form DFHnnnn or DFHccnnnn

v Message text – the words and inserts which make up the message as displayedin CICS

372 CICS TS for OS/390: CICS User’s Handbook

v Explanation – the events leading to or following the production of the messagev System action – the action that has been or will be taken by CICSv User response – the action recommended for the user (the console or terminal

operator or system programmer)v Destination – the device or log to which the message is sent. This is one of the

following:– Console – refers to a terminal type attached to CICS. (Route codes are 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 definitionsCSQL 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 in an XRFenvironment until the other destinations are made available during thetakeover.

v Module(s) – the name(s) of the module or modules that determined that themessage should be sent. (This is not necessarily the module that issued themacro to write the message.)

Chapter 11. DFH messages 373

XMEOUT parameters –Messages that can drive the XMEOUT global user exit include a list of XMEOUTparameters. The XMEOUT exit allows you to suppress or reroute messages thatuse the message domain. For programming information about the XMEOUT userexit see the CICS Customization Guide

Route codes –Console messages can be sent to a number of console types. The type of console towhich a particular message is sent is determined by the MVS route code. Eachroute code maps onto one console type. The meanings of the route codes normallyused 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 the screen and onSYSLOG

10 System error or maintenance information11 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 of thoseCICS messages that are issued via the message domain. Messages that cannot bechanged using the utility include a note to this effect before the messagedestination. See the CICS Operations and Utilities Guide for more information aboutthe 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 on an MVSconsole. It is effective when you specify FORMATMSG=YES as an initializationparameter for the CICS subsystem, as described in the CICS Transaction Server forOS/390 Installation Guide. When this facility is used, it affects messages displayedon MVS system consoles in the following ways:v The subsystem tries to ensure that all console messages issued by all CICS

regions have a standard format. The standard format is:Column number: 1 13 22

| | |+DFHnnnn applid message-text

374 CICS TS for OS/390: CICS User’s Handbook

The “plus” sign (+) is added by MVS to indicate that a problem-state programissued the message. It is not present when CICS issues the message while it is insupervisor state.

The applid inserted into the message is the specific application identifier. This isthe identifier that is specified in the system initialization parameter APPLID. It isthe only operand when XRF=NO is also specified, or the second operand whenXRF=YES is also specified.

v The subsystem adds routecodes specified in the ROUTECODES subsysteminitialization parameter, so the messages might be sent to more consoledestinations than those implied in the body of this book.

v The subsystem reformats messages for all CICS releases, even those issued byCICS/OS/VS Version 1.

v The subsystem does not reformat messages that are issued by a CICS region thathas not yet determined its applid. This includes messages that are issued whileprocessing the system initialization table and its overrides.

v The subsystem routine that reformats the messages does not receive control untilafter the message has been recorded in the CICS job’s job log. Therefore, thereformatting is not usually apparent in the job log.

v Messages issued by the message domain already contain the applid. Thesubsystem does not insert the applid into such messages, but it might insertblank characters to cause alignment into standard locations.

v If the original CICS message is a long one, adding the applid in the standardposition might cause the message to exceed the maximum length for an MVSconsole message. In this case, the original message is suppressed (does notappear on the console), and a new message is issued using the MVSmultiple-line console message service to split the message over several lines.Both the original message and perhaps several instances of the reformattedmultiple-line message appear in the job log, but only one copy of thereformatted message is displayed on the console.

v For some messages where the applid normally follows a time and date stamp,inserting the applid in the standard position would have resulted in the applidbeing duplicated within the message. For these messages, the subsystemeliminates the time and date stamp, since they are available from other sources,and only one occurrence of the applid is shown.

Terminal identifiers –Some messages include a terminal identifier (termid) in the message text. This isnormally shown as a 4-character identifier. However, when CICS cannotcompletely identify a terminal – for example, when intersystem communication istaking place, the terminal identifier is prefixed by the application identification(applid) of the system owning the terminal.

Abend code inserts –The transaction abend code insert (abcode) in some CICS messages is displayed as‘????’ when neither the EXEC CICS ABEND request nor the DFHPCTYPE=ABEND macro request specifies an abend code.

Dumps –A dump is generally available for printing when a CICS system abend or abnormaltermination occurs, provided the relevant data set has been specified. The dumpcan be used for problem determination.

Chapter 11. DFH messages 375

Terminology –The terms “abnormally terminates” and “abnormal termination” are frequentlyused in a general sense to relate, as applicable, to one of the following:v The termination of CICS as a result of an MVS ABEND macro. (The term

“abend” may also be used.)v The termination of a transaction (task) as a result of a CICS transaction ABEND

macro.

MVS user abend codesDFH messages which accompany a CICS system, utility, or subtask abend have anassociated MVS user abend code. Where possible, the value of this code is thenumeric part of the corresponding DFH message. Thus DFH0305 has an 0305 userabend code. If an MVS abend code is issued but not the associated CICS message,the problem probably does not originate with CICS. See the description of the MVSabend code in the MVS System Codes manual for further information.

The highest possible value of an MVS user abend code is 4095, therefore any DFHmessage with a number higher than 4095 has an MVS user abend code that doesnot follow the above convention. The following are lists of the abend codes formessages with numbers above 4095, in order of abend code, and in order ofmessage number.

Ordered by abend code

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 DFHXG6444

376 CICS TS for OS/390: CICS User’s Handbook

0203 DFHXG64300204 DFHXA65300205 DFHXG64390206 DFHXG64150207 DFHXA65230209 DFHXG64270210 DFHXA65280211 DFH65290213 DFHXG65240214 DFHXA65800220 DFHXO67000221 DFHXO67040222 DFHXO67020223 DFHXO67030224 DFHXO6720

Ordered by message identifier

DFHAK5802 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 0123

Chapter 11. DFH messages 377

DFH5180 0125DFH5184 0126DFH5263 0108DFH5721 0147DFH5722 0148DFH5723 0149DFH5754 0152DFH6529 0211

Notes:

1. All messages which appear in the JES job log are prefixed by a time stamp andjob number. Because of this, some messages will have their message texttruncated. If the full message text is required, consult the MVS log as allmessages in the JES log are duplicated in the MVS system log.

2. User abend 0225 is internal to CICS. It is issued by DFHDTES when, duringbackout, an entry in a hash table has been marked empty where it should notbe possible. This causes the CICS region to be abnormally terminated. If thisabend occurs, you will need help to resolve the problem. See Part 4 of the CICSProblem Determination Guide for guidance on how to proceed.

378 CICS TS for OS/390: CICS User’s Handbook

Chapter 12. Transaction abend codes

When abnormal conditions occur, CICS can send a message to the CSMT transientdata destination containing the transaction ID, the program name and the abendcode. Here is an example:

DFHAC2236 date time applid Transaction tranid abendprimary abcode in program program nameterm termid backout successful { batchid =}batchid. message

Alternatively, the application can intercept abends by including an active EXEC CICS HANDLE ABENDcommand. The actual abend code can be determined by issuing the EXEC CICS ASSIGN command withthe ABCODE option.

The transaction identification code tranid usually consists of the 4 characters defined to CICS. However,when a transaction is initiated by using a light pen, an operator identification (OPID) card reader, or 3270PA or PF keys (specified in the TASKREQ= operand), CICS creates an internal transaction identification inthe form of a 1-byte 3270 attention identification (AID) code followed by 3 bytes of X'FF'.

The code that may actually appear in the message in place of the internally-created transactionidentification will be *xx*, where xx is the character translation of the 3270 AID code. To preventambiguity, the user should avoid using these codes as transaction identifiers.

The keys, the light pen (LPA), and OPID, and their corresponding printed AID codes are given in thefollowing 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*

An abend code indicates the cause of an error that may have been originated by CICS or by a userprogram. For most of the abend codes described, a CICS transaction dump is provided at abnormaltermination.

All CICS transaction abend codes abcode are 4-character alphanumeric codes 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 that detected an error.

y is the 1-character alphanumeric code assigned by CICS.

© Copyright IBM Corp. 1989, 2000 379

Format of informationFor each transaction abend code, the following information is given:v An explanation of events leading to or following the message.v The action that has been or will be taken by CICS (system action).v The action recommended for the user (console or terminal operator).v The module or modules that can determine that the message should be sent (not

necessarily the module or modules that can issue the macro to write themessage.)

380 CICS TS for OS/390: CICS User’s Handbook

Chapter 13. Transaction abend codes

For guidance about interpreting the transaction abend codes summarized below,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 fileAAMK DFHAMP Irrecoverable error from DFHFCDN while installing a fileAAMN DFHAMP Unexpected return code from DFHPRPT, internal logic errorAAMO 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 Communications mapped conversation failed

AAOJ DFHCPIC CPI Communications detected unexpected response from internal routineAAOK DFHCPIC CPI Communications detected unexpected call to internal routine

© Copyright IBM Corp. 1989, 2000 381

Abend Module Explanation

AAOL DFHCPCLR CPI Communications made an invalid call to DFHLUCAAOM DFHCPCLR,

DFHCPSRHCPI Communications out of sync with DFHZUSR state machines

AAON DFHCPCLR,DFHCPCLC

Unexpected response from DFHLUC to CPI Communications

AAOO DFHCPARH CPI Communications invoked with invalid first parameterAAOP DFHCPCFS Impossible situation requested for CPI CommunicationsAAOQ DFHCPCFS CPI Communications return code has no entry in state tableAAOR DFHCPIC CPI Communications detected invalid value in conversation control blockAAOS DFHCPIC CPI Communications finds unexpected RESET for conversation stateAAOT DFHCPCBI CPI Communications chain error in conversation control blocksAAOU DFHCPCBI CPI Communications error processing initialize conversation requestAAOV 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 CPI CommunicationsAAO8 DFHCPSRH Invalid Conversation Control Block (CPC) passed to CPI CommunicationsAAO9 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 SM domain completed

ABLB DFHMCP,DFHMCPE,DFHM32,DFHPBP,DFHRLR

Error on call to SM domain

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 of terminals than possibleABMD DFHTPP,

DFHTPRUnexpected return code from send DFHTPR or DFHTPP

ABME DFHTPP,DFHTPR

DFHTPR or DFHTPP detected invalid datastream during BMS request

ABMF DFHPBP Send length too largeABMG DFHMCP,

DFHTPQBMS service not present

382 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

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 to CICS correctlyABMR 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-supported terminalABM2 DFHMCP No user data for BMS requestABM3 DFHMCP BMS service requested from a non-terminal-oriented taskABM4 DFHMCP,

DFHTPPBMS issued invalid request response to temp storage 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 largeABNA 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 be autoinstalled

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 value

Chapter 13. Transaction abend codes 383

Abend Module Explanation

ABRN DFHBRIC,DFHBRMS,DFHBRSP,DFHBRTC

The USERID check failed following call to the bridge exit

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 the bridge 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 the bridge exitABSA DFHTBS A message passed to DFHBSMSG is too long - CICS internal errorABXA DFH0CBRF Wrong type of RECEIVE vector in input messageABXC DFH0CBRE Error on SYNCPOINT request issued by bridge exitABXD DFH0CBRE Error when SYNCPOINT ROLLBACK request issued by bridge exitABXE DFH0CBAE,

DFH0CBRENo data passed on BRDATA parameter of START command

ABXF DFH0CBAE,DFH0CBRE,DFH0CBAI

Error detected by bridge exit inputting next message

ABXG DFH0CBAE,DFH0CBRE

Error detected by bridge exit outputting next message

ABXH DFH0CBRF No data available in message - transaction is non conversationalABXI DFH0CBAE,

DFH0CBREMessage received by bridge exit exceeds maximum message size

ABXJ DFH0CBAE,DFH0CBRE

Bridge exit detected error in MQCIH passed by client application

ABXK DFH0CBAE,DFH0CBRE

Bridge exit detected error in data passed on BRDATA parameter

ABXM DFH0CBAE,DFH0CBRE,DFH0CBRF

Bridge exit called with unsupported function or command

ABXN 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,DFH0CBRF

Bridge exit called with invalid BRXA-HEADER - storage overwrite

ABX2 DFH0CBAE,DFH0CBRE,DFH0CBRF

Bridge exit called with invalid BRXA-TRANSACTION-AREA - storage overwrite

ABX3 DFH0CBAE,DFH0CBRE,DFH0CBRF

Bridge exit called with unsupported BRXA-COMMAND-AREA - storage overwrite

ABX5 DFH0CBAE,DFH0CBRE,DFH0CBRF

Bridge exit called without a user-area - error in bridge exit

384 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

ABX6 DFH0CBAE,DFH0CBRE,DFH0CBRF

Bridge exit called with invalid user-area - storage overwrite or error in bridge exit

ABX7 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 smallACAM 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

CICS taskACL4 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 requestACL7 ICCGLBIC CICS Foundation Classes have thrown an exception theapplication programmer failed to

catchACL8 ICCGLBIC CICS Foundation Classes have thrown an exception theapplication programmer failed to

catchACL9 ICCRESIC CICS Foundation Classes responded to a request to abenda CICS task.ACLA ICCGLIBC CICS Foundation Classes detetcted an internal error.ACLB ICCGLIBC CICS Foundation Classes detetcted an internal error.ACLC ICCGLIBC CICS Foundation Classes detetcted an internal error.ACLD ICCGLIBC CICS Foundation Classes detetcted an internal error.

Chapter 13. Transaction abend codes 385

Abend Module Explanation

ACLE ICCGLIBC CICS Foundation Classes detetcted an internal error.ACLF ICCGLIBC CICS Foundation Classes detetcted an internal error.ACLG ICCGLIBC CICS Foundation Classes detetcted an internal error.ACLH ICCBASEC CICS Foundation Classes detetcted an error whileprocessing 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 FIELD contains only SBCS charactersACN9 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 facilityACRB DFHAPRT Relay program invoked by transaction not defined as remoteACRC 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 be linked

ACRJ DFHAPRT,DFHEPC

Dynamic transaction routing program has abended

ACRK DFHAPRT Relay program invoked with no address for principal facilityACRL DFHAPRT The task does not own the facilityACRM DFHAPRT Dynamic routing program INITIAL_LINK failureACRN DFHAPRT Dynamic routing program indicated that transaction should not be routed but executed

in local systemACRO 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 AOR

386 CICS TS for OS/390: CICS User’s Handbook

||||

Abend Module Explanation

ACTB 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 taskACTJ 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 protocolsACVC 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 failed

Chapter 13. Transaction abend codes 387

Abend Module Explanation

ACVL 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 terminalADCV DFHDLIDP Connection to DBCTL terminated and then re-establishedADDA 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 requestADLP 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 not supported by CICSADXA DFHDXCU XRF DBCTL state catch-up transaction, DXCU, has failedADXB DFHDXCU XRF DBCTL state catch-up transaction, DXCU, has failedAD2A 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

DB2ENTRY control blockAD2F DFHD2EX1 An error occurred on locate call to DM domain to locate a DB2ENTRY control blockAD2G DFHD2EX1 A transaction attempted to use a DB2ENTRY that is DISABLED or is DISABLING

388 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

AD2H DFHD2EX1 The CICS-DB2 attachment facility detected that a dynamic plan exit program abendedAD2I DFHD2EX1 The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because

it was not linked AMODE 31AD2J DFHD2EX1 The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because

it is disabledAD2K DFHD2EX1 The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because

no program definition was foundAD2L DFHD2EX1 The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because

the program could not be loadedAD2M DFHD2EX1 The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because

the program is defined as remoteAD2N DFHD2EX1 The CICS-DB2 attachment facility failed to link to a dynamic plan exit programAD2O DFHD2EX1 An error occurred on an WAIT_MVS call to DM domainAD2P DFHD2EX1 Transaction was unable to obtain a DB2 thread from a DB2ENTRY or poolAD2Q 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

which failedAD2T DFHD2EX1 An attempt to create a DB2 thread failed with DB2 reason code 00F30040AD2U DFHD2EX1 An attempt to create a DB2 thread by the subtask servicing the DB2 request failedAD2V DFHD2EX1 The CICS-DB2 attachment facility lost connection to DB2 (reason code 00F30805)AD2W DFHD2EX1 The CICS-DB2 attachment facility received an unexpected response to single-phase

commit call to DB2AD2X DFHD2EX1 The CICS-DB2 attachment facility detected that the CICS task and thread subtask were

in an invalid stateAD2Y DFHD2EX1 The transaction was unable to obtain a DB2 thread from a DB2ENTRY or or pool - no

TCBs availableAD2Z DFHD2EX1 DB2 detected a deadlock and CICS-DB2 attachment facility attempted a syncpoint

rollback command for transactionAD21 DFHD2EX1 The CICS-DB2 attachment facility received a request for resource manager with incorrect

nameAD22 DFHD2EDF The CICS-DB2 attachment facility EDF processor was unable to interpret the SQL

requestAD23 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 STRT commandAD3G DFHD2CM1 Unexpected response from EXEC CICS GETMAIN issued during processing of a

CICS-DB2 DSNC commandAD3I DFHD2CM1 Unexpected response from EXEC CICS INQUIRE DB2CONN issued during startup of

the CICS-DB2 interfaceAD3M DFHD2CM1 Unexpected error occurred during processing of DSNC MODIFY commandAD3P DFHD2CM1 Unexpected error occurred during processing of DSNC STOP commandAD3Q DFHD2CM1 Unexpected response received reading a record frm TS queue during processing of a

DSNCX STRT commandAD3R DFHD2STR Unexpected response received reading a record frm TS queue during startup of the

CICS-DB2 interface

Chapter 13. Transaction abend codes 389

Abend Module Explanation

AD3S DFHD2CM1 Unexpected response received from EXEC CICS SET DB2CONN command duringstartup of the CICS-DB2 interface

AD3T DFHD2EX1 Transaction was unable to obtain a DB2 thread from the poolAD3U 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 attempted on unsupported terminal

AEC2 DFHECIP,DFHECSP,DFHEMTP,DFHESTP,DFHEOTP,DFHEDAP

CECI, CEMT, or CEDA/B/C tried to use too small a screen

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 EDFXAAEDC 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, using CEBR on unsupported device orCEBR initiated with a 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 handled

390 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

AEIL 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 returnedAELB 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 handled

Chapter 13. Transaction abend codes 391

Abend Module Explanation

AEXU DFHEIDTI,DFHEIQDS,DFHEIQSA,DFHEIQSC,DFHEIQSM,DFHEIQSPDFHEIQST,DFHEIQSX

NOTPOSS condition raised on encountering invalid parameter

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

CodesAEXZ DFHxxx Command failed due to serious failure in CICS component For module list, see CICS

Messages and CodesAEX0 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, DFHEEI Invalid EXEC CICS command issued

392 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

AEZA DFHEIP AMODE 24 program defined in transaction with TASKDATALOC=ANYAEZB DFHERM AMODE 24 task related user exit defined in transaction with TASKDATALOC=ANYAEZC DFHAPLI AMODE 24 program defined in transaction with TASKDATALOC=ANYAEZD DFHAPLI Attempt to run EXECKEY(USER) program in transaction with TASKDATAKEY(CICS)

definedAEZE 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 request module DFHFCFR

AFCD DFHEIFC Irrecoverable error as table manager tries to locate AFCTAFCE DFHEIFC A GETMAIN for FFLE storage failedAFCF DFHEIFC,

DFHDMPCAFile control deadlock between tasks

AFCG DFHEIFC,DFHDMPCA

File issued sequence of file control requests that would 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 data set during backup

AFCL DFHDTLX Response could not continue during loading of Shared Data Table by CSFL txnAFCM DFHDTLX Data table load failedAFCN DFHDMPCA,

DFHEIFCJournal record too large for journal buffer

AFCO DFHDTLX Transaction not internally attached by CICS on attempt to attachAFCR DFHEIFC,

DFHDMPCASMSVSAM server address space has failed

AFCS DFHEIFC,DFHDMPCA

SMSVSAM server address space was inactive

AFCT DFHEIFC,DFHDMPCA

SMSVSAM server has been recycled since an earlier request from same UOW

AFCU DFHEIFC,DFHDMPCA

Data set in lost locks state

AFCV DFHEIFC,DFHDMPCA

Request against file in RLS mode unable to acquire record lock

AFCW DFHEIFC,DFHDMPCA

FC request against file in RLS mode would cause deadlock

AFCY DFHDMPCA,DFHEIFC

Transaction purged during file request

AFCZ DFHDMPCA,DFHEIFC

Irrecoverable error response from DFHFCFR to its caller

AFC0 DFHEIFC,DFHDMPCA

Updating file after file control restart failed

AFC2 DFHFCU Disastrous error from DFHFCFS on open file request

Chapter 13. Transaction abend codes 393

Abend Module Explanation

AFC7 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 - coupling facility 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, DFHEIIC Task purged before request to SM domain completed successfullyAICJ 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 domainAICQ DFHDFST DFHDFST is executing at a terminal which is not permitted.AICS DFHDFST DFHDFST has encountered an error during Retrieve processing.AICT DFHDFST DFHDFST has encountered an error during START processing.AICR DFHCRR Failure of DFHTC write request for IRCAINA DFHINDT Application program failed to pass commarea containing request to be executed on

LINK commandAINB DFHINDT Commarea passed did not contain valid request to be executedAINC DFHINDT,

DFHINDAPINQUIRE EXITPROGRAM failed with NOTAUTH response

AIND DFHINDT,DFHINDAP

INQUIRE EXITPROGRAM failed with unexpected response

AINE DFHINDT Error on START_LINK_BROWSE commandto RM domainAINF DFHINDT EXCEPTION response on GET_NEXT_LINK call to RM domainAING 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

394 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

AIOD DFJIIOP setIIOPDataFromTSQ method within CICSCommareaMapping detected an errorAIOE DFJIIOP setIIOPDataFromTSQ method within CICSCommareaMapping detected an errorAIOF DFJIIOP setIIOPDataFromTSQ method within CICSCommareaMapping detected an errorAIOG DFJIIOP The main method within CICSMain failed to initialize the ORBAIOH DFJIIOP The main method within CICSMain has received unexpected return code from

ProcessMessageAIOI DFJIIOP setBytes method within CICSCommareaMapping has detected an errorAIOJ DFJIIOP writeIIOPDataToTSQ method within CICSCommareaMapping has detected an errorAIOK DFJIIOP writeIIOPDataToTSQ method within CICSCommareaMapping has detected an errorAIOV DFJIIOP setBytes method within CICSCommareaMapping has detected an errorAIO0 DFHIIOP

DFHIIOPAProgramme chech when IIOP/CORBA call processed

AIO1 DFHIIOPDFHIIOPA

Call to Socket domain failed

AIO2 DFHIIOPDFHIIOPA

IIOP/CORBA data stream contains invalid header or data structure

AIO3 DFHIIOPDFHIIOPA

WRITEQ/READQ TS call detected that queue modified 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 directly from user terminal

AISN DFHCRNP CSNC failed to acquire SUSPEND TOKENAISO DFHCRNP CSNC failed to suspend itselfAISP DFHMIRS Mirror transaction invoked with invalid principal facilityAISQ DFHMIRS EXEC CICS command issued for CPI Communications sessionAISR 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 DFHMIRS

Chapter 13. Transaction abend codes 395

Abend Module Explanation

AIS9 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 a suyncpoint initiated by RRMS occurredAJA0 DFJCICS Invalid Resp code passed to SetAbendForCondition methodAJCD 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 domainAJCU DFHJCP Purge response from log manager or recovery managerAJ01 DFJCICS Main method of jave environment setup class invoked without argumentAJ02 DFJCICS CICS AbendError caught by the java environment setup class, WrapperAJ03 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 from

AbendException is too longAJMA DFHCJVM Change directory to CICS_HOME failedAJMB DFHAPLJ Call to JVM program disallowed due to previous JVM terminationerrorsAJMC DFHAPLJ CICS JVM interface failed to call user replaceable module DFHJVMATAJM1 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 callAKC3 DFHXCP,

DFHXMAT,DFHXMCL,DFHXMIQ,DFHXMTA

Task has been purged

AKC6 DFHXCP DFHKC SUSPEND did not precede DFHKC RESUME

396 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

AKC8 DFHXCP Unexpected response from call to KE domain for task purgeAKC9 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 building block code used by log manager domain

ALGD DFHLGCM,DFHLGGL,DFHLGJN,DFHLGLD,DFHLGST

Disaster response detected processing building block storage interface code used by logmanager domain

ALGE DFHLGJN Unexpected error while log manager attempted to find jounal model definitionALGF DFHLGGL,

DFHLGJN,DFHLGST

Unexpected error when log manager attempted enqueue/dequeue operation

ALGG DFHLGQC Transaction CSQC issued from a terminalALIA DFHAPLI Insufficient storage to satisfy GETMAIN requestALIB DFHAPLI Insufficient storage to satisfy GETMAIN requestALIC 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

Chapter 13. Transaction abend codes 397

Abend Module Explanation

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. For module list, see CICS Messages and CodesAPCO DFHAPXM GETMAIN of storage for LEVEL 2 trace failed during transaction initializationAPCS 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 determinedAPCY 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)APUF DFHPUP RDO language definition table invalid or missing

398 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

APUG 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 authorityARP2 DFHRPMS The server controller detected internal error during CICS ONC RPC enable processingARP4 DFHRPMS The server controller has performed an exception disable because of an internal errorARP5 DFHRPMS An invalid attempt was made to start the server controllerARP9 DFHRPC01 There was not enough storage for the connection managerARTA 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

invalid USERID.

Chapter 13. Transaction abend codes 399

Abend Module Explanation

ARXA DFHRXUW Error attempting to express interest in RRMS Unit of RecoveryARXB DFHRXUW Error on ADD_LINK call to Recovery Manager domainARXC 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 componentASHR DFHSHRSP Command failed due to a serious failure in a CICS componentASHU 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 codeASQD DFHCRRSY CLS2 transaction could not use transaction manager for input parametersASQE DFHCRRSY The CLS2 transaction requested a warm exchange log names but did not receive a warm

exchange log names replyASQG DFHCRRSY CLS2 transaction failed during receipt of data via MRO sessionASQH DFHCRRSY CLS2 transaction failed during receipt of data via MRO sessionASQI DFHCRRSY Attempt to invoke CICS recovery manager to save logname failedASQK DFHCRRSY CICS internal logic errorASQL DFHCRRSY Invocation of TERMINATE_RECOVERY command to unlock data failedASQM DFHCRRSY CICS internal logic error

400 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

ASRA 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 ZCP function 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

Messages and CodesATCI DFHZSUP

DFHMRXMDFH62XM

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 automatic logging

ATCN DFHZSUPDFH62XMDFHTFXM

Error during automatic journaling or automatic logging

ATCO DFHZARQ Function unsupported by terminal or systemATCQ DFHZRAQ Temporary storage errorATCR DFHZRAR Temporary storage errorATCS DFHZARQ Send data after request change direction receivedATCT DFHZSUP

DFHMRXMDFH62XM

Build of surrogate TCTTE for remotely-owned terminal failed

ATCU DFHZARQ Send in receive modeATCV DFHETL,

DFHZARQ,DFHZISP

Application attempted operation on logical unit which failed

ATCW DFHZSUPDFHMRXMDFH62XM

No installed profile definition for LU6.1 or APPC session

ATCX DFHxxx Error on call to SM domain For module list,see CICS Messages and CodesATCY 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 bytes

Chapter 13. Transaction abend codes 401

Abend Module Explanation

ATC7 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 NACPATNC DFHZARQ TC request made after abend ATCHATND DFHZARQ,

DFHZARL,DFHZSUP

Task termination postponed

ATNI DFHZARL,DFHZARM,DFHZARQ,DFHZRAQ,DFHZSUP

Task terminated by NEP (VTAM) or TEP (non-VTAM)

ATOA DFHCESC Invalid attempt to invoke CESC with terminal as principal facilityATOB DFHCESC Abnormal response from EXEC CICS START TRANSACTION(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 SM domain 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, DFHTSPTask 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 queue already deleted in the same unit ofwork

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

AUEP DFHUEH User exit program sent return code UERCPURG to user exit handlerAUXA CAUCAFB1 Unexpected error when one of TAU Detector exit programs called CAUTABM

402 CICS TS for OS/390: CICS User’s Handbook

|||

Abend Module Explanation

AUXB CAUCAFF3,CAUCAFF6,CAUCAFB1

The TAU Detector dataspace has filled up

AUYA CAUCAFB1 The TAU Detector transaction (CAFB) received unrecognized requestAUYC CAUCAFB1 The TAU Detector transaction (CAFB) received unexpected replyAUYE CAUCAFB2,

CAUCAFF3The TAU Detector program found an invalid affinity file number

AUYF CAUCAFB1 The TAU Detector transaction (CAFB) not started by CAFFAUYG CAUCAFB1 The TAU Detector transaction (CAFB) still running at CICS terminationAUYH CAUCAFF4,

CAUCAFF5,CAUCAFB1

The TAU Detector program found invalid address in Detector GWA

AUYI CAUCAFB2,CAUCAFF6

The TAU Detector transaction (CAFB of CAFB) had unexpected 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 an EXEC CICS command

AUZB CAUCAFF1, toCAUCAFF6,CAUCAFB1,CAUCAFB2

Unexpected error when CAFF or CAFB issued a VSAM 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 of CICS system

AUZF CAUCAFF1, toCAUCAFF6,CAUCAFB1

Unexpected error when CAFF or CAFB issued a Detector user exit

AUZH CAUCAFF3 Unexpected error when CAFF called CAUTABM to create MVS dataspaceAUZI CAUCAFF3,

CAUCAFF6Unexpected error when CAFF called CAUTABM to create affinity table

AUZJ CAUCAFF3 Unexpected error when CAFF called CAUTABM to add element to tableAUZK CAUCAFF3 Unexpected error when CAFF attempted to initialize internal trace tableAUZL CAUCAFF4 Unexpected error when CAFF attempted to release internal trace tableAUZN CAUCAFF4 Unexpected error when CAFF called CAUTABM to destroy dataspaceAUZO CAUCAFF6 Unexpected error when CAFF called CAUTABM to destroy tableAUZQ CAUCAFF3 Unexpected error when CAFF CAUCAFP to create MVS CPOOL storageAUZR CAUCAFF4,

CAUCAFF5,CAUCAFB1

Unexpected error when CAFF or CAFB called CAUCAFP to access storage

AUZS CAUCAFF4 Unexpected error when CAFF called CAUCAFP to destroy MVS CPOOL storageAUZU CAUCAFF1 Unexpected error when CAFF calculated occupancy of dataspace occupiedAUZV CAUCAFF1 Incorrect method of initiating TAU Detector transaction CAFFAUZY CAUCAFF3,

CAUCAFB2Unexpected error when CAFF or CAFB called CAUTABM to replace element

AUZZ CAUCAFF3,CAUCAFF6

Unexpected error when CAFF called subroutine to update 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 utility program

Chapter 13. Transaction abend codes 403

Abend Module Explanation

AWBE DFHWBBLI Converter program attempted to change response area addressAWBF 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 detected error in parameter list

AWBR DFHWBA1,DFHWBBLI

Web Business Logic Interface program detected a logic error

AWBU DFHWBC01 Web Interface connection manager could not get storageAWBV DFHWBC04 Web Interface connection manager detected error response on EXEC CICS DEQAWBX DFHWBC01 Web Interface connection manager started against invalid terminal typeAWBZ DFHWBC0B Web Interface connection manager detected NOTAUTH response to EXEC CICS

EXTRACT EXITAWB2 DFHWBXN Web Interface error in server controller attemting to disableAWB3 DFHWBXN Web Interface error trying to determine how server controller was startedAWB4 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 dataAWC7 DFHWBXM Web attach processing DFHWBXM could not proceed with the attach for a Web alias

transaction due to a security errorAWC8 DFHWBXM Web attach processing DFHWBXM could not proceed with the attach for a Web alias

transaction due to an unexpected errorAWKY 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 32767

404 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

AXFS DFHXFP Maximum length of I/O area exceeds 65535AXFT 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

and CodesAXMB DFHxxx Error releasing a lock in transaction manager domain For module list,see CICS Messages

and CodesAXMC DFHXMAT,

DFHXMXESevere error allocating unique transaction number to a 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 dataAXTM DFHXTP Wrong sync level for message—protected transactionAXTN DFHETL Application buffer chained off TCTTE (offest TCTERCSA) has corrupted headerAXTO 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 processing

Chapter 13. Transaction abend codes 405

Abend Module Explanation

AZCC DFHZARM Unsupported function management dataAZCD DFHETL,

DFHZARMDFHZARM invalid data length received

AZCE DFHETL,DFHZARM

Application data length to be received exceeds allowable limits

AZCF DFHZARM Invalid request to DFHZARLAZCG DFHZARM Invalid TCTTEAZCH DFHETL,

DFHZARMUnexpected sense code X’0889xxxx’ received while processing APPC mapped data

AZCI DFHETL,DFHZARM,DFHZARQ

Invalid sync level

AZCJ DFHZARM System does not support APPC structured field with null dataAZCK DFHZARM Internal logic error in error recovery for APPC mapped processingAZCL DFHZARM Sense code X’088901xx’ received during APPC mapped processingAZCM 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 terminalAZCP DFHZSUP

DFH62XMLogic error in ZCP

AZCQ DFHZSUPDFHMRXMDFH62XM

Error on call to RM domain

AZCR DFHZARL Error during APPC SYNCPOINT ROLLBACK requestAZCT 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

406 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

AZRM DFHZARR DFHZARR called one of its own routines at wrong timeAZRN DFHZARRF DFHLUC parameter list does not have LUCCIERR set onAZRO 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 connectionAZTU 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 another taskAZVA DFHZATS Time-out while waiting for service transaction CITS to complete

Chapter 13. Transaction abend codes 407

Abend Module Explanation

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 failedAZXA DFHZXCU Catch-up program finds unexpected error, reason code 5AZXB DFHZXCU Catch-up program finds unexpected error, reason code 4DHxx DFH***** EXEC DL/I error or invalid status code (xx)0100 DFHEAP

DFHECPDFHEDP DFHEPP

Translator error opening listing data set

0101 DFHEAPDFHECPDFHEDP DFHEPP

Translator program check

0211 DFHPD DFHPDX Recursive program check in system dump0212 DFHPD DFHPDX Too many program checks in system dump0300 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 DFHXCPRH

408 CICS TS for OS/390: CICS User’s Handbook

Abend Module Explanation

0406 DFHXCPRH Failure of CICS SVC call during EXCI initialization0407 DFHXCPRH CICS SVC at the wrong level for EXCI0408 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRH for working storage0409 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRH for SSI VERIFY0410 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRH for XCUSER block0411 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 drive LanguageEnvironment recovery

Chapter 13. Transaction abend codes 409

410 CICS TS for OS/390: CICS User’s Handbook

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 Application ProgramDebugging Guide, SC26-4049.

© Copyright IBM Corp. 1989, 2000 411

412 CICS TS for OS/390: CICS User’s Handbook

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 the DFHZNACCOMMAREA (DFHNEPCA) at label TWAEC.

For those error codes that have CICS messages associated with them, you shouldsee the CICS Messages and Codes for descriptions of the corresponding errorconditions.

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 AOS X’C1’ TCZSRCATDFHZC2401 2 3 9 10 11 24

OUTSERVX’B1’ TCZRPLAC

DFHZC2402 3 11 X’B4’ TCZRSNEDFHZC2403 2 5 18 24 X’11’ TCZSRCBFDFHZC2404 X’E6’ TCZDMLGDFHZC2404 2 3 9 10 11 24 AOS X’14’ TCZLRCERDFHZC2404 2 3 9 10 11 24 AOS X’18’ TCZLRCNRDFHZC2405 18 X’10’ TCZSRCTUDFHZC2406 9 10 11 18 X’19’ TCZSRCTSDFHZC2407 2 3 9 10 11 24 X’15’ TCZSRCPFDFHZC2408 2 3 9 10 11 18 24 X’1A’ TCZSRCVEDFHZC2408 2 3 9 10 11 18 24 X’1E’ TCZSRCV2DFHZC2409 2 3 9 10 11 15 24 X’D0’ TCZTXCSDFHZC2410 2 3 9 10 11 18 24 X’D1’ TCZTXCUDFHZC2411 X’E0’ TCZDMSNDFHZC2412 X’E1’ TCZDMRADFHZC2413 2 X’E2’ TCZDMCLDFHZC2414 X’80’ TCZSRCSP

© Copyright IBM Corp. 1989, 2000 413

CICS message Action flags set Error code Symbolic label

DFHZC2416 18 24 X’13’ TCZSRCVHDFHZC2417 2 24 X’1D’ TCZSRCVIDFHZC2417 X’20’ TCZVTAMIDFHZC2418 2 3 9 10 11 24 AOS X’BB’ TCZSEXUCDFHZC2419 2 3 9 10 11 24 AOS X’82’ TCZSSXUCDFHZC2420 2 3 9 10 11 24 AOS X’B5’ TCZSAXUCDFHZC2421 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’ TCZSDSE8DFHZC2446 2 3 9 10 11 24 AOS X’84’ TCZSSXIBDFHZC2447 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 24 X’44’ TCZSRCDEDFHZC2457 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 AOS X’88’ TCZLEXCIDFHZC2468 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’ TCZSXC3

VTAM

414 CICS TS for OS/390: CICS User’s Handbook

CICS message Action flags set Error code Symbolic label

DFHZC2471 2 3 10 11 22 24PRTTIOA

X’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 24 X’41’ TCZTOLRQDFHZC2497 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 AOS X’85’ TCZUNEGRDFHZC3410 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’ TCZSBIRVDFHZC3422 2 3 9 10 11 18 24 X’5B’ TCZNSP01DFHZC3424 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 AOS X’9D’ TCZRSPERDFHZC3466 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’ TCZVRDAC

VTAM

Chapter 15. VTAM-associated errors 415

CICS message Action flags set Error code Symbolic label

DFHZC3475 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 24 X’3C’ TCZXUVARDFHZC3489 18 24 X’C8’ TCZLUINHDFHZC3490 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’ TCZLUSKN

VTAM

416 CICS TS for OS/390: CICS User’s Handbook

CICS message Action flags set Error code Symbolic label

DFHZC4941 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’ TCZLUSECDFHZC6590 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

VTAM

Chapter 15. VTAM-associated errors 417

VTAM

418 CICS TS for OS/390: CICS User’s Handbook

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 system sensecodes.

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, 110869 DFHZC3457 2, 9, 10, 1108FF DFHZC3447 2, 3, 9, 10, 11, 241000 DFHZC3494 2, 3, 9, 10, 111001 DFHZC2481 2, 3, 9, 10, 11, 14

© Copyright IBM Corp. 1989, 2000 419

Sensecode

Message Action flags set

1002 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 NoneDFHZC3412 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, 24

420 CICS TS for OS/390: CICS User’s Handbook

Message Sensecode

Action flags set

DFHZC3436 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

Action flag settings and default actions !!!!!These are the default actions generated by DFHZNAC for DFHZNEP. The defaultactions can vary from the actions set, depending on the state of the node at thetime 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

Chapter 16. System sense codes received 421

422 CICS TS for OS/390: CICS User’s Handbook

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 QUEX’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 EXIT

© Copyright IBM Corp. 1989, 2000 423

Hex ID Module Description

X’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

STATEX’57’ ZDST SNA-ASCII TRAN ROUTINEX’58’ ZEV1 ENCRYPTION VALIDATION

1X’59’ ZEV2 ENCRYPTION VALIDATION

2X’5E’ ZXRC XRF TERMINAL RECOVERYX’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 processing

424 CICS TS for OS/390: CICS User’s Handbook

Hex ID Module Description

X’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 425

426 CICS TS for OS/390: CICS User’s Handbook

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 a storageaccounting area (SAA). For these, the storage class value always appears in thefirst byte in the accounting area for a storage element. The value is sometimesmodified when the top bit is set to indicate getmained storage. 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, 2000 427

428 CICS TS for OS/390: CICS User’s Handbook

Sending your comments to IBM

If you especially like or dislike anything about this book, please use one of themethods listed below to send your comments to IBM.

Feel free to comment on what you regard as specific errors or omissions, and onthe accuracy, organization, subject matter, or completeness of this book.

Please limit your comments to the information in this book and the way in whichthe information is presented.

To request additional publications, or to ask questions or make comments aboutthe functions of IBM products or systems, you should talk to your IBMrepresentative or to your IBM authorized remarketer.

When you send comments to IBM, you grant IBM a nonexclusive right to use ordistribute your comments in any way it believes appropriate, without incurringany obligation to you.

You can send your comments to IBM in any of the following ways:v By mail, to this address:

Information Development Department (MP095)IBM United Kingdom LaboratoriesHursley ParkWINCHESTER,HampshireUnited Kingdom

v By fax:– From outside the U.K., after your international access code use

44–1962–870229– From within the U.K., use 01962–870229

v Electronically, use the appropriate network ID:– IBM Mail Exchange: GBIBM2Q9 at IBMMAIL– IBMLink

: HURSLEY(IDRCF)– Internet: [email protected]

Whichever you use, ensure that you include:v The publication number and titlev The topic to which your comment appliesv Your name and address/telephone number/fax number/network ID.

© Copyright IBM Corp. 1989, 2000 429

430 CICS TS for OS/390: CICS User’s Handbook

����

Program Number: 5655-147

Printed in the United States of Americaon recycled paper containing 10%recovered post-consumer fiber.

SX33-6104-33

Spin

ein

form

atio

n:

��

�C

ICS

TS

for

OS/

390

CIC

SU

ser’s

Han

dboo

kR

elea

se3