Note!
Before using this information and the product it supports, be sure to readthe general information under “Notices” on page v.
Third edition (March 1999)
This edition applies to Release 3 of CICS Transaction Server for OS/390,program number 5655-147, and to all subsequent versions, releases, andmodifications until otherwise indicated in new editions. Make sure you are usingthe correct edition for the level of the product.
This edition replaces and makes obsolete the previous edition, SX33-6104-00.The technical changes for this edition are summarized under "Summary ofchanges" and are indicated by a vertical bar to the left of a change.
Order publications through your IBM representative or the IBM branch officeserving your locality. Publications are not stocked at the address given below.
At the back of this publication is a page entitled “Sending your comments toIBM”. If you want to make comments, but the methods described are notavailable to you, please address them to:
IBM United Kingdom Laboratories, Information Development,Mail Point 095, Hursley Park, Winchester, Hampshire, England, SO21 2JN.
When you send information to IBM, you grant IBM a nonexclusive right to useor distribute the information in any way it believes appropriate without incurringany obligation to you.
Copyright International Business Machines Corporation 1989, 1999. Allrights reserved.US Government Users Restricted Rights – Use, duplication or disclosurerestricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vProgramming interface information . . . . . . . . . . . . . . . . . . . . viTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixWhat this handbook is about . . . . . . . . . . . . . . . . . . . . . . . ix
Who this handbook is for . . . . . . . . . . . . . . . . . . . . . . . ixWhat you need to know to understand this handbook . . . . . . . . ix
Handbook structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiiiCICS Transaction Server for OS/390 . . . . . . . . . . . . . . . . . . . xiii
CICS books for CICS Transaction Server for OS/390 . . . . . . . . xiiiCICSPlex SM books for CICS Transaction Server for OS/390 . . . . xvOther CICS books . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Determining if a publication is current . . . . . . . . . . . . . . . . . . xv
Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . xviiChanges made for CICS Transaction Server for OS/390 Release 3 . xviiChanges made for CICS Transaction Server for OS/390 Release 2 . xviiChanges made for CICS/ESA 4.1 edition . . . . . . . . . . . . . . . xvii
Chapter 1. Command-level application programming . . . . . . . . 1General format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Restrictions for distributed program link (DPL) . . . . . . . . . . . . . . 2API command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 2. SPI command syntax . . . . . . . . . . . . . . . . . . . 91
Chapter 3. CICS-Supplied Transaction . . . . . . . . . . . . . . . 167
Chapter 4. Resource definition online . . . . . . . . . . . . . . . 197
Chapter 5. DFHCSDUP commands . . . . . . . . . . . . . . . . . 205
Chapter 6. Front End Programming Interface command reference 211FEPI application programming . . . . . . . . . . . . . . . . . . . . . 211FEPI system programming . . . . . . . . . . . . . . . . . . . . . . . 218
Chapter 7. CICS-value data areas used by all commands . . . . 225CVDAs and numeric values in alphabetic sequence . . . . . . . . . . 225CVDAs and numeric values in numeric sequence . . . . . . . . . . . 233
Copyright IBM Corp. 1989, 1999 iii
CVDA values for the DEVICE option . . . . . . . . . . . . . . . . . . 240
Chapter 8. EXEC interface block (EIB) . . . . . . . . . . . . . . . 243EIB field names and descriptions . . . . . . . . . . . . . . . . . . . 243EIBFN codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244EIBRCODE values . . . . . . . . . . . . . . . . . . . . . . . . . . . 249RESP values and conditions . . . . . . . . . . . . . . . . . . . . . . 254
Chapter 9. RESP2 values and their meanings . . . . . . . . . . . 257
Chapter 10. EXEC interface block (EIB) response and functioncodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
Response codes of EXEC CICS commands . . . . . . . . . . . . . . 397Function codes of EXEC CICS commands . . . . . . . . . . . . . . 399
Chapter 11. DFH messages . . . . . . . . . . . . . . . . . . . . . 407Message Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 407Format of information . . . . . . . . . . . . . . . . . . . . . . . . . . 411MVS user abend codes . . . . . . . . . . . . . . . . . . . . . . . . . 415
Chapter 12. Transaction abend codes . . . . . . . . . . . . . . . 419Format of information . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Chapter 13. Transaction abend codes . . . . . . . . . . . . . . . 421
Chapter 14. 1xxx-9xxx (COBOL II) abend codes . . . . . . . . . . 463
Chapter 15. VTAM-associated errors . . . . . . . . . . . . . . . . 465VTAM terminal error codes and CICS message numbers . . . . . . . 465
Chapter 16. System sense codes received . . . . . . . . . . . . . 471Action flag settings and default actions ˚˚˚˚˚ . . . 474
Chapter 17. VTAM submodule identifiers . . . . . . . . . . . . . . 475
Chapter 18. AP domain storage classes . . . . . . . . . . . . . . 479
Sending your comments to IBM . . . . . . . . . . . . . . . . . . . 481
iv CICS User’s Handbook
Notices
This information was developed for products and services offered in theU.S.A. IBM may not offer the products, services, or features discussed inthis document in other countries. Consult your local IBM representative forinformation on the products and services currently available in your area.Any reference to an IBM product, program, or service is not intended to stateor imply that only that IBM product, program, or service may be used. Anyfunctionally equivalent product, program, or service that does not infringeany IBM intellectual property right may be used instead. However, it is theuser's responsibility to evaluate and verify the operation of any non-IBMproduct, program, or service.
IBM may have patents or pending patent applications covering subjectmatter described in this document. The furnishing of this document does notgive you any license to these patents. You can send license inquiries, inwriting, to:
IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact theIBM Intellectual Property Department in your country or send inquiries, inwriting, to:
IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106, Japan
The following paragraph does not apply in the United Kingdom or anyother country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDESTHIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND,EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. Somestates do not allow disclaimer of express or implied warranties in certaintransactions, therefore this statement may not apply to you.
This publication could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will
Copyright IBM Corp. 1989, 1999 v
be incorporated in new editions of the publication. IBM may makeimprovements and/or changes in the product(s) and/or the program(s)described in this publication at any time without notice.
Licensees of this program who wish to have information about it for thepurpose of enabling: (i) the exchange of information between independentlycreated programs and other programs (including this one) and (ii) the mutualuse of the information which has been exchanged, should contact IBMUnited Kingdom Laboratories, MP151, Hursley Park, Winchester, Hampshire,England, SO21 2JN. Such information may be available, subject toappropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM CustomerAgreement, IBM International Programming License Agreement, or anyequivalent agreement between us.
Programming interface informationThis book is intended to help you refer quickly to CICS systemadministration and operating information.
This book also documents General-use Programming Interface andAssociated Guidance Information, Product-sensitive Programming Interfaceand Associated Guidance Information, and Diagnosis, Modification or TuningInformation provided by CICS.
General-use programming interfaces allow the customer to write programsthat obtain the services of CICS.
General-use Programming Interface and Associated Guidance Information isidentified where it occurs, by an introductory statement to a chapter orsection.
Product-sensitive programming interfaces allow the customer installation toperform tasks such as diagnosing, modifying, monitoring, repairing, tailoring,or tuning of CICS. Use of such interfaces creates dependencies on thedetailed design or implementation of the IBM software product.Product-sensitive programming interfaces should be used only for thesespecialized purposes. Because of their dependencies on detailed designand implementation, it is to be expected that programs written to suchinterfaces may need to be changed in order to run with new productreleases or versions, or as a result of service.
vi CICS User’s Handbook
Product-sensitive Programming Interface and Associated GuidanceInformation is identified where it occurs, by an introductory statement to achapter or section.
Diagnosis, Modification or Tuning Information is provided to help youdiagnose problems in a CICS system.
Attention: Do not use this Diagnosis, Modification or Tuning Information asa programming interface.
Diagnosis, Modification or Tuning Information is identified where it occurs, byan introductory statement to a chapter or section.
TrademarksThe following terms are trademarks of International Business MachinesCorporation in the United States, or other countries, or both:
Other company, product, and service names may be trademarks or servicemarks of others.
ACF/VTAMCICSCICS OS/2CICS/ESA
CICS/MVSCICS/VSEC/370DB2IBMIBMLink
MVS/ESARACFVSE/ESAVTAM
Notices vii
Preface
What this handbook is aboutThis book helps you refer quickly to topics you are already familiar with. Itprovides a summary of information contained elsewhere in the CICS library.
Who this handbook is forThis book is for:
� System programmers� CICS or system operators
� Application programmers.
What you need to know to understand this handbookYou need to have a good understanding of how CICS works. This assumesfamiliarity with most, if not all, of the books in the CICS library, together withadequate practical experience of running a CICS system.
Copyright IBM Corp. 1989, 1999 ix
Handbook structureChapter 1, “Command-level application programming” on page 1
Gives a summary of command-level application programming commands inCICS Transaction Server for OS/390. For programming information, see theCICS Application Programming Reference.
Chapter 2, “SPI command syntax” on page 91
Gives a summary of command-level system programming commands. Forprogramming information, see the CICS System Programming Referencemanual.
Chapter 3, “CICS-Supplied Transaction” on page 167
Gives a summary of the CICS-supplied transactions. For more detailedinformation, see the CICS Supplied Transactions.
Chapter 4, “Resource definition online” on page 197
Gives a summary of the syntax for resource definition online. For moredetailed information, see the CICS Resource Definition Guide.
Chapter 6, “Front End Programming Interface command reference” onpage 211
Gives a summary of the syntax for front end programming interfacecommand references. For more detailed information, see the CICS FrontEnd Programming Interface User's Guide.
Chapter 7, “CICS-value data areas used by all commands” onpage 225
Gives a table of CVDA values. For programming information, see the CICSSystem Programming Reference manual.
Chapter 8, “EXEC interface block (EIB)” on page 243
Gives information about EIB fields, and gives the meanings of EIBFN,EIBRCODE, RESP, and RESP2 values. For programming information, seethe CICS Application Programming Reference.
Chapter 10, “EXEC interface block (EIB) response and function codes”on page 397
x CICS User’s Handbook
Gives information about EIB response and function codes. For more detailedinformation, see the CICS System Programming Reference and the CICSProblem Determination Guide.
Chapter 11, “DFH messages” on page 407
Gives a summary of the terminal error messages and codes. For moredetailed information, see the CICS Messages and Codes.
Chapter 12, “Transaction abend codes” on page 419
Gives a summary of CICS transaction abend codes. For more detailedinformation, see the CICS Messages and Codes.
Chapter 15, “VTAM-associated errors” on page 465
Gives a summary of VTAM errors and associated CICS messages. For moredetailed information, see the CICS Messages and Codes.
Chapter 17, “VTAM submodule identifiers” on page 475
Gives information about the product-sensitive product interface.
Chapter 18, “AP domain storage classes” on page 479
Shows the valid AP domain storage classes.
Preface xi
Bibliography
CICS Transaction Server for OS/390CICS Transaction Server for OS/390: Planning for Installation GC33-1789CICS Transaction Server for OS/390 Release Guide GC34-5352CICS Transaction Server for OS/390 Migration Guide GC34-5353CICS Transaction Server for OS/390 Installation Guide GC33-1681CICS Transaction Server for OS/390 Program Directory GI10-2506CICS Transaction Server for OS/390 Licensed ProgramSpecification
GC33-1707
CICS books for CICS Transaction Server for OS/390
Copyright IBM Corp. 1989, 1999 xiii
GeneralCICS Master Index SC33-1704CICS User's Handbook SX33-6104CICS Transaction Server for OS/390 Glossary (softcopy only) GC33-1705
AdministrationCICS System Definition Guide SC33-1682CICS Customization Guide SC33-1683CICS Resource Definition Guide SC33-1684CICS Operations and Utilities Guide SC33-1685CICS Supplied Transactions SC33-1686
ProgrammingCICS Application Programming Guide SC33-1687CICS Application Programming Reference SC33-1688CICS System Programming Reference SC33-1689CICS Front End Programming Interface User's Guide SC33-1692CICS C++ OO Class Libraries SC34-5455CICS Distributed Transaction Programming Guide SC33-1691CICS Business Transaction Services SC34-5268
DiagnosisCICS Problem Determination Guide GC33-1693CICS Messages and Codes GC33-1694CICS Diagnosis Reference LY33-6088CICS Data Areas LY33-6089CICS Trace Entries SC34-5446CICS Supplementary Data Areas LY33-6090
CommunicationCICS Intercommunication Guide SC33-1695CICS Family: Interproduct Communication SC33-0824CICS Family: Communicating from CICS on System/390 SC33-1697CICS External Interfaces Guide SC33-1944CICS Internet Guide SC34-5445
Special topicsCICS Recovery and Restart Guide SC33-1698CICS Performance Guide SC33-1699CICS IMS Database Control Guide SC33-1700CICS RACF Security Guide SC33-1701CICS Shared Data Tables Guide SC33-1702CICS Transaction Affinities Utility Guide SC33-1777CICS DB2 Guide SC33-1939
xiv CICS User’s Handbook
CICSPlex SM books for CICS Transaction Server forOS/390General
CICSPlex SM Master Index SC33-1812CICSPlex SM Concepts and Planning GC33-0786CICSPlex SM User Interface Guide SC33-0788CICSPlex SM View Commands Reference Summary SX33-6099
Administration and ManagementCICSPlex SM Administration SC34-5401CICSPlex SM Operations Views Reference SC33-0789CICSPlex SM Monitor Views Reference SC34-5402CICSPlex SM Managing Workloads SC33-1807CICSPlex SM Managing Resource Usage SC33-1808CICSPlex SM Managing Business Applications SC33-1809
ProgrammingCICSPlex SM Application Programming Guide SC34-5457CICSPlex SM Application Programming Reference SC34-5458
DiagnosisCICSPlex SM Resource Tables Reference SC33-1220CICSPlex SM Messages and Codes GC33-0790CICSPlex SM Problem Determination GC33-0791
Other CICS books
If you have any questions about the CICS Transaction Server for OS/390library, see CICS Transaction Server for OS/390: Planning for Installationwhich discusses both hardcopy and softcopy books and the ways that thebooks can be ordered.
CICS Application Programming Primer (VS COBOL II) SC33-0674CICS Application Migration Aid Guide SC33-0768CICS Family: API Structure SC33-1007CICS Family: Client/Server Programming SC33-1435CICS Family: General Information GC33-0155CICS 4.1 Sample Applications Guide SC33-1173CICS/ESA 3.3 XRF Guide SC33-0661
Determining if a publication is currentIBM regularly updates its publications with new and changed information.When first published, both hardcopy and BookManager softcopy versions ofa publication are usually in step. However, due to the time required to printand distribute hardcopy books, the BookManager version is more likely tohave had last-minute changes made to it before publication.
Bibliography xv
Subsequent updates will probably be available in softcopy before they areavailable in hardcopy. This means that at any time from the availability of arelease, softcopy versions should be regarded as the most up-to-date.
For CICS Transaction Server books, these softcopy updates appearregularly on the Transaction Processing and Data Collection Kit CD-ROM,SK2T-0730-xx. Each reissue of the collection kit is indicated by an updatedorder number suffix (the -xx part). For example, collection kit SK2T-0730-06is more up-to-date than SK2T-0730-05. The collection kit is also clearlydated on the cover.
Updates to the softcopy are clearly marked by revision codes (usually a “#”character) to the left of the changes.
xvi CICS User’s Handbook
''
Summary of changes
Changes made for CICS Transaction Server for OS/390Release 3Trace entries have been moved to the Trace Entries manual SC34-5446-02.
Changes made for CICS Transaction Server for OS/390Release 2This handbook includes information about the new or enhanced facilitiesintroduced by CICS Transaction Server for OS/390 Release 3.
VTAM terminal error codes are now shown in CICS message order.
Tables of CVDA values are now shown in hexadecimal and decimal format.
Changes made for CICS/ESA 4.1 editionThe commands for application programming and system programming areshown in alphabetic order.
In the section Chapter 7, “CICS-value data areas used by all commands” onpage 225, tables of CVDA values have been added.
Syntax boxes for EXEC CICS commands are replaced with “railroad”diagrams. For an explanation of these diagrams, see the CICS ApplicationProgramming Reference manual.
Trace has been removed from this handbook and has been moved into theCICS Diagnosis Reference manual.
Front end programming interface (FEPI) commands have been added.
Copyright IBM Corp. 1989, 1999 xvii
Application Programming
Chapter 1. Command-level application programming
This chapter contains General-use Programming Interface information.
General formatThe format of a CICS command, which can be coded in a COBOL, C/370,PL/I, or assembler application program, is as follows:
COBOL:
EXEC CICS function[option[(arg)]]... END-EXEC
C:
EXEC CICS function[option[(arg)]]... ;
PL/I:
EXEC CICS function[option[(arg)]]... ;
Assembler:
EXEC CICS function[option[(arg)]]...
DL/I command formatThe format of a DL/I command, which can be coded only in a COBOL,C/370, or PL/I application program, is as follows:
EXEC DLI function[option[(arg)]]...
For multiple segment commands, options are repeated for each segment.
RPG II command formatThe format of a CICS command in an RPG II application program consists ofan EXEC statement, followed optionally by one or more ELEM statements,coded on an RPG calculation specification form (the C-spec).
Copyright IBM Corp. 1989, 1999 1
Application Programming
Restrictions for distributed program link (DPL)The following commands are not supported in a program running in aresource region in response to a distributed program link command:
Table 1. Restricted API commands
ADDRESS ....ALLOCATEASSIGN ....CONNECT PROCESSCONVERSEEXTRACT PROCESSFREE CONVIDHANDLE AID
ISSUE ....PURGE MESSAGERECEIVE ....ROUTESEND ....SIGNOFFSIGNONWAIT TERMINAL
2 CICS User’s Handbook
API syntax
API command syntax
ABEND
55─ ──ABEND ──┬ ┬────────────── ── ──┬ ┬──────── ── ──┬ ┬──────── ─5%└ ┘──ABCODE(name) └ ┘─CANCEL─ └ ┘─NODUMP─
ADDRESS
55─ ──ADDRESS ──┬ ┬─────────────── ──┬ ┬─────────────────── ──┬ ┬────────────── ───5└ ┘──ACEE(ptr-ref) └ ┘──COMMAREA(ptr-ref) └ ┘──CWA(ptr-ref)
5─ ──┬ ┬────────────── ──┬ ┬──────────────── ──┬ ┬────────────── ─5%└ ┘──EIB(ptr-ref) └ ┘──TCTUA(ptr-ref) └ ┘──TWA(ptr-ref)
ADDRESS SET
55─ ──ADDRESS ──┬ ┬──SET(data-area) ──USING(ptr-ref) ─5% └ ┘──SET(ptr-ref) ──USING(data-area)
ALLOCATE (APPC)
55─ ──ALLOCATE ──┬ ┬──SYSID(systemname) ──┬ ┬─────────────── ──┬ ┬───────── ───────5│ │└ ┘──PROFILE(name) └ ┘ ─NOQUEUE─└ ┘──PARTNER(name) ───────────────────────
5─ ──┬ ┬───────────── ─5%└ ┘──STATE(cvda)
Conditions: CBIDERR, INVREQ, NETNAMEIDERR, PARTNERIDERR,SYSBUSY, SYSIDERR
Chapter 1. Command-level application programming 3
API syntax
ALLOCATE (LUTYPE6.1)
55─ ──ALLOCATE ──┬ ┬──SESSION(name) ──── ──┬ ┬─────────────── ──┬ ┬───────── ─5%└ ┘──SYSID(systemname) └ ┘──PROFILE(name) └ ┘ ─NOQUEUE─
Conditions: CBIDERR, EOC, INVREQ, SESSBUSY, SESSIONERR,SYSBUSY, SYSIDERR
ALLOCATE (MRO)
55─ ──ALLOCATE ──SYSID(systemname) ──┬ ┬───────── ──┬ ┬───────────── ─5% └ ┘─NOQUEUE─ └ ┘──STATE(cvda)
Conditions: INVREQ, SYSBUSY, SYSIDERR
ASKTIME
55─ ──ASKTIME ──┬ ┬──────────────────── ─5%└ ┘──ABSTIME(data-area)
4 CICS User’s Handbook
API syntax
ASSIGN
┌ ┐───────────────────────────── ┌ ┐─────────────────────────────55─ ──ASSIGN ───
6┴┬ ┬───────────────────────── ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──ABCODE(data-area) ────── ├ ┤──MAPWIDTH(data-area) ────├ ┤──ABDUMP(data-area) ────── ├ ┤──MSRCONTROL(data-area) ──├ ┤──ABPROGRAM(data-area) ─── ├ ┤──NATLANGINUSE(data-area)
| ├ ┤──ACTIVITY(data-area) ──── ├ ┤──NETNAME(data-area) ─────| ├ ┤──ACTIVITYID(data-area) ── ├ ┤──NEXTTRANSID(data-area) ─
├ ┤──ALTSCRNHT(data-area) ─── ├ ┤──NUMTAB(data-area) ──────├ ┤──ALTSCRNWD(data-area) ─── ├ ┤──OPCLASS(data-area) ─────├ ┤──APLKYBD(data-area) ───── ├ ┤──OPERKEYS(data-area) ────├ ┤──APLTEXT(data-area) ───── ├ ┤──OPID(data-area) ────────├ ┤──APPLID(data-area) ────── ├ ┤──OPSECURITY(data-area) ──├ ┤──ASRAINTRPT(data-area) ── ├ ┤──ORGABCODE(data-area) ───
? ├ ┤──ASRAKEY(cvda) ────────── ├ ┤──OUTLINE(data-area) ─────├ ┤──ASRAPSW(data-area) ───── ├ ┤──PAGENUM(data-area) ─────├ ┤──ASRAREGS(data-area) ──── ├ ┤──PARTNPAGE(data-area) ───├ ┤──ASRASPC(cvda) ────────── ├ ┤──PARTNS(data-area) ──────
? ├ ┤──ASRASTG(cvda) ────────── ├ ┤──PARTNSET(data-area) ────├ ┤──BRIDGE(data-area) ────── ├ ┤──PRINSYSID(data-area) ───
| ├ ┤──BTRANS(data-area) ────── ├ ┤──PROCESS(data-area) ─────| ├ ┤──CMDSEC(data-area) ────── ├ ┤──PROCESSTYPE(data-area) ─
├ ┤──COLOR(data-area) ─────── ├ ┤──PROGRAM(data-area) ─────├ ┤──CWALENG(data-area) ───── ├ ┤──PS(data-area) ──────────├ ┤──DEFSCRNHT(data-area) ─── ├ ┤──QNAME(data-area) ───────├ ┤──DEFSCRNWD(data-area) ─── ├ ┤──RESSEC(data-area) ──────├ ┤──DELIMITER(data-area) ─── ├ ┤──RESTART(data-area) ─────├ ┤──DESTCOUNT(data-area) ─── ├ ┤──RETURNPROG(data-area) ──├ ┤──DESTID(data-area) ────── ├ ┤──SCRNHT(data-area) ──────├ ┤──DESTIDLENG(data-area) ── ├ ┤──SCRNWD(data-area) ──────├ ┤──DSSCS(data-area) ─────── ├ ┤──SIGDATA(data-area) ─────├ ┤──DS327ð(data-area) ────── ├ ┤──SOSI(data-area) ────────├ ┤──EWASUPP(data-area) ───── ├ ┤──STARTCODE(data-area) ───├ ┤──EXTDS(data-area) ─────── ├ ┤──STATIONID(data-area) ───├ ┤──FACILITY(data-area) ──── ├ ┤──SYSID(data-area) ───────├ ┤──FCI(data-area) ───────── ├ ┤──TASKPRIORITY(data-area)├ ┤──GCHARS(data-area) ────── ├ ┤──TCTUALENG(data-area) ───├ ┤──GCODES(data-area) ────── ├ ┤──TELLERID(data-area) ────├ ┤──GMMI(data-area) ──────── ├ ┤──TERMCODE(data-area) ────├ ┤──HILIGHT(data-area) ───── ├ ┤──TERMPRIORITY(data-area)
? ├ ┤──INITPARM(data-area) ──── ├ ┤──TEXTKYBD(data-area) ────? ├ ┤──INITPARMLEN(data-area) ─ ├ ┤──TEXTPRINT(data-area) ───
├ ┤──INPARTN(data-area) ───── ├ ┤──TRANPRIORITY(data-area)├ ┤──INVOKINGPROG(data-area) ├ ┤──TWALENG(data-area) ─────├ ┤──KATAKANA(data-area) ──── ├ ┤──UNATTEND(data-area) ────
? ├ ┤──LANGINUSE(data-area) ─── ├ ┤──USERID(data-area) ──────├ ┤──LDCMNEM(data-area) ───── ├ ┤──USERNAME(data-area) ────├ ┤──LDCNUM(data-area) ────── ├ ┤──USERPRIORITY(data-area)├ ┤──MAPCOLUMN(data-area) ─── └ ┘──VALIDATION(data-area) ──├ ┤──MAPHEIGHT(data-area) ───└ ┘──MAPLINE(data-area) ─────
Condition: INVREQ
Chapter 1. Command-level application programming 5
API syntax
BIF DEEDIT
55─ ──BIF DEEDIT ──FIELD(data-area) ──┬ ┬──────────────────── ─5%└ ┘──LENGTH(data-value)
Condition: LENGERR
BUILD ATTACH (LUTYPE6.1)
55─ ──BUILD ATTACH ──ATTACHID(name) ──┬ ┬─────────────── ──┬ ┬──────────────── ───5└ ┘──PROCESS(name) └ ┘──RESOURCE(name)
5─ ──┬ ┬──────────────── ──┬ ┬───────────────── ──┬ ┬───────────── ───────────────5└ ┘──RPROCESS(name) └ ┘──RRESOURCE(name) └ ┘──QUEUE(name)
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──IUTYPE(data-value) └ ┘──DATASTR(data-value)
5─ ──┬ ┬─────────────────── ─5%└ ┘──RECFM(data-value)
BUILD ATTACH (MRO)
55─ ──BUILD ATTACH ──ATTACHID(name) ──┬ ┬─────────────── ──┬ ┬──────────────── ───5└ ┘──PROCESS(name) └ ┘──RESOURCE(name)
5─ ──┬ ┬──────────────── ──┬ ┬───────────────── ──┬ ┬───────────── ───────────────5└ ┘──RPROCESS(name) └ ┘──RRESOURCE(name) └ ┘──QUEUE(name)
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──IUTYPE(data-value) └ ┘──DATASTR(data-value)
5─ ──┬ ┬─────────────────── ─5%└ ┘──RECFM(data-value)
CANCEL
55─ ──CANCEL ──┬ ┬─────────────────────────────────────────────────────── ─5% └ ┘──REQID(name) ──┬ ┬─────────────────── ──┬ ┬───────────────
└ ┘──SYSID(systemname) └ ┘──TRANSID(name)
Conditions: ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR
6 CICS User’s Handbook
API syntax
CHANGE PASSWORD
55─ ──CHANGE PASSWORD(data-value) ──NEWPASSWORD(data-value) ──────────────────5
5─ ──USERID(data-value) ──┬ ┬────────────────────── ──┬ ┬──────────────────── ─5%└ ┘──ESMREASON(data-area) └ ┘──ESMRESP(data-area)
Conditions: INVREQ, NOTAUTH, USERIDERR
CHANGE TASK
55─ ──CHANGE TASK ──┬ ┬────────────────────── ─5%└ ┘──PRIORITY(data-value)
Condition: INVREQ
CONNECT PROCESS (APPC)
55─ ──CONNECT PROCESS ──┬ ┬──CONVID(name) ─ ────────────────────────────────────5└ ┘──SESSION(name)
5─ ──┬ ┬──PROCNAME(data-area) ──┬ ┬──────────────────────── ────────────────────5│ │└ ┘──PROCLENGTH(data-value)
? └ ┘──PARTNER(name) ──────────────────────────────────
5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──PIPLIST(data-area) ──┬ ┬───────────────────────
└ ┘──PIPLENGTH(data-value)
5─ ──SYNCLEVEL(data-value) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
? Conditions: INVREQ, LENGERR, NOTALLOC, PARTNERIDERR,TERMERR
Chapter 1. Command-level application programming 7
API syntax
CONVERSE (APPC)
55─ ──CONVERSE ──┬ ┬────────────── ──FROM(data-area) ───────────────────────────5 └ ┘──CONVID(name)
5─ ──┬ ┬──FROMLENGTH(data-value) ─ ──┬ ┬──INTO(data-area) ───────────────────────5└ ┘──FROMFLENGTH(data-value) └ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ───────────────────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─
└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ──┬ ┬───────────── ─5%? └ ┘─NOTRUNCATE─ └ ┘──STATE? (cvda)
Conditions: EOC, INVREQ, LENGERR, NOTALLOC, SIGNAL,TERMERR
CONVERSE (default)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘──DEST(name)└ ┘──MAXFLENGTH(data-value)
Conditions: LENGERR
8 CICS User’s Handbook
API syntax
CONVERSE (LUTYPE2/LUTYPE3)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ────────────────────────────────────────────────────5└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────────────────5 │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────
5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬───────── ────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─DEFRESP─
└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ── ──┬ ┬────── ─5% └ ┘─NOTRUNCATE─ └ ┘─ASIS─
Conditions: EOC, LENGERR, TERMERR
CONVERSE (LUTYPE4)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─
5─ ──┬ ┬──────────────────────── ── ──┬ ┬───── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─FMH─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, IGREQCD, INBFMH, LENGERR, SIGNAL,TERMERR
Chapter 1. Command-level application programming 9
API syntax
CONVERSE (LUTYPE6.1)
55─ ──CONVERSE ──┬ ┬─────────────────────────────────────────────────────── ───5 └ ┘──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ──┬ ┬─────
└ ┘──FROMFLENGTH(data-value) └ ┘─FMH─
5─ ──┬ ┬─────────────── ──┬ ┬──────────────── ──┬ ┬──INTO(data-area) ─────────────5├ ┤──CONVID(name) ─ └ ┘──ATTACHID(name) └ ┘──SET(ptr-ref) ───└ ┘──SESSION(name)
5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ───────────────────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─
└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ── ──┬ ┬───────── ─5% └ ┘─NOTRUNCATE─ └ ┘─DEFRESP─
Conditions: CBIDERR, EOC, INBFMH, LENGERR, NOTALLOC,SIGNAL, TERMERR
CONVERSE (MRO)
55─ ──CONVERSE ──┬ ┬─────────────── ──┬ ┬──────────────── ───────────────────────5├ ┤──CONVID(name) ─ └ ┘──ATTACHID(name)└ ┘──SESSION(name)
5─ ──┬ ┬─────────────────────────────────────────────────────── ──────────────5 └ ┘──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ──┬ ┬─────
└ ┘──FROMFLENGTH(data-value) └ ┘─FMH─
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬───────── ────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─DEFRESP─└ ┘──MAXFLENGTH(data-value)
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE? (cvda)
Conditions: CBIDERR, EOC, INBFMH, LENGERR, NOTALLOC,TERMERR
10 CICS User’s Handbook
API syntax
CONVERSE (SCS)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬───────── ── ──┬ ┬────────── ──────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─DEFRESP─ └ ┘─STRFIELD─└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─
Conditions: LENGERR, TERMERR
CONVERSE (System/3)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──┬ ┬──────────── ───────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘──DEST(name)└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─
Conditions: LENGERR
CONVERSE (System/7)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────── ──────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘──DEST(name)
5─ ── ──┬ ┬────── ── ──┬ ┬─────────── ─5% └ ┘─ASIS─ └ ┘─PSEUDOBIN─
Condition: LENGERR
Chapter 1. Command-level application programming 11
API syntax
CONVERSE (2260)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───────────────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
5─ ──┬ ┬───────────────────── ──┬ ┬────────────────────── ──┬ ┬──────────── ──────5└ ┘──CTLCHAR(data-value) └ ┘──LINEADDR(data-value) └ ┘──DEST(name)
5─ ── ──┬ ┬───────── ─5% └ ┘─LEAVEKB─
Condition: LENGERR
CONVERSE (2741)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘──DEST(name)└ ┘──MAXFLENGTH(data-value)
Conditions: LENGERR, RDATT, WRBRK
12 CICS User’s Handbook
API syntax
CONVERSE (3270 display)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───────────────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
5─ ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────────────────5 │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────
5─ ──┬ ┬──────────── ── ──┬ ┬────── ─5%└ ┘──DEST(name) └ ┘─ASIS─
Condition: LENGERR
CONVERSE (3270 logical)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ────────────────────────────────────────────────────5└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────────────────5 │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────
5─ ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬───────── ────5└ ┘──TOFLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─DEFRESP─
└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ── ──┬ ┬────── ─5% └ ┘─NOTRUNCATE─ └ ┘─ASIS─
Conditions: INVREQ, LENGERR, TERMERR
Chapter 1. Command-level application programming 13
API syntax
CONVERSE (3600 BTAM)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)
Condition: LENGERR
CONVERSE (3600-3601)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──┬ ┬─────────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) ├ ┤──LDC(name)
└ ┘─FMH───────
5─ ── ──┬ ┬───────── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─DEFRESP─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, LENGERR, SIGNAL, TERMERR
CONVERSE (3600-3614)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: LENGERR, TERMERR
14 CICS User’s Handbook
API syntax
CONVERSE (3650 interpreter)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─
5─ ── ──┬ ┬───── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─FMH─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, LENGERR, TERMERR
CONVERSE (3650-3270)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬───────────────────── ──┬ ┬────────────────────── ── ──┬ ┬───────── ───────5└ ┘──CTLCHAR(data-value) └ ┘ ─ERASE─ ──┬ ┬─────────── └ ┘─DEFRESP─
├ ┤─DEFAULT─── └ ┘─ALTERNATE─
5─ ── ──┬ ┬───── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─FMH─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
Conditions: LENGERR, TERMERR
CONVERSE (3650-3653)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, LENGERR, TERMERR
Chapter 1. Command-level application programming 15
API syntax
CONVERSE (3650-3680)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───── ───────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─FMH─
5─ ── ──┬ ┬───────── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─DEFRESP─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
Conditions: LENGERR, TERMERR
CONVERSE (3735)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)
Conditions: EOF, LENGERR
CONVERSE (3740)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ──────────────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area)
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)
Condition: LENGERR
16 CICS User’s Handbook
API syntax
CONVERSE (3767)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, LENGERR, SIGNAL, TERMERR
CONVERSE (3770)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─
5─ ── ──┬ ┬───── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─FMH─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, LENGERR, SIGNAL, TERMERR
CONVERSE (3790 full-function or inquiry)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───── ───────────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─FMH─
5─ ── ──┬ ┬───────── ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘─DEFRESP─ ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, LENGERR, SIGNAL, TERMERR
Chapter 1. Command-level application programming 17
API syntax
CONVERSE (3790 3270-display)
55─ ──CONVERSE ──FROM(data-area) ──┬ ┬──FROMLENGTH(data-value) ─ ────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬──TOLENGTH(data-area) ─ ── ──┬ ┬───────── ───────────5└ ┘──SET(ptr-ref) ─── └ ┘──TOFLENGTH(data-area) └ ┘─DEFRESP─
5─ ──┬ ┬───────────────────── ────────────────────────────────────────────────5└ ┘──CTLCHAR(data-value)
5─ ──┬ ┬────────────────────────────────────────────────────────────────── ─5% └ ┘ ─ERASE─ ──┬ ┬─────────── ──┬ ┬──────────────────────── ──┬ ┬────────────
├ ┤─DEFAULT─── ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘─ALTERNATE─ └ ┘──MAXFLENGTH(data-value)
Conditions: LENGERR, TERMERR
DELAY
┌ ┐──INTERVAL(ð) ─────────────────────55─ ──DELAY ──┼ ┼────────────────────────────────── ──┬ ┬───────────── ─5%
├ ┤ ─ ─INTERVAL(hhmmss) ──────────────── └ ┘──REQID(name)├ ┤──TIME(hhmmss) ────────────────────
│ │┌ ┐───────────────────────── ├ ┤─FOR─ ───
6┴┬ ┬──HOURS(data-value) ── ──
│ │├ ┤──MINUTES(data-value)│ │└ ┘──SECONDS(data-value)
│ │┌ ┐───────────────────────── └ ┘─UNTIL─ ───
6┴┬ ┬──HOURS(data-value) ──
├ ┤──MINUTES(data-value) └ ┘──SECONDS(data-value)
Conditions: EXPIRED, INVREQ
18 CICS User’s Handbook
API syntax
DELETE
55─ ──DELETE ──FILE(filename) ──┬ ┬──────────────────────────────────────── ────5 ├ ┤──TOKEN(data-area) ────────────────────── └ ┘──RIDFLD(data-area) ──┬ ┬─────────────────
└ ┘───┤ keylength ├─
5─ ──┬ ┬─────────────────── ──┬ ┬─────────── ──┬ ┬───── ─5% └ ┘──SYSID(systemname) └ ┘ ─NOSUSPEND─ ├ ┤ ─RBA─ └ ┘ ─RRN─
keylength:├─ ──KEYLENGTH(data-value) ──┬ ┬───────────────────────────────── ─┤ └ ┘ ─GENERIC─ ──┬ ┬──────────────────── └ ┘──NUMREC(data-value)
| Conditions: CHANGED DISABLED, DUPKEY, FILENOTFOUND,ILLOGIC, INVREQ, IOERR, ISCINVREQ, LOADING, LOCKED,NOTAUTH, NOTFND, NOTOPEN, RECORDBUSY, SYSIDERR
DELETEQ TD
55─ ──DELETEQ TD ──QUEUE(name) ──┬ ┬─────────────────── ─5%└ ┘──SYSID(systemname)
Conditions: DISABLED, INVREQ, ISCINVREQ, LOCKED, NOTAUTH,QIDERR, SYSIDERR
DELETEQ TS
55─ ──DELETEQ TS ──┬ ┬──QUEUE(name) ──┬ ┬─────────────────── ─5%└ ┘──QNAME(name) └ ┘──SYSID(systemname)
Conditions: INVREQ, ISCINVREQ, LOCKED, NOTAUTH, QIDERR,SYSIDERR
Chapter 1. Command-level application programming 19
API syntax
DEQ
55─ ──DEQ ──RESOURCE(data-area) ──┬ ┬──────────────────── ──────────────────────5└ ┘──LENGTH(data-value)
? ┌ ┐─UOW───────────────5─ ──┼ ┼─────────────────── ─5%
? ├ ┤──MAXLIFETIME(cvda)? └ ┘─TASK──────────────
Conditions: INVREQ, LENGERR
20 CICS User’s Handbook
API syntax
DFHMDF (1 of 2)
55─ ── ──┬ ┬───── ──DFHMDF ─5% └ ┘─fld─
┌ ┐─,─────────────────────────────────────────5─ ───
6┴┬ ┬───────────────────────────────────────── ───────────────5
├ ┤──POS= ──┬ ┬─number──────── ────────────────│ │└ ┘──(line,column)├ ┤──LENGTH=number ──────────────────────────├ ┤──JUSTIFY=( ──┬ ┬─────── ──┬ ┬────────────── )
│ │├ ┤─LEFT── └ ┘──, ──┬ ┬─BLANK─│ │└ ┘─RIGHT─ └ ┘─ZERO──├ ┤──┬ ┬──INITIAL='char-data' ────── ──────────│ │├ ┤──XINIT=hex-data ───────────│ │└ ┘──GINIT='DBCS-characters'──(1)
├ ┤──ATTRB=(─┤ att1 ├──┤ att2 ├─) ─────────── │ │┌ ┐─DEFAULT─
├ ┤──COLOR= ──┼ ┼───────── ──────────────────── │ │└ ┘─color─── │ │┌ ┐─BASE─
└ ┘──PS= ──┼ ┼────── ────────────────────────── └ ┘─psid─
att1: ┌ ┐─ASKIP────────────├─ ──┼ ┼────────────────── ────────────────────────────────────────┤ ├ ┤─PROT───────────── └ ┘ ─UNPROT─ ──┬ ┬──────
└ ┘──,NUM
att2:├─ ──┬ ┬────────────────────────── ────────────────────────────────┤ │ │┌ ┐─────────── └ ┘──, ──┬ ┬─BRT── ───
6┴┬ ┬───────
├ ┤─NORM─ ├ ┤──,DET ─└ ┘─DRK── ├ ┤──,IC ──
└ ┘──,FSET
Notes:1 DBCS characters start with a shift-out character X'0E' and end with a
shift-in character X'0F'.
Chapter 1. Command-level application programming 21
API syntax
DFHMDF (2 of 2)
┌ ┐─,───────────────────────────────55─ ───
6┴┬ ┬─────────────────────────────── ─5%
│ │┌ ┐─,───────────├ ┤──VALIDN=( ───
6┴┬ ┬─────────── ) ───
│ │├ ┤─MUSTFILL── │ │├ ┤─MUSTENTER─ │ │└ ┘─TRIGGER───
├ ┤──GRPNAME=group-name ───────────├ ┤──OCCURS=number ────────────────├ ┤──PICIN='value' ────────────────├ ┤──PICOUT='value' ───────────────├ ┤──OUTLINE= ──┬ ┬─BOX─────────────
│ ││ │┌ ┐─,─────── │ │└ ┘──( ───
6┴┬ ┬─────── )
│ │├ ┤─LEFT── │ │├ ┤─RIGHT─ │ │├ ┤─OVER── │ │└ ┘─UNDER─ │ │┌ ┐─NO──
├ ┤──SOSI= ──┼ ┼───── ─────────────── │ │└ ┘─YES─ │ │┌ ┐─YES─
├ ┤──TRANSP= ──┼ ┼───── ───────────── │ │└ ┘─NO──
└ ┘──CASE=MIXED ───────────────────
Minimum BMS:
22 CICS User’s Handbook
API syntax
DFHMDI
55─ ──map ──DFHMDI ───────────────────────────────────────────────────────────────5
┌ ┐─,───────────────────────── ┌ ┐─,───────────────────────────────5─ ───
6┴┬ ┬───────────────────────── ───
6┴┬ ┬─────────────────────────────── ─5%
├ ┤──SIZE=(line,column) ───── ├ ┤──PS= ──┬ ┬─BASE─ ────────────────├ ┤──TERM=type ────────────── │ │└ ┘─psid─
│ │┌ ┐─,──────── │ │┌ ┐─,───────────├ ┤──CTRL=( ───
6┴┬ ┬──────── ) ── ├ ┤──VALIDN= ───
6┴┬ ┬─────────── ─────
│ │├ ┤─PRINT── │ │├ ┤─MUSTFILL── │ │├ ┤─length─ │ │├ ┤─MUSTENTER─ │ │├ ┤─FREEKB─ │ │└ ┘─TRIGGER───
│ │├ ┤─ALARM── ├ ┤──COLUMN=number ────────────────│ │└ ┘─FRSET── ├ ┤──LINE=number ──────────────────│ │┌ ┐─NO────── ├ ┤──FIELDS=NO ────────────────────├ ┤──EXTATT= ──┼ ┼───────── ─── │ │┌ ┐─,────────────│ │├ ┤─MAPONLY─ ├ ┤───
6┴MAPATTS=(attr) ─────────────
│ │└ ┘─YES───── │ │┌ ┐─,───────────│ │┌ ┐─DEFAULT─ ├ ┤───
6┴DSATTS=(attr) ──────────────
├ ┤──COLOR= ──┼ ┼───────── ──── ├ ┤──OUTLINE= ──┬ ┬─BOX───────────── │ │└ ┘─color─── │ ││ │┌ ┐─,─────── │ │┌ ┐─NO── │ │└ ┘──( ───
6┴┬ ┬─────── )
├ ┤──CURSLOC= ──┼ ┼───── ────── │ │├ ┤─LEFT── │ │└ ┘─YES─ │ │├ ┤─RIGHT─ │ │┌ ┐─OFF─────── │ │├ ┤─OVER──
└ ┘──HILIGHT= ──┼ ┼─────────── │ │└ ┘─UNDER─ ├ ┤─BLINK───── │ │┌ ┐─NO──
├ ┤─REVERSE─── ├ ┤──SOSI= ──┼ ┼───── ─────────────── └ ┘─UNDERLINE─ │ │└ ┘─YES─ │ │┌ ┐─YES─
├ ┤──TRANSP= ──┼ ┼───── ───────────── │ │└ ┘─NO──
└ ┘──JUSTIFY=BOTTOM ───────────────
Standard BMS:
DFHMDI
┌ ┐─,───────────────────────────────55─ ───
6┴┬ ┬─────────────────────────────── ─5%
├ ┤──PARTN=(name) ──┬ ┬───────────── │ │└ ┘ ─,──ACTIVATE─
├ ┤──OBFMT= ──┬ ┬─YES─ ────────────── │ │└ ┘─NO── │ │┌ ┐─FIELD─
├ ┤──DATA= ──┼ ┼─────── ───────────── │ │└ ┘─BLOCK─ │ │┌ ┐─NO──
├ ┤──TIOAPFX= ──┼ ┼───── ──────────── │ │└ ┘─YES─
└ ┘──FLDSEP= ──┬ ┬─char──────── ─────└ ┘──X'hex-char'
Chapter 1. Command-level application programming 23
API syntax
Full BMS:
DFHMDI
┌ ┐─,─────────────────────55─ ───
6┴┬ ┬───────────────────── ─5%
│ │┌ ┐─SAME───├ ┤──COLUMN= ──┼ ┼────────
│ │├ ┤─number─ │ │└ ┘─NEXT─── │ │┌ ┐─NEXT───
├ ┤──LINE= ──┼ ┼──────── ── │ │├ ┤─number─ │ │└ ┘─SAME───
├ ┤──JUSTIFY=(─┤ jst ├─)├ ┤──HEADER=YES ─────────└ ┘──TRAILER=YES ────────
jst: ┌ ┐─LEFT──├─ ──┼ ┼─────── ──┬ ┬────────────── ─┤ └ ┘─RIGHT─ └ ┘──, ──┬ ┬─FIRST─ └ ┘─LAST──
DFHMDX
55─ ──DFHMDX ──MAPSET= ──┬ ┬─name─ ──┬ ┬────────────── ──,MAP= ──┬ ┬─name─ ──────────5└ ┘─\──── └ ┘──,MODULE=name └ ┘─\────
5─ ──┬ ┬─────────────────────────────────────────── ──────────────────────────5└ ┘──,DOCTYPE= ──┬ ┬─'-//W3C//DTD HTML 3.2//EN'─
└ ┘─doctype────────────────────
5─ ──┬ ┬───────────────────── ──┬ ┬────────────────────────────────────── ──────5└ ┘──,TITLE='title-text' └ ┘──,MASTHEAD=url ──┬ ┬───────────────────
└ ┘──,'alternate-text'
5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ──┬ ┬─────────────────── ───5└ ┘──,BACKGROUND=url └ ┘──,BGCOLOR=─┤ color ├─ └ ┘──,TEXT=─┤ color ├─
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──,LINK=─┤ color ├─ └ ┘──,VLINK=─┤ color ├─
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────────────── ────────────────5└ ┘──,ALINK=─┤ color ├─ │ │┌ ┐─,────────────────────
└ ┘──, ───6
┴─┤ key ├─=─┤ button ├─
5─ ──┬ ┬───────────────────────────────── ──┬ ┬───────────────────── ───────────5 │ │┌ ┐─,──────────────────────── │ │┌ ┐─YES────
└ ┘──, ───6
┴─┤ bmscolor ├─=─┤ color ├─ └ ┘──,RESET= ──┼ ┼─NO─────└ ┘──'text'
5─ ──┬ ┬───────────────────────────────────────────────── ────────────────────5 │ │┌ ┐─,───────
└ ┘──,SUPPRESS=( ───6
┴(row,col) ──┬ ┬─────── ──┬ ┬─────── )└ ┘──,HEAD └ ┘──,FOOT
5─ ──┬ ┬──────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ─5%└ ┘──,ONLOAD='text' └ ┘──,ONUNLOAD='text' │ │┌ ┐─NO──
└ ┘──,PROPFONT= ──┴ ┴─YES─
Minimum BMS:
24 CICS User’s Handbook
API syntax
DFHMSD
55─ ──mapset ──DFHMSD ──TYPE= ──┬ ┬─DSECT─ ──────────────────────────────────────5 ├ ┤─MAP─── └ ┘─FINAL─
┌ ┐─,─────────────────────── ┌ ┐─,───────────────────────────────5─ ───
6┴┬ ┬─────────────────────── ───
6┴┬ ┬─────────────────────────────── ─5%
│ │┌ ┐─OUT─── │ │┌ ┐─NO──├ ┤──MODE= ──┼ ┼─────── ───── ├ ┤──CURSLOC= ──┼ ┼───── ────────────
│ │├ ┤─IN──── │ │└ ┘─YES─ │ │└ ┘─INOUT─ │ │┌ ┐─OFF───────
│ │┌ ┐─LOWER─ ├ ┤──HILIGHT= ──┼ ┼─────────── ──────├ ┤──FOLD= ──┼ ┼─────── ───── │ │├ ┤─BLINK─────
│ │└ ┘─UPPER─ │ │├ ┤─REVERSE─── │ │┌ ┐─NO── │ │└ ┘─UNDERLINE─
├ ┤──TRIGRAPH= ──┼ ┼───── ─── ├ ┤──PS= ──┬ ┬─BASE─ ──────────────── │ │└ ┘─YES─ │ │└ ┘─psid─ │ │┌ ┐─ASM──── │ │┌ ┐─,───────────
├ ┤──LANG= ──┼ ┼──────── ──── ├ ┤──VALIDN= ───6
┴┬ ┬─────────── ───── │ │├ ┤─COBOL── │ │├ ┤─MUSTFILL── │ │├ ┤─COBOL2─ │ │├ ┤─MUSTENTER─ │ │├ ┤─PLI──── │ │├ ┤─TRIGGER───
| │ │└ ┘─C────── │ │└ ┘─USEREXIT──├ ┤──┬ ┬────────────── ───── ├ ┤──┬ ┬──TERM=type ────────────────│ │├ ┤──STORAGE=AUTO │ │└ ┘──SUFFIX=n ─│ │└ ┘──BASE=name ─── │ │┌ ┐─NO──│ │┌ ┐─,──────── ├ ┤──TIOAPFX= ──┼ ┼───── ────────────├ ┤──CTRL=( ───
6┴┬ ┬──────── ) │ │└ ┘─YES─
│ │├ ┤─PRINT── │ │┌ ┐─,────────────│ │├ ┤─length─ ├ ┤───
6┴MAPATTS=(attr) ─────────────
│ │├ ┤─FREEKB─ │ │┌ ┐─,───────────│ │├ ┤─ALARM── ├ ┤───
6┴DSATTS=(attr) ──────────────
│ │└ ┘─FRSET── ├ ┤──OUTLINE= ──┬ ┬─BOX───────────── │ │┌ ┐─NO────── │ ││ │┌ ┐─,───────
├ ┤──EXTATT= ──┼ ┼───────── ─ │ │└ ┘──( ───6
┴┬ ┬─────── ) │ │├ ┤─MAPONLY─ │ │├ ┤─LEFT── │ │└ ┘─YES───── │ │├ ┤─RIGHT─ │ │┌ ┐─DEFAULT─ │ │├ ┤─OVER──
├ ┤──COLOR= ──┼ ┼───────── ── │ │└ ┘─UNDER─ │ │└ ┘─color─── │ │┌ ┐─NO──
| │ │┌ ┐─ADS── ├ ┤──SOSI= ──┼ ┼───── ───────────────| └ ┘──DSECT= ──┼ ┼────── ───── │ │└ ┘─YES─| └ ┘─ADSL─ │ │┌ ┐─YES─
└ ┘──TRANSP= ──┼ ┼───── ───────────── └ ┘─NO──
Standard BMS:
Chapter 1. Command-level application programming 25
API syntax
DFHMSD
┌ ┐─,───────────────────────────────55─ ───
6┴┬ ┬─────────────────────────────── ─5%
├ ┤──PARTN=(name) ──┬ ┬───────────── │ │└ ┘ ─,──ACTIVATE─
├ ┤──LDC=mnemonic ───────────────── │ │┌ ┐─NO──
├ ┤──OBFMT= ──┼ ┼───── ────────────── │ │└ ┘─YES─ │ │┌ ┐─,─────
├ ┤──HTAB= ───6
┴─ ──tab─ ───────────── │ │┌ ┐─,─────
├ ┤──VTAB= ───6
┴─ ──tab─ ───────────── │ │┌ ┐─FIELD─
├ ┤──DATA= ──┼ ┼─────── ───────────── │ │└ ┘─BLOCK─
└ ┘──FLDSEP= ──┬ ┬─char──────── ─────└ ┘──X'hex-char'
DFHPDI
55─ ── ──┬ ┬─────── ──DFHPDI ──VIEWPOS=(lines,columns) ──────────────────────────5 └ ┘─partn─
┌ ┐─,────────────────────────5─ ──,VIEWSZE=(lines,columns) ───
6┴┬ ┬──────────────────────── ─5%
├ ┤──BUFSZE=(lines,columns)├ ┤──CHARSZE=(vpels,hpels) ─├ ┤──MAPSFX=mapset-suffix ──└ ┘ ─ ─ATTRB=ERROR ───────────
DFHPSD
┌ ┐─,─────────────────────────55─ ──partnset DFHPSD ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──SUFFIX=user-suffix ─────├ ┤──ALTSCRN=(lines,columns)└ ┘──CHARSZE=(vpels,hpels) ──
26 CICS User’s Handbook
API syntax
DFHWBOUT
55─ ──DFHWBOUT ──'text' ──┬ ┬───────────────────── ─5% │ │┌ ┐─NO── └ ┘─,──SOSI──=─ ──┴ ┴─YES─
DOCUMENT CREATE
55─ ──DOCUMENT ──CREATE ──DOCTOKEN(data-area) ─────────────────────────────────5
5─ ──┬ ┬───────────────────────────────────────────────── ────────────────────5 └ ┘── ──┬ ┬──┬ ┬──FROM(data-area) ── ──LENGTH(data-value)
│ │├ ┤──TEXT(data-area) ──│ │└ ┘──BINARY(data-area)├ ┤──FROMDOC(data-area) ───────────────────────└ ┘──TEMPLATE(name) ───────────────────────────
5─ ──┬ ┬───────────────────────────────────────────── ────────────────────────5 └ ┘──SYMBOLLIST(data-area)LISTLENGTH(data-value)
5─ ──┬ ┬──────────────────── ──┬ ┬──────────────────── ─5%└ ┘──DOCSIZE(data-area) └ ┘──HOSTCODEPAGE(name)
Conditions: INVREQ, NOTFND, SYMBOLERR, TEMPLATERR
DOCUMENT INSERT
55─ ──DOCUMENT ──INSERT ──DOCTOKEN(data-area) ─────────────────────────────────5
5─ ──┬ ┬──┬ ┬──TEXT(data-area) ── ──LENGTH(data-value) ──────────────────────────5│ │├ ┤──BINARY(data-area)│ │└ ┘──FROM(data-area) ──├ ┤──SYMBOL(name) ─────────────────────────────├ ┤──TEMPLATE(name) ───────────────────────────├ ┤──FROMDOC(data-area) ───────────────────────└ ┘──BOOKMARK(name) ───────────────────────────
5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5└ ┘──DOCSIZE(data-value) └ ┘──HOSTCODEPAGE(name)
5─ ──┬ ┬──────────────────────── ─5% └ ┘──AT(name) ──┬ ┬──────────
└ ┘──TO(name)
Conditions: DUPREC, INVREQ, NOTFND, TEMPLATERR
Chapter 1. Command-level application programming 27
API syntax
DOCUMENT RETRIEVE
55─ ──DOCUMENT ──RETRIEVE ──DOCTOKEN(data-area) ──INTO(data-area) ──────────────5
5─ ──LENGTH(data-value) ──MAXLENGTH(data-value) ──┬ ┬──────────────────── ──────5└ ┘──CLNTCODEPAGE(name)
5─ ──┬ ┬────────── ─5% └ ┘──DATAONLY
Conditions: LENGERR, NOTFND
DOCUMENT SET
55─ ──DOCUMENT ──SET ──DOCTOKEN(data-area) ────────────────────────────────────5
5─ ──┬ ┬──SYMBOL(name) ──VALUE(data-area) ──LENGTH(data-value) ─5%└ ┘──SYMBOLLIST(data-area) ─────────
Conditions: NOTFND, SYMBOLERR
DUMP TRANSACTION
55─ ──DUMP TRANSACTION ──DUMPCODE(name) ──────────────────────────────────────5
5─ ──┬ ┬────────────────────────────────────────── ── ──┬ ┬────────── ───────────5 └ ┘──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ └ ┘─COMPLETE─
└ ┘──FLENGTH(data-value)
5─ ── ──┬ ┬───── ──────────────────────────────────────────────────────────────5 └ ┘─TRT─
5─ ──┬ ┬──────────────────────────────────────────────────────────────── ─────5 └ ┘─┤ segmentlist ├─ ──LENGTHLIST(data-area) ──NUMSEGMENTS(data-area)
5─ ── ──┬ ┬────── ── ──┬ ┬───────── ── ──┬ ┬───────── ── ──┬ ┬────────── ───────────────5 └ ┘─TASK─ └ ┘─STORAGE─ └ ┘─PROGRAM─ └ ┘─TERMINAL─
5─ ── ──┬ ┬──────── ── ──┬ ┬───── ── ──┬ ┬───── ── ──┬ ┬───── ── ──┬ ┬───── ── ──┬ ┬───── ────5└ ┘─TABLES─ └ ┘─DCT─ └ ┘─FCT─ └ ┘─PCT─ └ ┘─PPT─ └ ┘─SIT─
5─ ── ──┬ ┬───── ──┬ ┬─────────────────── ─5%└ ┘─TCT─ └ ┘──DUMPID(data-area)
segmentlist:├─ ──SEGMENTLIST(data-area) ─┤
Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTOPEN,OPENERR, SUPPRESSED
28 CICS User’s Handbook
API syntax
ENDBR
55─ ──ENDBR ──FILE(filename) ──┬ ┬─────────────────── ──┬ ┬─────────────────── ─5%└ ┘──REQID(data-value) └ ┘──SYSID(systemname)
Conditions: FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ,NOTAUTH, SYSIDERR
ENQ
55─ ──ENQ ──RESOURCE(data-area) ──┬ ┬──────────────────── ──────────────────────5└ ┘──LENGTH(data-value)
┌ ┐─UOW───────────────5─ ──┼ ┼─────────────────── ── ──┬ ┬─────────── ─5%
? ├ ┤──MAXLIFETIME(cvda) └ ┘─NOSUSPEND─ └ ┘─TASK──────────────
Conditions: ENQBUSY, INVREQ, LENGERR
ENTER TRACENUM
55─ ──ENTER TRACENUM(data-value) ────────────────────────────────────────────5
5─ ──┬ ┬──────────────────────────────────────────── ──┬ ┬──────────────── ─────5 └ ┘──FROM(data-area) ──┬ ┬─────────────────────── └ ┘──RESOURCE(name)
? └ ┘──FROMLENGTH(data-area)
5─ ── ──┬ ┬─────────── ─5% └ ┘─EXCEPTION─
? Conditions: INVREQ, LENGERR
Chapter 1. Command-level application programming 29
API syntax
EXTRACT ATTACH (LUTYPE6.1)
55─ ──EXTRACT ATTACH ──┬ ┬──────────────── ──┬ ┬──────────────────── ────────────5├ ┤──ATTACHID(name) └ ┘──PROCESS(data-area)├ ┤──CONVID(name) ──└ ┘──SESSION(name) ─
5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──RESOURCE(data-area) └ ┘──RPROCESS(data-area)
5─ ──┬ ┬────────────────────── ──┬ ┬────────────────── ─────────────────────────5└ ┘──RRESOURCE(data-area) └ ┘──QUEUE(data-area)
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──┬ ┬────────────────── ─5%└ ┘──IUTYPE(data-area) └ ┘──DATASTR(data-area) └ ┘──RECFM(data-area)
Conditions: CBIDERR, INVREQ, NOTALLOC
EXTRACT ATTACH (MRO)
55─ ──EXTRACT ATTACH ──┬ ┬──────────────── ──┬ ┬──────────────────── ────────────5├ ┤──ATTACHID(name) └ ┘──PROCESS(data-area)├ ┤──CONVID(name) ──└ ┘──SESSION(name) ─
5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──RESOURCE(data-area) └ ┘──RPROCESS(data-area)
5─ ──┬ ┬────────────────────── ──┬ ┬────────────────── ─────────────────────────5└ ┘──RRESOURCE(data-area) └ ┘──QUEUE(data-area)
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──┬ ┬────────────────── ─5%└ ┘──IUTYPE(data-area) └ ┘──DATASTR(data-area) └ ┘──RECFM(data-area)
Conditions: CBIDERR, INVREQ, NOTALLOC
EXTRACT ATTRIBUTES (APPC)
55─ ──EXTRACT ATTRIBUTES ──┬ ┬────────────── ──STATE(cvda) ─5%└ ┘──CONVID(name)
Conditions: INVREQ, NOTALLOC
30 CICS User’s Handbook
API syntax
EXTRACT ATTRIBUTES (MRO)
55─ ──EXTRACT ATTRIBUTES ──┬ ┬─────────────── ──STATE(cvda) ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)
Conditions: INVREQ, NOTALLOC
EXTRACT CERTIFICATE
55─ ──EXTRACT CERTIFICATE(ptr-ref) ──┬ ┬─────────────────── ───────────────────5└ ┘──LENGTH(data-area)
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────────── ────────────────────5└ ┘──SERIALNUM(ptr-ref) └ ┘──SERIALNUMLEN(data-area)
┌ ┐─OWNER──5─ ──┬ ┬───────────────── ──┼ ┼──────── ──┬ ┬───────────────────── ───────────────5
└ ┘──USERID(ptr-ref) └ ┘─ISSUER─ └ ┘──COMMONNAME(ptr-ref)
5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────── ──────────────────────5└ ┘──COMMONNAMLEN(data-area) └ ┘──COUNTRY(ptr-ref)
5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────── ──────────────────────────5└ ┘──COUNTRYLEN(data-area) └ ┘──STATE(ptr-ref)
5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ─────────────────────────5└ ┘──STATELEN(data-area) └ ┘──LOCALITY(ptr-ref)
5─ ──┬ ┬──────────────────────── ──┬ ┬─────────────────────── ──────────────────5└ ┘──LOCALITYLEN(data-area) └ ┘──ORGANIZATION(ptr-ref)
5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────── ──────────────────────5└ ┘──ORGANIZATLEN(data-area) └ ┘──ORGUNIT(ptr-ref)
5─ ──┬ ┬─────────────────────── ─5%└ ┘──ORGUNITLEN(data-area)
Conditions: INVREQ, LENGERR
EXTRACT LOGONMSG
55─ ──EXTRACT LOGONMSG ──┬ ┬──INTO(data-area) ──LENGTH(data-area) ─5%└ ┘──SET(ptr-ref) ───
? Condition: NOTALLOC
Chapter 1. Command-level application programming 31
API syntax
EXTRACT PROCESS (APPC)
55─ ──EXTRACT PROCESS ───────────────────────────────────────────────────────5
5─ ──┬ ┬──────────────────────────────────────────────────────────── ─────────5 └ ┘──PROCNAME(data-area) ──PROCLENGTH(data-area) ─┤ maxproclen ├─
5─ ──┬ ┬────────────── ──┬ ┬────────────────────── ─────────────────────────────5└ ┘──CONVID(name) └ ┘──SYNCLEVEL(data-area)
5─ ──┬ ┬──────────────────────────────────────── ─5% └ ┘──PIPLIST(ptr-ref) ──PIPLENGTH(data-area)
maxproclen:├─ ──┬ ┬──────────────────────── ─┤
? └ ┘──MAXPROCLEN(data-value)
? Conditions: INVREQ, LENGERR, NOTALLOC
EXTRACT TCT
55─ ──EXTRACT TCT ──NETNAME(name) ──┬ ┬─────────────────── ─5%├ ┤──SYSID(systemname)└ ┘──TERMID(data-area)
? Condition: INVREQ, NOTALLOC
32 CICS User’s Handbook
API syntax
FORMATTIME
55─ ──FORMATTIME ──ABSTIME(data-area) ──┬ ┬───────────────── ───────────────────5└ ┘──DATE(data-area)
5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──FULLDATE(data-area) └ ┘──DATEFORM(data-area)
5─ ──┬ ┬─────────────────────────── ──┬ ┬───────────────────── ─────────────────5 └ ┘─DATESEP─ ──┬ ┬────────────── └ ┘──DAYCOUNT(data-area) └ ┘──(data-value)
5─ ──┬ ┬─────────────────────── ──┬ ┬────────────────────── ────────────────────5└ ┘──DAYOFMONTH(data-area) └ ┘──DAYOFWEEK(data-area)
5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ─────────────────────────5└ ┘──DDMMYY(data-area) └ ┘──DDMMYYYY(data-area)
5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ─────────────────────────5└ ┘──MMDDYY(data-area) └ ┘──MMDDYYYY(data-area)
5─ ──┬ ┬──────────────────────── ─────────────────────────────────────────────5└ ┘──MONTHOFYEAR(data-area)
5─ ──┬ ┬──────────────────────────────────────────────── ─────────────────────5 └ ┘──TIME(data-area) ──┬ ┬─────────────────────────── └ ┘ ─TIMESEP─ ──┬ ┬──────────────
└ ┘──(data-value)
5─ ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ───────5└ ┘──YEAR(data-area) └ ┘──YYDDD(data-area) └ ┘──YYDDMM(data-area)
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──YYMMDD(data-area) └ ┘──YYYYDDD(data-area)
5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ─5%└ ┘──YYYYDDMM(data-area) └ ┘──YYYYMMDD(data-area)
Condition: INVREQ
FREE
55─ ──FREE ─5%
Condition: NOTALLOC
FREE (APPC)
55─ ──FREE ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)
Conditions: INVREQ, NOTALLOC
Chapter 1. Command-level application programming 33
API syntax
FREE (LUTYPE6.1)
55─ ──FREE ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)
Conditions: INVREQ, NOTALLOC
FREE (MRO)
55─ ──FREE ──┬ ┬─────────────── ──┬ ┬───────────── ─5%? ├ ┤──CONVID(name) ─ └ ┘──STATE(cvda)
└ ┘──SESSION(name)
Conditions: INVREQ, NOTALLOC
FREEMAIN
55─ ──FREEMAIN ──┬ ┬──DATA(data-area) ─────── ─5%└ ┘──DATAPOINTER(ptr-value)
Condition: INVREQ
GDS ALLOCATE (APPC basic)
55─ ──GDS ALLOCATE ──┬ ┬──SYSID(systemname) ──┬ ┬──────────────── ───────────────5│ │└ ┘──MODENAME(name)
? └ ┘──PARTNER(name) ────────────────────────
5─ ──CONVID(data-area) ──RETCODE(data-area) ── ──┬ ┬───────── ───────────────────5 └ ┘─NOQUEUE─
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
34 CICS User’s Handbook
API syntax
GDS ASSIGN (APPC basic)
55─ ──GDS ASSIGN ──┬ ┬─────────────────────── ──┬ ┬────────────────────── ───────5└ ┘──PRINCONVID(data-area) └ ┘──PRINSYSID(data-area)
5─ ──RETCODE(data-area) ─5%
GDS CONNECT PROCESS (APPC basic)
55─ ──GDS CONNECT PROCESS ──CONVID(name) ─────────────────────────────────────5
5─ ──┬ ┬──PROCNAME(name) ──┬ ┬──────────────────────── ─────────────────────────5│ │└ ┘──PROCLENGTH(data-value)
? └ ┘──PARTNER(name) ─────────────────────────────
5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──PIPLIST(data-area) ──┬ ┬───────────────────────
└ ┘──PIPLENGTH(data-value)
5─ ──SYNCLEVEL(data-value) ──CONVDATA(data-area) ──RETCODE(data-area) ─────────5
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS EXTRACT ATTRIBUTES (APPC basic)
55─ ──GDS EXTRACT ATTRIBUTES ──CONVID(name) ──┬ ┬───────────── ─────────────────5└ ┘──STATE(cvda)
5─ ──CONVDATA(data-area) ──RETCODE(data-area) ─5%
GDS EXTRACT PROCESS (APPC basic)
55─ ──GDS EXTRACT PROCESS ──CONVID(name) ─────────────────────────────────────5
5─ ──┬ ┬──────────────────────────────────────────────────────────── ─────────5 └ ┘──PROCNAME(data-area) ──PROCLENGTH(data-area) ─┤ maxproclen ├─
5─ ──┬ ┬────────────────────── ───────────────────────────────────────────────5└ ┘──SYNCLEVEL(data-area)
5─ ──┬ ┬──────────────────────────────────────────── ──RETCODE(data-area) ─5% └ ┘──PIPLIST(pointer-ref) ──PIPLENGTH(data-area)
maxproclen:├─ ──┬ ┬──────────────────────── ─┤
? └ ┘──MAXPROCLEN(data-value)
Chapter 1. Command-level application programming 35
API syntax
GDS FREE (APPC basic)
55─ ──GDS FREE ──CONVID(name) ──CONVDATA(data-area) ──RETCODE(data-area) ───────5
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS ISSUE ABEND (APPC basic)
55─ ──GDS ISSUE ABEND ──CONVID(name) ──CONVDATA(data-area) ────────────────────5
5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS ISSUE CONFIRMATION (APPC basic)
55─ ──GDS ISSUE CONFIRMATION ──CONVID(name) ──CONVDATA(data-area) ─────────────5
5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS ISSUE ERROR (APPC basic)
55─ ──GDS ISSUE ERROR ──CONVID(name) ──CONVDATA(data-area) ────────────────────5
5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS ISSUE PREPARE (APPC basic)
55─ ──GDS ISSUE PREPARE ──CONVID(name) ──CONVDATA(data-area) ──────────────────5
5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
36 CICS User’s Handbook
API syntax
GDS ISSUE SIGNAL (APPC basic)
55─ ──GDS ISSUE SIGNAL ──CONVID(name) ──CONVDATA(data-area) ───────────────────5
5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS RECEIVE (APPC basic)
55─ ──GDS RECEIVE ──CONVID(name) ──┬ ┬──INTO(data-area) ─ ──FLENGTH(data-area) ───5└ ┘──SET(pointer-ref)
5─ ──┬ ┬──────────────────────── ──┬ ┬─BUFFER─ ──CONVDATA(data-area) ────────────5└ ┘──MAXFLENGTH(data-value) └ ┘─LLID───
5─ ──RETCODE(data-area) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS SEND (APPC basic)
55─ ──GDS SEND ──CONVID(name) ──┬ ┬────────────────────────────────────── ──────5 └ ┘──FROM(data-area) ──FLENGTH(data-value)
5─ ──┬ ┬──────── ──┬ ┬───────── ──CONVDATA(data-area) ──RETCODE(data-area) ───────5 ├ ┤─INVITE─ ├ ┤─CONFIRM─ └ ┘─LAST─── └ ┘─WAIT────
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
GDS WAIT (APPC basic)
55─ ──GDS WAIT ──CONVID(name) ──CONVDATA(data-area) ──RETCODE(data-area) ───────5
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
Chapter 1. Command-level application programming 37
API syntax
GETMAIN
55─ ──GETMAIN ──SET(ptr-ref) ──┬ ┬──FLENGTH(data-value) ──┬ ┬─────── ─────────────5 │ │└ ┘─BELOW─
└ ┘──LENGTH(data-value) ────────────
5─ ──┬ ┬───────────────────── ── ──┬ ┬──────── ── ──┬ ┬─────────── ─────────────────5└ ┘──INITIMG(data-value) └ ┘─SHARED─ └ ┘─NOSUSPEND─
5─ ──┬ ┬───────────── ─5%? ├ ┤─USERDATAKEY─? └ ┘─CICSDATAKEY─
Conditions: LENGERR, NOSTG
HANDLE ABEND
┌ ┐─CANCEL────────55─ ──HANDLE ABEND ──┼ ┼─────────────── ─5%
├ ┤──PROGRAM(name)├ ┤──LABEL(label) ─
└ ┘─RESET─────────
? Conditions: NOTAUTH, PGMIDERR (PROGRAM only)
HANDLE AID
┌ ┐───────────────────────────55─ ──HANDLE AID ───
6┴┬ ┬─────────────────────── ─5%
├ ┤ ─ANYKEY─ ──┬ ┬───────── ──│ │└ ┘──(label)
├ ┤ ─CLEAR─ ──┬ ┬───────── ───│ │└ ┘──(label)
├ ┤ ─CLRPARTN─ ──┬ ┬─────────│ │└ ┘──(label)
├ ┤ ─ENTER─ ──┬ ┬───────── ───│ │└ ┘──(label)
├ ┤ ─LIGHTPEN─ ──┬ ┬─────────│ │└ ┘──(label)
├ ┤ ─OPERID─ ──┬ ┬───────── ──│ │└ ┘──(label)
├ ┤ ─PA1-PA3─ ──┬ ┬───────── ─│ │└ ┘──(label)
├ ┤ ─PF1-PF24─ ──┬ ┬─────────│ │└ ┘──(label)
└ ┘ ─TRIGGER─ ──┬ ┬───────── ─└ ┘──(label)
Condition: INVREQ
38 CICS User’s Handbook
API syntax
HANDLE CONDITION
┌ ┐──────────────────────────55─ ──HANDLE CONDITION ───
6┴─condition─ ──┬ ┬───────── ─5%
└ ┘──(label)
IGNORE CONDITION
┌ ┐─────────────55─ ──IGNORE CONDITION ───
6┴─condition─ ─5%
ISSUE ABEND (APPC)
55─ ──ISSUE ABEND ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)
Conditions: INVREQ, NOTALLOC, TERMERR
ISSUE ABORT
55─ ──ISSUE ABORT ──┬ ┬──────────────────────────────────────────────── ───────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────
│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─
5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────
└ ┘──VOLUMELENG(data-value)
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
Chapter 1. Command-level application programming 39
API syntax
ISSUE ADD
55─ ──ISSUE ADD ──DESTID(data-value) ──┬ ┬──────────────────────── ─────────────5└ ┘──DESTIDLENG(data-value)
5─ ──VOLUME(data-value) ──┬ ┬──────────────────────── ──FROM(data-area) ────────5└ ┘──VOLUMELENG(data-value)
5─ ──┬ ┬──────────────────── ──┬ ┬──────────────────── ── ──┬ ┬───────── ──────────5└ ┘──LENGTH(data-value) └ ┘──NUMREC(data-value) └ ┘─DEFRESP─
5─ ── ──┬ ┬──────── ──┬ ┬──────────────────────── ─5% └ ┘─NOWAIT─ └ ┘──RIDFLD(data-area) ─RRN─
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
ISSUE CONFIRMATION (APPC)
55─ ──ISSUE CONFIRMATION ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)
Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR
ISSUE COPY (3270 display)
55─ ──ISSUE COPY ──TERMID(name) ──┬ ┬───────────────────── ── ──┬ ┬────── ─5%└ ┘──CTLCHAR(data-value) └ ┘─WAIT─
? Condition: NOTALLOC, TERMIDERR
ISSUE COPY (3270 logical)
55─ ──ISSUE COPY ──TERMID(name) ──┬ ┬───────────────────── ── ──┬ ┬────── ─5%└ ┘──CTLCHAR(data-value) └ ┘─WAIT─
? Conditions: LENGERR, NOTALLOC, TERMERR
40 CICS User’s Handbook
API syntax
ISSUE DISCONNECT (default)
55─ ──ISSUE DISCONNECT ─5%
Conditions: SIGNAL, TERMERR
ISSUE DISCONNECT (LUTYPE6.1)
55─ ──ISSUE DISCONNECT ──┬ ┬─────────────── ─5%└ ┘──SESSION(name)
Conditions: NOTALLOC, TERMERR
ISSUE END
55─ ──ISSUE END ──┬ ┬──────────────────────────────────────────────── ─────────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────
│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─
5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────
└ ┘──VOLUMELENG(data-value)
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
ISSUE ENDFILE
55─ ──ISSUE ENDFILE ── ──┬ ┬─────────── ─5% └ ┘─ENDOUTPUT─
? Condition: INVREQ, NOTALLOC
Chapter 1. Command-level application programming 41
API syntax
ISSUE ENDOUTPUT
55─ ──ISSUE ENDOUTPUT ── ──┬ ┬───────── ─5% └ ┘─ENDFILE─
? Condition: INVREQ, NOTALLOC
ISSUE EODS
55─ ──ISSUE EODS ─5%
? Conditions: INVREQ, NOTALLOC, TERMERR
ISSUE ERASE
55─ ──ISSUE ERASE ──DESTID(data-value) ──┬ ┬──────────────────────── ───────────5└ ┘──DESTIDLENG(data-value)
5─ ──VOLUME(data-value) ──┬ ┬──────────────────────── ──RIDFLD(data-area) ──────5└ ┘──VOLUMELENG(data-value)
5─ ──┬ ┬──KEYLENGTH(data-value) ──┬ ┬─────────────────────── ───────────────────5│ │└ ┘──KEYNUMBER(data-value)
└ ┘─RRN──────────────────────────────────────────────
5─ ──┬ ┬──────────────────── ── ──┬ ┬───────── ── ──┬ ┬──────── ─5%└ ┘──NUMREC(data-value) └ ┘─DEFRESP─ └ ┘─NOWAIT─
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
ISSUE ERASEAUP
55─ ──ISSUE ERASEAUP ── ──┬ ┬────── ─5% └ ┘─WAIT─
? Conditions: INVREQ, NOTALLOC, TERMERR
42 CICS User’s Handbook
API syntax
ISSUE ERROR (APPC)
55─ ──ISSUE ERROR ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)
Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR
ISSUE LOAD
55─ ──ISSUE LOAD ──PROGRAM(name) ── ──┬ ┬────────── ─5% └ ┘─CONVERSE─
? Conditions: NONVAL, NOTALLOC, NOSTART, TERMERR
ISSUE NOTE
55─ ──ISSUE NOTE ──DESTID(data-value) ──┬ ┬──────────────────────── ────────────5└ ┘──DESTIDLENG(data-value)
5─ ──VOLUME(data-value) ──┬ ┬──────────────────────── ──RIDFLD(data-area) ──────5└ ┘──VOLUMELENG(data-value)
5─ ──RRN ─5%
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
ISSUE PASS
55─ ──ISSUE PASS ──LUNAME(name) ──┬ ┬───────────────────────────────────── ─────5 └ ┘──FROM(data-area) ──LENGTH(data-value)
5─ ──┬ ┬───────────────────── ── ──┬ ┬─────────── ─5%? ├ ┤──LOGMODE(data-value) └ ┘─NOQUIESCE─? └ ┘─LOGONLOGMODE────────
? Conditions: INVREQ, LENGERR, NOTALLOC
Chapter 1. Command-level application programming 43
API syntax
ISSUE PREPARE (APPC)
55─ ──ISSUE PREPARE ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)
? Conditions: INVREQ, NOTALLOC, TERMERR
ISSUE PRINT
55─ ──ISSUE PRINT ─5%
? Conditions: INVREQ, NOTALLOC, TERMERR
ISSUE QUERY
55─ ──ISSUE QUERY ──DESTID(data-value) ──┬ ┬──────────────────────── ───────────5└ ┘──DESTIDLENG(data-value)
5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────
└ ┘──VOLUMELENG(data-value)
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
ISSUE RECEIVE
55─ ──ISSUE RECEIVE ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ─5%└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)
Conditions: DSSTAT, EOC, EODS, INVREQ, LENGERR, UNEXPIN
44 CICS User’s Handbook
API syntax
ISSUE REPLACE
55─ ──ISSUE REPLACE ──DESTID(data-value) ──┬ ┬──────────────────────── ─────────5└ ┘──DESTIDLENG(data-value)
5─ ──┬ ┬──────────────────────────────────────────────── ──FROM(data-area) ────5 └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────
└ ┘──VOLUMELENG(data-value)
5─ ──┬ ┬──────────────────── ──┬ ┬──────────────────── ──RIDFLD(data-area) ──────5└ ┘──LENGTH(data-value) └ ┘──NUMREC(data-value)
5─ ──┬ ┬──KEYLENGTH(data-value) ──┬ ┬─────────────────────── ── ──┬ ┬───────── ────5│ │└ ┘──KEYNUMBER(data-value) └ ┘─DEFRESP─
└ ┘─RRN──────────────────────────────────────────────
5─ ── ──┬ ┬──────── ─5% └ ┘─NOWAIT─
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
ISSUE RESET
55─ ──ISSUE RESET ─5%
Condition: INVREQ, NOTALLOC
ISSUE SEND
55─ ──ISSUE SEND ──┬ ┬──────────────────────────────────────────────── ────────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────
│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─
5─ ──┬ ┬──────────────────────────────────────────────── ──FROM(data-area) ────5 └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────
└ ┘──VOLUMELENG(data-value)
5─ ──┬ ┬──────────────────── ── ──┬ ┬──────── ── ──┬ ┬───────── ─5%└ ┘──LENGTH(data-value) └ ┘─NOWAIT─ └ ┘─DEFRESP─
Conditions: FUNCERR, IGREQCD, INVREQ, SELNERR, UNEXPIN
Chapter 1. Command-level application programming 45
API syntax
ISSUE SIGNAL (APPC)
55─ ──ISSUE SIGNAL ──┬ ┬────────────── ──┬ ┬───────────── ─5%? └ ┘──CONVID(name) └ ┘──STATE(cvda)
? Conditions: INVREQ, NOTALLOC, TERMERR
ISSUE SIGNAL (LUTYPE6.1)
55─ ──ISSUE SIGNAL ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)
Conditions: NOTALLOC, TERMERR
ISSUE WAIT
55─ ──ISSUE WAIT ──┬ ┬──────────────────────────────────────────────── ────────5 ├ ┤──DESTID(data-value) ──┬ ┬────────────────────────
│ │└ ┘──DESTIDLENG(data-value) │ │┌ ┐─CONSOLE── └ ┘──SUBADDR(data-value) ──┼ ┼────────── ───────────── ├ ┤─PRINT──── ├ ┤─CARD───── ├ ┤─WPMEDIA1─ ├ ┤─WPMEDIA2─ ├ ┤─WPMEDIA3─ └ ┘─WPMEDIA4─
5─ ──┬ ┬──────────────────────────────────────────────── ─5% └ ┘──VOLUME(data-value) ──┬ ┬────────────────────────
└ ┘──VOLUMELENG(data-value)
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
46 CICS User’s Handbook
API syntax
LINK
55─ ──LINK ──PROGRAM(name) ──┬ ┬────────────────────────────────── ─────────────5 └ ┘──COMMAREA(data-area) ─┤ lengths ├─
5─ ──┬ ┬ ──┬ ┬─────────────────── ──┬ ┬────────────── ──┬ ┬─────────────── ─5% │ │└ ┘──SYSID(systemname) └ ┘ ─SYNCONRETURN─ └ ┘──TRANSID(name) └ ┘──INPUTMSG(data-area) ──┬ ┬───────────────────────── ────────── └ ┘──INPUTMSGLEN(data-value)
lengths:├─ ──┬ ┬──────────────────── ──┬ ┬─────────────────────── ─┤ └ ┘──LENGTH(data-value) └ ┘──DATALENGTH(data-area)
Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR,ROLLEDBACK, SYSIDERR, TERMERR
LOAD
55─ ──LOAD ──PROGRAM(name) ──┬ ┬────────────── ──┬ ┬──────────────────── ─────────5└ ┘──SET(ptr-ref) ├ ┤──LENGTH(data-area) ─
└ ┘──FLENGTH(data-area)
5─ ──┬ ┬──────────────── ── ──┬ ┬────── ─5%└ ┘──ENTRY(ptr-ref) └ ┘─HOLD─
Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR
MONITOR
55─ ──MONITOR ──POINT(data-value) ──┬ ┬────────────────── ──────────────────────5└ ┘──DATA1(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%└ ┘──DATA2(data-area) └ ┘──ENTRYNAME(data-area)
Condition: INVREQ
Chapter 1. Command-level application programming 47
API syntax
POINT
55─ ──POINT ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)
Condition: NOTALLOC
POP HANDLE
55─ ──POP HANDLE ─5%
Condition: INVREQ
POST
┌ ┐──INTERVAL(ð) ─────────────────────55─ ──POST ──┼ ┼────────────────────────────────── ──SET(ptr-ref) ──────────────5 ├ ┤──INTERVAL(hhmmss) ──────────────── ├ ┤──TIME(hhmmss) ──────────────────── │ │┌ ┐───────────────────────── ├ ┤ ─AFTER─ ───
6┴┬ ┬──HOURS(data-value) ──
│ │├ ┤──MINUTES(data-value) │ │└ ┘──SECONDS(data-value) │ │┌ ┐───────────────────────── └ ┘ ─AT─ ───
6┴┬ ┬──HOURS(data-value) ── ───
├ ┤──MINUTES(data-value) └ ┘──SECONDS(data-value)
5─ ──┬ ┬───────────── ─5% └ ┘──REQID(name)
Conditions: EXPIRED, INVREQ
PURGE MESSAGE
55─ ──PURGE MESSAGE ─5%
Conditions: Full BMS: INVREQ, TSIOERR
48 CICS User’s Handbook
API syntax
PUSH HANDLE
55─ ──PUSH HANDLE ─5%
QUERY SECURITY
55─ ──QUERY SECURITY ──┬ ┬──RESTYPE(data-value) ────────────────────────── ─────5 └ ┘──RESCLASS(data-value) ──RESIDLENGTH(data-value)
5─ ──RESID(data-value) ──┬ ┬────────────────── ──┬ ┬──────────── ────────────────5└ ┘──LOGMESSAGE(cvda) └ ┘──READ(cvda)
5─ ──┬ ┬────────────── ──┬ ┬─────────────── ──┬ ┬───────────── ─5%└ ┘──UPDATE(cvda) └ ┘──CONTROL(cvda) └ ┘──ALTER(cvda)
Conditions: INVREQ, LENGERR, NOTFND, QIDERR
READ
┌ ┐─UNCOMMITTED──────────────────55─ ──READ ──FILE(filename) ──┼ ┼────────────────────────────── ────────────────5 ├ ┤─CONSISTENT─────────────────── ├ ┤─REPEATABLE─────────────────── └ ┘ ─UPDATE─ ──┬ ┬──────────────────
└ ┘──TOKEN(data-area)
5─ ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ──RIDFLD(data-area) ──────────5└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)
5─ ──┬ ┬──────────────────────────────────── ──┬ ┬─────────────────── ──────────5 └ ┘──KEYLENGTH(data-value) ──┬ ┬───────── └ ┘──SYSID(systemname) └ ┘─GENERIC─
┌ ┐─EQUAL─5─ ──┬ ┬──────── ──┼ ┼─────── ──┬ ┬─────────── ─5% ├ ┤─RBA──── └ ┘─GTEQ── └ ┘─NOSUSPEND─ ├ ┤─RRN──── ├ ┤─DEBKEY─ └ ┘─DEBREC─
Conditions: DISABLED, DUPKEY, FILENOTFOUND, ILLOGIC,INVREQ, IOERR, ISCINVREQ, LENGERR, LOADING, LOCKED,NOTAUTH, NOTFND, NOTOPEN, RECORDBUSY, SYSIDERR
Chapter 1. Command-level application programming 49
API syntax
READNEXT
55─ ──READNEXT ──FILE(filename) ──┬ ┬──INTO(data-area) ─────────────────────────5└ ┘──SET(ptr-ref) ───
┌ ┐─UNCOMMITTED──────────────5─ ──┼ ┼────────────────────────── ──┬ ┬─────────────────── ────────────────────5
├ ┤─CONSISTENT─────────────── └ ┘──LENGTH(data-area) ├ ┤─REPEATABLE─────────────── └ ┘─UPDATE─ ──TOKEN(data-area)
5─ ──RIDFLD(data-area) ──┬ ┬─────────────────────── ──┬ ┬─────────────────── ────5└ ┘──KEYLENGTH(data-value) └ ┘──REQID(data-value)
5─ ──┬ ┬─────────────────── ──┬ ┬───── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA─ └ ┘─NOSUSPEND─
└ ┘─RRN─
Conditions: DUPKEY, ENDFILE, FILENOTFOUND, ILLOGIC, INVREQ,| IOERR, ISCINVREQ, LENGERR, LOADING, LOCKED, NOTAUTH,
NOTFND, RECORDBUSY, SYSIDERR
READPREV
55─ ──READPREV ──FILE(filename) ──┬ ┬──INTO(data-area) ─────────────────────────5└ ┘──SET(ptr-ref) ───
┌ ┐─UNCOMMITTED──────────────5─ ──┼ ┼────────────────────────── ──┬ ┬─────────────────── ────────────────────5
├ ┤─CONSISTENT─────────────── └ ┘──LENGTH(data-area) ├ ┤─REPEATABLE─────────────── └ ┘─UPDATE─ ──TOKEN(data-area)
5─ ──RIDFLD(data-area) ──┬ ┬─────────────────────── ──┬ ┬─────────────────── ────5└ ┘──KEYLENGTH(data-value) └ ┘──REQID(data-value)
5─ ──┬ ┬─────────────────── ──┬ ┬───── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA─ └ ┘─NOSUSPEND─
└ ┘─RRN─
Conditions: DUPKEY, ENDFILE, FILENOTFOUND, ILLOGIC, INVREQ,IOERR, ISCINVREQ, LENGERR, LOCKED, NOTAUTH, NOTFND,RECORDBUSY, SYSIDERR
50 CICS User’s Handbook
API syntax
READQ TD
55─ ──READQ TD ──QUEUE(name) ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ─────5└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)
5─ ──┬ ┬─────────────────── ── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) └ ┘─NOSUSPEND─
Conditions: DISABLED, INVREQ, IOERR, ISCINVREQ, LENGERR,LOCKED, NOTAUTH, NOTOPEN, QBUSY, QIDERR, QZERO,SYSIDERR
READQ TS
55─ ──READQ TS ──┬ ┬──QUEUE(name) ──┬ ┬──INTO(data-area) ────────────────────────5└ ┘──QNAME(name) └ ┘──SET(ptr-ref) ───
┌ ┐─NEXT─────────────5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ──┼ ┼────────────────── ───5
└ ┘──LENGTH(data-area) └ ┘──NUMITEMS(data-area) └ ┘──ITEM(data-value)
5─ ──┬ ┬─────────────────── ─5%└ ┘──SYSID(systemname)
Conditions: INVREQ, IOERR, ISCINVREQ, ITEMERR, LENGERR,NOTAUTH, QIDERR, SYSIDERR
RECEIVE (APPC)
55─ ──RECEIVE ──┬ ┬────────────── ──┬ ┬──INTO(data-area) ────────────────────────5└ ┘──CONVID(name) └ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──LENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───5└ ┘──FLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
Conditions: EOC, INVREQ, LENGERR, NOTALLOC, SIGNAL,TERMERR
Chapter 1. Command-level application programming 51
API syntax
RECEIVE (default)
55─ ──RECEIVE ──┬ ┬───────────────── ──────────────────────────────────────────5 ├ ┤──INTO(data-area) └ ┘──SET(ptr-ref) ───
5─ ──LENGTH(data-value) ──FLENGTH(data-value) ──┬ ┬────────────────────── ──────5 └ ┘──MAXLENGTH(data-area)
5─ ─NOTRUNCATE──5%
Conditions: INVREQ, LENGERR, NOTALLOC
RECEIVE (LUTYPE2/LUTYPE3)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬────── ── ──┬ ┬──────── ───────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─ASIS─ └ ┘─BUFFER─└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─
Conditions: EOC, INVREQ, LENGERR, TERMERR
RECEIVE (LUTYPE4)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR
52 CICS User’s Handbook
API syntax
RECEIVE (LUTYPE6.1)
55─ ──RECEIVE ──┬ ┬─────────────── ──┬ ┬──INTO(data-area) ───────────────────────5└ ┘──SESSION(name) └ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──LENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%└ ┘──FLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, INBFMH, INVREQ, LENGERR, NOTALLOC,SIGNAL, TERMERR
RECEIVE (MRO)
55─ ──RECEIVE ──┬ ┬─────────────── ──┬ ┬──INTO(data-area) ───────────────────────5└ ┘──SESSION(name) └ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──LENGTH(data-area) ─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ───5└ ┘──FLENGTH(data-area) ├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─
└ ┘──MAXFLENGTH(data-value)
5─ ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
Conditions: EOC, INBFMH, INVREQ, LENGERR, NOTALLOC,TERMERR
RECEIVE (System/3)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)
Conditions: INVREQ, LENGERR
Chapter 1. Command-level application programming 53
API syntax
RECEIVE (System/7)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ── ──┬ ┬─────────── ── ──┬ ┬────── ─5% └ ┘─PSEUDOBIN─ └ ┘─ASIS─
Conditions: INVREQ, LENGERR
RECEIVE (2260)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬───────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─LEAVEKB─└ ┘──MAXFLENGTH(data-value)
Conditions: INVREQ, LENGERR
RECEIVE (2741)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: INVREQ, LENGERR, RDATT
54 CICS User’s Handbook
API syntax
RECEIVE (2980)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ──PASSBK ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: INVREQ, LENGERR, NOPASSBKRD
RECEIVE (3270 display)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ── ──┬ ┬────── ───────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─ └ ┘─ASIS─└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────── ─5% └ ┘─BUFFER─
Conditions: INVREQ, LENGERR
RECEIVE (3270 logical)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬────── ── ──┬ ┬──────── ───────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─ASIS─ └ ┘─BUFFER─└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─
Conditions: INVREQ, LENGERR, TERMERR
Chapter 1. Command-level application programming 55
API syntax
RECEIVE (3600 BTAM)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: INVREQ, LENGERR
RECEIVE (3600 pipeline)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: INVREQ, LENGERR, NOTALLOC
RECEIVE (3600-3601)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR
56 CICS User’s Handbook
API syntax
RECEIVE (3600-3614)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: INVREQ, LENGERR, TERMERR
RECEIVE (3650)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, TERMERR
RECEIVE (3735)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOF, INVREQ, LENGERR
Chapter 1. Command-level application programming 57
API syntax
RECEIVE (3740)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOF, ENDINPT, INVREQ, LENGERR
RECEIVE (3767)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, INVREQ, LENGERR, SIGNAL, TERMERR
RECEIVE (3770)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR
58 CICS User’s Handbook
API syntax
RECEIVE (3790 full-function or inquiry)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬──────────── ─5%├ ┤──MAXLENGTH(data-value) ─ └ ┘─NOTRUNCATE─└ ┘──MAXFLENGTH(data-value)
Conditions: EOC, EODS, INBFMH, INVREQ, LENGERR, SIGNAL,TERMERR
RECEIVE (3790 3270-display)
55─ ──RECEIVE ──┬ ┬───────────────────── ──┬ ┬──LENGTH(data-area) ─ ──────────────5 └ ┘──┬ ┬──INTO(data-area) └ ┘──FLENGTH(data-area)
└ ┘──SET(ptr-ref) ───
5─ ──┬ ┬──────────────────────── ── ──┬ ┬────── ── ──┬ ┬──────── ───────────────────5├ ┤──MAXLENGTH(data-value) ─ └ ┘─ASIS─ └ ┘─BUFFER─└ ┘──MAXFLENGTH(data-value)
5─ ── ──┬ ┬──────────── ─5% └ ┘─NOTRUNCATE─
Conditions: INVREQ, LENGERR, TERMERR
Chapter 1. Command-level application programming 59
API syntax
RECEIVE MAP
55─ ──RECEIVE MAP(name) ──┬ ┬────────────── ──┬ ┬───────────────── ──────────────5└ ┘──MAPSET(name) ├ ┤──INTO(data-area)
└ ┘──SET(ptr-ref) ───
┌ ┐─TERMINAL────────────────────────────────5─ ──┼ ┼───────────────────────────────────────── ─5% ├ ┤──FROM(data-area) ──┬ ┬────────────────────
│ │└ ┘──LENGTH(data-value) └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬─────────────── ──
└ ┘─ASIS─ └ ┘──INPARTN(name)
Conditions: EOC, EODS, INVMPSZ, INVPARTN, INVREQ, MAPFAIL,PARTNFAIL, RDATT, UNEXPIN
Note: INPARTN is supported by Standard and full BMS
RECEIVE MAP MAPPINGDEV
55─ ──RECEIVE MAP(name) ──MAPPINGDEV(data-value) ──FROM(data-area) ────────────5
5─ ──┬ ┬──────────────────── ──┬ ┬────────────── ──┬ ┬───────────────── ─5%└ ┘──LENGTH(data-value) └ ┘──MAPSET(name) ├ ┤──INTO(data-area)
└ ┘──SET(ptr-ref) ───
Conditions: INVMPSZ, INVREQ, MAPFAIL,
RECEIVE PARTN
55─ ──RECEIVE PARTN(data-area) ─5%
Standard and full BMS:
RECEIVE PARTN
55─ ──┬ ┬──INTO(data-area) ──LENGTH(data-value) ── ──┬ ┬────── ─5%└ ┘──SET(ptr-ref) ─── └ ┘─ASIS─
Conditions: EOC, EODS, INVPARTN, INVREQ, LENGERR
60 CICS User’s Handbook
API syntax
RELEASE
55─ ──RELEASE ──PROGRAM(name) ─5%
Conditions: INVREQ, NOTAUTH, PGMIDERR
RESETBR
55─ ──RESETBR ──FILE(filename) ──RIDFLD(data-area) ────────────────────────────5
5─ ──┬ ┬──────────────────────────────────── ──┬ ┬─────────────────── ──────────5 └ ┘──KEYLENGTH(data-value) ──┬ ┬───────── └ ┘──REQID(data-value) └ ┘─GENERIC─
┌ ┐─GTEQ──5─ ──┬ ┬─────────────────── ──┼ ┼─────── ──┬ ┬───── ─5%
└ ┘──SYSID(systemname) └ ┘─EQUAL─ ├ ┤─RBA─ └ ┘─RRN─
Conditions: FILENOTFOUND, ILLOGIC, INVREQ, IOERR, ISCINVREQ,NOTAUTH, NOTFND, SYSIDERR
RETRIEVE
55─ ──RETRIEVE ──┬ ┬──INTO(data-area) ──┬ ┬─────────────────── ──────────────────5└ ┘──SET(ptr-ref) ─── └ ┘──LENGTH(data-area)
5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5└ ┘──RTRANSID(data-area) └ ┘──RTERMID(data-area)
5─ ──┬ ┬────────────────── ── ──┬ ┬────── ─5%└ ┘──QUEUE(data-area) └ ┘─WAIT─
Conditions: ENDDATA, ENVDEFERR, INVREQ, IOERR, LENGERR,NOTFND
Chapter 1. Command-level application programming 61
API syntax
RETURN
55─ ──RETURN ──┬ ┬──────────────────────────────────────────────── ────────────5 └ ┘──TRANSID(name) ──┬ ┬────────────── ──┬ ┬───────────
└ ┘─┤ commarea ├─ └ ┘ ─IMMEDIATE─
5─ ──┬ ┬────────────────────────────────────────────────── ───────────────────5 └ ┘──INPUTMSG(data-area) ──┬ ┬───────────────────────── └ ┘──INPUTMSGLEN(data-value)
5─ ──┬ ┬───────────── ─5%| └ ┘| ─ENDACTIVITY─
commarea:├─ ──COMMAREA(data-area) ──┬ ┬──────────────────── ─┤ └ ┘──LENGTH(data-value)
Conditions: INVREQ, LENGERR
REWRITE
55─ ──REWRITE ──FILE(filename) ──┬ ┬────────────────── ──FROM(data-area) ────────5└ ┘──TOKEN(data-area)
5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ── ──┬ ┬─────────── ─5%└ ┘──LENGTH(data-value) └ ┘──SYSID(systemname) └ ┘─NOSUSPEND─
| Conditions: CHANGED, DUPREC, FILENOTFOUND, ILLOGIC,INVREQ, IOERR, ISCINVREQ, LENGERR, LOCKED, NOSPACE,NOTAUTH, NOTFND, RECORDBUSY, SYSIDERR
62 CICS User’s Handbook
API syntax
ROUTE
┌ ┐──INTERVAL(ð) ─────────────────────55─ ──ROUTE ──┼ ┼────────────────────────────────── ──┬ ┬───────────────────── ──5
├ ┤ ─ ─INTERVAL(hhmmss) ──────────────── └ ┘ ─ERRTERM─ ──┬ ┬────────├ ┤──TIME(hhmmss) ──────────────────── └ ┘──(name)
│ │┌ ┐───────────────────────── ├ ┤─AFTER─ ───
6┴┬ ┬──HOURS(data-value) ──
│ │├ ┤──MINUTES(data-value)│ │└ ┘──SECONDS(data-value)
│ │┌ ┐───────────────────────── └ ┘─AT─ ───
6┴┬ ┬──HOURS(data-value) ── ───
├ ┤──MINUTES(data-value)└ ┘──SECONDS(data-value)
5─ ──┬ ┬────────────────── ──┬ ┬───────────────── ──┬ ┬──────────────────── ──────5└ ┘──TITLE(data-area) └ ┘──LIST(data-area) └ ┘──OPCLASS(data-area)
5─ ──┬ ┬───────────── ──┬ ┬─────────── ── ──┬ ┬─────── ─5%└ ┘──REQID(name) └ ┘──LDC(name) └ ┘─NLEOM─
Conditions: IGREQID, INVERRTERM, INVLDC, INVREQ, RTEFAIL,RTESOME
SEND (APPC)
55─ ──SEND ──┬ ┬────────────── ──┬ ┬────────────────────────────────────────── ──5└ ┘──CONVID(name) └ ┘──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─
└ ┘──FLENGTH(data-value)
5─ ──┬ ┬──────── ──┬ ┬───────── ──┬ ┬───────────── ─5%? ├ ┤─INVITE─ ├ ┤─CONFIRM─ └ ┘──STATE(cvda)
└ ┘─LAST─── └ ┘─WAIT────
Conditions: INVREQ, LENGERR, NOTALLOC, SIGNAL, TERMERR
SEND (default)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)
5─ ── ──┬ ┬────── ─5% └ ┘─WAIT─
Conditions: INVREQ, LENGERR, NOTALLOC
Chapter 1. Command-level application programming 63
API syntax
SEND (LUTYPE2/LUTYPE3)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────5 ├ ┤─INVITE─ │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) └ ┘─LAST─── │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────
5─ ── ──┬ ┬───────── ─5% └ ┘─DEFRESP─
Conditions: INVREQ, LENGERR, TERMERR
SEND (LUTYPE4)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, IGREQCD, LENGERR, SIGNAL, TERMERR
SEND (LUTYPE6.1)
55─ ──SEND ──┬ ┬─────────────── ── ──┬ ┬────── ──┬ ┬──────── ──┬ ┬──────────────── ───5└ ┘──SESSION(name) └ ┘─WAIT─ ├ ┤─INVITE─ └ ┘──ATTACHID(name)
└ ┘─LAST───
5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ── ──┬ ┬───── ────────────────5└ ┘──FROM(data-area) ├ ┤──LENGTH(data-value) ─ └ ┘─FMH─
└ ┘──FLENGTH(data-value)
5─ ── ──┬ ┬───────── ─5% └ ┘─DEFRESP─
Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, SIGNAL,TERMERR
64 CICS User’s Handbook
API syntax
SEND (MRO)
55─ ──SEND ──┬ ┬─────────────── ── ──┬ ┬────── ──┬ ┬──────── ──┬ ┬──────────────── ───5└ ┘──SESSION(name) └ ┘─WAIT─ ├ ┤─INVITE─ └ ┘──ATTACHID(name)
└ ┘─LAST───
5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ── ──┬ ┬───── ────────────────5└ ┘──FROM(data-area) ├ ┤──LENGTH(data-value) ─ └ ┘─FMH─
└ ┘──FLENGTH(data-value)
5─ ── ──┬ ┬───────── ──┬ ┬───────────── ─5%? └ ┘─DEFRESP─ └ ┘──STATE(cvda)
Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, TERMERR
SEND (SCS)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬────────── ── ──┬ ┬───── ─5%├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─STRFIELD─ └ ┘─FMH─
└ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, TERMERR
SEND (System/3)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)
5─ ── ──┬ ┬────── ── ──┬ ┬────── ── ──┬ ┬─────────── ─5% └ ┘─WAIT─ └ ┘─ASIS─ └ ┘─CNOTCOMPL─
Conditions: INVREQ, LENGERR
SEND (System/7)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)
5─ ── ──┬ ┬────── ── ──┬ ┬─────────── ── ──┬ ┬────── ─5% └ ┘─WAIT─ └ ┘─PSEUDOBIN─ └ ┘─ASIS─
Conditions: INVREQ, LENGERR
Chapter 1. Command-level application programming 65
API syntax
SEND (2260)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)
5─ ──┬ ┬───────────────────── ──┬ ┬──────────── ──┬ ┬────────────────────── ──────5└ ┘──CTLCHAR(data-value) └ ┘──DEST(name) └ ┘──LINEADDR(data-value)
5─ ── ──┬ ┬────── ── ──┬ ┬───────── ─5% └ ┘─WAIT─ └ ┘─LEAVEKB─
Conditions: INVREQ, LENGERR
SEND (2741)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)
5─ ── ──┬ ┬────── ─5% └ ┘─WAIT─
Conditions: INVREQ, LENGERR, WRBRK
SEND (2980)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)
5─ ──┬ ┬─PASSBK─ ─5% └ ┘─CBUFF──
Conditions: INVREQ, LENGERR, NOPASSBKWR
SEND (3270 display)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬──────────── ────────5└ ┘──FLENGTH(data-value) └ ┘──DEST(name)
5─ ── ──┬ ┬────── ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ─5% └ ┘─WAIT─ │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────
Conditions: INVREQ, LENGERR
66 CICS User’s Handbook
API syntax
SEND (3270 logical)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ──────5 ├ ┤─INVITE─ │ │└ ┘─ERASE─ ──┬ ┬─────────── └ ┘──CTLCHAR(data-value) └ ┘─LAST─── │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─STRFIELD──────────────────────────────────────────
5─ ── ──┬ ┬───────── ─5% └ ┘─DEFRESP─
Conditions: INVREQ, LENGERR, TERMERR
SEND (3600 BTAM)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─
Conditions: INVREQ, LENGERR
SEND (3600 pipeline)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ─5%└ ┘──FLENGTH(data-value) └ ┘─WAIT─
Conditions: INVREQ, LENGERR, TERMERR
SEND (3600-3601)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ──┬ ┬─────────── ─────────5└ ┘──FLENGTH(data-value) ├ ┤──LDC(name)
└ ┘─FMH───────
5─ ── ──┬ ┬────── ──┬ ┬──────── ──┬ ┬─────────── ─5% └ ┘─WAIT─ ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, SIGNAL, TERMERR
Chapter 1. Command-level application programming 67
API syntax
SEND (3600-3614)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, TERMERR
SEND (3650 interpreter)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ── ──┬ ┬───────── ── ──┬ ┬───── ─5%├ ┤─INVITE─ └ ┘─DEFRESP─ └ ┘─FMH─
└ ┘─LAST───
Conditions: INVREQ, LENGERR, TERMERR
SEND (3650-3270)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)
5─ ──┬ ┬───────────────────── ── ──┬ ┬────── ──┬ ┬────────────────────── ──────────5└ ┘──CTLCHAR(data-value) └ ┘─WAIT─ └ ┘ ─ERASE─ ──┬ ┬───────────
├ ┤─DEFAULT─── └ ┘─ALTERNATE─
5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, TERMERR
68 CICS User’s Handbook
API syntax
SEND (3650-3653)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, TERMERR
SEND (3650-3680)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, TERMERR
SEND (3735)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─
Conditions: INVREQ, LENGERR
SEND (3740)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ── ──┬ ┬────── ─5% └ ┘─ASIS─
Conditions: INVREQ, LENGERR
Chapter 1. Command-level application programming 69
API syntax
SEND (3767)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, SIGNAL, TERMERR
SEND (3770)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, SIGNAL, TERMERR
SEND (3790 full-function or inquiry)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ── ──┬ ┬───── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─FMH─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, SIGNAL, TERMERR
SEND (3790 SCS)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ── ──┬ ┬────── ────────────5└ ┘──FLENGTH(data-value) └ ┘─WAIT─
5─ ──┬ ┬──────── ──┬ ┬─────────── ─5% ├ ┤─INVITE─ ├ ┤─CNOTCOMPL─ └ ┘─LAST─── └ ┘─DEFRESP───
Conditions: INVREQ, LENGERR, TERMERR
70 CICS User’s Handbook
API syntax
SEND (3790 3270-display)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)
5─ ──┬ ┬───────────────────── ── ──┬ ┬────── ──┬ ┬────────────────────── ──────────5└ ┘──CTLCHAR(data-value) └ ┘─WAIT─ └ ┘ ─ERASE─ ──┬ ┬───────────
├ ┤─DEFAULT─── └ ┘─ALTERNATE─
5─ ──┬ ┬──────── ── ──┬ ┬───────── ─5% ├ ┤─INVITE─ └ ┘─DEFRESP─ └ ┘─LAST───
Conditions: INVREQ, LENGERR, TERMERR
SEND (3790 3270-printer)
55─ ──SEND ──FROM(data-area) ──┬ ┬──LENGTH(data-value) ─ ────────────────────────5└ ┘──FLENGTH(data-value)
5─ ──┬ ┬───────────────────── ── ──┬ ┬────── ──┬ ┬────────────────────── ──────────5└ ┘──CTLCHAR(data-value) └ ┘─WAIT─ └ ┘ ─ERASE─ ──┬ ┬───────────
├ ┤─DEFAULT─── └ ┘─ALTERNATE─
5─ ──┬ ┬──────── ── ──┬ ┬───────── ─5% ├ ┤─INVITE─ └ ┘─DEFRESP─ └ ┘─LAST───
Conditions: INVREQ, LENGERR, TERMERR
Chapter 1. Command-level application programming 71
API syntax
SEND CONTROL
55─ ──SEND CONTROL ─5%
Minimum BMS:
SEND CONTROL
55─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ──────────────────────────5 └ ┘ ─CURSOR─ ──┬ ┬────────────── └ ┘─FORMFEED─ └ ┘──(data-value)
5─ ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ───────5 ├ ┤ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─ERASEAUP─────────────
5─ ── ──┬ ┬─────── ─5% └ ┘─FRSET─
Standard BMS:
SEND CONTROL
55─ ──┬ ┬───────────────── ──┬ ┬ ──┬ ┬──────────────── ──┬ ┬──────────────── ─5%└ ┘──MSR(data-value) │ │└ ┘──OUTPARTN(name) └ ┘──ACTPARTN(name)
└ ┘──LDC(name) ─────────────────────────────
Full BMS:
72 CICS User’s Handbook
API syntax
SEND CONTROL
┌ ┐─TERMINAL─────────────────────55─ ── ──┬ ┬─────── ──┼ ┼────────────────────────────── ──┬ ┬───────────── ────────5
└ ┘─ACCUM─ ├ ┤──SET(ptr-ref) ──────────────── └ ┘──REQID(name) ├ ┤─PAGING─────────────────────── └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─
┌ ┐─HONEOM─5─ ──┼ ┼──────── ─5% ├ ┤─L4ð──── ├ ┤─L64──── └ ┘─L8ð────
Conditions: IGREQCD, IGREQID, INVLDC, INVPARTN, INVREQ,RETPAGE, TSIOERR, WRBRK
Chapter 1. Command-level application programming 73
API syntax
SEND MAP
55─ ──SEND MAP(name) ─5%
Minimum BMS:
SEND MAP
55─ ──┬ ┬────────────── ──────────────────────────────────────────────────────5└ ┘──MAPSET(name)
5─ ──┬ ┬ ──┬ ┬───────────────── ──┬ ┬────────── ──┬ ┬──────────────────── ──────────5│ │└ ┘──FROM(data-area) └ ┘─DATAONLY─ └ ┘──LENGTH(data-value)
└ ┘─MAPONLY───────────────────────────────────────────────────
5─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ───────────────────────────5 └ ┘ ─CURSOR─ ──┬ ┬────────────── └ ┘─FORMFEED─
└ ┘──(data-value)
5─ ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ───────5 ├ ┤ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ │ │├ ┤─DEFAULT─── │ │└ ┘─ALTERNATE─ └ ┘─ERASEAUP─────────────
5─ ── ──┬ ┬─────── ─5% └ ┘─FRSET─
Standard BMS:
SEND MAP
55─ ── ──┬ ┬─────── ──┬ ┬───────────────── ──┬ ┬─────────────── ───────────────────5└ ┘─NLEOM─ └ ┘──MSR(data-value) └ ┘──FMHPARM(name)
5─ ──┬ ┬ ──┬ ┬──────────────── ──┬ ┬──────────────── ─5%│ │└ ┘──OUTPARTN(name) └ ┘──ACTPARTN(name)└ ┘──LDC(name) ─────────────────────────────
Full BMS:
74 CICS User’s Handbook
API syntax
SEND MAP
┌ ┐─TERMINAL─────────────────────55─ ── ──┬ ┬─────── ──┼ ┼────────────────────────────── ──┬ ┬───────────── ────────5
└ ┘─ACCUM─ ├ ┤──SET(ptr-ref) ──────────────── └ ┘──REQID(name) ├ ┤─PAGING─────────────────────── └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─
┌ ┐─HONEOM─5─ ── ──┬ ┬───────── ──┼ ┼──────── ─5% └ ┘─NOFLUSH─ ├ ┤─L4ð──── ├ ┤─L64──── └ ┘─L8ð────
Conditions: IGREQCD, IGREQID, INVLDC, INVMPSZ, INVPARTN,INVREQ, OVERFLOW, RETPAGE, TSIOERR, WRBRK
Minimum BMS:
SEND MAP
55─ ──SEND MAP(name) ──MAPPINGDEV(data-value) ──SET(ptr-ref) ──────────────────5
5─ ──┬ ┬────────────── ───────────────────────────────────────────────────────5└ ┘──MAPSET(name)
5─ ──┬ ┬ ──┬ ┬───────────────── ──┬ ┬────────── ──┬ ┬──────────────────── ──────────5│ │└ ┘──FROM(data-area) └ ┘─DATAONLY─ └ ┘──LENGTH(data-value)
└ ┘─MAPONLY───────────────────────────────────────────────────
5─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ──┬ ┬────────── ─────────────5 └ ┘ ─CURSOR─ ──┬ ┬────────────── └ ┘─FORMFEED─ ├ ┤─ERASE────
└ ┘──(data-value) └ ┘─ERASEAUP─
5─ ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ── ──┬ ┬─────── ─5% └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ └ ┘─FRSET─
Conditions: INVMPSZ, INVREQ
Chapter 1. Command-level application programming 75
API syntax
SEND PAGE
55─ ──SEND PAGE ──┬ ┬ ─RELEASE─ ──┬ ┬─────────────── ──┬ ┬──────────────────── ─────5│ │└ ┘──TRANSID(name) └ ┘──TRAILER(data-area)
└ ┘─RETAIN─────────────────────
5─ ──┬ ┬────────────── ──┬ ┬─────────────────────── ── ──┬ ┬─────────── ───────────5└ ┘──SET(ptr-ref) ├ ┤ ─AUTOPAGE─ ──┬ ┬───────── └ ┘─OPERPURGE─
│ │├ ┤─CURRENT─ │ │└ ┘─ALL───── └ ┘─NOAUTOPAGE────────────
5─ ──┬ ┬─────────────── ── ──┬ ┬────── ─5%└ ┘──FMHPARM(name) └ ┘─LAST─
Conditions: IGREQCD, INVREQ, RETPAGE, TSIOERR, WRBRK
SEND PARTNSET
55─ ─SEND PARTNSET─ ──┬ ┬──────── ─5%└ ┘──(name)
Conditions: INVPARTNSET, INVREQ
SEND TEXT
55─ ──SEND TEXT ─5%
Standard BMS:
SEND TEXT
55─ ──FROM(data-area) ──┬ ┬──────────────────── ──┬ ┬──────────────────── ───────5└ ┘──LENGTH(data-value) └ ┘──CURSOR(data-value)
5─ ── ──┬ ┬────────── ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ────5 └ ┘─FORMFEED─ └ ┘ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ ├ ┤─DEFAULT─── └ ┘─ALTERNATE─
5─ ── ──┬ ┬─────── ── ──┬ ┬─────── ──┬ ┬─────────────── ────────────────────────────5└ ┘─ALARM─ └ ┘─NLEOM─ └ ┘──FMHPARM(name)
5─ ──┬ ┬ ──┬ ┬──────────────── ──┬ ┬──────────────── ──┬ ┬───────────────── ─5%│ │└ ┘──OUTPARTN(name) └ ┘──ACTPARTN(name) └ ┘──MSR(data-value)└ ┘──LDC(name) ─────────────────────────────
76 CICS User’s Handbook
API syntax
Full BMS:
SEND TEXT
┌ ┐─TERMINAL─────────────────────55─ ──┼ ┼────────────────────────────── ──┬ ┬───────────── ─────────────────────5
├ ┤──SET(ptr-ref) ──────────────── └ ┘──REQID(name) ├ ┤─PAGING─────────────────────── └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──HEADER(data-area) └ ┘──TRAILER(data-area)
┌ ┐─HONEOM─5─ ──┬ ┬───────────────────── ── ──┬ ┬─────── ──┼ ┼──────── ─5%
├ ┤──JUSTIFY(data-value) └ ┘─ACCUM─ ├ ┤─L4ð──── ├ ┤─JUSFIRST──────────── ├ ┤─L64──── └ ┘─JUSLAST───────────── └ ┘─L8ð────
Conditions: IGREQCD, IGREQID, INVLDC, INVPARTN, INVREQ,LENGERR, RETPAGE, TSIOERR, WRBRK
SEND TEXT MAPPED
55─ ──SEND TEXT MAPPED ──FROM(data-area) ──┬ ┬──────────────────── ─────────────5└ ┘──LENGTH(data-value)
┌ ┐─TERMINAL─────────────────────5─ ──┼ ┼────────────────────────────── ──┬ ┬───────────── ─5%
├ ┤─PAGING─────────────────────── └ ┘──REQID(name) └ ┘ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── └ ┘─WAIT─ └ ┘─LAST─
Conditions: IGREQCD, IGREQID, INVREQ, TSIOERR, WRBRK
Chapter 1. Command-level application programming 77
API syntax
SEND TEXT NOEDIT
55─ ──SEND TEXT NOEDIT ──FROM(data-area) ──┬ ┬──────────────────── ─────────────5└ ┘──LENGTH(data-value)
5─ ──┬ ┬────────────────────── ── ──┬ ┬─────── ── ──┬ ┬──────── ── ──┬ ┬─────── ───────5 └ ┘ ─ERASE─ ──┬ ┬─────────── └ ┘─PRINT─ └ ┘─FREEKB─ └ ┘─ALARM─ ├ ┤─DEFAULT─── └ ┘─ALTERNATE─
┌ ┐─TERMINAL─────────────────────5─ ──┬ ┬──────────────── ──┼ ┼────────────────────────────── ───────────────────5
└ ┘──OUTPARTN(name) ├ ┤ ─TERMINAL─ ──┬ ┬────── ──┬ ┬────── │ │└ ┘─WAIT─ └ ┘─LAST─ └ ┘─PAGING───────────────────────
┌ ┐─HONEOM─5─ ──┬ ┬───────────── ──┼ ┼──────── ─5%
└ ┘──REQID(name) ├ ┤─L4ð──── ├ ┤─L64──── └ ┘─L8ð────
Conditions: IGREQCD, IGREQID, INVREQ, INVPARTN, TSIOERR,WRBRK
SIGNOFF
55─ ──SIGNOFF ─5%
Condition: INVREQ
SIGNON
55─ ──SIGNON ──USERID(data-value) ──┬ ┬────────────────────── ──────────────────5└ ┘──ESMREASON(data-area)
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──ESMRESP(data-area) └ ┘──GROUPID(data-value)
5─ ──┬ ┬────────────────────────── ──┬ ┬────────────────────── ─────────────────5├ ┤──LANGUAGECODE(data-value) └ ┘──LANGINUSE(data-area)└ ┘──NATLANG(data-value) ─────
5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────────── ──────────────────5└ ┘──NATLANGINUSE(data-area) └ ┘──PASSWORD(data-value)
5─ ──┬ ┬───────────────────────── ──┬ ┬───────────────────── ─5%└ ┘──NEWPASSWORD(data-value) └ ┘──OIDCARD(data-value)
Conditions: INVREQ, NOTAUTH, USERIDERR
78 CICS User’s Handbook
API syntax
SPOOLCLOSE TOKEN
┌ ┐─────────────────────55─ ──SPOOLCLOSE ──TOKEN(data-area) ──┬ ┬──────── ───
6┴┬ ┬─NOHANDLE──────── ─5%
├ ┤─KEEP─── └ ┘ ─RESP─ ──┬ ┬─────── └ ┘─DELETE─ └ ┘─RESP2─
Conditions: ALLOCERR, INVREQ, NOSPOOL, NOSTG, NOTFND,NOTOPEN, STRELERR
SPOOLOPEN INPUT
55─ ──SPOOLOPEN INPUT ──TOKEN(data-area) ──USERID(data-value) ─────────────────5
┌ ┐─────────────────────5─ ──┬ ┬─────────────────── ───
6┴┬ ┬─NOHANDLE──────── ─5%
└ ┘──CLASS(data-value) └ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─
Conditions: ALLOCERR, ILLOGIC, INVREQ, NOSPOOL, NOSTG,NOTAUTH, NOTFND, NOTOPEN, OPENERR, SPOLBUSY, SPOLERR,STRELERR
SPOOLOPEN OUTPUT
55─ ──SPOOLOPEN OUTPUT ──TOKEN(data-area) ──USERID(data-value) ────────────────5
5─ ──NODE(data-value) ──┬ ┬─────────────────── ──┬ ┬─────────────────── ─────────5└ ┘──CLASS(data-value) └ ┘──OUTDESCR(ptr-ref)
┌ ┐─NOCC─ ┌ ┐─PRINT───────────────────────────────5─ ──┼ ┼────── ──┼ ┼───────────────────────────────────── ──────────────────────5 ├ ┤─ASA── ├ ┤ ─PRINT─ ──┬ ┬──────────────────────────
└ ┘─MCC── │ │└ ┘──RECORDLENGTH(data-value) └ ┘─PUNCH───────────────────────────────
┌ ┐─────────────────────5─ ───
6┴┬ ┬─NOHANDLE──────── ─5%
└ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─
Conditions: ALLOCERR, ILLOGIC, INVREQ, LENGERR, NODEIDERR,NOSPOOL, NOSTG, NOTFND, NOTOPEN, OPENERR,OUTDESCERR, SPOLBUSY, STRELERR
Chapter 1. Command-level application programming 79
API syntax
SPOOLREAD
55─ ──SPOOLREAD ──TOKEN(data-area) ──INTO(data-area) ──────────────────────────5
5─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ───────────────────5└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)
┌ ┐─────────────────────5─ ───
6┴┬ ┬─NOHANDLE──────── ─5%
└ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─
Conditions: ALLOCERR, ENDFILE, ILLOGIC, INVREQ, LENGERR,NOSPOOL, NOSTG, NOTFND, NOTOPEN, SPOLBUSY, SPOLERR,STRELERR
SPOOLWRITE
55─ ──SPOOLWRITE ──TOKEN(data-area) ──FROM(data-area) ─────────────────────────5
┌ ┐─LINE─ ┌ ┐─────────────────────5─ ──┬ ┬───────────────────── ──┼ ┼────── ───
6┴┬ ┬─NOHANDLE──────── ─5%
└ ┘──FLENGTH(data-value) └ ┘─PAGE─ └ ┘ ─RESP─ ──┬ ┬─────── └ ┘─RESP2─
Conditions: ALLOCERR, INVREQ, LENGERR, NOSPOOL, NOSTG,NOTOPEN, SPOLBUSY, SPOLERR, STRELERR
80 CICS User’s Handbook
API syntax
START
┌ ┐──INTERVAL(ð) ─────────────────────55─ ──START ──TRANSID(name) ──┼ ┼────────────────────────────────── ────────────5
├ ┤ ─ ─INTERVAL(hhmmss) ────────────────├ ┤──TIME(hhmmss) ────────────────────
│ │┌ ┐───────────────────────── ├ ┤─AFTER─ ───
6┴┬ ┬──HOURS(data-value) ──
│ │├ ┤──MINUTES(data-value)│ │└ ┘──SECONDS(data-value)
│ │┌ ┐───────────────────────── └ ┘─AT─ ───
6┴┬ ┬──HOURS(data-value) ── ───
├ ┤──MINUTES(data-value)└ ┘──SECONDS(data-value)
5─ ──┬ ┬───────────── ──┬ ┬────────────────────────────────────────────── ──────5└ ┘──REQID(name) └ ┘──FROM(data-area) ──LENGTH(data-value) ──┬ ┬─────
└ ┘─FMH─
5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ──────5├ ┤──TERMID(name) ────── └ ┘──SYSID(systemname) └ ┘──RTRANSID(name)└ ┘──USERID(data-value)
5─ ──┬ ┬─────────────── ──┬ ┬───────────── ── ──┬ ┬───────── ── ──┬ ┬───────── ─5%└ ┘──RTERMID(name) └ ┘──QUEUE(name) └ ┘─NOCHECK─ └ ┘─PROTECT─
Conditions: INVREQ, IOERR, ISCINVREQ, LENGERR, NOTAUTH,SYSIDERR, TERMIDERR, TRANSIDERR, USERIDERR
START ATTACH
55─ ──START ATTACH ──TRANSID(name) ──┬ ┬───────────────────────────────────── ─5% └ ┘──FROM(data-area) ──LENGTH(data-value)
Conditions: INVREQ, LENGERR, NOTAUTH, TRANSIDERR
START BREXIT
55─ ──START ──┬ ┬─BREXIT─────── ──TRANSID(name) ────────────────────────────────5└ ┘──BREXIT(name)
5─ ──┬ ┬───────────────────────────────────────────── ────────────────────────5 └ ┘──BRDATA(data-area) ──BRDATALENGTH(data-value)
5─ ──┬ ┬──────────────────── ─5%└ ┘──USERID(data-value)
Conditions: INVREQ,LENGERR, NOTAUTH, PGMIDERR,TRANSIDERR, USERIDERR
Chapter 1. Command-level application programming 81
API syntax
STARTBR
55─ ──STARTBR ──FILE(filename) ──RIDFLD(data-area) ────────────────────────────5
5─ ──┬ ┬──────────────────────────────────── ──┬ ┬─────────────────── ──────────5 └ ┘──KEYLENGTH(data-value) ──┬ ┬───────── └ ┘──REQID(data-value) └ ┘─GENERIC─
5─ ──┬ ┬─────────────────── ──┬ ┬──────── ──┬ ┬─────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA──── ├ ┤─GTEQ──
├ ┤─RRN──── └ ┘─EQUAL─ ├ ┤─DEBKEY─ └ ┘─DEBREC─
Conditions: DISABLED, FILENOTFOUND, ILLOGIC, INVREQ, IOERR,ISCINVREQ, LOADING, NOTAUTH, NOTFND, NOTOPEN, SYSIDERR
SUSPEND
55─ ──SUSPEND ─5%
SYNCPOINT
55─ ──SYNCPOINT ─5%
Conditions: INVREQ, ROLLEDBACK
SYNCPOINT ROLLBACK
55─ ──SYNCPOINT ──ROLLBACK ─5%
Condition: INVREQ
82 CICS User’s Handbook
API syntax
EXTRACT TCPIP
55─ ──EXTRACT ──TCPIP ──┬ ┬─────────────────────────────────────────────── ─────5 └ ┘──CLIENTNAME(data-area) ──CNAMELENGTH(data-area)
5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──SERVERNAME(data-area) ──SNAMELENGTH(data-area)
5─ ──┬ ┬──CLIENTADDR(data-area) ──CADDRLENGTH(data-area) ──┬ ┬─────────────── ───5├ ┤──CLIENTADDRNU(data-area) ────────────────────── └ ┘──SSLTYPE(cvda)
├ ┤──SERVERADDR(data-area) ──SADDRLENGTH(data-area)└ ┘──SERVERADDRNU(data-area) ──────────────────────
5─ ──┬ ┬───────────────────────── ──┬ ┬─────────────────────── ─────────────────5└ ┘──TCPIPSERVICE(data-area) └ ┘──PORTNUMBER(data-area)
5─ ──┬ ┬────────────────────── ─5%└ ┘──PORTNUMNU(data-area)
Conditions: INVREQ, LENGERR
UNLOCK
55─ ──UNLOCK ──FILE(filename) ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5% └ ┘──TOKEN(data-area) └ ┘──SYSID(systemname)
Conditions: DISABLED, FILENOTFOUND, ILLOGIC, INVREQ, IOERR,ISCINVREQ, NOTAUTH, NOTOPEN, SYSIDERR
VERIFY PASSWORD
55─ ──VERIFY PASSWORD(data-value) ──USERID(data-value) ───────────────────────5
5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────── ─────────────────────5└ ┘──CHANGETIME(data-area) └ ┘──DAYSLEFT(data-area)
5─ ──┬ ┬────────────────────── ──┬ ┬──────────────────── ───────────────────────5└ ┘──ESMREASON(data-area) └ ┘──ESMRESP(data-area)
5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────────── ─────────────────5└ ┘──EXPIRYTIME(data-area) └ ┘──INVALIDCOUNT(data-area)
5─ ──┬ ┬──────────────────────── ─5%└ ┘──LASTUSETIME(data-area)
Conditions: INVREQ, NOTAUTH, USERIDERR
Chapter 1. Command-level application programming 83
API syntax
WAIT CONVID (APPC)
55─ ──WAIT CONVID(name) ──┬ ┬───────────── ─5%? └ ┘──STATE(cvda)
Conditions: INVREQ, NOTALLOC
WAIT EVENT
55─ ──WAIT EVENT ──ECADDR(ptr-value) ──┬ ┬──────────── ─5%? └ ┘──NAME(name)
Condition: INVREQ
WAIT EXTERNAL
55─ ──WAIT EXTERNAL ──ECBLIST(ptr-value) ──NUMEVENTS(data-value) ──────────────5
┌ ┐─PURGEABLE──────────5─ ──┼ ┼──────────────────── ──┬ ┬──────────── ─5%
? ├ ┤──PURGEABILITY(cvda) └ ┘──NAME(name) └ ┘─NOTPURGEABLE───────
Condition: INVREQ
WAIT JOURNALNAME
55─ ──WAIT JOURNALNAME(data-value) ──┬ ┬─────────────────── ─5%└ ┘──REQID(data-value)
Conditions: INVREQ, IOERR, JIDERR, NOTOPEN
84 CICS User’s Handbook
API syntax
WAIT SIGNAL
55─ ──WAIT SIGNAL ─5%
Conditions: NOTALLOC, SIGNAL, TERMERR
WAIT TERMINAL
55─ ──WAIT TERMINAL ──┬ ┬─────────────── ─5%├ ┤──CONVID(name) ─└ ┘──SESSION(name)
Conditions: INVREQ, NOTALLOC, SIGNAL
WAITCICS
55─ ──WAITCICS ──ECBLIST(ptr-value) ──NUMEVENTS(data-value) ───────────────────5
┌ ┐─PURGEABLE──────────5─ ──┼ ┼──────────────────── ──┬ ┬──────────── ─5%
? ├ ┤──PURGEABILITY(cvda) └ ┘──NAME(name) └ ┘─NOTPURGEABLE───────
Condition: INVREQ
WEB ENDBROWSE
55─ ──WEB ──ENDBROWSE ──HTTPHEADER ─5%
Conditions: INVREQ
Chapter 1. Command-level application programming 85
API syntax
WEB EXTRACT
55─ ──WEB ──EXTRACT ──┬ ┬──────────────────────────────────────────────── ──────5 └ ┘──HTTPMETHOD(data-area) ──METHODLENGTH(data-area)
5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──HTTPVERSION(data-area) ──VERSIONLEN(data-area)
5─ ──┬ ┬──────────────────────────────────────── ──┬ ┬─────────────────── ─5% └ ┘──PATH(data-area) ──PATHLENGTH(data-area) └ ┘──REQUESTTYPE(cvda)
Conditions: INVREQ, LENGERR
WEB READ
55─ ──WEB ──READ ──HTTPHEADER(data-area) ──NAMELENGTH(data-value) ──────────────5
5─ ──VALUE(data-area) ──VALUELENGTH(data-area) ─5%
Conditions: INVREQ, LENGERR, NOTFND
WEB READNEXT
55─ ──WEB ──READNEXT ──HTTPHEADER(data-area) ──NAMELENGTH(data-area) ───────────5
5─ ──VALUE(data-area) ──VALUELENGTH(data-area) ─5%
Conditions: ENDFILE, INVREQ, LENGERR
WEB RECEIVE
55─ ──WEB ──RECEIVE ──┬ ┬──INTO(data-area) ──LENGTH(data-area) ──────────────────5└ ┘──SET(ptr-ref) ───
5─ ──MAXLENGTH(data-value) ──┬ ┬──────────── ──┬ ┬──────────── ──────────────────5└ ┘──TYPE(cvda) └ ┘──NOTRUNCATE
5─ ──┬ ┬──────────────────────────────────────── ─5% └ ┘──CLNTCODEPAGE(name) ──HOSTCODEPAGE(name)
Conditions: INVREQ, LENGERR
86 CICS User’s Handbook
API syntax
WEB RETRIEVE
55─ ──WEB ──RETRIEVE ──DOCTOKEN(data-area) ─5%
Conditions: INVREQ
WEB SEND
55─ ──WEB ──SEND ──DOCTOKEN(name) ──┬ ┬──────────────────── ─────────────────────5└ ┘──CLNTCODEPAGE(name)
5─ ──┬ ┬──────────────────────── ─────────────────────────────────────────────5└ ┘──STATUSCODE(data-value)
5─ ──┬ ┬─────────────────────────────────────────── ─5% └ ┘──STATUSTEXT(data-area) ──LENGTH(data-value)
Conditions: INVREQ, NOTFND
WEB STARTBROWSE
55─ ──WEB ──STARTBROWSE ──HTTPHEADER ─5%
Conditions: INVREQ
WEB WRITE
55─ ──WEB ──WRITE ──HTTPHEADER(data-area) ──NAMELENGTH(data-value) ─────────────5
5─ ──VALUE(data-area) ──VALUELENGTH(data-value) ─5%
Conditions: INVREQ
Chapter 1. Command-level application programming 87
API syntax
WRITE
55─ ──WRITE ──FILE(filename) ── ──┬ ┬──────────── ──FROM(data-area) ──────────────5 └ ┘─MASSINSERT─
5─ ──┬ ┬──────────────────── ──RIDFLD(data-area) ──┬ ┬─────────────────────── ───5└ ┘──LENGTH(data-value) └ ┘──KEYLENGTH(data-value)
5─ ──┬ ┬─────────────────── ──┬ ┬───── ── ──┬ ┬─────────── ─5%└ ┘──SYSID(systemname) ├ ┤─RBA─ └ ┘─NOSUSPEND─
└ ┘─RRN─
Conditions: DISABLED, DUPREC, FILENOTFOUND, ILLOGIC,INVREQ, IOERR, ISCINVREQ, LENGERR, LOADING, LOCKED,NOSPACE, NOTAUTH, NOTOPEN, RECORDBUSY, SUPPRESSED,SYSIDERR
WRITE JOURNALNAME
55─ ──WRITE JOURNALNAME(data-value) ──JTYPEID(data-value) ──FROM(data-area) ───5
5─ ──┬ ┬───────────────────── ──┬ ┬────────────────── ──────────────────────────5└ ┘──FLENGTH(data-value) └ ┘──REQID(data-area)
5─ ──┬ ┬───────────────────────────────────────────── ── ──┬ ┬────── ────────────5 └ ┘──PREFIX(data-value) ──┬ ┬───────────────────── └ ┘─WAIT─
└ ┘──PFXLENG(data-value)
5─ ── ──┬ ┬─────────── ─5% └ ┘─NOSUSPEND─
Conditions: INVREQ, IOERR, JIDERR, LENGERR, NOJBUFSP,NOTAUTH, NOTOPEN
88 CICS User’s Handbook
API syntax
WRITE OPERATOR
55─ ──WRITE OPERATOR ──TEXT(data-value) ──┬ ┬─────────────────────── ───────────5 └ ┘──TEXTLENGTH(data-area)
5─ ──┬ ┬─────────────────────────────────────────────── ──────────────────────5 └ ┘──ROUTECODES(data-value) ──NUMROUTES(data-value)
┌ ┐ ─EVENTUAL───────────────────────────────────────────────5─ ──┼ ┼──────────────────────────────────────────────────────── ─5% ├ ┤──ACTION(cvda) ────────────────────────────────────────── ├ ┤ ─CRITICAL─────────────────────────────────────────────── ├ ┤ ─IMMEDIATE────────────────────────────────────────────── └ ┘──REPLY(data-area) ─┤ lengths ├─ ──┬ ┬───────────────────── └ ┘──TIMEOUT(data-value)
lengths:├─ ──MAXLENGTH(data-area) ──┬ ┬──────────────────────── ─┤ └ ┘──REPLYLENGTH(data-area)
Conditions: EXPIRED, INVREQ, LENGERR
WRITEQ TD
55─ ──WRITEQ TD ──QUEUE(name) ──FROM(data-area) ──┬ ┬──────────────────── ───────5└ ┘──LENGTH(data-value)
5─ ──┬ ┬─────────────────── ─5%└ ┘──SYSID(systemname)
Conditions: DISABLED, INVREQ, IOERR, ISCINVREQ, LENGERR,LOCKED, NOSPACE, NOTAUTH, NOTOPEN, QIDERR, SYSIDERR
WRITEQ TS
55─ ──WRITEQ TS ──┬ ┬──QUEUE(name) ──FROM(data-area) ──┬ ┬──────────────────── ───5└ ┘──QNAME(name) └ ┘──LENGTH(data-value)
5─ ──┬ ┬────────────────────────────── ──┬ ┬─────────────────── ────────────────5├ ┤──NUMITEMS(data-area) ───────── └ ┘──SYSID(systemname)
└ ┘──ITEM(data-area) ──┬ ┬───────── └ ┘─REWRITE─
┌ ┐─AUXILIARY─5─ ──┼ ┼─────────── ── ──┬ ┬─────────── ─5% └ ┘─MAIN────── └ ┘─NOSUSPEND─
Conditions: INVREQ, IOERR, ISCINVREQ, ITEMERR, LENGERR,LOCKED, NOSPACE, NOTAUTH, QIDERR, SYSIDERR
Chapter 1. Command-level application programming 89
API syntax
XCTL
55─ ──XCTL ──PROGRAM(name) ──┬ ┬───────────────────────────────────────────── ──5 └ ┘──COMMAREA(data-area) ──┬ ┬────────────────────
└ ┘──LENGTH(data-value)
5─ ──┬ ┬────────────────────────────────────────────────── ─5% └ ┘──INPUTMSG(data-area) ──┬ ┬─────────────────────────
└ ┘──INPUTMSGLEN(data-value)
Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR
90 CICS User’s Handbook
SPI syntax
Chapter 2. SPI command syntax
This chapter contains General-use Programming Interface information.
ACQUIRE TERMINAL
55─ ──ACQUIRE TERMINAL(data-value) ──┬ ┬────────────────────── ────────────────5 ├ ┤─NOQUEUE────────────── ├ ┤ ─QALL─ ──┬ ┬──────── ──── │ │└ ┘─RELREQ─ ├ ┤ ─QNOTENAB───────────── └ ┘ ─QSESSLIM─ ──┬ ┬──────── └ ┘─RELREQ─
5─ ──┬ ┬─────────────────────────────────────────────────── ─5% └ ┘──USERDATA(data-value) ──┬ ┬─────────────────────────
└ ┘──USERDATALEN(data-value)
Conditions: INVREQ, LENGERR, NOTAUTH, TERMIDERR
Copyright IBM Corp. 1989, 1999 91
SPI syntax
COLLECT STATISTICS
55─ ──COLLECT STATISTICS SET(ptr-ref) ──┬ ┬────────────────────── ─────────────5├ ┤──LASTRESET(data-area)└ ┘─┤ COL3 ├─────────────
5─ ──┬ ┬─AUTOINSTALL────────────────────────────── ─5%├ ┤──CONNECTION(data-value) ──────────────────
├ ┤─DB2CONN──────────────────────────────────├ ┤ ─ ─DB2ENTRY(data-value) ────────────────────
├ ┤─DISPATCHER─────────────────────────────── ├ ┤─ENQUEUE──────────────────────────────────
├ ┤──FILE(data-value) ────────────────────────├ ┤──JOURNALNAME(data-value) ─────────────────├ ┤──JOURNALNUM(data-value) ──────────────────├ ┤──LSRPOOL(data-value) ─────────────────────
├ ┤ ──MONITOR ──┬ ┬────────────── ───────────────│ │└ ┘──(data-value)
├ ┤──NODE(data-value) ──TARGET(data-value) ──── ├ ┤──POOL(data-value) ──┬ ┬────────────────────
│ │└ ┘──TARGET(data-value) ├ ┤─PROGAUTO───────────────────────────────── ├ ┤ ──PROGRAM ──┬ ┬────────────── ───────────────
│ │└ ┘──(data-value) ├ ┤─RECOVERY───────────────────────────────── ├ ┤ ──STORAGE ──┬ ┬────────────── ───────────────
│ │└ ┘──(data-value)├ ┤──STREAMNAME(data-value) ──────────────────
├ ┤ ──SYSDUMPCODE ──┬ ┬────────────── ───────────│ │└ ┘──(data-value)
├ ┤─TABLEMGR─────────────────────────────────├ ┤──TCLASS(data-value) ──────────────────────
| ├ ┤──TCPIPSERVICE(data-value) ──────────────── ├ ┤ ──TDQUEUE ──┬ ┬────────────── ───────────────
│ │└ ┘──(data-value)├ ┤ ─ ─TERMINAL(data-value) ────────────────────├ ┤──TRANCLASS(data-value) ───────────────────
├ ┤ ──TRANDUMPCODE ──┬ ┬────────────── ──────────│ │└ ┘──(data-value)
├ ┤ ──TRANSACTION ──┬ ┬────────────── ───────────│ │└ ┘──(data-value)
├ ┤─TSQUEUE────────────────────────────────── └ ┘─VTAM─────────────────────────────────────
COL3:├──┤ COL4 ├─ ──LASTRESETMIN(data-area) ──LASTRESETSEC(data-area) ─┤
COL4:├─ ──LASTRESETHRS(data-area) ─┤
Conditions: INVREQ, IOERR, NOTAUTH, NOTFND
92 CICS User’s Handbook
SPI syntax
CREATE CONNECTION
55─ ──CREATE CONNECTION(data-value) ─────────────────────────────────────────5
5─ ──┬ ┬──ATTRIBUTES(data-value)ATTRLEN(data-value) ─5% ├ ┤──COMPLETE ───────────────────────────────── └ ┘──DISCARD ──────────────────────────────────
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE CONNECTION
CONNECTION attributes: ┌ ┐─ACCESSMETHOD(VTAM)───── ┌ ┐─ATTACHSEC(LOCAL)──────├─ ──┼ ┼──────────────────────── ──┼ ┼─────────────────────── ──────────────────5 ├ ┤─ACCESSMETHOD(INDIRECT)─ ├ ┤─ATTACHSEC(IDENTIFY)─── ├ ┤─ACCESSMETHOD(IRC)────── ├ ┤─ATTACHSEC(MIXIDPE)──── └ ┘─ACCESSMETHOD(XM)─────── ├ ┤─ATTACHSEC(PERSISTENT)─ └ ┘─ATTACHSEC(VERIFY)─────
┌ ┐─AUTOCONNECT(NO)── ┌ ┐─BINDSECURITY(NO)── ┌ ┐─CONNTYPE(SPECIFIC)─5─ ──┼ ┼────────────────── ──┼ ┼─────────────────── ──┼ ┼──────────────────── ────5 ├ ┤─AUTOCONNECT(ALL)─ └ ┘─BINDSECURITY(YES)─ └ ┘─CONNTYPE(GENERIC)── └ ┘─AUTOCONNECT(YES)─
┌ ┐─DATASTREAM(USER)─────5─ ──┼ ┼────────────────────── ──┬ ┬───────────────────── ──┬ ┬─────────────── ───5
├ ┤─DATASTREAM(LMS)────── └ ┘──DESCRIPTION(char58) └ ┘──INDSYS(char4) ├ ┤─DATASTREAM(SCS)────── ├ ┤─DATASTREAM(STRFIELD)─ └ ┘─DATASTREAM(327ð)─────
┌ ┐─INSERVICE(YES)─ ┌ ┐─MAXQTIME(NO)─────5─ ──┼ ┼──────────────── ──┼ ┼────────────────── ──┬ ┬──────────────── ───────────5
└ ┘─INSERVICE(NO)── └ ┘──MAXQTIME(ð-9999) └ ┘──NETNAME(char8)
┌ ┐─PSRECOVERY(SYSDEFAULT)─5─ ──┬ ┬──────────────── ──┼ ┼──────────────────────── ─────────────────────────5 ├ ┤─PROTOCOL(APPC)─ └ ┘─PSRECOVERY(NONE)─────── ├ ┤─PROTOCOL(EXCI)─ └ ┘─PROTOCOL(LU61)─
┌ ┐─QUEUELIMIT(NO)───── ┌ ┐─RECORDFORMAT(U)──5─ ──┼ ┼──────────────────── ──┼ ┼────────────────── ───────────────────────────5
└ ┘──QUEUELIMIT(ð-9999) └ ┘─RECORDFORMAT(VB)─
5─ ──┬ ┬───────────────────── ────────────────────────────────────────────────5└ ┘──REMOTESYSNET(char8)
5─ ──┬ ┬──────────────────────────────────────────── ─────────────────────────5└ ┘──REMOTESYSTEM(char4) ──┬ ┬───────────────────
└ ┘──REMOTENAME(char4)
┌ ┐─SINGLESESS(NO)── ┌ ┐─USEDFLTUSER(NO)──5─ ──┬ ┬───────────────────── ──┼ ┼───────────────── ──┼ ┼────────────────── ─────5
└ ┘──SECURITYNAME(char8) └ ┘─SINGLESESS(YES)─ └ ┘─USEDFLTUSER(YES)─
┌ ┐─XLNACTION(KEEP)──5─ ──┼ ┼────────────────── ─┤ └ ┘─XLNACTION(FORCE)─
Chapter 2. SPI command syntax 93
SPI syntax
CREATE DB2CONN
55─ ──CREATE DB2CONN(data-value) ────────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE DB2CONN
DB2CONN attributes:┌ ┐──CONNECTERROR(sqlcode)
├─ ──┬ ┬───────────────────── ──┼ ┼─────────────────────── ──┬ ┬────────────── ───5└ ┘──DESCRIPTION(char58) └ ┘──CONNECTERROR(abend) ── └ ┘──DB2ID(char4)
┌ ┐──MSGQUEUE1(CDB2) ─5─ ──┼ ┼────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ───────5
└ ┘──MSGQUEUE1(char4) └ ┘──MSGQUEUE2(char4) └ ┘──MSGQUEUE3(char4)
┌ ┐──NONTERMREL(yes) ┌ ┐──PURGECYCLE(ð,3ð) ─────5─ ──┼ ┼───────────────── ──┼ ┼─────────────────────── ──┬ ┬─────────────── ──────5
└ ┘──NONTERMREL(no) ─ └ ┘──PURGECYCLE(ð-59,ð-59) └ ┘──SIGNID(char8)
┌ ┐──STANDBYMODE(reconnect) ┌ ┐──STATSQUEUE(CDB2) ─5─ ──┼ ┼──────────────────────── ──┼ ┼─────────────────── ──────────────────────5
├ ┤──STANDBYMODE(noconnect) └ ┘──STATSQUEUE(char4)└ ┘──STANDBYMODE(connect) ──
┌ ┐──TCBLIMIT(12) ──── ┌ ┐──THREADERROR(n9ð6d) ┌ ┐──ACCOUNTREC(none)5─ ──┼ ┼────────────────── ──┼ ┼──────────────────── ──┼ ┼────────────────── ─────5
└ ┘──TCBLIMIT(4-2ððð) ├ ┤──THREADERROR(abend) ├ ┤──ACCOUNTREC(uow) ─└ ┘──THREADERROR(n9ð6) ─ ├ ┤──ACCOUNTREC(task)
└ ┘──ACCOUNTREC(txid)
┌ ┐──AUTHTYPE(userid) ┌ ┐──DROLLBACK(yes)5─ ──┬ ┬─────────────── ──┼ ┼────────────────── ──┼ ┼──────────────── ────────────5
└ ┘──AUTHID(char8) ├ ┤──AUTHTYPE(group) ─ └ ┘──DROLLBACK(no) ─├ ┤──AUTHTYPE(signid)├ ┤──AUTHTYPE(term) ──├ ┤──AUTHTYPE(txid) ──└ ┘──AUTHTYPE(opid) ──
┌ ┐──PLANEXITNAME(DSNCUEXT) ┌ ┐──PRIORITY(high) ─5─ ──┬ ┬───────────── ──┼ ┼──────────────────────── ──┼ ┼───────────────── ───────5
└ ┘──PLAN(char8) └ ┘──PLANEXITNAME(char8) ─── ├ ┤──PRIORITY(equal)└ ┘──PRIORITY(low) ──
┌ ┐──THREADLIMIT(3) ───── ┌ ┐──THREADWAIT(yes)5─ ──┼ ┼───────────────────── ──┼ ┼───────────────── ──┬ ┬────────────────── ─────5
└ ┘──THREADLIMIT(3-2ððð) └ ┘──THREADWAIT(no) ─ └ ┘──COMAUTHID(char8)
┌ ┐──COMAUTHTYPE(userid) ┌ ┐──COMTHREADLIM(1) ─────5─ ──┼ ┼───────────────────── ──┼ ┼────────────────────── ─┤
├ ┤──COMAUTHTYPE(group) ─ └ ┘──COMTHREADLIM(ð-2ððð)├ ┤──COMAUTHTYPE(signid)├ ┤──COMAUTHTYPE(term) ──├ ┤──COMAUTHTYPE(txid) ──└ ┘──COMAUTHTYPE(user) ──
94 CICS User’s Handbook
SPI syntax
CREATE DB2ENTRY
55─ ──CREATE DB2ENTRY(data-value) ───────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE DB2ENTRY
DB2ENTRY attributes:┌ ┐──ACCOUNTREC(none)
├─ ──┬ ┬───────────────────── ──┬ ┬──────────────── ──┼ ┼────────────────── ──────5└ ┘──DESCRIPTION(char58) └ ┘──TRANSID(char4) ├ ┤──ACCOUNTREC(uow) ─
├ ┤──ACCOUNTREC(task)└ ┘──ACCOUNTREC(txid)
┌ ┐──AUTHTYPE(userid) ┌ ┐──DROLLBACK(yes)5─ ──┬ ┬─────────────── ──┼ ┼────────────────── ──┼ ┼──────────────── ────────────5
└ ┘──AUTHID(char8) ├ ┤──AUTHTYPE(group) ─ └ ┘──DROLLBACK(no) ─├ ┤──AUTHTYPE(signid)├ ┤──AUTHTYPE(term) ──├ ┤──AUTHTYPE(txid) ──└ ┘──AUTHTYPE(opid) ──
┌ ┐──PLANEXITNAME(DSNCUEXT) ┌ ┐──PRIORITY(high) ─5─ ──┬ ┬───────────── ──┼ ┼──────────────────────── ──┼ ┼───────────────── ───────5
└ ┘──PLAN(char8) └ ┘──PLANEXITNAME(char8) ─── ├ ┤──PRIORITY(equal)└ ┘──PRIORITY(low) ──
┌ ┐──PROTECTNUM(ð) ───── ┌ ┐──THREADLIMIT(ð) ─────5─ ──┼ ┼──────────────────── ──┼ ┼───────────────────── ────────────────────────5
└ ┘──PROTECTNUM(ð-2ððð) └ ┘──THREADLIMIT(ð-2ððð)
┌ ┐──THREADWAIT(pool)5─ ──┼ ┼────────────────── ─┤
├ ┤──THREADWAIT(yes) ─└ ┘──THREADWAIT(no) ──
CREATE DB2TRAN
55─ ──CREATE DB2TRAN(data-value) ────────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
Chapter 2. SPI command syntax 95
SPI syntax
CREATE DB2TRAN
DB2TRAN attributes:├─ ──┬ ┬───────────────────── ──ENTRY(char8) ──┬ ┬──────────────── ─┤
└ ┘──DESCRIPTION(char58) └ ┘──TRANSID(char4)
CREATE DOCTEMPLATE
55─ ──CREATE DOCTEMPLATE(data-value) ────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE DOCTEMPLATE
DOCTEMPLATE attributes: ┌ ┐─APPENDCRLF(YES)─├─ ──┼ ┼───────────────── ──┬ ┬───────────────────── ───────────────────────────5
└ ┘─APPENDCRLF(NO)── └ ┘──DESCRIPTION(char58)
5─ ──┬ ┬──FILE(char8) ─────────────────────────── ──┬ ┬────────────────────── ─┤├ ┤──TSQUEUE(char16) ─────────────────────── └ ┘──TEMPLATENAME(char48)├ ┤──TDQUEUE(char4) ────────────────────────├ ┤──PROGRAM(char8) ────────────────────────├ ┤──EXITPGM(char8) ────────────────────────
│ │┌ ┐─DDNAME(DFHHTML)─└ ┘──MEMBERNAME(char8) ──┼ ┼─────────────────
└ ┘──DDNAME(char8) ──
| CREATE ENQMODEL|
| 55─ ──CREATE ENQMODEL(data-value) ───────────────────────────────────────────5
| 5─ ─── ───| ATTRIBUTES(data-value)| ATTRLEN(data-value) ─5%
| Conditions: INVREQ, LENGERR, NOTAUTH
96 CICS User’s Handbook
SPI syntax
| CREATE ENQMODEL|
| ENQMODEL attributes:| ├─ ──┬ ┬───────────────────── ──ENQNAME(char1-255) ──┬ ┬───────────────── ───────5| └ ┘──DESCRIPTION(char58) └ ┘──ENQSCOPE(char4)
| ┌ ┐─STATUS(ENABLED)──| 5─ ──┼ ┼────────────────── ─┤| └ ┘─STATUS(DISABLED)─
CREATE FILE
55─ ──CREATE FILE(data-value) ─── ───ATTRIBUTES(data-value) ───────────────────5
5─ ──ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE FILE
FILE attributes (1/2): ┌ ┐─ADD(NO)── ┌ ┐─BACKUPTYPE(STATIC)── ┌ ┐─BROWSE(NO)──├─ ──┼ ┼────────── ──┼ ┼───────────────────── ──┼ ┼───────────── ─────────────────5 └ ┘─ADD(YES)─ └ ┘─BACKUPTYPE(DYNAMIC)─ └ ┘─BROWSE(YES)─
┌ ┐─DATABUFFERS(2)─────── ┌ ┐─DELETE(NO)──5─ ──┬ ┬───────────────── ──┼ ┼────────────────────── ──┼ ┼───────────── ─────────5
| └ ┘──CFDTPOOL(char8) └ ┘──DATABUFFERS(2-32767) └ ┘─DELETE(YES)─
┌ ┐─DISPOSITION(SHARE)─5─ ──┬ ┬───────────────────── ──┼ ┼──────────────────── ──┬ ┬──────────────── ────5
└ ┘──DESCRIPTION(char58) └ ┘─DISPOSITION(OLD)─── └ ┘──DSNAME(char44)
┌ ┐─DSNSHARING(ALLREQS)──── ┌ ┐─FWDRECOVLOG(NO)───5─ ──┼ ┼──────────────────────── ──┼ ┼─────────────────── ──────────────────────5
└ ┘─DSNSHARING(MODIFYREQS)─ └ ┘──FWDRECOVLOG(1-99)
┌ ┐─INDEXBUFFERS(1)─────── ┌ ┐─JNLADD(NONE)───5─ ──┼ ┼─────────────────────── ──┼ ┼──────────────── ──────────────────────────5
└ ┘──INDEXBUFFERS(1-32767) ├ ┤─JNLADD(AFTER)── ├ ┤─JNLADD(ALL)──── └ ┘─JNLADD(BEFORE)─
┌ ┐─JNLREAD(NONE)─────── ┌ ┐─JNLSYNCREAD(NO)── ┌ ┐─JNLSYNCWRITE(YES)─5─ ──┼ ┼───────────────────── ──┼ ┼────────────────── ──┼ ┼─────────────────── ───5 ├ ┤─JNLREAD(ALL)──────── └ ┘─JNLSYNCREAD(YES)─ └ ┘─JNLSYNCWRITE(NO)── ├ ┤─JNLREAD(READONLY)─── └ ┘─JNLREAD(UPDATEONLY)─
┌ ┐─JNLUPDATE(NO)── ┌ ┐─JOURNAL(NO)───5─ ──┼ ┼──────────────── ──┼ ┼─────────────── ─┤
└ ┘─JNLUPDATE(YES)─ └ ┘──JOURNAL(1-99)
Chapter 2. SPI command syntax 97
SPI syntax
CREATE FILE
FILE attributes (2/2):| ┌ ┐─LOAD(NO)──
├─ ──┬ ┬──────────────────────────────── ──┼ ┼─────────── ──────────────────────5| └ ┘──KEYLENGTH(1-255|1-16 for CFDT) └ ┘─LOAD(YES)─
| ┌ ┐─LSRPOOLID(1)──── ┌ ┐─MAXNUMRECS(NOLIMIT)────────5─ ──┼ ┼───────────────── ──┼ ┼──────────────────────────── ────────────────────5 ├ ┤─LSRPOOLID(NONE)─ └ ┘──┬ ┬────────────────────────
| └ ┘──LSRPOOLID(1-8) ─ └ ┘──MAXNUMRECS(1-99999999)
┌ ┐─OPENTIME(FIRSTREF)─5─ ──┬ ┬───────────────── ──┼ ┼──────────────────── ──┬ ┬───────────────── ───────5
└ ┘──NSRGROUP(char8) └ ┘─OPENTIME(STARTUP)── └ ┘──PASSWORD(char8)
┌ ┐─READ(YES)─ ┌ ┐─READINTEG(UNCOMMITTED)─ ┌ ┐─RECORDFORMAT(V)─5─ ──┼ ┼─────────── ──┼ ┼──────────────────────── ──┼ ┼───────────────── ─────────5 └ ┘─READ(NO)── ├ ┤─READINTEG(CONSISTENT)── └ ┘─RECORDFORMAT(F)─ └ ┘─READINTEG(REPEATABLE)──
┌ ┐─RECOVERY(NONE)────────5─ ──┬ ┬───────────────────── ──┼ ┼─────────────────────── ─────────────────────5
└ ┘──RECORDSIZE(1-32767) ├ ┤─RECOVERY(ALL)───────── └ ┘─RECOVERY(BACKOUTONLY)─
┌ ┐─RLSACCESS(NO)──5─ ──┬ ┬──────────────────────────────────────────── ──┼ ┼──────────────── ─────5
└ ┘──REMOTESYSTEM(char4) ──┬ ┬─────────────────── └ ┘─RLSACCESS(YES)─└ ┘──REMOTENAME(char8)
┌ ┐─STATUS(ENABLED)─── ┌ ┐─STRINGS(1)───── ┌ ┐─TABLE(NO)───5─ ──┼ ┼─────────────────── ──┼ ┼──────────────── ──┼ ┼───────────── ─────────────5
| ├ ┤─STATUS(DISABLED)── └ ┘──STRINGS(1-255) ├ ┤─TABLE(CF)─── └ ┘─STATUS(UNENABLED)─ ├ ┤─TABLE(CICS)─ └ ┘─TABLE(USER)─
| ┌ ┐─UPDATE(NO)── ┌ ┐─UPDATEMODEL(LOCKING)────5─ ──┬ ┬────────────────── ──┼ ┼───────────── ──┼ ┼───────────────────────── ─┤
| └ ┘──TABLENAME(char8) └ ┘─UPDATE(YES)─ └ ┘─UPDATEMODEL(CONTENTION)─
CREATE JOURNALMODEL
55─ ──CREATE JOURNALMODEL(data-value) ───────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
98 CICS User’s Handbook
SPI syntax
CREATE JOURNALMODEL
JOURNALMODEL attributes:├─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5
└ ┘──DESCRIPTION(char58) └ ┘──JOURNALNAME(char8)
┌ ┐──STREAMNAME(&USERID..&APPLID..&JNAME;) ┌ ┐─TYPE(MVS)───5─ ──┼ ┼─────────────────────────────────────── ──┼ ┼───────────── ─┤
└ ┘──STREAMNAME(char26) ─────────────────── ├ ┤─TYPE(DUMMY)─ └ ┘─TYPE(SMF)───
CREATE LSRPOOL
55─ ──CREATE LSRPOOL(data-value) ──ATTRIBUTES(data-value) ────────────────────5
5─ ──ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
Chapter 2. SPI command syntax 99
SPI syntax
CREATE LSRPOOL
LSRPOOL attributes:├─ ──┬ ┬────────────────── ──┬ ┬───────────────── ──┬ ┬───────────────── ─────────5
└ ┘──DATA512(3-32767) └ ┘──DATA1K(3-32767) └ ┘──DATA2K(3-32767)
5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┬ ┬────────────────── ─────────5└ ┘──DATA4K(3-32767) └ ┘──DATA8K(3-32767) └ ┘──DATA12K(3-32767)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ───────5└ ┘──DATA16K(3-32767) └ ┘──DATA2ðK(3-32767) └ ┘──DATA24K(3-32767)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ────5└ ┘──DATA28K(3-32767) └ ┘──DATA32K(3-32767) └ ┘──DESCRIPTION(char58)
5─ ──┬ ┬────────────────────── ──┬ ┬────────────────────── ─────────────────────5└ ┘──HSDATA4K(ð-16777215) └ ┘──HSDATA8K(ð-16777215)
5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSDATA12K(ð-16777215) └ ┘──HSDATA16K(ð-16777215)
5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSDATA2ðK(ð-16777215) └ ┘──HSDATA24K(ð-16777215)
5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSDATA28K(ð-16777215) └ ┘──HSDATA32K(ð-16777215)
5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──HSINDEX4K(ð-16777215) └ ┘──HSINDEX8K(ð-16777215)
5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─────────────────5└ ┘──HSINDEX12K(ð-16777215) └ ┘──HSINDEX16K(ð-16777215)
5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─────────────────5└ ┘──HSINDEX2ðK(ð-16777215) └ ┘──HSINDEX24K(ð-16777215)
5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─────────────────5└ ┘──HSINDEX28K(ð-16777215) └ ┘──HSINDEX32K(ð-16777215)
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ──────5└ ┘──INDEX512(3-32767) └ ┘──INDEX1K(3-32767) └ ┘──INDEX2K(3-32767)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ──────5└ ┘──INDEX4K(3-32767) └ ┘──INDEX8K(3-32767) └ ┘──INDEX12K(3-32767)
5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┬ ┬─────────────────── ────5└ ┘──INDEX16K(3-32767) └ ┘──INDEX2ðK(3-32767) └ ┘──INDEX24K(3-32767)
┌ ┐─LSRPOOLID(1)───5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┼ ┼──────────────── ───────5
└ ┘──INDEX28K(3-32767) └ ┘──INDEX32K(3-32767) └ ┘──LSRPOOLID(1-8)
┌ ┐─SHARELIMIT(5ð)────5─ ──┬ ┬───────────────────── ──┼ ┼─────────────────── ──┬ ┬──────────────── ─┤
└ ┘──MAXKEYLENGTH(ð-255) └ ┘──SHARELIMIT(1-1ðð) └ ┘──STRINGS(1-255)
CREATE MAPSET
55─ ──CREATE MAPSET(data-value) ─────────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
100 CICS User’s Handbook
SPI syntax
CREATE MAPSET
MAPSET attributes: ┌ ┐─RESIDENT(NO)── ┌ ┐─STATUS(ENABLED)──├─ ──┬ ┬───────────────────── ──┼ ┼─────────────── ──┼ ┼────────────────── ───────5
└ ┘──DESCRIPTION(char58) └ ┘─RESIDENT(YES)─ └ ┘─STATUS(DISABLED)─
┌ ┐─USAGE(NORMAL)──── ┌ ┐─USELPACOPY(NO)──5─ ──┼ ┼────────────────── ──┼ ┼───────────────── ─┤ └ ┘─USAGE(TRANSIENT)─ └ ┘─USELPACOPY(YES)─
CREATE PARTITIONSET
55─ ──CREATE PARTITIONSET(data-value) ───────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE PARTITIONSET
PARTITIONSET attributes: ┌ ┐─RESIDENT(NO)── ┌ ┐─STATUS(ENABLED)──├─ ──┬ ┬───────────────────── ──┼ ┼─────────────── ──┼ ┼────────────────── ───────5
└ ┘──DESCRIPTION(char58) └ ┘─RESIDENT(YES)─ └ ┘─STATUS(DISABLED)─
┌ ┐─USAGE(NORMAL)──── ┌ ┐─USELPACOPY(NO)──5─ ──┼ ┼────────────────── ──┼ ┼───────────────── ─┤ └ ┘─USAGE(TRANSIENT)─ └ ┘─USELPACPOY(YES)─
CREATE PARTNER
55─ ──CREATE PARTNER(data-value) ────────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
Chapter 2. SPI command syntax 101
SPI syntax
CREATE PARTNER
PARTNER attributes:├─ ──┬ ┬───────────────────── ──NETNAME(char8) ──┬ ┬──────────────── ────────────5
└ ┘──DESCRIPTION(char58) └ ┘──NETWORK(char8)
┌ ┐─PROFILE(DFHCICSA)─5─ ──┼ ┼─────────────────── ──┬ ┬──TPNAME(char64) ─ ─┤
└ ┘──PROFILE(char8) ─── └ ┘──XTPNAME(hex128)
CREATE PROCESSTYPE
55─ ──CREATE PROCESSTYPE(data-value) ──ATTRIBUTES(data-value) ────────────────5
5─ ──ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE PROCESSTYPE
PROCESSTYPE attributes:├─ ──┬ ┬───────────────────── ──FILE(char8) ──┬ ┬───────────────── ──────────────5
└ ┘──DESCRIPTION(char58) └ ┘──AUDITLOG(char8)
┌ ┐─AUDITLEVEL(OFF)────── ┌ ┐─STATUS(ENABLED)──5─ ──┼ ┼────────────────────── ──┼ ┼────────────────── ─┤ ├ ┤─AUDITLEVEL(ACTIVITY)─ └ ┘─STATUS(DISABLED)─ ├ ┤─AUDITLEVEL(FULL)───── └ ┘─AUDITLEVEL(PROCESS)──
CREATE PROFILE
55─ ──CREATE PROFILE(data-value) ────────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
102 CICS User’s Handbook
SPI syntax
CREATE PROFILE
PROFILE attributes: ┌ ┐─CHAINCONTROL(NO)── ┌ ┐─DVSUPRT(ALL)─────├─ ──┼ ┼─────────────────── ──┬ ┬───────────────────── ──┼ ┼────────────────── ───5
└ ┘─CHAINCONTROL(YES)─ └ ┘──DESCRIPTION(char58) ├ ┤─DVSUPRT(NONVTAM)─ └ ┘─DVSUPRT(VTAM)────
┌ ┐─INBFMH(NO)─── ┌ ┐─JOURNAL(NO)─── ┌ ┐─LOGREC(NO)──5─ ──┼ ┼────────────── ──┼ ┼─────────────── ──┼ ┼───────────── ───────────────────5
├ ┤─INBFMH(ALL)── └ ┘──JOURNAL(1-99) └ ┘─LOGREC(YES)─ ├ ┤─INBFMH(DIP)── └ ┘─INBFMH(EODS)─
┌ ┐─MSGINTEG(NO)── ┌ ┐─MSGJRNL(NO)─────5─ ──┬ ┬───────────────── ──┼ ┼─────────────── ──┼ ┼───────────────── ────────────5
└ ┘──MODENAME(char8) └ ┘─MSGINTEG(YES)─ ├ ┤─MSGJRNL(INOUT)── ├ ┤─MSGJRNL(INPUT)── └ ┘─MSGJRNL(OUTPUT)─
┌ ┐─NEPCLASS(ð)───── ┌ ┐─ONEWTE(NO)── ┌ ┐─PRINTERCOMP(NO)──5─ ──┼ ┼───────────────── ──┼ ┼───────────── ──┼ ┼────────────────── ─────────────5
└ ┘──NEPCLASS(ð-255) └ ┘─ONEWTE(YES)─ └ ┘─PRINTERCOMP(YES)─
┌ ┐─PROTECT(NO)── ┌ ┐─RAQ(NO)── ┌ ┐─RTIMOUT(NO)─────5─ ──┼ ┼────────────── ──┼ ┼────────── ──┼ ┼───────────────── ────────────────────5
└ ┘─PROTECT(YES)─ └ ┘─RAQ(YES)─ └ ┘──RTIMOUT(1-7ððð)
┌ ┐─SCRNSIZE(DEFAULT)─── ┌ ┐─UCTRAN(NO)──5─ ──┼ ┼───────────────────── ──┼ ┼───────────── ─┤ └ ┘─SCRNSIZE(ALTERNATE)─ └ ┘─UCTRAN(YES)─
CREATE PROGRAM
55─ ──CREATE PROGRAM(data-value) ────────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
Chapter 2. SPI command syntax 103
SPI syntax
CREATE PROGRAM
PROGRAM attributes: ┌ ┐─CEDF(YES)─ ┌ ┐─CONCURRENCY(QUASIRENT)── ┌ ┐─DATALOCATION(BELOW)─├─ ──┼ ┼─────────── ──┼ ┼───────────────────────── ──┼ ┼───────────────────── ────5 └ ┘─CEDF(NO)── └ ┘─CONCURRENCY(THREADSAFE)─ └ ┘─DATALOCATION(ANY)───
┌ ┐─EXECKEY(USER)─5─ ──┬ ┬───────────────────── ──┼ ┼─────────────── ─────────────────────────────5
└ ┘──DESCRIPTION(char58) └ ┘─EXECKEY(CICS)─
| ┌ ┐─EXECUTIONSET(FULLAPI)─── ┌ ┐─JVM(NO)────5─ ──┼ ┼───────────────────────── ──┬ ┬─────────────────── ──┼ ┼──────────── ─────5
| └ ┘─EXECUTIONSET(DPLSUBSET)─ └ ┘──JVMCLASS(char255) ├ ┤─JVM(DEBUG)─| └ ┘─JVM(YES)───
┌ ┐─RELOAD(NO)──5─ ──┬ ┬───────────────────── ──┼ ┼───────────── ───────────────────────────────5 ├ ┤─LANGUAGE(ASSEMBLER)─ └ ┘─RELOAD(YES)─ ├ ┤─LANGUAGE(C)───────── ├ ┤─LANGUAGE(COBOL)───── ├ ┤─LANGUAGE(LE37ð)───── └ ┘─LANGUAGE(PLI)───────
┌ ┐─RESIDENT(NO)──5─ ──┬ ┬──────────────────────────────────────────── ──┼ ┼─────────────── ──────5
└ ┘──REMOTESYSTEM(char4) ──┬ ┬─────────────────── └ ┘─RESIDENT(YES)─└ ┘──REMOTENAME(char8)
┌ ┐─STATUS(ENABLED)── ┌ ┐─USAGE(NORMAL)────5─ ──┼ ┼────────────────── ──┬ ┬──────────────── ──┼ ┼────────────────── ─────────5
└ ┘─STATUS(DISABLED)─ └ ┘──TRANSID(char4) └ ┘─USAGE(TRANSIENT)─
┌ ┐─USELPACOPY(NO)──5─ ──┼ ┼───────────────── ─┤ └ ┘─USELPACOPY(YES)─
CREATE REQUESTMODEL
55─ ──CREATE REQUESTMODEL(data-value) ───────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE REQUESTMODEL
REQUESTMODEL attributes:├─ ──┬ ┬───────────────────── ──OMGMODULE(char58) ──OMGINTERFACE(char31) ───────5
└ ┘──DESCRIPTION(char58)
5─ ──OMGOPERATION(char31) ──TRANSID(char4) ─┤
104 CICS User’s Handbook
SPI syntax
CREATE SESSIONS
55─ ──CREATE SESSIONS(data-value) ───────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE SESSIONS
SESSIONS attributes: ┌ ┐─AUTOCONNECT(NO)── ┌ ┐─BUILDCHAIN(YES)─├─ ──┼ ┼────────────────── ──┼ ┼───────────────── ──CONNECTION(char4) ───────────5 ├ ┤─AUTOCONNECT(ALL)─ └ ┘─BUILDCHAIN(NO)── └ ┘─AUTOCONNECT(YES)─
┌ ┐─DISCREQ(NO)──5─ ──┬ ┬───────────────────── ──┼ ┼────────────── ──────────────────────────────5
└ ┘──DESCRIPTION(char58) └ ┘─DISCREQ(YES)─
┌ ┐─IOAREALEN(ð,ð)───────────── ┌ ┐─MAXIMUM(1,ð)─────────5─ ──┼ ┼──────────────────────────── ──┼ ┼────────────────────── ───────────────5
└ ┘──IOAREALEN(ð-32767,ð-32767) └ ┘──MAXIMUM(ð-999,ð-999)
┌ ┐─NEPCLASS(ð)─────5─ ──┬ ┬───────────────── ──┼ ┼───────────────── ──┬ ┬───────────────── ──────────5
└ ┘──MODENAME(char8) └ ┘──NEPCLASS(ð-255) └ ┘──NETNAMEQ(char8)
┌ ┐─PROTOCOL(APPC)─5─ ──┼ ┼──────────────── ──┬ ┬───────────────────── ──┬ ┬─────────────────── ─────5
├ ┤─PROTOCOL(LU61)─ └ ┘──RECEIVECOUNT(1-999) └ ┘──RECEIVEPFX(char2) └ ┘─PROTOCOL(EXCI)─
┌ ┐─RECEIVESIZE(4ð96)──── ┌ ┐─RECOVOPTION(SYSDEFAULT)──5─ ──┼ ┼────────────────────── ──┼ ┼────────────────────────── ─────────────────5
└ ┘──RECEIVESIZE(1-3ð72ð) ├ ┤─RECOVOPTION(CLEARCONV)─── ├ ┤─RECOVOPTION(NONE)──────── ├ ┤─RECOVOPTION(RELEASESESS)─ └ ┘─RECOVOPTION(UNCONDREL)───
┌ ┐─RELREQ(NO)──5─ ──┼ ┼───────────── ──┬ ┬────────────────── ──┬ ┬──────────────── ──────────────5
└ ┘─RELREQ(YES)─ └ ┘──SENDCOUNT(1-999) └ ┘──SENDPFX(char2)
┌ ┐─SENDSIZE(4ð96)──── ┌ ┐─SESSPRIORITY(ð)─────5─ ──┼ ┼─────────────────── ──┬ ┬───────────────── ──┼ ┼───────────────────── ────5
└ ┘──SENDSIZE(1-3ð72ð) └ ┘──SESSNAME(char4) └ ┘──SESSPRIORITY(ð-255)
┌ ┐─USERAREALEN(ð)─────5─ ──┼ ┼──────────────────── ──┬ ┬─────────────── ─┤
└ ┘──USERAREALEN(ð-255) └ ┘──USERID(char8)
Chapter 2. SPI command syntax 105
SPI syntax
CREATE TCPIPSERVICE
55─ ──CREATE TCPIPSERVICE(data-value) ───────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
CREATE TCPIPSERVICE
TCPIPSERVICE attributes:┌ ┐──BACKLOG(ð) ──────
├─ ──┼ ┼────────────────── ──┬ ┬───────────────────── ──────────────────────────5└ ┘──BACKLOG(ð-32767) └ ┘──CERTIFICATE(char44)
5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ──┬ ┬───────────────── ────5└ ┘──DESCRIPTION(char58) └ ┘──IPADDRESS(char15) └ ┘──KEYFILE(char44)
┌ ┐─SSL(NO)───────── ┌ ┐─STATUS(OPEN)───5─ ──PORTNUMBER(1-32767) ──┼ ┼───────────────── ──┼ ┼──────────────── ───────────5 ├ ┤─SSL(YES)──────── └ ┘─STATUS(CLOSED)─ └ ┘─SSL(CLIENTAUTH)─
5─ ──TRANSACTION(char4) ──┬ ┬────────────────── ──┬ ┬──────────── ─┤└ ┘──TSQPREFIX(char6) └ ┘──URM(char8)
CREATE TDQUEUE
55─ ──CREATE TDQUEUE(data-value) ────────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
106 CICS User’s Handbook
SPI syntax
TDQUEUE attributes for extra-partition queues:├─ ──TYPE(EXTRA) ──┬ ┬──────────────────────── ─────────────────────5 ├ ┤─BLOCKFORMAT(BLOCKED)─── └ ┘─BLOCKFORMAT(UNBLOCKED)─
┌ ┐─BLOCKSIZE(ð)─────── ┌ ┐─DATABUFFERS(1)─────5─ ──┼ ┼──────────────────── ──┼ ┼──────────────────── ──────────────5
└ ┘──BLOCKSIZE(ð-32767) └ ┘──DATABUFFERS(1-255)
5─ ──DDNAME(char8) ──┬ ┬───────────────────── ──────────────────────5└ ┘──DESCRIPTION(char58)
┌ ┐─DISPOSITION(SHR)─5─ ──┼ ┼────────────────── ──┬ ┬──────────────── ────────────────────5 ├ ┤─DISPOSITION(OLD)─ ├ ┤─DSNAME(DUMMY)──
└ ┘─DISPOSITION(MOD)─ └ ┘──DSNAME(char44)
┌ ┐─ERROROPTION(IGNORE)─ ┌ ┐─OPENTIME(INITIAL)──5─ ──┼ ┼───────────────────── ──┼ ┼──────────────────── ─────────────5 └ ┘─ERROROPTION(SKIP)─── └ ┘─OPENTIME(DEFERRED)─
5─ ──┬ ┬───────────────── ──┬ ┬──────────────────────── ─────────────5 ├ ┤─PRINTCONTROL(A)─ ├ ┤─RECORDFORMAT(FIXED)──── └ ┘─PRINTCONTROL(M)─ └ ┘─RECORDFORMAT(VARIABLE)─
┌ ┐─RECORDSIZE(ð)───────5─ ──┼ ┼───────────────────── ─────────────────────────────────────5
└ ┘──RECORDSIZE(ð-32767)
5─ ──┬ ┬────────────────────────────────────────────────── ────────5 │ │┌ ┐───────────────────────────
└ ┘──REMOTESYSTEM(char4) ───6
┴┬ ┬───────────────────────├ ┤──REMOTELENGTH(ð-32767)└ ┘──REMOTENAME(char4) ────
┌ ┐─SYSOUTCLASS(\)─────5─ ──┬ ┬──────────────── ──┼ ┼──────────────────── ──────────────────5
├ ┤─REWIND(LEAVE)── └ ┘──SYSOUTCLASS(char1) └ ┘─REWIND(REREAD)─
┌ ┐─TYPEFILE(INPUT)──5─ ──┼ ┼────────────────── ────────────────────────────────────────┤ ├ ┤─TYPEFILE(OUTPUT)─ └ ┘─TYPEFILE(RDBACK)─
Chapter 2. SPI command syntax 107
SPI syntax
TDQUEUE attributes for intra-partition queues: ┌ ┐─ATIFACILITY(TERMINAL)─├─ ──TYPE(INTRA) ──┼ ┼─────────────────────── ──────────────────────5 ├ ┤─ATIFACILITY(FILE)───── └ ┘─ATIFACILITY(SYSTEM)───
5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ──────────────5└ ┘──DESCRIPTION(char58) └ ┘──FACILITYID(char4)
┌ ┐─RECOVSTATUS(NO)───────5─ ──┼ ┼─────────────────────── ───────────────────────────────────5 ├ ┤─RECOVSTATUS(LOGICAL)── └ ┘─RECOVSTATUS(PHYSICAL)─
5─ ──┬ ┬────────────────────────────────────────────────── ────────5 │ │┌ ┐───────────────────────────
└ ┘──REMOTESYSTEM(char4) ───6
┴┬ ┬───────────────────────├ ┤──REMOTELENGTH(ð-32767)└ ┘──REMOTENAME(char4) ────
┌ ┐─TRIGGERLEVEL(1)───────5─ ──┬ ┬──────────────── ──┼ ┼─────────────────────── ───────────────5
└ ┘──TRANSID(char4) └ ┘──TRIGGERLEVEL(ð-32767)
┌ ┐─WAIT(YES)─ ┌ ┐─WAITACTION(REJECT)─5─ ──┬ ┬─────────────── ──┼ ┼─────────── ──┼ ┼──────────────────── ────┤
└ ┘──USERID(char8) └ ┘─WAIT(NO)── └ ┘─WAITACTION(QUEUE)──
TDQUEUE attributes for indirect queues:├─ ──TYPE(INDIRECT) ──┬ ┬───────────────────── ─────────────────────5
└ ┘──DESCRIPTION(char58)
5─ ──INDIRECTNAME(char4) ─────────────────────────────────────────5
5─ ──┬ ┬────────────────────────────────────────────────── ────────┤ │ │┌ ┐───────────────────────────
└ ┘──REMOTESYSTEM(char4) ───6
┴┬ ┬───────────────────────├ ┤──REMOTELENGTH(ð-32767)└ ┘──REMOTENAME(char4) ────
108 CICS User’s Handbook
SPI syntax
TDQUEUE attributes for remote queues of unspecified TYPE:├─ ──┬ ┬───────────────────── ──┬ ┬─────────────────────── ──────────5
└ ┘──DESCRIPTION(char58) └ ┘──REMOTELENGTH(ð-32767)
5─ ──┬ ┬─────────────────── ──REMOTESYSTEM(char4) ──────────────────┤└ ┘──REMOTENAME(char4)
CREATE TERMINAL
55─ ──CREATE TERMINAL(data-value) ───────────────────────────────────────────5
5─ ──┬ ┬──ATTRIBUTES(data-value)ATTRLEN(data-value) ─5% ├ ┤─COMPLETE────────────────────────────────── └ ┘─DISCARD───────────────────────────────────
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
Chapter 2. SPI command syntax 109
SPI syntax
CREATE TERMINAL
TERMINAL attributes: ┌ ┐─ALTPRINTCOPY(NO)──├─ ──┼ ┼─────────────────── ──┬ ┬─────────────────── ───────────────────────────5
└ ┘─ALTPRINTCOPY(YES)─ └ ┘──ALTPRINTER(char4)
┌ ┐─ATTACHSEC(LOCAL)────── ┌ ┐─AUTINSTMODEL(NO)───5─ ──┼ ┼─────────────────────── ──┼ ┼──────────────────── ──────────────────────5 ├ ┤─ATTACHSEC(IDENTIFY)─── ├ ┤─AUTINSTMODEL(ONLY)─ ├ ┤─ATTACHSEC(MIXIDPE)──── └ ┘─AUTINSTMODEL(YES)── ├ ┤─ATTACHSEC(PERSISTENT)─ └ ┘─ATTACHSEC(VERIFY)─────
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ────────────────────────5└ ┘──AUTINSTNAME(char8) └ ┘──BINDPASSWORD(hex16)
┌ ┐─BINDSECURITY(NO)── ┌ ┐─CONSOLE(NO)─────5─ ──┼ ┼─────────────────── ──┼ ┼───────────────── ──┬ ┬───────────────────── ────5
└ ┘─BINDSECURITY(YES)─ ├ ┤──CONSOLE(ð-25ð) ─ └ ┘──DESCRIPTION(char58)└ ┘──CONSNAME(char8)
┌ ┐─INSERVICE(YES)─5─ ──┼ ┼──────────────── ──┬ ┬───────────────── ──┬ ┬──────────── ────────────────5
└ ┘─INSERVICE(NO)── └ ┘──MODENAME(char8) ├ ┤─NATLANG(E)─ └ ┘─NATLANG(K)─
5─ ──┬ ┬──────────────── ──┬ ┬───────────── ──┬ ┬──────────────── ────────────────5└ ┘──NETNAME(char8) └ ┘──POOL(char8) └ ┘──PRINTER(char4)
┌ ┐─PRINTERCOPY(NO)──5─ ──┼ ┼────────────────── ──┬ ┬───────────────────── ──────────────────────────5
└ ┘─PRINTERCOPY(YES)─ └ ┘──REMOTESYSNET(char8)
5─ ──┬ ┬──────────────────────────────────────────── ─────────────────────────5└ ┘──REMOTESYSTEM(char4) ──┬ ┬───────────────────
└ ┘──REMOTENAME(char4)
┌ ┐─TASKLIMIT(NO)──────5─ ──┬ ┬───────────────────── ──┼ ┼──────────────────── ────────────────────────5
└ ┘──SECURITYNAME(char8) └ ┘──TASKLIMIT(1-32767)
┌ ┐─TERMPRIORITY(ð)─────5─ ──┼ ┼───────────────────── ──┬ ┬──────────────────── ──TYPETERM(char8) ───────5
└ ┘──TERMPRIORITY(ð-255) └ ┘──TRANSACTION(char4)
5─ ──┬ ┬─────────────── ─┤└ ┘──USERID(char8)
CREATE TRANCLASS
55─ ──CREATE TRANCLASS(data-value) ──────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
110 CICS User’s Handbook
SPI syntax
CREATE TRANCLASS
TRANCLASS attributes:├─ ──┬ ┬───────────────────── ──MAXACTIVE(ð-999) ──────────────────────────────5
└ ┘──DESCRIPTION(char58)
┌ ┐─PURGETHRESH(NO)────────5─ ──┼ ┼──────────────────────── ─┤
└ ┘──PURGETHRESH(1-1ðððððð)
CREATE TRANSACTION
55─ ──CREATE TRANSACTION(data-value) ────────────────────────────────────────5
5─ ─── ───ATTRIBUTES(data-value)ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
Chapter 2. SPI command syntax 111
SPI syntax
CREATE TRANSACTION
TRANSACTION attributes: ┌ ┐─ACTION(BACKOUT)─├─ ──┼ ┼───────────────── ──┬ ┬────────────── ──┬ ┬─────────────── ───────────────5
└ ┘─ACTION(COMMIT)── └ ┘──ALIAS(char4) └ ┘──BREXIT(char8)
┌ ┐─CMDSEC(NO)── ┌ ┐─CONFDATA(NO)──5─ ──┼ ┼───────────── ──┼ ┼─────────────── ──┬ ┬───────────────────── ────────────5
└ ┘─CMDSEC(YES)─ └ ┘─CONFDATA(YES)─ └ ┘──DESCRIPTION(char58)
┌ ┐─DTIMOUT(NO)───── ┌ ┐─DUMP(YES)─ ┌ ┐─DYNAMIC(NO)──5─ ──┼ ┼───────────────── ──┼ ┼─────────── ──┼ ┼────────────── ───────────────────5
└ ┘──DTIMOUT(1-68ðð) └ ┘─DUMP(NO)── └ ┘─DYNAMIC(YES)─
┌ ┐─INDOUBT(BACKOUT)─ ┌ ┐─ISOLATE(YES)─ ┌ ┐─LOCALQ(NO)──5─ ──┼ ┼────────────────── ──┼ ┼────────────── ──┼ ┼───────────── ────────────────5 ├ ┤─INDOUBT(COMMIT)── └ ┘─ISOLATE(NO)── └ ┘─LOCALQ(YES)─ └ ┘─INDOUBT(WAIT)────
┌ ┐─PRIORITY(1)───── ┌ ┐─PROFILE(DFHCICST)─5─ ──┬ ┬───────────────────── ──┼ ┼───────────────── ──┼ ┼─────────────────── ────5
├ ┤──PARTITIONSET(char8) └ ┘──PRIORITY(ð-255) └ ┘──PROFILE(char8) ─── ├ ┤─PARTITIONSET(KEEP)── └ ┘─PARTITIONSET(OWN)───
┌ ┐─RESSEC(NO)──5─ ──┬ ┬──PROGRAM(char8) ──────────────────────────── ──┼ ┼───────────── ────────5
└ ┘──REMOTESYSTEM(char4) ──┬ ┬─────────────────── └ ┘─RESSEC(YES)─└ ┘──REMOTENAME(char8)
┌ ┐─RESTART(NO)── ┌ ┐─RUNAWAY(SYSTEM)──── ┌ ┐─SHUTDOWN(DISABLED)─5─ ──┼ ┼────────────── ──┼ ┼──────────────────── ──┼ ┼──────────────────── ───────5
└ ┘─RESTART(YES)─ └ ┘──RUNAWAY(ð-27ððððð) └ ┘─SHUTDOWN(ENABLED)──
┌ ┐─SPURGE(NO)── ┌ ┐─STATUS(ENABLED)── ┌ ┐─STORAGECLEAR(NO)──5─ ──┼ ┼───────────── ──┼ ┼────────────────── ──┼ ┼─────────────────── ───────────5 └ ┘─SPURGE(YES)─ └ ┘─STATUS(DISABLED)─ └ ┘─STORAGECLEAR(YES)─
┌ ┐─TASKDATAKEY(USER)─ ┌ ┐─TASKDATALOC(BELOW)─5─ ──┼ ┼─────────────────── ──┼ ┼──────────────────── ──┬ ┬───────────────── ─────5 └ ┘─TASKDATAKEY(CICS)─ └ ┘─TASKDATALOC(ANY)─── ├ ┤─TASKREQ(LPA)──── ├ ┤─TASKREQ(MSRE)─── ├ ┤─TASKREQ(OPID)───
├ ┤──TASKREQ(PA1-3) ─└ ┘──TASKREQ(PF1-24)
┌ ┐─TPURGE(NO)── ┌ ┐─TRACE(YES)─5─ ──┬ ┬───────────────── ──┼ ┼───────────── ──┼ ┼──────────── ───────────────────5
├ ┤──TPNAME(char64) ─ └ ┘─TPURGE(YES)─ └ ┘─TRACE(NO)──└ ┘──XTPNAME(hex128)
┌ ┐─TRANCLASS(DFHTCLðð)─ ┌ ┐─TRPROF(DFHCICSS)─ ┌ ┐─TWASIZE(ð)───────5─ ──┼ ┼───────────────────── ──┼ ┼────────────────── ──┼ ┼────────────────── ────5
└ ┘──TRANCLASS(char8) ─── └ ┘──TRPROF(char8) ─── └ ┘──TWASIZE(ð-32767)
┌ ┐─WAIT(YES)─ ┌ ┐─WAITTIME(ð,ð,ð)──────────5─ ──┼ ┼─────────── ──┼ ┼────────────────────────── ──┬ ┬─────────────── ─┤
└ ┘─WAIT(NO)── └ ┘──WAITTIME(ð-99,ð-23,ð-59) └ ┘──XTRANID(hex8)
112 CICS User’s Handbook
SPI syntax
| CREATE TSMODEL|
| 55─ ──CREATE TSMODEL(data-value) ────────────────────────────────────────────5
| 5─ ─── ───| ATTRIBUTES(data-value)| ATTRLEN(data-value) ─5%
| Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
| CREATE TSMODEL|
| TSMODEL attributes:| ┌ ┐─LOCATION(AUXILIARY)─| ├─ ──┬ ┬───────────────────── ──┼ ┼───────────────────── ───────────────────────5| └ ┘──DESCRIPTION(char58) └ ┘─LOCATION(MAIN)──────
| ┌ ┐─RECOVERY(NO)──| 5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┼ ┼─────────────── ────────────5| └ ┘──POOLNAME(char8) ├ ┤──PREFIX(char16) ─ └ ┘─RECOVERY(YES)─| └ ┘──XPREFIX(char32)
| ┌ ┐─SECURITY(NO)──| 5─ ──┬ ┬─────────────────────────────────────────────── ──┼ ┼─────────────── ─┤| └ ┘──REMOTESYSTEM(char4) ──┬ ┬────────────────────── └ ┘─SECURITY(YES)─| ├ ┤──REMOTEPREFIX(char16)| └ ┘──XREMOTEPFX(char32) ──
CREATE TYPETERM
55─ ──CREATE TYPETERM(data-value) ──ATTRIBUTES(data-value) ───────────────────5
5─ ──ATTRLEN(data-value) ─5%
Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH
Chapter 2. SPI command syntax 113
SPI syntax
CREATE TYPETERM
TYPETERM attributes (1/3): ┌ ┐─ALTPAGE(ð,ð)─────────├─ ──┼ ┼────────────────────── ──┬ ┬──────────────────────── ───────────────────5
└ ┘──ALTPAGE(ð-999,ð-999) └ ┘──ALTSCREEN(ð-999,ð-999)
┌ ┐─APLKYBD(NO)── ┌ ┐─APLTEXT(NO)──5─ ──┬ ┬────────────────── ──┼ ┼────────────── ──┼ ┼────────────── ───────────────5
└ ┘──ALTSUFFIX(char1) └ ┘─APLKYBD(YES)─ └ ┘─APLTEXT(YES)─
┌ ┐─ASCII(NO)─ ┌ ┐─ATI(NO)── ┌ ┐─AUDIBLEALARM(NO)──5─ ──┼ ┼─────────── ──┼ ┼────────── ──┼ ┼─────────────────── ─────────────────────5 ├ ┤─ASCII(7)── └ ┘─ATI(YES)─ └ ┘─AUDIBLEALARM(YES)─ └ ┘─ASCII(8)──
┌ ┐─AUTOCONNECT(NO)── ┌ ┐─BACKTRANS(NO)──5─ ──┼ ┼────────────────── ──┬ ┬─────────────── ──┼ ┼──────────────── ────────────5 ├ ┤─AUTOCONNECT(ALL)─ ├ ┤─AUTOPAGE(NO)── └ ┘─BACKTRANS(YES)─ └ ┘─AUTOCONNECT(YES)─ └ ┘─AUTOPAGE(YES)─
┌ ┐─BRACKET(YES)─ ┌ ┐─BUILDCHAIN(NO)── ┌ ┐─CGCSGID(ð,ð)─────────────5─ ──┼ ┼────────────── ──┼ ┼───────────────── ──┼ ┼────────────────────────── ────5
└ ┘─BRACKET(NO)── └ ┘─BUILDCHAIN(YES)─ └ ┘──CGCSGID(ð-65535,ð-65535)
┌ ┐─COLOR(NO)── ┌ ┐─COPY(NO)── ┌ ┐─CREATESESS(NO)──5─ ──┼ ┼──────────── ──┼ ┼─────────── ──┼ ┼───────────────── ─────────────────────5 └ ┘─COLOR(YES)─ └ ┘─COPY(YES)─ └ ┘─CREATESESS(YES)─
┌ ┐─DEFSCREEN(ð,ð)─────────5─ ──┼ ┼──────────────────────── ──┬ ┬───────────────────── ──DEVICE(char8) ─────5
└ ┘──DEFSCREEN(ð-999,ð-999) └ ┘──DESCRIPTION(char58)
┌ ┐─DISCREQ(YES)─ ┌ ┐─DUALCASEKYBD(NO)── ┌ ┐─ERRCOLOR(NO)────────5─ ──┼ ┼────────────── ──┼ ┼─────────────────── ──┼ ┼───────────────────── ───────5 └ ┘─DISCREQ(NO)── └ ┘─DUALCASEKYBD(YES)─ ├ ┤─ERRCOLOR(BLUE)────── ├ ┤─ERRCOLOR(GREEN)───── ├ ┤─ERRCOLOR(NEUTRAL)─── ├ ┤─ERRCOLOR(PINK)────── ├ ┤─ERRCOLOR(RED)─────── ├ ┤─ERRCOLOR(TURQUOISE)─ └ ┘─ERRCOLOR(YELLOW)────
┌ ┐─ERRHILIGHT(NO)──────── ┌ ┐─ERRINTENSIFY(NO)──5─ ──┼ ┼─────────────────────── ──┼ ┼─────────────────── ───────────────────────5 ├ ┤─ERRHILIGHT(BLINK)───── └ ┘─ERRINTENSIFY(YES)─ ├ ┤─ERRHILIGHT(REVERSE)─── └ ┘─ERRHILIGHT(UNDERLINE)─
┌ ┐─ERRLASTLINE(NO)── ┌ ┐─EXTENDEDDS(NO)── ┌ ┐─FMHPARM(NO)──5─ ──┼ ┼────────────────── ──┼ ┼───────────────── ──┼ ┼────────────── ────────────5 └ ┘─ERRLASTLINE(YES)─ └ ┘─EXTENDEDDS(YES)─ └ ┘─FMHPARM(YES)─
┌ ┐─FORMFEED(NO)── ┌ ┐─HILIGHT(NO)── ┌ ┐─HORIZFORM(NO)──5─ ──┼ ┼─────────────── ──┼ ┼────────────── ──┼ ┼──────────────── ────────────────5 └ ┘─FORMFEED(YES)─ └ ┘─HILIGHT(YES)─ └ ┘─HORIZFORM(YES)─
┌ ┐─IOAREALEN(ð,ð)───────────── ┌ ┐─KATAKANA(NO)──5─ ──┼ ┼──────────────────────────── ──┼ ┼─────────────── ─┤
└ ┘──IOAREALEN(ð-32767,ð-32767) └ ┘─KATAKANA(YES)─
114 CICS User’s Handbook
SPI syntax
CREATE TYPETERM
TYPETERM attributes (2/3): ┌ ┐─LIGHTPEN(NO)──├─ ──┬ ┬──────────────── ──┼ ┼─────────────── ──┬ ┬──────────────── ──────────────5
└ ┘──LDCLIST(char8) └ ┘─LIGHTPEN(YES)─ ├ ┤──LOGMODE(char8) └ ┘─LOGMODE(ð)─────
┌ ┐─LOGONMSG(NO)── ┌ ┐─MSRCONTROL(NO)── ┌ ┐─NEPCLASS(ð)─────5─ ──┼ ┼─────────────── ──┼ ┼───────────────── ──┼ ┼───────────────── ────────────5
└ ┘─LOGONMSG(YES)─ └ ┘─MSRCONTROL(YES)─ └ ┘──NEPCLASS(ð-255)
┌ ┐─OBFORMAT(NO)── ┌ ┐─OBOPERID(NO)── ┌ ┐─OUTLINE(NO)──5─ ──┼ ┼─────────────── ──┼ ┼─────────────── ──┼ ┼────────────── ─────────────────5 └ ┘─OBFORMAT(YES)─ └ ┘─OBOPERID(YES)─ └ ┘─OUTLINE(YES)─
┌ ┐─PAGESIZE(24,8ð)─────── ┌ ┐─PARTITIONS(NO)──5─ ──┼ ┼─────────────────────── ──┼ ┼───────────────── ─────────────────────────5
└ ┘──PAGESIZE(ð-999,ð-999) └ ┘─PARTITIONS(YES)─
┌ ┐─PRINTADAPTER(NO)── ┌ ┐─PROGSYMBOLS(NO)── ┌ ┐─QUERY(NO)───5─ ──┼ ┼─────────────────── ──┼ ┼────────────────── ──┼ ┼───────────── ───────────5 └ ┘─PRINTADAPTER(YES)─ └ ┘─PROGSYMBOLS(YES)─ ├ ┤─QUERY(ALL)── └ ┘─QUERY(COLD)─
┌ ┐─RECEIVESIZE(256)───── ┌ ┐─RECOVNOTIFY(NONE)────────5─ ──┼ ┼────────────────────── ──┼ ┼────────────────────────── ─────────────────5
└ ┘──RECEIVESIZE(ð-3ð72ð) ├ ┤─RECOVNOTIFY(MESSAGE)───── └ ┘─RECOVNOTIFY(TRANSACTION)─
┌ ┐─RECOVOPTION(SYSDEFAULT)── ┌ ┐─RELREQ(NO)──5─ ──┼ ┼────────────────────────── ──┼ ┼───────────── ──────────────────────────5 ├ ┤─RECOVOPTION(CLEARCONV)─── └ ┘─RELREQ(YES)─ ├ ┤─RECOVOPTION(NONE)──────── ├ ┤─RECOVOPTION(RELEASESESS)─ └ ┘─RECOVOPTION(UNCONDREL)───
┌ ┐─SENDSIZE(ð)───────5─ ──┬ ┬────────────────────── ──┼ ┼─────────────────── ────────────────────────5
├ ┤─ROUTEDMSGS(ALL)────── └ ┘──SENDSIZE(ð-3ð72ð) ├ ┤─ROUTEDMSGS(NONE)───── └ ┘─ROUTEDMSGS(SPECIFIC)─
┌ ┐─SHIPPABLE(NO)── ┌ ┐─SIGNOFF(YES)────5─ ──┬ ┬──────────────────── ──┼ ┼──────────────── ──┼ ┼───────────────── ────────5
└ ┘──SESSIONTYPE(char8) └ ┘─SHIPPABLE(YES)─ ├ ┤─SIGNOFF(NO)───── └ ┘─SIGNOFF(LOGOFF)─
┌ ┐─SOSI(NO)── ┌ ┐─TEXTKYBD(NO)──5─ ──┼ ┼─────────── ──┬ ┬────────────── ──┼ ┼─────────────── ─────────────────────5 └ ┘─SOSI(YES)─ ├ ┤─TERMMODEL(1)─ └ ┘─TEXTKYBD(YES)─ └ ┘─TERMMODEL(2)─
┌ ┐─TEXTPRINT(NO)── ┌ ┐─TTI(YES)─ ┌ ┐─UCTRAN(NO)─────5─ ──┼ ┼──────────────── ──┼ ┼────────── ──┼ ┼──────────────── ───────────────────5 └ ┘─TEXTPRINT(YES)─ └ ┘─TTI(NO)── ├ ┤─UCTRAN(TRANID)─ └ ┘─UCTRAN(YES)────
┌ ┐─USERAREALEN(ð)───── ┌ ┐─VALIDATION(NO)──5─ ──┼ ┼──────────────────── ──┼ ┼───────────────── ─┤
└ ┘──USERAREALEN(ð-255) └ ┘─VALIDATION(YES)─
Chapter 2. SPI command syntax 115
SPI syntax
CREATE TYPETERM
TYPETERM attributes (3/3): ┌ ┐─VERTICALFORM(NO)── ┌ ┐─XRFSIGNOFF(NOFORCE)─├─ ──┼ ┼─────────────────── ──┼ ┼───────────────────── ─┤ └ ┘─VERTICALFORM(YES)─ └ ┘─XRFSIGNOFF(FORCE)───
DISABLE PROGRAM
55─ ──DISABLE PROGRAM(data-value) ──┬ ┬─────────────────────── ────────────────5└ ┘──ENTRYNAME(data-value)
5─ ──┬ ┬────────────────── ── ──┬ ┬─────────── ── ──┬ ┬────────── ── ──┬ ┬───── ───────5├ ┤──EXIT(data-value) └ ┘─FORMATEDF─ └ ┘─SHUTDOWN─ └ ┘─SPI─
└ ┘─EXITALL──────────
5─ ── ──┬ ┬────── ── ──┬ ┬─────────── ─5% └ ┘─STOP─ └ ┘─TASKSTART─
Conditions: INVEXITREQ, NOTAUTH
DISCARD AUTINSTMODEL
55─ ──DISCARD AUTINSTMODEL(data-value) ─5%
Conditions: INVREQ, MODELIDERR, NOTAUTH
DISCARD CONNECTION
55─ ──DISCARD CONNECTION(data-value) ─5%
Conditions: INVREQ, NOTAUTH, SYSIDERR
DISCARD DB2CONN
55─ ──DISCARD DB2CONN ─5%
Conditions: INVREQ, NOTAUTH, NOTFND
116 CICS User’s Handbook
SPI syntax
DISCARD DB2ENTRY
55─ ──DISCARD DB2ENTRY(data-value) ─5%
Conditions: NOTFND, INVREQ, NOTAUTH
DISCARD DB2TRAN
55─ ──DISCARD DB2TRAN(data-value) ─5%
Conditions: NOTFND, NOTAUTH
DISCARD DOCTEMPLATE
55─ ──DISCARD DOCTEMPLATE(data-value) ─5%
Conditions: NOTAUTH, NOTFND
| DISCARD ENQMODEL|
| 55─ ──DISCARD ENQMODEL(data-value) ─5%
| Conditions: NOTAUTH, NOTFND
DISCARD FILE
55─ ──DISCARD FILE(data-value) ─5%
Conditions: FILENOTFOUND, INVREQ, NOTAUTH
Chapter 2. SPI command syntax 117
SPI syntax
DISCARD JOURNALMODEL
55─ ──DISCARD ──JOURNALMODEL(data-value) ─5%
Conditions: NOTAUTH, NOTFND
DISCARD JOURNALNAME
55─ ──DISCARD ──JOURNALNAME(data-value) ─5%
Conditions: INVREQ, JIDERR, NOTAUTH
DISCARD PARTNER
55─ ──DISCARD PARTNER(data-value) ─5%
Conditions: INVREQ, NOTAUTH, PARTNERIDERR
DISCARD PROCESSTYPE
55──DISCARD─ ──PROCESSTYPE(data-value) ─5%
Conditions: INVREQ, NOTAUTH, PROCESSERR
DISCARD PROFILE
55─ ──DISCARD PROFILE(data-value) ─5%
Conditions: INVREQ, NOTAUTH, PROFILEIDERR
118 CICS User’s Handbook
SPI syntax
DISCARD PROGRAM
55─ ──DISCARD PROGRAM(data-value) ─5%
Conditions: INVREQ, NOTAUTH, PGMIDERR
DISCARD REQUESTMODEL
55─ ──DISCARD ──REQUESTMODEL(data-value) ─5%
Conditions: NOTAUTH, NOTFND
DISCARD TCPIPSERVICE
55─ ──DISCARD TCPIPSERVICE(data-value) ─5%
Conditions: INVREQ, NOTAUTH, NOTFND
DISCARD TDQUEUE
55─ ──DISCARD TDQUEUE(data-value) ─5%
Conditions: INVREQ, NOTAUTH, QIDERR
DISCARD TERMINAL
55─ ──DISCARD TERMINAL(data-value) ─5%
Conditions: INVREQ, NOTAUTH, TERMIDERR
Chapter 2. SPI command syntax 119
SPI syntax
DISCARD TRANCLASS
55─ ──DISCARD TRANCLASS(data-value) ─5%
Conditions: INVREQ, NOTAUTH, TCIDERR
DISCARD TRANSACTION
55─ ──DISCARD TRANSACTION(data-value) ─5%
Conditions: INVREQ, NOTAUTH, TRANSIDERR
| DISCARD TSMODEL|
| 55─ ──DISCARD TSMODEL(data-value) ─5%
| Conditions: INVREQ, NOTAUTH, NOTFND
ENABLE PROGRAM
┌ ┐─────────────────────────────────55─ ──ENABLE PROGRAM(data-value) ───
6┴┬ ┬───────────────────────────── ─5%
├ ┤──ENTRY(ptr-ref) ─────────────├ ┤──ENTRYNAME(data-value) ──────├ ┤──EXIT(data-value) ───────────
├ ┤─FORMATEDF───────────────────├ ┤──┬ ┬──GALENGTH(data-value) ───│ │└ ┘──GAENTRYNAME(data-value)
├ ┤─INDOUBTWAIT───────────────── ├ ┤─LINKEDITMODE────────────────
| ├ ┤──┬ ┬─QUASIRENT───────────────| │ │├ ┤| ─THREADSAFE─ ──┬ ┬─────────| │ ││ │└ ┘| ─OPENAPI─| │ │└ ┘─OPENAPI─────────────────
├ ┤─SHUTDOWN──────────────────── ├ ┤─SPI───────────────────────── ├ ┤─START───────────────────────
├ ┤──TALENGTH(data-value) ─────── └ ┘─TASKSTART───────────────────
Conditions: INVEXITREQ, NOTAUTH
120 CICS User’s Handbook
SPI syntax
EXTRACT EXIT
55─ ──EXTRACT EXIT PROGRAM(data-value) ──┬ ┬─────────────────────── ───────────5└ ┘──ENTRYNAME(data-value)
5─ ──GALENGTH(data-area) ──GASET(ptr-ref) ─5%
Conditions: INVEXITREQ, NOTAUTH
INQUIRE AUTINSTMODEL
55─ ──INQUIRE AUTINSTMODEL(data-value) ─5%
Conditions: END, ILLOGIC, MODELIDERR, NOTAUTH
INQUIRE AUTOINSTALL
┌ ┐────────────────────────55─ ──INQUIRE AUTOINSTALL ───
6┴┬ ┬──────────────────── ─5%
| ├ ┤──CONSOLES(cvda) ────├ ┤──CURREQS(data-area)├ ┤──ENABLESTATUS(cvda)├ ┤──MAXREQS(data-area)└ ┘──PROGRAM(data-area)
| Conditions: NOTAUTH
INQUIRE CFDTPOOL
55─ ──INQUIRE CFDTPOOL(data-value) ──┬ ┬────────────────── ─5%└ ┘──CONNSTATUS(cvda)
Conditions: END, ILLOGIC, NOTAUTH, POOLERR
Chapter 2. SPI command syntax 121
SPI syntax
INQUIRE CONNECTION
┌ ┐─────────────────────────────55─ ──INQUIRE CONNECTION(data-value) ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──ACCESSMETHOD(cvda) ─────├ ┤──ACQSTATUS(cvda) ────────├ ┤──AUTOCONNECT(cvda) ──────├ ┤──CONNSTATUS(cvda) ───────├ ┤──CONNTYPE(cvda) ─────────
| ├ ┤──CQP(cvda) ──────────────├ ┤──EXITTRACING(cvda) ──────├ ┤──GRNAME(data-area) ──────├ ┤──LINKSYSTEM(data-area) ──├ ┤──MEMBERNAME(data-area) ──├ ┤──NETNAME(data-area) ─────├ ┤──PENDSTATUS(cvda) ───────├ ┤──PROTOCOL(cvda) ─────────├ ┤──RECEIVECOUNT(data-area)├ ┤──RECOVSTATUS(cvda) ──────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSNET(data-area)├ ┤──REMOTESYSTEM(data-area)├ ┤──SENDCOUNT(data-area) ───├ ┤──SERVSTATUS(cvda) ───────├ ┤──XLNSTATUS(cvda) ────────└ ┘──ZCPTRACING(cvda) ───────
Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR
122 CICS User’s Handbook
SPI syntax
INQUIRE DB2CONN
55─ ──INQUIRE DB2CONN ───────────────────────────────────────────────────────5
┌ ┐───────────────────────────── ┌ ┐─────────────────────────────5─ ───
6┴┬ ┬───────────────────────── ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── ├ ┤──DB2ID(data-area) ───────│ │├ ┤─UOW────────────── ├ ┤──DB2RELEASE(data-area) ──│ │├ ┤─TASK───────────── ├ ┤──┬ ┬──DROLLBACK(cvda) ────
│ │├ ┤─TXID───────────── │ │├ ┤─ROLLBACK──────── │ │└ ┘─NONE───────────── │ │└ ┘─NOROLLBACK──────
├ ┤──AUTHID(data-area) ────── ├ ┤──MSGQUEUE1(data-area) ───├ ┤──┬ ┬──AUTHTYPE(cvda) ───── ├ ┤──MSGQUEUE2(data-area) ───│ │├ ┤─GROUP────────── ├ ┤──MSGQUEUE3(data-area) ───│ │├ ┤─SIGN─────────── ├ ┤──┬ ┬──NONTERMREL(cvda) ───
│ │├ ┤─TERM─────────── │ │├ ┤─RELEASE────────── │ │├ ┤─TX───────────── │ │└ ┘─NORELEASE────────
│ │├ ┤─OPID─────────── ├ ┤──PLAN(data-area) ────────│ │└ ┘─USERID───────── ├ ┤──PLANEXITNAME(data-area)├ ┤──COMAUTHID(data-area) ─── ├ ┤──┬ ┬──PRIORITY(cvda) ─────├ ┤──┬ ┬──COMAUTHTYPE(cvda) ── │ │├ ┤─HIGH───────────
│ │├ ┤─CGROUP──────────── │ │├ ┤─EQUAL────────── │ │├ ┤─CSIGN───────────── │ │└ ┘─LOW────────────
│ │├ ┤─CTERM───────────── ├ ┤──PURGECYCLEM(data-area) ─│ │├ ┤─CTX─────────────── ├ ┤──PURGECYCLES(data-area) ─│ │├ ┤─COPID───────────── ├ ┤──SIGNID(data-area) ──────│ │└ ┘─CUSERID─────────── ├ ┤──┬ ┬──STANDBYMODE(cvda) ──├ ┤──COMTHREADLIM(data-area) │ │├ ┤─NOCONNECT─────────├ ┤──COMTHREADS(data-area) ── │ │├ ┤─CONNECT───────────├ ┤──┬ ┬──CONNECTERROR(cvda) ─ │ │└ ┘─RECONNECT─────────│ │├ ┤─ABEND────────────── ├ ┤──STATSQUEUE(data-area) ──│ │└ ┘─SQLCODE──────────── ├ ┤──TCBLIMIT(data-area) ────└ ┘──┬ ┬──CONNECTST(cvda) ──── ├ ┤──TCBs(data-area) ────────├ ┤─CONNECTED─────── ├ ┤──THREADS(data-area) ─────├ ┤─CONNECTING────── ├ ┤──┬ ┬──THREADERROR(cvda) ──
├ ┤─DISCONNING────── │ │├ ┤─ABEND───────────── └ ┘─NOTCONNECTED──── │ │├ ┤─N9ð6D───────────── │ │└ ┘─N9ð6──────────────
├ ┤──THREADLIMIT(data-area) ─└ ┘──┬ ┬──THREADWAIT(cvda) ───
├ ┤─TWAIT──────────── └ ┘─NOTWAIT──────────
Conditions: NOTAUTH, NOTFND
Chapter 2. SPI command syntax 123
SPI syntax
INQUIRE DB2ENTRY
55─ ──INQUIRE DB2ENTRY(data-value) ──┬ ┬────────────────── ────────────────────5├ ┤──ACCOUNTREC(cvda)
├ ┤─UOW────────────── ├ ┤─TASK───────────── ├ ┤─TXID───────────── └ ┘─NONE─────────────
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────── ──┬ ┬─────────────────── ───────5└ ┘──AUTHID(data-area) ├ ┤──AUTHTYPE(cvda) ├ ┤──DISABLEDACT(cvda)
├ ┤─GROUP────────── ├ ┤─ABEND───────────── ├ ┤─SIGN─────────── ├ ┤─SQLCODE─────────── ├ ┤─TERM─────────── └ ┘─POOL────────────── ├ ┤─TX───────────── ├ ┤─OPID─────────── └ ┘─USERID─────────
5─ ──┬ ┬───────────────── ──┬ ┬──────────────────── ──┬ ┬───────────────── ───────5├ ┤──DROLLBACK(cvda) ├ ┤──ENABLESTATUS(cvda) └ ┘──PLAN(data-area)
├ ┤─ROLLBACK──────── ├ ┤─ENABLED──────────── └ ┘─NOROLLBACK────── ├ ┤─DISABLED─────────── └ ┘─DISABLING──────────
5─ ──┬ ┬───────────────────────── ──┬ ┬──────────────── ────────────────────────5└ ┘──PLANEXITNAME(data-area) ├ ┤──PRIORITY(cvda)
├ ┤─HIGH─────────── ├ ┤─EQUAL────────── └ ┘─LOW────────────
5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────── ─────────────────────5└ ┘──PROTECTNUM(data-area) └ ┘──PTHREADS(data-area)
5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─────────────────────5└ ┘──THREADLIMIT(data-area) └ ┘──THREADS(data-area)
5─ ──┬ ┬────────────────── ─5%├ ┤──THREADWAIT(cvda)
├ ┤─TWAIT──────────── ├ ┤─NOTWAIT────────── └ ┘─TPOOL────────────
Conditions: END,ILLOGIC,NOTAUTH, NOTFND
INQUIRE DB2TRAN
55─ ─INQUIRE DB2TRAN─ ──┬ ┬────────────── ──┬ ┬───────────────────── ────────────5└ ┘──(data-value) └ ┘──DB2ENTRY(data-area)
5─ ──┬ ┬──────────────────── ─5%└ ┘──TRANSID(data-area)
Conditions: END,ILLOGIC,NOTAUTH, NOTFND
124 CICS User’s Handbook
SPI syntax
INQUIRE DELETSHIPPED
55─ ──INQUIRE DELETSHIPPED ──────────────────────────────────────────────────5
5─ ──┬ ┬────────────────────────────────────────────────────────────── ───────5├ ┤──IDLE(data-area) ─────────────────────────────────────────────
└ ┘──IDLEHRS(data-area) ──IDLEMINS(data-area) ──IDLESECS(data-area)
5─ ──┬ ┬────────── ─5%├ ┤─┤ INQ7 ├─└ ┘─┤ INQ8 ├─
INQ7:├─ ──INTERVAL(data-area) ─┤
INQ8:├──┤ INQ9 ├─ ──INTERVALMINS(data-area) ──INTERVALSECS(data-area) ─┤
INQ9:├─ ──INTERVALHRS(data-area) ─┤
Conditions: NOTAUTH
INQUIRE DOCTEMPLATE
┌ ┐─────────────────────────────55─ ──INQUIRE DOCTEMPLATE(data-value) ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──APPENDCRLF(cvda) ───────├ ┤──DDNAME(data-area) ──────├ ┤──DSNAME(data-area) ──────├ ┤──EXITPGM(data-area) ─────├ ┤──FILE(data-area) ────────├ ┤──MEMBER(data-area) ──────├ ┤──PROGRAM(data-area) ─────├ ┤──TDQUEUE(data-area) ─────├ ┤──TEMPLATENAME(data-area)├ ┤──TEMPLATETYPE(cvda) ─────├ ┤──TSQUEUE(data-area) ─────└ ┘──TYPE(cvda) ─────────────
Conditions: END, ILLOGIC, NOTFND, NOTAUTH
Chapter 2. SPI command syntax 125
SPI syntax
INQUIRE DSNAME
┌ ┐────────────────────────────55─ ──INQUIRE DSNAME(data-value) ───
6┴┬ ┬──────────────────────── ─5%
├ ┤──ACCESSMETHOD(cvda) ────├ ┤──AVAILABILITY(cvda) ────├ ┤──BACKUPTYPE(cvda) ──────├ ┤──BASEDSNAME(data-area) ─├ ┤──FILECOUNT(data-area) ──├ ┤──FWDRECOVLOG(data-area)├ ┤──FWDRECOVLSN(data-area)├ ┤──OBJECT(cvda) ──────────├ ┤──LOSTLOCKS(cvda) ───────├ ┤──QUIESCESTATE(cvda) ────├ ┤──RECOVSTATUS(cvda) ─────├ ┤──RETLOCKS(cvda) ────────└ ┘──VALIDITY(cvda) ────────
Conditions: DSNNOTFOUND, END, ILLOGIC, IOERR, NOTAUTH
INQUIRE DUMPDS
┌ ┐───────────────────────────55─ ──INQUIRE DUMPDS ───
6┴┬ ┬─────────────────────── ─5%
├ ┤──CURRENTDDS(data-area)├ ┤──INITIALDDS(data-area)├ ┤──OPENSTATUS(cvda) ─────└ ┘──SWITCHSTATUS(cvda) ───
Conditions: NOTAUTH
126 CICS User’s Handbook
SPI syntax
| INQUIRE ENQ|
| 55─ ──INQUIRE ENQ ──┬ ┬──ENQSCOPE(data-value) ────────────────── ───────────────5| ├ ┤──| RESOURCE(data-value)| RESLEN(data-value)| └ ┘──UOW(data-value) ───────────────────────
| ┌ ┐──────────────────────────| 5─ ───
6┴┬ ┬────────────────────── ─5%
| ├ ┤──DURATION(data-area) ─| ├ ┤──ENQFAILS(data-area) ─| ├ ┤──NETUOWID(data-area) ─| ├ ┤──QUALIFIER(data-area)| ├ ┤──QUALLEN(data-area) ──| ├ ┤──RELATION(cvda) ──────| ├ ┤──RESLEN(data-area) ───| ├ ┤──RESOURCE(data-area) ─| ├ ┤──STATE(cvda) ─────────| ├ ┤──TASKID(data-area) ───| ├ ┤──TRANSID(data-area) ──| ├ ┤ ─ ─TYPE(cvda) ──────────| └ ┘──UOW(data-area) ──────
| Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND
| INQUIRE ENQMODEL|
| ┌ ┐─────────────────────────| 55─ ──INQUIRE ENQMODEL(data-value) ───
6┴┬ ┬───────────────────── ─5%
| ├ ┤──ENQSCOPE(data-area)| ├ ┤──ENQNAME(data-area) ─| └ ┘──STATUS(cvda) ───────
| Conditions: END, ILLOGIC, NOTAUTH, NOTFND
INQUIRE EXCI
55─ ──INQUIRE EXCI ──┬ ┬────────────────── ─5% ├ ┤──TASK(data-value) └ ┘──URID(data-value)
Conditions: END, ILLOGIC, NOTAUTH
Chapter 2. SPI command syntax 127
SPI syntax
INQUIRE EXITPROGRAM
┌ ┐──────────────────────────────55─ ──INQUIRE EXITPROGRAM(data-value) ───
6┴┬ ┬────────────────────────── ─5%
├ ┤──EXIT(data-value) ────────├ ┤──ENTRYNAME(data-value) ───
| ├ ┤──APIST(data-value) ───────| ├ ┤──CONCURRENTST(data-value)
├ ┤──CONNECTST(cvda) ─────────├ ┤──ENTRY(data-area) ────────├ ┤──FORMATEDFST(cvda) ───────├ ┤──GAENTRYNAME(data-area) ──├ ┤──GALENGTH(data-area) ─────├ ┤──GAUSECOUNT(data-area) ───├ ┤──INDOUBTST(cvda) ─────────├ ┤──NUMEXITS(data-area) ─────├ ┤──QUALIFIER(data-area) ────├ ┤──SHUTDOWNST(cvda) ────────├ ┤──SPIST(cvda) ─────────────├ ┤──STARTSTATUS(cvda) ───────├ ┤──TALENGTH(data-area) ─────└ ┘──TASKSTARTST(cvda) ───────
Conditions: END, ILLOGIC, INVREQ, NOTAUTH, PGMIDERR
128 CICS User’s Handbook
SPI syntax
INQUIRE FILE
┌ ┐─────────────────────────────55─ ──INQUIRE FILE(data-value) ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──ACCESSMETHOD(cvda) ─────├ ┤──ADD(cvda) ──────────────├ ┤──BASEDSNAME(data-area) ──├ ┤──BLOCKFORMAT(cvda) ──────├ ┤──BLOCKKEYLEN(data-area) ─├ ┤──BLOCKSIZE(data-area) ───├ ┤──BROWSE(cvda) ───────────
| ├ ┤──CFDTPOOL(data-area) ────├ ┤──DELETE(cvda) ───────────├ ┤──DISPOSITION(cvda) ──────├ ┤──DSNAME(data-area) ──────├ ┤──EMPTYSTATUS(cvda) ──────├ ┤──ENABLESTATUS(cvda) ─────├ ┤──EXCLUSIVE(cvda) ────────├ ┤──FWDRECSTATUS(cvda) ─────├ ┤──JOURNALNUM(data-area) ──├ ┤──KEYLENGTH(data-area) ───├ ┤──KEYPOSITION(data-area) ─
| ├ ┤──LOADTYPE(cvda) ─────────├ ┤──LSRPOOLID(data-area) ───├ ┤──MAXNUMRECS(data-area) ──├ ┤──OBJECT(cvda) ───────────├ ┤──OPENSTATUS(cvda) ───────├ ┤──READ(cvda) ─────────────├ ┤──READINTEG(cvda) ────────├ ┤──RECORDFORMAT(cvda) ─────├ ┤──RECORDSIZE(data-area) ──├ ┤──RECOVSTATUS(cvda) ──────├ ┤──RELTYPE(cvda) ──────────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSTEM(data-area)
| ├ ┤──REMOTETABLE(cvda) ──────├ ┤──RLSACCESS(cvda) ────────├ ┤──STRINGS(data-area) ─────├ ┤──TABLE(cvda) ────────────
| ├ ┤──TABLENAME(data-area) ───├ ┤──TYPE(cvda) ─────────────├ ┤──UPDATE(cvda) ───────────
| └ ┘──UPDATEMODEL(cvda) ──────
Conditions: END, FILENOTFOUND, ILLOGIC, NOTAUTH
INQUIRE IRC
55─ ──INQUIRE IRC ──┬ ┬────────────────── ─5%└ ┘──OPENSTATUS(cvda)
Conditions: NOTAUTH
Chapter 2. SPI command syntax 129
SPI syntax
INQUIRE JOURNALMODEL
55─ ──INQUIRE JOURNALMODEL(data-value) ──┬ ┬──────────────────────── ──────────5└ ┘──JOURNALNAME(data-area)
5─ ──┬ ┬─────────────────────── ──┬ ┬──────────── ─5%└ ┘──STREAMNAME(data-area) └ ┘──TYPE(cvda)
Conditions : END, ILLOGIC, NOTAUTH, NOTFND
INQUIRE JOURNALNAME
┌ ┐───────────────────────────55─ ──INQUIRE JOURNALNAME(data-value) ───
6┴┬ ┬─────────────────────── ─5%
├ ┤──STATUS(cvda) ─────────├ ┤──STREAMNAME(data-area)└ ┘──TYPE(cvda) ───────────
Conditions: END, ILLOGIC, JIDERR, NOTAUTH
INQUIRE MODENAME
55─ ──INQUIRE MODENAME(data-value) ──CONNECTION(data-value) ──────────────────5
┌ ┐───────────────────────────5─ ───
6┴┬ ┬─────────────────────── ─5%
├ ┤──ACTIVE(data-area) ────├ ┤──AUTOCONNECT(cvda) ────├ ┤──AVAILABLE(data-area) ─├ ┤──MAXIMUM(data-area) ───└ ┘──MAXWINNERS(data-area)
Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR
130 CICS User’s Handbook
SPI syntax
INQUIRE MONITOR
┌ ┐─────────────────────────────────────────────────55─ ──INQUIRE MONITOR ───
6┴┬ ┬───────────────────────────────────────────── ─5%
├ ┤──CONVERSEST(cvda) ───────────────────────────├ ┤──EVENTCLASS(cvda) ───────────────────────────├ ┤──EXCEPTCLASS(cvda) ──────────────────────────├ ┤──┬ ┬──FREQUENCY(data-area) ───────────────────
│ │└ ┘─┤ freqhrs ├──┤ freqmins ├──┤ freqsecs ├─├ ┤──PERFCLASS(cvda) ────────────────────────────├ ┤──STATUS(cvda) ───────────────────────────────├ ┤──SUBSYSTEMID(data-area) ─────────────────────├ ┤──SYNCPOINTST(cvda) ──────────────────────────└ ┘──TIME(cvda) ─────────────────────────────────
freqhrs:├─ ──FREQUENCYHRS(data-area) ─┤
freqmins:├─ ──FREQUENCYMIN(data-area) ─┤
freqsecs:├─ ──FREQUENCYSEC(data-area) ─┤
Conditions: NOTAUTH
INQUIRE TERMINAL/NETNAME
55─ ──INQUIRE NETNAME(data-value) ──┬ ┬───────────────────── ─5%└ ┘──TERMINAL(data-area)
Conditions: NOTAUTH, TERMIDERR
INQUIRE PARTNER
┌ ┐──────────────────────────55─ ──INQUIRE PARTNER(data-value) ───
6┴┬ ┬────────────────────── ─5%
├ ┤──NETWORK(data-area) ──├ ┤──NETNAME(data-area) ──├ ┤──PROFILE(data-area) ──├ ┤──TPNAME(data-area) ───└ ┘──TPNAMELEN(data-area)
Conditions: END, ILLOGIC, NOTAUTH, PARTNERIDERR
Chapter 2. SPI command syntax 131
SPI syntax
INQUIRE PROCESSTYPE
55──INQUIRE─ ──PROCESSTYPE(data-value) ──┬ ┬───────────────── ─────────────────5└ ┘──FILE(data-area)
5─ ──┬ ┬───────────────────── ──┬ ┬────────────────── ──┬ ┬────────────── ─5%└ ┘──AUDITLOG(data-area) └ ┘──AUDITLEVEL(cvda) └ ┘──STATUS(cvda)
Conditions: NOTAUTH, PROCESSERR
INQUIRE PROFILE
55─ ──INQUIRE PROFILE(data-value) ─5%
Conditions: END, ILLOGIC, NOTAUTH, PROFILEIDERR
INQUIRE PROGRAM
┌ ┐───────────────────────────────────────55─ ──INQUIRE PROGRAM(data-value) ───
6┴┬ ┬─────────────────────────────────── ─5%
├ ┤──CEDFSTATUS(cvda) ─────────────────├ ┤──COBOLTYPE(cvda) ──────────────────├ ┤──COPY(cvda) ───────────────────────
| ├ ┤──CONCURRENCY(cvda) ────────────────├ ┤──DATALOCATION(cvda) ───────────────
| ├ ┤──DYNAMSTATUS(cvda) ────────────────├ ┤──ENTRYPOINT(ptr-ref) ──────────────├ ┤──EXECKEY(cvda) ────────────────────├ ┤──EXECUTIONSET(cvda) ───────────────├ ┤──HOLDSTATUS(cvda) ─────────────────
| ├ ┤──JVMCLASS(255-character data-area)| ├ ┤──JVMDEBUG(cvda) ───────────────────
├ ┤──LANGDEDUCED(cvda) ────────────────├ ┤──LANGUAGE(cvda) ───────────────────├ ┤──LENGTH(data-area) ────────────────├ ┤──LOADPOINT(ptr-ref) ───────────────├ ┤──LPASTATUS(cvda) ──────────────────├ ┤──PROGTYPE(cvda) ───────────────────├ ┤──REMOTENAME(data-area) ────────────├ ┤──REMOTESYSTEM(data-area) ──────────├ ┤──RESCOUNT(data-area) ──────────────
| ├ ┤──RUNTIME(cvda) ────────────────────├ ┤──SHARESTATUS(cvda) ────────────────├ ┤──STATUS(cvda) ─────────────────────├ ┤──TRANSID(data-area) ───────────────└ ┘──USECOUNT(data-area) ──────────────
Conditions: END, ILLOGIC, NOTAUTH, PGMIDERR
132 CICS User’s Handbook
SPI syntax
INQUIRE REQID
55─ ──INQUIRE REQID(data-value) ──┬ ┬─────────────── ──────────────────────────5└ ┘──REQTYPE(cvda)
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──────────────────────────5└ ┘──TERMID(data-area) └ ┘──TRANSID(data-area)
5─ ──┬ ┬───────────────────────────────────────────────────────────────── ────5├ ┤──INTERVAL(data-area) ────────────────────────────────────────────├ ┤──TIME(data-area) ────────────────────────────────────────────────
├ ┤─AFTER─ ──HOURS(data-area) ──MINUTES(data-area) ──SECONDS(data-area) └ ┘─AT─ ──HOURS(data-area) ──MINUTES(data-area) ──SECONDS(data-area) ───
5─ ──┬ ┬────────────────────────────────────────────────────── ───────────────5 └ ┘──SET(ptr-ref) ──LENGTH(data-area) ──┬ ┬─────────────────
└ ┘──FMHSTATUS(cvda)
5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ────────────────────────5└ ┘──RTRANSID(data-area) └ ┘──RTERMID(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5%└ ┘──QUEUE(data-area) └ ┘──USERID(data-area)
Conditions: END, ILLOGIC, INVREQ, NOTAUTH, NOTFND
INQUIRE REQUESTMODEL
┌ ┐─────────────────────────────55─ ──INQUIRE REQUESTMODEL(data-value) ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──OMGINTERFACE(data-area)├ ┤──OMGMODULE(data-area) ───├ ┤──OMGOPERATION(data-area)└ ┘──TRANSID(data-value) ────
Conditions: END, ILLOGIC, JIDERR, NOTAUTH
INQUIRE RRMS
55─ ──INQUIRE RRMS ──┬ ┬────────────────── ─5% └ ┘──OPENSTATUS(cvda)
Conditions:
Chapter 2. SPI command syntax 133
SPI syntax
INQUIRE STATISTICS
55─ ──INQUIRE STATISTICS ──┬ ┬────────────────────────────────────── ──────────5├ ┤──ENDOFDAY(data-area) ─────────────────
└ ┘─┤ endhrs ├──┤ endmins ├──┤ endsecs ├─
5─ ──┬ ┬─────────────────────────────────── ──────────────────────────────────5├ ┤──INTERVAL(data-area) ──────────────
└ ┘─┤ inhrs ├──┤ inmins ├──┤ insecs ├─
5─ ──┬ ┬─────────────────────────────────── ──┬ ┬───────────────── ─5%├ ┤──NEXTTIME(data-area) ────────────── └ ┘──RECORDING(cvda)
└ ┘─┤ nxhrs ├──┤ nxmins ├──┤ nxsecs ├─
endhrs:├─ ──ENDOFDAYHRS(data-area) ─┤
endmins:├─ ──ENDOFDAYMINS(data-area) ─┤
endsecs:├─ ──ENDOFDAYSECS(data-area) ─┤
inhrs:├─ ──INTERVALHRS(data-area) ─┤
inmins:├─ ──INTERVALMINS(data-area) ─┤
insecs:├─ ──INTERVALSECS(data-area) ─┤
nxhrs:├─ ──NEXTTIMEHRS(data-area) ─┤
nxmins:├─ ──NEXTTIMEMINS(data-area) ─┤
nxsecs:├─ ──NEXTTIMESECS(data-area) ─┤
Conditions: NOTAUTH
134 CICS User’s Handbook
SPI syntax
INQUIRE STORAGE
55─ ──INQUIRE STORAGE ───────────────────────────────────────────────────────5
5─ ──┬ ┬──ADDRESS(ptr-value) ──┬ ┬────────────────── ──┬ ┬──────────────────── ─5%│ │└ ┘──ELEMENT(ptr-ref) └ ┘──FLENGTH(data-area)
└ ┘──NUMELEMENTS(data-area) ─┤ elist ├──┤ llist ├──┤ task ├───────────
elist:├─ ──┬ ┬────────────────────── ─┤
└ ┘──ELEMENTLIST(ptr-ref)
llist:├─ ──┬ ┬───────────────────── ─┤
└ ┘──LENGTHLIST(ptr-ref)
task:├─ ──┬ ┬────────────────── ─┤
└ ┘──TASK(data-value)
Conditions: NOTAUTH, TASKIDERR
INQUIRE STREAMNAME
┌ ┐─────────────────────────55─ ──INQUIRE STREAMNAME(data-value) ───
6┴┬ ┬───────────────────── ─5%
├ ┤──STATUS(cvda) ───────├ ┤──SYSTEMLOG(cvda) ────└ ┘──USECOUNT(data-area)
Conditions: END, ILLOGIC, NOTAUTH, NOTFND
INQUIRE SYSDUMPCODE
┌ ┐────────────────────────55─ ──INQUIRE SYSDUMPCODE(data-value) ───
6┴┬ ┬──────────────────── ─5%
├ ┤──CURRENT(data-area)├ ┤──DAEOPTION(cvda) ───├ ┤──DUMPSCOPE(cvda) ───├ ┤──MAXIMUM(data-area)├ ┤──SHUTOPTION(cvda) ──└ ┘──SYSDUMPING(cvda) ──
Conditions: END, ILLOGIC, NOTAUTH, NOTFND
Chapter 2. SPI command syntax 135
SPI syntax
INQUIRE SYSTEM
┌ ┐──────────────────────────────────────────────55─ ──INQUIRE SYSTEM ───
6┴┬ ┬────────────────────────────────────────── ─5%
| ├ ┤──ACTOPENTCBS(data-area) ──────────────────├ ┤──AKP(data-area) ──────────────────────────├ ┤──CDSASIZE(data-area) ─────────────────────├ ┤──CICSSTATUS(cvda) ────────────────────────├ ┤──CICSSYS(data-area) ──────────────────────├ ┤──CICSTSLEVEL(data-area) ──────────────────├ ┤──CMDPROTECT(cvda) ────────────────────────├ ┤──COLDSTATUS(cvda) ────────────────────────├ ┤──DB2CONN(data-area) ──────────────────────├ ┤──DFLTUSER(data-area) ─────────────────────├ ┤──DSALIMIT(data-area) ─────────────────────
| ├ ┤──DSRTPROGRAM(data-area) ──────────────────├ ┤──DTRPROGRAM(data-area) ───────────────────├ ┤──DUMPING(cvda) ───────────────────────────├ ┤ ─ ─ECDSASIZE(data-area) ────────────────────├ ┤ ─ ─EDSALIMIT(data-area) ────────────────────├ ┤ ─ ─ERDSASIZE(data-area) ────────────────────├ ┤ ─ ─ESDSASIZE(data-area) ────────────────────├ ┤ ─ ─EUDSASIZE(data-area) ────────────────────
| ├ ┤──FORCEQR(cvda) ─────────────────────────── ├ ┤──GMMTEXT(data-area) ──GMMLENGTH(data-area)
├ ┤ ─ ─GMMTRANID(data-area) ────────────────────├ ┤──INITSTATUS(cvda) ────────────────────────├ ┤──JOBNAME(data-area) ──────────────────────
| ├ ┤──LOGDEFER(data-area) ─────────────────────| ├ ┤──MAXOPENTCBS(data-area) ──────────────────
├ ┤──MAXTASKS(data-area) ─────────────────────├ ┤──MROBATCH(data-area) ─────────────────────├ ┤──OPREL(data-area) ────────────────────────├ ┤──OPSYS(data-area) ────────────────────────
| ├ ┤──OSLEVEL(data-area) ──────────────────────├ ┤──PROGAUTOCTLG(cvda) ──────────────────────├ ┤──PROGAUTOEXIT(data-area) ─────────────────├ ┤──PROGAUTOINST(cvda) ──────────────────────├ ┤ ─ ─PRTYAGING(data-area) ────────────────────├ ┤──RDSASIZE(data-area) ─────────────────────├ ┤──REENTPROTECT(cvda) ──────────────────────├ ┤──RELEASE(data-area) ──────────────────────├ ┤──RLSSTATUS(cvda) ─────────────────────────├ ┤──RUNAWAY(data-area) ──────────────────────├ ┤ ─ ─SCANDELAY(data-area) ────────────────────├ ┤──SDSASIZE(data-area) ─────────────────────├ ┤──SDTRAN(data-area) ───────────────────────├ ┤──SECURITYMGR(cvda) ───────────────────────├ ┤──SHUTSTATUS(cvda) ────────────────────────├ ┤──SOSSTATUS(cvda) ─────────────────────────├ ┤──STARTUP(cvda) ───────────────────────────├ ┤──STARTUPDATE(data-area) ──────────────────├ ┤──STOREPROTECT(cvda) ──────────────────────├ ┤──TIME(data-area) ─────────────────────────├ ┤──TRANISOLATE(cvda) ───────────────────────├ ┤──UDSASIZE(data-area) ─────────────────────└ ┘──XRFSTATUS(cvda) ─────────────────────────
Condition: NOTAUTH
136 CICS User’s Handbook
SPI syntax
INQUIRE TASK
┌ ┐─────────────────────────────────55─ ──INQUIRE TASK(data-value) ───
6┴┬ ┬───────────────────────────── ─5%
| ├ ┤──ACTIVITY(data-area) ────────| ├ ┤──ACTIVITYID(data-area) ──────
├ ┤──ATTACHTIME(data-area) ──────├ ┤──BRIDGE(data-area) ──────────├ ┤──CMDSEC(cvda) ───────────────├ ┤──DB2PLAN(data-area) ─────────├ ┤──DTIMEOUT(data-area) ────────├ ┤──DUMPING(cvda) ──────────────├ ┤──FACILITY(data-area) ────────├ ┤──FACILITYTYPE(cvda) ─────────├ ┤──IDENTIFIER(data-area) ──────├ ┤──INDOUBT(cvda) ──────────────├ ┤──INDOUBTMINS(data-area) ─────├ ┤──INDOUBTWAIT(cvda) ──────────├ ┤──ISOLATEST(cvda) ────────────├ ┤──PRIORITY(data-area) ────────
| ├ ┤──PROCESS(data-area) ─────────| ├ ┤──PROCESSTYPE(data-area) ─────
├ ┤──PROFILE(data-area) ─────────├ ┤──PROGRAM(data-area) ─────────├ ┤──PURGEABILITY(cvda) ─────────├ ┤──REMOTENAME(data-area) ──────├ ┤──REMOTESYSTEM(data-area) ────├ ┤──RESSEC(cvda) ───────────────├ ┤──ROUTING(cvda) ──────────────├ ┤──RTIMEOUT(data-area) ────────├ ┤──RUNAWAY(data-area) ─────────├ ┤──RUNSTATUS(cvda) ────────────├ ┤──SCRNSIZE(cvda) ─────────────├ ┤──STARTCODE(data-area) ───────├ ┤──STORAGECLEAR(cvda) ─────────├ ┤──SUSPENDTIME(data-area) ─────├ ┤──SUSPENDTYPE(data-area) ─────├ ┤──┬ ┬──SUSPENDVALUE(data-area)
| │ │└ ┘──RESNAME(data-area) ─────├ ┤──TASKDATAKEY(cvda) ──────────├ ┤──TASKDATALOC(cvda) ──────────├ ┤──TCB(cvda) ──────────────────├ ┤──┬ ┬──TRANCLASS(data-area) ───│ │└ ┘──TCLASS(data-area) ───├ ┤──TRACING(cvda) ──────────────├ ┤──TRANPRIORITY(data-area) ────├ ┤──TRANSACTION(data-area) ─────├ ┤──TRPROF(data-area) ──────────├ ┤──TWASIZE(data-area) ─────────├ ┤──UOW(data-area) ─────────────└ ┘──USERID(data-area) ──────────
Conditions: NOTAUTH, TASKIDERR
Chapter 2. SPI command syntax 137
SPI syntax
INQUIRE TASK LIST
55─ ──INQUIRE TASK LIST ──LISTSIZE(data-area) ── ──┬ ┬────────────── ────────────5 └ ┘─DISPATCHABLE─
5─ ── ──┬ ┬───────── ── ──┬ ┬─────────── ─────────────────────────────────────────5 └ ┘─RUNNING─ └ ┘─SUSPENDED─
5─ ──┬ ┬─────────────────────────────────────── ─5% └ ┘──SET(ptr-ref) ──┬ ┬─────────────────────
└ ┘──SETTRANSID(ptr-ref)
Condition: NOTAUTH
INQUIRE TCLASS
┌ ┐────────────────────────55─ ──INQUIRE TCLASS(data-value) ───
6┴┬ ┬──────────────────── ─5%
├ ┤──CURRENT(data-area)└ ┘──MAXIMUM(data-area)
Conditions: NOTAUTH, TCIDERR
INQUIRE TCPIP
55─ ──INQUIRE TCPIP ──OPENSTATUS(cvda) ─5%
Conditions: INVREQ, NOTAUTH
138 CICS User’s Handbook
SPI syntax
INQUIRE TCPIPService
┌ ┐─────────────────────────────55─ ──INQUIRE TCPIPSERVICE(data-value) ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──BACKLOG(data-area) ─────├ ┤──CLOSETIMEOUT(data-area)├ ┤──CONNECTIONS(data-area) ─├ ┤──IPADDRESS(data-area) ───├ ┤──OPENSTATUS(cvda) ───────├ ┤──PORT(data-area) ────────├ ┤──SOCKETCLOSE(cvda) ──────├ ┤──SSLTYPE(cvda) ──────────├ ┤──TRANSID(data-area) ─────├ ┤──TSQPREFIX(data-area) ───└ ┘──URM(data-area) ─────────
Conditions: INVREQ, NOTAUTH , NOTFND
INQUIRE TDQUEUE
┌ ┐─────────────────────────────55─ ──INQUIRE TDQUEUE(data-value) ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──ATIFACILITY(cvda) ──────├ ┤──ATITERMID(data-area) ───├ ┤──ATITRANID(data-area) ───├ ┤──ATIUSERID(data-area) ───├ ┤──BLOCKFORMAT(cvda) ──────├ ┤──BLOCKSIZE(data-area) ───├ ┤──DATABUFFERS(data-area) ─├ ┤──DDNAME(data-area) ──────├ ┤──DISPOSITION(cvda) ──────├ ┤──DSNAME(data-area) ──────├ ┤──EMPTYSTATUS(cvda) ──────├ ┤──ENABLESTATUS(cvda) ─────├ ┤──ERROROPTION(cvda) ──────├ ┤──INDIRECTNAME(data-area)├ ┤──INDOUBT(cvda) ──────────├ ┤──INDOUBTWAIT(cvda) ──────├ ┤──IOTYPE(cvda) ───────────
| ├ ┤──MEMBER(data-area) ──────├ ┤──NUMITEMS(data-area) ────├ ┤──OPENSTATUS(cvda) ───────├ ┤──PRINTCONTROL(cvda) ─────├ ┤──RECORDFORMAT(cvda) ─────├ ┤──RECORDLENGTH(data-area)├ ┤──RECOVSTATUS(cvda) ──────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSTEM(data-area)├ ┤──REWIND(cvda) ───────────├ ┤──SYSOUTCLASS(cvda) ──────├ ┤──TRIGGERLEVEL(data-area)└ ┘──TYPE(cvda) ─────────────
Conditions: ENDCOND, ILLOGIC, NORMAL, NOTAUTH, QIDERR
Chapter 2. SPI command syntax 139
SPI syntax
INQUIRE TERMINAL/NETNAME
55─ ──INQUIRE TERMINAL(data-value) ──┬ ┬──────────────────── ─5%└ ┘──NETNAME(data-area)
The following options apply to both the INQUIRE TERMINAL and theINQUIRE NETNAME command.
INQUIRE TERMINAL
┌ ┐───────────────────────────55─ ───
6┴┬ ┬─────────────────────── ─5%
├ ┤──ACCESSMETHOD(cvda) ───├ ┤──ACQSTATUS(cvda) ──────├ ┤──ALTPAGEHT(data-area) ─├ ┤──ALTPAGEWD(data-area) ─├ ┤──ALTPRINTER(data-area)├ ┤──ALTPRTCOPYST(cvda) ───├ ┤──ALTSCRNHT(data-area) ─├ ┤──ALTSCRNWD(data-area) ─├ ┤──ALTSUFFIX(data-area) ─├ ┤──APLKYBDST(cvda) ──────├ ┤──APLTEXTST(cvda) ──────├ ┤──ASCII(cvda) ──────────├ ┤──ATISTATUS(cvda) ──────├ ┤──AUDALARMST(cvda) ─────├ ┤──AUTOCONNECT(cvda) ────├ ┤──BACKTRANSST(cvda) ────├ ┤──COLORST(cvda) ────────
| ├ ┤──CONSOLE(data-area) ───├ ┤──COPYST(cvda) ─────────├ ┤──CORRELID(data-area) ──├ ┤──CREATESESS(cvda) ─────├ ┤──DATASTREAM(cvda) ─────├ ┤──DEFPAGEHT(data-area) ─├ ┤──DEFPAGEWD(data-area) ─├ ┤──DEFSCRNHT(data-area) ─├ ┤──DEFSCRNWD(data-area) ─├ ┤──DEVICE(cvda) ─────────├ ┤──DISCREQST(cvda) ──────├ ┤──DUALCASEST(cvda) ─────├ ┤──EXITTRACING(cvda) ────├ ┤──EXTENDEDDSST(cvda) ───├ ┤──FMHPARMST(cvda) ──────├ ┤──FORMFEEDST(cvda) ─────├ ┤──GCHARS(data-area) ────├ ┤──GCODES(data-area) ────├ ┤──HFORMST(cvda) ────────├ ┤──HILIGHTST(cvda) ──────├ ┤──KATAKANAST(cvda) ─────├ ┤──LIGHTPENST(cvda) ─────├ ┤──LINKSYSTEM(data-area)├ ┤──MAPNAME(data-area) ───└ ┘──MAPSETNAME(data-area)
140 CICS User’s Handbook
SPI syntax
INQUIRE TERMINAL
┌ ┐─────────────────────────────55─ ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──MODENAME(data-area) ────├ ┤──MSRCONTROLST(cvda) ─────├ ┤──NATLANG(data-area) ─────├ ┤──NATURE(cvda) ───────────├ ┤──NEXTTRANSID(data-area) ─├ ┤──OBFORMATST(cvda) ───────├ ┤──OBOPERIDST(cvda) ───────├ ┤──OPERID(data-area) ──────├ ┤──OUTLINEST(cvda) ────────├ ┤──PAGEHT(data-area) ──────├ ┤──PAGESTATUS(cvda) ───────├ ┤──PAGEWD(data-area) ──────├ ┤──PARTITIONSST(cvda) ─────├ ┤──PRINTADAPTST(cvda) ─────├ ┤──PRINTER(data-area) ─────├ ┤──PROGSYMBOLST(cvda) ─────├ ┤──PRTCOPYST(cvda) ────────├ ┤──QUERYST(cvda) ──────────├ ┤──RELREQST(cvda) ─────────├ ┤──REMOTENAME(data-area) ──├ ┤──REMOTESYSNET(data-area)├ ┤──REMOTESYSTEM(data-area)├ ┤──SCRNHT(data-area) ──────├ ┤──SCRNWD(data-area) ──────├ ┤──SECURITY(cvda) ─────────├ ┤──SERVSTATUS(cvda) ───────├ ┤──SESSIONTYPE(cvda) ──────├ ┤──SIGNONSTATUS(cvda) ─────├ ┤──SOSIST(cvda) ───────────├ ┤──TASKID(data-area) ──────├ ┤──TCAMCONTROL(data-area) ─├ ┤──TERMMODEL(data-area) ───├ ┤──TERMPRIORITY(data-area)├ ┤──TERMSTATUS(cvda) ───────├ ┤──TEXTKYBDST(cvda) ───────├ ┤──TEXTPRINTST(cvda) ──────├ ┤──TRACING(cvda) ──────────├ ┤──TRANSACTION(data-area) ─├ ┤──TTISTATUS(cvda) ────────├ ┤──UCTRANST(cvda) ─────────├ ┤──USERAREA(ptr-ref) ──────├ ┤──USERAREALEN(data-area) ─├ ┤──USERID(data-area) ──────├ ┤──USERNAME(data-area) ────├ ┤──VALIDATIONST(cvda) ─────├ ┤──VFORMST(cvda) ──────────└ ┘──ZCPTRACING(cvda) ───────
Conditions: END, ILLOGIC, NOTAUTH, TERMIDERR
Chapter 2. SPI command syntax 141
SPI syntax
INQUIRE TRACEDEST
┌ ┐──────────────────────────55─ ──INQUIRE TRACEDEST ───
6┴┬ ┬────────────────────── ─5%
├ ┤──AUXSTATUS(cvda) ─────├ ┤──CURAUXDS(data-area) ─├ ┤──GTFSTATUS(cvda) ─────├ ┤──INTSTATUS(cvda) ─────├ ┤──SWITCHSTATUS(cvda) ──└ ┘──TABLESIZE(data-area)
Conditions: NOTAUTH
INQUIRE TRACEFLAG
┌ ┐────────────────────────55─ ──INQUIRE TRACEFLAG ───
6┴┬ ┬──────────────────── ─5%
├ ┤──SINGLESTATUS(cvda)├ ┤──SYSTEMSTATUS(cvda)├ ┤──TCEXITSTATUS(cvda)└ ┘──USERSTATUS(cvda) ──
Conditions: NOTAUTH
INQUIRE TRACETYPE
┌ ┐───────────────────────55─ ──INQUIRE TRACETYPE ──┬ ┬─STANDARD─ ───
6┴┬ ┬─────────────────── ─5%
└ ┘─SPECIAL── └ ┘──COMPID(data-area)
Conditions: NOTAUTH, NOTFND
INQUIRE TRANCLASS
┌ ┐────────────────────────────55─ ──INQUIRE TRANCLASS(data-value) ───
6┴┬ ┬──────────────────────── ─5%
├ ┤──ACTIVE(data-area) ─────├ ┤──MAXACTIVE(data-area) ──├ ┤──PURGETHRESH(data-area)└ ┘──QUEUED(data-area) ─────
Conditions: INVREQ, NOTAUTH, TCIDERR
142 CICS User’s Handbook
SPI syntax
INQUIRE TRANDUMPCODE
┌ ┐────────────────────────55─ ──INQUIRE TRANDUMPCODE(data-value) ───
6┴┬ ┬──────────────────── ─5%
├ ┤──CURRENT(data-area)├ ┤──DUMPSCOPE(cvda) ───├ ┤──MAXIMUM(data-area)├ ┤──SHUTOPTION(cvda) ──├ ┤──SYSDUMPING(cvda) ──└ ┘──TRANDUMPING(cvda) ─
Conditions: END, ILLOGIC, NOTAUTH, NOTFND
INQUIRE TRANSACTION
┌ ┐──────────────────────────────55─ ──INQUIRE TRANSACTION(data-value) ───
6┴┬ ┬────────────────────────── ─5%
├ ┤──BREXIT(data-area) ───────├ ┤ ─ ─CMDSEC(cvda) ────────────├ ┤──DTIMEOUT(data-area) ─────├ ┤──DUMPING(cvda) ───────────├ ┤──FACILITYLIKE(data-area) ─├ ┤──INDOUBT(cvda) ───────────├ ┤──INDOUBTMINS(data-area) ──├ ┤──INDOUBTWAIT(cvda) ───────├ ┤──ISOLATEST(cvda) ─────────├ ┤──PRIORITY(data-area) ─────├ ┤──PROFILE(data-area) ──────├ ┤──PROGRAM(data-area) ──────├ ┤──PURGEABILITY(cvda) ──────├ ┤──REMOTENAME(data-area) ───├ ┤──REMOTESYSTEM(data-area) ─├ ┤ ─ ─RESSEC(cvda) ────────────├ ┤──ROUTING(cvda) ───────────
| ├ ┤──ROUTESTATUS(cvda) ───────├ ┤──RTIMEOUT(data-area) ─────├ ┤──RUNAWAY(data-area) ──────├ ┤──RUNAWAYTYPE(cvda) ───────├ ┤──SCRNSIZE(cvda) ──────────├ ┤──SHUTDOWN(cvda) ──────────├ ┤ ─ ─STATUS(cvda) ────────────├ ┤──STORAGECLEAR(cvda) ──────├ ┤──TASKDATAKEY(cvda) ───────├ ┤──TASKDATALOC(cvda) ───────├ ┤──┬ ┬──TCLASS(data-area) ───│ │└ ┘──TRANCLASS(data-area)├ ┤──TRACING(cvda) ───────────├ ┤──TRPROF(data-area) ───────└ ┘──TWASIZE(data-area) ──────
Conditions: END, ILLOGIC, INVREQ, NOTAUTH, TRANSIDERR
Chapter 2. SPI command syntax 143
SPI syntax
| INQUIRE TSMODEL|
| ┌ ┐─────────────────────────────| 55─ ──INQUIRE ──TSMODEL(data-value) ───
6┴┬ ┬───────────────────────── ─5%
| ├ ┤──LOCATION(cvda) ─────────| ├ ┤──POOLNAME(data-area) ────| ├ ┤──PREFIX(data-area) ──────| ├ ┤──RECOVSTATUS(cvda) ──────| ├ ┤──REMOTEPREFIX(data-area)| ├ ┤──REMOTESYSTEM(data-area)| └ ┘──SECURITYST(cvda) ───────
| Conditions: END, ILLOGIC, NOTAUTH, NOTFND
| INQUIRE TSPOOL|
| 55─ ──INQUIRE ──TSPOOL(data-value) ──┬ ┬────────────────── ─5%| └ ┘──CONNSTATUS(cvda)
| Conditions: END, ILLOGIC, NOTAUTH, NOTFND
INQUIRE TSQUEUE
55─ ──INQUIRE ──┬ ┬──TSQUEUE(data-value) ──┬ ┬────────────────────── ───────────5| └ ┘──TSQNAME(data-value) ├ ┤──POOLNAME(data-value)| └ ┘──SYSID(data-value) ───
┌ ┐────────────────────────────5─ ───
6┴┬ ┬──────────────────────── ─5%
├ ┤──FLENGTH(data-area) ────├ ┤──LASTUSEDINT(data-area)├ ┤──LOCATION(cvda) ────────├ ┤──MAXITEMLEN(data-area) ─├ ┤──MINITEMLEN(data-area) ─├ ┤──NUMITEMS(data-area) ───
| ├ ┤──RECOVSTATUS(cvda) ─────└ ┘──TRANSID(data-area) ────
Conditions: END, ILLOGIC, INVREQ, NOTAUTH, POOLERR, QIDERR,SYSIDERR
144 CICS User’s Handbook
SPI syntax
INQUIRE UOW
┌ ┐─────────────────────────55─ ──INQUIRE UOW(data-area) ───
6┴┬ ┬───────────────────── ─5%
├ ┤──AGE(data-area) ─────├ ┤──LINK(data-area) ────├ ┤──NETNAME(data-area) ─├ ┤──NETUOWID(data-area)├ ┤──SYSID(data-area) ───├ ┤──TASKID(data-area) ──├ ┤──TERMID(data-area) ──├ ┤──TRANSID(data-area) ─├ ┤──UOWSTATE(cvda) ─────├ ┤──USERID(data-area) ──├ ┤──WAITCAUSE(cvda) ────└ ┘──WAITSTATE(cvda) ────
Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND
INQUIRE UOWDSNFAIL
55─ ──INQUIRE UOWDSNFAIL ──┬ ┬───────────── ──DSNAME(data-area) ────────────────5└ ┘──CAUSE(cvda)
5─ ──┬ ┬──────────────────── ──┬ ┬────────────── ──┬ ┬───────────────── ──────────5└ ┘──NETNAME(data-area) └ ┘──REASON(cvda) └ ┘──RLSACCESS(cvda)
5─ ──┬ ┬────────────────── ──UOW(data-area) ─5%└ ┘──SYSID(data-area)
Conditions: END, ILLOGIC, NOTAUTH
Chapter 2. SPI command syntax 145
SPI syntax
INQUIRE UOWENQ
| ┌ ┐────────────────────────────────────────────55─ ──INQUIRE UOWENQ ───
6┴┬ ┬──────────────────────────────────────── ──────────5
| ├ ┤──ENQSCOPE(data-value) ──────────────────| ├ ┤──| RESOURCE(data-value)| RESLEN(data-value)| └ ┘──UOW(data-value) ───────────────────────
┌ ┐──────────────────────────5─ ───
6┴┬ ┬────────────────────── ─5%
| ├ ┤──DURATION(data-area) ─├ ┤──ENQFAILS(data-area) ─├ ┤──NETUOWID(data-area) ─├ ┤──QUALIFIER(data-area)├ ┤──QUALLEN(data-area) ──├ ┤──RELATION(cvda) ──────├ ┤──RESLEN(data-area) ───├ ┤──RESOURCE(data-area) ─├ ┤──STATE(cvda) ─────────├ ┤──TASKID(data-area) ───├ ┤──TRANSID(data-area) ──├ ┤ ─ ─TYPE(cvda) ──────────└ ┘──UOW(data-area) ──────
Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND
INQUIRE UOWLINK
55─ ──INQUIRE UOWLINK(data-area) ──┬ ┬───────────────── ───────────────────────5 └ ┘──LINK(data-area)
5─ ──┬ ┬───────────────────── ──┬ ┬──────────────── ──┬ ┬──────────────────── ────5 └ ┘──NETUOWID(data-area) ├ ┤──PROTOCOL(cvda) ├ ┤──RESYNCSTATUS(cvda) ├ ┤─APPC─────────── ├ ┤─COLD─────────────── ├ ┤─IRC──────────── ├ ┤─NOTAPPLIC────────── ├ ┤─LU61─────────── ├ ┤─OK───────────────── ├ ┤─NOTAPPLIC────── ├ ┤─STARTING───────────
| └ ┘─RRMS─────────── ├ ┤─UNAVAILABLE──────── └ ┘─UNCONNECTED────────
5─ ──┬ ┬─────────────────── ──┬ ┬───────────── ──┬ ┬────────────────── ───────────5 └ ┘──RMIQFY(data-area) ├ ┤──ROLE(cvda) ─ └ ┘──SYSID(data-area) ├ ┤─COORDINATOR─ ├ ┤─SUBORDINATE─ └ ┘─UNKNOWN─────
5─ ──┬ ┬──────────── ──┬ ┬──────────────── ──┬ ┬───────────────── ─5%| ├ ┤──TYPE(cvda) └ ┘──| UOW(data-area) └ ┘──| URID(data-area)| ├ ┤─CFTABLE────
├ ┤─CONNECTION─ └ ┘─RMI────────
Conditions: END, ILLOGIC, NOTAUTH, UOWLNOTFOUND,UOWNOTFOUND
146 CICS User’s Handbook
SPI syntax
INQUIRE VTAM
┌ ┐─────────────────────────────────────────────────55─ ──INQUIRE VTAM ───
6┴┬ ┬───────────────────────────────────────────── ─5%
├ ┤──GRNAME(data-area) ──────────────────────────├ ┤──GRSTATUS(cvda) ─────────────────────────────├ ┤──OPENSTATUS(cvda) ───────────────────────────└ ┘──┬ ┬──PSDINTERVAL(data-area) ─────────────────
└ ┘─┤ psinhrs ├──┤ psinmins ├──┤ psinsecs ├─
psinhrs:├─ ──PSDINTHRS(data-area) ─┤
psinmins:├─ ──PSDINTMINS(data-area) ─┤
psinsecs:├─ ──PSDINTSECS(data-area) ─┤
Conditions: INVREQ, NOTAUTH
INQUIRE WEB
┌ ┐───────────────────────────55─ ──INQUIRE WEB(data-area) ───
6┴┬ ┬─────────────────────── ─5%
├ ┤──GARBAGEINT(data-area)└ ┘──TIMEOUTINT(data-area)
Conditions: NOTAUTH
PERFORM DELETSHIPPED
55─ ──PERFORM DELETSHIPPED ─5%
Conditions: NOTAUTH
Chapter 2. SPI command syntax 147
SPI syntax
PERFORM DUMP
55─ ──PERFORM DUMP DUMPCODE(data-value) ─────────────────────────────────────5
5─ ──┬ ┬─────────────────────────────────────────── ──────────────────────────5 └ ┘──TITLE(data-area) ──TITLELENGTH(data-value)
5─ ──┬ ┬────────────────────────────────────────────── ───────────────────────5 └ ┘──CALLER(data-value) ──CALLERLENGTH(data-value)
5─ ──┬ ┬──────────────────── ─5%└ ┘──DUMPID(data-value)
Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH,SUPPRESSED, SYSBUSY
PERFORM ENDAFFINITY
55─ ──PERFORM ENDAFFINITY ──NETNAME(data-value) ──┬ ┬─────────────────── ─5%└ ┘──NETID(data-value)
Conditions: INVREQ
PERFORM RESETTIME
55─ ──PERFORM RESETTIME ─5%
Conditions: INVREQ, NOTAUTH
PERFORM SECURITY REBUILD
55─ ──PERFORM SECURITY REBUILD ──┬ ┬──────────────────── ─5%└ ┘──ESMRESP(data-area)
Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSBUSY
148 CICS User’s Handbook
SPI syntax
PERFORM SHUTDOWN
55─ ──PERFORM SHUTDOWN ── ──┬ ┬────── ──┬ ┬────────────────────────────── ─5% └ ┘─DUMP─ ├ ┤─IMMEDIATE──────────────────── │ │┌ ┐──────────────────────────── └ ┘───
6┴┬ ┬────────────────────────
├ ┤──PLT(data-value) ───────├ ┤──┬ ┬──SDTRAN(data-value)
│ │└ ┘─NOSDTRAN───────────├ ┤──XLT(data-value) ───────
└ ┘─TAKEOVER───────────────
Conditions: INVREQ, NOTAUTH, TRANSIDERR
PERFORM STATISTICS RECORD
┌ ┐───────────────────────55─ ──PERFORM STATISTICS RECORD ───
6┴┬ ┬─────────────────── ─5%
├ ┤ ─ALL─ ──┬ ┬────────── │ │└ ┘─RESETNOW─ ├ ┤─AUTOINSTALL─────── ├ ┤─CONNECTION──────── ├ ┤─DB2─────────────── ├ ┤─DISPATCHER──────── ├ ┤─ENQUEUE─────────── ├ ┤─FEPI────────────── ├ ┤─FILE────────────── ├ ┤──┬ ┬─JOURNALNAME─ ── │ │└ ┘─JOURNALNUM── ├ ┤─LSRPOOL─────────── ├ ┤─MONITOR─────────── ├ ┤─PROGAUTO────────── ├ ┤─PROGRAM─────────── ├ ┤─RECOVERY────────── ├ ┤─STATS───────────── ├ ┤─STORAGE─────────── ├ ┤─STREAMNAME──────── ├ ┤─SYSDUMP─────────── ├ ┤─TABLEMGR──────────
| ├ ┤─TCPIPSERVICE────── ├ ┤─TDQUEUE─────────── ├ ┤─TERMINAL────────── ├ ┤──┬ ┬─TRANCLASS─ ──── │ │└ ┘─TCLASS──── ├ ┤─TRANDUMP────────── ├ ┤─TRANSACTION─────── ├ ┤─TSQUEUE─────────── └ ┘─VTAM──────────────
Conditions: IOERR, NOTAUTH, NOTFND
Chapter 2. SPI command syntax 149
SPI syntax
RESYNC ENTRYNAME
55─ ──RESYNC ENTRYNAME(data-value) ──┬ ┬─────────────────────── ───────────────5└ ┘──QUALIFIER(data-value)
5─ ──┬ ┬────────────────────────────────────────────────── ──┬ ┬───────── ─5% └ ┘──IDLIST(data-value) ──┬ ┬────────────────────────── └ ┘──PARTIAL
└ ┘──IDLISTLENGTH(data-value)
Conditions: NOTAUTH
SET AUTOINSTALL
55─ ──SET AUTOINSTALL ──┬ ┬──────────────── ──┬ ┬───────────────────── ──────────5| └ ┘──CONSOLES(cvda) └ ┘──MAXREQS(data-value)
5─ ──┬ ┬───────────────────── ─5%└ ┘──PROGRAM(data-value)
Conditions: INVREQ, NOTAUTH, PGMIDERR
SET CONNECTION
55─ ──SET CONNECTION(data-value) ──┬ ┬────────────────── ──┬ ┬──────────────── ──5├ ┤──ACQSTATUS(cvda) ─ ├ ┤──AFFINITY(cvda)├ ┤──CONNSTATUS(cvda) └ ┘─ENDAFFINITY────
├ ┤─ACQUIRED───────── └ ┘─RELEASED─────────
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────── ───────5├ ┤──EXITTRACING(cvda) ├ ┤──PENDSTATUS(cvda) ├ ┤──PURGETYPE(cvda)
├ ┤─EXITTRACE───────── └ ┘─NOTPENDING─────── ├ ┤─CANCEL────────── └ ┘─NOEXITTRACE─────── ├ ┤─FORCECANCEL───── ├ ┤─FORCEPURGE────── └ ┘─PURGE───────────
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────── ───────5├ ┤──RECOVSTATUS(cvda) ├ ┤──SERVSTATUS(cvda) ├ ┤──UOWACTION(cvda)
└ ┘─NORECOVDATA─────── ├ ┤─INSERVICE──────── ├ ┤─BACKOUT───────── └ ┘─OUTSERVICE─────── ├ ┤─COMMIT────────── ├ ┤─FORCE─────────── └ ┘─RESYNC──────────
5─ ──┬ ┬────────────────── ─5%├ ┤──ZCPTRACING(cvda)
├ ┤─NOZCPTRACE─────── └ ┘─ZCPTRACE─────────
Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSIDERR
150 CICS User’s Handbook
SPI syntax
SET DB2CONN
55─ ──SET DB2CONN ───────────────────────────────────────────────────────────5
┌ ┐───────────────────────────── ┌ ┐─────────────────────────────5─ ───
6┴┬ ┬───────────────────────── ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── ├ ┤──DB2ID(data-area) ───────│ │├ ┤─UOW────────────── ├ ┤──MSGQUEUE1(data-area) ───│ │├ ┤─TASK───────────── ├ ┤──MSGQUEUE2(data-area) ───│ │├ ┤─TXID───────────── ├ ┤──MSGQUEUE3(data-area) ───│ │└ ┘─NONE───────────── ├ ┤──┬ ┬──NONTERMREL(cvda) ───├ ┤──AUTHID(data-area) ────── │ │├ ┤─RELEASE──────────├ ┤──┬ ┬──AUTHTYPE(cvda) ───── │ │└ ┘─NORELEASE────────│ │├ ┤─GROUP────────── ├ ┤──PLAN(data-area) ────────│ │├ ┤─SIGN─────────── ├ ┤──PLANEXITNAME(data-area)│ │├ ┤─TERM─────────── ├ ┤──┬ ┬──PRIORITY(cvda) ─────
│ │├ ┤─TX───────────── │ │├ ┤─HIGH─────────── │ │├ ┤─OPID─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─USERID───────── │ │└ ┘─LOW────────────
├ ┤──┬ ┬──BUSY(cvda) ───────── ├ ┤──PURGECYCLEM(data-area) ─│ │├ ┤─WAIT─────── ├ ┤──PURGECYCLES(data-area) ─│ │├ ┤─NOWAIT───── ├ ┤──SECURITY(REBUILD) ──────│ │└ ┘─FORCE────── ├ ┤──SIGNID(data-area) ──────├ ┤──COMAUTHID(data-area) ─── ├ ┤──┬ ┬──STANDBYMODE(cvda) ──├ ┤──┬ ┬──COMAUTHTYPE(cvda) ── │ │├ ┤─NOCONNECT─────────
│ │├ ┤─CGROUP──────────── │ │├ ┤─CONNECT─────────── │ │├ ┤─CSIGN───────────── │ │└ ┘─RECONNECT─────────
│ │├ ┤─CTERM───────────── ├ ┤──STATSQUEUE(data-area) ──│ │├ ┤─CTX─────────────── ├ ┤──TCBLIMIT(data-area) ────│ │├ ┤─COPID───────────── ├ ┤──THREADLIMIT(data-area) ─│ │└ ┘─CUSERID─────────── └ ┘──┬ ┬──THREADWAIT(cvda) ───├ ┤──COMTHREADLIM(data-area) ├ ┤─TWAIT────────────├ ┤──┬ ┬──CONNECTERROR(cvda) ─ ├ ┤─NOTWAIT──────────
│ │├ ┤─ABEND────────────── └ ┘─N9ð6───────────── │ │└ ┘─SQLCODE────────────
└ ┘──┬ ┬──CONNECTST(cvda) ──── ├ ┤─CONNECTED─────── └ ┘─NOTCONNECTED────
Conditions: NORMAL, NOTAUTH, NOTFND, INVREQ
Chapter 2. SPI command syntax 151
SPI syntax
55─ ─SET DB2ENTRY─ ──┬ ┬───────────── ──────────────────────────────5└ ┘──(data-area)
┌ ┐─────────────────────────────5─ ───
6┴┬ ┬───────────────────────── ──────────────────────────────5%
├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── │ │├ ┤─UOW────────────── │ │├ ┤─TASK───────────── │ │├ ┤─TXID───────────── │ │└ ┘─NONE─────────────
├ ┤──AUTHID(data-area) ──────├ ┤──┬ ┬──AUTHTYPE(cvda) ─────
│ │├ ┤─GROUP────────── │ │├ ┤─SIGN─────────── │ │├ ┤─TERM─────────── │ │├ ┤─TX───────────── │ │├ ┤─OPID─────────── │ │└ ┘─USERID─────────
├ ┤──┬ ┬──BUSY(cvda) ───────── │ │├ ┤─WAIT─────── │ │├ ┤─NOWAIT───── │ │└ ┘─FORCE──────
├ ┤──┬ ┬──DISABLEDACT(cvda) ── │ │├ ┤─ABEND───────────── │ │├ ┤─SQLCODE─────────── │ │└ ┘─POOL──────────────
├ ┤──┬ ┬──ENABLESTATUS(cvda) ─ │ │├ ┤─ENABLED──────────── │ │└ ┘─DISABLED───────────
├ ┤──PLAN(data-area) ────────├ ┤──PLANEXITNAME(data-area)├ ┤──┬ ┬──PRIORITY(cvda) ─────
│ │├ ┤─HIGH─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─LOW────────────
├ ┤──PROTECTNUM(data-area) ──├ ┤──THREADLIMIT(data-area) ─└ ┘──┬ ┬──THREADWAIT(cvda) ───
├ ┤─TWAIT──────────── ├ ┤─NOWAIT─────────── └ ┘─TPOOL────────────
Conditions: NOTAUTH, NOTFND, INVREQ
152 CICS User’s Handbook
SPI syntax
┌ ┐─────────────────────────55─ ──SET DB2TRAN ───
6┴┬ ┬───────────────────── ────────────────────5%
├ ┤──DB2ENTRY(data-area)└ ┘──TRANSID(data-area) ─
Conditions: NOTAUTH, NOTFND, INVREQ
SET DELETSHIPPED
55─ ──SET DELETSHIPPED ──┬ ┬──────────────────────────── ──────────────────────5├ ┤──IDLE(data-value) ──────────
│ │┌ ┐────────────────────────── └ ┘───
6┴┬ ┬──────────────────────
├ ┤──IDLEHRS(data-value) ─├ ┤──IDLEMINS(data-value)└ ┘──IDLESECS(data-value)
5─ ──┬ ┬──────────────────────────────── ─5%├ ┤──INTERVAL(data-value) ──────────
│ │┌ ┐────────────────────────────── └ ┘───
6┴┬ ┬──────────────────────────
├ ┤──INTERVALHRS(data-value) ─├ ┤──INTERVALMINS(data-value)└ ┘──INTERVALSECS(data-value)
Conditions: INVREQ, NOTAUTH
SET DSNAME
55─ ──SET DSNAME(data-value) ──┬ ┬────────────── ──┬ ┬──────────────────── ──────5├ ┤──ACTION(cvda) ├ ┤──AVAILABILITY(cvda)
├ ┤─REMOVE─────── ├ ┤─AVAILABLE────────── ├ ┤─RECOVERED──── └ ┘─UNAVAILABLE──────── ├ ┤─RESETLOCKS─── └ ┘─RETRY────────
┌ ┐─WAIT───────5─ ──┬ ┬─────────────────── ──┼ ┼──────────── ──┬ ┬───────────────── ─5%
├ ┤──QUESCESTATE(cvda) ├ ┤──BUSY(cvda) ├ ┤──UOWACTION(cvda) ├ ┤─QUIESCED────────── └ ┘─NOWAIT───── ├ ┤─BACKOUT───────── ├ ┤─IMMQUIESCED─────── ├ ┤─COMMIT────────── └ ┘─UNQUIESCED──────── └ ┘─FORCE───────────
Conditions: DSNNOTFOUND, INVREQ, IOERR,NOTAUTH, SUPPRESSED
Chapter 2. SPI command syntax 153
SPI syntax
SET DUMPDS
55─ ──SET DUMPDS ──┬ ┬──────────────────────── ──┬ ┬────────────────── ──────────5└ ┘──INITIALDDS(data-value) ├ ┤──OPENSTATUS(cvda)
├ ┤─CLOSED─────────── ├ ┤─OPEN───────────── └ ┘─SWITCH───────────
5─ ──┬ ┬──────────────────── ─5%├ ┤──SWITCHSTATUS(cvda)
├ ┤─NOSWITCH─────────── └ ┘─SWITCHNEXT─────────
Conditions: INVREQ, IOERR, NOTAUTH
| SET ENQMODEL|
| 55─ ──SET ENQMODEL(data-value) ──┬ ┬──STATUS(cvda) ─5%| ├ ┤─DISABLED─────| └ ┘─ENABLED──────
| Conditions: INVREQ, NOTAUTH, NOTFND
SET FILE
55─ ──┬ ┬──SET FILE(data-value) ─── ─── ───ATTRIBUTES(data-value) ─5%└ ┘──SET DATASET(data-value)
Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH
154 CICS User’s Handbook
SPI syntax
SET FILE
FILE attributes: ┌ ┐─WAIT───────├─ ──┬ ┬──────────── ──┬ ┬────────────── ──┼ ┼──────────── ───────────────────────5
├ ┤──ADD(cvda) ─ ├ ┤──BROWSE(cvda) ├ ┤──BUSY(cvda) ├ ┤─ADDABLE──── ├ ┤─BROWSABLE──── ├ ┤─FORCE────── └ ┘─NOTADDABLE─ └ ┘─NOTBROWSABLE─ └ ┘─NOWAIT─────
5─ ──┬ ┬────────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────── ──────5| └ ┘──CFDTPOOL(data-value) ├ ┤──DELETE(cvda) ├ ┤──DISPOSITION(cvda)
├ ┤─DELETABLE──── ├ ┤─OLD─────────────── └ ┘─NOTDELETABLE─ └ ┘─SHARE─────────────
5─ ──┬ ┬──────────────────────── ──┬ ┬─────────────────── ──────────────────────5├ ┤──DSNAME(data-value) ──── ├ ┤──EMPTYSTATUS(cvda)└ ┘──OBJECTNAME(data-value) ├ ┤─EMPTY─────────────
├ ┤─EMPTYREQ────────── └ ┘─NOEMPTYREQ────────
┌ ┐────────────────────────────────5─ ───
6┴┬ ┬──────────────────────────── ──┬ ┬───────────────── ──────────────────5
└ ┘──┬ ┬──┬ ┬──ENABLESTATUS(cvda) ├ ┤──EXCLUSIVE(cvda) │ │├ ┤─DISABLED─────────── ├ ┤─EXCTL─────────── │ │└ ┘─ENABLED──────────── └ ┘─NOEXCTL─────────
└ ┘──┬ ┬──OPENSTATUS(cvda) ── ├ ┤─CLOSED─────────── └ ┘─OPEN─────────────
5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────── ──────────────────────────5| └ ┘──KEYLENGTH(data-value) ├ ┤──LOADTYPE(cvda)| ├ ┤─LOAD───────────| └ ┘─NOLOAD─────────
5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────────── ──────────────────5└ ┘──LSRPOOLID(data-value) └ ┘──MAXNUMRECS(data-value)
5─ ──┬ ┬───────────── ──┬ ┬──────────────────────── ──┬ ┬───────────────── ───────5| ├ ┤──READ(cvda) ─ └ ┘──RECORDSIZE(data-value) ├ ┤──READINTEG(cvda)
├ ┤─NOTREADABLE─ ├ ┤─UNCOMMITTED───── └ ┘─READABLE──── ├ ┤─CONSISTENT────── └ ┘─REPEATABLE──────
5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ──┬ ┬───────────── ──────────5├ ┤──RLSACCESS(cvda) └ ┘──STRINGS(data-value) ├ ┤──TABLE(cvda)
| ├ ┤─RLS───────────── ├ ┤─CFTABLE───── ├ ┤─NOTAPPLIC─────── ├ ┤─CICSTABLE─── └ ┘─NOTRLS────────── ├ ┤─NOTTABLE──── └ ┘─USERTABLE───
5─ ──┬ ┬─────────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────── ─┤| └ ┘──TABLENAME(data-value) ├ ┤──UPDATE(cvda) ├ ┤──UPDATEMODEL(cvda)| ├ ┤─NOTUPDATABLE─ ├ ┤─CONTENTION────────| └ ┘─UPDATABLE──── └ ┘─LOCKING───────────
Chapter 2. SPI command syntax 155
SPI syntax
SET IRC
55─ ──SET IRC ──┬ ┬────────────────── ─5%├ ┤──OPENSTATUS(cvda)
├ ┤─CLOSED─────────── ├ ┤─IMMCLOSE───────── └ ┘─OPEN─────────────
Conditions: INVREQ, IOERR, NOSTG, NOTAUTH
SET JOURNALNAME
55─ ──SET JOURNALNAME(data-value) ──┬ ┬──ACTION(cvda) ──┬ ┬──STATUS(cvda) ─5% ├ ┤─FLUSH──────── ├ ┤─DISABLED───── └ ┘─RESET──────── └ ┘─ENABLED──────
Conditions: INVREQ, IOERR, JIDERR, NOTAUTH
SET MODENAME
55─ ──SET MODENAME(data-value) ──CONNECTION(data-value) ──────────────────────5
5─ ──┬ ┬──────────────────────────────────────────── ─5% ├ ┤──AVAILABLE(data-value) ──┬ ┬─────────────────
│ │├ ┤──ACQSTATUS(cvda) │ │└ ┘─ACQUIRED────────
└ ┘──┬ ┬──ACQSTATUS(cvda) ─────────────────────── └ ┘─CLOSED──────────
Conditions: INVREQ, NOTAUTH, SYSIDERR
156 CICS User’s Handbook
SPI syntax
SET MONITOR
55─ ──SET MONITOR ──┬ ┬────────────────── ──┬ ┬────────────────── ───────────────5├ ┤──CONVERSEST(cvda) ├ ┤──EVENTCLASS(cvda)
├ ┤─CONVERSE───────── ├ ┤─EVENT──────────── └ ┘─NOCONVERSE─────── └ ┘─NOEVENT──────────
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────────────────────── ────────────5├ ┤──EXCEPTCLASS(cvda) ├ ┤──FREQUENCY(data-value) ───────────
├ ┤─EXCEPT──────────── │ │┌ ┐──────────────────────────────── └ ┘─NOEXCEPT────────── └ ┘───
6┴──┬ ┬──────────────────────────
├ ┤──FREQUENCYHRS(data-value)| ├ ┤──FREQUENCYMIN| (data-value)| └ ┘──FREQUENCYSEC(data-value)
5─ ──┬ ┬───────────────── ──┬ ┬────────────── ──┬ ┬─────────────────── ─5%├ ┤──PERFCLASS(cvda) ├ ┤──STATUS(cvda) ├ ┤──SYNCPOINTST(cvda)
├ ┤─PERF──────────── ├ ┤─ON─────────── ├ ┤─SYNCPOINT───────── └ ┘─NOPERF────────── └ ┘─OFF────────── └ ┘─NOSYNCPOINT───────
Conditions: INVREQ, NOTAUTH
SET NETNAME
55─ ──SET NETNAME(data-value) ──┬ ┬─────────────────── ─5%├ ┤──EXITTRACING(cvda)
├ ┤─EXITTRACE───────── └ ┘─NOEXITTRACE───────
Conditions: INVREQ, NOTAUTH
SET PROCESSTYPE
55──SET─ ──PROCESSTYPE(data-value) ──┬ ┬────────────── ──┬ ┬────────────────── ─5%├ ┤──STATUS(cvda) ├ ┤──AUDITLEVEL(cvda)
├ ┤─DISABLED───── ├ ┤─ACTIVITY───────── └ ┘─ENABLED────── ├ ┤─FULL───────────── ├ ┤─OFF────────────── └ ┘─PROCESS──────────
Conditions: INVREQ, NOTAUTH, PROCESSERR
Chapter 2. SPI command syntax 157
SPI syntax
SET PROGRAM
55─ ──SET PROGRAM(data-value) ──┬ ┬────────────────── ──┬ ┬──────────── ─────────5├ ┤──CEDFSTATUS(cvda) ├ ┤──COPY(cvda)
├ ┤─CEDF───────────── ├ ┤─NEWCOPY──── └ ┘─NOCEDF─────────── └ ┘─PHASEIN────
5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ──────────────────────────5├ ┤──EXECUTIONSET(cvda) ├ ┤──SHARESTATUS(cvda)
├ ┤─DPLSUBSET────────── ├ ┤─PRIVATE─────────── └ ┘─FULLAPI──────────── └ ┘─SHARED────────────
5─ ──┬ ┬─────────────────────────────────── ──┬ ┬──────────────── ──────────────5| └ ┘──JVMCLASS(255-character data-area) ├ ┤──JVMDEBUG(cvda)| ├ ┤─DEBUG──────────| └ ┘─NODEBUG────────
5─ ──┬ ┬─────────────── ──┬ ┬────────────── ──┬ ┬─────────────── ─5%| ├ ┤──RUNTIME(cvda) ├ ┤──STATUS(cvda) └ ┘──VERSION(cvda)| ├ ┤─JVM─────────── ├ ┤─DISABLED─────| └ ┘─NOJVM───────── └ ┘─ENABLED──────
Conditions: INVREQ, IOERROR, NOTAUTH, PGMIDERR
SET STATISTICS
55─ ──SET STATISTICS ──┬ ┬──────────────────────────────── ────────────────────5├ ┤──ENDOFDAY(data-value) ──────────
│ │┌ ┐────────────────────────────── └ ┘───
6┴┬ ┬──────────────────────────
├ ┤──ENDOFDAYHRS(data-value) ─├ ┤──ENDOFDAYMINS(data-value)└ ┘──ENDOFDAYSECS(data-value)
5─ ──┬ ┬──────────────────────────────── ─────────────────────────────────────5├ ┤──INTERVAL(data-value) ──────────
│ │┌ ┐────────────────────────────── └ ┘───
6┴┬ ┬──────────────────────────
├ ┤──INTERVALHRS(data-value) ─├ ┤──INTERVALMINS(data-value)└ ┘──INTERVALSECS(data-value)
5─ ──┬ ┬────────────────────────────────────────────────── ─5% └ ┘──┬ ┬──RECORDING(cvda) ──┬ ┬─────────── ──┬ ┬────────── ├ ┤─ON────────────── └ ┘─RECORDNOW─ └ ┘─RESETNOW─ └ ┘─OFF─────────────
Conditions: INVREQ, NOTAUTH
158 CICS User’s Handbook
SPI syntax
SET SYSDUMPCODE
55─ ──SET SYSDUMPCODE(data-value) ──┬ ┬────────────── ──┬ ┬───────────────── ────5├ ┤──ACTION(cvda) ├ ┤──DAEOPTION(cvda)
├ ┤─ADD────────── ├ ┤─DAE───────────── ├ ┤─REMOVE─────── └ ┘─NODAE─────────── └ ┘─RESET────────
5─ ──┬ ┬───────────────── ──┬ ┬───────────────────── ──┬ ┬────────────────── ─────5├ ┤──DUMPSCOPE(cvda) └ ┘──MAXIMUM(data-value) ├ ┤──SHUTOPTION(cvda)
├ ┤─LOCAL─────────── ├ ┤─NOSHUTDOWN─────── └ ┘─RELATED───────── └ ┘─SHUTDOWN─────────
5─ ──┬ ┬────────────────── ─5%├ ┤──SYSDUMPING(cvda)
├ ┤─NOSYSDUMP──────── └ ┘─SYSDUMP──────────
Conditions: DUPREC, INVREQ, IOERR, NOSPACE, NOTAUTH,NOTFND
SET SYSTEM
┌ ┐──────────────────────────────────────────────────────55─ ──SET SYSTEM ───
6┴┬ ┬────────────────────────────────────────────────── ─5%
├ ┤──AKP(data-value) ─────────────────────────────────├ ┤──DSALIMIT(data-value) ────────────────────────────
| ├ ┤──DSRTPROGRAM(data-value) ─────────────────────────├ ┤──DTRPROGRAM(data-value) ──────────────────────────├ ┤──┬ ┬──DUMPING(cvda) ───────────────────────────────
│ │├ ┤─NOSYSDUMP───── │ │└ ┘─SYSDUMP───────
├ ┤──EDSALIMIT(data-value) ───────────────────────────| ├ ┤──FORCEQR(cvda) ───────────────────────────────────
├ ┤──GMMTEXT(data-value) ──┬ ┬─────────────────────── ──│ │└ ┘──GMMLENGTH(data-value)
| ├ ┤──LOGDEFER(data-area) ─────────────────────────────| ├ ┤──MAXOPENTCBS(data-value) ─────────────────────────
├ ┤──MAXTASKS(data-value) ──┬ ┬────────────────────────│ │└ ┘──NEWMAXTASKS(data-area)├ ┤──MROBATCH(data-value) ────────────────────────────├ ┤──┬ ┬──PROGAUTOCTLG(cvda) ──────────────────────────
│ │├ ┤─CTLGALL──────────── │ │├ ┤─CTLGMODIFY───────── │ │└ ┘─CTLGNONE───────────
├ ┤ ─ ─PROGAUTOEXIT(data-value) ────────────────────────├ ┤──┬ ┬──PROGAUTOINST(cvda) ──────────────────────────
│ │├ ┤─AUTOACTIVE───────── │ │└ ┘─AUTOINACTIVE───────
├ ┤──PRTYAGING(data-value) ───────────────────────────├ ┤──RUNAWAY(data-value) ─────────────────────────────├ ┤──SCANDELAY(data-value) ───────────────────────────└ ┘──TIME(data-value) ────────────────────────────────
Conditions: INVREQ, LENGERR, NOSTG, NOTAUTH
Chapter 2. SPI command syntax 159
SPI syntax
SET TASK
55─ ──SET TASK(data-value) ──┬ ┬────────────────────── ──┬ ┬───────────────── ─5%└ ┘──PRIORITY(data-value) ├ ┤──PURGETYPE(cvda)
├ ┤─FORCEPURGE────── └ ┘─PURGE───────────
Conditions: INVREQ, NOTAUTH, TASKIDERR
SET TCLASS
55─ ──SET TCLASS(data-value) ──┬ ┬───────────────────── ─5%└ ┘──MAXIMUM(data-value)
Conditions: INVREQ, NOTAUTH, TCIDERR
SET TCPIP
55─ ──SET TCPIP ──┬ ┬──STATUS(data-value) ─5% ├ ┤─CLOSE────────────── ├ ┤─IMMCLOSE─────────── └ ┘─OPEN───────────────
Conditions: INVREQ, IOERR, NOTAUTH
SET TCPIPSERVICE
55─ ──SET TCPIPSERVICE(data-value) ──┬ ┬────────────── ──┬ ┬───────────────── ─5%├ ┤──STATUS(cvda) └ ┘──URM(data-value)
├ ┤─CLOSE──────── ├ ┤─IMMCLOSE───── └ ┘─OPEN─────────
Conditions: INVREQ, NOTAUTH, NOTFND
160 CICS User’s Handbook
SPI syntax
SET TDQUEUE
55─ ──SET TDQUEUE(data-value) ──┬ ┬─────────────────── ────────────────────────5├ ┤──ATIFACILITY(cvda)
├ ┤─NOTERMINAL──────── └ ┘─TERMINAL──────────
5─ ──┬ ┬─────────────────────── ──┬ ┬─────────────────────── ───────────────────5└ ┘──ATITERMID(data-value) └ ┘──ATITRANID(data-value)
5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────── ──────────────────────5└ ┘──ATIUSERID(data-value) ├ ┤──ENABLESTATUS(cvda)
├ ┤─DISABLED─────────── └ ┘─ENABLED────────────
5─ ──┬ ┬────────────────── ──┬ ┬────────────────────────── ─5%├ ┤──OPENSTATUS(cvda) └ ┘──TRIGGERLEVEL(data-value)
├ ┤─CLOSED─────────── └ ┘─OPEN─────────────
Conditions: INVREQ, IOERR, NOTAUTH, QIDERR, USERIDERR
Chapter 2. SPI command syntax 161
SPI syntax
SET TERMINAL
55─ ──SET TERMINAL(data-value) ──┬ ┬────────────────── ────────────────────────5├ ┤──ACQSTATUS(cvda) ─├ ┤──TERMSTATUS(cvda)
├ ┤─ACQUIRED───────── ├ ┤─COLDACQ────────── └ ┘─RELEASED─────────
5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─────────────────────5└ ┘──ALTPRINTER(data-value) ├ ┤──ALTPRTCOPYST(cvda)
├ ┤─ALTPRTCOPY───────── └ ┘─NOALTPRTCOPY───────
5─ ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬───────────────── ─────────5├ ┤──ATISTATUS(cvda) ├ ┤──CREATESESS(cvda) ├ ┤──DISCREQST(cvda)
├ ┤─ATI───────────── ├ ┤─CREATE─────────── ├ ┤─DISCREQ───────── └ ┘─NOATI─────────── └ ┘─NOCREATE───────── └ ┘─NODISCREQ───────
5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ─────────────────────────5├ ┤──EXITTRACING(cvda) └ ┘──MAPNAME(data-value)
├ ┤─EXITTRACE───────── └ ┘─NOEXITTRACE───────
5─ ──┬ ┬──────────────────────── ──┬ ┬───────────────────────── ────────────────5└ ┘──MAPSETNAME(data-value) └ ┘──NEXTTRANSID(data-value)
5─ ──┬ ┬────────────────── ──┬ ┬──────────────────── ──┬ ┬────────────────── ─────5├ ┤──OBFORMATST(cvda) └ ┘──OPERID(data-value) ├ ┤──PAGESTATUS(cvda)
├ ┤─OBFORMAT───────── ├ ┤─AUTOPAGEABLE───── └ ┘─NOOBFORMAT─────── └ ┘─PAGEABLE─────────
5─ ──┬ ┬───────────────────── ──┬ ┬───────────────── ──┬ ┬────────────────── ─────5└ ┘──PRINTER(data-value) ├ ┤──PRTCOPYST(cvda) ├ ┤──PURGETYPE(cvda) ─
├ ┤─PRTCOPY───────── ├ ┤─FORCEPURGE─────── └ ┘─NOPRTCOPY─────── ├ ┤ ─PURGE─ ──┬ ┬─────── │ │└ ┘─FORCE─ └ ┘─CANCEL───────────
5─ ──┬ ┬──────────────── ──┬ ┬────────────────── ───────────────────────────────5├ ┤──RELREQST(cvda) ├ ┤──SERVSTATUS(cvda)
├ ┤─RELREQ───────── ├ ┤─INSERVICE──────── └ ┘─NORELREQ─────── └ ┘─OUTSERVICE───────
5─ ──┬ ┬───────────────────────── ──┬ ┬────────────────────────── ──────────────5└ ┘──TCAMCONTROL(data-value) └ ┘──TERMPRIORITY(data-value)
5─ ──┬ ┬─────────────── ──┬ ┬───────────────── ──┬ ┬──────────────── ─────────────5├ ┤──TRACING(cvda) ├ ┤──TTISTATUS(cvda) ├ ┤──UCTRANST(cvda)
├ ┤─SPECTRACE───── ├ ┤─NOTTI─────────── ├ ┤─UCTRAN───────── └ ┘─STANTRACE───── └ ┘─TTI───────────── ├ ┤─NOUCTRAN─────── └ ┘─TRANIDONLY─────
5─ ──┬ ┬────────────────── ─5%├ ┤──ZCPTRACING(cvda)
├ ┤─NOZCPTRACE─────── └ ┘─ZCPTRACE─────────
Conditions: INVREQ, NORMAL, NOTAUTH, TERMIDERR
162 CICS User’s Handbook
SPI syntax
SET TRACEDEST
55─ ──SET TRACEDEST ──┬ ┬───────────────── ──┬ ┬───────────────── ───────────────5├ ┤──AUXSTATUS(cvda) ├ ┤──GTFSTATUS(cvda)
├ ┤─AUXPAUSE──────── ├ ┤─GTFSTART──────── ├ ┤─AUXSTART──────── └ ┘─GTFSTOP───────── └ ┘─AUXSTOP─────────
5─ ──┬ ┬───────────────── ──┬ ┬──────────────────── ──┬ ┬──────────────────── ────5├ ┤──INTSTATUS(cvda) ├ ┤──SWITCHACTION(cvda) ├ ┤──SWITCHSTATUS(cvda)
├ ┤─INTSTART──────── └ ┘─SWITCH───────────── ├ ┤─NOSWITCH─────────── └ ┘─INTSTOP───────── ├ ┤─SWITCHALL────────── └ ┘─SWITCHNEXT─────────
5─ ──┬ ┬─────────────────────── ─5%└ ┘──TABLESIZE(data-value)
Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH
SET TRACEFLAG
55─ ──SET TRACEFLAG ──┬ ┬──────────────────── ──┬ ┬──────────────────── ─────────5├ ┤──SINGLESTATUS(cvda) ├ ┤──SYSTEMSTATUS(cvda)
├ ┤─SINGLEOFF────────── ├ ┤─SYSTEMOFF────────── └ ┘─SINGLEON─────────── └ ┘─SYSTEMON───────────
5─ ──┬ ┬──────────────────── ──┬ ┬────────────────── ─5%├ ┤──TCEXITSTATUS(cvda) ├ ┤──USERSTATUS(cvda)
├ ┤─TCEXITALL────────── ├ ┤─USEROFF────────── ├ ┤─TCEXITALLOFF─────── └ ┘─USERON─────────── ├ ┤─TCEXITNONE───────── └ ┘─TCEXITSYSTEM───────
Conditions: INVREQ, NOTAUTH
SET TRACETYPE
┌ ┐────────────────────────55─ ──SET TRACETYPE ──┬ ┬─STANDARD─ ───
6┴┬ ┬──────────────────── ─5%
└ ┘─SPECIAL── └ ┘──COMPID(data-value)
Conditions: NOTAUTH, NOTFND
Chapter 2. SPI command syntax 163
SPI syntax
SET TRANCLASS
55─ ──SET TRANCLASS(data-value) ──┬ ┬─────────────────────── ──────────────────5└ ┘──MAXACTIVE(data-value)
5─ ──┬ ┬───────────────────────── ─5%└ ┘──PURGETHRESH(data-value)
Conditions: INVREQ, NOTAUTH, TCIDERR
SET TRANDUMPCODE
55─ ──SET TRANDUMPCODE(data-value) ──┬ ┬────────────── ──┬ ┬───────────────── ───5├ ┤──ACTION(cvda) ├ ┤──DUMPSCOPE(cvda)
├ ┤─ADD────────── ├ ┤─LOCAL─────────── ├ ┤─REMOVE─────── └ ┘─RELATED───────── └ ┘─RESET────────
5─ ──┬ ┬───────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ────5└ ┘──MAXIMUM(data-value) ├ ┤──SHUTOPTION(cvda) ├ ┤──SYSDUMPING(cvda)
├ ┤─NOSHUTDOWN─────── ├ ┤─NOSYSDUMP──────── └ ┘─SHUTDOWN───────── └ ┘─SYSDUMP──────────
5─ ──┬ ┬─────────────────── ─5%├ ┤──TRANDUMPING(cvda)
├ ┤─NOTRANDUMP──────── └ ┘─TRANDUMP──────────
Conditions: DUPREC, INVREQ, IOERR, NOSPACE,NOTAUTH, NOTFND
164 CICS User’s Handbook
SPI syntax
SET TRANSACTION
55─ ──SET TRANSACTION(data-value) ──┬ ┬─────────────── ────────────────────────5├ ┤──DUMPING(cvda)
├ ┤─TRANDUMP────── └ ┘─NOTRANDUMP────
5─ ──┬ ┬────────────────────── ──┬ ┬──────────────────── ───────────────────────5└ ┘──PRIORITY(data-value) ├ ┤──PURGEABILITY(cvda)
├ ┤─NOTPURGEABLE─────── └ ┘─PURGEABLE──────────
5─ ──┬ ┬───────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ─────5└ ┘──RUNAWAY(data-value) ├ ┤──RUNAWAYTYPE(cvda) ├ ┤──SHUTDOWN(cvda)
├ ┤─SYSTEM──────────── ├ ┤─SHUTDISABLED─── └ ┘─USER────────────── └ ┘─SHUTENABLED────
5─ ──┬ ┬────────────── ──┬ ┬─────────────────────── ──┬ ┬─────────────── ─5%├ ┤──STATUS(cvda) ├ ┤──TCLASS(data-value) ─── ├ ┤──TRACING(cvda)├ ┤─DISABLED───── └ ┘──TRANCLASS(data-value) ├ ┤─SPECTRACE─────
└ ┘─ENABLED────── ├ ┤─SPRSTRACE───── └ ┘─STANTRACE─────
Conditions: INVREQ, NOTAUTH, TRANSIDERR
| SET TSQUEUE|
| 55─ ──SET ──┬ ┬──TSQUEUE(data-value) ──┬ ┬────────────────────── ───────────────5| └ ┘──TSQNAME(data-value) ├ ┤──SYSID(data-value) ───| └ ┘──POOLNAME(data-value)
| 5─ ──┬ ┬─────────────────────────────────────────── ─5%| ├ ┤──ACTION(cvda) ──┬ ┬─────────────────────────| │ │└ ┘──LASTUSEDINT(data-value)| └ ┘─DELETE────────────────────────────────────
| Conditions: INVREQ, NOTAUTH, NOTFND, POOLERR, QIDERR,| SYSIDERR
SET UOW
55─ ──SET UOW(data-value) ──┬ ┬──UOWSTATE(cvda) ─5% ├ ┤─COMMIT───────── ├ ┤─BACKOUT──────── └ ┘─FORCE──────────
Conditions: INVREQ, NOTAUTH, UOWNOTFOUND
Chapter 2. SPI command syntax 165
SPI syntax
SET UOWLINK
55─ ──SET UOWLINK(data-value) ──┬ ┬────────────── ─5%├ ┤──ACTION(cvda)
└ ┘─DELETE───────
Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND
SET VTAM
55─ ──SET VTAM ──┬ ┬────────────────── ──┬ ┬────────────────────────────── ──────5├ ┤──OPENSTATUS(cvda) ├ ┤──PSDINTERVAL(data-value) ─────
├ ┤─CLOSED─────────── │ │┌ ┐──────────────────────────── ├ ┤─FORCECLOSE─────── └ ┘───
6┴┬ ┬────────────────────────
├ ┤─IMMCLOSE───────── ├ ┤──PSDINTHRS(data-value) ─└ ┘─OPEN───────────── ├ ┤──PSDINTMINS(data-value)
└ ┘──PSDINTSECS(data-value)
5─ ──┬ ┬────────────── ─5% └ ┘──DEREGISTERED
Conditions: INVREQ, IOERR, NOTAUTH
SET WEB
55─ ──SET WEB ──┬ ┬──────────────────────── ──┬ ┬──────────────────────── ─5%└ ┘──GARBAGEINT(data-value) └ ┘──TIMEOUTINT(data-value)
Conditions: INVREQ, IOERR, NOTAUTH
166 CICS User’s Handbook
CST syntax
Chapter 3. CICS-Supplied Transaction
Some CICS-supplied transactions are menu driven, while others can beentered on the command line. Menus are provided wherever the transactionname appears on its own in the syntax descriptions on the pages that follow.
CEBT INQUIRE AUXTRACE
55─ ──CEBT Inquire Auxtrace ─5%
CEBT INQUIRE DUMP
55─ ──CEBT Inquire Dump ─5%
CEBT INQUIRE INTTRACE
55─ ──CEBT Inquire Inttrace ─5%
CEBT INQUIRE GTFTRACE
55─ ──CEBT Inquire Gtftrace ─5%
CEBT INQUIRE SURVEILLANCE
55─ ──CEBT Inquire Surveillance ─5%
CEBT PERFORM SHUTDOWN
55─ ──CEBT Perform SHutdown ──Dump ──Immediate ─5%
CEBT PERFORM SNAP
55─ ──CEBT Perform SNap ─5%
CEBT PERFORM TAKEOVER
55─ ──CEBT Perform Takeover ──Dump ─5%
CEBT SET AUXTRACE
55─ ──CEBT Set Auxtrace ──┬ ┬─────── ──┬ ┬────────── ──SWitch ─5% ├ ┤─STArt─ ├ ┤─NOswitch─ ├ ┤─Pause─ ├ ┤─NExt───── └ ┘─STOp── └ ┘─All──────
Copyright IBM Corp. 1989, 1999 167
CST syntax
CEBT SET DUMP
55─ ──CEBT Set Dump ──┬ ┬──────── ──┬ ┬────────────── ─5% ├ ┤─Open─── ├ ┤─Autoswitch─── ├ ┤─CLosed─ └ ┘─Noautoswitch─ └ ┘─Switch─
CEBT SET GTFTRACE
55─ ──CEBT Set Gtftrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──
CEBT SET INTTRACE
55─ ──CEbt Set Inttrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──
CEBT SET SURVEILLANCE
55─ ──CEBT Set Surveillance ──┬ ┬───── ─5% ├ ┤─OFf─ └ ┘─ON──
CEBT SET TAKEOVER
55─ ──CEBT Set Takeover ──┬ ┬─────────── ─5% ├ ┤─Automatic─ ├ ┤─Command─── └ ┘─Manual────
168 CICS User’s Handbook
CST syntax
55─ ──CEDA ──┬ ┬─ADD──GROUP──LIST─ ──┬ ┬──────── ───────────────────────────────────────── ───5% │ │├ ┤─AFTER── │ │└ ┘─BEFORE─ ├ ┤─ALTER──┤ Resource type ├────────────────────────────────────────────── ├ ┤─APPEND──LIST──TO────────────────────────────────────────────────────── ├ ┤ ─CHECK─ ──┬ ┬─GROUP─ ──┬ ┬────────────── ─────────────────────────────────── │ │└ ┘─LIST── └ ┘─REMOTESYSTEM─ │ │┌ ┐─ALL─────────────── ├ ┤ ─COPY─ ──┼ ┼─────────────────── ─GROUP─ ──┬ ┬─AS─── ──┬ ┬───────── ────────────
│ │└ ┘─┤ Resource type ├─ ├ ┤─TO─── ├ ┤─REPLACE─│ │└ ┘──ASTO └ ┘─MERGE───
├ ┤─DEFINE──┤ Resource type ├──GROUP──┤ attribute list ├────(1) ────────────── ├ ┤ ─DELETE─ ──┬ ┬─ALL─────────────── ──┬ ┬─GROUP─ ──┬ ┬──────── ─────────────────
│ │└ ┘─┤ Resource type ├─ └ ┘─LIST── └ ┘─REMOVE─ ├ ┤ ─DISPLAY─ ──┬ ┬─LIST─ ──┬ ┬─────── ───────────────────────── ──────────────── │ ││ │└ ┘──GROUP │ │└ ┘ ─GROUP─ ──┬ ┬─────────────────── ──┬ ┬──────── │ │├ ┤─ALL─────────────── └ ┘─RENAME─
│ │└ ┘─┤ Resource type ├─ ├ ┤ ─EXPAND─ ──┬ ┬─LIST─ ──┬ ┬─────── ───────────────────────── ───────────────── │ ││ │└ ┘──GROUP │ │└ ┘ ─GROUP─ ──┬ ┬─────────────────── ──┬ ┬──────── │ │├ ┤─ALL─────────────── └ ┘─RENAME─
│ │└ ┘─┤ Resource type ├─ ├ ┤ ─INSTALL─ ──┬ ┬─────────────────── ──┬ ┬─GROUP─ ──────────────────────────── │ │├ ┤─ALL─────────────── └ ┘─LIST──
│ │└ ┘─┤ Resource type ├─ ├ ┤ ─LOCK─ ──┬ ┬─GROUP─ ────────────────────────────────────────────────────── │ │└ ┘─LIST── │ │┌ ┐─ALL─────────────── ├ ┤ ─MOVE─ ──┼ ┼─────────────────── ─GROUP─ ──┬ ┬─AS─── ──┬ ┬───────── ──┬ ┬────────
│ │└ ┘─┤ Resource type ├─ ├ ┤─TO─── ├ ┤─REPLACE─ └ ┘─REMOVE─│ │└ ┘──ASTO └ ┘─MERGE───
├ ┤─REMOVE──GROUP──LIST─────────────────────────────────────────────────── ├ ┤ ─RENAME─ ──┬ ┬─────────────────── ──┬ ┬─────── ──┬ ┬──── ──┬ ┬──── ──┬ ┬──────── ─ │ │├ ┤─ALL─────────────── └ ┘─GROUP─ └ ┘─AS─ └ ┘─TO─ └ ┘─REMOVE─
│ │└ ┘─┤ Resource type ├─ ├ ┤ ─UNLOCK─ ──┬ ┬─GROUP─ ──────────────────────────────────────────────────── │ │└ ┘─LIST── ├ ┤─USERDEFINE──┤ Resource type ├──GROUP──┤ attribute list ├────(1) ────────── └ ┘ ─VIEW──GROUP─ ──┬ ┬─────────────────── ─────────────────────────────────── ├ ┤─ALL───────────────
└ ┘─┤ Resource type ├─
Note:1 Consult the CICS Resource Definition Guide. for information about the
attributes applicable to each resource type.
Chapter 3. CICS-Supplied Transaction 169
CST syntax
Resource type:├─ ──┬ ┬─CONNECTION───── ──────────────────────────────────────────────────────────────────┤ ├ ┤─DB2CONN──────── ├ ┤─DB2ENTRY─────── ├ ┤─DB2TRAN────────
| ├ ┤─DOCTEMPLATE──── ├ ┤── ──┬ ┬──────────
| │ │└ ┘─ENQMODEL─ ├ ┤─FILE─────────── ├ ┤─JOURNALMODEL─── ├ ┤─LSRPOOL──────── ├ ┤─MAPSET───────── ├ ┤─PARTITIONSET─── ├ ┤─PARTNER────────
| ├ ┤─PROCESSTYPE──── ├ ┤─PROFILE──────── ├ ┤─PROGRAM────────
| ├ ┤─REQUESTMODEL─── ├ ┤─SESSIONS───────
| ├ ┤─TCPIPSERVICE─── ├ ┤─TDQUEUE──────── ├ ┤─TERMINAL─────── ├ ┤─TRANCLASS────── ├ ┤─TRANSACTION────
| ├ ┤─TSMODEL──────── └ ┘─TYPETERM───────
CEDF
┌ ┐─,ON──55─ ──CEDF ──┬ ┬─────────── ──┼ ┼────── ─5% ├ ┤─termid──── └ ┘─,OFF─ ├ ┤─sysid───── └ ┘─sessionid─
CEDX
┌ ┐─,ON──55─ ──CEDX ──tranid ──┼ ┼────── ─5% └ ┘─,OFF─
170 CICS User’s Handbook
CST syntax
CEMT DISCARD
┌ ┐─────────────────────────55─ ──CEMT Discard ───
6┴┬ ┬───────────────────── ─5%
├ ┤──Autinstmodel(value)├ ┤──Connection(value) ──
├ ┤──DB2Conn ────────────├ ┤──DB2Entry(value) ────├ ┤──DB2TRAN(value) ─────
| ├ ┤──Doctemplate(value) ─| ├ ┤──Enqmodel(value) ────
├ ┤──FENode(value) ──────├ ┤──FEPool(value) ──────├ ┤──FEPropset(value) ───├ ┤──FETarget(value) ────├ ┤──FIle(value) ────────├ ┤──JModel(value) ──────├ ┤──JOurnalname(value) ─├ ┤──PArtner(value) ─────
| ├ ┤──PROCesstype(value) ─├ ┤──PROFile(value) ─────├ ┤──PROGram(value) ─────
| ├ ┤──Requestmodel(value)├ ┤──TClass(value) ──────
| ├ ┤──TCPIPservice(value)├ ┤──TDqueue(value) ─────├ ┤──TErminal(value) ────├ ┤──TRansaction(value) ─
| └ ┘──TSmodel(name) ──────
CEMT INQUIRE AUTOINSMODEL
55─ ──CEMT Inquire AUTInstmodel ── ──┬ ┬───── ─5% └ ┘─All─
CEMT INQUIRE AUTOINSTALL
55─ ──CEMT Inquire AUTOinstall ─5%
CEMT INQUIRE AUXTRACE
55─ ──CEMT Inquire AUXtrace ─5%
Chapter 3. CICS-Supplied Transaction 171
CST syntax
CEMT INQUIRE CONNECTION
55─ ──CEMT Inquire Connection ──┬ ┬──(value) ──┬ ┬──────────────── ──┬ ┬──────────── ──5└ ┘─ALl───── └ ┘──NEtname(value) ├ ┤─NOTPending─
└ ┘─PEnding────
5─ ──┬ ┬──────────── ──┬ ┬─────────── ──┬ ┬────────────── ──┬ ┬───────────── ───────────5| ├ ┤─INService── ├ ┤─ACquired── ├ ┤─NOTSupported─ ├ ┤─Vtam────────| └ ┘─OUtservice─ ├ ┤─RELeased── ├ ┤─Unattempted── ├ ┤─IRc─────────| ├ ┤─OBtaining─ ├ ┤─COMPlete───── ├ ┤─XM──────────| ├ ┤─FReeing─── └ ┘─Failed─────── ├ ┤─INDirect────
└ ┘─AVailable─ ├ ┤─XCf───────── └ ┘─RConnection─
5─ ──┬ ┬────── ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬─────────────── ─────────────────5├ ┤─EXci─ ├ ┤─XOk────── ├ ┤─RECovdata─── └ ┘──Grname(value)
├ ┤─APpc─ └ ┘─XNotdone─ ├ ┤─NORecovdata─ └ ┘─Lu61─ └ ┘─NRs─────────
5─ ──┬ ┬─────────────────── ──┬ ┬───────────────────── ──┬ ┬────────────── ───────────5└ ┘──Membername(value) └ ┘──REMotesystem(value) └ ┘──RNAme(value)
5─ ──┬ ┬───────────────── ─5%└ ┘──RNEtname(value)
CEMT INQUIRE DB2CONN
55─ ──CEMT Inquire DB2Conn ─5%
172 CICS User’s Handbook
CST syntax
55─ ──CEMT Inquire DB2Entry(data-area) ──┬ ┬─────────────── ──┬ ┬─────── ──────────5└ ┘──AT(data-area) ├ ┤─START─
├ ┤─END─── └ ┘─NEXT──
5─ ──┬ ┬────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ──────────5├ ┤──ACCOUNTREC(cvda) └ ┘──AUTHID(data-area) ├ ┤──AUTHTYPE(cvda)
├ ┤─UOW────────────── ├ ┤─GROUP────────── ├ ┤─TASK───────────── ├ ┤─SIGN─────────── ├ ┤─TXID───────────── ├ ┤─TERM─────────── └ ┘─NONE───────────── ├ ┤─TX───────────── ├ ┤─OPID─────────── └ ┘─USERID─────────
5─ ──┬ ┬─────────────────── ──┬ ┬───────────────── ──┬ ┬──────────────────── ───────5├ ┤──DISABLEDACT(cvda) ├ ┤──DROLLBACK(cvda) ├ ┤──ENABLESTATUS(cvda)
├ ┤─ABEND───────────── ├ ┤─ROLLBACK──────── ├ ┤─ENABLED──────────── ├ ┤─SQLCODE─────────── └ ┘─NOROLLBACK────── ├ ┤─DISABLED─────────── └ ┘─POOL────────────── └ ┘─DISABLING──────────
5─ ──┬ ┬───────────────── ──┬ ┬───────────────────────── ──┬ ┬──────────────── ─────5└ ┘──PLAN(data-area) └ ┘──PLANEXITNAME(data-area) ├ ┤──PRIORITY(cvda)
├ ┤─HIGH─────────── ├ ┤─EQUAL────────── └ ┘─LOW────────────
5─ ──┬ ┬─────────────────────── ──┬ ┬───────────────────── ───────────────────────5└ ┘──PROTECTNUM(data-area) └ ┘──PTHREADS(data-area)
5─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ───────────────────────5└ ┘──THREADLIMIT(data-area) └ ┘──THREADS(data-area)
5─ ──┬ ┬────────────────── ────────────────────────────────────────────────────5%├ ┤──THREADWAIT(cvda)
├ ┤─TWAIT──────────── ├ ┤─NOTWAIT────────── └ ┘─TPOOL────────────
CEMT INQUIRE DB2TRAN
55──CEMT Inquire DB2Tran─ ──┬ ┬───────────── ──┬ ┬───────────────────── ────────────5└ ┘──(data-area) └ ┘──DB2Entry(data-area)
5─ ──┬ ┬──────────────────── ─5%└ ┘──Transid(data-area)
CEMT INQUIRE DELETSHIPPED
55─ ──CEMT Inquire DEletshipped ──┬ ┬───────────── ──┬ ┬───────────────── ─5%└ ┘──IDle(value) └ ┘──INterval(value)
Chapter 3. CICS-Supplied Transaction 173
CST syntax
CEMT INQUIRE DOCTEMPLATE
55─ ──CEMT Inquire DOctemplate ──┬ ┬───────── ──┬ ┬──────────── ──┬ ┬────────── ───────5├ ┤─TSq───── └ ┘──Name(name) ├ ┤─Append───
├ ┤─TDq───── └ ┘─Noappend─ ├ ┤─File──── ├ ┤─EXitpgm─ └ ┘─Member──
5─ ──┬ ┬──────── ──┬ ┬──────────────────── ──┬ ┬────────────────────────── ───────────5├ ┤─Ebcdic─ └ ┘──Templatename(name) └ ┘─Templatename──(──name──)─
└ ┘─Binary─
5─ ──┬ ┬──────── ─5% ├ ┤─DDname─ └ ┘─DSname─
CEMT INQUIRE DSAS
55─ ──CEMT Inquire DSAs ─5%
CEMT INQUIRE DSNAME
┌ ┐─ALl────────────────55─ ──CEMT Inquire DSName ──┼ ┼──────────────────── ─5%
├ ┤──(value) ─────────── ├ ┤──┬ ┬─VSam─ ────────── │ │└ ┘─BDam─
├ ┤──FIlecount(value) ── ├ ┤──┬ ┬─VAlid─── ─────── │ │└ ┘─INvalid─ ├ ┤──┬ ┬─Path─ ────────── │ │└ ┘─BASE─ ├ ┤──┬ ┬─FWDRECOVAble─ ── │ │├ ┤─NOTrecovable─ │ │├ ┤─RECOVERAble── │ │└ ┘─UNDetermined─ ├ ┤──┬ ┬─Static─────── ── │ │├ ┤─Dynamic────── │ │└ ┘─UNDetermined─
├ ┤──FRlog(value) ────── ├ ┤──┬ ┬─AVailable─── ─── │ │└ ┘─UNAvailable─ ├ ┤──┬ ┬─NOLostlocks── ── │ │├ ┤─REMLostlocks─ │ │└ ┘─RECOVERLocks─ ├ ┤──┬ ┬─RETAined─── ──── │ │└ ┘─NORetained─ ├ ┤──┬ ┬─Quiesced─── ──── │ │└ ┘─UNQuiesced─
├ ┤──BASEDsname(value) ─└ ┘──FWDRECOVLsn(value)
CEMT INQUIRE DUMPDS
55─ ──CEMT Inquire DUmpds ─5%
174 CICS User’s Handbook
CST syntax
| CEMT INQUIRE ENQ|
| 55─ ──CEMT Inquire Enq ──┬ ┬──────────── ──┬ ┬──────────────── ──┬ ┬─────────────── ───5| └ ┘──Uow(value) └ ┘──TRansid(value) └ ┘──TAskid(value)
| 5─ ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬──────── ──┬ ┬───────────────── ─────────────5| ├ ┤─ACtive─── ├ ┤─Dataset───── ├ ┤─Owner── └ ┘──Netuowid(value)| └ ┘─RETained─ ├ ┤─File──────── └ ┘─Waiter─| ├ ┤─EXecenq─────| ├ ┤─ADdrexecenq─| ├ ┤─TDq─────────| └ ┘─TSq─────────
| 5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┬ ┬───────────── ──────────────────5| └ ┘──ENqfails(value) └ ┘──RESource(value) └ ┘──RLen(value)
| 5─ ──┬ ┬────────────────── ──┬ ┬───────────── ─5%| └ ┘──QUalifier(value) └ ┘──QLen(value)
| CEMT INQUIRE ENQMODEL|
| 55─ ──CEMT Inquire ENQModel ──┬ ┬──(value) ──────── ──┬ ┬────────── ─5%| ├ ┤──ENQSCOPE(value) ├ ┤─DISABLED─| └ ┘──ENQNAME(value) ─ ├ ┤─ENABLED──| └ ┘─WAITING──
CEMT INQUIRE EXCI
55─ ──CEMT Inquire Exci ──┬ ┬────────────── ─5%├ ┤──Task(number)
| └ ┘──Urid(value) ─
CEMT INQUIRE FILE
┌ ┐─ALl─────55─ ──CEMT Inquire FIle ──┼ ┼───────── ──┬ ┬──────── ──┬ ┬──────── ──┬ ┬─────────── ─────5
└ ┘──(value) ├ ┤─Vsam─── ├ ┤─OPen─── ├ ┤─ENabled─── ├ ┤─BDam─── └ ┘─CLosed─ ├ ┤─UNenabled─ └ ┘─REMote─ └ ┘─DIsabled──
5─ ──┬ ┬──────── ──┬ ┬────────── ──┬ ┬─────────── ──┬ ┬────────── ──┬ ┬────────── ────────5 ├ ┤─REAd─── ├ ┤─UPdate─── ├ ┤─ADdable─── ├ ┤─BRowse─── ├ ┤─DElete─── └ ┘─NORead─ └ ┘─NOUpdate─ └ ┘─NOAddable─ └ ┘─NOBrowse─ └ ┘─NODelete─
5─ ──┬ ┬───────────── ──┬ ┬─────── ──┬ ┬──────── ──┬ ┬──────────── ─────────────────────5 ├ ┤─EXclusive─── ├ ┤─OLd─── ├ ┤─RLs──── ├ ┤─EMptyreq─── └ ┘─NOEXclusive─ └ ┘─Share─ └ ┘─NOTRls─ └ ┘─NOEMptyreq─
5─ ──┬ ┬─────────────── ──┬ ┬─────────── ──┬ ┬──────── ──┬ ┬───────────────── ──────────5| └ ┘──DSname(value) ├ ┤─NOTTable── ├ ┤─LOAd─── └ ┘──CFDtpool(value)| ├ ┤─CIcstable─ └ ┘─NOLoad─| ├ ┤─USertable─| └ ┘─CFTable───
5─ ──┬ ┬────────────────── ──┬ ┬──────────── ──┬ ┬─────────────────── ────────────────5| └ ┘──Tablename(value) ├ ┤─LOCKING──── └ ┘──Maxnumrecs(value)| └ ┘─COntention─
5─ ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5%| └ ┘──Keylength(value) └ ┘──RECordsize(value)
CEMT INQUIRE GTFTRACE
55─ ──CEMT Inquire Gtftrace ─5%
Chapter 3. CICS-Supplied Transaction 175
CST syntax
CEMT INQUIRE INTTRACE
55─ ──CEMT Inquire INttrace ─5%
CEMT INQUIRE IRC
55─ ──CEMT Inquire IRc ─5%
CEMT INQUIRE JMODEL
┌ ┐─All─────55─ ──CEMT Inquire JModel ──┼ ┼───────── ──┬ ┬──────────────────── ──┬ ┬─────── ───────5
└ ┘──(value) └ ┘──(Journalnamevalue) ├ ┤─Mvs─── ├ ┤─SMf─── └ ┘─Dummy─
5─ ──┬ ┬─────────────────── ─5%└ ┘──STreamname(value)
CEMT INQUIRE JOURNALNAME
┌ ┐─All─────55─ ──CEMT Inquire JOurnalname ──┴ ┴──(value) ──┬ ┬─────── ──┬ ┬────────── ────────────5 ├ ┤─Mvs─── ├ ┤─Enabled── ├ ┤─SMf─── ├ ┤─DIsabled─ └ ┘─DUmmy─ └ ┘─FAiled───
5─ ──┬ ┬─────────────────── ─5%└ ┘──STreamname(value)
CEMT INQUIRE LINE
55─ ──CEMT Inquire Line ──(value) ──┬ ┬─────────────── ──┬ ┬──────────────── ─────────5└ ┘──NUmber(value) └ ┘──NEgpoll(value)
5─ ──┬ ┬──────────── ─5% ├ ┤─Inservice── └ ┘─Outservice─
CEMT INQUIRE MODENAME
┌ ┐─ALl─55─ ──CEMT Inquire MODename ── ──┴ ┴───── ──┬ ┬───────── ──┬ ┬─────────────────── ──────5
└ ┘──(value) └ ┘──COnnection(value)
5─ ──┬ ┬──────────────── ──┬ ┬────────────────── ──┬ ┬─────────────── ─5%└ ┘──Maximum(value) └ ┘──AVailable(value) └ ┘──ACTive(value)
CEMT INQUIRE MONITOR
55─ ──CEMT Inquire MONitor ──┬ ┬─────── ──┬ ┬──────────────────── ─5%├ ┤─Gmt─── └ ┘──SUbsystemid(value)
└ ┘─Local─
176 CICS User’s Handbook
CST syntax
CEMT INQUIRE NETNAME
┌ ┐─ALl─────55─ ──CEMT Inquire Netname ──┼ ┼───────── ──┬ ┬──────────────────── ─────────────────5
└ ┘──(value) └ ┘──TRansaction(value)
5─ ──┬ ┬───────────────── ──┬ ┬────────────── ──┬ ┬──────────── ──┬ ┬─────── ───────────5└ ┘──PRiority(value) ├ ┤─PAgeable───── ├ ┤─Inservice── ├ ┤─ATi───
└ ┘─AUtopageable─ └ ┘─Outservice─ └ ┘─NOAti─
5─ ──┬ ┬─────── ──┬ ┬─────────── ──┬ ┬───────────────── ──┬ ┬────────── ────────────────5├ ┤─TTi─── ├ ┤─RTerminal─ └ ┘──TErminal(value) ├ ┤─ACquired─
└ ┘─NOTti─ ├ ┤─RSession── ├ ┤─COldacq── ├ ┤─Session─── └ ┘─RELeased─ └ ┘─Local─────
5─ ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬───────────────────── ──┬ ┬────────────── ───5├ ┤─CReate─── └ ┘──TAsk(value) └ ┘──REMotesystem(value) └ ┘──RNAme(value)
└ ┘─NOCreate─
5─ ──┬ ┬───────────────── ──┬ ┬──────────── ── ──┬ ┬──────── ─5%└ ┘──RNEtname(value) └ ┘──CId(value) └ ┘─Userid─
CEMT INQUIRE PARTNER
┌ ┐─All─────55─ ──CEMT Inquire PArtner ──┼ ┼───────── ──┬ ┬──────────────── ─────────────────────5
└ ┘──(value) └ ┘──NETWork(value)
5─ ──┬ ┬──────────────── ──┬ ┬──────────────── ──┬ ┬──────────────── ─────────────────5└ ┘──NETName(value) └ ┘──Profile(value) └ ┘──Ltpname(value)
5─ ──┬ ┬─────────────── ─5%└ ┘──Tpname(value)
CEMT INQUIRE PROCESSTYPE
┌ ┐─ALl─────55─ ──CEMT Inquire PROCesstype ──┼ ┼───────── ──┬ ┬───────────── ────────────────────5
└ ┘──(value) └ ┘──FIle(value)
5─ ──┬ ┬───────────────── ──┬ ┬────────── ──┬ ┬────────── ─5% └ ┘──AUditlog(value) ├ ┤─ACtivity─ ├ ┤─Enabled── ├ ┤─FUll───── └ ┘─Disabled─ ├ ┤─Off────── └ ┘─Process──
CEMT INQUIRE PROFILE
┌ ┐─All─────55─ ──CEMT Inquire PROFile ──┼ ┼───────── ─5%
└ ┘──(value)
Chapter 3. CICS-Supplied Transaction 177
CST syntax
CEMT INQUIRE PROGRAM
┌ ┐─ALl──────────55─ ──CEMT Inquire PROGram ──┼ ┼────────────── ──┬ ┬─────────────── ─────────────────5
├ ┤──(value) ───── └ ┘──LENgth(value)└ ┘──CLass(value)
┌ ┐─PRIvate─5─ ──┬ ┬──────────── ──┬ ┬────────────── ──┬ ┬────────── ──┼ ┼───────── ────────────────5 ├ ┤─PLi──────── ├ ┤─PROgram────── ├ ┤─Enabled── └ ┘─Shared── ├ ┤─CObol────── ├ ┤─Mapset─────── └ ┘─DIsabled─ ├ ┤─C────────── └ ┘─PArtitionset─ ├ ┤─LE37ð────── ├ ┤─ASsembler── ├ ┤─NOTDEfined─
| └ ┘─JAVA───────
5─ ──┬ ┬───────────── ──┬ ┬──────── ──┬ ┬──────────── ──┬ ┬───────────────── ───────────5| ├ ┤─REQuired──── ├ ┤─CEDf─── ├ ┤─DYnamic──── └ ┘──REScount(value)| └ ┘─NOTRequired─ └ ┘─NOCedf─ └ ┘─NOTDYnamic─
5─ ──┬ ┬───────────────── ──┬ ┬─────── ──┬ ┬────────── ──┬ ┬─────────── ────────────────5└ ┘──USecount(value) ├ ┤─ANy─── ├ ┤─CEXeckey─ ├ ┤─DPlsubset─
└ ┘─Below─ └ ┘─UExeckey─ └ ┘─Fullapi───
5─ ──┬ ┬──────────── ──┬ ┬───────────────────── ──┬ ┬────────── ──┬ ┬───────── ─────────5| ├ ┤─Quasirent── └ ┘──REMotesystem(value) ├ ┤─JVM────── ├ ┤─DEBug───| └ ┘─Threadsafe─ ├ ┤─LE37ð──── └ ┘─NODebug─| ├ ┤─NONLE37ð─| └ ┘─UNKNOWN──
5─ ──┬ ┬───────────────── ─5%| └ ┘──JVMClass(value)
CEMT INQUIRE STATISTICS
55─ ──CEMT Inquire STAtistics ─5%
CEMT INQUIRE STREAMNAME
┌ ┐─ALl─55─ ──CEMT Inquire STReamname ── ──┴ ┴───── ─── ───(value) ──┬ ┬───────────────── ──────5
└ ┘──Usecount(value)
5─ ──┬ ┬──────── ──┬ ┬────────── ─5% ├ ┤─Failed─ ├ ┤─Syslog─── └ ┘─Ok───── └ ┘─Nosyslog─
CEMT INQUIRE SYDUMPCODE
┌ ┐─ALl─────55─ ──CEMT Inquire SYDumpcode ──┼ ┼───────── ──┬ ┬─────────── ──┬ ┬───────── ──────────5
└ ┘──(value) ├ ┤─SYsdump─── ├ ┤─RELated─ └ ┘─NOSYsdump─ └ ┘─Local───
5─ ──┬ ┬──────────── ──┬ ┬──────────────── ──┬ ┬──────────────── ──┬ ┬─────── ─5%├ ┤─SHutdown─── └ ┘──Maximum(value) └ ┘──Current(value) ├ ┤─Dae───
└ ┘─NOSHutdown─ └ ┘─NODae─
CEMT INQUIRE SYSTEM
55─ ──CEMT Inquire SYStem ─5%
178 CICS User’s Handbook
CST syntax
CEMT INQUIRE TASK
┌ ┐─ALl───────────55─ ──CEMT Inquire TAsk ──┼ ┼─────────────── ──┬ ┬─────────────── ───────────────────5
├ ┤──(value) ────── └ ┘──TRanid(value)└ ┘──TClass(value)
5─ ──┬ ┬───────────────── ──┬ ┬────────────── ──┬ ┬────── ──┬ ┬───────────────── ───────5└ ┘──FAcility(value) ├ ┤─Running────── ├ ┤─TAsk─ └ ┘──PRiority(value)
├ ┤─DIspatchable─ ├ ┤─TErm─ └ ┘─SUspended──── └ ┘─DEst─
5─ ──┬ ┬────────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ────────────────────5└ ┘──STartcode(value) └ ┘──USerid(value) └ ┘──UOw(value)
5─ ──┬ ┬────────────── ──┬ ┬─────────────── ──┬ ┬────────────── ──┬ ┬───────── ─────────5└ ┘──HTYpe(value) └ ┘──HValue(value) └ ┘──HTIme(value) ├ ┤─Backout─
└ ┘─Commit──
5─ ──┬ ┬─────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────────── ───────────5└ ┘──BRidge(value) └ ┘──IDentifier(value) └ ┘──Indoubtmins(value)
5─ ──┬ ┬──────── ──┬ ┬──────────────── ──┬ ┬─────────────────── ──────────────────────5| ├ ┤─Nowait─ └ ┘──DB2plan(value) └ ┘──ACTIVITYId(value)
└ ┘─Wait───
5─ ──┬ ┬───────────────── ──┬ ┬──────────────── ──┬ ┬──────────────────── ─5%| └ ┘──ACTIVITY(value) └ ┘──PROCESS(value) └ ┘──PROCESSType(value)
CEMT INQUIRE TCLASS
┌ ┐─ALl─────55─ ──CEMT Inquire TClass ──┼ ┼───────── ──┬ ┬────────────────── ────────────────────5
└ ┘──(value) └ ┘──Maxactive(value)
5─ ──┬ ┬─────────────── ──┬ ┬──────────────────── ──┬ ┬─────────────── ─5%└ ┘──ACtive(value) └ ┘──Purgethresh(value) └ ┘──Queued(value)
CEMT INQUIRE TCPIPSERVICE
55─ ──INQUIRE TCPIPSERVICE(value) ──┬ ┬──────────────── ──┬ ┬───────────────────── ──5└ ┘──Backlog(value) └ ┘──CLOsetimeout(value)
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ─────────5└ ┘──Connection(value) └ ┘──IPaddress(value) ├ ┤──OPENSTATUS(value)
├ ┤─OPEN────────────── ├ ┤─CLOSING─────────── ├ ┤─CLOSED──────────── └ ┘─IMMCLOSING────────
5─ ──┬ ┬───────────── ──┬ ┬──────────────── ──┬ ┬──────────────────── ────────────────5└ ┘──Port(value) ├ ┤──SSLTYPE(value) ├ ┤──SOcketclose(value)
├ ┤─NO───────────── ├ ┤─Wait─────────────── ├ ┤─YES──────────── └ ┘─TImeout──────────── └ ┘─CLIENTAUTH─────
5─ ──┬ ┬───────────────────── ──┬ ┬──────────────── ──┬ ┬────────────────── ──────────5└ ┘──TCPIPService(value) └ ┘──TRansid(value) └ ┘──TSqprefix(value)
5─ ──┬ ┬──────────── ─5%└ ┘──URM(value)
Chapter 3. CICS-Supplied Transaction 179
CST syntax
CEMT INQUIRE TDQUEUE
┌ ┐─All─────55─ ──CEMT Inquire TDqueue ──┼ ┼───────── ──┬ ┬───────────────────── ──┬ ┬────────── ──5
└ ┘──(value) └ ┘──TRIggerlevel(value) ├ ┤─INDirect─ ├ ┤─EXtra──── ├ ┤─INTra──── └ ┘─REMote───
5─ ──┬ ┬──────────────── ──┬ ┬────────── ──┬ ┬──────── ──┬ ┬─────────────── ────────────5└ ┘──NAmeind(value) ├ ┤─ENabled── ├ ┤─OPen─── └ ┘──TErmid(value)
└ ┘─DIsabled─ └ ┘─Closed─
5─ ──┬ ┬─────────────── ──┬ ┬─────────────── ──┬ ┬───── ──┬ ┬──────── ──┬ ┬──────── ──────5└ ┘──TRAnid(value) └ ┘──Userid(value) ├ ┤─Shr─ ├ ┤─INPut── ├ ┤─Queue──
├ ┤─OLd─ ├ ┤─OUtput─ └ ┘─REJect─ └ ┘─Mod─ └ ┘─RDback─
5─ ──┬ ┬──────── ──┬ ┬──────────────────── ──┬ ┬─────────────── ──┬ ┬─────────────── ─5%├ ┤─Wait─── └ ┘──DAtabuffers(value) └ ┘──DDname(value) └ ┘──DSname(value)
└ ┘─NOwait─
CEMT INQUIRE TERMINAL
┌ ┐─ALl──────────55─ ──CEMT Inquire TErminal ──┼ ┼────────────── ──┬ ┬──────────────────── ───────────5
├ ┤──(value) ───── └ ┘──TRansaction(value)└ ┘──CLass(value)
5─ ──┬ ┬──────────────── ──┬ ┬───────────────── ──┬ ┬────────────── ──────────────────5| └ ┘──COnsole(value) └ ┘──PRiority(value) ├ ┤─PAgeable─────
└ ┘─AUtopageable─
5─ ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬─────── ──┬ ┬─────────── ──┬ ┬──────────────── ────5├ ┤─Inservice── ├ ┤─ATi─── ├ ┤─TTi─── ├ ┤─RTerminal─ └ ┘──NEtname(value)
└ ┘─Outservice─ └ ┘─NOAti─ └ ┘─NOTti─ ├ ┤─RSession── ├ ┤─Session─── └ ┘─Local─────
5─ ──┬ ┬────────── ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬───────────────────── ───────5├ ┤─ACquired─ ├ ┤─CReate─── └ ┘──TAsk(value) └ ┘──REMotesystem(value)
└ ┘─RELeased─ └ ┘─NOCreate─
5─ ──┬ ┬────────────── ──┬ ┬───────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ─5%└ ┘──RNAme(value) └ ┘──RNEtname(value) └ ┘──Userid(value) └ ┘──CId(value)
180 CICS User’s Handbook
CST syntax
CEMT INQUIRE TRANSACTION
┌ ┐─ALl──────────55─ ──CEMT Inquire TRAnsaction ──┼ ┼────────────── ──┬ ┬───────────────── ───────────5
├ ┤──(value) ───── └ ┘──PRIority(value)└ ┘──CLass(value)
5─ ──┬ ┬──────────────── ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬────────────── ──────5└ ┘──PROgram(value) └ ┘──TClass(value) ├ ┤─Enabled── ├ ┤─PUrgeable────
└ ┘─Disabled─ └ ┘─NOTPurgeable─
5─ ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬─────── ──┬ ┬─────────── ──────────────────5└ ┘──PRFile(value) ├ ┤─CDatakey─ ├ ┤─ANy─── ├ ┤─ISolate───
└ ┘─Udatakey─ └ ┘─BElow─ └ ┘─NOIsolate─
5─ ──┬ ┬─────────────── ──┬ ┬───────── ──┬ ┬─────────────── ──────────────────────────5└ ┘──TRprof(value) ├ ┤─BAckout─ └ ┘──BRexit(value)
└ ┘─COmmit──
5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────── ──┬ ┬──────── ────────────────5└ ┘──FAcilitylike(value) └ ┘──INdoubtmins(value) ├ ┤─NOWait─
└ ┘─Wait───
5─ ──┬ ┬───────────── ─5%| ├ ┤─Routable────| └ ┘─NOTRoutable─
CEMT INQUIRE TRDUMPCODE
┌ ┐─ALl─────55─ ──CEMT Inquire TRDumpcode ──┼ ┼───────── ──┬ ┬──────────── ──┬ ┬─────────── ───────5
└ ┘──(value) ├ ┤─Trandump─── ├ ┤─SYsdump─── └ ┘─NOTrandump─ └ ┘─NOSYsdump─
5─ ──┬ ┬──────────── ──┬ ┬───────── ──┬ ┬──────────────── ──┬ ┬──────────────── ─5%├ ┤─SHutdown─── ├ ┤─RELated─ └ ┘──Maximum(value) └ ┘──Current(value)
└ ┘─NOSHutdown─ └ ┘─Local───
| CEMT INQUIRE TSMODEL|
| ┌ ┐─ALl───── ┌ ┐─────────────────────────────| 55─ ──CEMT Inquire TSModel ──┼ ┼───────── ───
6┴┬ ┬───────────────────────── ─5%
| └ ┘──(value) ├ ┤──LOCATION(value) ────────| ├ ┤──POOLNAME(data-area) ────| ├ ┤──PREFIX(data-area) ──────| ├ ┤──RECOVSTATUS(value) ─────| ├ ┤──REMOTEPREFIX(data-area)| ├ ┤──REMOTESYSTEM(data-area)| └ ┘──SECURITYST(value) ──────
| CEMT INQUIRE TSPOOL|
| ┌ ┐─ALl─────| 55─ ──CEMT Inquire TSPool ──┼ ┼───────── ──┬ ┬────────────────── ─5%| └ ┘──(value) └ ┘──CONNSTATUS(cvda)
Chapter 3. CICS-Supplied Transaction 181
CST syntax
CEMT INQUIRE TSQNAME
┌ ┐─ALl─────55─ ──CEMT Inquire TSqname ──┼ ┼───────── ──┬ ┬────────────── ──┬ ┬───────────────── ──5
└ ┘──(value) └ ┘──Sysid(value) └ ┘──Numitems(value)
5─ ──┬ ┬──────────────────── ──┬ ┬─────────────── ──┬ ┬─────────── ───────────────────5└ ┘──LAstusedint(value) └ ┘──LEngth(value) ├ ┤─MAIn──────
└ ┘─AUxiliary─
5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────── ─5%└ ┘──MAXitemlen(value) └ ┘──MInitemlen(value) └ ┘──Transid(value)
CEMT INQUIRE TSQUEUE
┌ ┐─ALl─────| 55─ ──CEMT Inquire TSQueue ──┼ ┼───────── ──┬ ┬───────────────── ────────────────────5| └ ┘──(value) ├ ┤──SYSID(value) ───| └ ┘──POOLNAME(value)
5─ ──┬ ┬───────────────── ──┬ ┬──────────────────── ──┬ ┬─────────────── ─────────────5└ ┘──Numitems(value) └ ┘──LAstusedint(value) └ ┘──LEngth(value)
5─ ──┬ ┬─────────── ──┬ ┬─────────────────── ──┬ ┬─────────────────── ────────────────5├ ┤─MAIn────── └ ┘──MAXitemlen(value) └ ┘──MInitemlen(value)
└ ┘─AUxiliary─
| 5─ ──RECOVSTATUS(value) ──┬ ┬──────────────── ─5%└ ┘──Transid(value)
CEMT INQUIRE UOW
┌ ┐─ALl─────55─ ──CEMT Inquire UOW ──┼ ┼───────── ──┬ ┬────────── ──┬ ┬───────── ──────────────────5
└ ┘──(value) ├ ┤─Backout── ├ ┤─ACtive── ├ ┤─COMmit─── ├ ┤─WAITIng─ ├ ┤─INDoubt── └ ┘─SHunted─ ├ ┤─INFlight─ ├ ┤─HBackout─ └ ┘─HCommit──
5─ ──┬ ┬──────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ──┬ ┬─────────────── ───5└ ┘──TRansid(value) └ ┘──TAskid(value) └ ┘──AGe(value) └ ┘──TErmid(value)
5─ ──┬ ┬──────────────── ──┬ ┬─────────────── ──┬ ┬──────────── ──┬ ┬───────────── ─────5└ ┘──NETName(value) └ ┘──Userid(value) ├ ┤─CONnection─ └ ┘──Link(value)
├ ┤─Dataset──── ├ ┤─Rlsserver── ├ ┤─WAITCommit─ ├ ┤─WAITForget─ └ ┘─WAITRmi────
5─ ──┬ ┬────────────── ──┬ ┬───────────────── ─5%└ ┘──SYsid(value) └ ┘──NETUowid(value)
182 CICS User’s Handbook
CST syntax
CEMT INQUIRE UOWDSNFAIL
55─ ──CEMT Inquire UOWDsnfail ──UOw(value) ──DSname(value) ──┬ ┬──────── ────────────5 ├ ┤─NOtrls─ └ ┘─RLS────
5─ ──┬ ┬──────────── ──┬ ┬────────────── ──┬ ┬────────────── ──┬ ┬──────────────── ─5%├ ┤─CAche────── ├ ┤─Backupnonbwo─ └ ┘──Sysid(value) └ ┘──NEtname(value)
├ ┤─CONnection─ ├ ┤─COMmitfail─── ├ ┤─DATASET──── ├ ┤─DATASETFull── ├ ┤─RLSServer── ├ ┤─DEAdlock───── └ ┘─UNdefined── ├ ┤─DELexiterror─ ├ ┤─Failedbkout── ├ ┤─INDExrecfull─ ├ ┤─IOerror────── ├ ┤─Openerror──── ├ ┤─RLSGone────── ├ ┤─INDOubt────── ├ ┤─RRCommitfail─ ├ ┤─RRIndoubt──── └ ┘─Lckstrucfull─
CEMT INQUIRE UOWENQ
55─ ──CEMT Inquire UOWEnq ──┬ ┬──────────── ──┬ ┬──────────────── ───────────────────5└ ┘──Uow(value) └ ┘──TRansid(value)
5─ ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬───────────── ──┬ ┬──────── ───────────────5└ ┘──TAskid(value) ├ ┤─ACtive─── ├ ┤─Dataset───── ├ ┤─Owner──
└ ┘─RETained─ ├ ┤─File──────── └ ┘─Waiter─ ├ ┤─EXecenq───── ├ ┤─ADdrexecenq─ ├ ┤─TDq───────── └ ┘─TSq─────────
5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ──┬ ┬───────────────── ──────────────5└ ┘──Netuowid(value) └ ┘──ENqfails(value) └ ┘──RESource(value)
5─ ──┬ ┬───────────── ──┬ ┬────────────────── ──┬ ┬───────────── ─5%└ ┘──RLen(value) └ ┘──QUalifier(value) └ ┘──QLen(value)
CEMT INQUIRE UOWLINK
┌ ┐─ALl─────55─ ──CEMT Inquire UOWLink ──┼ ┼───────── ──┬ ┬──────────── ──┬ ┬──────────── ─────────5
└ ┘──(value) └ ┘──UOw(value) ├ ┤─CONnection─ └ ┘─RMI────────
5─ ──┬ ┬───────────── ──┬ ┬───────────── ──┬ ┬─────────── ──┬ ┬───────────── ───────────5└ ┘──LInk(value) ├ ┤─COOrdinator─ ├ ┤─Irc─────── ├ ┤─COLdstart───
├ ┤─SUbordinate─ ├ ┤─APpc────── ├ ┤─STarting──── └ ┘─UNKnown───── ├ ┤─LU61────── ├ ┤─Warmstart─── ├ ┤─NOtapplic─ ├ ┤─UNAvailable─
| └ ┘─Rrms────── ├ ┤─UNConnected─ └ ┘─NOtapplic───
5─ ──┬ ┬────────────── ──┬ ┬─────────────── ──┬ ┬───────────────── ─5%└ ┘──SYsid(value) └ ┘──RMIQfy(value) └ ┘──NEtuowid(value)
CEMT INQUIRE VTAM
55─ ──CEMT Inquire Vtam ─5%
Chapter 3. CICS-Supplied Transaction 183
CST syntax
CEMT PERFORM DELETSHIPPED
55─ ──CEMT Perform DEletshipped ─5%
CEMT PERFORM ENDAFFINITY
55─ ──CEMT Perform Endaffinity ──NETName(value) ──┬ ┬────────────── ─5%└ ┘──NETId(value)
CEMT PERFORM RESET
55─ ──CEMT Perform Reset ─5%
CEMT PERFORM SECURITY REBUILD
55─ ──CEMT Perform SEcurity ── ──┬ ┬───────── ─5% └ ┘─Rebuild─
CEMT PERFORM SHUTDOWN
55─ ──CEMT Perform SHUTdown ──┬ ┬──────────── ──┬ ┬──────────── ──┬ ┬─────────────── ──5└ ┘──Xlt(value) └ ┘──Plt(value) ├ ┤──Sdtran(value)
└ ┘─NOSdtran──────
5─ ──┬ ┬────────────────────────── ── ──┬ ┬────────── ── ──┬ ┬────── ─5% └ ┘ ─Immediate─ ──┬ ┬─────────── └ ┘─Takeover─ └ ┘─Dump─ └ ┘─NORestart─
CEMT PERFORM DUMP
55─ ──CEMT Perform ──┬ ┬─DUmp─ ──┬ ┬────────────── ─5%└ ┘─SNap─ └ ┘──Title(value)
184 CICS User’s Handbook
CST syntax
CEMT PERFORM STATISTICS
┌ ┐───────────────────────55─ ──CEMT Perform STatistics ── ──┬ ┬──────── ───
6┴┬ ┬ ─ALl─ ──┬ ┬────────── ─5%
└ ┘─RECORd─ │ │└ ┘─RESetnow─ ├ ┤─AUtoinstall─────── ├ ┤─Connection──────── ├ ┤─DB2─────────────── ├ ┤─DIspatcher──────── ├ ┤─Enqueue─────────── ├ ┤─FEpi────────────── ├ ┤─FIle────────────── ├ ┤─Journalname─────── ├ ┤─Lsrpool─────────── ├ ┤─Monitor─────────── ├ ┤─PROGAuto────────── ├ ┤─PROGRam─────────── ├ ┤─RECOVery────────── ├ ┤─STAts───────────── ├ ┤─STOrage─────────── ├ ┤─STReamname──────── ├ ┤─SYsdump─────────── ├ ┤─TAblemgr────────── ├ ┤─TCLass────────────
| ├ ┤─TCPipservice────── ├ ┤─TDqueue─────────── ├ ┤─TErminal────────── ├ ┤─TRAnsaction─────── ├ ┤─TRDump──────────── ├ ┤─TSqueue─────────── └ ┘─Vtam──────────────
CEMT SET AUTOINSTALL
55─ ──CEMT Set AUToinstall ──┬ ┬───────────────── ──┬ ┬──────────────── ─────────────5| └ ┘──Consoles(value) └ ┘──Maxreqs(value)
5─ ──┬ ┬──────────────── ─5%└ ┘──Program(value)
CEMT SET AUXTRACE
55─ ──CEMT Set AUXtrace ──┬ ┬─────── ──┬ ┬────────── ── ──┬ ┬──────── ─5% ├ ┤─STArt─ ├ ┤─NOswitch─ └ ┘─SWitch─ ├ ┤─Pause─ ├ ┤─NExt───── └ ┘─STOp── └ ┘─All──────
CEMT SET CONNECTION
55─ ──CEMT Set Connection ──┬ ┬──(value) ── ──┬ ┬──────────── ──┬ ┬──────────── ────────5 └ ┘─ALl───── └ ┘─NOTpending─ ├ ┤─INService── └ ┘─OUtservice─
5─ ──┬ ┬────────── ──┬ ┬──────────── ──┬ ┬────────── ──┬ ┬───────────── ────────────────5 ├ ┤─ACquired─ ├ ┤─PUrge────── ├ ┤─COmmit─── └ ┘──ENdaffinity └ ┘─RELeased─ ├ ┤─FORCEPurge─ ├ ┤─Backout── ├ ┤─CAncel───── ├ ┤─FORCEUow─ └ ┘─FCancel──── └ ┘─RESync───
5─ ──┬ ┬───────────── ─5% └ ┘──NORecovdata
Chapter 3. CICS-Supplied Transaction 185
CST syntax
CEMT SET DB2CONN
55─ ──CEMT Set DB2Conn ──────────────────────────────────────────────────────────5
┌ ┐───────────────────────────── ┌ ┐─────────────────────────────5─ ───
6┴┬ ┬───────────────────────── ───
6┴┬ ┬───────────────────────── ─5%
├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── ├ ┤──DB2ID(data-area) ───────│ │├ ┤─UOW────────────── ├ ┤──MSGQUEUE1(data-area) ───│ │├ ┤─TASK───────────── ├ ┤──MSGQUEUE2(data-area) ───│ │├ ┤─TXID───────────── ├ ┤──MSGQUEUE3(data-area) ───│ │└ ┘─NONE───────────── ├ ┤──┬ ┬──NONTERMREL(cvda) ───├ ┤──AUTHID(data-area) ────── │ │├ ┤─RELEASE──────────├ ┤──┬ ┬──AUTHTYPE(cvda) ───── │ │└ ┘─NORELEASE────────│ │├ ┤─GROUP────────── ├ ┤──PLAN(data-area) ────────│ │├ ┤─SIGN─────────── ├ ┤──PLANEXITNAME(data-area)│ │├ ┤─TERM─────────── ├ ┤──┬ ┬──PRIORITY(cvda) ─────
│ │├ ┤─TX───────────── │ │├ ┤─HIGH─────────── │ │├ ┤─OPID─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─USERID───────── │ │└ ┘─LOW────────────
├ ┤──COMAUTHID(data-area) ─── ├ ┤──PURGECYCLEM(data-area) ─├ ┤──┬ ┬──COMAUTHTYPE(cvda) ── ├ ┤──PURGECYCLES(data-area) ─│ │├ ┤─CGROUP──────────── ├ ┤──SECURITY(REBUILD) ──────│ │├ ┤─CSIGN───────────── ├ ┤──SIGNID(data-area) ──────│ │├ ┤─CTERM───────────── ├ ┤──┬ ┬──STANDBYMODE(cvda) ──
│ │├ ┤─CTX─────────────── │ │├ ┤─NOCONNECT───────── │ │├ ┤─COPID───────────── │ │├ ┤─CONNECT─────────── │ │└ ┘─CUSERID─────────── │ │└ ┘─RECONNECT─────────
├ ┤──COMTHREADLIM(data-area) ├ ┤──STATSQUEUE(data-area) ──├ ┤──┬ ┬──CONNECTERROR(cvda) ─ ├ ┤──TCBLIMIT(data-area) ────│ │├ ┤─ABEND────────────── ├ ┤──THREADLIMIT(data-area) ─│ │└ ┘─SQLCODE──────────── └ ┘──┬ ┬──THREADWAIT(cvda) ───└ ┘──┬ ┬──CONNECTST(cvda) ── ── ├ ┤─TWAIT────────────
├ ┤─CONNECTED───────── ├ ┤─NOTWAIT────────── ├ ┤─NOTCONNECTED────── └ ┘─N9ð6───────────── └ ┘─FORCENOTCONNECTED─
186 CICS User’s Handbook
CST syntax
CEMT SET DB2ENTRY
┌ ┐─────────────────────────────55──CEMT Set DB2Entry─ ──┬ ┬───────────── ───
6┴┬ ┬───────────────────────── ─5%
└ ┘──(data-area) ├ ┤──┬ ┬──ACCOUNTREC(cvda) ─── │ │├ ┤─UOW────────────── │ │├ ┤─TASK───────────── │ │├ ┤─TXID───────────── │ │└ ┘─NONE─────────────
├ ┤──AUTHID(data-area) ──────├ ┤──┬ ┬──AUTHTYPE(cvda) ─────
│ │├ ┤─GROUP────────── │ │├ ┤─SIGN─────────── │ │├ ┤─TERM─────────── │ │├ ┤─TX───────────── │ │├ ┤─OPID─────────── │ │└ ┘─USERID─────────
├ ┤──┬ ┬──DISABLEDACT(cvda) ── │ │├ ┤─ABEND───────────── │ │├ ┤─SQLCODE─────────── │ │└ ┘─POOL──────────────
├ ┤──┬ ┬──ENABLESTATUS(cvda) ─ │ │├ ┤─ENABLED──────────── │ │├ ┤─DISABLED─────────── │ │└ ┘─FORCEDISABLED──────
├ ┤──PLAN(data-area) ────────├ ┤──PLANEXITNAME(data-area)├ ┤──┬ ┬──PRIORITY(cvda) ─────
│ │├ ┤─HIGH─────────── │ │├ ┤─EQUAL────────── │ │└ ┘─LOW────────────
├ ┤──PROTECTNUM(data-area) ──├ ┤──THREADLIMIT(data-area) ─└ ┘──┬ ┬──THREADWAIT(cvda) ───
├ ┤─TWAIT──────────── ├ ┤─NOTWAIT────────── └ ┘─TPOOL────────────
CEMT SET DB2TRAN
┌ ┐─────────────────────────55─ ──CEMT Set DB2Tran ───
6┴┬ ┬───────────────────── ─5%
├ ┤──DB2Entry(data-area)└ ┘──Transid(data-area) ─
CEMT SET DELETSHIPPED
55─ ──CEMT Set DEletshipped ──┬ ┬───────────────── ──┬ ┬───────────── ─5%└ ┘──INterval(value) └ ┘──IDle(value)
CEMT SET DSAS
55─ ──CEMT Set DSAs ──┬ ┬───────────────── ──┬ ┬────────────────── ─5%└ ┘──Dsalimit(value) └ ┘──EDsalimit(value)
Chapter 3. CICS-Supplied Transaction 187
CST syntax
CEMT SET DSNAME
55─ ──CEMT Set DSName ──┬ ┬──(value) ──┬ ┬──────────── ──┬ ┬───────────── ─────────────5 └ ┘─ALl───── ├ ┤─REMOve───── ├ ┤─AVailable─── ├ ┤─RECOVEREd── └ ┘─UNAvailable─ ├ ┤─RESetlocks─ └ ┘─RETRy──────
5─ ──┬ ┬───────────── ──┬ ┬───────── ─5% ├ ┤─Quiesced──── ├ ┤─BACkout─ ├ ┤─UNQuiesced── ├ ┤─Commit── └ ┘─IMmquiesced─ └ ┘─FOrce───
CEMT SET DUMPDS
55─ ──CEMT Set DUmpds ──┬ ┬──────── ──┬ ┬────────────── ─5% ├ ┤─Open─── ├ ┤─Autoswitch─── ├ ┤─CLosed─ └ ┘─Noautoswitch─ └ ┘─Switch─
| CEMT SET ENQMODEL|
| 55─ ──CEMT Set ENQModel(value) ──┬ ┬────────── ─5%| ├ ┤─Enabled──| └ ┘─DIsabled─
CEMT SET FILE
55─ ──CEMT Set FIle ──┬ ┬──(value) ──┬ ┬──────────── ──┬ ┬────────── ──┬ ┬──────── ──────5 └ ┘─ALl───── ├ ┤─OPen─────── ├ ┤─ENabled── ├ ┤─REAd─── ├ ┤─CLosed───── └ ┘─DIsabled─ └ ┘─NORead─ └ ┘─Forceclose─
5─ ──┬ ┬────────── ──┬ ┬─────────── ──┬ ┬────────── ──┬ ┬────────── ──┬ ┬───────────── ───5 ├ ┤─UPdate─── ├ ┤─ADdable─── ├ ┤─BRowse─── ├ ┤─DElete─── ├ ┤─EXclusive─── └ ┘─NOUpdate─ └ ┘─NOAddable─ └ ┘─NOBrowse─ └ ┘─NODelete─ └ ┘─NOEXclusive─
5─ ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬──────── ──┬ ┬─────────────── ──┬ ┬─────────── ────5├ ┤─EMptyreq─── ├ ┤─Old─── ├ ┤─RLs──── └ ┘──DSname(value) ├ ┤─NOTTable──
└ ┘─NOEMptyreq─ └ ┘─Share─ └ ┘─NOTRls─ ├ ┤─CIcstable─ ├ ┤─USertable─
| └ ┘─CFTable───
5─ ──┬ ┬──────── ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬──────────── ──────5| ├ ┤─LOAd─── └ ┘──CFDtpool(value) └ ┘──Tablename(value) ├ ┤─COntention─| └ ┘─NOLoad─ └ ┘─LOCking────
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬─────────────────── ─5%| └ ┘──Maxnumrecs(value) └ ┘──Keylength(value) └ ┘──RECordsize(value)
CEMT SET GTFTRACE
55─ ──CEMT Set Gtftrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──
CEMT SET INTTRACE
55─ ──CEMT Set INttrace ──┬ ┬─────── ─5% ├ ┤─STArt─ └ ┘─STOp──
188 CICS User’s Handbook
CST syntax
CEMT SET IRC
55─ ──CEMT SET IRc ──┬ ┬─Open───── ─5% ├ ┤─Closed─── └ ┘─Immclose─
CEMT SET JOURNALNAME
55─ ──CEMT Set Journalname(value) ──┬ ┬──(value) ──┬ ┬────────── ──┬ ┬─────── ─5% └ ┘─All───── ├ ┤─Enabled── ├ ┤─FLush─ └ ┘─DIsabled─ └ ┘─Reset─
CEMT SET LINE
55─ ──CEMT Set Line(value) ──┬ ┬─────────────── ──┬ ┬──────────────── ───────────────5└ ┘──NUmber(value) └ ┘──NEgpoll(value)
5─ ──┬ ┬──────────── ──┬ ┬──────────── ─5% ├ ┤─Inservice── ├ ┤─Purge────── └ ┘─Outservice─ └ ┘─Forcepurge─
CEMT SET MODENAME
55─ ──CEMT Set MODename ──┬ ┬──(value) ──┬ ┬─────────────────── ─────────────────────5└ ┘─ALl───── └ ┘──COnnection(value)
5─ ──┬ ┬────────────────── ──┬ ┬────────── ─5%└ ┘──AVailable(value) ├ ┤─ACQuired─
└ ┘─CLosed───
CEMT SET MONITOR
55─ ──CEMT Set MONitor ──┬ ┬───── ──┬ ┬──────── ──┬ ┬───────── ──┬ ┬────────── ──────────5 ├ ┤─ON── ├ ┤─Perf─── ├ ┤─EVent─── ├ ┤─EXcept─── └ ┘─OFf─ └ ┘─NOPerf─ └ ┘─NOEVent─ └ ┘─NOEXcept─
5─ ──┬ ┬──────────── ──┬ ┬───────────── ──┬ ┬────────────────── ─5%├ ┤─Converse─── ├ ┤─SYncpoint─── └ ┘──Frequency(value)
└ ┘─NOConverse─ └ ┘─NOSyncpoint─
CEMT SET NETNAME
55─ ──CEMT Set Netname ──┬ ┬──(value) ──┬ ┬───────────────── ──┬ ┬────────────── ──────5└ ┘─ALl───── └ ┘──PRiority(value) ├ ┤─PAgeable─────
└ ┘─AUtopageable─
5─ ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬─────── ──┬ ┬──────────── ──┬ ┬────────── ─────────5 ├ ┤─Inservice── ├ ┤─ATi─── ├ ┤─TTi─── ├ ┤─PUrge────── ├ ┤─ACquired─ └ ┘─Outservice─ └ ┘─NOAti─ └ ┘─NOTti─ └ ┘─Forcepurge─ ├ ┤─COldacq── └ ┘─RELeased─
5─ ──┬ ┬────────── ─5% ├ ┤─CReate─── └ ┘─NOCreate─
Chapter 3. CICS-Supplied Transaction 189
CST syntax
CEMT SET PROCESSTYPE
┌ ┐─ALl─────55─ ──CEMT Set PROCesstype ──┼ ┼───────── ──┬ ┬────────── ──┬ ┬────────── ─5%
└ ┘──(value) ├ ┤─ACtivity─ ├ ┤─Enabled── ├ ┤─FUll───── └ ┘─Disabled─ ├ ┤─Off────── └ ┘─Process──
CEMT SET PROGRAM
┌ ┐─PRIvate─55─ ──CEMT Set Program ──┬ ┬──(value) ───── ──┬ ┬────────── ──┼ ┼───────── ─────────────5
├ ┤──CLass(value) ├ ┤─Enabled── └ ┘─Shared── └ ┘─ALl────────── └ ┘─DIsabled─
5─ ──┬ ┬───────── ──┬ ┬──────── ──┬ ┬─────────── ──┬ ┬───────────────── ──┬ ┬───────── ───5| ├ ┤─NEwcopy─ ├ ┤─CEDf─── ├ ┤─DPlsubset─ └ ┘──JVMClass(value) ├ ┤─DEBUG───| └ ┘─PHasein─ └ ┘─NOCedf─ └ ┘─Fullapi─── └ ┘─NODEBUG─
5─ ──┬ ┬─────── ─5%| ├ ┤─JVM───| └ ┘─NOJVM─
CEMT SET STATISTICS
55─ ──CEMT Set STatistics ──┬ ┬───── ── ──┬ ┬────────── ── ──┬ ┬─────────── ─────────────5 ├ ┤─ON── └ ┘─RESetnow─ └ ┘─RECordnow─ └ ┘─OFf─
5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ─5%└ ┘──Interval(hhmmss) └ ┘──Endofday(hhmmss)
CEMT SET SYDUMPCODE
55─ ──CEMT Set SYDumpcode ──┬ ┬──(value) ──┬ ┬─────────── ──┬ ┬──────────── ───────────5 └ ┘─ALl───── ├ ┤─SYsdump─── ├ ┤─SHutdown─── └ ┘─NOSYsdump─ └ ┘─NOSHutdown─
5─ ──┬ ┬───────── ──┬ ┬──────────────── ──┬ ┬──────── ──┬ ┬─────── ─5%├ ┤─RELated─ └ ┘──Maximum(value) ├ ┤─RESet── ├ ┤─Dae───
└ ┘─Local─── ├ ┤─REMove─ └ ┘─NODae─ └ ┘─ADd────
190 CICS User’s Handbook
CST syntax
CEMT SET SYSTEM
┌ ┐──────────────────────────55─ ──CEMT Set SYStem ───
6┴┬ ┬────────────────────── ─5%
├ ┤──AGing(value) ──────── ├ ┤──AKp(value) ────────── ├ ┤──DSAlimit(value) ─────
| ├ ┤──DSRtprogram(value) ── ├ ┤──DTrprogram(value) ─── ├ ┤──EDsalimit(value) ────
| ├ ┤──Forceqr ──┬ ┬─Force───| │ │└ ┘─NOForce─| ├ ┤──Logdefer(value) ─────| ├ ┤──MAXOpentcbs(value) ──
├ ┤──MAxtasks(value) ───── ├ ┤──MRobatch(value) ───── ├ ┤──┬ ┬─CTLGAll──── ────── │ │├ ┤─CTLGModify─ │ │└ ┘─CTLGNone─── ├ ┤──Progautoexit(value) ─ ├ ┤──┬ ┬─AUTOActive─── ──── │ │└ ┘─AUTOInactive─ ├ ┤──RUnaway(value) ────── ├ ┤──SCandelay(value) ──── ├ ┤──Time(value) ───────── └ ┘──┬ ┬─SYsdump─── ─────── └ ┘─NOSysdump─
CEMT SET TASK
55─ ──CEMT Set TAsk ──┬ ┬──(value) ──┬ ┬───────────────── ──┬ ┬──────────── ─5%└ ┘─All───── └ ┘──PRiority(value) ├ ┤─PUrge──────
└ ┘─FOrcepurge─
CEMT SET TCLASS
55─ ──CEMT Set TClass ──┬ ┬──(value) ──┬ ┬────────────────── ────────────────────────5└ ┘─ALl───── └ ┘──Maxactive(value)
5─ ──┬ ┬──────────────────── ─5%└ ┘──Purgethresh(value)
CEMT SET TCPIP
55─ ──CEMT Set TCPIP ──┬ ┬──(value) ──┬ ┬──Openstatus(cvda) ─5% └ ┘─ALl───── ├ ┤─OPEN───────────── ├ ┤─CLOSE──────────── └ ┘─IMMCLOSE─────────
CEMT SET TCPIPSERVICE
55─ ──CEMT Set TCPIPSERVICE ──┬ ┬──(value) ──┬ ┬──────────────── ────────────────────5└ ┘─ALl───── └ ┘──Backlog(value)
5─ ──┬ ┬────────────────── ──┬ ┬──────────── ─5%├ ┤──Openstatus(cvda) └ ┘──URM(value)
├ ┤─OPEN───────────── ├ ┤─CLOSE──────────── └ ┘─IMMCLOSE─────────
Chapter 3. CICS-Supplied Transaction 191
CST syntax
CEMT SET TDQUEUE
55─ ──CEMT Set TDqueue ──┬ ┬──(value) ──┬ ┬───────────────────── ──┬ ┬────────── ──────5└ ┘─All───── └ ┘──TRIggerlevel(value) ├ ┤─ENabled──
└ ┘─DIsabled─
5─ ──┬ ┬──────── ─5% ├ ┤─OPen─── └ ┘─Closed─
CEMT SET TERMINAL
55─ ──CEMT Set TErminal ──┬ ┬──(value) ───── ──┬ ┬───────────────── ──────────────────5├ ┤──CLass(value) └ ┘──PRiority(value)
└ ┘─ALl──────────
5─ ──┬ ┬────────────── ──┬ ┬──────────── ──┬ ┬─────── ──┬ ┬─────── ──┬ ┬──────────── ─────5 ├ ┤─PAgeable───── ├ ┤─Inservice── ├ ┤─ATi─── ├ ┤─TTi─── ├ ┤─PUrge────── └ ┘─AUtopageable─ └ ┘─Outservice─ └ ┘─NOAti─ └ ┘─NOTti─ ├ ┤─Forcepurge─ └ ┘─CAncel─────
5─ ──┬ ┬────────── ──┬ ┬────────── ─5% ├ ┤─ACquired─ ├ ┤─CReate─── ├ ┤─COldacq── └ ┘─NOCreate─ └ ┘─RELeased─
CEMT SET TRANSACTION
55─ ──CEMT Set TRAnsaction ──┬ ┬──(value) ───── ──┬ ┬───────────────── ───────────────5├ ┤──CLass(value) └ ┘──PRIority(value)
└ ┘─ALl──────────
5─ ──┬ ┬─────────────── ──┬ ┬────────── ──┬ ┬────────────── ─5%└ ┘──TClass(value) ├ ┤─Enabled── ├ ┤─PUrgeable────
└ ┘─Disabled─ └ ┘─NOTpurgeable─
CEMT SET TRDUMPCODE
55─ ──CEMT Set TRDumpcode ──┬ ┬──(value) ──┬ ┬──────────── ──┬ ┬─────────── ───────────5 └ ┘─ALl───── ├ ┤─Trandump─── ├ ┤─SYsdump─── └ ┘─NOTrandump─ └ ┘─NOSYsdump─
5─ ──┬ ┬──────────── ──┬ ┬───────── ──┬ ┬──────────────── ──┬ ┬──────── ─5%├ ┤─SHutdown─── ├ ┤─RELated─ └ ┘──Maximum(value) ├ ┤─RESet──
└ ┘─NOSHutdown─ └ ┘─Local─── ├ ┤─REMove─ └ ┘─ADd────
| CEMT SET TSQUEUE|
| ┌ ┐─ALl─────| 55─ ──CEMT Set TSqueue ──┼ ┼───────── ──┬ ┬───────────────── ────────────────────────5| └ ┘──(value) ├ ┤──SYSID(value) ───| └ ┘──POOLNAME(value)
| 5─ ──┬ ┬──────────────────── ──┬ ┬──Action(value) ─5%| └ ┘──LAstusedint(value) └ ┘─DELETE────────
192 CICS User’s Handbook
CST syntax
CEMT SET UOW
55─ ──CEMT Set UOW(value) ──┬ ┬──(value) ──┬ ┬─COMmit── ─5% └ ┘─ALl───── ├ ┤─Backout─ └ ┘─Force───
CEMT SET UOWLINK
55─ ──CEMT Set UOWlink(value) ──┬ ┬──(value) ──Delete ─5% └ ┘─ALl─────
CEMT SET VTAM
55─ ──CEMT Set Vtam ──┬ ┬─Open─────── ──┬ ┬───────────────────── ──┬ ┬────────────── ─5%├ ┤─Closed───── └ ┘──Psdinterval(hhmmss) └ ┘──Deregistered
├ ┤─Immclose─── └ ┘─Forceclose─
CEOT
55─ ──CEOT ──┬ ┬────────────── ──┬ ┬─────── ──┬ ┬─────── ─5% ├ ┤─PAgeable───── ├ ┤─ATi─── ├ ┤─TTi─── └ ┘─AUtopageable─ └ ┘─NOAti─ └ ┘─NOTti─
CESF
55─ ──CESF ──┬ ┬─────────── ─5% ├ ┤─GOODNIGHT─ └ ┘─LOGOFF────
CESN
| 55─ ──CESN USERID=uuuuuuuu ──CESN ──USERID=uuuuuuuu ──┬ ┬─────────────────── ───────5└ ┘──,GROUPID=gggggggg
5─ ──┬ ┬─────────────── ──┬ ┬────────────── ──┬ ┬───────────────── ─5%└ ┘──,LANGUAGE=lll └ ┘──,PS=pppppppp └ ┘──,NEWPS=password
Note:1 Do not use blanks between parameters in the comma-separated
list.
Chapter 3. CICS-Supplied Transaction 193
CST syntax
CMSG
55─ ──CMSG ──┬ ┬────── ──'message' ─────────────────────────────────────────────────5 └ ┘─MSG=─
┌ ┐────────────────5─ ──┬ ┬───────────────────────────────────────────────── ───
6┴┬ ┬──────────── ──────5
│ │┌ ┐───────────────── └ ┘─,OPCLASS=n─ └ ┘─,ROUTE=─ ──┬ ┬ ─ ──
6┴─Termid──/opid─ ─────────────────
├ ┤─ALL──────────────────────────────── │ │┌ ┐───────────── ┌ ┐─────────────────── └ ┘ ───
6┴─.termlist─ ───
6┴─,±termid──/opid─
5─ ──┬ ┬───────────── ──┬ ┬───────────────── ──┬ ┬─────────────────────── ────────────5└ ┘─,TIME=value─ ├ ┤─,DATE=value───── └ ┘──,ERRTERM= ──┬ ┬─Termid─
└ ┘─,FULLDATE=value─ └ ┘─ORIG───
5─ ──┬ ┬───────────── ──┬ ┬──────────────────── ──┬ ┬─────────────────────── ─────────5└ ┘──,ID=(title) └ ┘──,HEADING= ──┬ ┬─YES─ └ ┘──,PROTECT= ──┬ ┬─YES────
└ ┘─NO── ├ ┤─NO───── └ ┘─Prefix─
5─ ──┬ ┬─,SEND─── ─5% └ ┘─,CANCEL─
ROUTE
┌ ┐───────────────────────55─ ──ROUTE= ──┬ ┬───
6┴─Termid──\ldc──/opid─ ──────── ─5%
├ ┤─ALL──\ldc─────────────────────── │ │┌ ┐─────────────────── └ ┘───
6┴─.termlist──\ldc─ ─┤ Idloop ├─
Idloop: ┌ ┐───────────────────────────├─ ───
6┴┬ ┬─────────────────────── ─┤
└ ┘─,±termid──\ldc──/opid─
CRTE
55─ ──CRTE ──SYSID=sysid ──┬ ┬──────────────── ─5% └ ┘─,TRPROF=trprof─
CSFE SPOOLFE
55─ ──CSFE spoolfe= ──┬ ┬─ON── ─5% └ ┘─OFF─
CSFE ZCQTRACE
55─ ──CSFE zcqtrace ──┬ ┬─=termid────── ─5% ├ ┤─,AUTOINSTALL─ └ ┘─,OFF─────────
CSFE DEBUG TRANID
55─ ──CSFE debug ──┬ ┬─,TRANID=xxxx─ ──┬ ┬─────────────────── ─5% └ ┘─,TASKREQ=yyy─ │ │┌ ┐─OFF─
└ ┘──,STGFRZ= ──┴ ┴─ON──
194 CICS User’s Handbook
CST syntax
CSFE DEBUG CHKSTSK
55─ ──CSFE debug ──┬ ┬──,CHKSTSK= ──┬ ┬─CURRENT─ ─5% │ │└ ┘─NONE────
└ ┘──,CHKSTRM= ──┬ ┬─CURRENT─ └ ┘─NONE────
CSPG GETPAGE
55─ ──CSPG ──Getpage ──┬ ┬─── ──B ──┬ ┬────── ──┬ ┬───────── ─5%└ ┘─A─ ├ ┤─\ldc─ └ ┘─,hhhhhh─
└ ┘─\ALL─
CSPG MESSCHNYYYY
55─ ──CSPG ──Messchnyyyy ──┬ ┬──────────── ─5% └ ┘─Parameters─
CSPG MSGTERM
55─ ──CSPG ──Msgterm ──┬ ┬─A─ ──┬ ┬───────── ─5% ├ ┤─B─ └ ┘─,hhhhhh─ ├ ┤─C─ ├ ┤─H─ └ ┘─R─
CWTO
55─ ──CWTO ──Message ─5%
Chapter 3. CICS-Supplied Transaction 195
RDO
Chapter 4. Resource definition online
The syntax diagrams that follow are taken from the CICS ResourceDefinition Guide.
ADD syntax
55─ ──ADd ──Group(groupname1) ──LIst(listname) ──┬ ┬──────────────────── ─5%├ ┤──Before(groupname2)└ ┘──After(groupname3) ─
ALTER syntax
55─ ──ALter ──┬ ┬──Connection(name) ── ──Group(groupname) ───────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TErminal(name) ────├ ┤──TDqueue(name) ─────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──attribute list(new value) ─5%
APPEND syntax
55─ ──APpend ──LIst(listname1) ──To(listname2) ─5%
Copyright IBM Corp. 1989, 1999 197
RDO
CHECK syntax
55─ ──CHeck ──┬ ┬──Group(groupname) ──────────────────────────────── ───────────5└ ┘──List(listname1, listname2, listname3, listname4)
5─ ──┬ ┬───────────────────── ─5%| └ ┘──Remotesystem(sysid)
COPY syntax
┌ ┐─All────────────────55─ ──COpy ──┼ ┼──────────────────── ──Group(groupname) ────────────────────────5
├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──┬ ┬──AS(newname) ────────────────── ──┬ ┬───────── ─5%├ ┤──TO(newgroupname) ───────────── ├ ┤──Replace└ ┘──AS(new-name) TO(newgroupname) └ ┘──MErge ──
198 CICS User’s Handbook
RDO
USERDEFINE syntax
55─ ──USerdefine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────├ ┤──DOctemplate(name) ─├ ┤──Enqmodel(name) ────├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──attribute list(newvalue) ─5%
DEFINE syntax
55─ ──DEFine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──LSRpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──attribute list(newvalue) ─5%
Chapter 4. Resource definition online 199
RDO
DELETE syntax
55─ ──DELete ──┬ ┬─All──────────────── ──Group(groupname) ──┬ ┬──────── ─5%| ├ ┤──Connection(name) ── └ ┘─REMove─
├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
DISPLAY syntax
55─ ──DISplay ──┬ ┬──List(listname) ──┬ ┬────────────────── ──────────────── ─5%│ │└ ┘──Group(groupname)
└ ┘──Group(groupname) ──┬ ┬──────────────────── ──┬ ┬────────├ ┤ ─ ─ALl(name) ───────── └ ┘──REname├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
200 CICS User’s Handbook
RDO
EXPAND syntax
55─ ──EXPand ──┬ ┬──List(listname) ──┬ ┬────────────────── ──────────────── ─5%│ │└ ┘──Group(groupname)
└ ┘──Group(groupname) ──┬ ┬──────────────────── ──┬ ┬────────├ ┤ ─ ─ALl(name) ───────── └ ┘──REname├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
INSTALL syntax
| 55─ ──Install ──┬ ┬──────────────────── ──┬ ┬──Group(groupname) ─5%| ├ ┤ ─ ─ALl(name) ───────── └ ┘──List(listname) ──
├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)| ├ ┤──TCpipservice(name)
├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
Chapter 4. Resource definition online 201
RDO
LOCK syntax
55─ ──Lock ──┬ ┬──Group(groupname) ─5%└ ┘──List(listname) ──
MOVE syntax
┌ ┐─All────────────────55─ ──Move ──┼ ┼──────────────────── ──Group(groupname) ──┬ ┬──────── ────────────5
| ├ ┤──Connection(name) ── └ ┘─REMove─├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──┬ ┬──AS(newname) ───────────────── ──┬ ┬───────── ─5%| ├ ┤──TO(newgroupname) ──────────── ├ ┤──REPlace
└ ┘──AS(newname) TO(newgroupname) └ ┘──MErge ──
REMOVE syntax
55─ ──REMove ──Group(groupname) ──List(listname) ─5%
202 CICS User’s Handbook
RDO
RENAME syntax
55─ ──REName ──┬ ┬──────────────────── ──┬ ┬────────────────── ──────────────────5├ ┤ ─ ─ALl(name) ───────── └ ┘──Group(groupname)├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──REQuestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──┬ ┬───────────── ──┬ ┬────────────────── ──┬ ┬──────── ─5%| └ ┘──AS(newname) └ ┘──TO(newgroupname) └ ┘──REMove
UNLOCK syntax
55─ ──UNLock ──┬ ┬──Group(groupname) ─5%└ ┘──List(listname) ──
Chapter 4. Resource definition online 203
RDO
USERDEFINE syntax
55─ ──USerdefine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──attribute list(newvalue) ─5%
VIEW syntax
55─ ──View ──Group(groupname) ──┬ ┬──────────────────── ─5%├ ┤ ─ ─ALl(name) ─────────├ ┤──Connection(name) ──├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────├ ┤──PROFile(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
204 CICS User’s Handbook
CSD
Chapter 5. DFHCSDUP commands
The syntax diagrams that follow are taken from the CICS ResourceDefinition Guide.
ADD syntax
55─ ──ADd ──Group(groupname) ──LIst(listname) ─5%
ALTER syntax
55─ ──ALter ──┬ ┬──Connection(name) ── ──Group(groupname) ───────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──attribute list(new value) ─5%
APPEND syntax
55─ ──APpend ──FRomcsd(ddname) ──LIst(listname1) ──To(listname2) ─5%
Copyright IBM Corp. 1989, 1999 205
CSD
COPY syntax
55─ ──Copy ──Group(groupname1) ──To(groupname2) ──┬ ┬───────── ──────────────────5 ├ ┤──Replace └ ┘──MErge ──
5─ ──FRomcsd(ddname) ─5%
DEFINE syntax
55─ ──DEFine ──┬ ┬──Connection(name) ── ──Group(groupname) ──────────────────────5├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──LSRpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
5─ ──attribute list(newvalue) ─5%
206 CICS User’s Handbook
CSD
DELETE syntax
55─ ──DELete ──┬ ┬──List(listname) ────────────────────────────────────── ─5% └ ┘──Group(groupname) ──┬ ┬─All──────────────── ──┬ ┬────────
| ├ ┤──Connection(name) ── └ ┘─REMove─├ ┤──DB2Conn(name) ─────├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
EXTRACT syntax
55─ ──EXtract ──┬ ┬──Group(groupname) ──┬ ┬──USerprogram(DFHxCRFy) ──────────── ──5└ ┘──LIst(listname) ── ├ ┤──USerprogram(DFHxFORy) ────────────
├ ┤──USerprogram(DFHðCBDC) ──────────── └ ┘──USerprogram(user-written program)
5─ ── ──┬ ┬───────── ─5% └ ┘─Objects─
INITIALIZE syntax
55─ ──INITialize ─5%
Chapter 5. DFHCSDUP commands 207
CSD
LIST syntax
┌ ┐─All─55─ ──LIst ──┬ ┬── ──┴ ┴───── ─────── ── ──┬ ┬───────── ─5%
├ ┤──Group(groupname) └ ┘─Objects─└ ┘──LIst(listname) ──
MIGRATE syntax
55─ ──MIgrate ──TAble(tablename) ──┬ ┬──────────────────────────── ─────────────5└ ┘──TYpesgroup(typesgroupname)
5─ ──┬ ┬──────────────────── ─5%└ ┘──TOGROUP(groupname)
REMOVE syntax
55─ ──Remove ──Group(groupname) ──LIst(listname) ─5%
208 CICS User’s Handbook
CSD
SCAN syntax
55─ ──SCAN ──┬ ┬──Connection(name) ── ──┬ ┬────────────────── ─5%├ ┤──DB2Conn(name) ───── └ ┘──ALIAS(aliasname)├ ┤──DB2Entry(name) ────├ ┤──DB2Tran(name) ─────
| ├ ┤──DOctemplate(name) ─| ├ ┤──Enqmodel(name) ────
├ ┤──File(name) ────────├ ┤──Journalmodel(name)├ ┤──Lsrpool(name) ─────├ ┤──Mapset(name) ──────├ ┤──PARTItionset(name)├ ┤──PARTNer(name) ─────
| ├ ┤──PROCesstype(name) ─├ ┤──PROFile(name) ─────├ ┤──PROGram(name) ─────
| ├ ┤──Requestmodel(name)├ ┤──Sessions(name) ────
| ├ ┤──TCpipservice(name)├ ┤──TDqueue(name) ─────├ ┤──TErminal(name) ────├ ┤──TRANClass(name) ───├ ┤──TRANSaction(name) ─
| ├ ┤──TSmodel(name) ─────└ ┘──TYpeterm(name) ────
SERVICE syntax
55─ ──Service ──FRomcsd(ddname) ──LEvel(nnn) ─5%
UPGRADE syntax
55─ ──UPgrade ──┬ ┬───────────────── ── ──┬ ┬───────── ─5%└ ┘──USing(filename) └ ┘─Replace─
VERIFY syntax
55─ ──VERIFY ─5%
Chapter 5. DFHCSDUP commands 209
FEPI programming
Chapter 6. Front End Programming Interfacecommand reference
This chapter contains General Use Programming Interface information.
FEPI application programming
FEPI ALLOCATE PASSCONVID
55─ ──FEPI ALLOCATE ──PASSCONVID(data-value) ─5%
Conditions: INVREQ
FEPI ALLOCATE POOL
55─ ──FEPI ALLOCATE ──POOL(data-value) ──CONVID(data-area) ────────────────────────5
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────── ──┬ ┬───────────────────── ───5└ ┘──TARGET(data-value) └ ┘──TIMEOUT(data-value) └ ┘──SEQNUMIN(data-area)
5─ ──┬ ┬────────────────────── ──┬ ┬─────────────────── ─5%└ ┘──SEQNUMOUT(data-area) └ ┘──SESSNSTATUS(cvda)
Conditions: INVREQ
FEPI AP NOOP
55─ ──FEPI AP NOOP ─5%
Conditions: INVREQ
Previously allocated conversation
Copyright IBM Corp. 1989, 1999 211
FEPI programming
FEPI CONVERSE DATASTREAM
55─ ──FEPI CONVERSE DATASTREAM ──CONVID(data-value) ──FROM(data-value) ────────────5
┌ ┐─CHAIN─────5─ ──┬ ┬───────────────────────── ──┼ ┼─────────── ──┬ ┬───────────────── ──┬ ┬───── ───5
└ ┘──FROMFLENGTH(data-value) ├ ┤─RU──────── └ ┘──ENDSTATUS(cvda) └ ┘──FMH └ ┘─UNTILCDEB─
5─ ──┬ ┬───────────────── ──┬ ┬───────────────────────────────────── ───────────────5└ ┘──FMHSTATUS(cvda) └ ┘── ──INTO(data-area) ─┤ INTO options ├─
5─ ──┬ ┬─────────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ───5└ ┘──REMFLENGTH(data-area) └ ┘──RESPSTATUS(cvda) └ ┘──SEQNUMIN(data-area)
5─ ──┬ ┬────────────────────── ──┬ ┬───────────────────── ─5%└ ┘──SEQNUMOUT(data-area) └ ┘──TIMEOUT(data-value)
INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤
└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)
Conditions: INVREQ
212 CICS User’s Handbook
FEPI programming
Temporary conversationFEPI CONVERSE DATASTREAM
55─ ──FEPI CONVERSE DATASTREAM ──POOL(data-value) ──┬ ┬──────────────────── ────────5└ ┘──TARGET(data-value)
┌ ┐─UNTILCDEB─5─ ──FROM(data-value) ──┬ ┬───────────────────────── ──┴ ┴─────────── ───────────────5
└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬───────────────── ──┬ ┬───── ──┬ ┬───────────────── ──────────────────────────5└ ┘──ENDSTATUS(cvda) └ ┘──FMH └ ┘──FMHSTATUS(cvda)
5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────────── ─────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──REMFLENGTH(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬───────────────────── ──┬ ┬────────────────────── ────5└ ┘──RESPSTATUS(cvda) └ ┘──SEQNUMIN(data-area) └ ┘──SEQNUMOUT(data-area)
5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)
INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤
└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)
Conditions: INVREQ
Previously allocated conversationFEPI CONVERSE FORMATTED
55─ ──FEPI CONVERSE FORMATTED ──CONVID(data-value) ──FROM(data-value) ─────────────5
5─ ──┬ ┬───────────────────────── ────────────────────────────────────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──AID(data-value) ──┬ ┬──────────────────────── ────────────────────────────5│ │└ ┘──FROMCURSOR(data-value)
└ ┘ ──KEYSTROKES ──┬ ┬──────────────────── ─────────└ ┘──ESCAPE(data-value)
5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────── ─────────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──ALARMSTATUS(cvda)
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────── ──┬ ┬─────────────────── ─────────5└ ┘──COLUMNS(data-area) └ ┘──ENDSTATUS(cvda) └ ┘──FIELDS(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ────────5└ ┘──LINES(data-area) └ ┘──RESPSTATUS(cvda) └ ┘──TIMEOUT(data-value)
5─ ──┬ ┬───────────────────── ─5%└ ┘──TOCURSOR(data-area)
INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤
└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)
Conditions: INVREQ
Chapter 6. FEPI command reference 213
FEPI programming
Temporary conversationFEPI CONVERSE FORMATTED
55─ ──FEPI CONVERSE FORMATTED ──POOL(data-value) ──┬ ┬──────────────────── ─────────5└ ┘──TARGET(data-value)
5─ ──FROM(data-value) ──┬ ┬───────────────────────── ──KEYSTROKES ──────────────────5└ ┘──FROMFLENGTH(data-value)
5─ ──┬ ┬──────────────────── ──┬ ┬───────────────────────────────────── ────────────5└ ┘──ESCAPE(data-value) └ ┘── ──INTO(data-area) ─┤ INTO options ├─
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────── ──┬ ┬───────────────── ─────────5└ ┘──ALARMSTATUS(cvda) └ ┘──COLUMNS(data-area) └ ┘──ENDSTATUS(cvda)
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ──────────5└ ┘──FIELDS(data-area) └ ┘──LINES(data-area) └ ┘──RESPSTATUS(cvda)
5─ ──┬ ┬───────────────────── ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value) └ ┘──TOCURSOR(data-area)
INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬────────────────────── ─┤
└ ┘──MAXFLENGTH(data-value) └ ┘──TOFLENGTH(data-area)
Conditions: INVREQ
FEPI EXTRACT CONV
55─ ──FEPI EXTRACT CONV ──CONVID(data-value) ──┬ ┬────────────── ───────────────────5└ ┘──DEVICE(cvda)
5─ ──┬ ┬────────────── ──┬ ┬───────────────── ──┬ ┬─────────────────── ───────────────5└ ┘──FORMAT(cvda) └ ┘──POOL(data-area) └ ┘──TARGET(data-area)
5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ─5%└ ┘──NODE(data-area) └ ┘──SENSEDATA(data-area)
Conditions: INVREQ
214 CICS User’s Handbook
FEPI programming
FEPI EXTRACT FIELD
55─ ──FEPI EXTRACT FIELD ──CONVID(data-value) ──┬ ┬──FIELDLOC(data-value) ──────────5└ ┘──FIELDNUM(data-value)
5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────────── ─────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──BACKGROUND(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ──┬ ┬──────────────────── ─────5└ ┘──COLOR(data-area) └ ┘──FIELDATTR(data-area) └ ┘──HILIGHT(data-area)
5─ ──┬ ┬───────────────────────── ──┬ ┬─────────── ──┬ ┬──────────────────── ─────────5└ ┘──INPUTCONTROL(data-area) └ ┘──MDT(cvda) └ ┘──OUTLINE(data-area)
5─ ──┬ ┬───────────────────── ──┬ ┬─────────────── ──┬ ┬─────────────── ──────────────5└ ┘──POSITION(data-area) └ ┘──PROTECT(cvda) └ ┘──PS(data-area)
5─ ──┬ ┬───────────────── ──┬ ┬───────────────────────── ───────────────────────────5└ ┘──SIZE(data-area) └ ┘──TRANSPARENCY(data-area)
5─ ──┬ ┬─────────────────────── ─5%└ ┘──VALIDATION(data-area)
INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─┤
└ ┘──MAXFLENGTH(data-value) └ ┘──FLENGTH(data-area)
Conditions: INVREQ
FEPI EXTRACT STSN
55─ ──FEPI EXTRACT STSN ──CONVID(data-value) ──┬ ┬───────────────────── ────────────5└ ┘──SEQNUMIN(data-area)
5─ ──┬ ┬────────────────────── ──┬ ┬────────────────── ─5%└ ┘──SEQNUMOUT(data-area) └ ┘──STSNSTATUS(cvda)
Conditions: INVREQ
FEPI FREE
┌ ┐─HOLD────55─ ──FEPI FREE ──CONVID(data-value) ──┼ ┼───────── ─5% ├ ┤─RELEASE─ ├ ┤─FORCE─── └ ┘─PASS────
Conditions: INVREQ
FEPI ISSUE
55─ ──FEPI ISSUE ──CONVID(data-value) ──CONTROL(cvda) ──┬ ┬─────────────────────── ──5└ ┘──SENSEDATA(data-value)
5─ ──┬ ┬───────────── ─5%└ ┘──VALUE(cvda)
Conditions: INVREQ
Chapter 6. FEPI command reference 215
FEPI programming
FEPI RECEIVE DATASTREAM
┌ ┐─CHAIN─────55─ ──FEPI RECEIVE DATASTREAM ──CONVID(data-value) ──┼ ┼─────────── ────────────────5 ├ ┤─RU──────── └ ┘─UNTILCDEB─
5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ───────────────────────────────────5└ ┘──ENDSTATUS(cvda) └ ┘──FMHSTATUS(cvda)
5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────────── ─────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──REMFLENGTH(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬───────────────────── ──┬ ┬────────────────────── ────5└ ┘──RESPSTATUS(cvda) └ ┘──SEQNUMIN(data-area) └ ┘──SEQNUMOUT(data-area)
5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)
INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─┤
└ ┘──MAXFLENGTH(data-value) └ ┘──FLENGTH(data-area)
Conditions: INVREQ
FEPI RECEIVE FORMATTED
55─ ──FEPI RECEIVE FORMATTED ──CONVID(data-value) ────────────────────────────────5
5─ ──┬ ┬───────────────────────────────────── ──┬ ┬─────────────────── ─────────────5 └ ┘── ──INTO(data-area) ─┤ INTO options ├─ └ ┘──ALARMSTATUS(cvda)
5─ ──┬ ┬──────────────────── ──┬ ┬─────────────────── ──┬ ┬───────────────── ─────────5└ ┘──COLUMNS(data-area) └ ┘──CURSOR(data-area) └ ┘──ENDSTATUS(cvda)
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬────────────────── ──────────5└ ┘──FIELDS(data-area) └ ┘──LINES(data-area) └ ┘──RESPSTATUS(cvda)
5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)
INTO options:├─ ──┬ ┬──────────────────────── ──┬ ┬──────────────────── ─┤
└ ┘──MAXFLENGTH(data-value) └ ┘──FLENGTH(data-area)
Conditions: INVREQ
FEPI REQUEST PASSTICKET
55─ ──FEPI REQUEST PASSTICKET(data-area) ──CONVID(data-value) ────────────────────5
5─ ──┬ ┬──────────────────── ──┬ ┬────────────────────── ─5%└ ┘──ESMRESP(data-area) └ ┘──ESMREASON(data-area)
Conditions: INVREQ
216 CICS User’s Handbook
FEPI programming
FEPI SEND DATASTREAM
55─ ──FEPI SEND DATASTREAM ──CONVID(data-value) ──FROM(data-value) ────────────────5
5─ ──┬ ┬───────────────────── ──┬ ┬──────── ──┬ ┬───── ──┬ ┬───────────────────── ──────5└ ┘──FLENGTH(data-value) └ ┘──INVITE └ ┘──FMH └ ┘──SEQNUMIN(data-area)
5─ ──┬ ┬────────────────────── ─5%└ ┘──SEQNUMOUT(data-area)
Conditions: INVREQ
FEPI SEND FORMATTED
55─ ──FEPI SEND FORMATTED ──CONVID(data-value) ──FROM(data-value) ─────────────────5
5─ ──┬ ┬───────────────────── ──┬ ┬──AID(data-value) ──┬ ┬──────────────────── ─5%└ ┘──FLENGTH(data-value) │ │└ ┘──CURSOR(data-value)
└ ┘ ─KEYSTROKES─ ──┬ ┬──────────────────── ─────└ ┘──ESCAPE(data-value)
Conditions: INVREQ
FEPI START
55─ ──FEPI START ──CONVID(data-value) ──TRANSID(data-value) ───────────────────────5
5─ ──┬ ┬──────────────────── ─────────────────────────────────────────────────────5└ ┘──TERMID(data-value)
5─ ──┬ ┬───────────────────────────────────────────────── ────────────────────────5 └ ┘── ──USERDATA(data-value) ──┬ ┬─────────────────────
└ ┘──FLENGTH(data-value)
5─ ──┬ ┬───────────────────── ─5%└ ┘──TIMEOUT(data-value)
Conditions: INVREQ
Chapter 6. FEPI command reference 217
FEPI programming
FEPI system programming
FEPI ADD POOL
┌ ┐─ACQUIRED────────55─ ──FEPI ADD ──POOL(data-value) ──┼ ┼───────────────── ───────────────────────────5
├ ┤──ACQSTATUS(cvda) └ ┘─RELEASED────────
┌ ┐─INSERVICE────────5─ ──┬ ┬────────────────────────────────────────── ──┼ ┼────────────────── ─────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value) ├ ┤──SERVSTATUS(cvda) └ ┘─OUTSERVICE───────
5─ ──┬ ┬────────────────────────────────────────────── ─5% └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value)
Conditions: INVREQ, NOTAUTH
FEPI DELETE POOL
55─ ──FEPI DELETE ──POOL(data-value) ─────────────────────────────────────────────5
5─ ──┬ ┬────────────────────────────────────────── ───────────────────────────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value)
5─ ──┬ ┬────────────────────────────────────────────── ─5% └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value)
Conditions: INVREQ, NOTAUTH
FEPI DISCARD NODELIST
55─ ──FEPI DISCARD ──NODELIST(data-area) ──NODENUM(data-value) ─5%
Conditions: INVREQ, NOTAUTH
FEPI DISCARD POOL
55─ ──FEPI DISCARD ──POOL(data-value) ─5%
Conditions: INVREQ, NOTAUTH
FEPI DISCARD PROPERTYSET
55─ ──FEPI DISCARD ──PROPERTYSET(data-value) ─5%
Conditions: INVREQ, NOTAUTH
218 CICS User’s Handbook
FEPI programming
FEPI DISCARD TARGETLIST
55─ ──FEPI DISCARD ──TARGETLIST(data-area) ──TARGETNUM(data-value) ─5%
Conditions: INVREQ, NOTAUTH
FEPI INQUIRE CONNECTION
55─ ──FEPI INQUIRE CONNECTION ──NODE(data-value) ──TARGET(data-value) ─────────────5
5─ ──┬ ┬─────────────────── ──┬ ┬───────────────── ──┬ ┬──────────────────── ─────────5└ ┘──ACQNUM(data-area) └ ┘──ACQSTATUS(cvda) └ ┘──CONVNUM(data-area)
5─ ──┬ ┬─────────────────── ──┬ ┬──────────────────────── ──┬ ┬───────────────── ─────5└ ┘──INSTLSTATUS(cvda) └ ┘──LASTACQCODE(data-area) └ ┘──POOL(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬───────────── ──┬ ┬───────────────────── ─────────────5└ ┘──SERVSTATUS(cvda) └ ┘──STATE(cvda) └ ┘──USERDATA(data-area)
5─ ──┬ ┬──────────────────────── ─5%└ ┘──WAITCONVNUM(data-area)
Conditions:END, ILLOGIC, INVREQ, NOTAUTH
FEPI INQUIRE NODE
55─ ──FEPI INQUIRE ──NODE(data-value) ──┬ ┬─────────────────── ─────────────────────5└ ┘──ACQNUM(data-area)
5─ ──┬ ┬───────────────── ──┬ ┬─────────────────── ──┬ ┬──────────────────────── ─────5└ ┘──ACQSTATUS(cvda) └ ┘──INSTLSTATUS(cvda) └ ┘──LASTACQCODE(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬───────────────────── ─5%└ ┘──SERVSTATUS(cvda) └ ┘──USERDATA(data-area)
Conditions:END, ILLOGIC, INVREQ, NOTAUTH
FEPI INQUIRE POOL
55─ ──FEPI INQUIRE ──POOL(data-value) ──┬ ┬───────────────────────── ───────────────5└ ┘──BEGINSESSION(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────────── ──────────5└ ┘──CONTENTION(cvda) └ ┘──DEVICE(cvda) └ ┘──ENDSESSION(data-area)
5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────────── ──┬ ┬────────────── ────5└ ┘──EXCEPTIONQ(data-area) └ ┘──FJOURNALNUM(data-area) └ ┘──FORMAT(cvda)
5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────── ──┬ ┬─────────────────────── ────5└ ┘──INITIALDATA(cvda) └ ┘──INSTLSTATUS(cvda) └ ┘──MAXFLENGTH(data-area)
5─ ──┬ ┬─────────────── ──┬ ┬──────────────────────── ──┬ ┬────────────────── ────────5└ ┘──MSGJRNL(cvda) └ ┘──PROPERTYSET(data-area) └ ┘──SERVSTATUS(cvda)
5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ──┬ ┬─────────────────── ───────5└ ┘──STSN(data-area) └ ┘──UNSOLDATA(data-area) └ ┘──UNSOLDATACK(cvda)
5─ ──┬ ┬───────────────────── ──┬ ┬──────────────────────── ─5%└ ┘──USERDATA(data-area) └ ┘──WAITCONVNUM(data-area)
Conditions:END, ILLOGIC, INVREQ, NOTAUTH
Chapter 6. FEPI command reference 219
FEPI programming
FEPI INQUIRE PROPERTYSET
55─ ──FEPI INQUIRE ──PROPERTYSET(data-value) ──┬ ┬───────────────────────── ────────5└ ┘──BEGINSESSION(data-area)
5─ ──┬ ┬────────────────── ──┬ ┬────────────── ──┬ ┬─────────────────────── ──────────5└ ┘──CONTENTION(cvda) └ ┘──DEVICE(cvda) └ ┘──ENDSESSION(data-area)
5─ ──┬ ┬─────────────────────── ──┬ ┬──────────────────────── ──┬ ┬────────────── ────5└ ┘──EXCEPTIONQ(data-area) └ ┘──FJOURNALNUM(data-area) └ ┘──FORMAT(cvda)
5─ ──┬ ┬─────────────────── ──┬ ┬─────────────────────── ──┬ ┬─────────────── ────────5└ ┘──INITIALDATA(cvda) └ ┘──MAXFLENGTH(data-area) └ ┘──MSGJRNL(cvda)
5─ ──┬ ┬───────────────── ──┬ ┬────────────────────── ──┬ ┬─────────────────── ─5%└ ┘──STSN(data-area) └ ┘──UNSOLDATA(data-area) └ ┘──UNSOLDATACK(cvda)
Conditions:END, ILLOGIC, INVREQ, NOTAUTH
FEPI INQUIRE TARGET
55─ ──FEPI INQUIRE ──TARGET(data-value) ──┬ ┬───────────────── ─────────────────────5└ ┘──APPL(data-area)
5─ ──┬ ┬─────────────────── ──┬ ┬────────────────── ──┬ ┬───────────────────── ─5%└ ┘──INSTLSTATUS(cvda) └ ┘──SERVSTATUS(cvda) └ ┘──USERDATA(data-area)
Conditions:END, ILLOGIC, INVREQ, NOTAUTH
FEPI INSTALL NODELIST
55─ ──FEPI INSTALL ──NODELIST(data-area) ──NODENUM(data-value) ────────────────────5
┌ ┐─ACQUIRED──────── ┌ ┐─INSERVICE────────5─ ──┼ ┼───────────────── ──┬ ┬───────────────────────── ──┼ ┼────────────────── ─5%
├ ┤──ACQSTATUS(cvda) └ ┘──PASSWORDLIST(data-area) ├ ┤──SERVSTATUS(cvda) └ ┘─RELEASED──────── └ ┘─OUTSERVICE───────
Conditions: INVREQ, NOTAUTH
FEPI INSTALL POOL
55─ ──FEPI INSTALL ──POOL(data-value) ──PROPERTYSET(data-value) ───────────────────5
┌ ┐─ACQUIRED────────5─ ──┼ ┼───────────────── ──┬ ┬────────────────────────────────────────── ──────────5
├ ┤──ACQSTATUS(cvda) └ ┘──NODELIST(data-area) ──NODENUM(data-value) └ ┘─RELEASED────────
┌ ┐─INSERVICE────────5─ ──┼ ┼────────────────── ──┬ ┬────────────────────────────────────────────── ─5%
├ ┤──SERVSTATUS(cvda) └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value) └ ┘─OUTSERVICE───────
Conditions: INVREQ, NOTAUTH
220 CICS User’s Handbook
FEPI programming
FEPI INSTALL PROPERTYSET
55─ ──FEPI INSTALL ──PROPERTYSET(data-value) ──┬ ┬────────────────────────── ───────5└ ┘──BEGINSESSION(data-value)
┌ ┐─LOSE───────────── ┌ ┐─T3278M2──────5─ ──┼ ┼────────────────── ──┼ ┼────────────── ──┬ ┬──────────────────────── ─────────5
├ ┤──CONTENTION(cvda) ├ ┤──DEVICE(cvda) └ ┘──ENDSESSION(data-value) └ ┘─WIN────────────── ├ ┤─T3278M3────── ├ ┤─T3278M4────── ├ ┤─T3278M5────── ├ ┤─T3279M2────── ├ ┤─T3279M3────── ├ ┤─T3279M4────── ├ ┤─T3279M5────── ├ ┤─TPS55M2────── ├ ┤─TPS55M3────── ├ ┤─TPS55M4────── └ ┘─LUP──────────
5─ ──┬ ┬──────────────────────── ──┬ ┬───────────────────────── ────────────────────5└ ┘──EXCEPTIONQ(data-value) └ ┘──FJOURNALNUM(data-value)
┌ ┐─FORMATTED──── ┌ ┐─NOTINBOUND────────5─ ──┼ ┼────────────── ──┼ ┼─────────────────── ──┬ ┬──────────────────────── ────────5
├ ┤──FORMAT(cvda) ├ ┤──INITIALDATA(cvda) └ ┘──MAXFLENGTH(data-value) └ ┘─DATASTREAM─── └ ┘─INBOUND───────────
┌ ┐─NOMSGJRNL─────5─ ──┼ ┼─────────────── ──┬ ┬────────────────── ────────────────────────────────────5
├ ┤──MSGJRNL(cvda) └ ┘──STSN(data-value) ├ ┤─INPUT───────── ├ ┤─OUTPUT──────── └ ┘─INOUT─────────
5─ ──┬ ┬────────────────────────────────────────────── ─5% │ │┌ ┐─NEGATIVE────────── └ ┘──UNSOLDATA(data-value) ──┼ ┼──UNSOLDATACK(cvda) └ ┘─POSITIVE──────────
Conditions: INVREQ, NOTAUTH
FEPI INSTALL TARGETLIST
55─ ──FEPI INSTALL ──TARGETLIST(data-area) ──APPLLIST(data-area) ──────────────────5
┌ ┐─INSERVICE────────5─ ──TARGETNUM(data-value) ──┼ ┼────────────────── ─5%
├ ┤──SERVSTATUS(cvda) └ ┘─OUTSERVICE───────
Conditions: INVREQ, NOTAUTH
Chapter 6. FEPI command reference 221
FEPI programming
FEPI SET CONNECTION
55─ ──FEPI SET CONNECTION ──┬ ┬──NODE(data-value) ──────────────────────── ─────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value)
5─ ──┬ ┬──TARGET(data-value) ────────────────────────── ──┬ ┬───────────────── ──────5 └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value) ├ ┤──ACQSTATUS(cvda) ├ ┤─ACQUIRED──────── └ ┘─RELEASED────────
5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)
├ ┤─INSERVICE──────── └ ┘─OUTSERVICE───────
Conditions: INVREQ, NOTAUTH
FEPI SET NODE
55─ ──FEPI SET ──┬ ┬──NODE(data-value) ──────────────────────── ────────────────────5 └ ┘──NODELIST(data-area) ──NODENUM(data-value)
5─ ──┬ ┬───────────────── ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──ACQSTATUS(cvda) ├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)
├ ┤─ACQUIRED──────── ├ ┤─INSERVICE──────── └ ┘─RELEASED──────── └ ┘─OUTSERVICE───────
Conditions: INVREQ, NOTAUTH
FEPI SET POOL
55─ ──FEPI SET ──┬ ┬──POOL(data-value) ──────────────────────── ────────────────────5 └ ┘──POOLLIST(data-area) ──POOLNUM(data-value)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)
├ ┤─INSERVICE──────── └ ┘─OUTSERVICE───────
Conditions: INVREQ, NOTAUTH
FEPI SET TARGET
55─ ──FEPI SET ──┬ ┬──TARGET(data-value) ────────────────────────── ────────────────5 └ ┘──TARGETLIST(data-area) ──TARGETNUM(data-value)
5─ ──┬ ┬────────────────── ──┬ ┬────────────────────── ─5%├ ┤──SERVSTATUS(cvda) └ ┘──USERDATA(data-value)
├ ┤─INSERVICE──────── └ ┘─OUTSERVICE───────
Conditions: INVREQ, NOTAUTH
222 CICS User’s Handbook
FEPI programming
FEPI SP NOOP
55─ ──FEPI SP NOOP ─5%
Conditions: INVREQ, NOTAUTH
Chapter 6. FEPI command reference 223
Chapter 7. CICS-value data areas used by allcommands
This section lists the CICS-value data-area (CVDA) values and their numericequivalents for all of the EXEC CICS commands. CVDAs are described inthe CICS System Programming Reference.
This section consists of three tables:
� one, in alphabetic sequence of the CVDA values;� one, (beginning on page 233) in numeric sequence of the CVDA
values;� and one, (beginning on page 240) gives the CVDA values returned by
the INQUIRE TERMINAL|NETNAME DEVICE command.
CVDAs and numeric values in alphabetic sequenceCVDA Value CVDA Value
ABEND 900 ASSEMBLER 150ACQFAIL 515 ATI 75ACQUIRED 69 ATTENTION 524ACQUIRING 71 AUDALARM 395ACTIVE 181 AUTOACTIVE 630
| ACTIVITY| 1002 AUTOARCH 262ADD 291 AUTOCONN 170ADDABLE 41 AUTOINACTIVE 631ADDFAIL 519 AUTOPAGEABLE 80ADVANCE 265 AUTOSTART 618ALARM 501 AUXILIARY 247ALLCONN 169 AUXPAUSE 313ALLOCATED 81 AUXSTART 312ALLQUERY 431 AUXSTOP 314ALTERABLE 52 AVAILABLE 95ALTERNATE 197 BACKOUT 192ALTPRTCOPY 446 BACKTRANS 397
| AND| 1005 BACKUPNONBWO 800ANY 158 BASE 10APLKYBD 391| BASEAPI| 1052APLTEXT 393 BASESPACE 664APPC 124 BDAM 2APPCPARALLEL 374 BEGINSESSION 510APPCSINGLE 373 BELOW 159
| APPEND| 1036 BGAM 63APPLICATION 559| BINARY| 1038ASACTL 224 BLK 47ASCII7 616 BLOCKED 16ASCII8 617 BROWSABLE 39
Copyright IBM Corp. 1989, 1999 225
CVDA Value CVDA Value
BSAM 61 CONVERSE 600BTAM 62 CONVIDLE 518BUSY 612 COORDINATOR 770C 149 COPID 908CACHE 791 COPY 401CANCEL 526 CREATE 67CANCELLED 624 CSIGN 905
| CANCELLING| 1025 CTERM 906CD 491 CTLGALL 632CEDF 370 CTLGMODIFY 633
| CFTABLE| 833 CTLGNONE 634CGROUP 902 CTRLABLE 56CICS 660 CTX 907CICSDATAKEY 379 CURRENT 260CICSEXECKEY 381 CUSERID 909CICSTABLE 101 DAE 684
| CKOPEN| 1055 DATA 508CLEAR 640 DATASET 756
| CLIENTAUTH| 1032 DATASETFULL 793CLOSED 19 DATASTREAM 543CLOSELEAVE 261 DEADLOCK 794CLOSEREQUEST 22| DEBUG| 1082CLOSING 21 DEC 46CMDPROT 673 DEFAULT 198CMDSECNO 205 DEFRESP1 497CMDSECYES 207 DEFRESP1OR2 528COBOL 151 DEFRESP2 498COBOLII 375 DEFRESP3 499COLD 788 DELAY 637COLDACQ 72 DELETABLE 43COLDQUERY 433| DELETE| 292COLDSTART 266 DELETEFAIL 520COLOR 399 DELEXITERROR 795COMMIT 208 DEREGERROR 679COMMITFAIL 792 DEREGISTERED 678
| COMPLETE| 1026 DEST 235| COMPOSITE| 1003 DISABLED 24
CONFFREE 82 DISABLING 25CONFRECEIVE 83 DISCARDFAIL 513CONFSEND 84 DISCREQ 444CONNECT 903 DISCONNING 910CONNECTED 690 DISK1 252CONNECTING 904 DISK2 253CONNECTION 755 DISK2PAUSE 254CONSISTENT 723 DISPATCHABLE 228CONSOLE 66| DORMANT| 1024
| CONTENTION| 836 DPLSUBSET 383CONTROLSHUT 623 DS3270 615
226 CICS User’s Handbook
CVDA Value CVDA Value
DUALCASE 403 FORMFEED 407DUMMY 781 FOUTPUT 271DYNAMIC 178 FREE 85EB 490 FREEING 94
| EBCDIC| 1039 FULL 212EMERGENCY 268 FULLAPI 384EMPTY 210| FULLAUTO| 1073EMPTYREQ 31 FWDRECOVABLE 354ENABLED 23 GENERIC 651ENDAFFINITY 790 GMT 604EQUAL 911 GOINGOUT 172ESDS 5 GROUP 913EVENT 334 GTFSTART 317
| EVENTFAIL| 1012 GTFSTOP 318EXCEPT 332 HEURBACKOUT 758EXCEPTRESP 523 HEURCOMMIT 757EXCI 650 HEX 45EXCTL 48 HFORM 409EXECENQ 751 HIGH 914EXECENQADDR 752 HILIGHT 413EXIT 912 HOLD 163EXITTRACE 362| HTTPNO| 1034
| EXPIRED| 1017| HTTPYES| 1033EXTENDEDDS 405 IGNORE 1EXTRA 221 IGNORERR 816EXTSECURITY 194 IMMCLOSE 350FAILED 782 IMMCLOSING 352FAILEDBKOUT 357 IMMQUIESCED 706FAILINGBKOUT 358 INACTIVE 378FCLOSE 273 INBOUND 547FINALQUIESCE 183| INCOMPLETE| 1014FINPUT 270 INDEXRECFULL 796
| FIRED| 1001 INDIRECT 122FIRSTINIT 625 INDOUBT 620FIRSTQUIESCE 182 INFLIGHT 621FIXED 12 INITCOMPLETE 628FLUSH 783 INITIAL 789FMH 502 INOUT 532FMHPARM 385 INPUT 226FOPEN 272 INSERVICE 73FORCE 342 INSTALLED 550
| FORCECANCEL| 655 INSTALLFAIL 512FORCECLOSE 351| INTERNAL| 1058FORCECLOSING 353 INTRA 222
| FORCED| 1013 INTSTART 310FORCEPURGE 237 INTSTOP 311FORMATEDF 606 INVALID 359FORMATTED 542 IOERROR 797
Chapter 7. CICS-value data areas used by all commands 227
CVDA Value CVDA Value
IRC 121 NOCMDPROT 674ISOLATE 658 NOCOLOR 400
| JVM| 1080 NOCONNECT 916KATAKANA 415 NOCONV 556KEYED 8 NOCONVERSE 601KSDS 6 NOCOPY 402
| LCKSTRUCFULL| 832 NOCREATE 68LEAVE 811 NOCTL 223LE370 377 NODAE 685LIC 493| NODEBUG| 1083LIGHTPEN 417 NODISCREQ 445
| LOAD| 834 NODUALCASE 404LOCAL 605 NOEMPTYREQ 32
| LOCKING| 837 NOEVENT 335LOG 54 NOEXCEPT 333LOGICAL 216 NOEXCTL 49LOGTERM 269 NOEXIT 917LOSE 544 NOEXITTRACE 363LOW 915 NOEXTENDEDDS 406LPA 165 NOFMH 503LUP 541 NOFMHPARM 386LUSTAT 525| NOFORCE| 1054LU61 125 NOFORMATEDF 607MAIN 248 NOFORMFEED 408MAP 155 NOHFORM 410MAPSET 155 NOHILIGHT 414MCHCTL 241 NOHOLD 164MDT 506 NOISOLATE 657MOD 813| NOJVM| 1081MODEL 370 NOKATAKANA 416MORE 492 NOLIGHTPEN 418MSRCONTROL 419| NOLOAD| 835MVS 780 NOLOG 55NEGATIVE 530 NOLOSTLOCKS 710NEWCOPY 167 NOMDT 507NEWSESSION 485 NOMSGJRNL 531NOALARM 500 NOMSRCONTROL 420NOALTPRTCOPY 447 NONAUTOCONN 171NOAPLKYBD 392 NONCICS 661NOAPLTEXT 394 NONE 496
| NOAPPEND| 1037| NONLE370| 1084NOATI 76 NOOBFORMAT 422NOAUDALARM 396 NOOBOPERID 388
| NOAUTO| 1071 NOOUTLINE 424NOAUTOARCH 263 NOPARTITIONS 426NOBACKTRANS 398 NOPERF 331NOCEDF 371 NOPRESETSEC 243NOCLEAR 641 NOPRINTADAPT 428
228 CICS User’s Handbook
CVDA Value CVDA Value
NOPROGSYMBOL 430 NOTRANDUMP 187NOPRTCOPY 449 NOTREADABLE 36NOQUERY 432 NOTREADY 259NORECOVDATA 700 NOTRECOVABLE 30NOREENTPROT 681 NOTREQUIRED 667NORELEASE 918 NOTRLS 721NORELREQ 443| NOTROUTABLE| 1022NORETAINED 711 NOTSOS 669
| NORMAL| 1016 NOTSUPPORTED 15NORMALBKOUT 356| NOTSUSPENDED| 1027NORMALRESP 522 NOTTABLE 100NOROLLBACK 919 NOTTI 78NOSECURITY 196 NOTUPDATABLE 38NOSHUTDOWN 289 NOTWAIT 920NOSOSI 435 NOUCTRAN 451NOSPI 694| NOUSER| 1011
| NOSSL| 1031 NOVALIDATION 441NOSTSN 487 NOVFORM 412NOSWITCH 285 NOWAIT 341NOSYNCPOINT 603 NOWRITE 275NOSYSCONNECT 654 NOZCPTRACE 365NOSYSDUMP 185 NRS 774NOSYSLOG 784 N906 931NOTADDABLE 42 N906D 921NOTALTERABLE 53 OBFORMAT 421NOTAPPLIC 1 OBOPERID 387NOTASKSTART 608 OBTAINING 96NOTBROWSABLE 40 OFF 200NOTBUSY 613 OK 274NOTCDEB 495 OLD 26NOTCONNECTED 691 OLDCOPY 162NOTCTRLABLE 57 OLDSESSION 486NOTDEFINED 659 ON 201NOTDELETABLE 44 OPEN 18
| NOTDYNAMIC| 1021| OPENAPI| 1053NOTEMPTY 211 OPENERROR 798NOTERMINAL 214 OPENING 20NOTEXTKYBD 437 OPENOUTPUT 257NOTEXTPRINT 439 OPID 933
| NOTFIRED| 1000| OR| 1006NOTFWDRCVBLE 361 OUTLINE 423NOTINBOUND 546 OUTPUT 227NOTINIT 376 OUTSERVICE 74NOTINSTALLED 551 OWNER 753NOTKEYED 9 PAGEABLE 79NOTLPA 166 PARTITIONS 425NOTPENDING 127 PARTITIONSET 156NOTPURGEABLE 161 PATH 11
Chapter 7. CICS-value data areas used by all commands 229
CVDA Value CVDA Value
PENDBEGIN 558 REGISTERED 670PENDDATA 560 REJECT 815PENDFREE 86 RELATED 675PENDING 126 RELEASE 563PENDPASS 565 RELEASED 70PENDRECEIVE 87 RELEASING 549PENDRELEASE 562 RELREQ 442PENDSTART 561 REMLOSTLOCKS 713PENDSTSN 557 REMOTE 4PENDUNSOL 564 REMOVE 276PERF 330 REMSESSION 740PHASEIN 168| REMTABLE| 103PHYSICAL 215 REPEATABLE 724PLI 152 REQUIRED 666PL1 152 REREAD 812POOL 922 RESET 290POSITIVE 529 RESETLOCKS 714POST 636| RESSECINT| 203PRESETSEC 242 RESSECNO 202PRIMARY 110 RESSECYES 204PRINTADAPT 427 RESYNC 702PRIVATE 174 RETAINED 715
| PROCESS| 1010 RETRY 716| PROGAUTO| 1072 REVERTED 264
PROGRAM 154 REWIND 811PROGSYMBOL 429 RLS 720PROTECTED 504 RLSACTIVE 730PRTCOPY 448 RLSGONE 799PURGE 236 RLSINACTIVE 731PURGEABLE 160 RLSSERVER 761
| QUASIRENT| 1050 RMI 771QUEUE 814 ROLLBACK 89QUIESCED 707 ROUTE 638QUIESCING 708| ROUTABLE| 1023
| QR| 1057| RRCOMMITFAIL| 830READABLE 35 RRDS 7READBACK 209| RRINDOUBT| 831READONLY 275 RTR 527READY 258 RU 494REBUILD 923 RUNNING 229RECEIVE 88 SCS 614RECONNECT 924 SECONDINIT 626RECOVDATA 701 SEND 90RECOVERABLE 29 SESSION 372RECOVERED 277 SESSIONFAIL 517RECOVERLOCKS 712 SESSIONLOST 516REENTPROT 680 SETFAIL 514REGERROR 677 SHARE 27
230 CICS User’s Handbook
CVDA Value CVDA Value
SHARED 173 SYSTEM 643SHUNTED 762 SYSTEMOFF 320SHUTDISABLED 645 SYSTEMON 319SHUTDOWN 288 TAKEOVER 111SHUTENABLED 644 TAPE1 250SIGN 925 TAPE2 251SIGNEDOFF 245 TASK 233SIGNEDON 244 TASKSTART 611SINGLEOFF 324 TCAM 64SINGLEON 323 TCAMSNA 65SKIP 810 TCEXITALL 366SMF 255 TCEXITALLOFF 369SOS 668 TCEXITNONE 368SOSABOVE 683 TCEXITSYSTEM 367SOSBELOW 682 TDQ 767SOSI 434 TERM 234SPECIFIC 652 TERMINAL 213SPECTRACE 177 TEXTKYBD 436SPI 693 TEXTPRINT 438SPRSTRACE 175 THIRDINIT 627SQLCODE 926| THREADSAFE| 1051
| SSL| 1030 TIMEOUT 511STANDBY 629| TIMER| 1004STANTRACE 176 TPOOL 932START 635 TPS55M3 553STARTED 609 TPS55M4 554STARTING 772 TPS55M5 555STARTUP 180 TRANDUMP 186STATIC 179 TRANIDONLY 452STOPPED 610 TSQ 768STSN 509 TTI 77STSNSET 488 TX 929STSNTEST 489 TXID 928SUBORDINATE 773 TWAIT 927SUBSPACE 663 T3278M2 533SURROGATE 371 T3278M3 534SUSPENDED 231 T3278M4 535SWITCH 188 T3278M5 536SWITCHALL 287 T3279M2 537SWITCHING 225 T3279M3 538SWITCHNEXT 286 T3279M4 539SYNCFREE 91 T3279M5 540
| SYNCPOINT| 602 UCTRAN 450SYNCRECEIVE 92| UKOPEN| 1056SYNCSEND 93| UNATTEMPTED| 820SYSCONNECT 653 UNAVAILABLE 672SYSDUMP 184 UNBLOCKED 17SYSLOG 785 UNCOMMITTED 722
Chapter 7. CICS-value data areas used by all commands 231
CVDA Value
| UNCONNECTED| 703UNDEFINED 14UNDETERMINED 355UNENABLED 33
| UNENABLING| 34| UNEXPECTED| 1015| UNEXPIRED| 1018
UNPROTECTED 505UNQUIESCED 709UNREGISTERED 671UNSOLDATA 521
| UOW| 246UPDATABLE 37USER 642USERDATAKEY 380USEREXECKEY 382USERID 930USEROFF 322USERON 321USERTABLE 102VALID 360VALIDATION 440VARIABLE 13VFORM 411VRRDS 732VSAM 3VTAM 60WAIT 340WAITCOMMIT 763WAITER 754WAITFORGET 622WAITING 765WAITRMI 766WARMSTART 267WIN 545XCF 665XM 123XNOTDONE 144XOK 143ZCPTRACE 364
232 CICS User’s Handbook
CVDAs and numeric values in numeric sequenceValue CVDA Value CVDA
1 IGNORE 47 BLK1 NOTAPPLIC 48 EXCTL2 BDAM 49 NOEXCTL3 VSAM 52 ALTERABLE4 REMOTE 53 NOTALTERABLE5 ESDS 54 LOG6 KSDS 55 NOLOG7 RRDS 56 CTRLABLE8 KEYED 57 NOTCTRLABLE9 NOTKEYED 60 VTAM
10 BASE 61 BSAM11 PATH 62 BTAM12 FIXED 63 BGAM13 VARIABLE 64 TCAM14 UNDEFINED 65 TCAMSNA15 NOTSUPPORTED 66 CONSOLE16 BLOCKED 67 CREATE17 UNBLOCKED 68 NOCREATE18 OPEN 69 ACQUIRED19 CLOSED 70 RELEASED20 OPENING 71 ACQUIRING21 CLOSING 72 COLDACQ22 CLOSEREQUEST 73 INSERVICE23 ENABLED 74 OUTSERVICE24 DISABLED 75 ATI25 DISABLING 76 NOATI26 OLD 77 TTI27 SHARE 78 NOTTI29 RECOVERABLE 79 PAGEABLE30 NOTRECOVABLE 80 AUTOPAGEABLE31 EMPTYREQ 81 ALLOCATED32 NOEMPTYREQ 82 CONFFREE33 UNENABLED 83 CONFRECEIVE
| 34| UNENABLING 84 CONFSEND35 READABLE 85 FREE36 NOTREADABLE 86 PENDFREE37 UPDATABLE 87 PENDRECEIVE38 NOTUPDATABLE 88 RECEIVE39 BROWSABLE 89 ROLLBACK40 NOTBROWSABLE 90 SEND41 ADDABLE 91 SYNCFREE42 NOTADDABLE 92 SYNCRECEIVE43 DELETABLE 93 SYNCSEND44 NOTDELETABLE 94 FREEING45 HEX 95 AVAILABLE46 DEC 96 OBTAINING
Chapter 7. CICS-value data areas used by all commands 233
Value CVDA Value CVDA
100 NOTTABLE 182 FIRSTQUIESCE101 CICSTABLE 183 FINALQUIESCE102 USERTABLE 184 SYSDUMP
| 103| REMTABLE 185 NOSYSDUMP110 PRIMARY 186 TRANDUMP111 TAKEOVER 187 NOTRANDUMP121 IRC 188 SWITCH122 INDIRECT 192 BACKOUT123 XM 194 EXTSECURITY124 APPC 196 NOSECURITY125 LU61 197 ALTERNATE126 PENDING 198 DEFAULT127 NOTPENDING 200 OFF143 XOK 201 ON144 XNOTDONE 202 RESSECNO149 C | 203| RESSECINT150 ASSEMBLER 204 RESSECYES151 COBOL 205 CMDSECNO152 PLI 207 CMDSECYES152 PL1 208 COMMIT154 PROGRAM 209 READBACK155 MAP 210 EMPTY155 MAPSET 211 NOTEMPTY156 PARTITIONSET 212 FULL158 ANY 213 TERMINAL159 BELOW 214 NOTERMINAL160 PURGEABLE 215 PHYSICAL161 NOTPURGEABLE 216 LOGICAL162 OLDCOPY 221 EXTRA163 HOLD 222 INTRA164 NOHOLD 223 NOCTL165 LPA 224 ASACTL166 NOTLPA 225 SWITCHING167 NEWCOPY 226 INPUT168 PHASEIN 227 OUTPUT169 ALLCONN 228 DISPATCHABLE170 AUTOCONN 229 RUNNING171 NONAUTOCONN 231 SUSPENDED172 GOINGOUT 233 TASK173 SHARED 234 TERM174 PRIVATE 235 DEST175 SPRSTRACE 236 PURGE176 STANTRACE 237 FORCEPURGE177 SPECTRACE 241 MCHCTL178 DYNAMIC 242 PRESETSEC179 STATIC 243 NOPRESETSEC180 STARTUP 244 SIGNEDON181 ACTIVE 245 SIGNEDOFF
234 CICS User’s Handbook
Value CVDA Value CVDA
| 246| UOW 321 USERON247 AUXILIARY 322 USEROFF248 MAIN 323 SINGLEON250 TAPE1 324 SINGLEOFF251 TAPE2 330 PERF252 DISK1 331 NOPERF253 DISK2 332 EXCEPT254 DISK2PAUSE 333 NOEXCEPT255 SMF 334 EVENT257 OPENOUTPUT 335 NOEVENT258 READY 340 WAIT259 NOTREADY 341 NOWAIT260 CURRENT 342 FORCE261 CLOSELEAVE 350 IMMCLOSE262 AUTOARCH 351 FORCECLOSE263 NOAUTOARCH 352 IMMCLOSING264 REVERTED 353 FORCECLOSING265 ADVANCE 354 FWDRECOVABLE266 COLDSTART 355 UNDETERMINED267 WARMSTART 356 NORMALBKOUT268 EMERGENCY 357 FAILEDBKOUT269 LOGTERM 358 FAILINGBKOUT270 FINPUT 359 INVALID271 FOUTPUT 360 VALID272 FOPEN 361 NOTFWDRCVBLE273 FCLOSE 362 EXITTRACE274 OK 363 NOEXITTRACE275 NOWRITE 364 ZCPTRACE275 READONLY 365 NOZCPTRACE276 REMOVE 366 TCEXITALL277 RECOVERED 367 TCEXITSYSTEM285 NOSWITCH 368 TCEXITNONE286 SWITCHNEXT 369 TCEXITALLOFF287 SWITCHALL 370 CEDF288 SHUTDOWN 370 MODEL289 NOSHUTDOWN 371 NOCEDF290 RESET 371 SURROGATE291 ADD 372 SESSION
| 292| DELETE 373 APPCSINGLE310 INTSTART 374 APPCPARALLEL311 INTSTOP 375 COBOLII312 AUXSTART 376 NOTINIT313 AUXPAUSE 377 LE370314 AUXSTOP 378 INACTIVE317 GTFSTART 379 CICSDATAKEY318 GTFSTOP 380 USERDATAKEY319 SYSTEMON 381 CICSEXECKEY320 SYSTEMOFF 382 USEREXECKEY
Chapter 7. CICS-value data areas used by all commands 235
Value CVDA Value CVDA
383 DPLSUBSET 433 COLDQUERY384 FULLAPI 434 SOSI385 FMHPARM 435 NOSOSI386 NOFMHPARM 436 TEXTKYBD387 OBOPERID 437 NOTEXTKYBD388 NOOBOPERID 438 TEXTPRINT391 APLKYBD 439 NOTEXTPRINT392 NOAPLKYBD 440 VALIDATION393 APLTEXT 441 NOVALIDATION394 NOAPLTEXT 442 RELREQ395 AUDALARM 443 NORELREQ396 NOAUDALARM 444 DISCREQ397 BACKTRANS 445 NODISCREQ398 NOBACKTRANS 446 ALTPRTCOPY399 COLOR 447 NOALTPRTCOPY400 NOCOLOR 448 PRTCOPY401 COPY 449 NOPRTCOPY402 NOCOPY 450 UCTRAN403 DUALCASE 451 NOUCTRAN404 NODUALCASE 452 TRANIDONLY405 EXTENDEDDS 485 NEWSESSION406 NOEXTENDEDDS 486 OLDSESSION407 FORMFEED 487 NOSTSN408 NOFORMFEED 488 STSNSET409 HFORM 489 STSNTEST410 NOHFORM 490 EB411 VFORM 491 CD412 NOVFORM 492 MORE413 HILIGHT 493 LIC414 NOHILIGHT 494 RU415 KATAKANA 495 NOTCDEB416 NOKATAKANA 496 NONE417 LIGHTPEN 497 DEFRESP1418 NOLIGHTPEN 498 DEFRESP2419 MSRCONTROL 499 DEFRESP3420 NOMSRCONTROL 500 NOALARM421 OBFORMAT 501 ALARM422 NOOBFORMAT 502 FMH423 OUTLINE 503 NOFMH424 NOOUTLINE 504 PROTECTED425 PARTITIONS 505 UNPROTECTED426 NOPARTITIONS 506 MDT427 PRINTADAPT 507 NOMDT428 NOPRINTADAPT 508 DATA429 PROGSYMBOL 509 STSN430 NOPROGSYMBOL 510 BEGINSESSION431 ALLQUERY 511 TIMEOUT432 NOQUERY 512 INSTALLFAIL
236 CICS User’s Handbook
Value CVDA Value CVDA
513 DISCARDFAIL 562 PENDRELEASE514 SETFAIL 563 RELEASE515 ACQFAIL 564 PENDUNSOL516 SESSIONLOST 565 PENDPASS517 SESSIONFAIL 600 CONVERSE518 CONVIDLE 601 NOCONVERSE519 ADDFAIL 602 SYNCPOINT520 DELETEFAIL 603 NOSYNCPOINT521 UNSOLDATA 604 GMT522 NORMALRESP 605 LOCAL523 EXCEPTRESP 606 FORMATEDF524 ATTENTION 607 NOFORMATEDF525 LUSTAT 608 NOTASKSTART526 CANCEL 609 STARTED527 RTR 610 STOPPED528 DEFRESP1OR2 611 TASKSTART529 POSITIVE 612 BUSY530 NEGATIVE 613 NOTBUSY531 NOMSGJRNL 614 SCS532 INOUT 615 DS3270533 T3278M2 616 ASCII7534 T3278M3 617 ASCII8535 T3278M4 618 AUTOSTART536 T3278M5 620 INDOUBT537 T3279M2 621 INFLIGHT538 T3279M3 622 WAITFORGET539 T3279M4 623 CONTROLSHUT540 T3279M5 624 CANCELLED541 LUP 625 FIRSTINIT542 FORMATTED 626 SECONDINIT543 DATASTREAM 627 THIRDINIT544 LOSE 628 INITCOMPLETE545 WIN 629 STANDBY546 NOTINBOUND 630 AUTOACTIVE547 INBOUND 631 AUTOINACTIVE549 RELEASING 632 CTLGALL550 INSTALLED 633 CTLGMODIFY551 NOTINSTALLED 634 CTLGNONE552 TPS55M2 635 START553 TPS55M3 636 POST554 TPS55M4 637 DELAY555 TPS55M5 638 ROUTE556 NOCONV 640 CLEAR557 PENDSTSN 641 NOCLEAR558 PENDBEGIN 642 USER559 APPLICATION 643 SYSTEM560 PENDDATA 644 SHUTENABLED561 PENDSTART 645 SHUTDISABLED
Chapter 7. CICS-value data areas used by all commands 237
Value CVDA Value CVDA
650 EXCI 713 REMLOSTLOCKS651 GENERIC 714 RESETLOCKS652 SPECIFIC 715 RETAINED653 SYSCONNECT 716 RETRY654 NOSYSCONNECT 720 RLS655 FORCECANCEL 721 NOTRLS657 NOISOLATE 722 UNCOMMITTED658 ISOLATE 723 CONSISTENT659 NOTDEFINED 724 REPEATABLE660 CICS 730 RLSACTIVE661 NONCICS 731 RLSINACTIVE663 SUBSPACE 732 VRRDS664 BASESPACE 740 REMSESSION665 XCF 751 EXECENQ666 REQUIRED 752 EXECENQADDR667 NOTREQUIRED 753 OWNER668 SOS 754 WAITER669 NOTSOS 755 CONNECTION670 REGISTERED 756 DATASET671 UNREGISTERED 757 HEURCOMMIT672 UNAVAILABLE 758 HEURBACKOUT673 CMDPROT 761 RLSSERVER674 NOCMDPROT 762 SHUNTED675 RELATED 763 WAITCOMMIT677 REGERROR 765 WAITING678 DEREGISTERED 766 WAITRMI679 DEREGERROR 767 TDQ680 REENTPROT 768 TSQ681 NOREENTPROT 770 COORDINATOR682 SOSBELOW 771 RMI683 SOSABOVE 772 STARTING684 DAE 773 SUBORDINATE685 NODAE 774 NRS690 CONNECTED 780 MVS691 NOTCONNECTED 781 DUMMY693 SPI 782 FAILED694 NOSPI 783 FLUSH700 NORECOVDATA 784 NOSYSLOG701 RECOVDATA 785 SYSLOG702 RESYNC 788 COLD703 UNCONNECTED 789 INITIAL706 IMMQUIESCED 790 ENDAFFINITY707 QUIESCED 791 CACHE708 QUIESCING 792 COMMITFAIL709 UNQUIESCED 793 DATASETFULL710 NOLOSTLOCKS 794 DEADLOCK711 NORETAINED 795 DELEXITERROR712 RECOVERLOCKS 796 INDEXRECFULL
238 CICS User’s Handbook
Value CVDA Value CVDA
797 IOERROR 928 TXID798 OPENERROR 929 TX799 RLSGONE 930 USERID800 BACKUPNONBWO 931 N906810 SKIP 932 TPOOL811 REWIND 933 OPID811 LEAVE | 1000| NOTFIRED812 REREAD | 1001| FIRED813 MOD | 1002| ACTIVITY814 QUEUE | 1003| COMPOSITE815 REJECT | 1004| TIMER816 IGNORERR | 1005| AND820 UNATTEMPTED | 1006| OR830 RRCOMMITFAIL | 1010| PROCESS831 RRINDOUBT | 1011| NOUSER832 LCKSTRUCFULL | 1012| EVENTFAIL
| 833| CFTABLE | 1013| FORCED| 834| LOAD | 1014| INCOMPLETE| 835| NOLOAD | 1015| UNEXPECTED| 836| CONTENTION | 1016| NORMAL| 837| LOCKING | 1017| EXPIRED
900 ABEND | 1018| UNEXPIRED902 CGROUP | 1021| NOTDYNAMIC903 CONNECT | 1022| NOTROUTABLE904 CONNECTING | 1023| ROUTABLE905 CSIGN | 1024| DORMANT906 CTERM | 1025| CANCELLING907 CTX | 1026| COMPLETE908 COPID | 1027| NOTSUSPENDED909 CUSERID | 1030| SSL910 DISCONNING | 1031| NOSSL911 EQUAL | 1032| CLIENTAUTH912 EXIT | 1033| HTTPYES913 GROUP | 1034| HTTPNO914 HIGH | 1036| APPEND915 LOW | 1037| NOAPPEND916 NOCONNECT | 1038| BINARY917 NOEXIT | 1039| EBCDIC918 NORELEASE | 1050| QUASIRENT919 NOROLLBACK | 1051| THREADSAFE920 NOTWAIT | 1052| BASEAPI921 N906D | 1053| OPENAPI922 POOL | 1054| NOFORCE923 REBUILD | 1055| CKOPEN924 RECONNECT | 1056| UKOPEN925 SIGN | 1057| QR926 SQLCODE | 1058| INTERNAL927 TWAIT | 1071| NOAUTO
Chapter 7. CICS-value data areas used by all commands 239
Value CVDA
| 1072| PROGAUTO| 1073| FULLAUTO| 1080| JVM| 1081| NOJVM| 1082| DEBUG| 1083| NODEBUG| 1084| NONLE370
CVDA values for the DEVICE optionCVDA sequence CVDA sequence
BATCHLU 191 T3277L 153BIPROG 160 T3277R 145BISYNCH 128 T3284L 155CDRDLPRT 24 T3284R 147CONTNLU 189 T3286L 156HARDCOPY 32 T3286R 148INTACTLU 190 T3600BI 138ISCMMCONV 209 T3601 177LUCMODGRP 210 T3614 178LUCSESS 211 T3650ATT 186LUTYPE4 193 T3650PIPE 184LUTYPE6 192 T3650USER 187MAGTAPE 20 T3653HOST 185RESSYS 208 T3735 136SDLC 176 T3740 137SEQDISK 18 T3780 133SYSTEM3 161 T3790 180SYSTEM7 2 T3790SCSP 182SYS370 164 T3790UP 181SYS7BSCA 166 T7770 1TCONSOLE 8 VIDEOTERM 64TELETYPE 34TTCAM 80TWX3335 33T1050 36T1053 74T2260L 65T2260R 72T2265 76T2740 40T2741BCD 43T2741COR 42T2770 130T2780 132T2980 134T3275R 146
240 CICS User’s Handbook
Numeric sequence Numeric sequence
1 T7770 189 CONTNLU2 SYSTEM7 190 INTACTLU8 TCONSOLE 191 BATCHLU
18 SEQDISK 192 LUTYPE620 MAGTAPE 193 LUTYPE424 CDRDLPRT 208 RESSYS32 HARDCOPY 209 ISCMMCONV33 TWX3335 210 LUCMODGRP34 TELETYPE 211 LUCSESS36 T105040 T274042 T2741COR43 T2741BCD64 VIDEOTERM65 T2260L72 T2260R74 T105376 T226580 TTCAM
128 BISYNCH130 T2770132 T2780133 T3780134 T2980136 T3735137 T3740138 T3600BI145 T3277R146 T3275R147 T3284R148 T3286R153 T3277L155 T3284L156 T3286L160 BIPROG161 SYSTEM3164 SYS370166 SYS7BSCA176 SDLC177 T3601178 T3614180 T3790181 T3790UP182 T3790SCSP184 T3650PIPE185 T3653HOST186 T3650ATT187 T3650USER
Chapter 7. CICS-value data areas used by all commands 241
EIB � EIB field names
Chapter 8. EXEC interface block (EIB)
This chapter contains General-use Programming Interface information.
EIB field names and descriptions
EIB field COBOL C/370 PL/I ASM
EIBAID PIC X(1) char eibaid[1] CHAR(1) CL1EIBATT PIC X(1) char eibatt[1] CHAR(1) CL1EIBCALEN PIC S9(4)
COMPshort int eibcalen FIXED
BIN(15)H
EIBCOMPL PIC X(1) char eibcompl[1] CHAR(1) CL1EIBCONF PIC X(1) char eibconf[1] CHAR(1) CL1EIBCPOSN PIC S9(4)
COMPshort int eibcposn FIXED
BIN(15)H
EIBDATE PIC S9(7)COMP-3
char eibdate[4] FIXEDDEC(7,0)
PL4
EIBDS PIC X(8) char eibds[8] CHAR(8) CL8EIBEOC PIC X(1) char eibeoc[1] CHAR(1) CL1EIBERR PIC X(1) char eiberr[1] CHAR(1) CL1EIBERRCD PIC X(4) char eiberrcd[4] CHAR(4) CL4EIBFMH PIC X(1) char eibfmh[1] CHAR(1) CL1EIBFN PIC X(2) char eibfn[2] CHAR(2) CL2EIBFREE PIC X(1) char eibfree[1] CHAR(1) CL1EIBNODAT PIC X(1) char eibnodat[1] CHAR(1) CL1EIBRCODE PIC X(6) char eibrcode[6] CHAR(6) CL6EIBRECV PIC X(1) char eibrecv[1] CHAR(1) CL1EIBREQID PIC X(8) char eibreqid[8] CHAR(8) CL8EIBRESP PIC S9(8)
COMPlong int eibresp FIXED
BIN(31)F
EIBRESP2 PIC S9(8)COMP
long int eibresp2 FIXEDBIN(31)
F
EIBRLDBK PIC X(1) char eibrldbk[1] CHAR(1) CL1EIBRSRCE PIC X(8) char eibrsrce[8] CHAR(8) CL8EIBSIG PIC X(1) char eibsig[1] CHAR(1) CL1EIBSYNC PIC X(1) char eibsync[1] CHAR(1) CL1EIBSYNRB PIC X(1) char eibsynrb[1] CHAR(1) CL1EIBTASKN PIC S9(7)
COMP-3char eibtaskn[4] FIXED
DEC(7,0)PL4
EIBTIME PIC S9(7)COMP-3
char eibtime[4] FIXEDDEC(7,0)
PL4
EIBTRMID PIC X(4) char eibtrmid[4] CHAR(4) CL4EIBTRNID PIC X(4) char eibtrnid[4] CHAR(4) CL4
Copyright IBM Corp. 1989, 1999 243
EIBFN codes
EIBFN codesNote: In the column Type , API
indicates that the commandis described in the CICSApplication ProgrammingReference, and SPI indicatesthat it is described in theCICS System ProgrammingReference manual. SPI doesnot indicate that the special(SP) translator option isrequired for this command.FEPI indicates commandsused by the CICS/ESA FrontEnd Programming Interface.They are described in theCICS Front EndProgramming InterfaceUser's Guide.
EIBFNvalue
Command Type
X'0422' FREE APIX'0424' POINT APIX'0426' BUILD ATTACH APIX'0428' EXTRACT ATTACH APIX'042A' EXTRACT TCT APIX'042C' WAIT CONVID APIX'042E' EXTRACT PROCESS APIX'0430' ISSUE ABEND APIX'0432' CONNECT PROCESS APIX'0434' ISSUE
CONFIRMATIONAPI
X'0436' ISSUE ERROR APIX'0438' ISSUE PREPARE APIX'043A' ISSUE PASS APIX'043C' EXTRACT
LOGONMSGAPI
X'043E' EXTRACTATTRIBUTES
API
X'0602' READ APIEIBFNvalue
Command Type X'0604' WRITE FILE APIX'0606' REWRITE APIX'0608' DELETE APIX'0202' ADDRESS APIX'060A' UNLOCK APIX'0204' HANDLE CONDITION APIX'060C' STARTBR APIX'0206' HANDLE AID APIX'060E' READNEXT APIX'0208' ASSIGN APIX'0610' READPREV APIX'020A' IGNORE CONDITION APIX'0612' ENDBR APIX'020C' PUSH APIX'0614' RESETBR APIX'020E' POP APIX'0802' WRITEQ TD APIX'0210' ADDRESS SET APIX'0804' READQ TD APIX'0402' RECEIVE APIX'0806' DELETEQ TD APIX'0404' SEND APIX'0A02' WRITEQ TS APIX'0406' CONVERSE APIX'0A04' READQ TS APIX'0408' ISSUE EODS APIX'0A06' DELETEQ TS APIX'040A' ISSUE COPY APIX'0C02' GETMAIN APIX'040C' WAIT TERMINAL APIX'0C04' FREEMAIN APIX'040E' ISSUE LOAD APIX'0E02' LINK APIX'0410' WAIT SIGNAL APIX'0E04' XCTL APIX'0412' ISSUE RESET APIX'0E06' LOAD APIX'0414' ISSUE DISCONNECT APIX'0E08' RETURN APIX'0416' ISSUE ENDOUTPUT APIX'0E0A' RELEASE APIX'0418' ISSUE ERASEAUP APIX'0E0C' ABEND APIX'041A' ISSUE ENDFILE APIX'0E0E' HANDLE ABEND APIX'041C' ISSUE PRINT APIX'1002' ASKTIME APIX'041E' ISSUE SIGNAL APIX'1004' DELAY APIX'0420' ALLOCATE API
244 CICS User’s Handbook
EIBFN codes
EIBFNvalue
Command Type EIBFNvalue
Command Type
X'1006' POST API X'240E' ISSUECONFIRMATION
APIX'1008' START APIX'100A' RETRIEVE API X'2410' ISSUE ERROR APIX'100C' CANCEL API X'2412' ISSUE SIGNAL APIX'1202' WAIT EVENT API X'2414' RECEIVE APIX'1204' ENQ API X'2416' SEND APIX'1206' DEQ API X'2418' WAIT APIX'1208' SUSPEND API X'241A' ISSUE PREPARE APIX'1402' WRITE
JOURNALNUMAPI X'241C' EXTRACT
ATTRIBUTESAPI
X'1404' WAIT JOURNALNUM API X'3002' CREATE PROGRAM SPIX'1406' WRITE
JOURNALNAMEAPI X'3004' CREATE MAPSET SPI
X'3006' CREATEPARTITIONSET
SPIX'1408' WAIT JOURNALNAME APIX'1602' SYNCPOINT API X'3008' CREATE
TRANSACTIONSPI
X'1604' RESYNCENTRYNAME
SPIX'300A' CREATE PROFILE SPI
X'1802' RECEIVE MAP API X'300C' CREATE TYPETERM SPIX'1804' SEND MAP API X'300E' CREATE
CONNECTIONSPI
X'1806' SEND TEXT APIX'1808' SEND PAGE API X'3010' CREATE TERMINAL SPIX'180A' PURGE MESSAGE API X'3012' CREATE SESSIONS SPIX'180C' ROUTE API X'3014' CREATE FILE SPIX'180E' RECEIVE PARTN API X'3016' CREATE LSRPOOL SPIX'1810' SEND PARTNSET API X'3018' CREATE PARTNER SPIX'1812' SEND CONTROL API X'301A' CREATE TRANCLASS SPIX'1C02' DUMP API X'301C' CREATE TDQUEUE SPIX'1E02' ISSUE ADD API X'301E' CREATE
JOURNALMODELSPI
X'1E04' ISSUE ERASE APIX'1E06' ISSUE REPLACE API X'3020' CREATE DB2CONN SPIX'1E08' ISSUE ABORT API X'3022' CREATE DB2ENTRY SPIX'1E0A' ISSUE QUERY API X'3024' CREATE DB2TRAN SPIX'1E0C' ISSUE END API X'3026' CREATE
PROCESSTYPESPI
X'1E0E' ISSUE RECEIVE APIX'1E10' ISSUE NOTE API X'3028' CREATE TSMODEL SPIX'1E12' ISSUE WAIT API X'302A' CREATE ENQMODEL SPIX'1E14' ISSUE SEND API X'302C' CREATE
REQUESTMODELSPI
X'2002' BIF DEEDIT APIX'2202' ENABLE PROGRAM SPI X'302E' CREATE
DOCTEMPLATESPI
X'2204' DISABLE APIX'2206' EXTRACT EXIT SPI X'3030' CREATE
TCPIPSERVICESPI
X'2402' ALLOCATE APIX'2404' ASSIGN API X'3A02' INQ RRMS SPIX'2406' EXTRACT PROCESS API X'4202' INQUIRE
AUTINSTMODELSPI
X'2408' FREE APIX'240A' ISSUE ABEND API X'4210' DISCARD
AUTINSTMODELSPI
X'240C' CONNECT PROCESS API
Chapter 8. EXEC interface block (EIB) 245
EIBFN codes
EIBFNvalue
Command Type EIBFNvalue
Command Type
X'4402' INQUIRE PARTNER SPI X'5C10' DISCARD TDQUEUE SPIX'4410' DISCARD PARTNER SPI X'5E02' INQUIRE TASK SPIX'4602' INQUIRE PROFILE SPI X'5E04' SET TASK SPIX'4610' DISCARD PROFILE SPI X'5E06' CHANGE TASK APIX'4802' ENTER TRACENUM API X'5E08' INQUIRE STORAGE SPIX'4804' MONITOR API X'5E12' INQUIRE TCLASS SPIX'4A02' ASKTIME ABSTIME API X'5E14' SET TCLASS SPIX'4A04' FORMATTIME API X'5E18' DISCARD
TRANCLASSSPI
X'4C02' INQUIRE FILE SPIX'4C04' SET FILE SPI X'5E1A' INQUIRE
TRANCLASSSPI
X'4C10' DISCARD FILE SPIX'4E02' INQUIRE PROGRAM SPI X'5E1C' SET TRANCLASS SPIX'4E04' SET PROGRAM SPI X'5E22' WAIT EXTERNAL APIX'4E10' DISCARD PROGRAM SPI X'5E32' WAITCICS APIX'5002' INQUIRE
TRANSACTIONSPI X'6002' INQUIRE
JOURNALNUMSPI
X'5004' SET TRANSACTION SPI X'6004' SET JOURNALNUM SPIX'5010' DISCARD
TRANSACTIONSPI X'6010' DISCARD
JOURNALNAMESPI
X'5202' INQUIRE TERMINAL SPI X'6012' INQUIREJOURNALNAME
SPIX'5204' SET TERMINAL SPIX'5206' INQUIRE NETNAME SPI X'6014' SET JOURNALNAME SPIX'5208' SET NETNAME SPI X'6202' INQUIRE VOLUME SPIX'5210' DISCARD TERMINAL SPI X'6204' SET VOLUME SPIX'5212' INQUIRE TERMINAL SPI X'6402' PERFORM SECURITY SPIX'5214' SET TERMINAL SPI X'6602' INQUIRE DUMPDS SPIX'5216' INQUIRE NETNAME SPI X'6604' SET DUMPDS SPIX'5402' INQUIRE SYSTEM SPI X'6612' INQUIRE
TRANDUMPCODESPI
X'5404' SET SYSTEM SPIX'5412' INQ SYSTEM SPI X'6614' SET
TRANDUMPCODESPI
X'5602' SPOOLOPEN INPUT APIX'5602' SPOOLOPEN
OUTPUTAPI X'6622' INQUIRE
SYSDUMPCODESPI
X'5604' SPOOLREAD API X'6624' SET SYSDUMPCODE SPIX'5606' SPOOLWRITE API X'6802' INQUIRE VTAM SPIX'5610' SPOOLCLOSE API X'6804' SET VTAM SPIX'5802' INQUIRE
CONNECTIONSPI X'6812' INQUIRE
AUTOINSTALLSPI
X'5804' SET CONNECTION SPI X'6814' SET AUTOINSTALL SPIX'5806' PERFORM
ENDAFFINITYSPI X'6822' INQUIRE
DELETSHIPPEDSPI
X'5810' DISCARDCONNECTION
SPI X'6824' SET DELETSHIPPED SPIX'6826' PERFORM
DELETSHIPPEDSPI
X'5A02' INQUIRE MODENAME SPIX'5A04' SET MODENAME SPI X'6A02' QUERY SECURITY APIX'5C02' INQUIRE TDQUEUE SPI X'6C02' WRITE OPERATOR APIX'5C04' SET TDQUEUE SPI X'6C12' CICSMESSAGE API
246 CICS User’s Handbook
EIBFN codes
EIBFNvalue
Command Type EIBFNvalue
Command Type
X'6E02' INQUIRE IRC SPI X'8214' CONVERSEDATASTREAM
FEPIX'6E04' SET IRC SPIX'7002' INQUIRE STATISTICS SPI X'8216' EXTRACT CONV FEPIX'7004' SET STATISTICS SPI X'8218' EXTRACT FIELD FEPIX'7006' PERFORM
STATISTICSSPI X'821A' EXTRACT STSN FEPI
X'821C' FREE FEPIX'7008' COLLECT
STATISTICSSPI X'821E' ISSUE FEPI
X'8220' RECEIVEFORMATTED
FEPIX'7012' INQUIRE MONITOR SPIX'7014' SET MONITOR SPI X'8222' RECEIVE
DATASTREAMFEPI
X'7202' PERFORMRESETTIME
SPIX'8224' SEND FORMATTED FEPI
X'7402' SIGNON API X'8226' SEND DATASTREAM FEPIX'7404' SIGNOFF API X'8228' START FEPIX'7406' VERIFY PASSWORD API X'840E' SP FEPIX'7408' CHANGE
PASSWORDAPI X'8422' INQUIRE
PROPERTYSETFEPI
X'7602' PERFORMSHUTDOWN
SPI X'8428' INSTALLPROPERTYSET
FEPI
X'7802' INQUIRETRACEDEST
SPI X'8430' DISCARDPROPERTYSET
FEPI
X'7804' SET TRACEDEST SPI X'8442' INQUIRE NODE FEPIX'7812' INQUIRE
TRACEFLAGSPI X'8444' SET NODE FEPI
X'8444' SET NODELIST FEPIX'7814' SET TRACEFLAG SPI X'8448' INSTALL NODELIST FEPIX'7822' INQUIRE
TRACETYPESPI X'844A' ADD POOL FEPI
X'844C' DELETE POOL FEPIX'7824' SET TRACETYPE SPI X'8450' DISCARD NODELIST FEPIX'7A02' INQUIRE DSNAME SPI X'8462' INQUIRE POOL FEPIX'7A04' SET DSNAME SPI X'8464' SET POOL FEPIX'7C02' INQ EXCI SPI X'8464' SET POOLLIST FEPIX'7E02' DUMP
TRANSACTIONAPI X'8468' INSTALL POOL FEPI
X'8470' DISCARD POOL FEPIX'7E04' PERFORM DUMP SPI X'8482' INQUIRE TARGET FEPIX'8002' INQUIRE TSQUEUE SPI X'8484' SET TARGETLIST FEPIX'8004' SET TSQUEUE SPI X'8484' SET TARGET FEPIX'8012' INQUIRE TSQNAME SPI X'8488' INSTALL
TARGETLISTFEPI
X'8014' SET TSQNAME SPIX'801A' INQUIRE TSPOOL SPI X'8490' DISCARD
TARGETLISTFEPI
X'8022' INQUIRE TSMODEL SPIX'8030' DISCARD TSMODEL SPI X'84A2' INQUIRE
CONNECTIONFEPI
X'820E' AP FEPIX'8210' ALLOCATE POOL FEPI X'84A4' SET CONNECTION FEPIX'8210' ALLOCATE
PASSCONVIDFEPI X'8602' ACQUIRE SPI
X'8802' INQUIREEXITPROGRAM
SPIX'8212' CONVERSE
FORMATTEDFEPI
X'8A02' INQUIRE REQID SPI
Chapter 8. EXEC interface block (EIB) 247
EIBFN codes
EIBFNvalue
Command Type EIBFNvalue
Command Type
X'8C02' WRITE MESSAGE API X'962C' STARTBROWSEEVENT
SPIX'9002' INQUIRE UOW SPIX'9004' SET UOW SPI X'962E' GETNEXT EVENT SPIX'9022' INQUIRE UOWENQ SPI X'9630' ENDBROWSE EVENT SPIX'9042' INQUIRE UOWLINK SPI X'9632' STARTBROWSE
PROCESSSPI
X'9044' SET UOWLINK SPIX'9062' INQUIRE
UOWDSNFAILSPI X'9634' GETNEXT PROCESS SPI
X'9636' ENDBROWSEPROCESS
SPIX'9082' INQUIRE ENQMODEL SPIX'9084' SET ENQMODEL SPI X'9638' INQUIRE TIMER SPIX'9090' DISCARD
ENQMODELSPI X'963A' STARTBROWSE
TIMERSPI
X'9202' INQUIREJOURNALMODEL
SPI X'963C' GETNEXT TIMER SPIX'963E' ENDBROWSE TIMER SPI
X'9210' DISCARDJOURNALMODEL
SPI X'9802' INQUIRE CFDTPOOL SPIX'9A02' INQUIRE
REQUESTMODELSPI
X'9212' INQUIRESTREAMNAME
SPIX'9A10' DISCARD
REQUESTMODELSPI
X'9402' INQUIRE DB2CONN SPIX'9404' SET DB2CONN SPI X'9C02' INQUIRE
TCPIPSERVICESPI
X'9410' DISCARD DB2CONN SPIX'9422' INQUIRE DB2ENTRY SPI X'9C04' SET TCPIPSERVICE SPIX'9424' SET DB2ENTRY SPI X'9C10' DISCARD
TCPIPSERVICESPI
X'9430' DISCARD DB2ENTRY SPIX'9442' INQUIRE DB2TRAN SPI X'9C12' INQUIRE TCPIP SPIX'9444' SET DB2TRAN SPI X'9C14' SET TCPIP SPIX'9450' DISCARD DB2TRAN SPI X'9C22' INQUIRE WEB SPIX'9602' INQUIRE
PROCESSTYPESPI X'9C24' SET WEB SPI
X'9E02' INQUIREDOCTEMPLATE
SPIX'9604' SET PROCESSTYPE SPIX'9610' DISCARD
PROCESSTYPESPI X'9E10' DISCARD
DOCTEMPLATESPI
X'9612' INQUIRE ACTID SPIX'9614' INQUIRE CONTAIN SPIX'9616' INQUIRE EVENT SPIX'9618' INQUIRE PROCESS SPIX'9620' STARTBROWSE
ACTIVITYSPI
X'9622' GETNEXT ACTIVITY SPIX'9624' ENDBROWSE
ACTIVITYSPI
X'9626' STARTBROWSECONTAINER
SPI
X'9628' GETNEXTCONTAINER
SPI
X'962A' ENDBROWSECONTAINER
SPI
248 CICS User’s Handbook
EIBRCODE values
EIBRCODE valuesSee the notes at the end of the list of values for explanations of the numbersfollowing some of the conditions.
EIBFN EIBRCODE Condition
ð6 .. 85 .. .. .. .. .. SUPPRESSEDEIBFN EIBRCODE Condition
ð6 .. 86 .. .. .. .. .. LOADING
ð6 .. Dð .. .. .. .. .. SYSIDERR3ð2 .. Eð .. .. .. .. .. INVREQ
ð6 .. D1 .. .. .. .. .. ISCINVREQ ð6 .. D6 .. .. .. .. .. NOTAUTHð4 .. ð4 .. .. .. .. .. EOF
ð6 .. E1 .. .. .. .. .. LENGERRð4 .. 1ð .. .. .. .. .. EODS
ð4 .. C1 .. .. .. .. .. EOF
ð8 .. ð1 .. .. .. .. .. QZEROð4 .. C2 .. .. .. .. .. ENDINPT
ð8 .. ð2 .. .. .. .. .. QIDERRð4 .. Dð .. .. .. .. .. SYSIDERR3
ð8 .. ð4 .. .. .. .. .. IOERRð4 .. D2 .. .. .. .. .. SESSIONERR4
ð8 .. ð8 .. .. .. .. .. NOTOPENð4 .. D3 .. .. .. .. .. SYSBUSY5
ð8 .. 1ð .. .. .. .. .. NOSPACEð4 .. D4 .. .. .. .. .. SESSBUSY
ð8 .. Cð .. .. .. .. .. QBUSYð4 .. D5 .. .. .. .. .. NOTALLOC
ð8 .. Dð .. .. .. .. .. SYSIDERR3ð4 .. Eð .. .. .. .. .. INVREQ6
ð8 .. D1 .. .. .. .. .. ISCINVREQð4 .. E1 .. .. .. .. .. LENGERR7
ð8 .. D6 .. .. .. .. .. NOTAUTHð4 .. E3 .. .. .. .. .. WRBRK
ð8 .. D7 .. .. .. .. .. DISABLEDð4 .. E4 .. .. .. .. .. RDATT
ð8 .. Eð .. .. .. .. .. INVREQð4 .. E5 .. .. .. .. .. SIGNAL
ð8 .. E1 .. .. .. .. .. LENGERRð4 .. E6 .. .. .. .. .. TERMIDERR
ð4 .. E7 .. .. .. .. .. NOPASSBKRD
ðA .. ð1 .. .. .. .. .. ITEMERRð4 .. E8 .. .. .. .. .. NOPASSBKWR
ðA .. ð2 .. .. .. .. .. QIDERRð4 .. EA .. .. .. .. .. IGREQCD
ðA .. ð4 .. .. .. .. .. IOERRð4 .. EB .. .. .. .. .. CBIDERR
ðA .. ð8 .. .. .. .. .. NOSPACEð4 .. EC .. .. .. .. .. PARTNERIDERR
ðA .. 2ð .. .. .. .. .. INVREQð4 .. ED .. .. .. .. .. NETNAMEIDERR
ðA .. Dð .. .. .. .. .. SYSIDERR3ð4 .. F1 .. .. .. .. .. TERMERR
ðA .. D1 .. .. .. .. .. ISCINVREQð4 .. .. 2ð .. .. .. .. EOC
ðA .. D6 .. .. .. .. .. NOTAUTHð4 .. .. 4ð .. .. .. .. INBFMH
ðA .. E1 .. .. .. .. .. LENGERRð4 .. .. .. .. F6 .. .. NOSTART
ð4 .. .. .. .. F7 .. .. NONVAL
ðC .. E1 .. .. .. .. .. LENGERR ðC .. E2 .. .. .. .. .. NOSTGð6 .. ð1 .. .. .. .. .. FILENOTFOUND
ð6 .. ð2 .. .. .. .. .. ILLOGIC1
ðE .. ð1 .. .. .. .. .. PGMIDERRð6 .. ð3 .. .. .. .. .. LOCKED
ðE .. D6 .. .. .. .. .. NOTAUTHð6 .. ð5 .. .. .. .. .. RECORDBUSY
ðE .. Eð .. .. .. .. .. INVREQð6 .. ð8 .. .. .. .. .. INVREQ
ðE .. E1 .. .. .. .. .. LENGERRð6 .. ðC .. .. .. .. .. NOTOPEN
ðE .. F1 .. .. .. .. .. TERMERRð6 .. ðD .. .. .. .. .. DISABLED
ð6 .. ðF .. .. .. .. .. ENDFILE
ð6 .. 8ð .. .. .. .. .. IOERR1
ð6 .. 81 .. .. .. .. .. NOTFND
ð6 .. 82 .. .. .. .. .. DUPREC
ð6 .. 83 .. .. .. .. .. NOSPACE
ð6 .. 84 .. .. .. .. .. DUPKEY
Chapter 8. EXEC interface block (EIB) 249
EIBRCODE values
EIBFN EIBRCODE Condition EIBFN EIBRCODE Condition
1ð .. ð1 .. .. .. .. .. ENDDATA 18 .. .. .. 1ð .. .. .. IGREQID
1ð .. ð4 .. .. .. .. .. IOERR 1ð .. 11 .. .. .. .. .. TRANSIDERR 1A .. Eð .. .. .. .. .. INVREQ
1ð .. 12 .. .. .. .. .. TERMIDERR 1A .. ð4 .. .. .. .. .. DSSTAT
1ð .. 2ð .. .. .. .. .. EXPIRED 1A .. ð8 .. .. .. .. .. FUNCERR
1ð .. 81 .. .. .. .. .. NOTFND 1A .. ðC .. .. .. .. .. SELNERR
1ð .. Dð .. .. .. .. .. SYSIDERR3 1A .. 1ð .. .. .. .. .. UNEXPIN
1ð .. D1 .. .. .. .. .. ISCINVREQ 1A .. E1 .. .. .. .. .. LENGERR
1ð .. D6 .. .. .. .. .. NOTAUTH 1A .. .. 11 .. .. .. .. EODS
1ð .. D8 .. .. .. .. .. USERIDERR 1A .. .. 2B .. .. .. .. IGREQCD
1ð .. E1 .. .. .. .. .. LENGERR 1A .. .. .. 2ð .. .. .. EOC
1ð .. E9 .. .. .. .. .. ENVDEFERR 1ð .. FF .. .. .. .. .. INVREQ 22 .. 8ð .. .. .. .. .. INVEXITREQ
12 .. 32 .. .. .. .. .. ENQBUSY 4A .. .. .. .. ð1 .. .. ERROR
12 .. Eð .. .. .. .. .. INVREQ 12 .. E1 .. .. .. .. .. LENGERR 56 .. .. .. .. ðD .. .. NOTFND
56 .. .. .. .. 1ð .. .. INVREQ
14 .. ð1 .. .. .. .. .. JIDERR 56 .. .. .. .. 13 .. .. NOTOPEN
14 .. ð2 .. .. .. .. .. INVREQ 56 .. .. .. .. 14 .. .. ENDFILE
14 .. ð5 .. .. .. .. .. NOTOPEN 56 .. .. .. .. 15 .. .. ILLOGIC
14 .. ð6 .. .. .. .. .. LENGERR 56 .. .. .. .. 16 .. .. LENGERR
14 .. ð7 .. .. .. .. .. IOERR 56 .. .. .. .. 2A .. .. NOSTG
14 .. ð9 .. .. .. .. .. NOJBUFSP 56 .. .. .. .. 46 .. .. NOTAUTH
14 .. D6 .. .. .. .. .. NOTAUTH 56 .. .. .. .. 5ð .. .. NOSPOOL
56 .. .. .. .. 55 .. .. ALLOCERR
16 .. ð1 .. .. .. .. .. ROLLEDBACK 56 .. .. .. .. 56 .. .. STRELERR
56 .. .. .. .. 57 .. .. OPENERR
18 .. ð1 .. .. .. .. .. INVREQ 56 .. .. .. .. 58 .. .. SPOLBUSY
18 .. ð2 .. .. .. .. .. RETPAGE 56 .. .. .. .. 59 .. .. SPOLERR
18 .. ð4 .. .. .. .. .. MAPFAIL 56 .. .. .. .. 5A .. .. NODEIDERR
18 .. ð8 .. .. .. .. .. INVMPSZ2 56 .. .. .. .. 6ð .. .. OUTDESCRERR
18 .. 2ð .. .. .. .. .. INVERRTERM 18 .. 4ð .. .. .. .. .. RTESOME
18 .. 8ð .. .. .. .. .. RTEFAIL
18 .. E1 .. .. .. .. .. LENGERR
18 .. E3 .. .. .. .. .. WRBRK
18 .. E4 .. .. .. .. .. RDATT
18 .. .. ð2 .. .. .. .. PARTNFAIL
18 .. .. ð4 .. .. .. .. INVPARTN
18 .. .. ð8 .. .. .. .. INVPARTNSET
18 .. .. 1ð .. .. .. .. INVLDC
18 .. .. 2ð .. .. .. .. UNEXPIN
18 .. .. 4ð .. .. .. .. IGREQCD
18 .. .. 8ð .. .. .. .. TSIOERR
18 .. .. .. ð1 .. .. .. OVERFLOW
18 .. .. .. ð4 .. .. .. EODS
18 .. .. .. ð8 .. .. .. EOC
250 CICS User’s Handbook
EIBRCODE values
Notes:
1. When ILLOGIC or IOERR occurs during file control operations, furtherinformation is provided in field EIBRCODE, as follows:
.. xx xx xx xx .. BDAM response
.. xx .. .. .. .. VSAM return code
.. .. xx .. .. .. VSAM error code
.. .. .. xx .. .. VSAM problem determination code
.. .. .. .. xx .. VSAM component code
VSAM Administration: Macro Instruction Reference manual for VSAM,and the Data Facility Product Customization Guide for BDAM.
2. When INVMPSZ occurs during BMS operations, byte 3 of fieldEIBRCODE contains the terminal code:
.. .. .. xx .. .. terminal code
3. When SYSIDERR occurs, further information is provided in bytes 1 and2 of EIBRCODE, as follows:
.. ð4 ðð .. .. .. request was for invalid function
.. ð4 ð4 .. .. .. no session available and NOQUEUE
.. ð4 ð8 .. .. .. mode name not found
.. ð4 ðC .. .. .. mode name invalid
.. ð4 1ð .. .. .. task canceled or timed out during allocation
.. ð4 14 .. .. .. mode group is out of service
.. ð4 18 .. .. .. close - DRAIN=ALL (Note: APPC only)
.. ð8 .. .. .. .. SYSID out of service – for function shippingrequests, the exit program (XISCONA) may haverefused to queue the request because the intersystemconnection is busy
.. ðC xx .. .. .. SYSID definition error
.. ðC ðð .. .. .. name not that of TCTSE
.. ðC ð4 .. .. .. name not that of remote TCTSE
.. ðC ð8 .. .. .. mode name not found
.. ðC ðC .. .. .. profile not found
Further information about SYSIDERR can be found in the CICSIntercommunication Guide.
4. When SESSIONERR occurs, further information is provided in bytes 1and 2 of EIBRCODE, as follows:
.. ð8 .. .. .. .. session out of service
.. ðC xx .. .. .. session definition error
.. ðC ðð .. .. .. name not found
.. ðC ðC .. .. .. profile not found
Chapter 8. EXEC interface block (EIB) 251
EIBRCODE values
Further information about SESSIONERR can be found in the CICSIntercommunication Guide.
5. If SYSBUSY occurs on an ALLOCATE command that attempts toacquire a session to an APPC terminal or system, byte 3 of theEIBRCODE indicates where the error condition was detected:
.. .. .. ðð .. .. the request was for a session to a connectedterminal or system
.. .. .. ð1 .. .. the request was for a session to a remotelyconnected terminal or system, and the error occurredin the terminal-owning region (TOR) or an intermediatesystem
.. .. .. ð2 .. .. the request was for a session to a remotelyconnected terminal or system, and the error occurredin the application-owning region (AOR)
Further information about SYSBUSY can be found in the CICSIntercommunication Guide.
6. When INVREQ occurs during terminal control operations, furtherinformation is provided in byte 3 of EIBRCODE as follows:
.. .. .. ð4 .. .. ALLOCATE command - TCTTE already allocated
.. .. .. ð8 .. .. FREE command - TCTTE in wrong state
.. .. .. ðC .. .. CONNECT PROCESS command - SYNCLVL 2 hasbeen requested but cannot be supported on thesession in use
.. .. .. 1ð .. .. EXTRACT ATTACH command - invalid data
.. .. .. 14 .. .. SEND command - CONFIRM option has beenspecified but conversation is not SYNCLVL 1
.. .. .. 18 .. .. EXTRACT TCT command - invalid netname
.. .. .. 1C .. .. an invalid command has been issued for theterminal or logical unit in use
.. .. .. 2ð .. .. an invalid command has been issued for the LU6.2conversation type in use
.. .. .. 28 .. .. GETMAIN failure on ISSUE PASS command
252 CICS User’s Handbook
EIBRCODE values
7. When LENGERR occurs during terminal control operations, furtherinformation is provided in byte 1 of EIBRCODE, as follows:
.. ðð .. .. .. .. input data is overlong and has been truncated
.. ð4 .. .. .. .. on output commands, an invalid (FROM)LENGTHhas been specified, either less than zero or greaterthan 32767
.. ð8 .. .. .. .. on input commands, an invalid (TO)LENGTH hasbeen specified, greater than 32767
.. ðC .. .. .. .. length error has occurred on ISSUE PASScommand
Chapter 8. EXEC interface block (EIB) 253
RESP values
RESP values and conditionsRESPvalue
Condition RESPvalue
Condition
00 NORMAL 45 NOJBUFSP01 ERROR 46 DSSTAT02 RDATT 47 SELNERR03 WRBRK 48 FUNCERR04 EOF 49 UNEXPIN05 EODS 50 NOPASSBKRD06 EOC 51 NOPASSBKWR07 INBFMH 52 -08 ENDINPT 53 SYSIDERR09 NONVAL 54 ISCINVREQ10 NOSTART 55 ENQBUSY11 TERMIDERR 56 ENVDEFERR12 FILENOTFOUND 57 IGREQCD13 NOTFND 58 SESSIONERR14 DUPREC 59 SYSBUSY15 DUPKEY 60 SESSBUSY16 INVREQ 61 NOTALLOC17 IOERR 62 CBIDERR18 NOSPACE 63 INVEXITREQ19 NOTOPEN 64 INVPARTNSET20 ENDFILE 65 INVPARTN21 ILLOGIC 66 PARTNFAIL22 LENGERR 67 -23 QZERO 68 -24 SIGNAL 69 USERIDERR25 QBUSY 70 NOTAUTH26 ITEMERR 71 VOLIDERR27 PGMIDERR 72 SUPPRESSED28 TRANSIDERR 73 -29 ENDDATA 74 -30 INVTSREQ 75 RESIDERR31 EXPIRED 76 -32 RETPAGE 77 -33 RTEFAIL 78 -34 RTESOME 79 -35 TSIOERR 80 NOSPOOL36 MAPFAIL 81 TERMERR37 INVERRTERM 82 ROLLEDBACK38 INVMPSZ 83 END39 IGREQID 84 DISABLED40 OVERFLOW 85 ALLOCERR41 INVLDC 86 STRELERR42 NOSTG 87 OPENERR43 JIDERR 88 SPOLBUSY44 QIDERR 89 SPOLERR
254 CICS User’s Handbook
RESP values
RESPvalue
Condition
90 NODEIDERR91 TASKIDERR92 TCIDERR93 DSNNOTFOUND94 LOADING95 MODELIDERR96 OUTDESCRERR97 PARTNERIDERR98 PROFILEIDERR99 NETNAMEIDERR100 LOCKED101 RECORDBUSY102 UOWNOTFOUND103 UOWLNOTFOUND104 LINKABEND105 CHANGED106 PROCESSBUSY107 ACTIVITYBUSY108 PROCESSERR109 ACTIVITYERR110 CONTAINERERR111 EVENTERR112 TOKENERR113 NOTFINISHED114 POOLERR115 TIMERERR116 SYMBOLERR117 TEMPLATERR118 -
Chapter 8. EXEC interface block (EIB) 255
RESP2 values
Chapter 9. RESP2 values and their meanings
Note: The RESP2 values returned by the CICS/ESA Front EndProgramming Interface are described in the CICS Front EndProgramming Interface User's Guide.
Command Condition RESP2 Meaning
ACQUIRETERMINAL
INVREQ 2 The terminal is a remoteterminal
3 The terminal is LU6.1,APPC, IRC or anon-VTAM device
4 The terminal is not inservice; that is, it is notavailable for use.
5 VTAM is not open7 CICS is already in the
process of acquiring thissession.
8 NOQUEUE andQNOTENAB options areinvalid for a logged-ondevice
LENGERR 6 Out-of-range valuesupplied in theUSERDATALEN option
NOTAUTH 100 The user associated withthe task is not authorizedto use this command
TERMIDERR 1 The terminal cannot befound
ADDRESS INVREQ 200 The TCTUA option isspecified on anADDRESS commandissued in a DPL serverprogram
ASSIGN INVREQ 1 The task does not have asigned-on user
2 No BMS command hasyet been issued, BMSrouting is in effect, or nomap has yet beenpositioned
3 No BDI command has yetbeen issued
Copyright IBM Corp. 1989, 1999 257
RESP2 values
Command Condition RESP2 Meaning
4 The task is not initiated byautomatic transactioninitiation (ATI)
5 The task is not associatedwith a terminal; or thetask has no principalfacility; or the principalfacility is not am MRO,LU6.1, or APPC session
200 Command syntax optionsare not allowed in aserver program invokedby a distributed programlink
CHANGEPASSWORD
INVREQ 13 There is an unknownreturn code in ESMRESPfrom the external securitymanager
18 The CICS externalsecurity manager interfaceis not initialized
29 The external securitymanager is notresponding
NOTAUTH 2 The supplied password iswrong
4 The new password is notacceptable
19 The USERID is revoked22 The change password
request failed duringSECLEVEL processing
31 The user is revoked in theconnection to the defaultgroup
USERIDERR 8 The USERID is not knownto the external securitymanager
CHANGE TASK INVREQ 1 The PRIORITY value isoutside the range 0–255
258 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
COLLECTSTATISTICS
NOTFND 1 The requested resourcecannot be found (forexample, if theJOURNALNAME specifiedis not known to CICS)
2 The type of resource isnot defined in the CICSsystem
IOERR 3 The requested statisticsarea was not functioning
INVREQ 4 The TCLASS value wasnot in the range 1–10, orthe LSRPOOL value wasnot in the range 1–8
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe task is not authorizedto access this particularresource in the wayrequired by this command
CONNECTPROCESS
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
CONVERSE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
CREATECONNECTION
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier connection orterminal pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 259
RESP2 values
Command Condition RESP2 Meaning
102 The user of thetransaction issuing theCREATE CONNECTIONis not an authorizedsurrogate of the useridspecified inSECURITYNAME
INVREQ n Syntax error inATTRIBUTES string, orerror occurred duringeither discard or resourcedefinition phase ofprocessing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATEDB2CONN
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 Command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionnot yet completed
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.
260 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
102 The user associated withthe issuing task is not anauthorized surrogate ofthe user specified inAUTHID, COMAUTHID, orSIGNID parameter
103 The user associated withthe issuing task is notauthorized to create aDB2CONN with anAUTHTYPE orCOMAUTHTYPEparameter
CREATEDB2ENTRY
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 Command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionnot yet completed
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 261
RESP2 values
Command Condition RESP2 Meaning
101 The user associated withthe issuing task is notauthorized to create aDB2ENTRY definition withthis name
102 The user associated withthe issuing task is not anauthorized surrogate ofthe user specified in theAUTHID parameter
103 The user associated withthe issuing task is notauthorized to create aDB2ENTRY with anAUTHTYPE parameter
CREATEDB2TRAN
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 Command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionnot yet completed
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create aDB2TRAN definition andassociate it with thenamed DB2ENTRY
262 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
102 The user associated withthe issuing task is not anauthorized surrogate ofthe user specified in theAUTHID parameter of theDB2ENTRY named in theDB2TRAN
103 The user associated withthe issuing task is notauthorized to create aDB2TRAN with theDB2ENTRY specifyingAUTHTYPE
CREATEDOCTEMPLATE
LENGERR 1 The length specified inATTRLEN is negative
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
CREATEENQMODEL
LENGERR 1 The length specified inATTRLEN is negative
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
Chapter 9. RESP2 values and their meanings 263
RESP2 values
Command Condition RESP2 Meaning
200 The command wasexecuted in a programdefined with anEXECUTIONSET value ofDPLSUBSET or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create this aENQMODEL definitionwith this name
CREATE FILE LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier connection orterminal pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create aFILE definition with thisname
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
264 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATEJOURNALMODEL
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATELSRPOOL
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 265
RESP2 values
Command Condition RESP2 Meaning
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATEMAPSET
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create aMAPSET definition withthis name
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
266 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
CREATEPARTITIONSET
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create thisparticular PARTITIONSET
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATEPARTNER
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 267
RESP2 values
Command Condition RESP2 Meaning
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATEPROFILE
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATEPROGRAM
LENGERR 1 The length specified inATTRLEN is negative
268 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create thisparticular PROGRAM
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATEREQUESTMODEL
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
Chapter 9. RESP2 values and their meanings 269
RESP2 values
Command Condition RESP2 Meaning
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATESESSIONS
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
102 The user of transactionissuing CREATESESSIONS is not anauthorized surrogate ofthe user specified inUSERID
102 The user of thetransaction issuing theCREATE SESSIONScommand is not anauthorized surrogate ofthe userid specified inUSERID
INVREQ 200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
270 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
CREATETCPIPSERVICE
INVREQ n Syntax error inATTRIBUTE string or anerror occurred duringeither the discard orresource definition phaseof processing
200 The command executedin program defined withan EXECUTIONSET orDPLSUBSET, or aprogram invoked from aremote system by adistributed program linkwithout theSYNCONRETURN option.
LENGERR 1 Length specified inATTRLEN is negative
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
CREATETDQUEUE
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create aTDQUEUE definition withthis name
102 The user of thetransaction issuing theCREATE TDQUEUEcommand is not anauthorized surrogate ofthe user specified inUSERID
Chapter 9. RESP2 values and their meanings 271
RESP2 values
Command Condition RESP2 Meaning
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATETERMINAL
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
102 The user of thetransaction issuing theCREATE TERMINALcommand is not anauthorized surrogate ofthe userid specified inUSERID
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
272 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATETRANCLASS
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATETRANSACTION
LENGERR 1 The length specified inATTRLEN is negative
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 273
RESP2 values
Command Condition RESP2 Meaning
101 The user associated withthe issuing task is notauthorized to create thisparticular TRANSACTION
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATETSMODEL
LENGERR 1 The length specified inATTRLEN is negative
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to create aTSMODEL definition withthis name
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
CREATETYPETERM
LENGERR 1 The length specified inATTRLEN is negative
274 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 2 The command cannot beexecuted because anearlier CONNECTION orTERMINAL pool definitionhas not yet beencompleted
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
DELAY INVREQ 4 Hours are out of range5 Minutes are out of range6 Seconds are out of range
DELETE FILENOTFOUND 1 The file name referred to
in the FILE option cannotbe found in the FCT
INVREQ 20 Delete operations are notallowed according to thefile entry specification inthe FCT or theuser-maintained datatable was defined as aCICS file and thedefinition does not allowfor delete operations
21 A DELETE command wasissued for a file referringto a VSAM ESDS
22 A generic delete wasissued for a file that is nota VSAM KSDS
Chapter 9. RESP2 values and their meanings 275
RESP2 values
Command Condition RESP2 Meaning
25 The KEYLENGTH andGENERIC options werespecified, and the lengthspecified in theKEYLENGTH option isgreater than or equal tothe length of a full key
26 The KEYLENGTH optionwas specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers
27 A DELETE command wasissued for a file referringto a BDAM data set
31 A DELETE commandwithout the RIDFLD optionwas issued for a file forwhich no previous READUPDATE command hasbeen issued
42 The KEYLENGTH andGENERIC options werespecified, and the lengthspecified in theKEYLENGTH option isless than zero
44 The DELETE commanddoes not conform to theformat of DELETE for auser-maintained table; forexample if GENERICwere specified
47 A DELETE instructionincluded a token whosevalue cannot be matchedagainst any token in usefor an existing READ forUPDATE request
276 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
51 A DELETE commandspecifying the RBAkeyword was issuedagainst a KSDS file that isbeing accessed in RLSmode. RLS does notsupport relative byteaddress (RBA) access toKSDS files
55 NOSUSPEND wasspecified for a non-RLSfile
DISABLED 50 A file is disabled NOTOPEN 60 The requested file is
CLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but a closerequest against it hasbeen received or aDELETE command hasbeen issued against adata set that is quiesced,or is being quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED commend
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTFND 80 An attempt to delete arecord based on thesearch argument providedis unsuccessful or, foruser-maintained datatables, an attempt todelete a record wasunsuccessful becausethere is no entry with thespecified key in the datatable
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
Chapter 9. RESP2 values and their meanings 277
RESP2 values
Command Condition RESP2 Meaning
LOADING 104 A delete request has beenissued for auser-maintained table thatis currently being loaded
LOCKED 106 An attempt has beenmade to delete a recordspecifying the RIDFLD,but a retained lock existsagainst this key. If therequest specified theGENERIC keyword, allpossible records aredeleted, but the lockedrecords remain. Thenumber of records deletedis returned by NUMREC
RECORDBUSY 107 The NOSUSPENDkeyword was specified forthe deletion of a recordthat is locked by a VSAMactive lock
ILLOGIC 110 A VSAM error hasoccurred which does notfall within the one of theother CICS responsecategories
IOERR 120 There has been an I/Oerror during the file controloperation
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemwas closed.
DUPKEY 140 A record has beenaccessed by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key follows
278 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
DEQ LENGERR 1 The value specified forthe LENGTH option isoutside the range 1–255
INVREQ 2 The MAXLIFETIME optionhas an incorrect CVDA
DISABLEPROGRAM
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand.
DISCARDAUTINSTMODEL
MODELIDERR 1 The model cannot befound
INVREQ 2 The model you requestedis currently in use
3 The model cannot bediscarded because itsname begins with DFH
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
DISCARDCONNECTION
SYSIDERR 9 The named connectioncannot be found
INVREQ 24 Remote and in-use25 Not set out-of-service and
not remote26 Recovery work pending27 Discard processing failed28 Indirect connections point
to this connection29 MRO connection and IRC
active38 Delete already in flight39 Entry locked by another
RDO action200 DPL subset without
SYNCONRETURN NOTAUTH 100 The user of this command
is not authorized
Chapter 9. RESP2 values and their meanings 279
RESP2 values
Command Condition RESP2 Meaning
DISCARDDB2CONN
INVREQ 2 The CICS DB2 interfaceis active
NOTFND 1 A DB2CONN cannot befound
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
DISCARDDB2ENTRY
INVREQ 2 The DB2ENTRY iscurrently in use
3 The DB2ENTRY is notdisabled
NOTFND 1 The DB2ENTRY cannotbe found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
DISCARDDB2TRAN
NOTFND 1 The DB2ENTRY cannotbe found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access theDB2ENTRY referenced bythis DB2TRAN in the wayrequired by this command
DISCARDDOCTEMPLATE
LENGERR 1 The length specified inATTRLEN is negative
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
280 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
INVREQ n There is a syntax error inthe ATTRIBUTES string,or an error occurredduring either the discardor resource definitionphase of processing
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
DISCARDENQMODEL
NOTFND 1 The specifiedENQMODEL is notinstalled on this system
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
DISCARD FILE INVREQ 2 The file is not closed3 The file is not disabled
25 The file definition iscurrently in use
26 The file cannot bediscarded because itsname begins with DFH
43 The file cannot bediscarded because it haswork outstanding forwhich there are retainedlocks
FILENOTFOUND 18 The file cannot be found NOTAUTH 100 The user associated with
the issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
DISCARDJOURNALMODEL
NOTFND 1 The specifiedJOURNALMODEL namewas not found
Chapter 9. RESP2 values and their meanings 281
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user is not authorizedfor this command
DISCARDJOURNALNAME
INVREQ 3 The specified journalname (for example, thesystem log) cannot bediscarded
JIDERR 1 The journal cannot befound
NOTAUTH 100 The user is not authorizedfor this command
101 The user does not havethe required accessauthority to the specifiedjournal name
DISCARDPARTNER
PARTNERIDERR 1 The partner cannot befound
5 The Partner ResourceManager (PRM) is notactive, because it failed toinitialize during CICSinitialization
INVREQ 2 The partner definition iscurrently in use
3 The partner cannot bediscarded because itsname begins with DFH
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
DISCARDPROFILE
PROFILEIDERR 1 The profile cannot befound
INVREQ 2 The profile definition iscurrently in use
3 A transaction definitionpoints to the profile
4 The profile cannot bediscarded because itsname begins with DFH
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
282 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
DISCARDPROGRAM
INVREQ 1 The resource cannot bediscarded because itsname begins with DFH
11 The resource definition iscurrently in use
15 The resource cannot bediscarded because it is auser-replaceable module
PGMIDERR 7 The resource definitioncannot be found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
DISCARDREQUESTMODEL
NOTFND 1 The requested modelname was not found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
DISCARDTCPIPSERVICE
INVREQ 9 The TCPIPservice is stillopen
NOTFND 3 The TCPIPSERVICEname was not found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
DISCARDTDQUEUE
QIDERR 1 The queue cannot befound
INVREQ 11 The queue name beginswith the letter C
18 The queue is not closed 30 Disable pending 31 The queue is not disabled
Chapter 9. RESP2 values and their meanings 283
RESP2 values
Command Condition RESP2 Meaning
200 The command wasexecuted in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
DISCARDTERMINAL
TERMIDERR 23 Named terminal cannot befound
INVREQ 33 APPC session or device 38 Terminal type not VTAM
or console 39 Not out of service and not
remote 40 Error console 41 MRO session 43 Delete failed 44 Remote and in-use 45 Locked by another RDO
action 46 Delete already in flight 200 The command was
executed in a programthat has been linked tofrom a remote system thathas not specified theSYNCONRETURN option,or has been linked tolocally and is defined withEXECUTIONSET=DPLSUBSET
NOTAUTH 100 The use of this commandis not authorized
DISCARDTRANCLASS
TCIDERR 1 The transaction classcannot be found
284 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
INVREQ 2 The TRANCLASSdefinition is in use
12 The transaction classcannot be discardedbecause installedtransactions belong to it
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
DISCARDTRANSACTION
TRANSIDERR 1 The transaction cannot befound
INVREQ 4 The transaction cannot bediscarded because itsname begins with C
13 The transaction is a SITparameter
14 The transaction isscheduled to run at afuture time (in use by aninterval control element)
15 The transaction isscheduled to run whenrequired resources areavailable (in use by anautomatic initiatedescriptor)
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
DISCARDTSMODEL
NOTFND 1 The TSMODEL does notexist
INVREQ 2 The TSMODEL definitionis currentl in use
3 The TS model cannot bediscarded because itsname begins with DFH
Chapter 9. RESP2 values and their meanings 285
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to discard aTSMODEL with this name
DUMPTRANSACTION
SUPPRESSED 1 The transaction dump issuppressed by MAXIMUMin table
2 The transaction dump issuppressed byNOTRANDUMP in table
3 The transaction dump issuppressed by a user exitprogram
NOSPACE 4 The transaction dump isincomplete due to lack ofspace
NOSTG 5 CICS has run out ofworking storage
NOTOPEN 6 The current CICS dumproutine is not open
OPENERR 7 Error on opening, closing,or writing to, the currentCICS dump routine
IOERR 9 The SDUMP process wasnot authorized
10 An error occurred duringsystem dumping
13 The CICS routine issuingthe SDUMP was unableto establish a recoveryroutine (FESTAE)
INVREQ 13 An incorrect DUMPCODEwas specified.DUMPCODE must notcontain leading orimbedded blanks
ENABLEPROGRAM
NOTAUTH 100 The user associated withthe issuing task is notauthorized to issue thiscommand
286 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
101 The user associated withthe task is not authorizedto access this particularresource in the wayrequired by thiscommand.
ENDBR FILENOTFOUND 1 The name referred to in
the FILE option cannot befound in the FCT
INVREQ 35 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
ILLOGIC 110 A VSAM error which doesnot fall within one of theother CICS responsecategories has occurred.
IOERR 120 There has been an I/Oerror during the operation
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining a connection); orthe link to the remotesystem is closed.
ENQ LENGERR 1 The value specified for
the LENGTH option isoutside the range 1–255
INVREQ 2 The MAXLIFETIME optionhas an incorrect CVDA
ENTERTRACENUM
INVREQ 1 TRACENUM is outsidethe range 0–199
2 There is no valid tracedestination
Chapter 9. RESP2 values and their meanings 287
RESP2 values
Command Condition RESP2 Meaning
3 The user trace master flagis set OFF andEXCEPTION has notbeen specified
LENGERR 4 FROMLENGTH is outsidethe range 0–4000specified
EXTRACTATTRIBUTES(APPC)
INVREQ 200 A distributed program linkserver applicationexplicitly, or implicitly bydefault, specified thefunction-shipping session(its principal facility) onthe CONVID option
EXTRACTATTRIBUTES(MRO)
INVREQ 200 A distributed program linkserver applicationexplicitly, or implicitly bydefault, specified thefunction-shipping session(its principal facility) onthe CONVID option
EXTRACT EXIT NOTAUTH 100 The user associated with
the issuing task is notauthorized to issue thiscommand
101 The user associated withthe task is not authorizedto access this particularresource in the wayrequired by thiscommand.
EXTRACTPROCESS
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
FORMATTIME INVREQ 1 The ABSTIME option is inan incorrect format
288 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
FREE (APPC) INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
FREEMAIN INVREQ 1 The storage specified bythe DATA orDATAPOINTERparameter was notstorage acquired by aGETMAIN command
2 The storage areaspecified by the DATA orDATAPOINTERparameter was inCICS-key storage, andthe program issuing theFREEMAIN commandwas in user-key.
GETMAIN LENGERR 1 The FLENGTH value was
less than 1 or greaterthan the length of thetarget storage area fromwhich the request was tobe satisfied
NOSTG 2 The storage requestedwas more than wascurrently available in thetarget DSA
HANDLEABEND
PGMIDERR 1 The program has no entryin the PPT and autoinstallfor programs is not active
2 The program is disabled 9 The installed program
definition is for a remoteprogram
HANDLE AID INVREQ 200 The command was issued
by a distributed programlink server application
Chapter 9. RESP2 values and their meanings 289
RESP2 values
Command Condition RESP2 Meaning
INQUIREAUTINSTMODEL
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
MODELIDERR 1 The model specifiedcannot be found
END 2 There are no moreresource definitions of thistype
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREAUTOINSTALL
INVREQ 20 The console has aninvalid CVDA value
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRECFDTPOOL
END 2 There are no morecoupling facility data tablepools to browse
ILLOGIC 1 START command issuedwhen CFDTPOOLsalready in progress, orNEXT or END issuedwhen CFDTPOOLs is notin progress
POOLERR 1 Named CFDTPOOL wasnot found
2 An internal controlstructure that CICS usesto maintain access toCFDT pools has beenaltered while the set ofpools known to CICS wasbeing browsed.
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
290 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
INQUIRECONNECTION
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SYSIDERR 1 The named connectioncould not be found
INQUIREDB2CONN
NOTFND 1 The requested DB2CONNcannot be found
NOTAUTH 100 Command authorizationfailure
INQUIREDB2ENTRY
NOTFND 1 The requestedDB2ENTRY cannot befound
NOTAUTH 100 Command authorizationfailure
101 Resource authorizationfailure
INQUIREDB2TRAN
NOTFND 1 The requested DB2TRANcannot be found
NOTAUTH 100 Command authorizationfailure
101 Resource authorizationfailure
INQUIREDELETSHIPPED
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREDOCTEMPLATE
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
Chapter 9. RESP2 values and their meanings 291
RESP2 values
Command Condition RESP2 Meaning
MODELIDERR 1 The DOCTEMPLATEspecified cannot be found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREDSNAME
DSNNOTFOUND 1 The data set cannot befound
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
IOERR 40 QUIESCESTATE wasspecified, but an errorwas raised by DFSMSreading the ICF catalog
49 An error was raised byDFSMS reading the ICFcatalog to establish thebase data set name
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREDUMPDS
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREENQMODEL
END 2 There are no moreresource definitions of thistype
NOTFND 1 The ENQMODEL cannotbe found
292 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 1 A START has beenissued when a browse ofthis resoutrce type isalready in progress, or aNEXT ot END issuedwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
INQUIRE EXCI END 2 There are no more
resource definitions of thistype
ILLOGIC 1 A START has beenissued when a browse ofthis resoutrce type isalready in progress, or aNEXT ot END issuedwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
INQUIREEXITPROGRAM
END 2 There are no moreresource definitions of thistype
INVREQ 3 The exit point identified by
EXIT does not exist
Chapter 9. RESP2 values and their meanings 293
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
PGMIDERR 1 � The exit identified byEXITPROGRAM andENTRYNAME is notenabled, or
� The EXIT parameteris missing for aninquiry on a globaluser exit, or
� The EXIT parameteris present on atask-related user exit
INQUIRE FILE END 2 There are no more
resource definitions asthis type
FILENOTFOUND 1 The file cannot be found ILLOGIC 1 A START has been given
when a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
294 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
INQUIRE IRC NOTAUTH 100 The user associated with
the issuing task is notauthorized to use thiscommand
INQUIREJOURNALMODEL
END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwithout a precedingSTART
2 The browse token is notvalid
NOTFND 1 The specified journalmodel was not found
NOTAUTH 100 The user is not authorizedfor this command
INQUIREJOURNALNAME
END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwithout a precedingSTART
2 The browse token is notvalid
JIDERR 1 The specified journalname was not found
Chapter 9. RESP2 values and their meanings 295
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user is not authorizedfor this command
101 The user does not havethe required accessauthority to the specifiedresource (Not applicableto INQUIREJOURNALNAME START,INQUIREJOURNALNAME NEXT,or INQUIREJOURNALNAME ENDcommands)
INQUIREMODENAME
END 2 There are no moreresource difinitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT orEND has been givenwhen a browse of thisresource type is not inprogress
SYSIDERR 1 The connection cannot befound
2 The modename within theconnection cannot befound
3 The connection specifiedon an INQUIREMODENAME NEXTcannot be found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREMONITOR
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREPARTNER
END 2 There are no moreresource definitions of thistype
296 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress
PARTNERIDERR 1 The partner cannot befound
2 Partner ResourceManager (PRM) is notactive, because it failed toinitialize during CICSinitialization
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREPROFILE
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
PROFILEIDERR 1 The profile cannot befound
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREPROGRAM
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or or a NEXTor an END has beengiven when a browse ofthis resource type is not inprogress
PGMIDERR 1 The program cannot befound
Chapter 9. RESP2 values and their meanings 297
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
INQUIREREQID
NOTFND 1 The REQID cannot befound
ILLOGIC 1 You have issued aSTART command when abrowse is already inprogress, or a NEXT oran END issued when abrowse of this resourcetype is not in progress
END 2 There are no moreresource definitions of thistype
INVREQ 3 An I/O error occurredwhile an attempt wasmade to read data fromtemporary storage for theSET, QUEUE, RTERMIDor RTRANSID option
4 Data required for the SET,QUEUE, RTERMID orRTRANSID option cannotbe returned because ithas been deleted fromtemporary storage
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIREREQUESTMODEL
NOTFND 1 The specified erquestmodel was not found
298 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 1 You have issued aSTART command when abrowse is already inprogress, or a NEXT oran END issued when abrowse of this resourcetype is not in progress
END 2 All authorized resourcedefinitions have beenretrieved
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRESTATISTICS
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRESTORAGE
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
TASKIDERR 1 The task number does notexist
2 The task number is asystem task, not a usertask
INQUIRESTREAMNAME
NOTAUTH 100 The user is not authorizedfor this command
END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged
NOTFND 1 The requested log streamname was not found
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwithout a precedingSTART
2 The browse token is notvalid
Chapter 9. RESP2 values and their meanings 299
RESP2 values
Command Condition RESP2 Meaning
INQUIRESYSDUMPCODE
END 2 There are no moreresource definitions of thistype
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
ILLOGIC 1 A START command hasbeen issued when abrowse is already inprogress or a NEXT or anEND command issuedwhen a browse of thisresource type is not inprogress
NOTFND 1 The named dump codecannot be found
INQUIRESYSTEM
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRE TASK TASKIDERR 1 The named task cannot
be found 2 The task is executing a
type of transaction whichis not subject to thiscommand operator
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INVREQ 1 SUSPENDVALUE isspecified but significantcharacters are lost
3 TCLASS is specified butCLASS is named. Theuser should specify theTRANCLASS option
10 Requested data is held ona data profile, but the datais not available
300 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
INQUIRE TASKLIST
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRETCLASS
TCIDERR 1 The named task classcannot be found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRE TCPIP INVREQ 4 TCPIP=NO has been
specified in the systeminitialization table (SIT)
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRETCPIPSERVICE
NOTFND 3 Named TCPIPSERVICEwas not found
ILLOGIC 1 A START command hasbeen issued when abrowse is already inprogress or a NEXT or anEND command issuedwhen a browse of thisresource type is not inprogress
END 2 There are no moreresource definitions of thistype
INVREQ 4 TCPIP not available(TCPIP=NO)
5 TCPIP is closed NOTAUTH 100 The user associated with
the issuing task is notauthorized to use thiscommand
INQUIRETDQUEUE
ENDCOND 2 There are no moreresource definitions of thistype
ILLOGIC 1 Browse sequence error
Chapter 9. RESP2 values and their meanings 301
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
QIDERR 1 The named queue cannotbe found
NORMAL 0 No errors INQUIRETERMINAL
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
TERMIDERR 1 The named terminalcannot be found
INQUIRETRACEDEST
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRETRACEFLAG
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRETRACETYPE
NOTFND 1 CICS was initializedwithout support for atleast one of thecomponents listed in thecommand; trace levelswere returned for all othercomponents
302 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
INQUIRETRANCLASS
INVREQ 12 The TRANCLASSdefinition is in use
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access theparticular resource in theway required by thiscommand
TCIDERR 1 The transaction classcannot be found
INQUIRETRANDUMPCODE
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
NOTFND 1 The dump code cannot befound
INQUIRETRANSACTION
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress
Chapter 9. RESP2 values and their meanings 303
RESP2 values
Command Condition RESP2 Meaning
TRANSIDERR 1 The transaction could notbe found
INVREQ 3 The TCLASS option hasbeen specified in thisINQUIRE command, andthe transaction belongs toa class that is not one ofthe numbered classesDFHTCL00 throughDFHTCL10
NORMAL 10 The profile definitionassociated with thetransaction is notavailable
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
INQUIRETSMODEL
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress
NOTFND 1 The TSMODEL does notexist
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
304 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
INQUIRETSPOOL
END 2 There are no moreresource definitions of thistype
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress or a NEXT oran END has been givenwhen a browse if thisresource type is not inprogress
NOTFND 1 The TSPOOL does notexist
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
INQUIRETSQUEUE/TSQNAME
END 2 There are no moreresource definitions of thistype
INVREQ 1 The specified SYSID doesnot exist in anyTYPE=SHARED entry inthe temporary storagetable
2 When INQUIRETSQUEUE NEXT isspecified, the NEXTqueue to be browsed hasa Queuename of morethan 8 significantcharacters. The queuename is truncated, somesignificant characters arelost.
4 This TSQNAME cannotbe deleted as it waswritten by CICS usingPUTQ macro
Chapter 9. RESP2 values and their meanings 305
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXT oran END has been givenwhen a browse of thisresource type is not inprogress
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
POOLERR 3 The POOLNAME doesnot exist
QIDERR 1 The temporary storagequeue cannot be found
SYSIDERR 3 The SYSID does not mapto a shared pool
4 An error has occurred inthe shared TS server
5 An I/O error has occurredon the coupling facility
INQUIRE UOW END 2 All authorized resourcedefinitions have beenretrieved. All data areasspecified on thiscommand are leftunchanged
ILLOGIC 1 A browse of this resourcetype is already inprogress, or an INQUIREUOW START commandhas not been issued
UOWNOTFOUND 1 A named UOW cannot befound
NOTAUTH 100 A use of this command isnot authorized
INQUIREUOWDSNFAIL
END 2 There are no moreUOW/data set pairs
306 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ILLOGIC 1 A START has been givenwhen a browse is alreadyin progress, or a NEXThas been given without apreceding START
NOTAUTH 100 A use of this command isnot authorized
INQUIREUOWENQ
END 2 All enqueues have beenretrieved
ILLOGIC 1 � For INQUIREUOQENQ START - abrowse of thisresource is already inprogress
� For INQUIREUOWENQ NEXT andINQUIRE UOWENQEND - an INQUIREUOWENQ STARTcommand has notbeen issued
UOWNOTFOUND 1 The named UOW cannotbe found
NOTAUTH 100 A use of this command isnot authorized
INQUIREUOWLINK
END 2 All authorized resourcedefinitions have beenretrieved
ILLOGIC 1 � For INQUIREUOQLINK START - abrowse of thisresource is already inprogress
� For INQUIREUOWLINK NEXT andINQUIRE UOWLINKEND - an INQUIREUOWLINK STARTcommand has notbeen issued
UOWLNOTFOUND 1 The named UOW-linkcannot be found
UOWNOTFOUND 1 The named UOW cannotbe found
NOTAUTH 100 A use of this command isnot authorized
Chapter 9. RESP2 values and their meanings 307
RESP2 values
Command Condition RESP2 Meaning
INQUIREVOLUME
VOLIDERR 1 The program has issuedan INQUIRE VOLUMEbrowse command. Thiscommand is withdrawn
INQUIRE VTAM INVREQ 1 VTAM is not present in
the system NOTAUTH 100 The user associated with
the issuing task is notauthorized to use thiscommand
INQUIRE WEB INVREQ 11 An invalid value was
supplied for one of theoptions
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
ISSUE ABEND INVREQ 200 A distributed program link
server applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE ABORT INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE ADD INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUECONFIRMATION
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
308 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ISSUE END INVREQ 200 A distributed program link
server applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE ENDFILE INVREQ 200 A distributed program linkserver applicationattempted to send on itsfunction-shipping session,its principal facility
ISSUEENDOUTPUT
INVREQ 200 A distributed program linkserver applicationattempted to send on itsfunction shipping session,its principal facility
ISSUE EODS INVREQ 200 A distributed program linkserver applicationattempted to send on itsfunction shipping session,its principal facility
ISSUE ERASE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUEERASEAUP
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE ERROR INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping sessionon the CONVID option
Chapter 9. RESP2 values and their meanings 309
RESP2 values
Command Condition RESP2 Meaning
ISSUE NOTE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUEPREPARE
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE PRINT INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE QUERY INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUERECEIVE
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUEREPLACE
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE RESET INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
310 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
ISSUE SEND INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE SIGNAL(APPC)
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
ISSUE WAIT INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
LINK INVREQ 8 A LINK command with theINPUTMSG option isissued for a program thatis not associated with aterminal, or that isassociated with an APPClogical unit, or an IRCsession
14 The SYNCONRETURNoption is specified but theprogram issuing the linkrequest (the clientprogram) is already inconversation with a mirrortask (that is, a logicalunit-of-work (LUW) is inprogress) in the remoteregion specified on theSYSID option. In thiscase, the client program isin an incorrect state tosupport theSYNCONRETURN option
Chapter 9. RESP2 values and their meanings 311
RESP2 values
Command Condition RESP2 Meaning
15 The program issuing thelink request is already inconversation with a mirrortask and the TRANSIDspecified is different fromthe transaction identifier ofthe active mirror
16 The TRANSID specified isall blanks
19 A LINK command with theINPUTMSG option isissued for a program thatis the subject of a DPLrequest; that is, SYSID isalso specified
30 The program managerdomain has not yet beeninitialized. This is probablydue to a link requesthaving been made in afirst stage PLT
LENGERR 11 The COMMAREA lengthis less than 0 or greaterthan 32767
12 The length specified onthe DATALENGTH optionis a negative value
13 The length specified onthe DATALENGTH optionis greater than the lengthspecified on the LENGTHoption
26 The COMMAREA addressis zero, but theCOMMAREA length isnon zero
27 The INPUTMSG length <0 or > 32767
NOTAUTH 101 A resource security checkhas failed onPROGRAM(name)
312 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
PGMIDERR 1 A program has no entry inthe PPT and eitherprogram autoinstall wasswitched off, or theprogram autoinstall controlprogram indicated that theprogram should not beautoinstalled
2 A program is disabled 3 A program cannot be
loaded because
� This was the first loadof the program andthe program loadfailed, usuallybecause the loadmodule could not befound
� This was asubsequent load ofthe program, but thefirst load failed
In order to reset the loadstatus the load modulemust be in the DFHRPLconcatenation, and a SETPROGRAM NEWCOPYwill be required
21 The program autoinstallcontrol program failedeither because theprogram autoinstall controlprogram is incorrect,incorrectly defined, or asa result of an abend in theprogram autoinstall controlprogram. Programautoinstall is disabled andmessage DFHPG0202 orDFHPG0203 written to theCSPL
22 The model returned bythe program autoinstallcontrol program is notdefined in the PPT table,or is not enabled
Chapter 9. RESP2 values and their meanings 313
RESP2 values
Command Condition RESP2 Meaning
23 The program autoinstallcontrol program returnedinvalid data
24 Define for the programfailed due to autoinstallreturning an invalidprogram name ordefinition
ROLLEDBACK 29 The SYNCONRETURNwas specified and theserver program wasunable successfully totake a syncpoint. Theserver program has takena rollback, and allchanges made torecoverable resources inthe remote region, withinthe current UOW, arebacked out
SYSIDERR 18 The SYSID specifiedcannot be found in theintersystem table, or thelink to the specifiedsystem is unavailable
20 The remote systemspecified by SYSID is anLUTYPE6.1-connectedsystem. Distributedprogram link requests arenot supported onLUTYPE6.1 connections
TERMERR 17 An unrecoverable erroroccurred during theconversation with themirror (for example, thesession failed or theserver region failed)
LOAD INVREQ 30 The program manager
domain has not yet beeninitialized. This is probablydue to a load requesthaving been made in afirst stage PLT
314 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
LENGERR 19 LENGTH is used and thelength of the loadedprogram is not less than32KB
NOTAUTH 101 A resource security checkhas failed onPROGRAM(name)
PGMIDERR 1 A program, table, or maphas no entry in the PPTand either programautoinstall was switchedoff, or the programautoinstall control programindicated that the programshould not beautoinstalled
2 A program is disabled 3 A program cannot be
loaded because
� This was the first loadof the program andthe program loadfailed, usuallybecause the loadmodule could not befound
� This was asubsequent load ofthe program, but thefirst load failed
In order to reset the loadstatus the load modulemust be in the DFHRPLconcatenation, and a SETPROGRAM NEWCOPYwill be required
9 The installed programdefinition is for a remoteprogram
Chapter 9. RESP2 values and their meanings 315
RESP2 values
Command Condition RESP2 Meaning
21 The program autoinstallcontrol program failedeither because theprogram autoinstall controlprogram is incorrect,incorrectly defined, or asa result of an abend in theprogram autoinstall controlprogram. Programautoinstall is disabled andmessage DFHPG0202 orDFHPG0203 written to theCSPL
22 The model returned bythe program autoinstallcontrol program was notdefined in the PPT table,or was not enabled
23 The program autoinstallcontrol program returnedinvalid data
24 Define for the programfailed due to autoinstallreturning an invalidprogram name ordefinition
MONITOR INVREQ 1 POINT value is outside
the range 1–255 2 POINT value is not
defined in the MCT 3 DATA1 value is not valid 4 DATA2 value is not valid 5 DATA1 value not
specified for an MCToperation that required it
6 DATA2 value notspecified for an MCToperation that required it
PERFORMDELETSHIPPED
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
316 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
PERFORMDUMP
SUPPRESSED 1 The dump was not takenbecause the number ofdumps with this dumpcode exceeds themaximum for the code
2 The dump was not takenbecause the system dumptable entry for this codeindicates no system dump
3 The dump was not takenbecause it wassuppressed by a user exitprogram
8 The dump was not takenbecause system dumpsare suppressed globally
NOSPACE 4 The dump is incompletedue to lack of dumpdata-set space
NOSTG 5 CICS cannot complete thedump because ofinsufficient storage
INVREQ 6 TITLELENGTH is greaterthan 80 bytes
7 CALLERLENGTH isgreater than 8 bytes
13 The DUMPCODEcontains leading orimbedded blanks
IOERR 9 CICS is not authorized byMVS to take dumps
10 An error occurs duringsystem dumping
12 MVS cannot process thedump because there is nodump data set or becauseit is full
13 An error occurred in theCICS routine that issuesMVS SDUMP requests
SYSBUSY 11 The MVS dump routine isbusy. Retry the command
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 317
RESP2 values
Command Condition RESP2 Meaning
PERFORMENDAFFINITY
INVREQ 25 The connection is still inservice
26 There may be recoveryinformation outstandingfor the connection.RECOVSTATUS has avalue other thanNORECOVDATA
32 See messageDFHZC0178. VTAM couldnot end the affinity for areason other than 35(NOTFOUND) or 36(SESSIONS ACTIVE)
34 Enter NETID. NETID wasnot specified, and cannotbe obtained from theinstalled connection. Thismay be because theconnection does not exist,or because it does notcontain a NETID value
35 VTAM could not find anaffinity for the values input
36 VTAM could not end theaffinity because theconnection had somesessions active
37 See messageDFHZC0176. A VTAMerror prevented theCHANGE AFFINITYmacro being carried out
PERFORMRESETTIME
INVREQ 1 There is no clock in thesystem
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
PERFORMSECURITYREBUILD
INVREQ 1 No ESM is installed, orthe ESM is inactive
5 The ESM is temporarilyinactive and cannotperform the actionrequested
318 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
IOERR 3 Error returned from ESM.The return code is inESMRESP, if the optionwas used
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
NORMAL 0 Profiles have beenrefreshed
4 No action is required,because RACF is atVersion 2.1 (or later), andso profiles are refreshedautomatically
SYSBUSY 3 A security rebuild iscurrently in progress
PERFORMSHUTDOWN
INVREQ 1 A normal shutdown hasbeen requested whenshutdown was already inprogress
2 The XLT cannot be found 3 The PLT cannot be found 4 XRF is not in effect 5 The transaction specified
on SDTRAN is notenabled for shutdown
6 The transaction specifiedon SDTRAN is notdefined as remote
7 The transaction specifiedon SDTRAN is notenabled
TRANSIDERR 1 The shutdown transactionspecified on SDTRANwas not found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 319
RESP2 values
Command Condition RESP2 Meaning
PERFORMSTATISTICSRECORD
IOERR n Statistics for at least oneof the options chosenwere not available; usuallythe reason for this error iscorruption of the memoryin which they areaccumulated. (See below)
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
NOTFND n Statistics for at least oneof the options chosenwere not availablebecause CICS wasinitialized without supportfor the function. (Seebelow)
The values of “n” are asfollows:
1 AUTOINSTALL 2 CONNECTION 3 DISPATCHER 6 FILE
8 JOURNALNUM andJOURNALNAME
10 LSRPOOL 11 MONITOR 12 PROGRAM 13 STATS 14 STORAGE 15 SYSDUMP 16 TABLEMGR 18 TCLASS,
TRANCLASS 19 TDQUEUE 20 TERMINAL 21 TRANDUMP 22 TRANSACTION 23 TSQUEUE 24 VTAM 25 FEPI 26 PROGAUTO 28 ENQUEUE 29 RECOVERY 30 STREAMNAME
320 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
POST INVREQ 4 Hours are out of range 5 Minutes are out of range 6 Seconds are out of range PURGEMESSAGE
INVREQ 200 The command was calledin a distributed programlink server program
QUERYSECURITY
NOTFND 1 The RESID is not valid
2 The RESTYPE is not valid 3 The RESID value for
RESTYPE(SPCOMMAND) is notvalid
5 The RESCLASS is notdefined to the externalsecurity manager (ESM)
8 The resource is notprotected
Possible causes include
� RESCLASS notactive
� No profile found
� ESM not active QIDERR 1 No indirect queue name
associated with the givenRESID has been found
LENGERR 6 The RESIDLENGTH valueis not valid, that is, not inthe range 1–246
INVREQ 7 The CVDA value is notvalid for theLOGMESSAGE
9 The RESID is invalid orfilled with blanks
10 The external securitymanager (ESM) is inactiveor not present
READ FILENOTFOUND 1 The file name referred to
in the FILE option cannotbe found in the FCT
Chapter 9. RESP2 values and their meanings 321
RESP2 values
Command Condition RESP2 Meaning
LENGERR 10 Neither the LENGTH norSET options have beenspecified on a READcommand for a file withvariable-length records orfor a BDAM file withvariable-length orundefined-format records
11 The length of a recordread with the INTO optionspecified exceeds thevalue specified in theLENGTH option; therecord is truncated, andthe data area supplied inthe LENGTH option is setto the actual length of therecord
13 An incorrect length isspecified for a file withfixed-length records
INVREQ 20 Read is not allowedaccording to the file entryspecification in the FCT ora read command with theUPDATE option has beenissued to a file whereupdate operations are notallowed according to thefile entry specification inthe FCT
25 The KEYLENGTH andGENERIC options arespecified and the lengthspecified in theKEYLENGTH option isgreater than or equal tothe length of a full key
26 The KEYLENGTH optionis specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers
322 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
28 Following a READUPDATE command for afile, another READUPDATE command isissued for a filereferencing the same dataset before exclusivecontrol is released by aREWRITE, UNLOCK, orDELETE command
40 A BDAM key conversionerror occurred
42 The KEYLENGTH andGENERIC options arespecified, and the lengthspecified in theKEYLENGTH option isless than or equal to zero
44 The command does notconform to the format ofREAD for auser-maintained table; forexample if GTEQ isspecified with UPDATE
51 A READ to a KSDS filethat was being accessedin RLS mode specified theRBA keyword. RLS modedoes not support relativebyte address access toKSDS data sets
52 A READ request to anon-RLS file specifiedCONSISTENT
53 A READ request to anon-RLS file specifiedREPEATABLE
55 A READ request to anon-RLS file specifiedNOSUSPEND, which isnot allowed because thefile is not a VSAM fileaccessed in RLS mode
Chapter 9. RESP2 values and their meanings 323
RESP2 values
Command Condition RESP2 Meaning
DISABLED 50 A file was initially definedas disabled and has notsince been enabled or ithas been disabled by anEXEC CICS SET FILE orthe CEMT SET FILEcommand
NOTOPEN 60 The requested file isCLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but aCLOSE request against ithas been received or aREAD command hasbeen issued against adata set that is quiesced,or is being quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED command
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedis unsuccessful or, foruser-maintained datatables, an attempt to reada record is unsuccessfulbecause there is no entrywith the specified key inthe data table
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
324 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
LOADING 104 A READ UPDATE hasbeen issued for auser-maintained datatable that is currentlybeing loaded or a READGENERIC has beenissued for auser-maintained datatable that is currentlybeing loaded
LOCKED 106 An attempt has beenmade to read a recordeither specifying theUPDATE keyword, orspecifying (explicitly orimplicitly) CONSISTENTor REPEATABLE, but therecord was locked by aretained lock
RECORDBUSY 107 The NOSUSPENDkeyword was specifiedand the record was lockedby an active lock
ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during the READoperation
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.
DUPKEY 140 A record has beenretrieved by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key follows.
Chapter 9. RESP2 values and their meanings 325
RESP2 values
Command Condition RESP2 Meaning
READNEXT FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT
LENGERR 10 Neither the LENGTH norSET options have beenspecified for a file withvariable-length records orfor a BDAM file withundefined-format records
11 The length of a recordread with the INTO optionspecified exceeds thevalue specified in theLENGTH option; therecord is truncated, andthe data areas supplied inthe LENGTH option is setto the actual length of therecord
13 An incorrect length isspecified for a file withfixed-length records
INVREQ 20 The FILE definition doesnot allow updates
INVREQ 25 The KEYLENGTH optionis specified for a genericbrowse (that is one whereGENERIC was specifiedon the STARTBR or thelast RESETBR) and thevalue of KEYLENGTHwas greater than the fullkey length
26 The KEYLENGTH optionis specified for anongeneric browse, andthe specified length doesnot equal the lengthdefined for the data set towhich this file refers
34 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand
326 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
37 The type of recordidentification used toaccess a data set duringthe browse is changed bythe READNEXT command
42 The KEYLENGTH optionis specified for a genericbrowse (that is one whereGENERIC was specifiedon the STARTBR or thelast RESETBR) and thevalue of KEYLENGTH isless than zero
52 CONSISTENT is notallowed because the file isnot a VSAM file that isaccessed in RLS mode
53 REPEATABLE is notallowed because the file isnot a VSAM file that isaccessed in RLS mode
54 UPDATE is not allowedbecause the file is not aVSAM file that isaccessed in RLS mode
55 NOSUSPEND is notallowed because the file isnot a VSAM file that isaccessed in RLS mode
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedis unsuccessful
ENDFILE 90 An end-of-file conditionhas been detected duringa browse
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
Chapter 9. RESP2 values and their meanings 327
RESP2 values
Command Condition RESP2 Meaning
LOCKED 106 The read requestspecified the UPDATEkeyword, or one of theread integrity keywordsCONSISTENT orREPEATABLE, or the fileresource definitionspecified read integrity,but VSAM held a retainedlock against the record
RECORDBUSY 107 NOSUSPEND wasspecified on the requestbut VSAM held an activelock against the record,which would cause therequest to wait
ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during theREADNEXT command
SYSIDERR 130 The SYSID optionspecifies a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.
DUPKEY 140 A record has beenretrieved by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key follows
READPREV FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT
LENGERR 10 Neither the LENGTH norSET options have beenspecified for a file withvariable-length records
328 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
11 The length of a recordread with the INTO optionspecified exceeds thevalue specified in theLENGTH option; therecord is truncated, andthe data area supplied inthe LENGTH option is setto the actual length of therecord
13 An incorrect length isspecified for a file withfixed-length records
INVREQ 20 The FILE definition doesnot allow updates
24 A READPREV commandis issued for a file forwhich the previousSTARTBR or RESETBRcommand has theGENERIC option
26 The KEYLENGTH optionis specified and thespecified length does notequal the length definedfor the data set this filerefers to
37 The type of recordidentification used toaccess a data set duringthe browse is changed
39 A READPREV is issuedfor a BDAM file
41 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand
52 CONSISTENT is notallowed because the file isnot a VSAM file that isaccessed in RLS-mode
53 REPEATABLE is notallowed because the file isnot a VSAM file that isaccessed in RLS-mode
Chapter 9. RESP2 values and their meanings 329
RESP2 values
Command Condition RESP2 Meaning
54 UPDATE is not allowedbecause the file is not aVSAM file that isaccessed in RLS-mode
55 NOSUSPEND is notallowed because the file isnot a VSAM file that isaccessed in RLS-mode
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedis unsuccessful
ENDFILE 90 An end-of-file conditionhas been detected duringa browse
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
LOCKED 106 The read requestspecified the UPDATEkeyword, or one of theread integrity keywordsCONSISTENT orREPEATABLE, or the fileresource definitionspecified read integrity,but VSAM held a retainedlock against the record
RECORDBUSY 107 NOSUSPEND wasspecified on the requestbut VSAM held an activelock against the record,which would cause therequest to wait
ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during the browse
330 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
SYSIDERR 130 The SYSID optionspecified a name that hasnot been defined to CICSas a remote system(defined by defining aCONNECTION); or thelink to the remote systemis closed.
DUPKEY 140 A record has beenretrieved by way of analternate index with theNONUNIQUEKEYattribute, and anotheralternate index record withthe same key exists
RECEIVE INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
RELEASE PGMIDERR 1 A program, table, or maphas no entry in the PPT
2 A program, table, or mapis disabled
9 The installed programdefinition is for a remoteprogram
INVREQ 5 An invalid attempt hasbeen made by a programto release itself
6 A RELEASE commandhas been issued for aprogram that is not loaded
7 A RELEASE commandhas been issued for aprogram that is loaded,without the HOLD option,by another task
17 A program has beendefined withRELOAD=YES. It must bereleased by a FREEMAINrather than a RELEASEcommand
Chapter 9. RESP2 values and their meanings 331
RESP2 values
Command Condition RESP2 Meaning
30 The program managerdomain has not yet beeninitialized
RESETBR FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT
INVREQ 25 The KEYLENGTH andGENERIC options arespecified and the lengthspecified in theKEYLENGTH option isgreater than or equal tothe length of a full key
26 The KEYLENGTH optionis specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers
36 The REQID, if any, doesnot match that of anysuccessful STARTBRcommand
42 The KEYLENGTH andGENERIC options arespecified, and the lengthspecified in theKEYLENGTH option isless than zero
51 A RESETBR command toa KSDS file that wasbeing accessed in RLSmode specified the RBAkeyword. RLS mode doesnot support RBA accessto KSDS data sets
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTFND 80 An attempt to retrieve arecord based on thesearch argument providedhas been unsuccessful
332 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during the file controloperation
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor theremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.
RESYNCENTRYNAME
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
RETURN INVREQ 1 A RETURN commandwith the TRANSID optionhas been issued by aprogram that is notassociated with a terminal
2 A RETURN commandwith the COMMAREA orIMMEDIATE option hasbeen issued in a programthat is not at the highestlogical level
4 A RETURN commandwith the TRANSID optionhas been issued in aprogram that is associatedwith an APPC logical unit
Chapter 9. RESP2 values and their meanings 333
RESP2 values
Command Condition RESP2 Meaning
8 A RETURN commandwith the INPUTMSGoption has been issuedfor a program that is notassociated with aterminal, or that isassociated with an APPClogical unit, or an IRCsession
30 PG domain is notinitialized. Parameters arenot allowed on the EXECRETURN statement infirst stage PLT programs
200 A RETURN command hasbeen issued with anINPUTMSG option in aprogram invoked by DPL
LENGERR 11 The COMMAREA lengthis less than 0 or greaterthan 32763
26 The COMMAREAADDRESS passed waszero, but the commarealength was non-zero
27 The INPUTMSG LENGTHwas less than 0 or greaterthan 32767
REWRITE FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT
LENGERR 10 The length option has notbeen specified for a filewith variable-lengthrecords, or for a BDAMfile with undefined formatrecords
12 The length specifiedexceeds the maximumrecord size
14 An incorrect length isspecified for a file withfixed-length records
334 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
INVREQ 30 A REWRITE commandhas been issued without atoken and no previousREAD for UPDATE (alsowithout a token) can befound
46 A REWRITE commandhas attempted to changethe length of a BDAMvariable length record orblock
47 A REWRITE instructionincluded a token whosevalue cannot be matchedagainst any token in usefor an existing READ forUPDATE request
55 NOSUSPEND is notallowed because the file isnot a VSAM file accessedin RLS mode
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOSPACE 100 No space is available onthe direct access devicefor adding the updatedrecord to the data set
103 For user-maintained datatables, CICS is unable toget sufficient storage inthe CICS address spaceto store the updated datatable entry
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
Chapter 9. RESP2 values and their meanings 335
RESP2 values
Command Condition RESP2 Meaning
LOCKED 106 When updating a recordvia a base key or analternate key, an attemptwas made to modify analternate key containedwithin the record (not thekey by which the updatewas made) and the newvalue of the alternate keyis the subject of aretained lock held byanother transaction
RECORDBUSY 107 The NOSUSPENDkeyword was specifiedand the record was foundto be locked by an activelock in VSAM
ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during the file controloperation
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.
DUPREC 150 An attempt has beenmade to rewrite a recordto a data set whoseupgrade set has analternate index with theUNIQUEKEY attribute, ifthe correspondingalternate key alreadyexists in the alternateindex
ROUTE INVREQ 4 Hours are out of range 5 Minutes are out of range 6 Seconds are out of range
336 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
200 BMS commands are notsupported for distributedprogram link
SEND INVREQ 200 A distributed program linkserver application hasattempted to send on itsfunction-shipping session(its principal facility) or, forSEND (APPC), adistributed program linkserver application hasspecified thefunction-shipping session(its principal facility) onthe CONVID option
SENDCONTROL
INVREQ 200 A distributed program linkserver application hasattempted to send on itsfunction-shipping session(its principal facility)
SEND MAP INVREQ 200 Command is not allowedfor a distributed programlink server program
SEND PAGE INVREQ 200 Command is not allowedfor a distributed programlink server program
SENDPARTNSET
INVREQ 200 Command is not allowedfor a distributed programlink server program
SEND TEXT INVREQ 200 Command is not allowedfor a distributed programlink server program
SEND TEXTMAPPED
INVREQ 200 A distributed program linkserver application hasspecified thefunction-shipping session(its principal facility) onthe CONVID option
Chapter 9. RESP2 values and their meanings 337
RESP2 values
Command Condition RESP2 Meaning
SEND TEXTNOEDIT
INVREQ 200 Command is not allowedfor a distributed programlink server program
SETAUTOINSTALL
INVREQ 1 VTAM is not in use in thissystem
2 The MAXREQS value isnot in the range 0–999
4 One of the modulesinvoked by DFHZATDX(DFHZATA andDFHZATD) cannot befound
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
PGMIDERR 3 The program namecannot be found
SETCONNECTION
INVREQ 1 ACQSTATUS|CONNSTATUSwas specified for anon-APPC connection
2 1. ACQUIRED specifiedwith OUTSERVICE
2. ACQUIRED specifiedfor OUTSERVICEconnection
3. OUTSERVICEspecified forACQUIREDconnection
3 ACQSTATUS|CONNSTATUShas an invalid CVDAvalue
4 SERVSTATUS has aninvalid CVDA value
5 PENDSTATUS orNOTPENDING wasspecified for a connectionthat is not APPC or IRC
6 PURGE was specified forconnection that is notVTAM
7 PURGETYPE has aninvalid CVDA value
8 PENDSTATUS has aninvalid CVDA value
338 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
11 SET command named aremote connection
12 EXITTRACING has aninvalid CVDA
13 ZCPTRACING has aninvalid CVDA
14 EXITTRACING|ZCPTRACINGspecified for a non-VTAMconnection or VTAM notinitialized
16 The resource whosename was specified byCONNECTION(data-value)is an indirect link
17 ACQSTATUS|CONNSTATUScannot be set whensystem initialized withISC=NO
18 NOTPENDING cannot beset for a connection whichhas successfullycompleted ExchangeLognames processing
19 CONNSTATUS cannot beset to ACQUIRED whenin the FREEING state
20 COMMIT, BACKOUT, orFORCE is not valid forthis type of connection
21 BACKOUT or FORCEwas specified, but wasunsuccessful. SomeUOWs remain shunted forthis connection
22 Other SET parameterswere included with theCANCEL orFORCECANCEL option
23 The resource whosename was specified byCONNECTION(name) isthe local TCT system entry(TCTSE)
25 Connection is still inservice
Chapter 9. RESP2 values and their meanings 339
RESP2 values
Command Condition RESP2 Meaning
26 RECOVSTATUS does nothave a value ofNORECOVDATA.ENDAFFINITY is invalid
30 Wrong connection type forENDAFFINITY. Affinitiescan exist only on LU6.1and LU6.2 connections
31 User PERFORMENDAFFINITY. TheNETID could not beobtained from the installedconnection. Therefore, toend affinity you must usethe PERFORMENDAFFINITY command
32 See messageDFHZC0178. VTAM couldnot end the affinity for areason other than 35(NOTFOUND) or 36(SESSIONS ACTIVE)
35 VTAM could not find anaffinity for this connection
36 VTAM could not end theaffinity because theconnection had somesessions active
37 See messageDFHZC0176. A VTAMerror prevented theCHANGE ENDAFFINmacro being carried out
44 GRSTATUS is not set toREGISTERED orDEREGISTERED
45 NORECOVDATA cannotbe set for a connectionthat is in service
46 NORECOVDATA wasspecified for a non-APPCconnection
SYSIDERR 9 The named connectioncould not be found
IOERR 10 Unexpected error NORMAL 58 AIDs are successfully
canceled NORMAL 59 No AIDs are canceled
340 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET DB2CONN INVREQ 1 Invalid ACCOUNTRECvalue
2 Invalid AUTHTYPE value 3 Invalid BUSY value 4 Invalid COMAUTHTYPE
value 5 Invalid CONNECTERROR
value 6 Invalid CONNECTST
value 7 Invalid NONTERMREL
value 9 Invalid PRIORITY value 10 Invalid SECURITY value 11 Invalid STANDBYMODE
value 12 Invalid THREADWAIT
value 13 Bad characters in
AUTHID 14 Bad characters in
COMAUTHID 15 Bad characters in DB2ID 16 Bad characters in
MSGQUEUE1 17 Bad characters in
MSGQUEUE2 18 Bad characters in
MSGQUEUE3 19 Bad characters in PLAN 20 Bad characters in
PLANEXITNAME 21 Bad characters in SIGNID 22 Bad characters in
STATSQUEUE 23 Both AUTHID and
AUTHTYPE specified 24 Both COMAUTHID and
COMAUTHTYPEspecified
Chapter 9. RESP2 values and their meanings 341
RESP2 values
Command Condition RESP2 Meaning
25 STANDBYMODE(NOCONNECT)andCONNECTERROR(SQLCODE)specified orCONNECTERROR(SQLCODE)specified whenSTANDBYMODE isNOCONNECT
26 Both PLAN andPLANEXITNAMEspecified
27 Invalid ACCOUNTRECvalue
28 COMTHREADLIMexceeds TCBLIMIT orCOMTHREADLIM > 2000or COMTHREADLIM < 0
29 PURGE CYCLE is toolow; that is, < 30 seconds
1. or PURGE CYCLEminutes < 0
2. or PURGE CYCLEseconds < 0
3. or PURGE CYCLEminutes > 59
4. or PURGE CYCLEseconds > 59
32 TCBLIMIT > 2000 orTCBLIMIT < 4
33 THREADLIMIT exceedsTCBLIMIT orTHREADLIMIT > 2000 orTHREADLIMIT < 3
34 Already connected 35 RCT suffix not allowed 36 RCT suffix not found 37 Wrong level RCT 39 DB2 not active 40 Insufficient authorization 41 Connection error 42 Invalid INIT parms 43 DB2ID cannot be set,
CONN active 44 DB2CONN partially
discarded 45 RCT suffix invalid
342 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
46 SET NOTCONNECTEDwhen the FORCE orWAIT option has beenspecified, but thistransaction is itself usingthe CICS DB2 interface
NORMAL 38 Waiting for DB2 (mayoccur following aCONNECTST with aCVDA of CONNECT)
NOTFND 1 There is no DB2TRANcurrently installed with thespecified name
NOTAUTH 100 Command authorizationfailure
101 Surrogate authorizationfailure
102 AUTHTYPE authorizationfailure
SET DB2ENTRY INVREQ 2 Invalid ACTION value 3 Invalid AUTHTYPE value 4 Invalid BUSY value 5 Invalid ENABLESTATUS
value 7 Invalid PRIORITY value 8 Invalid THREADWAIT
value 9 Bad characters in
AUTHID 10 Bad characters in PLAN 11 Bad characters in
PLANEXITNAME 12 Both AUTHID and
AUTHTYPE specified 13 Both PLAN and
PLANEXITNAMEspecified
14 Entry is disabling 15 PROTECTNUM greater
than THREADLIMIT orPROTECTNUM < 0 orPROITECTNUM > 2000
16 THREADWAIT must beTPOOL withTHREADLIMIT=0
Chapter 9. RESP2 values and their meanings 343
RESP2 values
Command Condition RESP2 Meaning
17 THREADLIMIT > 2000 orTHREADLIMIT < 0 orTHREADLIMIT >TCBLIMIT
18 Invalid ACCOUNTRECvalue
19 SET DISABLED when theFORCE ir WAIT optionhas been specified, butthis transaction itself isusing the DB2ENTRY
NOTAUTH 100 Command authorizationfailure
101 Resource authorizationfailure
102 Surrogate authorizationfailure
103 AUTHTYPE authorizationfailure
NOTFND 1 There is no DB2ENTRYcurrently installed with thespecified name
SET DB2TRAN INVREQ 2 Bad characters inTRANSID name
3 TRANSID already exisitsin another installedDB2TRAN
4 Bad characters inDB2ENTRY name
NOTAUTH 100 Command authorizationfailure
101 Resource authorizationfailure
102 Surrogate authorizationfailure
103 AUTHTYPE authorizationfailure
NOTFND 1 There is no DB2TRANcurrently installed with thespecified name
SETDELETSHIPPED
INVREQ 1 INTERVAL value is invalid
2 INTERVALHRS value isnot in the range 0-99
3 INTERVALMINS value isinvalid
4 INTERVALSECS value isinvalid
344 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
5 IDLE value is invalid 6 IDLEHRS value is not in
the range 0-99 7 IDLEMINS value is invalid 8 IDLESECS value is invalid NOTAUTH 100 The user associated with
the issuing task is notauthorized to use thiscommand
SET DSNAME DSNNOTFOUND 1 The named data setcannot be found
15 RECOVERED wasspecified, but the data setwas not found
INVREQ 3 ACTION has an invalidCVDA value
10 REMOVE was specified,but the data set isassociated with a filedefinition
12 REMOVE was specifiedwith another option. If youspecify remove, it must bethe only option present onthe command
13 REMOVE was specifiedbut a lock was held on thedata set by anotherINQUIRE or SETDSNAME command, or byCICS file controlprocessing.
14 RECOVERED wasspecified but CICS is notconfigured to support“backup while open”(BWO). Check that youhave a version ofMVS/DFP, DFHSM, andDFDSS that support BWO
16 RECOVERED wasspecified but the data sethas not been openedduring this CICS session,so the BWO attributes inthe ICF catalog cannot beset
Chapter 9. RESP2 values and their meanings 345
RESP2 values
Command Condition RESP2 Meaning
17 RECOVERED wasspecified for a BDAM dataset, or a VSAM path. Thisis not supported
18 RECOVERED wasspecified for a VSAMbase data set that hadFCTs open. This is notallowed.
19 RECOVERED wasspecified for an unknowndata set, or the data setwas not in the ‘forwardrecovered’ state
29 QUIESCESTATE isspecified, but theoperation is not supportedbecause DFSMS 1.3, orlater, is not installed
30 QUIESCESTATE has aninvalid CVDA value
31 BUSY has an invalidCVDA value
33 AVAILABILITY has aninvalid CVDA value data
34 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified, but is rejectedeither because q quiesceor unquiesce is alreadytaking place, or becauseDFSMSdss is currentlytaking a backup copy ofthe data set
36 A QUIESCESTATE valueof UNQUIESCED isspecified, but is rejectedby RLS either because anunquiesce is alreadytaking place, or becauseDFSMSdss is currentlytaking a backup copy ofthe data set
346 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
39 AVAILABILITY,QUIESCESTATE,RESETLOCKS or RETRYis specified for a data setthat is a BDAM data set
40 The CICS control block(DSNB) describing thedata set has been deleted(by the REMOVE option)by another task beforeCICS could process theSET command
41 QUIESCESTATE isspecified for a data setthat is not known toDFSMS as a VSAM dataset
42 An invalid CVDA isspecified forUOWACTION
43 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified withoutNOWAIT, and the issuingtask has updated the dataset, or is browsing thedata set, in the same unitof work. This is notallowed because:
� For QUIESCED thiswould result in adeadlock
� For IMMQUIESCEDthis would result inthe issuing task beingpurged
44 A SET DSNAMEREMOVE command hasbeen issued by anothertask. This has beendetected after this SETDSNAME command wasissued, but before theAVAILABILITY option isprocessed
46 FAILEDBKOUT, which isobsolete, is specified
Chapter 9. RESP2 values and their meanings 347
RESP2 values
Command Condition RESP2 Meaning
47 No file has been openedagainst the data set sincethe last cold start of thisCICS region, or since thefile definition was installedfor the data set
IOERR 20 RECOVERED wasspecified but an error wasraised on accessing theICF catalog. Ensure thatthe specified data set ison an SMS managedDASD and is known tothe SMS subsystem
21 RECOVERED wasspecified but an error wasraised by the CICS tablemanager program
35 QUIESCESTATE isspecified but theSMSVSAM server is notavailable
40 QUIESCESTATE isspecified, and anunexpected error occurredin DFSMS
48 The specified operationcannot be completedbecause the data set ismigrated. Recall the dataset and re-issue thecommand
49 An error was raised byDFSMS when reading theICF Catalog to establishthe base data set name
348 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
SUPPRESSED 37 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified, but the quiesceof the data set iscancelled by anotherparticipating CICS region.This could be for one ofthe following reasons:
� A user issued a SETDSNAMEUNQUIESCEDcommand
� AN XCFVSDS globaluser exit programsuppressed thequiesce
� AN XCFSREQ globaluser exit programsuppressed the closeof a file that is openagainst the data set
38 A QUIESCESTATE valueof QUIESCED orIMMQUIESCED isspecified, but the quiesceof the data set iscancelled by this CICSregion because thequiesce operation timedout. This is probably dueto a long-runningtransaction on anotherparticipating CICS regionpreventing the close of afile that is open againstthe data set
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET DUMPDS INVREQ 1 INITIALDDS has an
invalid value 2 SWITCHSTATUS has an
invalid CVDA value
Chapter 9. RESP2 values and their meanings 349
RESP2 values
Command Condition RESP2 Meaning
3 OPENSTATUS has aninvalid CVDA value
IOERR 4 OPEN or SWITCH causedan error opening a dataset
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SETENQMODEL
INVREQ 2 The attempt toenable/disble anENQMODEL failed,because a more genericENQMODEL is enabled
3 STATE has an invalidCVDA value
IOERR 4 The ENQMODEL is in theWAITING state
NOTFND 1 The specifiedENQMODEL is notinstalled on this system
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET FILE INVREQ 1 The named file isREMOTE
2 The named file is notCLOSED
3 The named file is notDISABLED
4 ADD has an invalid CVDAvalue
5 BROWSE has an invalidCVDA value
6 BUSY has an invalidCVDA value
7 DELETE has an invalidCVDA value
8 DISPOSITION has aninvalid CVDA value
9 EMPTYSTATUS has aninvalid CVDA value
10 LSRPOOLID wasspecified for a non-VSAMdata set
350 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
11 LSRPOOLID is not in therange 1–8, or thecorresponding buffer isnot defined
12 READ has an invalidCVDA value
13 STRINGS value is not inthe range 1–255, or this isnot a VSAM file
14 UPDATE has an invalidCVDA value
16 OPENSTATUS has aninvalid CVDA value
17 ENABLESTATUS has aninvalid CVDA value
19 DELETE has beenspecified for a non-VSAMfile
20 EMPTYSTATUS has beenspecified for a non-VSAMfile
21 CLOSED or DISABLEDhas been specified, butthis transaction has anincomplete requestagainst the file
22 ENABLED was specifiedfor a file that is currentlyDISABLING orUNENABLING
23 EXCLUSIVE has aninvalid CVDA value
24 EXCLUSIVE has beenspecified for a non-BDAMfile.
28 OPEN, CLOSE, ENABLEor DISABLE has beenspecified but an exitprogram running at exitpoint XFCSREQinstructed CICS not tocarry out the command
29 TABLE has an invalidCVDA value
30 MAXNUMREQS value isout of range
Chapter 9. RESP2 values and their meanings 351
RESP2 values
Command Condition RESP2 Meaning
31 The TABLE option isinvalid for a BDAM file(must be VSAM for a datatable.)
32 The TABLE option is notvalid for a file defined withthe REUSE option
33 The TABLE option isinvalid for a file defined asUNBLOCKED
34 The MAXNUMRECSoption is invalid for aBDAM file (must beVSAM for a data table.)
35 The MAXNUMRECSoption is invalid for a filedefined with the REUSEoption
36 The MAXNUMRECSoption is invalid for a filedefined as UNBLOCKED
37 The TABLE option isinvalid when LSRPOOL=0is specified
39 The USERTABLE optionis invalid when recordformat is not variable
40 CONSISTENT orREPEATABLE is specifiedfor a file that is notaccessed in RLS mode
41 The DSNB cannot bedisconnected for this filebecause the file hasdeferred workoutstanding, for whichthere are retained locks.This means there is atleast one shunted UOW,awaiting completion, thathas made changes to thisfile
352 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
42 The SET FILE requestcannot be satisfiedbecause the file hasdeferred workoutstanding, for whichthere are retained locks.This means there is atleast one shunted UOW,awaiting completion, thathas made changes to thisfile. The only valid optionswhen a file has deferredwork pending are thosethat change the file state.File state changes arepermitted because theymay be required to enablethe deferred work to becompleted
43 The file cannot bediscarded because it hasdeferred workoutstanding, for whichthere are retained locks.This means there is atleast one shunted UOW,awaiting completion, thathas made changes to thisfile
44 A file open request cannotbe satisfied because thefile references a data setthat has been marked asunavailable by a SETDSNAME UNAVAILABLEcommand
45 A file open request cannotbe satisfied because thefile references anRLS-mode data set thathas been quiesced by aSET DSNAMEQUIESCED command
Chapter 9. RESP2 values and their meanings 353
RESP2 values
Command Condition RESP2 Meaning
46 A file open request cannotbe satisfied because thefile references anRLS-mode data set that isbeing copied by aDFSMSdss-initiatednon-BWO backup
47 A file open request cannotbe satisfied because thefile references anRLS-mode data set that isin the process ofquiescing by a SETDSNAME QUIESCEDcommand
48 A file open request cannotbe satisfied because thefile references a data setfor which its ICF Catalogentry indicates that arecovery is pending, or isin progress (for example,a CICSVR job is running)
49 An invalid CVDA isspecified for theREADINTEG option
50 An attempt has beenmade to open an RLS filewhen RLS is notsupported
51 An invalid CVDA isspecified for theRLSACCESS option
52 An attempt has beenmade to specify RLSaccess for a BDAM dataset
53 An attempt has beenmade to specify aCICS-maintained datatable for a file defined withRLS access
354 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
54 A file open request cannotbe satisfied because ofone of the followingreasons:
� the file is beingopened in RLS modeand this region hasother files open innon-RLS modeagainst the data setwhich it references
� the file is beingopened in non-RLSmode and this regionhas other files openin RLS mode againstthe data set which itreferences
� the file is beingopened in non-RLSmode and this regionhas unresolved RLSrecovery work againstthe data set which itreferences
55 LOADTYPE has an invalidCVDA value
56 UPDATEMODEL has aninvalid CVDA value
57 EMPTYSTATUS has aCVDA value that is notallowed for a couplingfacility data table.EMPTYSTATUS must beNOEMPTYREQ for acoupling facility data table.
58 CFDTPOOL is notspecified for a file thatrefers to a coupling facilitydata table.
59 KEYLENGTH is notspecified for a file thatrefers to a coupling facilitydata table, and whichspecifies LOAD=NO
60 An invalid KEYLENGTH isspecified
Chapter 9. RESP2 values and their meanings 355
RESP2 values
Command Condition RESP2 Meaning
61 RECORDSIZE is notspecified for a file thatrefers to a coupling facilitydata table that specifiesLOAD=NO
62 An invalid RECORDSIZEis specified
63 Open is specified for a filethat refers to a couplingfacility data table, butOPEN processing hasfailed because:
� The file attributes donot match thosespecified when theCFDT was created, or
� A KEYLENGTH orRECORDSIZE hasbeen specified thatexceeds themaximum supported
64 OPEN is specified for afile that refers to acoupling facility data table,but OPEN processing hasfailed because the serveris not available
65 An invalid CDFTPOOLname is specified
66 An invalid TABLE name isspecified
67 An UPDATEMODEL ofCONTENTION isspecified for a recoverablecoupling facility data table.The update model mustbe LOCKING for acoupling facility data tablethat is recoverable
FILENOTFOUND 18 The named file cannot befound
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
356 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
IOERR * OPEN has failed inVSAM, and the RESP2field contains a VSAMresponse code
* CLOSE has failed inVSAM, and the RESP2field contains a VSAMresponse code
SET IRC INVREQ 1 A program required forIRC, DFHCRSP, isunavailable
2 OPENSTATUS has aninvalid CVDA value
4 CICS was initializedwithout IRC support(ISC=NO)
5 No connection has beendefined
6 The VTAM APPLID forthis CICS is blanks; IRCrequires a non-blankAPPLID
7 Another CICS using IRChas the same VTAMAPPLID as this one;unique names arerequired
8 IRC rejected the open ofthis CICS because it hadalready reached themaximum number oflogons
18 IRC support (the DFHIRPmodule) is below the levelrequired by this CICSsystem
NOSTG 9 CICS storage isinsufficient for the request
10 MVS storage isinsufficient (SVC blockrequest rejected)
Chapter 9. RESP2 values and their meanings 357
RESP2 values
Command Condition RESP2 Meaning
11 MVS storage isinsufficient (SUBSYSblock request rejected)
IOERR 12 IRC initialization failed 13 The log on to IRC failed 14 An attempt to attach the
node error transaction,CSNC, failed
15 An error occurred closingIRC
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SETJOURNALNAME
JIDERR 1 The specified journalname was not found
2 An error occurred duringan attempt to define thelog stream associatedwith the journal name, orthe journal name wasincorrectly specified
3 The specified journalname refers to aDASD-only log stream towhich a CICS region inanother MVS image iscurrently connected.
INVREQ 2 The request is invalid 3 The system log cannot be
changed 4 The ACTION option has
an invalid CVDA value 5 The STATUS option has
an invalid CVDA value n The ACTION option
specifies FLUSH or RESTfor a journal that is notcurrently connected to alog stream
358 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
IOERR 6 Either the log streamassociated with thejournal name cannot beopened, or the journalcannot be opened, or anunrecoverable error hasoccurred during theflushing of the log bufferto the log stream
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
SETJOURNALNUM
JIDERR 1 There are no valid optionssupported by thiscommand, which isobsolete. Use the SETJOURNALNAMEcommand
SETMODENAME
SYSIDERR 1 The connection cannot befound
2 The MODENAME withinthe connection cannot befound
INVREQ 3 MODENAME‘SNASVCMG’ wasspecified
4 The AVAILABLE value isout of range
5 AVAILABLE was specifiedbut CICS is not in sessionon this connection
6 CLOSED was specifiedwith AVAILABLE
7 ACQSTATUS has aninvalid CVDA value
8 This is not aparallel-session APPCgroup
Chapter 9. RESP2 values and their meanings 359
RESP2 values
Command Condition RESP2 Meaning
9 ACQUIRED was specifiedbut CICS is not in sessionon this connection
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET MONITOR INVREQ 1 STATUS has an invalidCVDA value
2 PERFCLASS has aninvalid CVDA value
3 EXCEPTCLASS has aninvalid CVDA value
4 EVENTCLASS has aninvalid CVDA value
5 CONVERSEST has aninvalid CVDA value
6 SYNCPOINTST has aninvalid CVDA value
7 The FREQUENCY valueis invalid
� Hours exceed 24,minutes or secondsexceed 59, or totalvalue is out of range
8 The FREQUENCYHRSvalue is out of range
9 The FREQUENCYMINvalue is out of range
10 The FREQUENCYSECvalue is out of range
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET NETNAME INVREQ 27 EXITTRACING has aninvalid CVDA value
29 The terminal is not aVTAM terminal
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
360 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
SET PROGRAM INVREQ 1 DISABLED orDPLSUBSET wasspecified for a programbeginning ‘DFH’
2 STATUS has an invalidCVDA value
3 NEWCOPY was specifiedand RESCOUNT is notequal to zero
4 SHARESTATUS has aninvalid CVDA value
5 COPY has an invalidCVDA value
6 COPY was specified for amodule currently loadedwith the HOLD option
9 CEDFSTATUS has aninvalid CVDA value
17 You have specified anoption that is invalid for aremote program(CEDFSTATUS, COPY,EXECUTIONSET orSHARESTATUS)
18 You have specified anoption that is invalid for amap set (CEDFSTATUSor EXECUTIONSET)
19 You have specified anoption that is invalid for apartition set(CEDFSTATUS orEXECUTIONSET)
20 EXECUTIONSET has aninvalid CVDA
PGMIDERR 7 The program, map set, orpartition set cannot befound
IOERR 8 The COPY option wasspecified but CICS couldnot locate the module
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 361
RESP2 values
Command Condition RESP2 Meaning
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
SETSTATISTICS
INVREQ 1 The INTERVAL value isout of range
2 The ENDOFDAY value isout of range
3 RECORDING has aninvalid CVDA value
4 The INTERVALHRS valueis out of range
5 The INTERVALMINSvalue is out of range
6 The INTERVALSECSvalue is out of range
7 More than one of theinterval values has beenused and the combinationeither exceeds 24 hoursor is less than 1 minute
8 The ENDOFDAYHRSvalue is out of range
9 The ENDOFDAYMINSvalue is out of range
10 The ENDOFDAYSECSvalue is out of range
11 RESETNOW orRECORDNOW has beenspecified, but theRECORDING state hasnot been changed
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SETSYSDUMPCODE
NOTFND 1 The dump code cannot befound
INVREQ 2 ACTION has an invalidCVDA value
4 SYSDUMPING has aninvalid CVDA value
5 The MAXIMUM value isout of range
362 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
6 SHUTOPTION has aninvalid CVDA value
7 REMOVE is specified withother options
9 The dump code is invalid 13 DUMPSCOPE has an
invalid CVDA value 14 RELATED requires
MVS/ESA 5.1 15 DAEOPTION has an
invalid CVDA value DUPREC 10 ADD is specified for a
dump code already in thesystem dump table
IOERR 11 An error occurredupdating the CICScatalog. The entry ischanged for the currentrun, but is not recordedfor restarts
NOSPACE 12 The CICS catalog full.The entry is changed forthe current run, but is notrecorded for restarts
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET SYSTEM INVREQ 1 The MAXTASKS value isout of range
3 The AKP value is out ofrange
5 TIME is not in the range100–3600000
6 The RUNAWAY value isout of range
7 MROBATCH is not in therange 1–255
9 DUMPING has an invalidCVDA value
12 AKP was specified, butCICS was initializedwithout keypointing
13 TIME is less thanSCANDELAY
14 PRTYAGING is not in therange 0–65535
Chapter 9. RESP2 values and their meanings 363
RESP2 values
Command Condition RESP2 Meaning
15 SCANDELAY is not in therange 0–5000
20 DSALIMIT is not in therange 2MB to 16MB
21 EDSALIMIT is not in therange 10MB to 2GB
22 There is insufficient MVSstorage to allocateDSALIMIT
23 There is insufficient MVSstorage to allocateEDSALIMIT
LENGERR 20 The GMMLENGTH valueis out of range
NOSTG 16 CICS reduced the valueyou requested forMAXTASKS because ofstorage constraints; seethe NEWMAXTASKSoption
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET TASK TASKIDERR 1 The task cannot be found 2 The task is protected by
CICS and not eligible formodification with thiscommand
INVREQ 3 PURGETYPE has aninvalid CVDA value
4 PRIORITY is not in therange 0–255
5 The task is not in a validstate for purging
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET TCLASS TCIDERR 1 The transaction classcannot be found
INVREQ 2 The MAXIMUM value isnot in the range 0–999
364 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET TCPIP INVREQ 4 TCPIP not available(TCPIP=NO)
5 TCPIP already closed (forSETCLOSED|IMMCLOSE)
6 TCPIP already open (forSET OPEN)
11 STATUS has an invalidCVDA value
12 The OPEN request didnot complete becauseanother task subsequentlyrequested a CLSOE ofCICS internal socketssupport
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SETTCPIPSERVICE
INVREQ 4 TCPIP is not available(TCPIP=NO)
4 TCPIP status is closed 7 Port in use 8 CICS is not authorized to
use this port 9 TCPIPSERVICE not
closed 10 Unknown IP address 11 Invalid value specified in
an operand of the SETcommand (either theSTATUS or theURMname is wrong)
12 Invalid status NOTFND 3 The named
TCPIPSERVICE is notfound
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET TDQUEUE QIDERR 1 The queue cannot befound
Chapter 9. RESP2 values and their meanings 365
RESP2 values
Command Condition RESP2 Meaning
INVREQ 2 TRIGGERLEVEL wasspecified for anextrapartition queue
3 The TRIGGERLEVELvalue is not in the range0–32767
4 ATITERMID was specifiedfor an extrapartition queue
5 ATITRANID was specifiedfor an extrapartition queue
6 ATIFACILITY wasspecified for anextrapartition queue
7 ATIFACILITY has aninvalid CVDA value
8 OPENSTATUS has aninvalid CVDA value
9 OPENSTATUS wasspecified for anintrapartition queue
10 ENABLESTATUS has aninvalid CVDA value
12 The queue is remote 13 The queue is indirect 15 OPENSTATUS was
specified for a DISABLEDqueue
16 OPENSTATUS wasspecified, but the JCLDDNAME to which thequeue definition pointswas not found
18 SET not possible becausethe queue was not closed
19 ATIUSERID was specifiedfor an extrapartition queue
20 The ESM interface is notinitialized
21 CICS has received anunknown response fromthe ESM
22 The ESM did not respond 30 Disabled pending
condition 31 SET not possible because
the queue was notdisabled
366 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
35 SET not possible becausethe queue is in-doubt
40 SET not possible becausethe queue is CXRF
IOERR 14 An error occurred openingor closing the data setassociated with the queue
17 The queue cannot be setCLOSED because there isno space in theassociated data set
NOTAUTH 23 The user named on theATIUSERID option is notauthorized
24 The user named in theATIUSERID has beenrevoked
25 During SECLABELprocessing by the externalsecurity manager, an erroroccurred. For informationabout security labels, seethe OS/390 SecurityServer (RACF) SecurityAdministrator’s Guide,SC28-1915
27 The user named in theATIUSERID option is notallowed to access thequeue
100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
102 The user associated withthe issuing task is not anauthorized surrogate forthe user specified inATIUSERID
USERIDERR 28 The user named inATIUSERID is not knownto the ESM
Chapter 9. RESP2 values and their meanings 367
RESP2 values
Command Condition RESP2 Meaning
SET TERMINAL INVREQ 1 TERMSTATUS orACQSTATUS wasspecified for IRC sessionsor non-VTAM terminal
2 TERMSTATUS orACQSTATUS has aninvalid CVDA value
4 ATISTATUS has aninvalid CVDA value
5 ATISTATUS changewould result in NOATI andNOTTI
6 CREATESESS wasspecified for non-VTAMterminal
7 CREATESESS has aninvalid CVDA value
9 PAGESTATUS has aninvalid CVDA value
11 Trying to put the issuingterminal OUTSERVICE
13 SERVSTATUS has aninvalid CVDA value
15 TERMPRIORITY valuenot in range 0–255
17 NOTTI cannot bespecified for the issuingterminal
18 TTISTATUS has aninvalid CVDA value
21 PURGETYPE has aninvalid CVDA value
22 TRACING has an invalidCVDA value
24 Invalid option requestedfor a remote terminal
25 ACQUIRED specified, butterminal is not inservice
26 PURGE specified, buttarget task hasSPURGE=NO on itsassociated transactiondefinition
27 EXITTRACING has aninvalid CVDA value
28 ZCPTRACING has aninvalid CVDA value
368 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
29 EXITTRACING orZCPTRACING specifiedfor non-VTAM terminal (orVTAM not installed)
31 This is a remote terminalwith no associatedsurrogate
33 SET TERMINAL is notvalid for an LU6.2 (APPC)session
34 A permanent transactionhas been defined for thisterminal (TRANSACTIONoperand in TERMINALdefinition)
35 Attempt made to changeTCAM CONTROL onnon-TCAM terminal
36 Invalid value supplied forTCAM CONTROL
37 Preset signon failed,terminal remainsOUTSERVICE
38 OBFORMATST has aninvalid CVDA value
39 RELREQST has aninvalid CVDA value
40 DISCREQST has aninvalid CVDA value
41 ALTPRTCOPYST has aninvalid CVDA value
42 PRTCOPYST has aninvalid CVDA value
43 UCTRANST has aninvalid CVDA value
44 Options would result inthe invalid combination ofthe alternate printer copystatus being set withoutan alternate printerdefined
45 Options would result inthe invalid combination ofthe alternate printer beingdefined without a primaryprinter defined
Chapter 9. RESP2 values and their meanings 369
RESP2 values
Command Condition RESP2 Meaning
46 OBFORMATST isspecified for a console or3790
48 Options would result inthe invalid combination ofthe printer copy statusbeing set without aprimary printer defined
50 VTAM not available forVTAM terminal
51 PRINTER andALTPRINTER optionspecified for a non-3270terminal
52 PRTCOPYST ofALTPRTCOPST optionspecified for a non-3270terminal
54 Option other thanPURGETYPE specifiedfor IRC session
57 Other SET parameterswere included with theCANCEL option
NORMAL 53 Purge deferred 58 AIDs are successfully
canceled 59 No AIDs are canceled 60 MAPNAME or
MAPSETNAME specified,but the terminal is not of atype supported by BMS
TERMIDERR 23 The named terminalcannot be found
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SETTRACEDEST
INVREQ 1 INSTATUS has an invalidCVDA value
2 A TABLESIZE value of <−1 has been specified
3 AUXSTATUS has aninvalid CVDA value
4 SWITCHSTATUS has aninvalid CVDA value
370 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
5 GTFSTATUS has aninvalid CVDA value
6 AUXPAUSE wasspecified, but auxiliarytracing is not active
11 SWITCHACTION has aninvalid CVDA value
IOERR 10 A SWITCH request or aSET AUXSTART requestresulted in an “open” errorfor the trace data set
NOSPACE 7 There is insufficient spacefor a new trace table
NOSTG 8 There is insufficient spacefor an auxiliary tracebuffer
9 There is insufficient spacefor a GTF trace buffer
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SETTRACEFLAG
INVREQ 1 SYSTEMSTATUS has aninvalid CVDA value
2 USERSTATUS has aninvalid CVDA value
3 SINGLESTATUS has aninvalid CVDA value
4 TCEXITSTATUS has aninvalid CVDA value
5 TCEXITSTATUS isspecified but VTAM is notinstalled
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SETTRACETYPE
NOTFND 1 At least one CICScomponent was notaccessible. Trace levelswere set for the othercomponents
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
Chapter 9. RESP2 values and their meanings 371
RESP2 values
Command Condition RESP2 Meaning
SETTRANCLASS
INVREQ 2 The MAXACTIVE value isnot in the range 0-999
3 The PURGETHRESHvalue is not in the range0-1000000
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
TCIDERR 1 The transaction classcannot be found
SETTRANDUMPCODE
NOTFND 1 The dump code cannot befound
INVREQ 2 ACTION has an invalidCVDA value
3 TRANDUMPING has aninvalid CVDA value
4 SYSDUMPING has aninvalid CVDA value
5 The MAXIMUM value isout of range
6 SHUTOPTION has aninvalid CVDA value
7 REMOVE is specified withother options
9 The dump code is invalid 13 DUMPSCOPE has an
invalid CVDA value 14 RELATED requires
MVS/ESA 5.1 DUPREC 10 ADD is specified for a
dump code already in thetransaction dump table
IOERR 11 An error occurredupdating the CICScatalog. The entry ischanged for the currentrun, but is not recordedfor restarts
NOSPACE 12 The CICS catalog is full.The entry is changed forthe current run, but is notrecorded for restarts
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
372 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
SETTRANSACTION
TRANSIDERR 1 The transaction cannot befound
INVREQ 2 PURGEABILITY has aninvalid CVDA value
3 STATUS has an invalidCVDA value
4 DISABLED has beenspecified for aCICS-supplied transaction
5 The TCLASS orTRANCLASS name is notknown
7 Tracing has an invalidCVDA value
8 DUMPING has an invalidCVDA value
9 The PRIORITY value isout of range
10 RUNAWAYTYPE has aninvalid CVDA value
11 SHUTDOWN has aninvalid CVDA value
12 USER has been specifiedwithout a RUNAWAYvalue
13 RUNAWAY has beenspecified without aRUNAWAYTYPE value ofUSER
14 The RUNAWAY value isout of range
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
SETTSQUEUE/TSQNAME
NOTFND 1 The TSQUEUE cannot befound
Chapter 9. RESP2 values and their meanings 373
RESP2 values
Command Condition RESP2 Meaning
INVREQ 1 The TSQUEUE was notdeleted becauseLASTUSEDINIT wasgreater than the interval,or because theTSQUEUE is in use
2 The action specified wasnot DELETE
3 LASTUSEDINIT wasspecified but has aninterval value; that is, anegative value
4 The filetype was not validfor the specified operation
POOLERR 0 POOLNAME wasspecified but the poolcould not be accessed
QIDERR 1 The QUEUE name wasinvalid (it was binaryzeroes)
SYSIDERR 0 SYSID was specified butthere was nocorresponding pool, or thepool was unavailable
3 The SYSID does not mapto a shared pool
5 I/O error on the couplingfacility
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
101 The user associated withthe issuing task is notauthorized to access thisparticular resource in theway required by thiscommand
SET UOW UOWNOTFOUND 1 The UOW cannot befound
INVREQ 3 UOWSTATE has aninvalid CVDA value
4 CICS is not in a validstate to COMMIT,BACKOUT, or FORCEthis UOW
374 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
NOTAUTH 100 The use of this commandis not authorized
SET UOWLINK UOWLNOTFOUND 1 The specified UOW-linkcannot be found
INVREQ 2 Resynchronization isalready in progress, or theUOW-link is already beingprocessed by anotherinstance of the SETUOWLINK command
3 The UOW is in-doubt, andthe UOW-link is thecoordinator of the commitor backout session. TheUOW must be forcedusing the SET UOWcommand before theUOW-link can be deleted
4 This is not a link createdby a connection, or is nota recoverable link
5 The UOW-link (and theassociated communicationsession) is still active
6 ACTION has an invalidCVDA value
7 The UOW-link has asuitable connectiondefinition, and cannot bedeleted
NOTAUTH 100 The use of this commandis not authorized
SET VOLUME VOLIDERR 1 This command isobsolete, and is retainedonly for compatibility withreleases of CICS earlierthan CICS for MVS/ESA5.1. It has no equivalentfunction in CICS forMVS/ESA 5.1 or laterreleases
SET VTAM INVREQ 1 VTAM is not present inthe system
2 OPENSTATUS has aninvalid CVDA value
Chapter 9. RESP2 values and their meanings 375
RESP2 values
Command Condition RESP2 Meaning
4 The PSDINTERVAL valueis out of range
5 The PSDINTHRS value isout of range
6 The PSDINTMINS valueis out of range
7 The PSDINTSECS valueis out of range
8 A PSDINTERVAL value >0 was specified in anXRF-eligible system
9 VTAM reported an errorwhile an attempt wasbeing made to set thePSD interval
10 A PSD interval has beenspecified but either theVTAM currently in use (orthe VTAM library usedwhen the terminal controltable was assembled)does not supportpersistent sessions. Theinterval may have beenspecified earlier than thiscommand; see thePSDINTERVALdescription. If OPEN wasalso requested, CICS hasopened the VTAM ACB
11 The ACB has openedsuccessfully, but an erroroccurred in at least one ofthe sessions thatpersisted from theprevious failure
12 Your OPEN request didnot complete becauseanother task subsequentlyrequested a close of theVTAM connection
13 An error occurred duringrecovery of sessions, andthe VTAM ACB will beclosed as a result
376 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
14 CICS is performingcleanup processingfollowing a predatory XRFtakeover. CICS rejectsOPEN requests with thiserror, without invokingVTAM, during this activity.OPEN requests areprocessed as usual assoon as cleanup iscomplete
16 Your attempt to deregisterCICS from a VTAMgeneric resource failedbecause CICS is notregistered as a member ofa generic resource group
IOERR n An error occurred duringthe opening of the ACB. IfCICS could not processthe request, the RESP2value is 3. If VTAMdetects the failure, CICSreturns the VTAM FDBK2code in RESP2: you canlook up these errors in theVTAM Programmingmanual, under ACBOPEN and CLOSE returncodes
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SET WEB INVREQ 11 An invalid value has been
supplied for STATUS,GARBAGEINT orTIMEOUTINT
NOTAUTH 100 The user associated withthe issuing task is notauthorized to use thiscommand
SIGNOFF INVREQ 1 No user is currentlysigned on
2 There is no terminal withthis task
Chapter 9. RESP2 values and their meanings 377
RESP2 values
Command Condition RESP2 Meaning
3 This task’s terminal haspreset security
4 Signoff is attempted usingtransaction routing withoutusing the CRTEtransaction
18 The CICS ESM interfacenot initialized
200 Command not allowed fora distributed program linkserver program
SIGNON NOTAUTH 1 A password is required 2 The supplied password is
wrong 3 A new password is
required 4 The new password is not
acceptable 5 An OIDCARD is required 6 The supplied OIDCARD is
wrong 16 The USERID is not
authorized to use thisterminal
17 The USERID is notauthorized to use theapplication
19 The USERID is revoked 20 The USERID’s access to
the specified group hasbeen revoked
21 The signon failed duringSECLABEL checking
22 The signon failed becauseESM is not currentlyaccepting signons
23 The GROUPID is notknown to the ESM
24 The USERID is notcontained in theGROUPID
INVREQ 9 The terminal alreadysigned on
10 No terminal associatedwith this task
11 This task’s terminal haspreset security
378 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
12 The response from CICSsecurity modules isunrecognized
13 There is an unknownreturn code in ESMRESPfrom the external securitymanager
14 The required nationallanguage is not available
15 Signon attempted viatransaction routing withoutusing the CRTEtransaction
18 The CICS ESM interfaceis not initialized
25 The terminal is of aninvalid type
27 The ESM is not active 28 The required national
language is invalid 29 The user is already
signed on. This relates tothe signon scopechecking
200 Command not allowed fora distributed program linkserver program
USERIDERR 8 The USERID is not knownto external securitymanager
30 The USERID is all blanksor nulls
SPOOLCLOSE INVREQ 4 Unsupported language 8 Unsupported function 40 Subsystem interface
already enabled
Note: Errors 1024 andover are internaland should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.
NOSPOOL 4 No subsystem present 8 Interface being disabled;
CICS is quiescing
Chapter 9. RESP2 values and their meanings 379
RESP2 values
Command Condition RESP2 Meaning
12 Interface has beenstopped
NOTOPEN 8 Dataset has not beenopened
NOTFND 1024 Input or output functionhas been corrupted, andSPOOLCLOSE could notcomplete
SPOOLOPENINPUT
ILLOGIC 3 Invalid CLASS valuespecified
INVREQ 4 Unsupported language 8 Unsupported function 16 USERID missing 36 INPUT|OUTPUT missing 40 Subsystem interface
already enabled
Note: Errors 1024 andover are internaland should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.
NOSPOOL 4 No subsystem present 8 Interface being disabled;
CICS is quiescing 12 Interface has been
stopped NOTFND 4 No data sets could be
located for retrieval for thespecified external writername
1024 Input or output functionhas been corrupted, andSPOOLCLOSE could notcomplete
NOTOPEN 8 Data set has not beenopened or a task whichhas not issued theSPOOLOPEN for a spooldata set has attempted toaccess it.
1024 Subtask OPEN macrofailure
380 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
OPENERR 4 A VSAM SHOWCB macrofailed to return the lengthsof the VSAM controlblocks used to access theJES spool file.
SPOLBUSY 4 Interface already in useby another task
8 Interface already in useby current task
SPOOLOPENOUTPUT
ILLOGIC 3 Invalid CLASS valuespecified
INVREQ 4 Unsupported language 8 Unsupported function 16 USERID missing 20 NODE missing 36 INPUT|OUTPUT missing 40 Subsystem interface
already enabled
Note: Errors 1024 andover are internaland should notoccur. If one ofthese error codesis returned contactyour IBM supportcenter.
44 Error in the OUTDESCRstring
48 OUTDESCR specified butfunction not available(wrong level of MVS orJES)
52 OUTDESCR specified butbad pointer found onkeyword or inOUTDESCR condition
NOSPOOL 4 No subsystem present 8 Interface being disabled;
CICS is quiescing 12 Interface has been
stopped NOTFND 4 No data sets could be
located for retrieval for thespecified external writername
NOTOPEN 8 Data set has not beenopened
Chapter 9. RESP2 values and their meanings 381
RESP2 values
Command Condition RESP2 Meaning
1024 Subtask OPEN macrofailure
OPENERR 4 A VSAM SHOWCB macrofailed to return the lengthsof the VSAM controlblocks used to access theJES spool file.
SPOLBUSY 4 Interface already in useby another task
8 Interface already in useby current task
SPOOLREAD ILLOGIC 3 Invalid CLASS valuespecified
INVREQ 4 Unsupported language 8 Unsupported function 12 Read attempt after end of
file 24 INTO missing 40 Subsystem interface
already enabled.
Note: Errors 1024 andover are internal,and should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.
NOSPOOL 4 No subsystem present 8 Interface being disabled;
CICS is quiescing 12 Interface has been
stopped NOTFND 4 No data sets could be
located for retrieval for thespecified external writername
NOTOPEN 8 Data set has not beenopened
12 Attempt to read an outputfile
1024 Subtask OPEN macrofailure
SPOLBUSY 4 Interface already in useby another task
8 Interface already in useby current task
SPOOLWRITE INVREQ 4 Unsupported language
382 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
8 Unsupported function 28 FROM missing 40 Subsystem interface
already enabled.
Note: Errors 1024 andover are internal,and should notoccur. If one ofthese error codesis returned,contact your IBMsupport center.
NOSPOOL 4 No subsystem present 8 Interface being disabled;
CICS is quiescing 12 Interface has been
stopped NOTOPEN 8 Spool report has not been
opened 16 Attempt to write an input
file 1024 Subtask OPEN macro
failure SPOLBUSY 4 Interface already in use
by another task 8 Interface already in use
by current task START INVREQ 4 Hours are out of range 5 Minutes are out of range 6 Seconds are out of range 11 An attempt was made to
ship a START requestwith the ATTACH option
Chapter 9. RESP2 values and their meanings 383
RESP2 values
Command Condition RESP2 Meaning
12 A START request with theATTACH option has failed
Note: RESP2 values of4, 5 and 6 arevalid only if issuingAT or AFTERoptions. WhenspecifyingINTERVAL, onlyEIBRESP ispassed with avalue of X'10' - noRESP2 value ispassed in thiscase
18 A USERID was specifiedand the CICS externalsecurity manager interfaceis not initialized
NOTAUTH 7 A resource security checkhas failed onTRANSID(name)
9 A surrogate user securitycheck has failed onUSERID(name)
USERIDERR 8 The specified USERID isnot known to the externalsecurity manager
10 The external securitymanager is in a statesuch that CICS cannotdetermine whether aspecified USERID is valid
STARTBR FILENOTFOUND 1 A file name referred to inthe FILE option cannot befound in the FCT andSYSID has not beenspecified
INVREQ 20 Browse operations are notallowed according to thefile entry specification inthe FCT
384 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
25 The KEYLENGTH andGENERIC options arespecified, and the lengthdefined for the data set towhich this file specified inthe KEYLENGTH option isgreater than or equal tothe length of a full key
26 The KEYLENGTH optionis specified (but theGENERIC option is notspecified), and thespecified length does notequal the length definedfor the data set to whichthis file refers
33 An attempt has beenmade to start a browsewith a REQID already inuse for another browse
42 The KEYLENGTH andGENERIC options arespecified, and the lengthspecified in theKEYLENGTH option isless than zero
44 The specified file is auser-maintained datatable
51 A STARTBR command toa KSDS file that wasbeing accessed in RLSmode specified the RBAkeyword. RLS mode doesnot support RBA accessto KSDS files
DISABLED 50 File is disabled
Chapter 9. RESP2 values and their meanings 385
RESP2 values
Command Condition RESP2 Meaning
NOTOPEN 60 The requested file isCLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but aCLOSE request against ithas been received or aSTARTBR command wasissued against a data setthat is quiesced, or isbeing quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED command
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTFND 80 An attempt to position ona record based on thesearch argument providedwas unsuccessful
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
LOADING 104 A STARTBR was issuedto a user-maintained datatable that is currentlybeing loaded
LOCKED 106 An attempt has beenmade to start a browse,but a retained lock existsagainst the key of the firstrecord in the range of thebrowse. After a LOCKEDresponse, the browse hasnot been started
ILLOGIC 110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during the file controloperation
386 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.
SYNCPOINT INVREQ 200 SYNCPOINT was in a
program that is linked tofrom a remote system thathas not specified theSYNCONRETURN option,or it was linked to locallyand is defined withEXECUTIONSET=DPLSUBSET
SYNCPOINTROLLBACK
INVREQ 200 SYNCPOINT ROLLBACKwas in a program that islinked to from a remotesystem that has notspecified theSYNCONRETURN option,or it was linked to locallyand is defined withEXECUTIONSET=DPLSUBSET
UNLOCK FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT andSYSID has not beenspecified
INVREQ 47 An unlock included atoken whose value cannotbe matched against anytoken in use for anexisting READ forUPDATE request
DISABLED 50 A file is disabled NOTOPEN 60 The requested file is
CLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but a closerequest against it hasbeen received
Chapter 9. RESP2 values and their meanings 387
RESP2 values
Command Condition RESP2 Meaning
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
ILLOGIC (VSAM andCICS-maintained datatables)
110 A VSAM error hasoccurred which does notfall within one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during the file controloperation
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.
VERIFYPASSWORD
NOTAUTH 2 The supplied password iswrong
3 A new password isrequired
19 The USERID is revoked USERIDERR 8 The USERID is not known
to the external securitymanager
INVREQ 13 There is an unknownreturn code in ESMRESPfrom the external securitymanager
18 The CICS externalsecurity manager interfaceis not initialized
29 The external securitymanager is notresponding
32 The userid field contains ablank character in aninvalid position
388 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
WAIT CONVID INVREQ 200 Command not supportedfor distributed programlink when it refers to theprincipal facility
WAIT EVENT INVREQ 2 The ECB address is a nullpointer, (X'00000000') or(X'FF000000')
3 The specified eventcontrol area address isabove the 16MB line forprograms executing in24-bit mode
4 The event control areaaddress is not aligned ona fullword boundary
6 The timer-event controlarea specified on a WAITEVENT is in use-keytask-lifetime storage, andis inaccessible to anothertransaction. This conditioncan only occur if thestorage for the timer-eventcontrol area is obtainedother than by an EXECCICS POST command,and is for posting as anECB by some other taskon completion of an event
WAITEXTERNAL
INVREQ 1 An ECB is not valid, forexample the ECB is notfullword aligned
2 An ECB is already beingwaited on
3 NUMEVENTS is not apositive number
4 PURGEABILITY isspecified with an incorrectCVDA
5 No valid ECBs have beenfound in the list becauseeither the ECBLISTaddress is not valid or allthe ECB addresses arenot valid
Chapter 9. RESP2 values and their meanings 389
RESP2 values
Command Condition RESP2 Meaning
6 The event control blocks(ECBs) specified are inuser-key task-lifetimestorage, and areinaccessible to anothertransaction that isexpected to post theECBs or the ECBsspecified are in read-onlystorage
WAITTERMINAL
INVREQ 200 A distributed program linkserver applicationspecified thefunction-shipping session(its principal facility) onthe CONVID option
WAITCICS INVREQ 1 An ECB is not valid, forexample the ECB is notfullword aligned
3 NUMEVENTS is not apositive number
4 PURGEABILITY isspecified with an incorrectCVDA
5 No valid ECBs have beenfound in the list, becauseeither the ECBLISTaddress is not valid, or allthe ECB addresses arenot valid
6 The event control block(ECBs) specified are inuser-key task-lifetimestorage, and areinaccessible to anothertransaction that isexpected to post theECBs or the ECBsspecified are in read-onlystorage
WRITE FILENOTFOUND 1 The file name referred toin the FILE option cannotbe found in the FCT
390 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
LENGERR 10 LENGTH is omitted for aWRITE to a file withvariable-length records orto a BDAM file withundefined-format records
12 The length specified forthe write operationexceeds the maximumrecord size; the record istruncated
14 An incorrect length isspecified for a writeoperation involvingfixed-length records
INVREQ 20 Add operations are notallowed according to thefile entry specification inthe FCT
23 When writing recordscontaining embeddedkeys, the key in therecord area (FROMoption) and the key inRIDFLD do not match
26 The KEYLENGTH optionis specified, and thespecified length does notequal the length definedfor the data set to whichthis file refers to
38 A WRITE with theMASSINSERT option hasbeen issued against aBDAM file
40 A BDAM key conversionerror has occurred
44 The WRITE commanddoes not conform to theformat of WRITE for auser-maintained datatable
Chapter 9. RESP2 values and their meanings 391
RESP2 values
Command Condition RESP2 Meaning
51 A WRITE commandspecifying the RBAkeyword was issuedagainst a KSDS file thatwas being accessed inRLS mode. RLS modedoes not support relativebyte address access toKSDS files
55 NOSUSPEND specifiedbut file is not RLS
DISABLED 50 A file is disabled NOTOPEN 60 The requested file is
CLOSED andUNENABLED or therequested file is OPENand in use by othertransactions, but aCLOSE request against ithas been received or aWRITE request wasissued against a data setthat is quiesced, or isbeing quiesced, as aresult of a SET DSNAMEQUIESCED orIMMQUIESCED command
ISCINVREQ 70 The remote systemindicated a failure thatdoes not correspond to aknown condition
NOSPACE 100 No space is available onthe direct access devicefor adding records to adata set
102 The maximum number oftable entries specified forthe user-maintained tablehas already been reached
103 CICS is unable to getsufficient storage in theCICS address space tocreate an in-memory tableentry for the record beingwritten
NOTAUTH 101 A resource security checkhas failed onFILE(filename)
392 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
LOADING 104 A WRITE is issued to auser-maintained datatable that is currentlybeing loaded
SUPPRESSED 105 A user exit program thatis invoked at the XDTADexit point decides not toadd the record to theuser-maintained datatable
LOCKED 106 An attempt was made towrite a record, but aretained lock existsagainst the key of thisrecord
RECORDBUSY 107 NOSUSPEND wasspecified on the requestbut VSAM held an activelock against the record,which would cause therequest to wait
ILLOGIC 110 A VSAM error hasoccurred that does not fallwithin one of the otherCICS response categories
IOERR 120 There has been an I/Oerror during the file controloperation or you are tryingto write to a BDAM trackaddress that is notdefined for a data set
SYSIDERR 130 The SYSID optionspecified a name that isneither the local nor aremote system (madeknown to CICS bydefining aCONNECTION); or thelink to the remote systemis closed.
DUPREC 150 An attempt has beenmade to add a record to adata set, by referring to afile, or a path over a file(with the UNIQUEKEYattribute), in which thesame key already exists
Chapter 9. RESP2 values and their meanings 393
RESP2 values
Command Condition RESP2 Meaning
WRITEOPERATOR
INVREQ 1 The TEXTLENGTH valueis not valid
2 The NUMROUTES valueis not valid
3 A ROUTECODE value isnot valid
4 The MAXLENGTH valueis not valid
5 The TIMEOUT value isnot valid
6 The ACTION value is notvalid
EXPIRED 7 TIMEOUT has occurredbefore the operator’s replywas received
LENGERR 8 The reply was longer thanMAXLENGTH, and hasbeen truncated
XCTL PGMIDERR 1 A program has no entry in
the PPT and eitherprogram autoinstall wasswitched off, or theprogram autoinstall controlprogram indicated that theprogram should no beautoinstalled
2 A program is disabled 3 A program cannot be
loaded because this wasthe first load of theprogram and the programload failed or this was asubsequent load of theprogram, but the first loadfailed
In order to reset the loadstatus the load modulemust be in the DFHRPLconcatenation, and a SETPROGRAM NEWCOPYwill be required
9 The installed programdefinition is for a remoteprogram
394 CICS User’s Handbook
RESP2 values
Command Condition RESP2 Meaning
21 The program autoinstallcontrol program failedeither because theprogram autoinstall controlprogram is incorrect,incorrectly defined, or asa result of an abend in theprogram autoinstall controlprogram. Programautoinstall is disabled andmessage DFHPG0202 orDFHPG0203 is written tothe CSPL
22 The model returned bythe program autoinstallcontrol program was notdefined in the PPT table,or was not enabled
23 The program autoinstallcontrol program returnedinvalid data
24 Define for the programfailed due to autoinstallreturning an invalidprogram name ordefinition
INVREQ 8 An XCTL command withthe INPUTMSG optionwas issued for a programthat is not associated witha terminal, or that isassociated with an APPClogical unit, or an IRCsession
29 EXEC XCTL is notallowed in a GLUE orTRUE
30 The program managerdomain has not yet beeninitialized
200 An XCTL command withthe INPUTMSG optionhas been issued in aprogram invoked by DPL
LENGERR 11 LENGTH is less than 0 orgreater than 32763
Chapter 9. RESP2 values and their meanings 395
RESP2 values
Command Condition RESP2 Meaning
26 The COMMAREA addresspassed was zero, butLENGTH was non zero
27 INPUTMSGLEN was lessthan 0 or greater than32767
28 LENGTH orINPUTMSGLEN is greaterthan the length of the dataarea specified in theCOMMAREA orINPUTMSG options, andwhile that data was beingcopied a destructiveoverlap occurred becauseof the incorrect length
NOTAUTH 101 A resource security checkhas failed onPROGRAM(name)
396 CICS User’s Handbook
Chapter 10. EXEC interface block (EIB) response andfunction codes
This appendix lists the response codes and the function codes of EXECCICS commands.
Response codes of EXEC CICS commandsAfter the execution of an EXEC CICS command, fields EIBRESP andEIBRCODE are set to indicate whether the command executed successfully,or whether a CICS condition was raised.
Each possible value of EIBRESP relates directly to a specific condition, nomatter which command caused the condition to be raised. This is not true forEIBRCODE values: both the value and the byte of EIBRCODE in which it isset depend on which command was issued.
The following sections list the conditions that are applicable to the EXECCICS commands described in this book, their corresponding RESP values(decimal), the associated EIBRCODE values (hexadecimal), and thetransaction abend codes (if any).
EXEC CICS DISCARD, INQUIRE, PERFORM, and SETcommandsThe first word of EIBRCODE for these commands is always set equal to thehexadecimal equivalent of the RESP value; the remaining bytes are set toX'00'.
Copyright IBM Corp. 1989, 1999 397
Condition (Byte 3) RESPValuecode code
EIBRCODE Abend
DSNNOTFOUND 93 5D AEX1DUPREC 14 0E AEINEND 83 53 AEXKFILENOTFOUND 12 0C AEILILLOGIC 21 15 AEIUINVREQ 16 10 AEIPIOERR 17 11 AEIQJIDERR 43 2B AEYGLENGERR 22 16 AEIVMODELIDERR 95 5F AEX3NOSPACE 18 12 AEIRNOSTG 42 2A —NOTAUTH 70 46 AEY7NOTFND 13 0D AEIMPARTNERIDERR 97 61 AEX5PGMIDERR 27 1B AEI0PROFILEIDERR 98 62 AEX6QIDERR 44 2C AEYHSYSBUSY 59 3B —SYSIDERR 53 35 AEYQTASKIDERR 91 5B AEXXTCIDERR 92 5C AEX0TERMIDERR 11 0B AEIKTRANSIDERR 28 1C AEI1
| UOWNOTFOUND| 102| 66| -USERIDERR 69 45 AEYXVOLIDERR 71 47 AEXV
EXEC CICS DISABLE, ENABLE, and EXTRACT EXITcommandsConditions that can be raised by the DISABLE, ENABLE, and EXTRACTEXIT commands are INVEXITREQ and NOTAUTH. There are no conditionsassociated with the RESYNC command.
Condition RESPValue
EIBRCODE Abend
INVEXITREQ 63 80 AEY0NOTAUTH 70 46 AEY7
398 CICS User’s Handbook
Function codes of EXEC CICS commandsThe function code (field EIBFN) is a hexadecimal value that identifies thecommand most recently issued by a task. The format of the EIBFN field isas follows:
ASM CL2
COBOL PIC X(2)
PL/I CHAR (2)
C CHAR variable name(2);
The function codes of the commands described in this book are listed belowin command sequence, then in function code sequence. For informationabout other function codes, see the CICS Application ProgrammingReference manual.
Command Code
ACQUIRE TERMINAL 86 02COLLECT STATISTICS 70 08CREATE CONNECTION 30 0ECREATE DB2CONN 30 20CREATE DB2ENTRY 30 22CREATE DB2TRAN 30 24
| CREATE DOCTEMPLATE| 30 2E| CREATE ENQMODEL| 30 2A
CREATE FILE 30 14CREATE JOURNALMODEL 30 1ECREATE LSRPOOL 30 16CREATE MAPSET 30 04CREATE PARTITIONSET 30 06CREATE PARTNER 30 18
| CREATE PROCESSTYPE| 30 26CREATE PROFILE 30 0ACREATE PROGRAM 30 02
| CREATE REQUESTMODEL| 30 2CCREATE SESSIONS 30 12
| CREATE TCPIPSERVICE| 30 30CREATE TDQUEUE 30 1CCREATE TERMINAL 30 10CREATE TRANCLASS 30 1ACREATE TRANSACTION 30 08
| CREATE TSMODEL| 30 28CREATE TYPETERM 30 0CDISABLE PROGRAM 22 04DISCARD AUTINSTMODEL 42 10DISCARD CONNECTION 58 10DISCARD DB2CONN 94 10DISCARD DB2ENTRY 94 30DISCARD DB2TRAN 94 50
Chapter 10. EXEC interface block (EIB) response and function codes 399
Command Code
| DISCARD DOCTEMPLATE| 9E 10| DISCARD ENQMODEL| 90 90
DISCARD FILE 4C 10DISCARDJOURNALMODEL
92 10
DISCARD JOURNALNAME 60 10DISCARD PARTNER 44 10
| DISCARD PROCESSTYPE| 96 10DISCARD PROFILE 46 10DISCARD PROGRAM 4E 10
| DISCARD| REQUESTMODEL| 9A 10
| DISCARD TCPIPSERVICE| 9C 10DISCARD TDQUEUE 5C 10DISCARD TERMINAL 52 10DISCARD TRANCLASS 5E 18DISCARD TRANSACTION 50 10
| DISCARD TSMODEL| 80 30ENABLE PROGRAM 22 02EXTRACT EXIT 22 06
| INQUIRE ACTIVITYID| 96 12INQUIRE AUTINSTMODEL 42 02INQUIRE AUTOINSTALL 68 12
| INQUIRE CFDTPOOL| 98 02INQUIRE CONNECTION 58 02
| INQUIRE CONTAINER| 96 14INQUIRE DB2CONN 94 02INQUIRE DB2ENTRY 94 22INQUIRE DB2TRAN 94 42INQUIRE DELETSHIPPED 68 22
| INQUIRE DOCTEMPLATE| 9E 02INQUIRE DSNAME 7A 02INQUIRE DUMPDS 66 02
| INQUIRE ENQMODEL| 90 82| INQUIRE EVENT| 96 16| INQUIRE EXCI| 7C 02
INQUIRE EXITPROGRAM 88 02INQUIRE FILE 4C 02INQUIRE IRC 6E 02INQUIRE JOURNALMODEL 92 02INQUIRE JOURNALNAME 60 12INQUIRE JOURNALNUM 60 02INQUIRE MODENAME 5A 02INQUIRE MONITOR 70 12INQUIRE NETNAME 52 16INQUIRE NETNAME 52 06INQUIRE PARTNER 44 02
| INQUIRE PROCESS| 96 18
400 CICS User’s Handbook
Command Code
| INQUIRE PROCESSTYPE| 96 02INQUIRE PROFILE 46 02INQUIRE PROGRAM 4E 02INQUIRE REQID 8A 02
| INQUIRE REQUESTMODEL| 9A 02| INQUIRE RRMS| 3A 02
INQUIRE STATISTICS 70 02INQUIRE STORAGE 5E 08INQUIRE STREAMNAME 92 12INQUIRE SYSDUMPCODE 66 22INQUIRE SYSTEM 54 02INQUIRE TASK 5E 02INQUIRE TCLASS 5E 12
| INQUIRE TCPIP| 9C 12| INQUIRE TCPIPSERVICE| 9C 02
INQUIRE TDQUEUE 5C 02INQUIRE TERMINAL 52 02INQUIRE TERMINAL 52 12
| INQUIRE TIMER| 96 38INQUIRE TRACEDEST 78 02INQUIRE TRACEFLAG 78 12INQUIRE TRACETYPE 78 22INQUIRE TRANCLASS 5E 1AINQUIRETRANDUMPCODE
66 12
INQUIRE TRANSACTION 50 02| INQUIRE TSMODEL| 80 22| INQUIRE TSPOOL| 80 1A| INQUIRE TSQNAME| 80 12
INQUIRE TSQUEUE 80 02INQUIRE UOW 90 02INQUIRE UOWDSNFAIL 90 62INQUIRE UOWENQ 90 22INQUIRE UOWLINK 90 42INQUIRE VOLUME 62 02INQUIRE VTAM 68 02
| INQUIRE WEB| 9C 22PERFORM DELETSHIPPED 68 26PERFORM DUMP 7E 04PERFORM ENDAFFINITY 58 06PERFORM RESETTIME 72 02PERFORM SECURITY 64 02PERFORM SHUTDOWN 76 02PERFORM STATISTICS 70 06RESYNC ENTRYNAME 16 04SET AUTOINSTALL 68 14SET CONNECTION 58 04SET DB2CONN 94 04
Chapter 10. EXEC interface block (EIB) response and function codes 401
Command Code
SET DB2ENTRY 94 24SET DB2TRAN 94 44SET DELETSHIPPED 68 24SET DSNAME 7A 04SET DUMPDS 66 04
| SET ENQMODEL| 90 84SET FILE 4C 04SET IRC 6E 04SET JOURNALNAME 60 14SET JOURNALNUM 60 04SET MODENAME 5A 04SET MONITOR 70 14SET NETNAME 52 08
| SET PROCESSTYPE| 96 04SET PROGRAM 4E 04SET STATISTICS 70 04SET SYSDUMPCODE 66 24SET SYSTEM 54 04SET TASK 5E 04SET TCLASS 5E 14
| SET TCPIP| 9C 14| SET TCPIPSERVICE| 9C 04
SET TDQUEUE 5C 04SET TERMINAL 52 04SET TERMINAL 52 14SET TRACEDEST 78 04SET TRACEFLAG 78 14SET TRACETYPE 78 24SET TRANCLASS 5E 1CSET TRANDUMPCODE 66 14SET TRANSACTION 50 04
| SET TSQNAME| 80 14| SET TSQUEUE| 80 04
SET UOW 90 04SET UOWLINK 90 44SET VOLUME 62 04SET VTAM 68 04
| SET WEB| 9C 24
Code Command
16 04 RESYNC ENTRYNAME22 02 ENABLE PROGRAM22 04 DISABLE PROGRAM22 06 EXTRACT EXIT30 0A CREATE PROFILE30 0C CREATE TYPETERM
402 CICS User’s Handbook
Code Command
30 0E CREATE CONNECTION30 02 CREATE PROGRAM30 04 CREATE MAPSET30 06 CREATE PARTITIONSET30 08 CREATE TRANSACTION30 1A CREATE TRANCLASS30 1C CREATE TDQUEUE30 1E CREATE JOURNALMODEL30 10 CREATE TERMINAL30 12 CREATE SESSIONS30 14 CREATE FILE30 16 CREATE LSRPOOL30 18 CREATE PARTNER30 20 CREATE DB2CONN30 22 CREATE DB2ENTRY30 24 CREATE DB2TRAN
| 30 26| CREATE PROCESSTYPE| 30 28| CREATE TSMODEL| 30 2A| CREATE ENQMODEL| 30 2C| CREATE REQUESTMODEL| 30 2E| CREATE DOCTEMPLATE| 30 30| CREATE TCPIPSERVICE| 3A 02| INQUIRE RRMS
42 02 INQUIRE AUTINSTMODEL42 10 DISCARD AUTINSTMODEL44 02 INQUIRE PARTNER44 10 DISCARD PARTNER46 02 INQUIRE PROFILE46 10 DISCARD PROFILE4C 02 INQUIRE FILE4C 04 SET FILE4C 10 DISCARD FILE4E 02 INQUIRE PROGRAM4E 04 SET PROGRAM4E 10 DISCARD PROGRAM50 02 INQUIRE TRANSACTION50 04 SET TRANSACTION50 10 DISCARD TRANSACTION52 02 INQUIRE TERMINAL52 04 SET TERMINAL52 06 INQUIRE NETNAME52 08 SET NETNAME52 10 DISCARD TERMINAL52 12 INQUIRE TERMINAL52 14 SET TERMINAL52 16 INQUIRE NETNAME54 02 INQUIRE SYSTEM54 04 SET SYSTEM
Chapter 10. EXEC interface block (EIB) response and function codes 403
Code Command
58 02 INQUIRE CONNECTION58 04 SET CONNECTION58 06 PERFORM ENDAFFINITY58 10 DISCARD CONNECTION5A 02 INQUIRE MODENAME5A 04 SET MODENAME5C 02 INQUIRE TDQUEUE5C 04 SET TDQUEUE5C 10 DISCARD TDQUEUE5E 02 INQUIRE TASK5E 04 SET TASK5E 08 INQUIRE STORAGE5E 1A INQUIRE TRANCLASS5E 1C SET TRANCLASS5E 12 INQUIRE TCLASS5E 14 SET TCLASS5E 18 DISCARD TRANCLASS60 02 INQUIRE JOURNALNUM60 04 SET JOURNALNUM60 10 DISCARD JOURNALNAME60 12 INQUIRE JOURNALNAME60 14 SET JOURNALNAME62 02 INQUIRE VOLUME62 04 SET VOLUME64 02 PERFORM SECURITY66 02 INQUIRE DUMPDS66 04 SET DUMPDS66 12 INQUIRE TRANDUMPCODE66 14 SET TRANDUMPCODE66 22 INQUIRE SYSDUMPCODE66 24 SET SYSDUMPCODE68 02 INQUIRE VTAM68 04 SET VTAM68 12 INQUIRE AUTOINSTALL68 14 SET AUTOINSTALL68 22 INQUIRE DELETSHIPPED68 24 SET DELETSHIPPED68 26 PERFORM DELETSHIPPED6E 02 INQUIRE IRC6E 04 SET IRC70 02 INQUIRE STATISTICS70 04 SET STATISTICS70 06 PERFORM STATISTICS70 08 COLLECT STATISTICS70 12 INQUIRE MONITOR70 14 SET MONITOR72 02 PERFORM RESETTIME76 02 PERFORM SHUTDOWN
404 CICS User’s Handbook
Code Command
78 02 INQUIRE TRACEDEST78 04 SET TRACEDEST78 12 INQUIRE TRACEFLAG78 14 SET TRACEFLAG78 22 INQUIRE TRACETYPE78 24 SET TRACETYPE7A 02 INQUIRE DSNAME7A 04 SET DSNAME
| 7C 02| INQUIRE EXCI7E 04 PERFORM DUMP80 02 INQUIRE TSQUEUE
| 80 04| SET TSQUEUE| 80 12| INQUIRE TSQNAME| 80 14| SET TSQNAME| 80 1A| INQUIRE TSPOOL| 80 22| INQUIRE TSMODEL| 80 30| DISCARD TSMODEL
86 02 ACQUIRE TERMINAL88 02 INQUIRE EXITPROGRAM8A 02 INQUIRE REQID90 02 INQUIRE UOW90 04 SET UOW90 22 INQUIRE UOWENQ90 42 INQUIRE UOWLINK90 44 SET UOWLINK90 62 INQUIRE UOWDSNFAIL
| 90 82| INQUIRE ENQMODEL| 90 84| SET ENQMODEL| 90 90| DISCARD ENQMODEL
92 02 INQUIRE JOURNALMODEL92 10 DISCARD JOURNALMODEL92 12 INQUIRE STREAMNAME
| 94 02| INQUIRE DB2CONN| 94 04| SET DB2CONN| 94 10| DISCARD DB2CONN| 94 22| INQUIRE DB2ENTRY| 94 24| SET DB2ENTRY| 94 30| DISCARD DB2ENTRY| 94 42| INQUIRE DB2TRAN| 94 44| SET DB2TRAN| 94 50| DISCARD DB2TRAN| 96 02| INQUIRE PROCESSTYPE| 96 04| SET PROCESSTYPE| 96 10| DISCARD PROCESSTYPE| 96 12| INQUIRE ACTIVITYID| 96 14| INQUIRE CONTAINER| 96 16| INQUIRE EVENT| 96 18| INQUIRE PROCESS
Chapter 10. EXEC interface block (EIB) response and function codes 405
Abend codes � DFH messages
Code Command
| 96 38| INQUIRE TIMER| 98 02| INQUIRE CFDTPOOL| 9A 02| INQUIRE REQUESTMODEL| 9A 10| DISCARD REQUESTMODEL| 9C 02| INQUIRE TCPIPSERVICE| 9C 04| SET TCPIPSERVICE| 9C 10| DISCARD TCPIPSERVICE| 9C 12| INQUIRE TCPIP| 9C 14| SET TCPIP| 9C 22| INQUIRE WEB| 9C 24| SET WEB| 9E 02| INQUIRE DOCTEMPLATE| 9E 10| DISCARD DOCTEMPLATE
406 CICS User’s Handbook
DFH messages
Chapter 11. DFH messages
While CICS is running, it can produce several types of messages:
� Console messages advise the system operator of execution progress, orrequest a decision.
� Certain CICS-supplied support programs communicate directly withterminal operators.
� CICS management modules and support programs log significant eventsand error occurrences to transient data destinations; for example, to thecontrol system master terminal (CSMT), or to the CICS database controllog (CDBC) for the CICS-DBCTL interface.
� The CICS message switching program (DFHMSP) generates messageswitching responses (described in the CICS Supplied Transactionsmanual).
� CICS directs informational macro notes (mnotes) to programmers (theseare not documented).
� Messages produced by CICS/ESA utility programs such as DFH$MOLSand DFHMNDUP. These messages are self-explanatory and are notdocumented.
All of the CICS messages described in this book can also be viewed onlineusing the CICS transaction CMAC. For guidance on using CMAC, see theCICS Supplied Transactions manual.
Message IdentifiersMessage identifiers are of two types.
DFHnnnn identifiersThese consist of the prefix “DFH” followed by a four digit message number.“DFH” is the IBM assigned identifier for CICS modules. The first two digitsare the CICS module reference code as follows:01 DFHSSIN
42 DFHZCNR
51 DFHCSDUP
52 DFHCSDUP
55 DFHCSDUP
56 DFHCSDUP
7x Command-level translators
The last two digits are assigned by CICS to identify the message or group ofmessages within an assembled program.
Copyright IBM Corp. 1989, 1999 407
DFH messages
DFHccnnnn identifiersThese consist of the prefix “DFH” followed by a two-letter componentidentifier (cc), and a four-digit message number (nnnn). The componentidentifier shows the domain or the component which issues the message.Here is a list of component identifiers with associated domains andcomponents:AC The abnormal condition
program component
AI The auto-install terminal modelmanager (AITM)
AM The RDO allocation manager
AP The application domain
AU The transaction affinities utility
BA The Business ApplicationManager (BAM) domain
BR Bridging to 3270 transactions
CA RDO command utility routine
CC The CICS catalog domain (localand global)
CE The sign on programcomponent
CF CICS coupling facility datatables server
CP The CPI Communicationscomponent
CR The ISC remote schedulercomponent
CZ The CICS class librariesdomain
DB The CICS database controlcomponent
DD The directory manager
DM The domain manager domain
DS The dispatcher domain
DU The dump domain
DX The CICS database controlcomponent
EM The Event Manager domain
ER The user backout program
EX The external CICS interface
FC The file control component
FE The FE terminal test programcomponent
IC The interval control program
IN The indoubt testing tool
IR The interregion component
JC The online journal controlcomponent
KC The transaction/profile manager
KE The kernel domain
LD The loader domain
LG The logger domain
LM The lock manager domain
MC The BMS message controlprogram component
ME The message domain
MN The monitor domain
MU The message editing utilityprogram
MV The MVS RESMGR exit stub
NQ The enqueue manager domain
PA The parameter managerdomain
408 CICS User’s Handbook
DFH messages
PC The program control programcomponent
PD The print dump exit routineDFHPDX
PG The program manager domain
PR The partner resource manager
PS The system spooler interfacecontrol module component
RD The RDO allocation manager
RM The recovery Manager
RP CICS ONC RPC
RS The communicationsresynchronization program
RT The ISC transaction routingcomponent
RU The recovery utility program
RX The RRS-coordinated EXCIdomain
SH The Scheduler domain
SI The system initializationcomponent
SK The sub task control programcomponent
SM The storage manager domain
SN The signon component
SO The CICS sockets domain
SR The system recoverycomponent
ST The statistics domain
SZ The front end programminginterface (FEPI)
TC The terminal control programcomponent
TD The transient data component
TF The terminal facility manager
TI The timer domain
TM The system terminationprogram component
TO The terminal object resolutionprogram component
TP The BMS terminal pageretrieval program component
TR The trace domain
TS The temporary storage domain
UP The measured usage licensecharging support macro
US The user domain
WB The CICS Web Interface
XA The XRF alternate component
XC The XRF CICS availabilitymanager
XG The XRF general component
XM The transaction manager
XO The XRF CICS availabilitymanager
XQ The shared temporary storagequeue pool server
XS The CICS security component
ZC The terminal control working setcomponent
ZE The TCP error message writercomponent
ZN The syncpoint componentThus the CICS message DFHAP0002 is issued from the application domain,identified by the two-character identifier AP.
Chapter 11. DFH messages 409
DFH messages
Action codesCertain messages (for example, DFHDB8208D) include an action code afterthe message identifier. Action codes give guidance to the operator of thetype of action needed when the message appears on the system console.The following action codes are used:
A Immediate action (for example, mount a tape)
D Immediate decision (reply to a request, for example, enter “GO” or“CANCEL”)
E Eventual – action is required, but does not have to be takenimmediately
I No action required (If issued via the message domain, these messagescan be suppressed by specifying MSGLVL=0 as a system initializationoverride.)
Severity codesCertain messages, especially those associated with messages to terminaloperators and messages which come from CICS utilities, have a severitycode. (DFHST0210 I, is an example.) A severity code indicates to theoperator whether a message is associated with an error, and if so, howserious it is. The following severity codes are used:
E Error. Something has gone wrong and action is required of the userbefore CICS processing can continue.
I Information only. No action is required.
W Warning. Something may have gone wrong, a program loop forexample, but CICS processing continues.
S Severe error. Something serious has gone wrong and immediate actionis required. CICS processing is suspended until action has been taken.
410 CICS User’s Handbook
DFH messages
Format of informationInformation about each message is presented in the following format:
� Message identifier – in the form DFHnnnn or DFHccnnnn
� Message text – the words and inserts which make up the message asdisplayed in CICS
� Explanation – the events leading to or following the production of themessage
� System action – the action that has been or will be taken by CICS
� User response – the action recommended for the user (the console orterminal operator or system programmer)
� Destination – the device or log to which the message is sent. This isone of the following:
– Console – refers to a terminal type attached to CICS. (Route codesare 2 and 11 unless otherwise stated.)
– Terminal end user
– TERMCDBC – terminals running the CDBC transaction.
– SYSPRINT (System printer)
– One of the following transient data queues:
CADL VTAM resource definition logCAFF Transaction affinities utility messagesCAIL Autoinstall terminal model manager (AITM) logCCPI Common programming interface for communications (CPI
Communications) messagesCDBC CICS-DBCTL interface logCDB2 CICS DB2 messagesCDUL Transaction dump messagesCMIG Migration log for messages reporting the use of functions
that are no longer supportedCPLD PL/I dumpsCPLI PL/I sysprint outputCRDI Log for installed resource definitionsCRPO ONC RPC messagesCSDL CEDA command logCSCS Sign on/off security logCSFL File allocation and related messagesCSKL Log for transaction and profile resource definitionsCSMT Write term errors and abends from DFHTACP and
DFHACPCSPL Log for program resource definitions
Chapter 11. DFH messages 411
DFH messages
CSQL TDQUEUE messagesCSRL Log for partner resource definitionsCSSL Statistics logCSTL Term I/O error messages from DFHTACPCSML Sign on/off messagesCSNE Terminal error messages issued from DFHZNAC.CSZL FEPI message queueCWBO CICS Web Interface messages
Note: Destination CXRF is used by the alternate CICS system inan XRF environment until the other destinations are madeavailable during the takeover.
� Module(s) – the name(s) of the module or modules that determined thatthe message should be sent. (This is not necessarily the module thatissued the macro to write the message.)
XMEOUT parameters –Messages that can drive the XMEOUT global user exit include a list ofXMEOUT parameters. The XMEOUT exit allows you to suppress or reroutemessages that use the message domain. For programming informationabout the XMEOUT user exit see the CICS Customization Guide
Route codes –Console messages can be sent to a number of console types. The type ofconsole to which a particular message is sent is determined by the MVSroute code. Each route code maps onto one console type. The meanings ofthe route codes normally used by CICS are as follows:
Code Meaning1 Master console action – indicates a change in system status
demanding operator action2 Master console information – indicates a change in system status
(system default)3 Tape pool status or other tape related information4 Direct access pool status or other related information5 Tape library information6 Disk library information7 Unit record pool information8 Teleprocessing control status9 System security checking
Note: This route code suppresses the operator’s reply on thescreen and on SYSLOG
10 System error or maintenance information
412 CICS User’s Handbook
DFH messages
11 Programmer information for the MVS log
Unless otherwise stated, console messages have the route codes ‘2’ and‘11’.
Message editing –You can use the message editing utility to change the text or language ofthose CICS messages that are issued via the message domain. Messagesthat cannot be changed using the utility include a note to this effect beforethe message destination. See the CICS Operations and Utilities Guide formore information about the message editing utility.
Console message reformatting –The “console message handling facility” is an optional feature of the CICSsubsystem that can affect the appearance of CICS messages displayed onan MVS console. It is effective when you specify FORMATMSG=YES as aninitialization parameter for the CICS subsystem, as described in the CICSTransaction Server for OS/390 Installation Guide. When this facility is used,it affects messages displayed on MVS system consoles in the followingways:
� The subsystem tries to ensure that all console messages issued by allCICS regions have a standard format. The standard format is:
Column number: 1 13 22
| | |
+DFHnnnn applid message-text
The “plus” sign (+) is added by MVS to indicate that a problem-stateprogram issued the message. It is not present when CICS issues themessage while it is in supervisor state.
The applid inserted into the message is the specific application identifier.This is the identifier that is specified in the system initializationparameter APPLID. It is the only operand when XRF=NO is alsospecified, or the second operand when XRF=YES is also specified.
� The subsystem adds routecodes specified in the ROUTECODESsubsystem initialization parameter, so the messages might be sent tomore console destinations than those implied in the body of this book.
� The subsystem reformats messages for all CICS releases, even thoseissued by CICS/OS/VS Version 1.
� The subsystem does not reformat messages that are issued by a CICSregion that has not yet determined its applid. This includes messagesthat are issued while processing the system initialization table and itsoverrides.
Chapter 11. DFH messages 413
DFH messages
� The subsystem routine that reformats the messages does not receivecontrol until after the message has been recorded in the CICS job’s joblog. Therefore, the reformatting is not usually apparent in the job log.
� Messages issued by the message domain already contain the applid.The subsystem does not insert the applid into such messages, but itmight insert blank characters to cause alignment into standard locations.
� If the original CICS message is a long one, adding the applid in thestandard position might cause the message to exceed the maximumlength for an MVS console message. In this case, the original messageis suppressed (does not appear on the console), and a new message isissued using the MVS multiple-line console message service to split themessage over several lines. Both the original message and perhapsseveral instances of the reformatted multiple-line message appear in thejob log, but only one copy of the reformatted message is displayed onthe console.
� For some messages where the applid normally follows a time and datestamp, inserting the applid in the standard position would have resultedin the applid being duplicated within the message. For these messages,the subsystem eliminates the time and date stamp, since they areavailable from other sources, and only one occurrence of the applid isshown.
Terminal identifiers –Some messages include a terminal identifier (termid) in the message text.This is normally shown as a 4-character identifier. However, when CICScannot completely identify a terminal – for example, when intersystemcommunication is taking place, the terminal identifier is prefixed by theapplication identification (applid) of the system owning the terminal.
Abend code inserts –The transaction abend code insert (abcode) in some CICS messages isdisplayed as ‘????’ when neither the EXEC CICS ABEND request nor theDFHPC TYPE=ABEND macro request specifies an abend code.
Dumps –A dump is generally available for printing when a CICS system abend orabnormal termination occurs, provided the relevant data set has beenspecified. The dump can be used for problem determination.
414 CICS User’s Handbook
DFH messages
Terminology –The terms “abnormally terminates” and “abnormal termination” are frequentlyused in a general sense to relate, as applicable, to one of the following:
� The termination of CICS as a result of an MVS ABEND macro. (Theterm “abend” may also be used.)
� The termination of a transaction (task) as a result of a CICS transactionABEND macro.
MVS user abend codesDFH messages which accompany a CICS system, utility, or subtask abendhave an associated MVS user abend code. Where possible, the value of thiscode is the numeric part of the corresponding DFH message. ThusDFH0305 has an 0305 user abend code. If an MVS abend code is issuedbut not the associated CICS message, the problem probably does notoriginate with CICS. See the description of the MVS abend code in the MVSSystem Codes manual for further information.
The highest possible value of an MVS user abend code is 4095, thereforeany DFH message with a number higher than 4095 has an MVS user abendcode that does not follow the above convention. The following are lists of theabend codes for messages with numbers above 4095, in order of abendcode, and in order of message number.
Ordered by abend code
Chapter 11. DFH messages 415
DFH messages
0108 DFH52630121 DFH51000123 DFH51750125 DFH51800126 DFH51840127 DFH51480147 DFH57210148 DFH57220149 DFH57230150 DFHER57240151 DFHER57250152 DFH57540161 DFHAK58020162 DFHAK58030170 DFHPS53940184 DFHJC45340185 DFHJC45300190 DFHXG64500191 DFHXG64510192 DFHXG64520193 DFHXG64530194 DFHXG64540195 DFHXG64400196 DFHXG64410197 DFHXG64420198 DFHXG64430200 DFHXA65400201 DFHXA65410202 DFHXG64440203 DFHXG64300204 DFHXA65300205 DFHXG64390206 DFHXG64150207 DFHXA65230209 DFHXG64270210 DFHXA65280211 DFH65290213 DFHXG65240214 DFHXA65800220 DFHXO67000221 DFHXO67040222 DFHXO67020223 DFHXO67030224 DFHXO6720
416 CICS User’s Handbook
DFH messages
Ordered by message identifierDFHAK5802 0161DFHAK5803 0162DFHER5724 0150DFHER5725 0151DFHJC4530 0185DFHJC4534 0184DFHPS5394 0170DFHXA6523 0207DFHXA6528 0210DFHXA6530 0204DFHXA6540 0200DFHXA6541 0201DFHXA6580 0214DFHXG6415 0206DFHXG6427 0209DFHXG6430 0203DFHXG6439 0205DFHXG6440 0195DFHXG6441 0196DFHXG6442 0197DFHXG6443 0198DFHXG6444 0202DFHXG6450 0190DFHXG6451 0191DFHXG6452 0192DFHXG6453 0193DFHXG6454 0194DFHXG6524 0213DFHXO6700 0220DFHXO6702 0222DFHXO6703 0223DFHXO6704 0221DFHXO6720 0224DFH5100 0121DFH5148 0127DFH5175 0123DFH5180 0125DFH5184 0126DFH5263 0108DFH5721 0147DFH5722 0148DFH5723 0149DFH5754 0152DFH6529 0211
Notes:
1. All messages which appear in the JES job log are prefixed by a timestamp and job number. Because of this, some messages will have theirmessage text truncated. If the full message text is required, consult theMVS log as all messages in the JES log are duplicated in the MVSsystem log.
2. User abend 0225 is internal to CICS. It is issued by DFHDTES when,during backout, an entry in a hash table has been marked empty where
Chapter 11. DFH messages 417
DFH messages
it should not be possible. This causes the CICS region to be abnormallyterminated. If this abend occurs, you will need help to resolve theproblem. See Part 4 of the CICS Problem Determination Guide forguidance on how to proceed.
418 CICS User’s Handbook
DFH messages
Chapter 12. Transaction abend codes
When abnormal conditions occur, CICS can send a message to the CSMTtransient data destination containing the transaction ID, the program nameand the abend code. Here is an example:
DFHAC2236 date time applid Transaction tranid abend primary abcode in programprogram name term termid backout successful
{ batchid = }batchid. message
Alternatively, the application can intercept abends by including an activeEXEC CICS HANDLE ABEND command. The actual abend code can bedetermined by issuing the EXEC CICS ASSIGN command with the ABCODEoption.
The transaction identification code tranid usually consists of the 4 charactersdefined to CICS. However, when a transaction is initiated by using a lightpen, an operator identification (OPID) card reader, or 3270 PA or PF keys(specified in the TASKREQ= operand), CICS creates an internal transactionidentification in the form of a 1-byte 3270 attention identification (AID) codefollowed by 3 bytes of X'FF'.
The code that may actually appear in the message in place of theinternally-created transaction identification will be *xx*, where xx is thecharacter translation of the 3270 AID code. To prevent ambiguity, the usershould avoid using these codes as transaction identifiers.
The keys, the light pen (LPA), and OPID, and their corresponding printedAID codes are given in the following list:
PF1 *F1* PF13 *C1* LPA *7E*PF2 *F2* PF14 *C2* OPID *E6*PF3 *F3* PF15 *C3* PA1 *6C*PF4 *F4* PF16 *C4* PA2 *6E*PF5 *F5* PF17 *C5* PA3 *6B*PF6 *F6* PF18 *C6*PF7 *F7* PF19 *C7*PF8 *F8* PF20 *C8*PF9 *F9* PF21 *C9*PF10 *7A* PF22 *4A*PF11 *7B* PF23 *4B*PF12 *7C* PF24 *4C*
Copyright IBM Corp. 1989, 1999 419
DFH messages
An abend code indicates the cause of an error that may have beenoriginated by CICS or by a user program. For most of the abend codesdescribed, a CICS transaction dump is provided at abnormal termination.
All CICS transaction abend codes abcode are 4-character alphanumericcodes of the form Axxy, where:
Aack 'M' is the IBM-assigned designation of a CICS transaction abend.
xx is the 2-character code assigned by CICS to identify the module thatdetected an error.
y is the 1-character alphanumeric code assigned by CICS.
Format of informationFor each transaction abend code, the following information is given:
� An explanation of events leading to or following the message.
� The action that has been or will be taken by CICS (system action).
� The action recommended for the user (console or terminal operator).
� The module or modules that can determine that the message should besent (not necessarily the module or modules that can issue the macro towrite the message.)
420 CICS User’s Handbook
Abend codes
Chapter 13. Transaction abend codes
For guidance about interpreting the transaction abend codes summarizedbelow, see the CICS Messages and Codes manual.
Abend Module Explanation
AACA DFHTFP,DFHACP Invalid error codeAALM DFHAMLM Error has occurred on call to Log Manager (LM)
domainAALN DFHAMTD Error has occurred on call to the TD managerAALO DFHAMD2 Error has occurred on call to the CICS/DB2 table
manager DFHD2TMAALP DFHAMPG Error has occurred on call to the Program ManagerAALQ DFHAMBA Error has occurred on call to the Business
Application ManagerAALR DFHAMBA Error has occurred on call to the Temporary Storage
ManagerAALS DFHAMBA Error has occurred on call to the Global Enqueue
ManagerAALT DFHAMOP Error has occurred on call to the Internet Inter-Orb
Protocol ManagerAALU DFHAMSO Error has occurred on call to the Sockets Doamin
ManagerAAL1 DFHALP DFHALP was processing a request that deadlockedAAL2 DFHALP Unexpected response from suspend or resume
allocated taskAAL3 DFHALP Task purged before GETMAIN completedAAL4 DFHALP Error occurred on call to storage manager (SM)
domainAAL6 DFHALP Error occurred on call to
SIGNOFF_TERMINAL_USERAAL7 DFHALP Error occurred on call to schedule a remote terminal
deleteAAMA DFHAMP Internal logic error in DFHAMPAAMC DFHAMP Task purged before GETMAIN completedAAMD DFHAMP Unexpected return code from DFHDMP, internal
logic errorAAMF DFHAMP Unexpected return code from KE domain, internal
logic errorAAMG DFHAMP Unexpected return code from DFHAFMT, internal
logic errorAAMH DFHAMP Unexpected return code from DFHFCMT, internal
logic errorAAMI DFHAMP Unexpected return code from DFHFCRL, internal
logic errorAAMJ DFHAMP Irrecoverable error from DFHFCFS while installing a
file
Copyright IBM Corp. 1989, 1999 421
Abend codes
Abend Module Explanation
AAMK DFHAMP Irrecoverable error from DFHFCDN while installing afile
AAMN DFHAMP Unexpected return code from DFHPRPT, internallogic error
AAMO DFHAMP Invalid return code from DFHTORAAMP DFHAMP Unexpected return code from DFHPUP, internal
logic errorAAMQ DFHAMP Partner resource manager is unavailable, failed to
initializeAAMS DFHAMP Unexpected return code from SM domain, internal
logic errorAAMT DFHAMP Unexpected return code from DFHTMP, internal
logic errorAAMZ DFHAMP Unexpected return code from DFHZCP, internal logic
errorAAM1 DFHAMP Unexpected response from DFHXMCL during install
of TRANCLASSAAM2 DFHAMP Unexpected response from DFHXMXD during
transaction definition installAAOA DFHCPI Unsupported CPI verbAAOB DFHCPI CPI verb with more than eight parametersAAOC DFHCPARH Invalid number of parameters for CPI
Communications callAAOD DFHCPCBI Task purged before GETMAIN request to SM
domain completedAAOE DFHCPCBA Task purged before GETMAIN request to SM
domain completedAAOF DFHCPCBS Task purged before GETMAIN request to SM
domain completedAAOG DFHCPCBA Application attached with unsupported sync levelAAOH DFHCPCOJ Journaling of data sent on CPI Communications
mapped conversation failedAAOI DFHCPCRI,
DFHCPCRWJournaling of data received on CPI Communicationsmapped conversation failed
AAOJ DFHCPIC CPI Communications detected unexpected responsefrom internal routine
AAOK DFHCPIC CPI Communications detected unexpected call tointernal routine
AAOL DFHCPCLR CPI Communications made an invalid call toDFHLUC
AAOM DFHCPCLR,DFHCPSRH
CPI Communications out of sync with DFHZUSRstate machines
AAON DFHCPCLR,DFHCPCLC
Unexpected response from DFHLUC to CPICommunications
AAOO DFHCPARH CPI Communications invoked with invalid firstparameter
AAOP DFHCPCFS Impossible situation requested for CPICommunications
422 CICS User’s Handbook
Abend codes
Abend Module Explanation
AAOQ DFHCPCFS CPI Communications return code has no entry instate table
AAOR DFHCPIC CPI Communications detected invalid value inconversation control block
AAOS DFHCPIC CPI Communications finds unexpected RESET forconversation state
AAOT DFHCPCBI CPI Communications chain error in conversationcontrol blocks
AAOU DFHCPCBI CPI Communications error processing initializeconversation request
AAOV DFHCPCFS CPI Communications internal state table corruptedAAOW DFHCPCLC Internal logic error in DFHCPCLCAAOX DFHCPIC CPI Communications has detected bad syncpoint
return codeAAOY DFHCPCRB Invalid LL field while CPI Communications receives
mapped conversationAAOZ DFHCPCRB Invalid ID field while CPI Communications receives
mapped conversationAAO2 DFHCPCBA Unexpected response from DFHLUC to CPI
CommunicationsAAO3 DFHCPI Call to CPI Communications without initializationAAO4 DFHCPCLR Logic error detected by DFHZARLAAO5 DFHCPCBA,
DFHCPCBI,DFHCPCBS
Task purged before GETMAIN completed
AAO7 DFHCPSRH Invalid DFHLUC parameter list passed to CPICommunications
AAO8 DFHCPSRH Invalid Conversation Control Block (CPC) passed toCPI Communications
AAO9 DFHCPCLR Task purge detectedABAC DFHBASP EXEC CICS RETURN issued for activity executed
with RUN command.ABAD DFHBASP EXEC CICS RETURN ENDACTIVITY issued for
activity executedwith RUN command.ABAE DFHEIBAM EXEC CICS RETURN issued for activity executed
with LINK command.ABAF DFHEIBAM EXEC CICS RETURN ENDACTIVITY issued for
activity executedwith LINK command.ABLA DFHMCP,
DFHMCPE,DFHM32,DFHPBP,DFHRLR
Task purged before GETMAIN request to SMdomain completed
ABLB DFHMCP,DFHMCPE,DFHM32,DFHPBP,DFHRLR
Error on call to SM domain
Chapter 13. Transaction abend codes 423
Abend codes
Abend Module Explanation
ABMA DFHPBP,DFHMCP
TIOA = 0 or < (storage accounting length - 12)
ABMB DFHPBP,DFHMCPDFHMCX
Cursor position larger than current screen size
ABMC DFHMCP CMSG tran attempt to send to greater number ofterminals than possible
ABMD DFHTPP,DFHTPR
Unexpected return code from send DFHTPR orDFHTPP
ABME DFHTPP,DFHTPR
DFHTPR or DFHTPP detected invalid datastreamduring BMS request
ABMF DFHPBP Send length too largeABMG DFHMCP,
DFHTPQBMS service not present
ABMI DFHMCP,DFHMCX,DFHMCY
Not input map
ABML DFHRLR Terminal control locate routine received invalid dataABMM DFHPBP Invalid map specifiedABMO DFHMCP,
DFHMCX,DFHMCY
Not output map
ABMQ DFHQRY Task not terminal-oriented or terminal not defined toCICS correctly
ABMR DFHTPR CPSG initiated but task not terminal-orientedABMU DFHMCP,
DFHEMSAddress not within region boundaries
ABMV DFHRLR Invalid route list entryABMX DFHPBP Invalid set attribute order in textABMZ DFHMCP,
DFHMCX,DFHMCY
TIOA address in TCTTEDA is zero
ABM0 DFHMCP,DFHMCX,DFHMCY
Map could not be located
ABM1 DFHRLR BMS service requested from non-BMS-supportedterminal
ABM2 DFHMCP No user data for BMS requestABM3 DFHMCP BMS service requested from a non-terminal-oriented
taskABM4 DFHMCP,
DFHTPPBMS issued invalid request response to tempstorage PUT or PUTQ
ABM5 DFHMCP,DFHTPR
Purge request issued with invalid REQID by BMS
ABM6 DFHMCP CSPS not installedABM7 DFHPBP Trailer too largeABM8 DFHPBP Justify parameter zero or too large for pageABM9 DFHPBP Header or trailer too large
424 CICS User’s Handbook
Abend codes
Abend Module Explanation
ABNA DFHTPS No route list suppliedABNB DFHTPS Invalid TCTTE type for principal facility of the taskABNC DFHTPS Access temporary storage queue failedABNE DFHTPS Error response from BMS ROUTE or STORE
requestABNF DFHTPS Transaction not in send mode when sent to remote
systemABNG DFHTPS Attach received from remote system without dataABNH DFHTPS Ship data to remote system failedABNI DFHTPS No profile for LU6.2 transaction routing requestABNJ DFHTPS Task purged before GETMAIN completeABNK DFHTPS Error on call to storage manager domainABRC DFHBRMS,
DFHBRTCBridge exit not defined and could not beautoinstalled
ABRD DFHBRMS,DFHBRTC
Bridge exit is disabled
ABRE DFHBRMS,DFHBRTC
Bridge exit could not be loaded
ABRF DFHBRMS,DFHBRTC
Bridge exit is defined as remote
ABRG DFHBRXM An invalid bridge facility token was specifiedABRH DFHBRXM The bridge facility token specified is in use by
another transaction, or has been discardedABRI DFHBRXM There are no free bridge facility tokens availableABRJ DFHBRXM An invalid FACILITYLIKE value was specifiedABRK DFHBRXM The bridge exit returned an invalid brxa_resp valueABRN DFHBRIC,
DFHBRMS,DFHBRSP,DFHBRTC
The USERID check failed following call to the bridgeexit
ABRQ DFHBRMS,DFHBRTC
The bridge exit issued an abend
ABRR DFHBRXM The user transaction's profile could not be foundABRS DFHBRXM CICS was unable to obtain storage to create bridge
facilityABRY DFHBRMS,
DFHBRTCCICS returned an unexpected error running thebridge exit
ABRZ DFHBRIC,DFHBRMS,DFHBRSP,DFHBRTC,DFHXMBR
The bridge exit returned invalid data in the BRXA
ABR3 DFHEMS An unsupported BMS request was received by thebridge exit
ABSA DFHTBS A message passed to DFHBSMSG is too long -CICS internal error
ABXA DFH0CBRF Wrong type of RECEIVE vector in input messageABXC DFH0CBRE Error on SYNCPOINT request issued by bridge exit
Chapter 13. Transaction abend codes 425
Abend codes
Abend Module Explanation
ABXD DFH0CBRE Error when SYNCPOINT ROLLBACK request issuedby bridge exit
ABXE DFH0CBAE,DFH0CBRENo data passed on BRDATA parameter of STARTcommand
ABXF DFH0CBAE,DFH0CBRE,DFH0CBAIError detected by bridge exit inputting next messageABXG DFH0CBAE,DFH0CBREError detected by bridge exit outputting next
messageABXH DFH0CBRF No data available in message - transaction is non
conversationalABXI DFH0CBAE,DFH0CBREMessage received by bridge exit exceeds maximum
message sizeABXJ DFH0CBAE,DFH0CBREBridge exit detected error in MQCIH passed by client
applicationABXK DFH0CBAE,DFH0CBREBridge exit detected error in data passed on
BRDATA parameterABXM DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with unsupported function or
commandABXN DFH0CBRF Bridge exit detected input messsage was truncatedABXO DFH0CBRF Bridge exit detected error in BRMQ vector passed
by client applicationABXP DFH0CBRF Bridge exit detected error in BRMQ vector header
passedABXQ DFH0CBRF Bridge exit could not find ADSD vector as part of
BRMQ-RM vectorABXS DFH0CBRE Bridge exit detected error trying to open queue for
input/outputABX1 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with invalid BRXA-HEADER -
storage overwriteABX2 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with invalid
BRXA-TRANSACTION-AREA - storage overwriteABX3 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with unsupported
BRXA-COMMAND-AREA - storage overwriteABX5 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called without a user-area - error in
bridge exitABX6 DFH0CBAE,DFH0CBRE,DFH0CBRFBridge exit called with invalid user-area - storage
overwrite or error in bridge exitABX7 DFH0CBRF TC command passed to bridge exit exceeded
maximum message sizeABX8 DFH0CBRF BMS BRMQ vector does not contain mapset
requestedABX9 DFH0CBRF Next BMS BRMQ vector does not contain mapname
requestedACAA DFHCAP Parameterized resource definition contains invalid
resource type codeACAD DFHCAP Parameterized resource definition contains invalid
resource type codeACAI DFHCAP Invalid function code for domain call to DFHCAPACAJ DFHCAP Preallocated dynamic storage area too small
426 CICS User’s Handbook
Abend codes
Abend Module Explanation
ACAM DFHECBAM Internal Error in CBAM transactionACCx C/370 errors. See the C/370 User's Guide for further
information.ACFA DFHFCDL Abend during loading of CFDT by CFCL transactionACFB DFHEIFC Request to CFDT is reliant on lock acquired before
server failedACFC DFHEIFC Attempt to reopen access between CICS file and
CFDT failedACFD DFHFCDL Call to CICS Txn Manager returned response and
processing cannot continueACFE DFHFCDL Transaction not internally attached to CICSACHA DFHCHS Remote server transaction is incorrect levelACHB DFHCHS Remote server received frame out of sequenceACHC DFHCHS Remote server did not receive expected
acknowledgement type data frameACHD DFHCHS Remote server did not receive expected response
type data frameACHE DFHCHS Remote server received unexpected data frameACHF DFHCHS Remote server sent more than one data frameACHG DFHCHS Remote server sent data when not in correct modeACHH DFHCHS Remote server has no TIOA for dataACHI DFHCHS Remote server received unexpected return codeACHJ DFHCHS Remote server cannot return error condition to
CICS/CMSACHK DFHCHS Logic error in transformer program requestACHL DFHCHS Remote server buffer too smallACHM DFHCHS Remote server response retry limit exceededACHN DFHCHS Remote server request retry limit exceededACHO DFHCHS Remote server reply retry limit exceededACHP DFHCHS Remote server reply has insufficient storageACHR DFHCHS Failure of the CICS/CMS remote server transaction
(CEHS)ACHS DFHCHS Failure of the CICS/OS2 remote server transaction
(CEHP)ACL0 ICCGLBIC Insufficient storage available to CICS regionACL1 ICCGLBIC CICS Foundation Classes have thrown an exception
- application manager failed to catch itACL2 ICCRESEC CICS Foundation Classes invoked default
handleEvent method defined in class IccResourceACL3 ICCRESIC CICS Foundation Classes responded to an
application programmer's request to abend CICStask
ACL4 ICCGLIBC CICS Foundation Classes detected an internal errorACL5 ICCBASEC CICS Foundation Classes received an error from
CICS GETMAINACL6 ICCBASEC CICS Foundation Classes detected an error
processing storage release request
Chapter 13. Transaction abend codes 427
Abend codes
Abend Module Explanation
ACL7 ICCGLBIC CICS Foundation Classes have thrown an exceptiontheapplication programmer failed to catch
ACL8 ICCGLBIC CICS Foundation Classes have thrown an exceptiontheapplication programmer failed to catch
ACL9 ICCRESIC CICS Foundation Classes responded to a request toabenda CICS task.
ACLA ICCGLIBC CICS Foundation Classes detetcted an internalerror.
ACLB ICCGLIBC CICS Foundation Classes detetcted an internalerror.
ACLC ICCGLIBC CICS Foundation Classes detetcted an internalerror.
ACLD ICCGLIBC CICS Foundation Classes detetcted an internalerror.
ACLE ICCGLIBC CICS Foundation Classes detetcted an internalerror.
ACLF ICCGLIBC CICS Foundation Classes detetcted an internalerror.
ACLG ICCGLIBC CICS Foundation Classes detetcted an internalerror.
ACLH ICCBASEC CICS Foundation Classes detetcted an errorwhileprocessing a storage release request.
ACNA DFHCCNV Table DFHCNV could not be loadedACNB DFHCCNV Program DFHUCNV cannot be linkedACN1 DFHCCNV Table DFHCNV could not be loadedACN2 DFHCCNV Table DFHCNV has wrong format in first recordACN3 DFHCCNV Program DFHUCNV could not be linkedACN4 DFHCCNV Unrecognized format of DFHCNV table encounteredACN5 DFHCCNV Override for default client code page received and
unrecognizedACN6 DFHCCNV Conversion between client code page and server
code page not supported by CICS/390ACN7 DFHCCNV Override for default binary format received and
unrecognizedACN8 DFHCCNV FIELD defined as having GRAPHIC characters and
client code page and server code page imply FIELDcontains only SBCS characters
ACN9 DFHCCNV Table DFHCNV could not be loadedACP1 DFHCPY Bad DFHIC TYPE=GET response codeACP2 DFHCPY Bad DFHIC TYPE=INITIATE response codeACQA DFHCLS5 Connection Quiesce Protocol txn not intended to be
initiated this wayACQB DFHCLS5 Connection Quiesce Protocol txn encountered an
errorACQC DFHCLS5 Connection Quiesce Protocol txn encountered an
errorACRA DFHAPRT Relay program invoked without terminal as principal
facility
428 CICS User’s Handbook
Abend codes
Abend Module Explanation
ACRB DFHAPRT Relay program invoked by transaction not defined asremote
ACRC DFHAPRT Invalid response from DFHZCXACRD DFHAPRT System entry not foundACRE DFHAPRT Link is out of serviceACRF DFHAPRT Dynamic routing program incorrectly initiatedACRG DFHAPRT No matching entry in AID chain for ATI initiated
remote transactionACRH DFHAPRT Profile could not be foundACRI DFHAPRT,
DFHEPCDynamic transaction routing program could not belinked
ACRJ DFHAPRT,DFHEPC
Dynamic transaction routing program has abended
ACRK DFHAPRT Relay program invoked with no address for principalfacility
ACRL DFHAPRT The task does not own the facilityACRM DFHAPRT Dynamic routing program INITIAL_LINK failureACRO DFHCRQ Attempt to invoke CRSQ from a terminalACRP DFHAPRT SYDID does not support a routable startACSA DFHCRS Remote scheduler task (CRSR) does not own
intersystem link TCTTEACSB DFHCRS Invalid reply to schedule requestACSC DFHCRS Unexpected request received from remote systemACSD DFHCRS Internal logic error detectedACSE DFHCRS DFHCRS attached in unsupported mannerACSF DFHCRS Task purged before GETMAIN to SM domain
successfulACSG DFHCRS Error on call to SM domainACSH DFHCRS Sync level mismatch for processing APPC dataACSI DFHCRS APPC conversion failure when attaching between
systemsACSJ DFHCRS Unexpected response on call to RM domainACSL DFHCRS Unable to perform CDTS request or CFTS requestACSM DFHCRS Transaction CFTS has abendedACSN DFHCRS Transaction CFTS has stalledACTA DFHZTSP Relay program in TOR had unexpected request from
AORACTB DFHZTSP Relay program in TOR WRITE, LAST request failedACTC DFHZTSP Relay program in TOR failed to free sessionACTD DFHZTSP Relay program in TOR WRITE, WAIT, READ
request failedACTE DFHZTSP Relay program in TOR failed to free sessionACTF DFHZTSP Relay program in TOR failed to free sessionACTG DFHZTSP Relay program in TOR received invalid region
responseACTH DFHZISP Privileged allocate issued against a remote LU6.2
systemACTI DFHCRT TCTTE for session not owned by task
Chapter 13. Transaction abend codes 429
Abend codes
Abend Module Explanation
ACTJ DFHCRT Principal facility of relay transaction not a TCTTEACTK DFHZISP Task purged before GETMAIN successfulACTL DFHZISP Error on call to SM domainACUA DFHZXRL Request not supported for transaction routingACUB DFHZXRL TCTSE address missing from parameter list for
ALLOCATE requestACUC DFHZXRL TCTSE address not that of a remote LU6.2 terminalACUD DFHZXRL Profile DFHCICSR was not located as installed
profile definitionACUE DFHZXRL Request to DFHZTSP to build surrogate TCTTE not
satisfiedACUF DFHZXRL Session not allocated, request incorrectly specifiedACUG DFHZXRL Profile for ALLOCATE not located as installed
transaction definitionACUH DFHZXRL Requested session already owned by the TCAACUI DFHZXRL MODENAME named in profile not foundACUJ DFHZXRL Maximum session count for modegroup is zeroACUK DFHZXRL No TCT entry for TOR in TCTSE for remote terminalACUL DFHZXRL WRITE, WAIT, READ request failedACUM DFHZXRL Request to DFHZTSP to free surrogate TCTTE not
satisfiedACUO DFHZXRL Attempt to receive data from TOR failedACUP DFHZXRL Expected rollback not receivedACUQ DFHZXRL Attempt to receive data from TOR failedACUR DFHZXRL Expected rollback not receivedACUS DFHZXRL Attempt to receive data from TOR failedACUT DFHZXRL Expected rollback or syncpoint not receivedACUV DFHZXRL TC ISSUE ABEND on MRO link failedACUW DFHZXRL TC ISSUE ERROR on MRO link failedACUX DFHZXRL WRITE, WAIT, READ request failedACUY DFHZXRL TC WRITE, WAIT failedACUZ DFHZXRL WRITE, WAIT, READ request failedACU0 DFHZXRL TC WRITE, LAST, WAIT failedACU1 DFHZXRL Attempt to receive data from TOR failedACU2 DFHZXRL Response from the TOR violates protocolsACU3 DFHZXRL AOR set of conversation state machine violates
protocolsACU4 DFHZXRL Setting of conversation state machine failedACU5 DFHZXRL Connection between two systems not installedACU6 DFHZXRL DFHRTSU request for syncpoint failedACU7 DFHZXRL Remote system connection not APPC or MRO
connectionACU8 DFHZXRL Unexpected response and reason code from
DFHRTSUACU9 DFHZXRL Unexpected response and reason code from
recovery managerACVA DFHZXRT TC WRITE, WAIT, or READ failedACVB DFHZXRT ISSUE SIGNAL on MRO link violates protocols
430 CICS User’s Handbook
Abend codes
Abend Module Explanation
ACVC DFHZXRT ISSUE SIGNAL on LU6.2 link failedACVD DFHZXRT TC READ, WAIT failedACVE DFHZXRT TC WRITE failedACVF DFHZXRT TC WRITE, LAST, WAIT failedACVG DFHZXRT Attempt to free session with LU6.2 terminal failedACVH DFHZXRT Attempt to free session with AOR failedACVK DFHZXRT ISSUE ABEND on LU6.2 link failedACVL DFHZXRT TC ISSUE ABEND on MRO link failedACVM DFHZXRT ISSUE ERROR on LU6.2 link failedACVN DFHZXRT TC ISSUE ERROR on MRO link failedACVO DFHZXRT ISSUE PREPARE in TOR failed or violates protocolsACVP DFHZXRT Expected FMH43 not received from AORACVQ DFHZXRT Nonzero return code from APPC terminalACVR DFHZXRT TC SEND, LAST, WAIT failedACWA DFHCWTO CWTO transaction has failed, task started without a
terminal IDACXA DFHCXCU Catch-up transaction, CXCU, has failedADCA DFHDLIDP Nonzero return code from DBCTLADCB DFHDLIDP No PSB scheduled for taskADCC DFHDLIDP PSB already scheduledADCD DFHDLIDP Deadlock detected by IMSADCE DFHDLIDP Nonzero return code from DFHDBATADCI DFHDLIDP User abend 3303 returned from IMSADCJ DFHDLIDP CICS-DBCTL interface terminatedADCP DFHDLIDP PSB schedule request failed security checkADCQ DFHDLIDP Invalid EXEC DLI SCHD requestADCR DFHDLIDP No active communication with DBCTLADCS DFHDBAT Unexpected response from DBCTL to single phase
commit requestADCT DFHDBCT Attempt to invoke a CICS-DBCTL control transaction
from a terminalADDA DFHDBME,
DFHDLI,DFHDLIDP
Error on call to SM domain
ADDB DFHDBCON,DFHDBDSC
Error on call to CC domain
ADDC DFHDBCON,DFHDBDI
Error on call to LD domain
ADDI DFHDBCT CICS cannot find DBCTL alternate after failureADDJ DFHDBCON CICS/DBCTL connect failure - DFHDBAT cannot be
ENABLEDADEF DFHCLS3 Severe error executing transaction CLS3ADIR DFHDIP Invalid DFHDI or DFHBMS requestADLE DFHDLIRP DL/I request for remote database on unknown
systemADLF DFHDLIRP DL/I request for remote database, but link downADLG DFHDLIRP Errors in DL/I argument list for remote database
request
Chapter 13. Transaction abend codes 431
Abend codes
Abend Module Explanation
ADLP DFHDLIRP PSB usage failed security checkADMA DFHDBCR Error in DBCTL connection statusADMB DFHDBCR Unrecognizable message from CICS/XRF message
managerADMD DFHDBCR DBCTL connection status unable to complete search
for DBCTLalternate.ADPL DFHEIP,
DFHCPIR,DFHDLI
Restricted API command used in DPL environment
ADPM DFHDLI CALL AIBTDLI request issued for function type notsupported by CICS
ADXA DFHDXCU XRF DBCTL state catch-up transaction, DXCU, hasfailed
ADXB DFHDXCU XRF DBCTL state catch-up transaction, DXCU, hasfailed
AD2A DFHD2EX1 Error occurred on a LOCK call to LM domainAD2B DFHD2EX1 Error occurred on an UNLOCK call to LM domainAD2C DFHD2EX1 Unexpected EXCEPTION response occurred on
locate call to DM domainAD2D DFHD2EX1 An error occurred on locate call to DM domain to
locate DB2TRAN control blockAD2E DFHD2EX1 Unexpected EXCEPTION response occurred on
locate call to DM domain to locate a DB2ENTRYcontrol block
AD2F DFHD2EX1 An error occurred on locate call to DM domain tolocate a DB2ENTRY control block
AD2G DFHD2EX1 A transaction attempted to use a DB2ENTRY that isDISABLED or is DISABLING
AD2H DFHD2EX1 The CICS-DB2 attachment facility detected that adynamic plan exit program abended
AD2I DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because it was not linkedAMODE 31
AD2J DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because it is disabled
AD2K DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because no programdefinition was found
AD2L DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because the programcould not be loaded
AD2M DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program because the program isdefined as remote
AD2N DFHD2EX1 The CICS-DB2 attachment facility failed to link to adynamic plan exit program
AD2O DFHD2EX1 An error occurred on an WAIT_MVS call to DMdomain
432 CICS User’s Handbook
Abend codes
Abend Module Explanation
AD2P DFHD2EX1 Transaction was unable to obtain a DB2 thread froma DB2ENTRY or pool
AD2Q DFHD2EX1 An error occurred on a GETMAIN call to SM domainAD2R DFHD2EX1 The CICS-DB2 subtask processing DB2 request for
this transaction has abendedAD2S DFHD2EX1 The subtask servicing the DB2 request for
transaction issued a sign-on request to DB2 whichfailed
AD2T DFHD2EX1 An attempt to create a DB2 thread failed with DB2reason code 00F30040
AD2U DFHD2EX1 An attempt to create a DB2 thread by the subtaskservicing the DB2 request failed
AD2V DFHD2EX1 The CICS-DB2 attachment facility lost connection toDB2 (reason code 00F30805)
AD2W DFHD2EX1 The CICS-DB2 attachment facility received anunexpected response to single-phase commit call toDB2
AD2X DFHD2EX1 The CICS-DB2 attachment facility detected that theCICS task and thread subtask were in an invalidstate
AD2Y DFHD2EX1 The transaction was unable to obtain a DB2 threadfrom a DB2ENTRY or or pool - no TCBs available
AD2Z DFHD2EX1 DB2 detected a deadlock and CICS-DB2 attachmentfacility attempted a syncpoint rollback command fortransaction
AD21 DFHD2EX1 The CICS-DB2 attachment facility received a requestfor resource manager with incorrect name
AD22 DFHD2EDF The CICS-DB2 attachment facility EDF processorwas unable to interpret the SQL request
AD23 DFHD2EX2 An error occurred on LOCK call to LM domainAD24 DFHD2EX2 An error occurred on an UNLOCK call to LM domainAD25 DFHD2CC An error occurred on LOCK call to LM domainAD26 DFHD2CC An error occurred on an UNLOCK call to LM domainAD27 DFHD2EX1 The CICS-DB2 attachment facility attempted to
attach a subtask which failed due to lack of storageAD28 DFHD2EX1 The CICS-DB2 attachment facility attempted to
attach a subtask which failedAD29 DFHD2EDF The CICS-DB2 attachment facility was unable to link
to its EDF processor DFHD2EDFAD3A DFHD2STR An error occurred on a LOCK call to LM domainAD3B DFHD2STR An error occurred on an UNLOCK call to LM domainAD3D DFHD2CM1 Unexpected response while deleting a record from
TS queue during processing of a DSNC STRTcommand
AD3G DFHD2CM1 Unexpected response from EXEC CICS GETMAINissued during processing of a CICS-DB2 DSNCcommand
Chapter 13. Transaction abend codes 433
Abend codes
Abend Module Explanation
AD3I DFHD2CM1 Unexpected response from EXEC CICS INQUIREDB2CONN issued during startup of the CICS-DB2interface
AD3M DFHD2CM1 Unexpected error occurred during processing ofDSNC MODIFY command
AD3P DFHD2CM1 Unexpected error occurred during processing ofDSNC STOP command
AD3Q DFHD2CM1 Unexpected response received reading a record frmTS queue during processing of a DSNCX STRTcommand
AD3R DFHD2STR Unexpected response received reading a record frmTS queue during startup of the CICS-DB2 interface
AD3S DFHD2CM1 Unexpected response received from EXEC CICSSET DB2CONN command during startup of theCICS-DB2 interface
AD3T DFHD2EX1 Transaction was unable to obtain a DB2 thread fromthe pool
AD3U DFHD2EX1 Error on locate call to transaction manager domainAD3W DFHD2STR Unexpected response received writing a record to
TS queue during startup of CICS-DB2 interfaceAD3X DFHD2CM1 Unexpected response received writing a record to
TS queue during startup of DSNC STRT commandAD3Z DFHD2EX1 The CICS-DB2 subtask has abended because the
DB2 adapter is beingshutdown.AEC1 DFHECIP,
DFHECSP,DFHEMTP,DFHESTP,DFHEOTP,DFHEDAP
CECI, CEMT, or CEDA/B/C transaction attemptedon unsupported terminal
AEC2 DFHECIP,DFHECSP,DFHEMTP,DFHESTP,DFHEOTP,DFHEDAP
CECI, CEMT, or CEDA/B/C tried to use too small ascreen
AEC3 DFHAPLI COBOL II failed to initialize a threadAEC4 DFHAPLI COBOL II failed to initialize a run-unitAEC5 DFHAPLI C/370 failed to initialize a threadAEC6 DFHAPLI C/370 failed to initialize a run-unitAEC7 DFHAPLI Language Environment/370 failed to initialize a
threadAEC8 DFHAPLI Language Environment/370 failed to initialize a
run-unitAEC9 DFHAPLI Language Environment/370 had error during
RUNUNIT BEGIN INITIALIZATION phaseAEDA DFHEDFX CEDF started with invalid start codeAEDB DFHEDFX DFHEDFP passed invalid EDFXA
434 CICS User’s Handbook
Abend codes
Abend Module Explanation
AEDC DFHEDFX EDF GETMAIN request failedAEDD DFHEDFX EDF attach failedAEDE DFHEDFX EDF suspend failedAEDF DFHEDFX User task purged before control returned to EDFAEDG DFHEDFX User task gone away while suspended, before
control returned from EDFAEDH DFHEDFX Failure of call to Program ManagerAED1 DFHEDFP,
DFHEDFBRAttempt to use EDF on unsupported terminal, usingCEBR on unsupported device or CEBR initiated witha non-terminal principal priority
AED2 DFHEDFX EDF has terminated a taskAED3 DFHEDFX EDF has terminated a taskAED4 DFHEDFP Internal logic error in DFHEDFPAED5 DFHEDFD Internal logic error in EDF - insufficient dynamic
storageAED6 DFHEDFU Internal logic error in EDFAED7 DFHEDFP TWA size too small for CEDF transactionAED8 DFHEDFX Terminal control error in DFHEDFXAED9 DFHEDFD Temporary storage error in EDFAEIA DFHEIP ERROR condition not handledAEID DFHEIP EOF condition not handledAEIE DFHEIP EODS condition not handledAEIG DFHEIP INBFMH condition not handledAEIH DFHEIP ENDINPT condition not handledAEII DFHEIP NONVAL condition not handledAEIJ DFHEIP NOSTART condition not handledAEIK DFHEIP TERMIDERR condition not handledAEIL DFHEIP FILENOTFOUND condition not handledAEIM DFHEIP NOTFND condition not handledAEIN DFHEIP DUPREC condition not handledAEIO DFHEIP DEPKEY condition not handledAEIP DFHEIP INVREQ condition not handledAEIQ DFHEIP IOERR condition not handledAEIR DFHEIP NOSPACE condition not handledAEIS DFHEIP NOTOPEN condition not handledAEIT DFHEIP ENDFILE condition not handledAEIU DFHEIP ILLOGIC condition not handledAEIV DFHEIP LENGERR condition not handledAEIW DFHEIP QZERO condition not handledAEIZ DFHEIP ITEMERR condition not handledAEI0 DFHEIP PGMIDERR condition not handledAEI1 DFHEIP TRANSIDERR condition not handledAEI2 DFHEIP ENDDATE condition not handledAEI3 DFHEIP INVTSREQ condition not handledAEI4 DFHEIP EXPIRED condition not handledAEI8 DFHEIP TSIOERR condition not handledAEI9 DFHEIP MAPFAIL condition not handledAELA DFHETL Function purged before control returned
Chapter 13. Transaction abend codes 435
Abend codes
Abend Module Explanation
AELB DFHEGL Function purged before control returnedAEMA DFHUEM Error on call to AP domainAEMB DFHUEM Error on call to LD domainAEMP DFHUEM Task purged before set active request to AP domain
completedAEMQ DFHUEM Task purged before IDENTIFY_PROGRAM
completed successfullyAETA DFHERM Task abended by DFHERM after using DFHRMCAL
macroAETC DFHERM Command issued with invalid TRUEAETF DFHERM Task purged before completion of request to SM
domainAETG DFHERM Error on call to SM domainAETH DFHERM Task purged before completion of request to SM
domainAETI DFHERM Error on call to SM domainAETJ DFHERM Error on ADD_LINK call to RM domainAETK DFHERM Error on SET_LINK call to RM domainAETL DFHERM Error on SET_UOW call to RM domainAETM DFHRMSY Error on INQUIRE_TRANSACTION call to XM
domainAETN DFHRMSY Error on INITIATE_RECOVERY call to RM domainAETO DFHRMSY Error on INITIATE_RECOVERY call to RM domainAETP DFHRMSY Error on TERMINATE_RECOVERY call to RM
domainAETQ DFHRMSY Error on INQUIRE_UOW call to RM domainAETR DFHRMSY Error on INQUIRE_UOW call to RM domainAETS DFHRMSY Error on INQUIRE_STARTUP call to RM domainAEXC DFHEIP RESIDERR condition not handledAEXF DFHEIP ESCERROR condition not handledAEXG DFHEIP UOWLNOTFOUND condition not handledAEXI DFHEIP TERMERR condition not handledAEXJ DFHEIP ROLLEDBACK condition not handledAEXK DFHEIP END condition not handledAEXL DFHEIP DISABLED condition not handledAEXU DFHEIDTI,
DFHEIQDS,DFHEIQSA,DFHEIQSC,DFHEIQSM,DFHEIQSPDFHEIQST,DFHEIQSX
NOTPOSS condition raised on encountering invalidparameter
AEXV DFHEIP VOLIDERR condition not handledAEXW DFHEIP SUPPRESSED condition not handledAEXX DFHEIP TASKIDERR condition not handledAEXY DFHxxx Transaction purged before control was returned For
module list, see CICS Messages and Codes
436 CICS User’s Handbook
Abend codes
Abend Module Explanation
AEXZ DFHxxx Command failed due to serious failure in CICScomponent For module list, see CICS Messages andCodes
AEX0 DFHEIP TCIDERR condition not handledAEX1 DFHEIP DSNNOTFOUND condition not handledAEX2 DFHEIP LOADING condition not handledAEX3 DFHEIP MODELIDERR condition not handledAEX4 DFHEIP RECORDBUSY condition not handledAEX5 DFHEIP PARTNERIDERR condition not handledAEX6 DFHEIP PROFILEIDERR condition not handledAEX7 DFHEIP NETNAMEIDERR condition not handledAEX8 DFHEIP LOCKED condition not handledAEX9 DFHEIP RECORDBUSY condition not handledAEYA DFHEIP INVERRTERM condition not handledAEYB DFHEIP INVMPSZ condition not handledAEYC DFHEIP IGREQID condition not handledAEYD DFHSRP Storage violation by CICSAEYE DFHEIP INVLDC condition not handledAEYG DFHEIP JIDERR condition not handledAEYH DFHEIP QIDERR condition not handledAEYJ DFHEIP DSSTAT condition not handledAEYK DFHEIP SELNERR condition not handledAEYL DFHEIP FUNCERR condition not handledAEYM DFHEIP UNEXPIN condition not handledAEYN DFHEIP NOPASSBKRD condition not handledAEYO DFHEIP NOPASSBKWR condition not handledAEYP DFHEIP SEGIDERR condition not handledAEYQ DFHEIP SYSIDERR condition not handledAEYR DFHEIP ISCINVREQ condition not handledAEYT DFHEIP ENVDEFERR condition not handledAEYU DFHEIP IGREQCD condition not handledAEYV DFHEIP SESSIONERR condition not handledAEYX DFHEIP USERIDERR condition not handledAEYY DFHEIP NOTALLOC condition not handledAEYZ DFHEIP CBIDERR condition not handledAEY0 DFHEIP INVEXITREQ condition not handledAEY1 DFHEIP INVPARTNSET condition not handledAEY2 DFHEIP INVPARTN condition not handledAEY3 DFHEIP PARTNFAIL condition not handledAEY6 DFHUEM Internal logic error in DFHUEMAEY7 DFHEIP NOTAUTH condition not handledAEY8 DFHEIP No DSA found on chain trying to free dynamic
storageAEY9 DFHEIP,
DFHEEIInvalid EXEC CICS command issued
AEZA DFHEIP AMODE 24 program defined in transaction withTASKDATALOC=ANY
Chapter 13. Transaction abend codes 437
Abend codes
Abend Module Explanation
AEZB DFHERM AMODE 24 task related user exit defined intransaction with TASKDATALOC=ANY
AEZC DFHAPLI AMODE 24 program defined in transaction withTASKDATALOC=ANY
AEZD DFHAPLI Attempt to run EXECKEY(USER) program intransaction with TASKDATAKEY(CICS) defined
AEZE DFHEIP CHANGE condition not handled - see AEIAAEZF DFHEIP PROCESSBUSY condition not handled - see AEIAAEZG DFHEIP ACTIVITYBUSY condition not handled - see AEIAAEZH DFHEIP PROCESSERR condition not handled - see AEIAAEZI DFHEIP ACTIVITYERR condition not handled - see AEIAAEZJ DFHEIP CONTAINERERR condition not handled - see AEIAAEZK DFHEIP EVENTERR condition not handled - see AEIAAEZL DFHEIP TOKENERR condition not handled - see AEIAAEZM DFHEIP NOTFINISHED condition not handled - see AEIAAEZN DFHEIP POOLERR condition not handled - see AEIAAEZO DFHEIP TIMERERR condition not handled - see AEIAAEZP DFHEIP SYMBOLERR condition not handled - see AEIAAEZQ DFHEIP TEMPLATERR condition not handled - see AEIAAFCB DFHEIFC Unexpected response from DFHFCEI resource level
security checkAFCC DFHEIFC,
DFHDMPCAInternal logical error on calling file control requestmodule DFHFCFR
AFCD DFHEIFC Irrecoverable error as table manager tries to locateAFCT
AFCE DFHEIFC A GETMAIN for FFLE storage failedAFCF DFHEIFC,
DFHDMPCAFile control deadlock between tasks
AFCG DFHEIFC,DFHDMPCA
File issued sequence of file control requests thatwould deadlock itself
AFCH DFHEIFC Request to disabled or closed tableAFCJ DFHFCU Task taking longer than DTIMEOUT interval
specified for CSFUAFCK DFHDMPCA,
DFHEIFCFile update request issued against RLS mode dataset during backup
AFCL DFHDTLX Response could not continue during loading ofShared Data Table by CSFL txn
AFCM DFHDTLX Data table load failedAFCN DFHDMPCA,
DFHEIFCJournal record too large for journal buffer
AFCO DFHDTLX Transaction not internally attached by CICS onattempt to attach
AFCR DFHEIFC,DFHDMPCA
SMSVSAM server address space has failed
AFCS DFHEIFC,DFHDMPCA
SMSVSAM server address space was inactive
AFCT DFHEIFC,DFHDMPCA
SMSVSAM server has been recycled since anearlier request from same UOW
438 CICS User’s Handbook
Abend codes
Abend Module Explanation
AFCU DFHEIFC,DFHDMPCA
Data set in lost locks state
AFCV DFHEIFC,DFHDMPCA
Request against file in RLS mode unable to acquirerecord lock
AFCW DFHEIFC,DFHDMPCA
FC request against file in RLS mode would causedeadlock
AFCY DFHDMPCA,DFHEIFC
Transaction purged during file request
AFCZ DFHDMPCA,DFHEIFC
Irrecoverable error response from DFHFCFR to itscaller
AFC0 DFHEIFC,DFHDMPCA
Updating file after file control restart failed
AFC2 DFHFCU Disastrous error from DFHFCFS on open file requestAFC7 DFHDMPCA Disastrous error response from DFHFCFS to
DFHDMPCAAFDA DFHFCQT Attach of transaction failed - not internally attached
by CICSAFDB DFHFCQT Transaction not CFQS or CFQRAFDC DFHFCQT CFQS failed due to serious errorAFDD DFHFCQT CFQR failed due to serious errorAFDE DFHFCRD Attach of transaction failed - not internally attached
by CICSAFDF DFHFCOR Attach of transaction failed - not internally attached
by CICSAFDG DFHFCOR CFOR failed due to serious errorAFDH DFHEIFC,
DFHDMPCAVSAM RLS unable to create new locks - couplingfacility full
AGMA DFHGMM No terminal specified for Good Morning transactionAICA DFHSRP Task executing for longer than runaway time intervalAICB DFHICP RETRIEVE WAIT reissued in system shutdownAICC DFHTAJP,
DFHICPIncorrect response from a TI domain request
AICD DFHICP Incorrect response from a KE domain requestAICE DFHICP Incorrect response from a DS domain request (other
than AICG)AICF DFHICP Incorrect response from a TM domain requestAICG DFHICP PURGED response from DS request with reason
code TASK_CANCELAICH DFHICP,
DFHEIICTask purged before request to SM domaincompleted successfully
AICJ DFHICP Error on call to SM domainAICK DFHEIIC Invalid response from resource level security checkAICL DFHEIIC Invalid function code in the command level
parameter listAICN DFHICP Incorrect response from US domain requestAICO DFHICXM Unexpected EXCEPTION response on call to US
domain
Chapter 13. Transaction abend codes 439
Abend codes
Abend Module Explanation
AICQ DFHDFST DFHDFST is executing at a terminal which is notpermitted.
AICS DFHDFST DFHDFST has encountered an error during Retrieveprocessing.
AICT DFHDFST DFHDFST has encountered an error during STARTprocessing.
AICR DFHCRR Failure of DFHTC write request for IRCAINA DFHINDT Application program failed to pass commarea
containing request to be executed on LINKcommand
AINB DFHINDT Commarea passed did not contain valid request tobe executed
AINC DFHINDT,DFHINDAP
INQUIRE EXITPROGRAM failed with NOTAUTHresponse
AIND DFHINDT,DFHINDAP
INQUIRE EXITPROGRAM failed with unexpectedresponse
AINE DFHINDT Error on START_LINK_BROWSE commandto RMdomain
AINF DFHINDT EXCEPTION response on GET_NEXT_LINK call toRM domain
AING DFHINDT Error on GET_NEXT_LINK call to RM domainAINH DFHINDT Error on END_LINK_BROWSE command to RM
domainAINI DFHINDT Error on INQUIRE_UOW command to RM domainAINJ DFHINDT Exception respone on INITIATE_RECOVERY call to
RM domainAINK DFHINDT Error on INITIATE_RECOVERY call to RM domainAINL DFHINDT Error on SET_RECOVERY_STATUS command to
RM domainAINM DFHINDT Error on TERMINATE_RECOVERY command to RM
domainAINN DFHINTRU Error on ADD_LINK command to RM domainAINO DFHINTRU INQUIRE TRANSACTION command failed with
NOTAUTH responseAINP DFHINTRU INQUIRE TRANSACTION command failed with
unexpected responseAINQ DFHINTRU INQUIRE TASK command failed with TASKIDERR
responseAINR DFHINTRU INQUIRE TASK command failed with NOTAUTH
responseAINS DFHINTRU INQUIRE TASK command failed with unexpected
responseAIOA DFJIIOP The main method within CICSMain invoked with a
null COMMAREAAIOB DFJIIOP checkbytes method within CICSCommareaMapping
detected an errorAIOC DFJIIOP setbytes method within CICSCommareaMapping
detected an error
440 CICS User’s Handbook
Abend codes
Abend Module Explanation
AIOD DFJIIOP setIIOPDataFromTSQ method withinCICSCommareaMapping detected an error
AIOE DFJIIOP setIIOPDataFromTSQ method withinCICSCommareaMapping detected an error
AIOF DFJIIOP setIIOPDataFromTSQ method withinCICSCommareaMapping detected an error
AIOG DFJIIOP The main method within CICSMain failed to initializethe ORB
AIOH DFJIIOP The main method within CICSMain has receivedunexpected return code from ProcessMessage
AIOI DFJIIOP setBytes method within CICSCommareaMappinghas detected an error
AIOJ DFJIIOP writeIIOPDataToTSQ method withinCICSCommareaMapping has detected an error
AIOK DFJIIOP writeIIOPDataToTSQ method withinCICSCommareaMapping has detected an error
AIOV DFJIIOP setBytes method within CICSCommareaMappinghas detected an error
AIO0 DFHIIOPDFHIIOPA
Programme chech when IIOP/CORBA callprocessed
AIO1 DFHIIOPDFHIIOPA
Call to Socket domain failed
AIO2 DFHIIOPDFHIIOPA
IIOP/CORBA data stream contains invalid header ordata structure
AIO3 DFHIIOPDFHIIOPA
WRITEQ/READQ TS call detected that queuemodified by another process
AIO4 DFHIIOPDFHIIOPA
IIOP transaction CIOF has been started incorrectly.
AISA DFHMIRS CSMI attached to facility other than terminalAISB DFHMIRS Errors detected in data for mirror transactionAISC DFHMIRS TIOA not received from terminal by mirror
transactionAISD DFHMIRS Mirror program received nonzero return codeAISF DFHMIRS Facility for mirror is APPC, conversation unmappedAISG DFHMIRS Mirror transaction could not send replyAISH DFHCRNP Incorrect invocation of CSNCAISI DFHISP Invalid function shipping request from DFHEIP to
DFHISPAISJ DFHCRNP CSNC abended because LINK to DFHCRR failedAISK DFHISP Mirror transaction abendedAISL DFHLUP,
DFHCLS3,DFHCLS4,DFHZLS1
LU services manager transaction started directlyfrom user terminal
AISN DFHCRNP CSNC failed to acquire SUSPEND TOKENAISO DFHCRNP CSNC failed to suspend itselfAISP DFHMIRS Mirror transaction invoked with invalid principal
facility
Chapter 13. Transaction abend codes 441
Abend codes
Abend Module Explanation
AISQ DFHMIRS EXEC CICS command issued for CPICommunications session
AISR DFHCRR DFHCRR invoked in an incorrect mannerAISS DFHZARM Security violation at start of APPC conversationAIST DFHCRNP Unexpected return code after DFHTC
TYPE=LOCATEAISU DFHMIRS Error on call to SM domainAISV DFHMIRS PURGED condition on call to SM domain to
FREEMAINAISW DFHCRSP Error on call to SM domainAISX DFHCRSP PURGED condition on call to SM domain to
GETMAIN or FREEMAINAISY DFHLUP Invalid parameters for LU services managerAISZ DFHMXP Unexpected reply when committing START
PROTECT NOCHECK requestsAIS1 DFHCRSP Unexpected return code after DFHMROQM
FUNC=ENQ commandAIS2 DFHCRNP Unexpected return code after DFHMROQM
FUNC=WAIT_Q commandAIS3 DFHCRNP Failed to issue store clock instructionAIS4 DFHCRNP Unexpected return code after DFHMROQM
FUNC=ENQUEUE commandAIS5 DFHCRNP Unexpected return code after DFHMROQM
FUNC=ENQUEUE commandAIS6 DFHMIRS DISASTER, EXCEPTION, or INVALID condition on
call to SM domainAIS7 DFHMIRS PURGED condition on call to SM domainAIS8 DFHMIRS Internal logic error in DFHMIRSAIS9 DFHMIRS DPL server program returned invalid state after LINK
commandAITA DFHCRNP Error on call to RM domainAITB DFHISP Error on call to RM domainAITC DFHMIRS Error on call to RM domainAITD DFHMIRS Mirror program received unexpected response from
RX domainAITE DFHMIRS RTIMOUT interval exceeded on transactional EXCI
requestAITF DFHMIRS Transactional EXCI request purged waiting on eventAITG DFHMIRS Transactional EXCI request executed and both a
further request from the batch region and asuyncpoint initiated by RRMS occurred
AJA0 DFJCICS Invalid Resp code passed to SetAbendForConditionmethod
AJCD DFHJCP Error on call to SM domainAJCE DFHJCP Task purged before GETMAIN request to SM
domain completedAJCS DFHJCP Error on call to LM domainAJCT DFHJCP Error on call to RM domain
442 CICS User’s Handbook
Abend codes
Abend Module Explanation
AJCU DFHJCP Purge response from log manager or recoverymanager
AJ01 DFJCICS Main method of jave environment setup classinvoked without argument
AJ02 DFJCICS CICS AbendError caught by the java environmentsetup class, Wrapper
AJ03 DFJCICS CicsConditionException caught by WrapperAJ04 DFJCICS Unexpected condition caught by WrapperAJ05 DFJCICS Unhandled exception from Java applicationAJ07 DFJCICS Wrapper unable to invoke the user's main methodAJ09 DFJCICS Wrapper unable to invoke the user's main methodAJ99 DFJCICS Wrapper detected AbendException and issued
setAbend - abend code extracted fromAbendException is too long
AJMA DFHCJVM Change directory to CICS_HOME failedAJMB DFHAPLJ Call to JVM program disallowed due to previous
JVM terminationerrorsAJM1 DFHCJVM JNI_CreateJavaVM request failedAJM2 DFHCJVM JVM failed to find the CICS Wrapper ClassAJM3 DFHCJVM JVM failed to find the main method of the CICS
Wrapper classAJM4 DFHCJVM JVM failed to build the argument list for the CICS
Wrapperclass.AJM5 DFHCJVM The CICS Wrapper class threw an exceptionAJM6 DFHCJVM CICS JVM interface failed to set up CICS Recovery
facilities.AJM7 DFHCJVM CICS JVM interface failed to delete CICS Recovery
facilities.AJM8 DFHAPLJ A severe error occurred whilst the JVM was
executingAJM9 DFHCJVM CICS JVM interface failed to load user replaceable
module DFHJVMAT.AKCB DFHKCRP Transaction manager restart task could not completeAKCC DFHXMAT,
DFHXMCLPurge threshold on TRANCLASS reached
AKCE DFHKCQ Write to system log failedAKCF DFHKCQ Write to catalog failedAKCR DFHXCP Transaction manager received an invalid request
codeAKCS DFHXCP Deadlock time-out has occurredAKCT DFHXCP Terminal read-time-out has occurredAKCV DFHALP Unexpected return code on resume of suspended
taskAKC0 DFHAPATT Attempt to run CSSY as user transactionAKC1 DFHXCP DFHKC WAIT when ECB already marked as waitingAKC2 DFHXCP Unexpected response from DS domain call
Chapter 13. Transaction abend codes 443
Abend codes
Abend Module Explanation
AKC3 DFHXCP,DFHXMAT,DFHXMCL,DFHXMIQ,DFHXMTA
Task has been purged
AKC6 DFHXCP DFHKC SUSPEND did not precede DFHKCRESUME
AKC8 DFHXCP Unexpected response from call to KE domain fortask purge
AKC9 DFHXCP Error from call to NQ domainAKEA DFHKESTX Program check detected by KE domainAKEB DFHKESTX Operating system abend detected by KE domainAKEC DFHKESTX,
DFHKERRURunaway detected by KE domain
AKED DFHKEEDA Deferred abend request in KE domainAKEF DFHKERKE Error detected while processing KE domain callAKEG DFHKESGM MVS GETMAIN for kernel stack storage failedAKEH DFHKESTX Transaction purged while running outside control of
CICS.AKEI DFHKESTX Kernel domain detected runaway while transaction
isoutside control of CICS.AKEZ DFHKETA Failure of user attach - insufficient kernel tasksAKSE DFH99KC No code for keywordALGA DFHLGGL,
DFHLGJN,DFHLGLD,DFHLGST
Error obtaining lock within log manager domain
ALGB DFHLGGL,DFHLGJN,DFHLGLD,DFHLGST
Error releasing lock within log manager domain
ALGC DFHLGGL,DFHLGJN,DFHLGLD,DFHLGST
Disaster response detected processing buildingblock code used by log manager domain
ALGD DFHLGCM,DFHLGGL,DFHLGJN,DFHLGLD,DFHLGST
Disaster response detected processing buildingblock storage interface code used by log managerdomain
ALGE DFHLGJN Unexpected error while log manager attempted tofind jounal model definition
ALGF DFHLGGL,DFHLGJN,DFHLGST
Unexpected error when log manager attemptedenqueue/dequeue operation
ALGG DFHLGQC Transaction CSQC issued from a terminalALIA DFHAPLI Insufficient storage to satisfy GETMAIN requestALIB DFHAPLI Insufficient storage to satisfy GETMAIN request
444 CICS User’s Handbook
Abend codes
Abend Module Explanation
ALIC DFHAPLI Insufficient storage to satisfy GETMAIN requestALID DFHAPLI Insufficient storage to satisfy GETMAIN requestALIE DFHAPLI Insufficient storage to satisfy GETMAIN requestALIF DFHAPLI Insufficient storage to satisfy GETMAIN requestALIG DFHAPLI CICS unable to determine language of user
application programAMI1 DFHMIRS Unexpected response when mirror task resumedAMNA DFHCMP Exception response from MN domain—invalid
address in DATA1AMNB DFHCMP Exception response from MN domain—invalid data
in DATA2AMNZ DFHCMP Unexpected error response from MN domainAMSA DFHMSP SBA not followed by two 1-byte address fieldsAMSB DFHMSP Internal logic error in DFHMSPAMSC DFHMSP Task purged before GETMAIN to SM domain
completedAMSD DFHMSP Error on call to SM domainANQA DFHNQED,
DFHNQIB,DFHNQNQ,DFHNQST
Error occurred obtaining lock within enqueue domain
ANQB DFHNQED,DFHNQIB,DFHNQNQ,DFHNQST
Error occurred releasing lock within enqueue domain
ANQC DFHNQED Error occurred obtaining sysplex enqueueANQD DFHNQED Error occurred obtaining sysplex enqueueANQE DFHNQRN EXEC ENQ issued and enqmodel disabled or in
waiting stateAPCF DFHAPLI Program not compiled with supported PL/I compilerAPCG DFHxxx Transaction purged For module list,see CICS
Messages and CodesAPCH DFHAPLI COBOL II or LE/370 support not presentAPCI DFHAPLI Execution of PL/I programs has been disabledAPCJ DFHAPLI C/370 does not recognize programAPCK DFHAPLI Execution of C program disabledAPCL DFHAPLI Language Environment/370 unable to determine
program languageAPCN DFHxxx Attempt to release program/mapset/partitionset that
is not loaded or has already been deleted. Formodule list, see CICS Messages and Codes
APCO DFHAPXM GETMAIN of storage for LEVEL 2 trace failed duringtransaction initialization
APCS DFHAPLI CICS could not get run time information from LE/370APCT DFHxxx Program/mapset/partitionset failure. For module list,
see CICS Messages and CodesAPCW DFHAPLI Compiler level for COBOL program cannot be
determined
Chapter 13. Transaction abend codes 445
Abend codes
Abend Module Explanation
APCY DFHAPLI Macro request from PL/I or COBOL applicationAPCZ DFHAPLI Program not reentrant and cannot be loaded into
read-only storageAPC0 DFHPCP,
DFHMCYSerious error on call to program manager domain
APC1 DFHAPLI Request for TGT exceeding 64KB in sizeAPC2 DFHAPLI Illegal branch following abend conditionAPC3 DFHAPLI No Language Environment/370 support present for
programAPC4 DFHPCPC2 Loader domain define request failed for program
ILBOCOMAPC5 DFHPCPC2 Loader domain load request failed for program
ILBOCOMAPC6 DFHPCPC2 An internal error has occurredAPC7 DFHPCPC2 An MVS IDENTIFY call for entry point ILBOCOM0
failedAPC8 DFHPCPC2 An MVS LOAD of ILBOCOM0 has failedAPC9 DFHPCPC2 An MVS LOAD of ILBOCOM has failedAPLx PL/I abend code (see OS/VS PL/I Optimizing
Compiler: Programmer’s Guide)APP1 DFHP3270 Invalid DFHIC TYPE=GET response codeAPP2 DFHP3270 Data length passed to DFHP3270 less than or equal
to 5APP3 DFHP3270 Invalid request to nonprinterAPR1 DFHPRK Invalid DFHIC TYPE=PUT response codeAPSJ DFHPSIP Spooler initialization program incorrectly invokedAPST DFHEPS SPOOL command without NOHANDLE operandAPSU DFHPSPST Invalid JES return code to spoolerAPSV DFHPSPST VSAM macro return code contains invalid valueAPSW DFHPSPST Abend in CICS system spooler subtaskAPSX DFHPSPST A CICS storage area contains invalid valueAPSY DFHPSPST Storage area for MVS macro return code contains
invalid valueAPSZ DFHPSPST CICS area for JES interface return code contains
invalid valueAPTI DFHPSPST Task purged before GETMAIN request to SM
domain completedAPTJ DFHPSPST Error on call to SM domainAPUA DFHPUP GETSTG parameter missing on call to DFHPUP
(PUPF)APUB DFHPUP GETSTG parameter missing on call to DFHPUP
(PUPU)APUC DFHPUP Invalid function code supplied on domain call to
DFHPUPAPUD DFHPUP Unable to locate RDO language definition table
(DFHEITSP)APUE DFHPUP Lack of storage to load RDO language definition
table (DFHEITSP)
446 CICS User’s Handbook
Abend codes
Abend Module Explanation
APUF DFHPUP RDO language definition table invalid or missingAPUG DFHPUP Storage cannot be obtained for CSD record bufferAPUH DFHPUP Storage cannot be obtained for argument listAPUI DFHPUP Storage cannot be freed for argument listAPUJ DFHPUP Storage cannot be freed for CSD record bufferAPUK DFHPUP Unable to obtain storageAPUL DFHPUP Unrecognized resource type code (FLATTEN)APUM DFHPUP Unrecognized resource type code (TRANCASE)APUN DFHPUP Unrecognized resource type code (COMPARE)APUO DFHPUP Unrecognized resource type code (BACKTRANS)APUP DFHPUP Error processing language definition table for RDOAPUQ DFHPUP Error processing language definition table for RDOAPUR DFHPUP Data type conflictAPUS DFHPUP Invalid integer data length for keyword fieldAPUT DFHPUP Invalid keyword existence bit numberAPUZ DFHPUP Invalid resource type code in CSD recordAPXA DFHAPXM User transaction's profile could not be foundARCB DFHRCEX Initialization failure - exit program cannot be foundARHA DFHCPIR SAA resource recovery interface has invalid first
parameterARHB DFHCPIR Invalid number of parameters for SAA resource
recovery callARHC DFHCPIR Unexpected return code from syncpoint program for
SAA resource recovery interfaceARM0 DFHRMXN3 Transaction not internally attached by CICSARPA DFHRTC Unexpected response from DFHSUSN signing off
user of CRTE transactionARPF DFHRPAS The alias could not be initializedARPG DFHRPAS The alias was not able to link to the CICS programARPH DFHRPAS The alias detected a global work area errorARPI DFHRPAS The alias detected a logic errorARPJ DFHRPAS The alias ends for one of various reasonsARPK DFHRPAS The alias detected a CICS logic errorARPL DFHRPAS The alias detected an authorization errorARPM DFHRPAS The alias detected an error in user codeARPN DFHRPAS The alias detected an error while trying to switch
TCBsARPO DFHRPAS The alias program detected an abendARPU DFHRPC01 The connection manager could not access the CICS
ONC RPC data setARPV DFHRPC0E The connection manager received unexpected
response from CICSARPW DFHRPC0E The connection manager received unexpected
response from CICSARPX DFHRPC01 The connection manager started against an invalid
terminalARPZ DFHRPC0B The connection manager has insufficient authority
Chapter 13. Transaction abend codes 447
Abend codes
Abend Module Explanation
ARP2 DFHRPMS The server controller detected internal error duringCICS ONC RPC enable processing
ARP4 DFHRPMS The server controller has performed an exceptiondisable because of an internal error
ARP5 DFHRPMS An invalid attempt was made to start the servercontroller
ARP9 DFHRPC01 There was not enough storage for the connectionmanager
ARTA DFHRTE Task does not own terminal as its principal facilityARTB DFHRTE No input TIOA, or data length zeroARTC DFHRTE Link not usableARTD DFHRTE Internal logic error in DFHRTEARTE DFHRTE Error in I/O to or from temporary storageARTF DFHRTE Invalid attempt to use CRTEARTG DFHRTE Profile not foundARTH DFHRTE Error on call to schedule remote terminal delete
during sign-offARUA DFHXMRU Exception condition on ADD_LINK during BIND
phase of ATTACHARUB DFHXMXM A RUN SYNCHRONOUS command caused an
attempt to attach a remotely defined transactionARUC DFHXMRU A RUN SYNCHRONOUS command caused an
attempt to attach a transaction with an invalidUSERID.
ARXA DFHRXUW Error attempting to express interest in RRMS Unit ofRecovery
ARXB DFHRXUW Error on ADD_LINK call to Recovery Managerdomain
ARXC DFHRXUW Error on transactional EXCI requestASCA DFHSMSCP Disaster response to DFHSC TYPE=GETMAIN
request from SM domainASCB DFHSMSCP Disaster response to DFHSC TYPE=FREEMAIN
request from SM domainASCP DFHSMSCP Task purged while waiting for contiguous main
storageASCR DFHSMSCP Invalid storage control request typeASDA DFHCESD CESD started directly from a terminal not internally
by CICSASFA DFHSFP Unexpected response from EXEC CICSASFB DFHSFP Attempt to execute CICS signoff without an
associated terminalASFC DFHSFP Attempt to execute CICS signoff program against
APPC sessionASHA DFHSHDM Command failed due to a serious failure in a CICS
componentASHB DFHSHDM Command failed due to a serious failure in a CICS
component
448 CICS User’s Handbook
Abend codes
Abend Module Explanation
ASHR DFHSHRSP Command failed due to a serious failure in a CICScomponent
ASHU DFHSHRSP Abend occurred due to a routing failureASH2 DFHSHXM Resources required to service request unobtainableASH3 DFHSHRM Transaction bound to a Scheduler Services request
has backed out (default abend code)ASH4 DFHSHXM Scheduler Services attempted to attatch a disabled
transaction.ASIA DFHSII1 Error on call to SM domainASIB DFHSIPLT Invalid attempt to run CICS internal task CPLT as
user transactionASNA DFHSNP Unexpected response from EXEC CICSASNB DFHSNP Attempt to execute CICS signon without an
associated terminalASNC DFHSNP Signon program failed to send request to userASND DFHSNTU Request from DFHSNTU to ENQ failed during
signoff terminal userASOA DFHSOL TCP/IP listener task CSOL incorrectly started from a
terminalASPA DFHAPAC Task purged before request to RM domain
completed successfullyASPB DFHAPAC Error on call to RM domainASPC DFHSPP Error on call to bridge syncpoint routine (DFHBRSP)ASPF DFHAPAC ROLLEDBACK returned to RM domainASPI DFHCR2U Unexpected FMH or no data received from partner
systemASPJ DFHCR2U Unexpected syncpoint message data received from
partner systemASPN DFHAPAC Transaction has issued an EXEC CICS RETURN in
backout required program stateASPO DFHAPAC Intersystem session failed during syncpointASPP DFHAPAC Intersystem session failed during syncpointASPQ DFHAPAC Intersystem communication failed during syncpointASPR DFHAPAC Intersystem communication failed during syncpointASP1 DFHAPAC Intersystem communication failed during syncpointASP2 DFHAPAC Syncpoint attempted with intersystem conversation
in invalid stateASP3 DFHAPAC No syncpoint taken in remote systemASP7 DFHAPAC Resource manager replied 'No' to request to
'Prepare'ASP8 DFHAPAC Syncpoint rollback not supportedASP9 DFHEISP User Syncpoint not allowed in activationASQA DFHCRRSY Communication session failed during CLS2
processingASQB DFHCRRSY Logic error during CLS2 processingASQC DFHCRRSY CLS2 transaction attached with unexpected start
code
Chapter 13. Transaction abend codes 449
Abend codes
Abend Module Explanation
ASQD DFHCRRSY CLS2 transaction could not use transaction managerfor input parameters
ASQG DFHCRRSY CLS2 transaction failed during receipt of data viaMRO session
ASQH DFHCRRSY CLS2 transaction failed during receipt of data viaMRO session
ASQI DFHCRRSY Attempt to invoke CICS recovery manager to savelogname failed
ASQK DFHCRRSY CICS internal logic errorASQL DFHCRRSY Invocation of TERMINATE_RECOVERY command
to unlock data failedASQM DFHCRRSY CICS internal logic errorASRA DFHSRP Program check has occurredASRB DFHSRP Operating system abendASRD DFHSRP Invalid macro call or reference to CSA or TCAASRE DFHSRP Attempt to access a CICS-DB2 RCT load module
terminated taskASRK DFHSR1 DFHSR1 unable to call system recovery program
(DFHSRP)ATCA DFHZARQ DFHTC macro issued when in final quiesce modeATCB DFHZARQ Two consecutive reads or writes without intervening
waitATCC DFHZARQ Read or more than one write issued using pipeline
sessionATCD DFHZDSP,
DFHZERHCTYPE or QUEUE issued and VTAM or ZCPfunction not included in system
ATCE DFHZARQ DFHTC request issued without address of TIOAATCF DFHZCRQ DFHTC CTYPE macro issued to non-VTAM TCTTEATCG DFHZARQ DFHTC request for terminal which program does not
ownATCH DFHxxx Task purged before domain call completed
successfully For module list,see CICS Messagesand Codes
ATCI DFHZSUPDFHMRXMDFH62XM
Error occurred on call to DFHRTSU
ATCJ DFHZATADFHZATDDFHZATR
Invalid autoinstall invocation
ATCK DFHZARQ Write issued with CCOMPL=NO without authorityATCL DFHETL,
DFHTCPCM,DFHZARQ
Error during automatic journaling or automaticlogging
ATCN DFHZSUPDFH62XMDFHTFXM
Error during automatic journaling or automaticlogging
ATCO DFHZARQ Function unsupported by terminal or systemATCQ DFHZRAQ Temporary storage error
450 CICS User’s Handbook
Abend codes
Abend Module Explanation
ATCR DFHZRAR Temporary storage errorATCS DFHZARQ Send data after request change direction receivedATCT DFHZSUP
DFHMRXMDFH62XM
Build of surrogate TCTTE for remotely-ownedterminal failed
ATCU DFHZARQ Send in receive modeATCV DFHETL,
DFHZARQ,DFHZISP
Application attempted operation on logical unit whichfailed
ATCW DFHZSUPDFHMRXMDFH62XM
No installed profile definition for LU6.1 or APPCsession
ATCX DFHxxx Error on call to SM domain For module list,see CICSMessages and Codes
ATCY DFHZARQ,DFHZSUPDFHMRXMDFH62XM
Error processing inbound FMH
ATCZ DFHZSLS Error in call to security domainATC1 DFHTCRP Terminal control restart task failureATC2 DFHZSLS VTAM rejected CICS SET VTAM OPEN requestATC3 DFHZARQ Write to TLX device issued with data length of 0
causing TIOA data length (TIOATDL) to be 0ATC4 DFHTCRP The XRF TCB abendedATC5 DFHETL Internal logic error in APPC mapped processingATC6 DFHETL SEND DATA length greater than 65528 bytesATC7 DFHZSUP Unexpected response from INITIAL-CALL request to
DFHZARLATC8 DFHETL Error during processing of an inbound FMHATC9 DFHZNCE RESUME issued without prior SUSPENDATDC DFHETD Task purged awaiting enqueue during
READQ/WRITEQ or DELETEQ commandATDY DFHTDRP Transient data initialization failedATDZ DFHTDRP CICS function invoked by TD init failedATFE DFHTOUT1 FREEMAIN failed during CEDA CHECK or CEDA
INSTALLATGE DFHTOUT1 GETMAIN failed during CEDA CHECK or CEDA
INSTALLATMA DFHTMP Task purged before GETMAIN request to SM
domain completed successfullyATMB DFHTMP Error on call to SM domainATNA DFHZNAC Terminal operator entered transaction identification
for NACPATND DFHZARQ,
DFHZARL,DFHZSUP
Task termination postponed
Chapter 13. Transaction abend codes 451
Abend codes
Abend Module Explanation
ATNI DFHZARL,DFHZARM,DFHZARQ,DFHZRAQ,DFHZSUP
Task terminated by NEP (VTAM) or TEP(non-VTAM)
ATOA DFHCESC Invalid attempt to invoke CESC with terminal asprincipal facility
ATOB DFHCESC Abnormal response from EXEC CICS STARTTRANSACTION(CESC)
ATOC DFHCESC Failure of a DFHZCUT timeout requestATOD DFHCESC Abnormal response from EXEC CICS CANCEL
TRANSACTION(CESC)ATOE DFHCESC Cannot determine time XRF takeover beganATOF DFHCESC Abnormal response from EXEC CICS DELAY
TRANSACTION(CESC)ATOG DFHCESC Abnormal response from EXEC CICS START
TRANSACTION(CEGN)ATOH DFHCESC Failure of CESC due to an invalid function codeATOT DFHCEGN CEGN RETRIEVE failureATOU DFHCEGN CEGN RETURN failureATOV DFHCEGN CEGN GETMAIN, ASSIGN or SEND failureATPA DFHTPR Error occurred estimating the length of a CICS
messageATPB DFHTPR Error occurred trying to retrieve a CICS messageATPC DFHTPQ Error occurred estimating the length of a CICS
messageATPD DFHTPQ Error occurred trying to retrieve a CICS messageATPE DFHTPQ,
DFHTPRTask purged before GETMAIN request to SMdomain completed successfully
ATPF DFHTPQ,DFHTPR
Error on call to SM domain
ATRA DFHTRP Task abnormal termination requested by DFHTRAPATSA DFHTSDQ CTSD transaction attached other than by internal
requestATSB DFHTSDQ CTSD transaction attached with invalid parametersATSC DFHEITS,
DFHICP,DFHTSP
Task canceled during temporary storage command
ATSD DFHEITS,DFHICP,DFHTSP
Unexpected response from DS domain
ATSP DFHEITS,DFHTSP
Attempt to write to or delete a recoverable TS queuealready deleted in the same unit of work
ATSQ DFHEITS Move of data to or from temporary storage failedATUF DFH99KO Insufficient space to build parameter list for
DYNALLOC SVCAUEL DFHUEM,
DFHERMInternal logic error in CICS user exit management
452 CICS User’s Handbook
Abend codes
Abend Module Explanation
AUEP DFHUEH User exit program sent return code UERCPURG touser exit handler
AUXA CAUCAFB1 Unexpected error when one of TAU Detector exitprograms called CAUTABM
AUXB CAUCAFF3,CAUCAFF6,CAUCAFB1
The TAU Detector dataspace has filled up
AUYA CAUCAFB1 The TAU Detector transaction (CAFB) receivedunrecognized request
AUYC CAUCAFB1 The TAU Detector transaction (CAFB) receivedunexpected reply
AUYE CAUCAFB2,CAUCAFF3
The TAU Detector program found an invalid affinityfile number
AUYF CAUCAFB1 The TAU Detector transaction (CAFB) not started byCAFF
AUYG CAUCAFB1 The TAU Detector transaction (CAFB) still running atCICS termination
AUYH CAUCAFF4,CAUCAFF5,CAUCAFB1
The TAU Detector program found invalid address inDetector GWA
AUYI CAUCAFB2,CAUCAFF6
The TAU Detector transaction (CAFB of CAFB) hadunexpected error
AUYJ CAUCAFB2 One of the TAU affinity data files is fullAUZA CAUCAFF1, to
CAUCAFF6,CAUCAFF7,CAUCAFB1,CAUCAFB2,CAUCAF41
Unexpected error when CAFF or CAFB issued anEXEC CICS command
AUZB CAUCAFF1, toCAUCAFF6,CAUCAFB1,CAUCAFB2
Unexpected error when CAFF or CAFB issued aVSAM FC EXEC CICS command
AUZC CAUCAFF1,CAUCAFF2
Invalid internal field holding TAU Detector state
AUZD CAUCAFF1,CAUCAFF2
CICS APPLID in TAU file does not match APPLID ofCICS system
AUZF CAUCAFF1, toCAUCAFF6,CAUCAFB1
Unexpected error when CAFF or CAFB issued aDetector user exit
AUZH CAUCAFF3 Unexpected error when CAFF called CAUTABM tocreate MVS dataspace
AUZI CAUCAFF3,CAUCAFF6
Unexpected error when CAFF called CAUTABM tocreate affinity table
AUZJ CAUCAFF3 Unexpected error when CAFF called CAUTABM toadd element to table
AUZK CAUCAFF3 Unexpected error when CAFF attempted to initializeinternal trace table
Chapter 13. Transaction abend codes 453
Abend codes
Abend Module Explanation
AUZL CAUCAFF4 Unexpected error when CAFF attempted to releaseinternal trace table
AUZN CAUCAFF4 Unexpected error when CAFF called CAUTABM todestroy dataspace
AUZO CAUCAFF6 Unexpected error when CAFF called CAUTABM todestroy table
AUZQ CAUCAFF3 Unexpected error when CAFF CAUCAFP to createMVS CPOOL storage
AUZR CAUCAFF4,CAUCAFF5,CAUCAFB1
Unexpected error when CAFF or CAFB calledCAUCAFP to access storage
AUZS CAUCAFF4 Unexpected error when CAFF called CAUCAFP todestroy MVS CPOOL storage
AUZU CAUCAFF1 Unexpected error when CAFF calculated occupancyof dataspace occupied
AUZV CAUCAFF1 Incorrect method of initiating TAU Detectortransaction CAFF
AUZY CAUCAFF3,CAUCAFB2
Unexpected error when CAFF or CAFB calledCAUTABM to replace element
AUZZ CAUCAFF3,CAUCAFF6
Unexpected error when CAFF called subroutine toupdate TT or UT
AUZ1 CAUCAFF3 Header record on VSAM affinity data file not foundAWBA DFHWBXN CICS Web Receive error encounteredAWBB DFHWBBLI CICS Web Business Logic Interface program
parmlist errorAWBC DFHWBENV,
DFHWBTLNo commarea passed to CICS Web Interface utilityprogram
AWBE DFHWBBLI Converter program attempted to change responsearea address
AWBF DFHWBA Web Interface alias detected an error in initializationAWBH DFHWBA Web Interface alias detected a logic errorAWBI DFHWBA Web Interface alias received unexpected response
from EXEC CICS ASSIGN STARTCODEAWBJ DFHWBA Web Interface alias received unexpected response
when it switched to RP TCBAWBK DFHWBA Web Interface alias received an abend in converter
or program servicing the requestAWBL DFHWBA *** NO DESCRIPTION FOUND ***AWBM DFHWBA Web Interface alias detected an error from program
DFHWBBLI.AWBQ DFHWBA1,
DFHWBBLIWeb Business Logic Interface program detectederror in parameter list
AWBR DFHWBA1,DFHWBBLI
Web Business Logic Interface program detected alogic error
AWBU DFHWBC01 Web Interface connection manager could not getstorage
AWBV DFHWBC04 Web Interface connection manager detected errorresponse on EXEC CICS DEQ
454 CICS User’s Handbook
Abend codes
Abend Module Explanation
AWBX DFHWBC01 Web Interface connection manager started againstinvalid terminal type
AWBZ DFHWBC0B Web Interface connection manager detectedNOTAUTH response to EXEC CICS EXTRACT EXIT
AWB2 DFHWBXN Web Interface error in server controller attemting todisable
AWB3 DFHWBXN Web Interface error trying to determine how servercontroller was started
AWB4 DFHWBXN Web Interface server controller was invalidly startedAWB5 DFHWBM Requested port in not availableAWB7 DFHWBENV Web Interface environment variables program
invoked with invoking task number of zeroAWB8 DFHWBGB CWBG task started directly from terminalAWB9 DFHWBC01 Web Interface connection manager failed for lack of
storageAWC1 DFHWBLT Bridge exit DFHWBLT could not establish
partnership with Web terminal translation taskAWC2 DFHWBLT Bridge exit DFHWBLT passe an invalid state tokenAWC3 DFHWBLT Unsupported combination of BMS and terminal
control commands passedAWC4 DFHWBLT Bridge exit DFHWBLT reinvoked after returning an
earlier errorAWC5 DFHWBLT Bridge exit DFHWBLT could not getmain a brxa user
areaAWC6 DFHWBLT Bridge exit DFHWBLT detected an incinsistency in
request parameters or state dataAWKY DFHWKP Failure of global catalog request during warm
keypointingAXFA DFHXFP File control request keylength zeroAXFB DFHXFP Unacceptable FMH type foundAXFC DFHXFP Invalid request passed to data transformation
programAXFD DFHXFP Invalid request for remote systemAXFE DFHXFP Transformation requested does not existAXFF DFHXFP Unacceptable queue organization foundAXFG DFHXFP Unacceptable argument number in data following
FMH type 43AXFH DFHXFP Unexpected argument in data following FMH type 43AXFI DFHXFP Zero data length for WRITEQ TD or READQ TDAXFJ DFHXFP Error code in UIBFCTR and UIBDLTR cannot be
converted to SNA error codeAXFL DFHXFP Null chain of data receivedAXFM DFHXFP ISCINVREQ condition raisedAXFO DFHXFP Check on DS and DBA parameters failedAXFP DFHXFP No second FMH receivedAXFQ DFHXFP FMH too short or too longAXFR DFHXFP Length of data exceeds 32767AXFS DFHXFP Maximum length of I/O area exceeds 65535
Chapter 13. Transaction abend codes 455
Abend codes
Abend Module Explanation
AXFT DFHXFP Size of output I/O area exceeds 65535AXFU DFHXFP Invalid two-level cursorAXFW DFHXFP Invalid length specification givenAXFX DFHXFP Function shipping request by APPC link failed
protocolsAXFY DFHXFP APPC conversation failure for attach between CICS
systemsAXF0 DFHXFP Task purged due to lack of storage in a DSAAXF1 DFHXFP Unexpected return code from storage manager
module DFHSMGFAXF2 DFHXFP Task purged because of insufficient storage in DSAAXF3 DFHXFP Unexpected return code from storage manager
module DFHSMMCAXF4 DFHXFX Task purged before GET_BUFFER request
completed successfullyAXF5 DFHXFX Error on call to DFHEISRAXF8 DFHXFX Keyword shipped to system that does not support
the functionAXMA DFHxxx Error obtaining a lock in transaction manager
domain For module list,see CICS Messages andCodes
AXMB DFHxxx Error releasing a lock in transaction managerdomain For module list,see CICS Messages andCodes
AXMC DFHXMAT,DFHXMXE
Severe error allocating unique transaction number toa new transaction
AXMD DFHXMAB Invalid attempt to run CICS internal task CSXMAXMY DFHXMAT Error obtaining transaction class membershipAXMZ DFHXMTA Severe error detected by the transaction manager
domainAXSA DFHXSMN Security control task could not completeAXSC DFHXSMN Task purged before GETMAIN request to SM
domain completed successfullyAXSD DFHTCRP Error on call to SM domainAXTA DFHXTP Calculation of data length to be shipped failedAXTB DFHXTP Obtain of TIOA to ship data failedAXTC DFHXTP Data transform failedAXTD DFHXTP No TIOA received from remote systemAXTE DFHXTP Data received from remote system not long enoughAXTF DFHXTP No relay process FMH received from remote systemAXTG DFHXTP Data transform from remote system failedAXTH DFHXTP Locate of terminal identifier failedAXTI DFHXTP Major request byte LUCOPN0 invalidAXTJ DFHXTP Unexpected combination of bit settings in XTSSTAT
and XTSTCOPCAXTK DFHXTP APPC conversation failed on attach between CICS
systemsAXTL DFHXTP Wrong sync level for processing APPC mapped data
456 CICS User’s Handbook
Abend codes
Abend Module Explanation
AXTM DFHXTP Wrong sync level for message—protectedtransaction
AXTN DFHETL Application buffer chained off TCTTE (offestTCTERCSA) has corrupted header
AXTO DFHXTP Exception response from CICS security managerAXTP DFHXTP Exception response from DFHCCNV to DFHXTPAXTQ DFHXTP Exception response from DFHCCNV to DFHXTPAXTR DFHXTP Exception response from DFHPGLE to DFHXTPAZAB DFHZARM SEND DATA length greater than 65528AZAD DFHZCN1 DFHZCN1 started from unexpected placeAZAE DFHZCN1 DFHZCN1 started from terminal facility but not
LU6.2 sessionAZAF DFHZCN1 DFHZCN1 started for CCIN with errorsAZAG DFHZCT1 DFHZCT1 started from unexpected placeAZAH DFHZCT1 DFHZCT1 started from terminal facility but not LU6.2
sessionAZAI DFHZCT1 DFHZCT1 started for CTIN with errorsAZAJ DFHZCN1 CCIN must be local transaction on region directly
connected to clientAZAK DFHZCT1 CTIN must be local transaction on region directly
connected to clientAZCA DFHZARM DFHZARM conversation state conflictAZCB DFHZARM Sense code X'088901xx' received during APPC
mapped processingAZCC DFHZARM Unsupported function management dataAZCD DFHETL,
DFHZARMDFHZARM invalid data length received
AZCE DFHETL,DFHZARM
Application data length to be received exceedsallowable limits
AZCF DFHZARM Invalid request to DFHZARLAZCG DFHZARM Invalid TCTTEAZCH DFHETL,
DFHZARMUnexpected sense code X'0889xxxx' received whileprocessing APPC mapped data
AZCI DFHETL,DFHZARM,DFHZARQ
Invalid sync level
AZCJ DFHZARM System does not support APPC structured field withnull data
AZCK DFHZARM Internal logic error in error recovery for APPCmapped processing
AZCL DFHZARM Sense code X'088901xx' received during APPCmapped processing
AZCM DFHZARM Error on call to SM domainAZCN DFHZARM Task purged before GETMAIN request to SM
domain completed successfullyAZCO DFHZCGRP VTAM persistent sessions initialization txn (CGRP)
started directly from terminal
Chapter 13. Transaction abend codes 457
Abend codes
Abend Module Explanation
AZCP DFHZSUPDFH62XM
Logic error in ZCP
AZCQ DFHZSUPDFHMRXMDFH62XM
Error on call to RM domain
AZCR DFHZARL Error during APPC SYNCPOINT ROLLBACKrequest
AZCT DFHZARQ Terminal read-time-out has occurredAZCU DFHZCOVR Invalid attempt to start COVR transactionAZCV DFHZCOVR Logic error in COVR transaction while connecting to
VTAMAZCW DFHZCSTP Invalid attempt to run CICS internal task CSTPAZIA DFHZIS2 Transaction request for storage during MRO
processing invalidAZIB DFHZIS2 Transaction purged while waiting for storageAZIC DFHZIS2 Error on call to SM domain to FREEMAINAZID DFHZIS2 PURGED condition on call to SM domain to
FREEMAINAZIE DFHZARQ IRC ISSUE-ERROR or ISSUE-ABEND violated IRC
protocolsAZIF DFHZARQ Error on call to RM domainAZI1 DFHZARQ IRC data transmission protocol violatedAZI2 DFHZARQ IRC data transmission cannot completeAZI3 DFHZARQ Conversation failedAZI4 DFHZARQ IRC link to connected transaction downAZI5 DFHZARQ IRC data transmission violated IRC protocolsAZI6 DFHZARQ IRC connected transaction abnormally terminatedAZI7 DFHZIS2 Wait during MRO request rejected by CICS
dispatcherAZI8 DFHZIS1 Incorrect format for error log dataAZI9 DFHZIS2 Failing transaction purged during waitAZRA DFHZARRC FMH address missing from APPC receive bufferAZRB DFHZARR0 First parameter is invalid in call to DFHZARR0AZRD DFHZARR0 APPC logical and physical receive buffers are out of
stepAZRE DFHZARR0 Logical APPC receive buffer starts outside physical
bufferAZRF DFHZARRF Invalid state error returned from DFHZUSR state
machineAZRG DFHZARR Invalid state error returned from DFHZUSR state
machineAZRH DFHZARR Invalid RECEIVE_TYPE in DFHZARRAZRI DFHZARR1 Invalid parameter passed to DFHZARR1AZRJ DFHZARR0 APPC record length exceeds receive bufferAZRK DFHZARRF Invalid combination of fields in DFHLUC parameter
listAZRL DFHZARRF First parameter invalid in call to DFHZARRF
458 CICS User’s Handbook
Abend codes
Abend Module Explanation
AZRM DFHZARR DFHZARR called one of its own routines at wrongtime
AZRN DFHZARRF DFHLUC parameter list does not have LUCCIERRset on
AZRO DFHZARER First parameter invalid in call to DFHZARERAZRP DFHZARER Invalid response from DFHZNACAZRQ DFHZARRA Invalid parameter in call to DFHZARRAAZRR DFHZARRA Corrupted header in application bufferAZRS DFHZARRA DFHZARRA cannot acquire main memoryAZRT DFHZARRA Invalid application bufferAZRU DFHZARRF Unexpected response from DFHZARR0AZRV DFHZARR1 Unexpected response from DFHZARR0AZRW DFHZARRA Negative record length in the TCTTEAZRY DFHZARR Unexpected response from DFHZARRCAZRZ DFHZARR Unexpected response from an internal subroutineAZR2 DFHZARRA DFHZARRA can not acquire main memoryAZR3 DFHZARRA Task purged during GETMAIN requestAZR4 DFHZARER Unexpected response from dispatcher domain callAZR5 DFHZARR1 Unexpected response from dispatcher domain callAZR6 DFHZARER Exception condition from APPC routine DFHZARL to
RM domainAZS0 DFHZSTAP DFHZSTAM macro passed invalid requestAZS1 DFHZSTAP No TCTTE pointer passed via DFHZSTAM macroAZS2 DFHZSTAP TCTTE passed via DFHZSTAM does not relate to
MRO or APPC conversationAZS3 DFHZSTAP No LUCX found for an APPC TCTTEAZS4 DFHZSTAP DFHZUSRM LUC State Machine has invalid settingAZS5 DFHZSTAP Internal State number has invalid settingAZS6 DFHZSTAP Internal State number has invalid settingAZTA DFHZTSP Task does not own terminal as principal facilityAZTB DFHZTSP Attempt to delete/install remote terminal failedAZTC DFHZTSP Failure of remote terminal install or delete caused by
SOS conditionAZTF DFHZTSP TCTTE length error due to storage violation, or CICS
logic errorAZTG DFHZTSP Principal facility not intersystem TCTTEAZTH DFHZTSP Error response from remote terminal control macroAZTI DFHZTSP Terminal not defined as remotely ownedAZTL DFHZTSP Request to invalid terminalAZTM DFHZTSP Data has no FMHAZTN DFHZTSP Conversation unexpectedly terminatedAZTO DFHZTSP TCTTE ownership chain in errorAZTP DFHZTSP BMS TYPE=STORE request failedAZTQ DFHZTSP Invalid BMS data received from remote systemAZTR DFHZTSP BMS TYPE=PAGEOUT request failedAZTS DFHZTSP Data ship to remote system failedAZTT DFHZTSP Connection with remote system not APPC or MRO
connection
Chapter 13. Transaction abend codes 459
Abend codes
Abend Module Explanation
AZTU DFHZTSP Link TCTTE not owned by task after syncpointAZTV DFHZTSP Invalid FMH received from remote systemAZTW DFHZTSP Attach request to task already runningAZTY DFHZTSP Maximum APPC sessions limit reachedAZTZ DFHZTSP Relay program DFHCRT attached in unsupported
mannerAZT1 DFHZTSP Task attached improperly in AOR when transaction
routingAZT3 DFHZTSP Task is being routed back to region from where it
cameAZT6 DFHZTSP TOR has violated transaction routing protocolAZT7 DFHZTSP TCT entry for remotely owned APPC terminal can
not be added to TCTAZT8 DFHZTSP TCT entry for remotely owned APPC terminal can
not be deleted from TCTAZT9 DFHZTSP TCT entry for remotely owned APPC terminal can
not be deleted from TCT as it is locked by anothertask
AZVA DFHZATS Time-out while waiting for service transaction CITSto complete
AZVB DFHZATS DFHZCQ failed to create remote terminal definitionAZVC DFHZATS Unexpected error in DFHZATSAZVD DFHZATS Unexpected error in install procedure of DFHZATSAZVE DFHZATS Terminal has same ID as an existing TCT entryAZVF DFHZATS An attempt was made to start
CITS/CDTS/CMTS/CFTS from a terminalAZVG DFHZATS Error in remote delete routinesAZVH DFHZATS Error in remote delete routine while processing mass
deleteAZVI DFHZATS Error in remote delete routine while processing
single deleteAZVJ DFHZATS Error in mass deletion of remote terminalsAZVK DFHZATS Unexpected return code during deletion of single
terminalAZVL DFHZATS Error in mass flag routine of remote terminals for
deletionAZVM DFHZATMF Error in DFHZATMFAZVN DFHZATMF CRMF started directly from terminalAZVO DFHZATMD CRMD started directly from terminalAZVP DFHZATMD Error in DFHZATMDAZVQ DFHZATS Request to install a shipped terminal definition
rejected by autoinstall user programAZVR DFHZATS Unexpected return code from autoinstall user
programAZVS DFHZATS Error in autoinstall user programAZVU DFHZATS Autoinstall of shipped terminal, virtual terminal or
shipped connection failed
460 CICS User’s Handbook
Abend codes
Abend Module Explanation
AZXA DFHZXCU Catch-up program finds unexpected error, reasoncode 5
AZXB DFHZXCU Catch-up program finds unexpected error, reasoncode 4
DHxx DFH***** EXEC DL/I error or invalid status code (xx)0100 DFHEAP
DFHECPDFHEDPDFHEPP
Translator error opening listing data set
0101 DFHEAPDFHECPDFHEDPDFHEPP
Translator program check
0211 DFHPDDFHPDX
Recursive program check in system dump
0212 DFHPDDFHPDX
Too many program checks in system dump
0300 DFHCSDUP SYSIN data set failed to open successfully0301 DFHCSDUP Invalid RECFM in SYSIN DD statement0302 DFHCSDUP Invalid record length in SYSIN DD statement0303 DFHCSDUP SYSPRINT data set has not opened successfully0304 DFHCSDUP DFHCSDUP found unrecognized resource type code
in CSD record0305 DFHCSDUP Unexpected return code received0307 DFHCSDUP Attempt to print input command failed0308 DFHCSDUP Bad command sequence found migrating TCT table0309 DFHCSDUP Unrecognized function code found in command0321 DFHCSDUP Internal error in DFHCSDUP module0322 DFHCSDUP Table to be migrated could not be loaded0323 DFHCSDUP VSAM detected an error processing a command0325 DFHCSDUP Error occurred during execution of DFHDMP function0326 DFHCSDUP Internal logic error in DFHCSDUP utility program0327 DFHCSDUP Language table DFHEITCU could not be loaded0328 DFHCSDUP Language table DFHEITCU could not be unloaded0330 DFHCSDUP Cross-reference table size too small0331 DFHCSDUP *** NO DESCRIPTION FOUND ***0332 DFHCSDUP *** NO DESCRIPTION FOUND ***0401 DFHXCSTB EXCI call made in AMODE 240402 DFHXCPRH Nonzero return code following MVS ESTAE issued
by DFHXCPRH0403 DFHXCPRH Nonzero return code following MVS GETMAIN
request by DFHXCPRH0404 DFHXCPRH EXCI dump services not available to take MVS
SDUMP0405 DFHXCPRH Failure of SSI VERIFY request by DFHXCPRH0406 DFHXCPRH Failure of CICS SVC call during EXCI initialization0407 DFHXCPRH CICS SVC at the wrong level for EXCI
Chapter 13. Transaction abend codes 461
Abend codes
Abend Module Explanation
0408 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRHfor working storage
0409 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRHfor SSI VERIFY
0410 DFHXCPRH Failure of MVS GETMAIN request by DFHXCPRHfor XCUSER block
0411 DFHXCDMP Failure of CICS SVC call by DFHXCDMP0412 DFHXCEIP Invalid function in EXEC parameter list of EXCI
EXEC API request0413 DFHXCEIP Error in EXEC parameter list of EXCI EXEC API
request0414 DFHXCEIP Nonzero return code following MVS ESTAE issued
by DFHXCEIP0415 DFHXCEIP Error in EXCI initialization detected by DFHXCEIP0501 DFHCALLA,
DFHMSGIF,DFHTRCIF
JCICS request attempted on a pthread
0555 DFHAPLJ CICS JVM interface percolation abend to driveLanguageEnvironment recovery
462 CICS User’s Handbook
Chapter 14. 1xxx-9xxx (COBOL II) abend codes
Abend codes with 1 through 9 as the first character are issued by COBOL IIapplications running on CICS. The last three digits of the abend code, xxx,correspond to the xxx in the associated COBOL II run-time message,IGZxxxI.
COBOL II run-time messages are described in the VS COBOL II ApplicationProgram Debugging Guide, SC26-4049.
Copyright IBM Corp. 1989, 1999 463
VTAM
Chapter 15. VTAM-associated errors
This section lists the terminal error codes from VTAM.
VTAM terminal error codes and CICS message numbersTerminal error codes from VTAM are put in a one-byte field of theDFHZNAC COMMAREA (DFHNEPCA) at label TWAEC.
For those error codes that have CICS messages associated with them, youshould see the CICS Messages and Codes for descriptions of thecorresponding error conditions.
CICS message Action flags set Error code Symbolic label
DFHZC0101 X'5D' TCZPRDTODFHZC0125 X'FB' TCZPSUNBDFHZC0131 X'FC' TCZPSOPNDFHZC0144 11 X'7A' TCZPSRACDFHZC0145 3 9 10 11 24
DUMPNTAX'79' TCZPSRAF
DFHZC0146 X'FD' TCZPSRCDFHZC0147 3 9 10 11 24
DUMPNTAX'71' TCZPSLE
DFHZC0148 9 10 11 24 X'72' TCZPSVFDFHZC0149 X'FF' TCZPSPEDFHZC0150 3 9 10 11 15 24
DUMPNTAX'FE' TCZPSRF
DFHZC0155 3 9 10 11 24DUMPNTA
X'6C' TCZPSAF
DFHZC0156 X'6D' TCZPSARDFHZC2102 3 X'E9' TCZSTINDDFHZC2117 9 10 11 23 24 X'DB' TCZPIPLDFHZC2351 2 3 X'6F' TCZSDASDFHZC2400 2 3 9 10 11 24
AOSX'C1' TCZSRCAT
DFHZC2401 2 3 9 10 11 24OUTSERV
X'B1' TCZRPLAC
DFHZC2402 3 11 X'B4' TCZRSNEDFHZC2403 2 5 18 24 X'11' TCZSRCBFDFHZC2404 X'E6' TCZDMLGDFHZC2404 2 3 9 10 11 24
AOSX'14' TCZLRCER
DFHZC2404 2 3 9 10 11 24AOS
X'18' TCZLRCNR
DFHZC2405 18 X'10' TCZSRCTUDFHZC2406 9 10 11 18 X'19' TCZSRCTSDFHZC2407 2 3 9 10 11 24 X'15' TCZSRCPF
Copyright IBM Corp. 1989, 1999 465
VTAM
CICS message Action flags set Error code Symbolic label
DFHZC2408 2 3 9 10 11 1824
X'1A' TCZSRCVE
DFHZC2408 2 3 9 10 11 1824
X'1E' TCZSRCV2
DFHZC2409 2 3 9 10 11 1524
X'D0' TCZTXCS
DFHZC2410 2 3 9 10 11 1824
X'D1' TCZTXCU
DFHZC2411 X'E0' TCZDMSNDFHZC2412 X'E1' TCZDMRADFHZC2413 2 X'E2' TCZDMCLDFHZC2414 X'80' TCZSRCSPDFHZC2416 18 24 X'13' TCZSRCVHDFHZC2417 2 24 X'1D' TCZSRCVIDFHZC2417 X'20' TCZVTAMIDFHZC2418 2 3 9 10 11 24
AOSX'BB' TCZSEXUC
DFHZC2419 2 3 9 10 11 24AOS
X'82' TCZSSXUC
DFHZC2420 2 3 9 10 11 24AOS
X'B5' TCZSAXUC
DFHZC2421 2 3 9 10 11 24 X'60' TCZUNCMDDFHZC2422 1 2 3 9 10 11
DUMPNTAX'90' TCZLGCER
DFHZC2423 3 9 10 11 24 X'74' TCZSDSE5DFHZC2424 3 9 10 11 15 24 X'75' TCZSESE1DFHZC2425 3 9 10 11 15 24 X'B2' TCZSDAUCDFHZC2426 2 3 9 10 11 22 X'94' TCZRACESDFHZC2427 2 X'C5' TCZSRCNADFHZC2428 3 9 11 X'92' TCZSDSE6DFHZC2429 3 10 11 X'91' TCZRSTLEDFHZC2430 3 9 11 RESP X'78' TCZSDRE2DFHZC2431 2 3 9 10 11 X'CB' TCZSRCTCDFHZC2432 X'81' TCZSSXNRDFHZC2433 X'E4' TCZAIERDFHZC2434 3 11 X'43' TCZCPYNSDFHZC2435 3 10 11 24 X'96' TCZRVSZ1DFHZC2436 3 10 11 X'97' TCZRVSZ3DFHZC2437 3 9 11 X'73' TCZSDSE4DFHZC2438 3 10 11 X'A1' TCZRVSZ2DFHZC2439 2 18 X'98' TCZACT01DFHZC2440 X'D7' TCZSXC1DFHZC2441 X'D6' TCZSXC2DFHZC2442 X'DC' TCZPXE1DFHZC2443 2 3 9 10 11 24 X'59' TCZROCTDFHZC2444 2 3 9 10 11 24 X'A3' TCZBKTSEDFHZC2445 3 9 11 X'95' TCZSDSE8
466 CICS User’s Handbook
VTAM
CICS message Action flags set Error code Symbolic label
DFHZC2446 2 3 9 10 11 24AOS
X'84' TCZSSXIB
DFHZC2447 3 9 10 11 AOS X'9A' TCZDOMCFDFHZC2448 2 3 10 11 24
AOS RESPX'65' TCZINVRR
DFHZC2449 2 3 11 18 22 24 X'A7' TCZBOEBDFHZC2450 X'83' TCZSSXARDFHZC2451 2 3 9 10 11 X'CC' TCZSRCCIDFHZC2452 3 9 10 11 18 24 X'D5' TCZCXE2DFHZC2453 1 2 3 9 10 X'D4' TCZCXRRDFHZC2454 2 3 9 10 11 X'CD' TCZSRCCXDFHZC2455 2 3 9 10 11 X'93' TCZRACETDFHZC2456 2 3 9 10 11 18
24X'44' TCZSRCDE
DFHZC2457 2 3 9 10 11 24 X'D8' TCZRNCHDFHZC2458 X'DD' TCZPXE2DFHZC2459 3 9 11 X'99' TCZSDSE7DFHZC2463 X'D3' TCZDMPDDFHZC2467 2 3 9 10 11 24
AOSX'88' TCZLEXCI
DFHZC2468 2 3 9 10 11 24 X'89' TCZLEXUSDFHZC2469 2 3 9 10 11 X'D9' TCZYX43DFHZC2469 2 3 9 10 11 X'F2' TCZEXRVTDFHZC2470 9 10 11 24 X'DA' TCZSXC3DFHZC2471 2 3 10 11 22 24
PRTTIOAX'A8' TCZFMHLE
DFHZC2472 11 X'A9' TCZRACRFDFHZC2473 3 9 11 X'AA' TCZSDSE9DFHZC2485 3 9 10 11 X'E3' TCZCNCLDFHZC2486 3 X'9B' TCZRACNLDFHZC2487 3 X'76' TCZLGNADFHZC2488 X'77' TCZDMRYDFHZC2489 3 9 11 X'40' TCZINCPYDFHZC2490 2 3 9 10 11 15
24X'41' TCZTOLRQ
DFHZC2497 X'42' TCZUNPRTDFHZC2498 X'4B' TCZICPUTDFHZC3400 3 10 11 RESP X'45' TCZCHMXDFHZC3402 3 9 10 11 X'46' TCZOCIRDFHZC3409 2 3 9 10 11 24
AOSX'85' TCZUNEGR
DFHZC3410 2 3 9 10 11 X'BC' TCZINIIRDFHZC3416 2 3 X'E8' TCZDMSLEDFHZC3417 3 9 10 11 24 X'50' TCZSDRE3DFHZC3418 3 9 10 11 24 X'51' TCZBDPRIDFHZC3419 2 3 5 X'52' TCZBDUACDFHZC3420 20 X'53' TCZBDTOSDFHZC3421 20 X'5A' TCZSBIRV
Chapter 15. VTAM-associated errors 467
VTAM
CICS message Action flags set Error code Symbolic label
DFHZC3422 2 3 9 10 11 1824
X'5B' TCZNSP01
DFHZC3424 9 10 11 15 24 X'5C' TCZNSP02DFHZC3428 3 X'EB' TCZSTRMHDFHZC3429 2 3 X'EC' TCZSTRMMDFHZC3430 2 3 X'ED' TCZSTONDFHZC3431 2 3 X'EF' TCZSTINDFHZC3432 2 3 X'EA' TCZSTLERDFHZC3433 X'58' TCZERMGRDFHZC3434 2 3 9 10 11 24 X'54' TCZUNBISDFHZC3440 X'55' TCZEMWBKDFHZC3441 X'63' TCZVTAMODFHZC3442 X'67' TCZVTAMKDFHZC3443 X'64' TCZVTAMADFHZC3444 2 3 9 10 11 24
PRTACTX'6A' TCZTIOAE
DFHZC3452 X'66' TCZSIGRDFHZC3454 2 3 5 18 24 X'5E' TCZBRUACDFHZC3455 2 3 5 18 24 X'5F' TCZBDSQPDFHZC3461 X'48' TCZOPSINDFHZC3462 X'49' TCZCLSINDFHZC3463 X'4A' TCZOPACBDFHZC3464 20 X'57' TCZRELISDFHZC3465 1 2 3 9 10 11
AOSX'9D' TCZRSPER
DFHZC3466 20 AOS X'69' TCZSEXOSDFHZC3468 9 10 11 15 24 X'70' TCZCLRRVDFHZC3469 9 10 11 24 X'CE' TCZVHOLDDFHZC3470 9 10 11 24 X'AB' TCZLUERRDFHZC3470 9 10 11 24 X'37' TCZXSHRADFHZC3471 9 10 11 24 X'CF' TCZVRNOPDFHZC3472 X'9E' TCZDEVNDDFHZC3473 X'4D' TCZSLSRLDFHZC3474 9 10 11 24 X'AC' TCZVRDACDFHZC3475 9 10 11 24 X'AD' TCZNRLUFDFHZC3476 9 10 11 24 X'AE' TCZRCLUFDFHZC3477 9 10 11 24 X'AF' TCZCLEANDFHZC3479 2 3 9 10 11 24 X'4E' TCZUNBFEDFHZC3480 24 AOS X'A0' TCZNOISCDFHZC3481 2 3 9 10 11 24 X'4C' TCZDSPCLDFHZC3482 X'DF' TCZDMGFDFHZC3484 X'C6' TCZPASSDDFHZC3485 24 X'C7' TCZPSPREDFHZC3486 24 X'C2' TCZLUINPDFHZC3487 24 X'C9' TCZNPSAUDFHZC3488 2 3 9 10 11 18
24X'3C' TCZXUVAR
DFHZC3489 18 24 X'C8' TCZLUINH
468 CICS User’s Handbook
VTAM
CICS message Action flags set Error code Symbolic label
DFHZC3490 24 X'BF' TCZCPFALDFHZC3491 15 24 X'B0' TCZEXRODFHZC3492 X'16' TCZDMITDFHZC3495 24 X'6B' TCZNOTNADFHZC3499 X'C0' TCZDWEGFDFHZC4902 3 9 10 11 24 X'21' TCZLUCF1DFHZC4903 3 9 10 11 24 X'22' TCZLUCF2DFHZC4904 3 9 10 11 24 X'23' TCZFSMBEDFHZC4905 3 9 10 11 24 X'24' TCZFSMCSDFHZC4906 3 9 10 11 24 X'25' TCZFSMCRDFHZC4907 3 9 10 11 24 X'26' TCZSDLERDFHZC4909 3 9 10 11 24 X'28' TCZRVLERDFHZC4910 3 9 10 11 24 X'29' TCZRVLRBDFHZC4911 2 3 9 10 11 24 X'2A' TCZRLPEXDFHZC4912 2 3 9 10 11 24 X'2B' TCZRLPBDDFHZC4913 2 3 9 10 11 24 X'2C' TCZRLPDRDFHZC4914 2 3 9 10 11 24 X'2D' TCZRLPILDFHZC4915 2 3 9 10 11 24 X'2E' TCZRLPECDFHZC4916 2 3 9 10 11 24 X'2F' TCZRLPRRDFHZC4917 2 3 9 10 11 24 X'30' TCZRLPIFDFHZC4918 2 3 9 10 11 24 X'31' TCZRLPIRDFHZC4919 2 3 9 10 11 24 X'33' TCZIVINDDFHZC4920 2 3 9 10 11 24 X'34' TCZIVDATDFHZC4922 N24 X'32' TCZRLXCLDFHZC4924 2 3 5 24 X'B6' TCZNSEEDDFHZC4925 2 3 5 24 X'B7' TCZASINCDFHZC4926 2 3 5 24 X'B8' TCZEVBADDFHZC4927 2 3 5 24 X'B9' TCZFMH12DFHZC4928 24 X'BD' TCZDESGMDFHZC4929 2 3 5 24 X'B3' TCZBDBNDDFHZC4930 2 3 9 10 11 24 X'35' TCZRTMTDFHZC4931 18 24 X'F1' TCZBDMODDFHZC4932 2 3 24 X'F3' TCZICTYPDFHZC4933 2 3 24 X'F4' TCZIDBADFHZC4934 2 3 24 X'F5' TCZISYNLDFHZC4935 2 3 24 X'F6' TCZIUOWDFHZC4936 2 3 24 X'F7' TCZIFMHLDFHZC4937 2 3 5 24 X'8A' TCZLUSRRDFHZC4938 2 3 5 24 X'8B' TCZLUSRFDFHZC4939 2 3 5 24 X'8C' TCZLUPUNDFHZC4940 2 3 5 24 X'8F' TCZLUSKNDFHZC4941 2 3 5 24 X'8D' TCZLUPLKDFHZC4942 2 3 5 24 X'8E' TCZLUPEXDFHZC4943 3 9 10 11 24 X'F8' TCZFSMRBDFHZC4944 2 3 5 24 X'BE' TCZBFAILDFHZC4945 3 9 10 11 24 X'A2' TCZPRGEDFHZC4946 2 3 24 X'F9' TCZINVATDFHZC4947 2 3 24 X'FA' TCZLUSEC
Chapter 15. VTAM-associated errors 469
VTAM
CICS message Action flags set Error code Symbolic label
DFHZC6590 X'3F' TCZXRSTDFHZC6591 9 10 11 15 24 X'3E' TCZXERRDFHZC6593 X'3B' TCZXSBCDFHZC6594 24 X'3A' TCZXSHRDFHZC6595 2 3 5 24 X'39' TCZXSABNDFHZC6596 2 3 15 24 X'38' TCZXSWASDFHZC6598 X'56' TCZXRFVS
470 CICS User’s Handbook
System sense codes
Chapter 16. System sense codes received
This section contains Product-sensitive Programming Interface information.
This table lists the actions taken by DFHZNAC on receipt of inbound systemsense codes.
Sensecode
Message Action flags set
0001 DFHZC3401 20002 DFHZC3415 2, 3, 10, 110003 DFHZC3449 None0004 DFHZC3450 None0007 DFHZC3451 None00FF DFHZC3446 2, 3, 9, 10, 11, 23, 240801 DFHZC2476 3, 9, 10, 110802 DFHZC2461 None0806 DFHZC3426 None0807 DFHZC3411 None080B DFHZC2462 2, 3, 9, 10, 11, 15, 24080E DFHZC3448 23080F DFHZC3436 9, 10, 110811 DFHZC2464 9, 10, 110812 DFHZC2465 2, 3081B DFHZC2483 2, 3081C DFHZC2466 2, 3, 9, 10, 110824 DFHZC2475 3, 9, 10, 110825 DFHZC2484 2, 3, 9, 10, 110826 DFHZC3423 2, 3, 9, 10, 110827 DFHZC2480 30829 DFHZC3407 1, 2, 3, 10, 11, 24082A None 9, 32082B DFHZC3408 2, 3, 10, 11, 13082D DFHZC3413 None082E DFHZC3412 None082F DFHZC3414 2, 3, 9, 10, 110831 DFHZC3438 None0833 DFHZC3427 None0847 DFHZC3439 None084A None 32084C DFHZC3467 9, 10, 110860 DFHZC3459 None0863 DFHZC3460 9, 10, 110864 DFHZC2475 3, 9, 10, 110865 DFHZC2465 3, 9, 10, 110866 DFHZC2475 3, 9, 10, 110867 None 9, 10, 110868 DFHZC3456 2, 9, 10, 11
Copyright IBM Corp. 1989, 1999 471
System sense codes
Sensecode
Message Action flags set
0869 DFHZC3457 2, 9, 10, 1108FF DFHZC3447 2, 3, 9, 10, 11, 241000 DFHZC3494 2, 3, 9, 10, 111001 DFHZC2481 2, 3, 9, 10, 11, 141002 DFHZC2481 2, 3, 9, 10, 11, 141003 DFHZC2479 2, 3, 9, 10, 11, 141005 DFHZC3406 2, 3, 4, 9, 10, 11, 141008 DFHZC2478 None1009 DFHZC3458 2, 9, 10, 1110FF DFHZC3446 2, 3, 9, 10, 11, 23, 242003 DFHZC3405 2, 3, 9, 10, 11, 15, 2420FF DFHZC3445 2, 3, 9, 10, 11, 23, 24400B DFHZC2477 1, 3, 1140FF DFHZC3453 2, 3, 9, 10, 11, 23, 248000 DFHZC3435 2, 3, 9, 10, 11, 18, 248005 DFHZC3435 2, 3, 9, 10, 11, 18, 2480FF DFHZC3435 2, 3, 9, 10, 11, 18, 23, 24FFFF DFHZC2460 2, 3, 9, 10, 11, 23, 24
Message Sensecode
Action flags set
DFHZC2460 FFFF 2, 3, 9, 10, 11, 23, 24DFHZC2461 0802 NoneDFHZC2462 080B 2, 3, 9, 10, 11, 15, 24DFHZC2464 0811 9, 10, 11DFHZC2465 0812 2, 3DFHZC2465 0865 3, 9, 10, 11DFHZC2466 081C 2, 3, 9, 10, 11DFHZC2475 0824 3, 9, 10, 11DFHZC2475 0864 3, 9, 10, 11DFHZC2475 0866 3, 9, 10, 11DFHZC2476 0801 3, 9, 10, 11DFHZC2477 400B 1, 3, 11DFHZC2478 1008 NoneDFHZC2479 1003 2, 3, 9, 10, 11, 14DFHZC2480 0827 3DFHZC2481 1001 2, 3, 9, 10, 11, 14DFHZC2481 1002 2, 3, 9, 10, 11, 14DFHZC2483 081B 2, 3DFHZC2484 0825 2, 3, 9, 10, 11DFHZC3401 0001 2DFHZC3405 2003 2, 3, 9, 10, 11, 15, 24DFHZC3406 1005 2, 3, 4, 9, 10, 11, 14DFHZC3407 0829 1, 2, 3, 10, 11, 24DFHZC3408 082B 2, 3, 10, 11, 13DFHZC3411 0807 None
472 CICS User’s Handbook
System sense codes
Message Sensecode
Action flags set
DFHZC3412 082E NoneDFHZC3413 082D NoneDFHZC3414 082F 2, 3, 9, 10, 11DFHZC3415 0002 2, 3, 10, 11DFHZC3423 0826 2, 3, 9, 10, 11DFHZC3426 0806 NoneDFHZC3427 0833 NoneDFHZC3435 8000 2, 3, 9, 10, 11, 18, 24DFHZC3435 8005 2, 3, 9, 10, 11, 18, 24DFHZC3435 80FF 2, 3, 9, 10, 11, 18, 23, 24DFHZC3436 080F 9, 10, 11DFHZC3438 0831 NoneDFHZC3439 0847 NoneDFHZC3445 20FF 2, 3, 9, 10, 11, 23, 24DFHZC3446 00FF 2, 3, 9, 10, 11, 23, 24DFHZC3446 10FF 2, 3, 9, 10, 11, 23, 24DFHZC3447 08FF 2, 3, 9, 10, 11, 24DFHZC3448 080E 23DFHZC3449 0003 NoneDFHZC3450 0004 NoneDFHZC3451 0007 NoneDFHZC3453 40FF 2, 3, 9, 10, 11, 23, 24DFHZC3456 0868 2, 9, 10, 11DFHZC3457 0869 2, 9, 10, 11DFHZC3458 1009 2, 9, 10, 11DFHZC3459 0860 NoneDFHZC3460 0863 9, 10, 11DFHZC3467 084C 9, 10, 11DFHZC3494 1000 2, 3, 9, 10, 11None 082A 9, 32None 084A 32None 0867 9, 10, 11
Chapter 16. System sense codes received 473
System sense codes
Action flag settings and default actions˚˚˚˚˚These are the default actions generated by DFHZNAC for DFHZNEP. Thedefault actions can vary from the actions set, depending on the state of thenode at the time of the error.
Flag Field Bit mask Hex bitsetting
Action
1 TWAOPT1 1... .... "X'80'" Print action flags2 .1.. .... "X'40'" Print VTAM RPL3 ..1. .... "X'20'" Print TCTTE4 ...1 .... "X'10'" Print TIOA5 .... 1... "X'08'" Print BIND area6 .... .1.. "X'04'" System dump if no task
attached9 1... .... "X'80'" Abort any send for this
terminal10 TWAOPT2 .1.. .... "X'40'" Abort any receive for " "11 ..1. .... "X'20'" Abend any task attached to
TCTTE12 ...1 .... "X'10'" Cancel any task attached to
TCTTE13 .... 1... "X'08'" Good Morning message to
be sent14 .... .1.. "X'04'" Purge any BMS pages for
this TCTTE15 .... ..1. "X'02'" SIMLOGON required17 TWAOPT3 1... .... "X'80'" Set INTLOG now allowed18 .1.. .... "X'40'" Set no internal general
logons20 ...1 .... "X'10'" Normal CLSDST (no reset
allowed)21 .... 1... "X'08'" Normal CLSDST (reset
allowed)22 .... .1.. "X'04'" Send negative response23 .... ..1. "X'02'" Keep node out of service24 .... ...1 "X'01'" CLSDST node
474 CICS User’s Handbook
VTAM identifiers
Chapter 17. VTAM submodule identifiers
This chapter contains Product-sensitive Programming Interface information.
Hex ID Module Description
X'00' ZDSP DISPATCHX'01' ZARQ READ /WRITE RX'02' ZLOC LOCATEX'03' ZDET DETACHX'04' ZTCP TCPX'06' ZCRQ COMMAND REQSX'08' ZSTU STATUS CHANGEX'09' ZTSP TERMINAL SHARINGX'0A' ZHPX HPO RPL EXEC OS
ONLYX'0B' ZISP ALLOCATE/FREEX'0C' ZIS1 INTER SYSTEMX'0D' ZIS2 INTER SYSTEM 2X'0E' ZABD INVALID
REQUEST/ABENDX'10' ZATI ATIX'11' ZATT ATTACH TASKX'12' ZFRE FREE STORAGEX'13' ZGET GET STORAGEX'14' ZRAC RECEIVE ANYX'15' ZRST RESETSRX'16' ZRVS RECEIVE SPECX'17' ZRVX RECEIVE S EXTX'18' ZSDS SEND NORMALX'19' ZSDX SEND DATA EXITX'1A' ZUCT TRANSLATIONX'1B' ZUIX USER EXITX'1C' ZACT ACTIVATE SCANX'1D' ZSDR SEND RESPONSEX'1E' ZHPS HPO SEND/RECV CALLX'1F' ZRPL RECV.ANY BLDERX'20' ZAIT ATTACH INITX'21' ZASX ASYN COM EXITX'22' ZCLS CLOSE DESTINX'23' ZCLX CLOSE DS EXITX'24' ZDWE DWE PROCESSX'25' ZLEX LERAD EXITX'26' ZLGX LOGON EXITX'27' ZLRP LOGICAL RECX'28' ZLTX LOSTERM EXITX'29' ZOPN OPEN DESTINATX'2A' ZOPX OPEN DESTEXITX'2B' ZRAQ READAHEAD QUE
Copyright IBM Corp. 1989, 1999 475
VTAM identifiers
Hex ID Module Description
X'2C' ZRAR READAHEAD RETX'2E' ZRRX REL REQUEST EXX'2F' ZNSP NETWORK SPEC EXITX'30' ZRSY RESYNCX'31' ZSAX SEND COMM EXTX'32' ZSCX SCIP EXITX'33' ZSDA SEND ASYN COMX'34' ZSKR SEND COMMAND
RESPONSE IDX'35' ZSES SESSIONC COMX'36' ZSEX SESSIONC EXITX'37' ZSIM SIMLOGONX'38' ZSIX SIMLOGON EXITX'39' ZSLS SETLOGON STARTX'3A' ZSSX SEND COM EXITX'3B' ZSYX SYNAD EXITX'3C' ZTAX TURNAROUND EXITX'3D' ZTPX TPEND EXITX'3E' ZOPA VTAM OPEN ACBX'3F' ZSHU VTAM SHUTDOWNX'40' ZQUE TERMINAL SHARINGX'41' ZEMW ERROR MESSAGE
WRITERX'42' ZSYN SYNCPOINT HANDLERX'43' ZTRA VTAM RPL TRACEX'44' ZAND ABEND CONTROL
BLOCKX'45' ZCNA CONSOLE CONTROLX'46' ZCNR CONSOLE REQUESTX'47' ZCNC CONSOLE ABNORMAL
COND.X'48' ZUAX ATTACH USER EXITX'49' ZUOX OUTPUT USER EXITX'4A' ZARL LU6.2 APPL REQUESTX'4B' ZARM LU6.2 MIGRATIONX'4C' ZRVL LU6.2 RECEIVEX'4D' ZRLX LU6.2 RECEIVE EXITX'4E' ZSDL LU6.2 SENDX'4F' ZSLX LU6.2 SEND EXITX'50' ZERH LU6.2 APPL ERPX'52' ZBKT LU6.2 BRACKET STATE
M/CX'53' ZCNT LU6.2 CONTENTION
STATEX'54' ZCHS LU6.2 CHAIN SENDX'55' ZCHR LU6.2 CHAIN RECEIVEX'56' ZUSR LU6.2 CONVERSATION
STATE
476 CICS User’s Handbook
VTAM identifiers
Hex ID Module Description
X'57' ZDST SNA-ASCII TRANROUTINE
X'58' ZEV1 ENCRYPTIONVALIDATION 1
X'59' ZEV2 ENCRYPTIONVALIDATION 2
X'5E' ZXRC XRF TERMINALRECOVERY
X'5F' ZXTS XRF TERMINAL SCANX'60' ZXRL LU6.2 Transaction
RoutingX'61' ZINT Initialization Module IdentX'62' ZXRT LU6.2 Transaction
Routing TOSX'63' ZSTA LU6.2 Application StatusX'64' ZRLP LU6.2 RECEIVE
post-vtamX'65' ZCRT LU6.2 RPL_B stateX'66' ZRAS LU6.2 Slow-down
processingX'67' ZXPS LU6.2 Per sess recoveryX'7D' ZRLG RESPONSE LOGGERX'7E' ZNAC NACPX'7F' ZRSP RESYNC SYSTEM TASKX'80' ZATR ZATR restart deletesX'82' ZATA ZATA autoinstallX'84' ZATD ZATD autoinstall deleteX'86' ZGMM GOOD MORNING
TRANSACTIONX'8B' ZATS ZATS remote install entryX'C0' ZQ00 DFHZCQ REQUEST
ROUTERX'C1' ZQIN ZC INITIALIZEX'C2' ZQBA ZC Bind AnalysisX'C3' ZQCH ZC CHANGEX'C4' ZQDL ZC DELETEX'C5' ZQIT ZC INSTALL TCTTEX'C6' ZQRC ZC RECOVERX'C7' ZQRS ZC RESTOREX'C8' ZQIQ ZC INQUIREX'C9' ZQIS ZC INSTALLX'C4' ZTCT DUMMY TCTTE
IDENTIFIER
Chapter 17. VTAM submodule identifiers 477
Storage classes
Chapter 18. AP domain storage classes
This chapter contains Diagnosis, Modification or Tuning information.
This table shows the valid AP domain storage classes. Some classes use astorage accounting area (SAA). For these, the storage class value alwaysappears in the first byte in the accounting area for a storage element. Thevalue is sometimes modified when the top bit is set to indicate getmainedstorage. As an example, X'01' can appear as X'81'.
Value Class SAA
X'01' TERMINAL24 NoX'02' CICS NoX'03' SHARED_CICS NoX'04' LINE NoX'05' TERMINAL NoX'06' TASK NoX'07' TASK24 NoX'08' CICS24 NoX'09' SHARED_CICS24 NoX'0C' CICS24_SAA YesX'0D' TRANSDATA YesX'0E' TEMPSTG YesX'11' USER NoX'12' USER24 NoX'13' SHARED_CICS24_SAA YesX'14' CONTROL NoX'16' TACLE YesX'20' SHARED_USER24 NoX'21' SHARED_USER No
Copyright IBM Corp. 1989, 1999 479
Sending your comments to IBM
If you especially like or dislikeanything about this book, please useone of the methods listed below tosend your comments to IBM.
Feel free to comment on what youregard as specific errors oromissions, and on the accuracy,organization, subject matter, orcompleteness of this book.
Please limit your comments to theinformation in this book and the wayin which the information ispresented.
To request additional publications, orto ask questions or make commentsabout the functions of IBM productsor systems, you should talk to yourIBM representative or to your IBMauthorized remarketer.
When you send comments to IBM,you grant IBM a nonexclusive rightto use or distribute your commentsin any way it believes appropriate,without incurring any obligation toyou.
You can send your comments toIBM in any of the following ways:
� By mail, to this address:
Information Development Department (MP095)IBM United Kingdom LaboratoriesHursley ParkWINCHESTER,HampshireSO21 2JNUnited Kingdom
� By fax:
– From outside the U.K., afteryour international accesscode use 44–1962–870229
– From within the U.K., use01962–870229
� Electronically, use theappropriate network ID:
– IBM Mail Exchange:GBIBM2Q9 at IBMMAIL
– IBMLink:HURSLEY(IDRCF)
– Internet:[email protected]
Whichever you use, ensure that youinclude:
� The publication number and title
� The topic to which yourcomment applies
� Your name andaddress/telephone number/faxnumber/network ID.
Copyright IBM Corp. 1989, 1999 481
IBM
Program Number: 5655-147
Printed in the United States of Americaon recycled paper containing 10%recovered post-consumer fiber.
SX33-61ð4-ð2